0
  • 聊天消息
  • 系统消息
  • 评论与回复
登录后你可以
  • 下载海量资料
  • 学习在线课程
  • 观看技术视频
  • 写文章/发帖/加入社区
会员中心
创作中心

完善资料让更多小伙伴认识你,还能领取20积分哦,立即完善>

3天内不再提示

Air780EP模块AT开发-MQTT接入阿里云应用指南

合宙LuatOS 2024-07-22 14:19 次阅读

简介

> 使用AT方式连接阿里云分为一机一密和一型一密两种方式,其中一机一密又包括HTTP认证二次连接和MQTT直连两种方式
>
> - 关联文档和使用工具:
> - [AT固件获取]
> - [在线加/解密工具]
> - [阿里云平台]

准备工作

1. Air780EP_全IO开发板一套,包括天线SIM卡,USB线,并烧录AT固件

wKgaomad-MqALrfDAEuqzo4Snig631.png

2. PC电脑,串口工具

3. 准备设备证书及产品证书

**注意:下方证书信息仅为本教程使用,用户需要使用自己的证书信息**

```lua
--设备证书
{
"ProductKey": "k1hipglLdjU",
"DeviceName": "868488076506128",
"DeviceSecret": "fef32adf6dad46c2c7cbf335d3a7b021"
}
--产品证书
{
"ProductSecret": "8LQwOYSZMwp3DFBd",
"ProductKey": "k1hipglLdjU"
}
```

阿里云操作

产品操作

打开[阿里云平台]找到**物联网平台**,开通业务后进入**控制台**。

点开**设备管理**的**产品页面**,点击**新建产品**。根据需求和图示说明创建产品。

wKgZomad-ROAbDglAAk3D7tfPr4720.png

设备操作

创建产品完成后就可以进入设备页面添加设备,在对应产品页面进入设备管理,按照提示添加设备

**(在做正式产品时建议使用imei为devicename,方便后期维护)**

