Air780EP是合宙推出的一款低功耗4G全网通模组，兼容模组行业1618经典封装，支持OpenCPU开发及全功能数传AT开发，可广泛应用于多样物联网终端。

针对客户朋友需求反馈，本期特别推出基于Air780EP模组AT开发的阿里云应用指南。

一、相关准备 职业 

1.1 硬件准备

• 合宙Air780EP_全IO开发板一套，包括天线、SIM卡；

• USB线

• PC电脑

1.2 软件准备

• 串口调试工具如果没有准备，推荐使用LLCOM：https://llcom.papapoi.com

• AT固件下载https://gitee.com/openLuat/airm2m-ec718-at/releases

• 准备设备证书及产品证书

–设备证书{ “ProductKey”: “k1hipglLdjU”, “DeviceName”: “868488076506128”, “DeviceSecret”: “fef32adf6dad46c2c7cbf335d3a7b021”}–产品证书{ “ProductSecret”: “8LQwOYSZMwp3DFBd”, “ProductKey”: “k1hipglLdjU”}

特别提醒：

上方证书信息仅为本教程使用，用户需要使用自己的证书信息。

二、阿里云操作 

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

2.1 产品操作

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

2.2 设备操作

创建产品完成后就可以进入设备页面添加设备，在对应产品页面进入设备管理，按照提示添加设备。在做正式产品时提议使用imei为devicename，方便后期维护。

三、连接阿里云 

使用AT方式连接阿里云分为：一机一密和一型一密两种方式，其中一机一密又包括HTTP鉴权连接和MQTT直连。

下文将根据不同连接方式分别讲解：

3.1 一机一密AT HTTP鉴权连接

3.1.1 第一需要使用H cMD5计算哈希值用于签名

3.1.2 拼接DOWNLOAD参数

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

3.1.3 AT交互流程如下所示：

01）激活网络

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

[03:09:17.106]收←◆AT+CGATT?+CGATT: 1OK[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,1OK

02）初始化HTTP

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

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

03）写入网址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/devicenameOK

04）设置本次请求的hearder

注意：”Content-type: ” 后面有一个空格。

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

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

05）配置写入DOWNLOAD参数指令

注意：这个112是DOWNLOAD参数的数据长度（以字节为单位），实际使用时，要根据自己的数据长度进行修改，切记！！！ 

待出现DOWNLOAD后发送通过前文计算拼接出来的DOWNLOAD参数。

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

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

06）写入DOWNLOAD参数

注意：最好自己 这串数据， 接着修改具体的值，不要全部手动输入，否则很容易出 难题，切记！！！

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

[03:10:10.740]收←◆OK

07）HTTPACTION的信息上报

[03:10:16.378]发→◇AT+HTTPACTION=1[03:10:16.381]收←◆AT+HTTPACTION=1OK

08）收到信息上报

正常回复 情形码200，收到返回数据长度为124：

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

09）读取请求 结局

注意：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”:”13 7eb0759ca248b79383a60c0b0e0f80″}, “message”:”success”}OK

10）配置连接阿里云

注意：第一个值为clientId，第二个值为iotId，第三个值为iotToken。

[03:13:32.942]发 →◇AT+MCONFIG=”868488076506128″,”2BGmgWFvoXlbi1Er9sk 4k1hip0″,”137eb0759ca248b79383a60c0b0e0f80″

[03:13:32.945]收 ←◆AT+MCONFIG=”868488076506128″,”2BGmgWFvoXlbi1Er9sk 4k1hip0″,”137eb0759ca248b79383a60c0b0e0f80″OK

11）建立连接

注意：收到CONNECT OK后立刻发送指令建立会话，不然会被踢，必定注意！！！

