Lierda_NB860&MB960&MB260MQTT对接Lierda X平台指导（上）

NB-IoT_001

1.与Lierda X平台对接流程

1.1.平台侧操作说明
1.1.1.用户注册

步骤1：访问 https://account.xiot.senthink.com/login点击”注册”按钮，进入注册页面

步骤2：填写注册信息，完成注册

步骤3：完成信息认证，开通物联网平台账号

1.1.2.智能设备接入前准备事项

智能设备在接入 Lierda X 平台之前，需要先完成下事项：

1. 在平台提供的管理后台注册一个硬件厂商账号，云平台会为该账号分配一个厂商的唯一标识OpenID；

2. 注册厂商账号后，需要在平台提供的管理后台上创建一个产品类，云平台会为该产 品分配一个产品的唯一标识 ProductID 以及产品的密钥 ProductKey（用于入网加密以及会话 Key 的更新，注意保密！）；

3. 智能设备接入 Lierda X平台之前，必须要将基础参数烧录进设备。后面设备与平 台的通信需要这些参数才能完成，不同设备所需要烧录的参数如下：

（1）一型一密免注册设备：NodeEui、OpenID、ProductID、ProductKey

（2）一型一密预注册设备：NodeEui、OpenID、ProductID、ProductKey

（3）一机一密预注册设备：NodeEui、OpenID、ProductID、ProductKey、 ClientID、DeviceSecret 至此，接入前的准备工作完成！

1.1.3.注册，创建产品设备

前提条件：

已在Lierda X 平台注册账号。

图1产品创建页面

步骤1：创建产品

1.登录物联网平台控制台

2.在云平台页面，找到产品管理，单击产品管理进入产品详情页面。在中间导航栏，选择创建产品，单击创建产品，如下图所示。

图2产品创建

步骤2：设置物模型、topic消息等

添加自定义Topic

1. 登录物联网平台控制台。

2. 在产品管理页面，找到对应的产品，单击产品进入产品详情页面。

3. 在产品页面，找到需要自定义Topic类的产品，并单击对应操作栏中的查看按钮。

4. 在产品详情页面，单击Topic类详情 > 自定义Topic > 定义Topic类。

5. 配置参数，单击确认。

图3新建topic

步骤3：创建设备

1.登录物联网平台控制台。

2.在左侧导航栏，选择设备管理 > 设备列表。

3.在设备页面，单击添加设备。

4.在添加设备对话框中，输入设备信息，单击确认。

图 4设备创建

执行结果

设备注册成功后，将自动弹出设备证书弹框。您可以查看、一键复制设备证书信息，包含DeviceID、DeviceSecret、OpenID、ProductID和ProductKey，是设备与物联网平台进行通信的重要身份认证，建议您妥善保管。

后续步骤

1.在设备列表页，单击对应设备，进入设备详情页。您可以查看设备证书信息、数据加密密钥、继承产品的基础信息、禁用/启用设备、设备状态、激活时间、最后在线/离线时间等。

2.在设备详情页，可对设备在线调试、远程配置和日志分析。

3.在设备列表页，可以删除不再使用的设备。删除设备不可撤回，请谨慎操作。

4.添加云云接入的设备后将同步从对应第三方平台上添加。

1.2.模组侧操作说明
1.2.1.上电检查流程

（1）AT //判断模组是否上电开机成功

（2）AT+CFUN=1 //关闭飞行模式

（3）AT+CEREG? //判断 PS 域附着状态，第二个参数为 1 或 5 表示附着正常

1.2.2.设置服务端IP或域名

使用AT+MQTTCFG="host",0,"host_name",1883命令设置服务端IP或域名

其中，<host_name>：服务端的IP或域名：1~2000字节字符串。Lierda X平台MQTT接入默认域名为： mqtt.xiot.senthink.com,1883

示例：AT+MQTTCFG="host",0,"mqtt.xiot.senthink.com",1883

1.2.3.设置客户端标识

使用AT+MQTTCFG="clientid",<Link_ID>,<client_id>命令设置客户端标识

< Link_ID > 连接ID：取值0~2。

<client_id> 客户端标识符：字符串类型，1~128字节字符串。贤芯平台clientid可在设备详情页查看。file:///C:/Users/lsd/AppData/Local/Temp/msohtmlclip1/01/clip_image014.jpg

示例：

AT+MQTTCFG="clientid",0,"ACF37***************EA9F3582"

1.2.4.连接服务端

使用AT+MQTTCONN=<Link_ID>,<ssl_enable>,<will_flag>,<username>,<password>命令连接服务端，在收到+MQTTCONNACK: 0,0,0 OK即已经成功连接上平台。

< Link_ID > 连接ID：取值0~2。

<ssl_enable> SSL TCP连接使能：

0：不采用；

1：采用SSL TCP连接。

will_flag 遗嘱标志，取值0或1：

0：不带遗嘱；

1：CONNECT报文带有遗嘱。

<username> 用户名：0~512字节的字符串。

<password> 密码：0~512字节的字符串。

注：贤芯平台登录账号以及密码在创建设备时自动生成，可在设备详情页查看。

示例：

AT+MQTTCONN=0,0,0,"5*******-********-8************3","7*******************AB2C2"

1.2.5.订阅MQTT消息

使用AT+MQTTSUB=<Link_ID>,<packId>,<topic1>,<qos1>[,<topic2>,<qos2>]

[,<topic3>,<qos3>]命令订阅消息，已经订阅成功的消息可在平台上的设备topic列表查看。

< Link_ID > 连接ID：取值0~2。

<packId> 报文标识符：取值1~65535。

<topic> 主题名：0~512字节字符串。一次最多可订阅3个主题。

<qos> 订阅消息QOS等级：取值0~2。

示例：

AT+MQTTSUB=0,1,"/sys/5********/*********/86**********83/downlink",1

收←◆

+MQTTSUBACK: 0,1,0

OK

1.2.6.数据交互

通过AT+MQTTPUB=<Link_ID>,<packId>,<qos>,<retain>,<topic>,<payload>命令向平台发布消息。

< Link_ID > 连接ID：取值0~2。

<packId> 报文标识符：取值1~65535。

<qos> 发布消息QOS等级：取值0~2。

<retain> 保留标志：取值0~1。

<topic> 主题名：0~512字节字符串。

<payload> 有效载荷：0~1500字节字符串。

示例：

AT+MQTTPUB=0,1,0,0,"/sys/5********/*********/86**********83/uplink","{"MessageId" :

1231,"HeaderCtrl":4,"Mode":1,"Nonce":10,"Payload":"CB963****************EFE"}"

[11:06:12.040]收←◆

[11:06:12.060]收←◆

+MQTTPUBACK: 0,1,0

OK

[11:06:13.680]收←◆

+MQTTRECV: 0,8,1,0, /sys/5********/*********/86**********83/downlink,{"MessageId":1231,"HeaderCtrl":4,"Code":"200","Msg":"SUCCESS"}

+MQTTRECV: 0,9,1,0, /sys/5********/*********/86**********83/uplink_ack,{"MessageId":1231,"HeaderCtrl":4,"Code":"200","Msg":"SUCCESS"}