NBIOT模块 BC26通过MQTT协议连接到onenet（新版）

命令说明

基础AT指令
ATI显示MT的ID信息
AT+CIMI查询IMSI
AT+CGSN查询产品序列号
AT+CGATT?查询当前PS域状态
AT+QBAND查询或设置移动波段操作
AT+CSQ查询信号强度
AT+CEREG查询网络注册状态
AT+CGPADDR查询PDP地址
MQTT配置指令
AT+QMTCFG配置MQTT可选参数
AT+QMTOPEN打开MQTT客户端网络
AT+QMTCLOSE关闭MQTT客户端网络
AT+QMTCONN连接客户端到MQTT服务器.
AT+QMTDISC客户端断开与MQTT服务器的连接
AT+QMTSUB订阅主题
AT+QMTUNS退订主题
AT+QMTPUB发布消息

流程

OneNet平台(新版)

OneNET - 中国移动物联网开放平台

第一步：配置OneNet平台

登入个人账号后，点击进入开发者中心，进入管理后台。

在页面左侧导航栏中，依次选择[产品开发]→[创建产品]，进入产品创建页面。

在产品创建页面配置产品基本信息

产品品类：根据实际需求在下拉菜单中选择（如智能家居等）。

智能化方式选择:

1.设备接入（自定义开发）

适用于已有硬件设备需接入平台的场景，可自主开发设备通信协议。

2.产品智能化（OneNet平台方案）

可直接使用OneNet自带的[中移和物]APP实现设备管理与控制，无需额外开发客户端。

在产品列表找到已创建产品，点击对应产品开发按钮，进入产品开发详情页。

在产品开发详情页，设置物模型。

可选自定义功能，按需填写功能名称、数据类型、标识符等信息。

在页面左侧导航栏，找到设备接入管理分类下的设备管理选项并点击，随后在对应功能区，点击添加设备。

经上述步骤，OneNet平台相关配置已全部完成。

第二步：NB模块接线

NB模块  -----  USB转TTL
VCC     -----  5V
GND     -----  GND
TX      -----   RX
RX      -----   TX

实物接线

第三步：连接OneNet云平台

将USB转TTL模块接入设备，打开串口调试助手，选定对应通信端口，设置波特率为115200。之后通过发送AT指令，即可实现设备与OneNet平台的连接，完成数据的上传与数据下发操作。

AT命令流程及命令结果：

1. 查询模块信息

发送指令：ATI

说明：查询模块型号、固件版本等基础信息。

预期响应：Quectel_Ltd   Quectel_BC26   Revision: BC26NCR01A09

2. 查询国际移动用户识别码（IMSI）

发送指令：AT+CIMI

说明：获取SIM卡的IMSI号码，用于识别移动用户。

预期响应：460049167111311  OK

3. 查询产品序列号

发送指令：AT+CGSN=1

说明：获取设备的国际移动设备识别码。

预期响应：+CGSN: 863409052504122

4.查询GPRS附着状态

发送指令：AT+CGATT?

说明：检查模块是否已附着到GPRS网络（1=已附着，0=未附着）。

预期响应：+CGATT: 1  OK

5.查询频段信息

发送指令：AT+QBAND?

说明：查询当前模块所使用的频段信息。

预期响应：+QBAND: 1,3,5,8

6.查询信号强度

发送指令：AT+CSQ

说明：检查当前网络信号质量（0-31，值越大信号越强）。

预期响应：+CSQ:18,0 OK

7.查询信号强度

发送指令：AT+CGPADDR=1

说明：查询PDP对应的IP地址，PDP用于建立数据连接。

预期响应：+CGPADDR: 1,"10.133.68.48"

8.配置MQTT协议版本

发送指令：AT+QMTCFG="version",0,4

说明：设置MQTT客户端（ID=0）使用MQTT  v3.1.1协议。

预期响应：OK

9.打开MQTT连接

发送指令：AT+QMTOPEN=0,"mqtts.heclouds.com",1883

说明：建立服务器连接,MQTT客户端标识符为0。"mqtts.heclouds.com"为MQTT服务器，1883为服务器端口号域名。

预期响应：OK  +QMTOPEN: 0,0  

10.连接客户端到MQTT服务器

发送指令：

AT+QMTCONN=0,"Test","0O6AkE7n1h","version=2018-10-31&res=products%2F0O6AkE7n1h%2Fdevices%2FTest&et=4859849405&method=md5&sign=8sYIABDDQFB3WDnWzeeJog%3D%3D"

说明：参数0为MQTT客户端标识符，"Test"为MQTT客户端ID，"0O6AkE7n1h"为产品ID，"version=...&sign=..."为签名认证参数。

预期响应：OK  +QMTCONN: 0,0,1

其中Token获取：token获取链接在文章末。

11.订阅MQTT主题

发送指令：AT+QMTSUB=0,1,"$sys/0O6AkE7n1h/Test/thing/property/set",2

说明：订阅平台下发属性设置的主题，0为MQTT客户端标识符，1为数据包标识符，

"$sys/0O6AkE7n1h/Test/thing/property/set"为订阅的主题名称，2为QoS级别。

预期响应：OK   +QMTSUB: 0,1,0,0

12.发布MQTT消息

发送指令：

AT+QMTPUB=0,0,0,0,"$sys/0O6AkE7n1h/Test/thing/property/post","{"id":"123","params":{"temp":{"value":2}}}"

说明：准备发布MQTT消息到指定主题，参数依次为客户端ID、QoS 等级、保留标志、消息主题（"$sys/0O6AkE7n1h/Test/thing/property/post"）、消息内容（温度为2的JSON数据）。

响应：OK  +QMTPUB: 0,0,0

OneNet平台数据交互操作：

数据上报成功后，可通过OneNet平台实时查看数据：

在平台控制台找到已创建设备，点击进入设备详情页，切换至属性标签页，即可直观查看设备成功上报的实时数据

平台数据下发操作

在 OneNet 平台控制台找到已创建设备，点击进入设备详情页。

切换至设备调试标签页，进入数据下发调试界面。在调试界面中找到[属性设置]模块。

点击[启动调试]按钮，激活数据输入框。

在串口调试助手中，可实时监控设备接收数据的状态：

总结命令流程

ATI
AT+CIMI
AT+CGSN=1
AT+CGATT?
AT+QBAND?
AT+CSQ
AT+CGPADDR=1
AT+QMTCFG="version",0,4
AT+QMTOPEN=0,"mqtts.heclouds.com",1883
AT+QMTCONN=0,"Test","0O6AkE7n1h","version=2018-10-31&res=products%2F0O6AkE7n1h%2Fdevices%2FTest&et=4859849405&method=md5&sign=8sYIABDDQFB3WDnWzeeJog%3D%3D"
AT+QMTSUB=0,1,"$sys/0O6AkE7n1h/Test/thing/property/set",2 
AT+QMTPUB=0,0,0,0,"$sys/0O6AkE7n1h/Test/thing/property/post","{"id":"123","params":{"temp":{"value":2}}}"

Token软件及获取Token密钥方式链接: https://pan.baidu.com/s/1FMKOybgvJ_rniJfiSsCUIg?pwd=yths 提取码: yths