[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”,1883OK[03:13:52.911]收←◆CONNECT OK[03:13:53.182]发→◇AT+MCONNECT=1,120

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

3.1.4 连接成功

3.2  一机一密AT直连MQTT

3.2.1 注册参数

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

mqttClientId: clientId+”|securemode=3,signmethod=h csha1,timestam p=132323232|”

mqttUsername:deviceName+”&”+productKey

mqttPassword:sign_h c(deviceSecret,content)

3.2.2 AT交互流程如下所示：

01）配置MQTT参数

[03:51:26.001]发→◇AT+MCONFIG=”868488076506128|securemode=3,signmethod=h cmd5|”,”868488076506128&k1hipglLdjU”,”0f655b12adf519b9a7a2b0a990f398b6″

[03:51:26.004]收←◆AT+MCONFIG=”868488076506128|securemode=3,signmethod=h cmd5|”,”868488076506128&k1hipglLdjU”,”0f655b12adf519b9a7a2b0a990f398b6″OK

02）建立连接

注意：第一个参数需要根据实际项目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”,1883OK

03）建立会话

注意：收到 CONNECT OK 后立刻发送指令建立会话，不然会被踢，必定注意！！！

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

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

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

OK

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

3.3 一型一密AT方式连接

一型一密与一机一密的主要区别在于，第一次连接的时候需要根据协议请求秘钥。

3.3.1 第一需要在阿里云打开动态注册开关：

3.3.2 使用到的参数如下所示：

{        “ProductSecret”: “8LQwOYSZMwp3DFBd”,    “ProductKey”: “k1hipglLdjU”    “DeviceName” “868488076506128”}

明文：deviceName868488076506128productKeyk1hipglLdjUrandom123456秘钥：8LQwOYSZMwp3DFBdH cMD5计算 结局：20558baadb2a0b04847767980f0ee67bDOWNLOAD参数–random 为随机数，长度不定

productKey=k1hipglLdjU&deviceName=868488076506128&random=123456&sign=20558baadb2a0b04847767980f0ee67b&signMethod=H cMD5

3.3.3 注册参数

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

mqttClientId:clientId+”|securemode=2,authType=xxxx,random=xxxx,signmethod=xxxx|”

mqttUserName:deviceName+”&”+productKey

mqttPassword:sign_h c(productSecret,content)

3.3.4 AT交互流程如下所示：

01）激活网络

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

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

[04:07:13.902]收←◆AT+CGATT?+CGATT: 1OK[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,1OK

02）初始化HTTP

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

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

03）写入网址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

04）设置本次请求的hearder

注意：”Content-type: ” 后面有一个空格。

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

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

05）配置写入DOWNLOAD参数指令

注意：这个120是DOWNLOAD参数的数据长度（以字节为单位），实际使用时，要根据自己的数据长度进行修改，切记！！！待出现DOWNLOAD后发送通过前文计算拼接出来的DOWNLOAD参数。

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

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

06）写入DOWNLOAD参数

注意：最好自己 这串数据， 接着修改具体的值，不要全部手动输入，否则很容易出 难题，切记！！！

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

[04:09:16.947]收←◆OK

07）HTTPACTION的信息上报

[04:09:26.653]发→◇AT+HTTPACTION=1[04:09:26.656]收←◆AT+HTTPACTION=1OK

08）收到信息上报

正常回复 情形码200，收到返回数据长度为149：

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

09）读取请求 结局

[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

四、发布与订阅消息 

4.1 发布消息

4.1.1 发布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

4.1.2 发布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

4.1.3 查看日志信息：

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

4.2 订阅消息

4.2.1 订阅主题：

[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

4.2.2 设置收到数据时的打印方式：

配置为0时主动上报到串口，上报的URC为+MSUB：<topic>,<len>,<message> 配置为1时为缓存模式。

有新订阅消息时，上报的URC为 +MSUB：<store_addr>。

[05:02:05.102]发→◇AT+MQTTMSGSET=0[05:02:05.105]收←◆AT+MQTTMSGSET=0OK

4.2.3 通过阿里云平台发布消息：