域格 4G 系列模组接入 ThingsCloud

ThingsCloud 是开放的物联网公有云平台，为物联网设备提供统一接入和低代码应用。这个示例我们分享 域格 4G 模组 接入 ThingsCloud 的步骤。感谢域格工程师贺工、王工、谢工为 ThingsCloud 提供接入测试。

域格 4G 系列模组的 AT 指令集支持 MQTT，请参考以下步骤，只需几分钟就可以接入 ThingsCloud 云平台并上报数据，还可以从云平台下发消息实现远程对硬件设备实时控制。

关于 ThingsCloud 标准 MQTT 接入协议，请浏览 设备 MQTT 接入。

支持模组

示例中接入步骤适用于以下模组型号：

• Cat1：
  • CLM920_YV9
  • CLM920_RC5(RV5、RE5)
  • CLM920_KV5
  • CLM920_KV7
• Cat4：
  • CLM920_JC3(JD3)

在控制台创建设备

进入 ThingsCloud 控制台，创建一个新的设备，进入 设备详情页>连接，获得以下信息，用于随后的设备 MQTT 接入。

• MQTT 地址、端口
• AccessToken: 作为 MQTT username
• ProjectKey: 作为 MQTT password

模组 AT 命令

检查网络

AT+CSQ
+CSQ: 20,99

OK

AT^SYSINFO 
^SYSINFO: 2,3,0,9,1

OK

初始化 MQTT

AT+IMQTTMODE=2,0,0 

OK

AT+IMQTTPARA=TIMEOUT,1,CLEAN,0,KEEPALIVE,60,VERSION,3.1.1 

OK

设置 MQTT 连接参数

在 设备详情页>连接 复制 <MQTT地址>、设备证书 <AccessToken> 和 <ProjectKey>。

AT+IMQTTADDR=<MQTT地址>,1883,yuge_01 

OK

AT+IMQTTUSER=<AccessToken>,<ProjectKey>

OK

建立 MQTT 连接

AT+IMQTTCONN 

+IMQTTCONN:0

OK

至此，模组和云平台已建立 MQTT 连接，在 ThingsCloud 控制台可以看到设备状态显示为在线。

接下来，我们可以向云平台发布消息或订阅消息。

点此了解 MQTT 主题一览

MQTT 上报属性

先来发送一个简单的属性上报，ThingsCloud 支持 JSON 格式的属性上报，我们来模拟设备的几个属性值，如下：

{    "temperature": 28.5,    "light": 2000,    "switch": true}

以上 JSON 包含了 3 个属性：温度、光照强度、开关状态，我们将 JSON 文本去掉换行和多余的空格，压缩为一行如下：

{"temperature": 28.5,"light": 2000,"switch": true}

在上报数据之前，我们先订阅以下主题，用来接收云平台的属性上报回复。这个订阅不是必须的，也可以跳过。

AT+IMQTTSUB=attributes/response,0 
+IMQTTSUB:2,0

OK

现在使用 MQTT 发布，将刚才打包好的 JSON 属性消息上报到云平台，如下：

AT+IMQTTPUBEX=attributes,1,0,50
 > {"temperature": 28.5,"light": 2000,"switch": true}

+IMQTTPUBEX:4,0

OK

如果订阅了云平台的属性上报回复主题，立即会收到响应消息，如下：

+IMQTTRCVPUB:2,"attributes/response",31,"{"result":1,"ts":1666247574224}"

此时，在云平台的设备详情页，可以看到出现了这几个上报的属性值。如果继续上报新的属性值，云平台页面可以看到属性值实时变化。

通过在属性 JSON 结构中放置更多属性，您可以将设备上更多数据上传到云平台。

在云平台的设备调试页面，可以看到刚才上报的属性消息，如下图：

MQTT 订阅属性下发

接下来订阅云平台的属性下发主题，来实时接收云平台下发的消息。

AT+IMQTTSUB=attributes/push,0 

+IMQTTSUB:2,0

OK

订阅成功后，我们上云平台的设备页面将 switch 拨动属性下边的开关。此时模组实时收到云平台下发的属性消息。

+IMQTTRCVPUB:2,"attributes/push",16,"{"switch":false}"

在云平台的设备调试页面，可以看到刚才下发的属性消息，如下图：

以上仅介绍常用的两个 MQTT 主题，更多主题和相应的功能，请参考 MQTT 主题一览

高级功能

一型一密

对于需要量产的设备，通常使用动态获取证书的方式，即实现一型一密。点此了解 设备动态获取证书。

更多设备接入示例，请浏览 教程