[阿里云设备创建](https://help.aliyun.com/document_detail/73729.html?spm=a2c4g.11186623.6.573.55977b7bAjX04B)

wKgZomad-SuAe5jDABy7wGu063o497.png

# 连接阿里云

## 一机一密AT HTTP鉴权连接

- 首先需要使用HmacMD5计算哈希值用于签名,使用网址:[在线加/解密工具](http://encode.chahuo.com/)

```
明文: clientId868488076506128deviceName868488076506128productKeyk1hipglLdjU
秘钥: fef32adf6dad46c2c7cbf335d3a7b021
结果: 0f655b12adf519b9a7a2b0a990f398b6
```

- 拼接DOWNLOAD参数

```
productKey=k1hipglLdjU&sign=0f655b12adf519b9a7a2b0a990f398b6&clientId=868488076506128&deviceName=868488076506128
```

- AT交互流程如下所示

1. 激活网络

```
[03:09:17.105]发→◇AT+CGATT?

[03:09:17.106]收←◆AT+CGATT?

+CGATT: 1

OK

[03:09:24.575]发→◇AT+SAPBR=3,1,"CONTYPE","GPRS"

[03:09:24.579]收←◆AT+SAPBR=3,1,"CONTYPE","GPRS"

OK

[03:09:32.363]发→◇AT+SAPBR=3,1,"APN","CMIOT"

[03:09:32.365]收←◆AT+SAPBR=3,1,"APN","CMIOT"

OK

[03:09:38.899]发→◇AT+SAPBR=1,1

[03:09:38.901]收←◆AT+SAPBR=1,1

OK
```

2. 初始化HTTP

```
[03:09:43.901]发→◇AT+HTTPINIT

[03:09:43.903]收←◆AT+HTTPINIT

OK
```

3. 写入网址URL

```
[03:09:50.783]发→◇AT+HTTPPARA="URL",https://iot-auth.cn-shanghai.aliyuncs.com/auth/devicename

[03:09:50.786]收←◆AT+HTTPPARA="URL",https://iot-auth.cn-shanghai.aliyuncs.com/auth/devicename

OK
```

4. 设置本次请求的hearder,**注意"Content-type: " 后面有一个空格**

```
[03:09:57.667]发→◇AT+HTTPPARA="USER_DEFINED","Content-type: application/x-www-form-urlencoded"

[03:09:57.671]收←◆AT+HTTPPARA="USER_DEFINED","Content-type: application/x-www-form-urlencoded"

OK
```

5. 配置写入DOWNLOAD参数指令,**注意这个112是DOWNLOAD参数的数据长度(以字节为单位),实际使用时,要根据自己的数据长度进行修改,切记!!! 待出现DOWNLOAD后发送通过前文计算拼接出来的DOWNLOAD参数**

```
[03:10:05.246]发→◇AT+HTTPDATA=112,20000

[03:10:05.249]收←◆AT+HTTPDATA=112,20000

DOWNLOAD
```

6. 写入DOWNLOAD参数,**注意最好自己复制这串数据,然后修改具体的值,不要全部手动输入,否则很容易出问题,切记!!!**

```
[03:10:10.735]发→◇productKey=k1hipglLdjU&sign=0f655b12adf519b9a7a2b0a990f398b6&clientId=868488076506128&deviceName=868488076506128

[03:10:10.740]收←◆
OK
```

7. HTTPACTION的信息上报,正常的话会回复状态码200

```
[03:10:16.378]发→◇AT+HTTPACTION=1

[03:10:16.381]收←◆AT+HTTPACTION=1

OK
```

8. 收到信息上报正常回复状态码200,收到返回数据长度为124

```
[03:10:18.025]收←◆
+HTTPACTION: 1,200,124
```

9. 读取请求结果,**注意,HTTPREAD返回的数据中有iotId和iotToken,其中iotId的值为MQTT client的用户名,iotToken的值为MQTT client的密码**

```
[03:10:51.867]发→◇AT+HTTPREAD

[03:10:51.870]收←◆AT+HTTPREAD

+HTTPREAD: 124
{"code":200,"data":{"iotId":"2BGmgWFvoXlbi1Er9sk4k1hip0","iotToken":"137eb0759ca248b79383a60c0b0e0f80"},"message":"success"}
OK
```

10. 配置连接阿里云,**注意,第一个值为clientId,第二个值为iotId,第三个值为iotToken**

```
[03:13:32.942]发→◇AT+MCONFIG="868488076506128","2BGmgWFvoXlbi1Er9sk4k1hip0","137eb0759ca248b79383a60c0b0e0f80"

[03:13:32.945]收←◆AT+MCONFIG="868488076506128","2BGmgWFvoXlbi1Er9sk4k1hip0","137eb0759ca248b79383a60c0b0e0f80"

OK
```

11. 建立连接,**注意,收到CONNECT OK后立刻发送指令建立会话,不然会被踢,一定注意!!!**

```lua
[03:13:51.493]发→◇AT+SSLMIPSTART="a1qsHBbKtmc.iot-as-mqtt.cn-shanghai.aliyuncs.com",1883

[03:13:51.496]收←◆AT+SSLMIPSTART="a1qsHBbKtmc.iot-as-mqtt.cn-shanghai.aliyuncs.com",1883

OK

[03:13:52.911]收←◆
CONNECT OK

[03:13:53.182]发→◇AT+MCONNECT=1,120

[03:13:53.185]收←◆AT+MCONNECT=1,120

OK

[03:13:53.434]收←◆
CONNACK OK
```

- 连接成功

wKgaomad-W6ADsGiAAQwbR4bJ2A958.png

## 一机一密AT直连MQTT

- 当设备属于公共实例,使用一型一密预注册认证方式时,动态注册参数如下:

```lua
mqttClientId: clientId+"|securemode=3,signmethod=hmacsha1,timestamp=132323232|"
mqttUsername: deviceName+"&"+productKey
mqttPassword: sign_hmac(deviceSecret,content)
```

| 参数 | 说明 |
| :----------- | :----------------------------------------------------------- |
| clientId | 客户端ID:长度在64个字符内,建议使用IMEI或SN码方便区分不同客户端 |
| securemode | 安全模式: 2 (TLS直连模式),3 (TCP直连模式) |
| signmethod | 表示签名算法类型。支持hmacmd5,hmacsha1,hmacsha256。默认为hmacmd5 |
| timestamp | 表示当前时间毫秒值,可以不传递 |
| mqttPassword | 前文计算的签名值 |

- AT交互流程如下所示

1. 配置MQTT参数

```
[03:51:26.001]发→◇AT+MCONFIG="868488076506128|securemode=3,signmethod=hmacmd5|","868488076506128&k1hipglLdjU","0f655b12adf519b9a7a2b0a990f398b6"

[03:51:26.004]收←◆AT+MCONFIG="868488076506128|securemode=3,signmethod=hmacmd5|","868488076506128&k1hipglLdjU","0f655b12adf519b9a7a2b0a990f398b6"

OK
```

2. 建立连接,**注意,第一个参数需要根据实际项目productKey修改**

```
[03:51:43.546]发→◇AT+SSLMIPSTART="k1hipglLdjU.iot-as-mqtt.cn-shanghai.aliyuncs.com",1883

[03:51:43.549]收←◆AT+SSLMIPSTART="k1hipglLdjU.iot-as-mqtt.cn-shanghai.aliyuncs.com",1883

OK
```

3. 建立会话,**注意,收到 CONNECT OK 后立刻发送指令建立会话,不然会被踢,一定注意!!!**

```
[03:51:45.836]收←◆
CONNECT OK

[03:51:48.961]发→◇AT+MCONNECT=1,120

[03:51:48.964]收←◆AT+MCONNECT=1,120

OK

[03:51:49.179]收←◆
CONNACK OK
```

## 一型一密AT方式连接

- 一型一密与一机一密的主要区别在于第一次连接的时候需要根据协议请求秘钥,首先需要在阿里云打开动态注册开关,如下图所示

wKgZomad-aaALySeAAKo3UgiCGI168.png

- 使用到的参数如下所示

```lua
{
"ProductSecret": "8LQwOYSZMwp3DFBd",
"ProductKey": "k1hipglLdjU"
"DeviceName" "868488076506128"
}

明文:deviceName868488076506128productKeyk1hipglLdjUrandom123456
秘钥:8LQwOYSZMwp3DFBd
HmacMD5计算结果:20558baadb2a0b04847767980f0ee67b

DOWNLOAD参数
--random 为随机数,长度不定
productKey=k1hipglLdjU&deviceName=868488076506128&random=123456&sign=20558baadb2a0b04847767980f0ee67b&signMethod=HmacMD5
```

- 当设备属于公共实例,使用一型一密预注册认证方式时,动态注册参数如下:

```lua
mqttClientId: clientId+"|securemode=2,authType=xxxx,random=xxxx,signmethod=xxxx|"
mqttUserName: deviceName+"&"+productKey
mqttPassword: sign_hmac(productSecret,content)
```

- AT交互流程如下所示

1. 激活网络,**注意,先发送AT+CGATT?查询是否附着上GPRS数据网络,返回+CGATT: 1后,才能执行下面的三个 AT指令。**

```
[04:07:13.901]发→◇AT+CGATT?

[04:07:13.902]收←◆AT+CGATT?

+CGATT: 1

OK

[04:07:23.900]发→◇AT+SAPBR=3,1,"CONTYPE","GPRS"

[04:07:23.902]收←◆AT+SAPBR=3,1,"CONTYPE","GPRS"

OK

[04:07:31.245]发→◇AT+SAPBR=3,1,"APN","CMIOT"

[04:07:31.248]收←◆AT+SAPBR=3,1,"APN","CMIOT"

OK

[04:07:38.659]发→◇AT+SAPBR=1,1

[04:07:38.661]收←◆AT+SAPBR=1,1

OK
```

2. 初始化HTTP

```
[04:08:35.329]发→◇AT+HTTPINIT

[04:08:35.332]收←◆AT+HTTPINIT

OK
```

3. 写入网址URL

```
[04:08:44.056]发→◇AT+HTTPPARA="URL","https://iot-auth.cn-shanghai.aliyuncs.com/auth/register/device"

[04:08:44.061]收←◆AT+HTTPPARA="URL","https://iot-auth.cn-shanghai.aliyuncs.com/auth/register/device"

OK
```

4. 设置本次请求的hearder,**注意"Content-type: " 后面有一个空格**

```
[04:08:54.671]发→◇AT+HTTPPARA="USER_DEFINED","Content-Type: application/x-www-form-urlencoded"

[04:08:54.674]收←◆AT+HTTPPARA="USER_DEFINED","Content-Type: application/x-www-form-urlencoded"

OK
```

5. 配置写入DOWNLOAD参数指令,**注意这个120是DOWNLOAD参数的数据长度(以字节为单位),实际使用时,要根据自己的数据长度进行修改,切记!!! 待出现DOWNLOAD后发送通过前文计算拼接出来的DOWNLOAD参数**

```
[04:09:11.437]发→◇AT+HTTPDATA=120,20000

[04:09:11.439]收←◆AT+HTTPDATA=120,20000

DOWNLOAD
```

6. 写入DOWNLOAD参数,**注意最好自己复制这串数据,然后修改具体的值,不要全部手动输入,否则很容易出问题,切记!!!**

```
[04:09:16.944]发→◇productKey=k1hipglLdjU&deviceName=868488076506128&random=123456&sign=20558baadb2a0b04847767980f0ee67b&signMethod=HmacMD5

[04:09:16.947]收←◆
OK
```

7. HTTPACTION的信息上报,正常的话会回复状态码200

```
[04:09:26.653]发→◇AT+HTTPACTION=1

[04:09:26.656]收←◆AT+HTTPACTION=1

OK
```

8. 收到信息上报正常回复状态码200,收到返回数据长度为149

```
[04:09:28.828]收←◆
+HTTPACTION: 1,200,149
```

9. 读取请求结果

```
[04:09:43.709]发→◇AT+HTTPREAD

[04:09:43.711]收←◆AT+HTTPREAD

+HTTPREAD: 149
{"code":200,"data":{"deviceName":"868488076506128","deviceSecret":"fef32adf6dad46c2c7cbf335d3a7b021","productKey":"k1hipglLdjU"},"message":"success"}
OK
```

# 发布与订阅消息

## 发布消息

- 发布Qos0消息

```
[04:58:06.798]发→◇AT+MPUB="/k1hipglLdjU/868488076506128/user/update",0,0,"HelloWorld"

[04:58:06.802]收←◆AT+MPUB="/k1hipglLdjU/868488076506128/user/update",0,0,"HelloWorld"

OK
```

- 发布Qos1消息,**注意,Qos1 消息必须等到PUBACK返回,才能发下一条消息**

```
[04:58:43.408]发→◇AT+MPUB="/k1hipglLdjU/868488076506128/user/update",1,0,"HelloWorld"

[04:58:43.412]收←◆AT+MPUB="/k1hipglLdjU/868488076506128/user/update",1,0,"HelloWorld"

OK

[04:58:43.709]收←◆
PUBACK
```

- 通过**物联网平台-监控运维-日志服务**可以直接查看日志信息

wKgZomad-cSADkKyAARUgc57alM229.png

## 订阅消息

- 订阅主题

```
[05:01:58.568]发→◇AT+MSUB="/k1hipglLdjU/868488076506128/user/get",0

[05:01:58.572]收←◆AT+MSUB="/k1hipglLdjU/868488076506128/user/get",0

OK

[05:01:58.887]收←◆
SUBACK
```

- 设置收到数据时的打印方式
配置为0时主动上报到串口,上报的 URC 为`+MSUB:,,`
配置为1时为缓存模式。有新订阅消息时,上报的URC为 `+MSUB:`

```
[05:02:05.102]发→◇AT+MQTTMSGSET=0

[05:02:05.105]收←◆AT+MQTTMSGSET=0

OK
```

- 通过阿里云平台发布消息

wKgaomad-c-AWFKaAAjES2WhuYc690.png
声明:本文内容及配图由入驻作者撰写或者入驻合作网站授权转载。文章观点仅代表作者本人,不代表电子发烧友网立场。文章及其配图仅供工程师学习之用,如有内容侵权或者其他违规问题,请联系本站处理。 举报投诉
  • 开发板
    +关注

    关注

    25

    文章

    4976

    浏览量

    97265
  • 阿里云
    +关注

    关注

    3

    文章

    943

    浏览量

    42979
  • MQTT
    +关注

    关注

    5

    文章

    650

    浏览量

    22448
  • 合宙通信
    +关注

    关注

    0

    文章

    147

    浏览量

    1730
收藏 人收藏

    评论

    相关推荐

    AT开发FOTA远程升级:Air780EP低功耗4G模组

    ​针对客户朋友的应用反馈,特编辑本篇文章:基于Air780EP模组AT开发的FOTA远程升级指南
    的头像 发表于 10-25 17:31 291次阅读
    AT<b class='flag-5'>开发</b>FOTA远程升级:<b class='flag-5'>Air780EP</b>低功耗4G模组

    MQTT应用:Air780EP低功耗4G模组AT开发

    本文应各位大佬邀请,详细讲解Air780EP模组MQTT应用的多个AT命令。
    的头像 发表于 10-25 17:27 266次阅读
    <b class='flag-5'>MQTT</b>应用:<b class='flag-5'>Air780EP</b>低功耗4G模组AT<b class='flag-5'>开发</b>

    Air780EP低功耗4G模组AT开发示例:阿里应用篇

    推出基于Air780EP模组AT开发阿里应用指南。 一、相关准备工作 1.1 硬件准备 合宙Air7
    的头像 发表于 10-14 14:22 865次阅读
    <b class='flag-5'>Air780EP</b>低功耗4G模组AT<b class='flag-5'>开发</b>示例:<b class='flag-5'>阿里</b><b class='flag-5'>云</b>应用篇

    超实用!阿里应用——Air780EP低功耗4G模组AT开发示例

    特别推出基于Air780EP模组AT开发阿里应用指南。 **一、相关准备工作 ** 1.1 硬件准备 合宙
    的头像 发表于 10-08 09:55 1300次阅读
    超实用!<b class='flag-5'>阿里</b><b class='flag-5'>云</b>应用——<b class='flag-5'>Air780EP</b>低功耗4G模组AT<b class='flag-5'>开发</b>示例

    Air780EP模块FTP应用AT开发详解

    基于合宙Air780EP使用AT指令接入FTP的超详细教程!
    的头像 发表于 08-21 11:16 487次阅读
    <b class='flag-5'>Air780EP</b><b class='flag-5'>模块</b>FTP应用AT<b class='flag-5'>开发</b>详解

    AT指令速通FTP:合宙Air780EP模块超详细教程

    合宙Air780EP低功耗4G模组AT开发接入FTP超详细示例!
    的头像 发表于 08-20 17:40 2371次阅读
    AT指令速通FTP:合宙<b class='flag-5'>Air780EP</b><b class='flag-5'>模块</b>超详细教程

    合宙Air780EP模块——AT指令MQTT接入OneNET开发指南

    物联网设备要互动,Air780EP模块是桥梁。用AT指令告诉MQTT:“帮我把话带给OneNET吧!”MQTT就忙着打包数据,像寄信一样传给OneNET。OneNET收到后,处理、存着
    的头像 发表于 08-19 16:40 2063次阅读
    合宙<b class='flag-5'>Air780EP</b><b class='flag-5'>模块</b>——AT指令<b class='flag-5'>MQTT</b><b class='flag-5'>接入</b>OneNET<b class='flag-5'>开发指南</b>

    MQTT应用看这篇!合宙Air780EP_LuatOS_MQTT应用指南

    Air780EP 是合宙的低功耗4G模组之一,支持LuatOS的脚本二次开发,即使是不太懂技术的老板,也能轻松使用 Air780EP开发产品。 本文应各位大佬邀请,详细讲解了
    的头像 发表于 08-08 17:13 1781次阅读
    <b class='flag-5'>MQTT</b>应用看这篇!合宙<b class='flag-5'>Air780EP_LuatOS_MQTT</b>应用<b class='flag-5'>指南</b>

    合宙Air780EP模块Lua开发阿里应用指南

    合宙Air780EP模块Lua开发阿里超详细教学!看完包学会!
    的头像 发表于 08-08 09:00 883次阅读
    合宙<b class='flag-5'>Air780EP</b><b class='flag-5'>模块</b>Lua<b class='flag-5'>开发</b><b class='flag-5'>阿里</b><b class='flag-5'>云</b>应用<b class='flag-5'>指南</b>

    Air780EP模块 AT开发-MQTT接入OneNET移动物联网平台应用指南

    应用概述  使用AT方式通过MQTT协议连接onenetstudio。官网地址:https://open.iot.10086.cn/材料准备Air780EP(V)开发板一套,包括天线SIM卡,USB
    的头像 发表于 07-24 14:24 781次阅读
    <b class='flag-5'>Air780EP</b><b class='flag-5'>模块</b> AT<b class='flag-5'>开发</b>-<b class='flag-5'>MQTT</b><b class='flag-5'>接入</b>OneNET移动物联网平台应用<b class='flag-5'>指南</b>

    Air780EP模块 LuatOS开发-MQTT接入阿里应用指南

    简介本文简单讲述了利用LuatOS-Air进行二次开发,采用一型一密、一机一密两种方式认证方式连接阿里。整体结构如图关联文档和使用工具:LuatOS库
    的头像 发表于 07-24 13:51 731次阅读
    <b class='flag-5'>Air780EP</b><b class='flag-5'>模块</b> LuatOS<b class='flag-5'>开发</b>-<b class='flag-5'>MQTT</b><b class='flag-5'>接入</b><b class='flag-5'>阿里</b><b class='flag-5'>云</b>应用<b class='flag-5'>指南</b>

    Air780EP模块AT开发-HTTP应用指南

    Air780EP模块AT开发-HTTP应用指南
    的头像 发表于 07-22 14:38 586次阅读
    <b class='flag-5'>Air780EP</b><b class='flag-5'>模块</b>AT<b class='flag-5'>开发</b>-HTTP应用<b class='flag-5'>指南</b>

    Air780E/Air780EP/Air780EQ/Air201模块遇到内存死机如何分析

    Air780E/Air780EP/Air780EQ/Air201模块遇到内存死机如何分析简介本文档适用于合宙
    的头像 发表于 07-19 16:07 497次阅读
    <b class='flag-5'>Air780</b>E/<b class='flag-5'>Air780EP</b>/<b class='flag-5'>Air780</b>EQ/<b class='flag-5'>Air</b>201<b class='flag-5'>模块</b>遇到内存死机如何分析

    Air780E/Air780EP/Air780EQ/Air201模块遇到死机问题如何分析

    Air780E/Air780EP/Air780EQ/Air201模块遇到死机问题如何分析简介本文档适用于合宙
    的头像 发表于 07-19 15:37 606次阅读
    <b class='flag-5'>Air780</b>E/<b class='flag-5'>Air780EP</b>/<b class='flag-5'>Air780</b>EQ/<b class='flag-5'>Air</b>201<b class='flag-5'>模块</b>遇到死机问题如何分析

    Air780EP模块AT开发FOTA远程升级指南

    Air780EP模块AT开发FOTA远程升级指南简介AT版本的远程升级主要是对AT固件进行升级,实际方式为通过合宙官方IOT平台升级或者使用自己搭建的服务器进行升级服务。关联文档和使用
    的头像 发表于 07-19 15:16 721次阅读
    <b class='flag-5'>Air780EP</b><b class='flag-5'>模块</b>AT<b class='flag-5'>开发</b>FOTA远程升级<b class='flag-5'>指南</b>