设备接入常见问题
设备接入常见问题
设备接入
ThingsCloud 支持哪些品牌的物联网设备接入?
ThingsCloud 不限定接入设备的具体品牌和型号。通过 ThingsCloud 平台的开放协议,任何设备都可以 直连 或 通过网关连接 到 ThingsCloud。
任何设备厂商、硬件开发者都可以将设备接入 ThingsCloud。看看哪些设备在接入 ThingsCloud
设备可使用哪些通信方式接入平台?
对于 直连设备 或者 网关设备,可通过以下通信方式直接接入平台:
- 蜂窝网络(2G/3G/4G/5G/NB-IoT)
- WiFi
- 以太网
如果设备不具备以上通信方式,可作为 子设备,通过网关设备接入平台。子设备和网关设备之间的通信方式,平台不做任何限制,常用的有:蓝牙/BLE、ZigBee、LoRa、433MHz、RS485/232、各类工业以太网等。
更多内容请阅读 设备通信方式
平台支持哪些设备接入协议?
对于 直连设备 或 网关设备,平台支持多种网络接入协议,包括:
- MQTT
- TCP
- HTTP
详细介绍请阅读 设备接入指南
设备 MQTT 接入
可以模拟设备 MQTT 接入平台吗?
可以,您可以通过 MQTT 客户端工具,模拟真实的设备,快速熟悉和测试平台的接入协议。详细介绍请浏览:
- MQTTX 模拟设备接入 ThingsCloud
- [MQTT.fx 视频教程] 如何连接云平台?
- [MQTT.fx 视频教程] 如何上报属性到云平台?🎦
- [MQTT.fx 视频教程] 如何实时接收云平台下发的属性?🎦
- [MQTT.fx 视频教程] 如何从云平台获取当前属性?🎦
- [MQTT.fx 视频教程] 如何上报事件到云平台?🎦
- [MQTT.fx 视频教程] 如何实时接收云平台下发的命令?🎦
设备 MQTT 接入平台,发布和订阅主题(Topic)有哪些?
ThingsCloud 支持一套简洁的 MQTT 主题(Topic)规范,大大简化了硬件设备接入的过程。
详细介绍请浏览 MQTT 主题一览
是否可以自定义 MQTT 主题(Topic)?
可以,对于一些个性化场景,平台也提供了灵活的自定义主题。您可以创建自定义数据流,来实现自定义主题,并配合消息规则以及强大的云函数,可实现任何通信格式的需求。
详细介绍请浏览 自定义数据流
设备 TCP 接入
可以模拟设备 TCP 接入平台吗?
可以,您可以使用任何 TCP 测试工具,按照平台的设备 TCP 接入协议,设置地址和端口,连接后立即发送注册包,即可完成连接。
详细介绍请浏览 设备 TCP 接入
设备端 TCP 配置都正确,为什么还是连接不上平台?
如果您确认在设备端,已经配置了正确的地址、端口、注册包,仍然无法上线,请检查是否在平台的设备类型中创建了自定义数据流,并绑定 TCP 通道。
详细介绍请浏览 设备 TCP 接入
DTU & Modbus 设备接入
DTU 如何接入平台?
DTU 通常可使用 TCP 客户端 或 MQTT 客户端 模式接入平台,详细介绍请浏览:
RS485/Modbus 设备如何接入平台?
可通过 DTU 模块接入,详情请浏览 RS485/Modbus 设备通过 DTU 透传接入 ThingsCloud。
Modbus 设备已经回复 HEX 报文,为什么无法解析出属性值?
如果在设备调试日志中回复的 HEX 报文正确,仍然无法解析生成属性值,请检查是否正确设置 Modbus 寄存器读写类型。
例如:在下发查询中用了 03
功能码,那么数值寄存器读写类型应该设置为 读写,如果是 04
功能码,则使用 只读。
DTU 已在线,为什么不显示传感器数据?
DTU 成功连接到平台后,DTU 连接的 Modbus 设备数据并不会自动在平台显示,您需要完成一些必要的配置。
请务必先阅读 [保姆级教程] RS485/Modbus 设备通过 DTU 透传接入 ThingsCloud,按文中步骤完成配置。
如果您认为配置正确,但仍然无法正常显示属性数据,请在平台的设备详情页打开设备调试日志,检查以下几点:
- 是否可以正确向设备下发 Modbus 指令,如果正确配置了 Modbus 任务,在日志中应该可以看到自定义下发消息,例如:
01 03 00 00 00 02 C4 0B
。 - 在日志中观察设备能否正常回复,如果正常回复,会看到自定义上报消息。例如:
01 03 04 00 EE 01 E5 5A 1D
。 - 如果只能看到自定义下发消息,但没有自定义上报消息,请浏览下一条常见问题。
DTU 已在线,下发 Modbus 指令后,DTU 不回复,是什么原因?
DTU 已成功接入平台并显示在线,平台向 DTU 下发了 Modbus 消息后,无法收到 DTU 的 Modbus 回复消息。
请按以下步骤依次排查问题原因:
- 首先确认下发的 Modbus 指令是否正确。
- 请仔细检查设备的 Modbus 手册或咨询设备厂家,确定以下的参数是否正确:从机地址、功能码、寄存器起始地址、寄存器数量。
- 仍然不确定的话,可以用 PC 串口助手工具,通过 USB 转 RS485/RS232 跳过 DTU 直接连接到 RS485 设备,来验证同样的 Modbus 指令是否可以收到回复。
- 如果确定下发的 Modbus 指令本身没问题,问题可能在 DTU 的透传环节。
- 使用 PC 串口助手工具,通过 USB 转 RS485/RS232 和 DTU 连接,看看能否收到平台下发的 Modbus 消息,并模拟发送任意的 HEX 消息看平台上的设备调试日志中能否收到。点此了解
- 如果 PC 串口助手工具收不到平台下发的消息,请检查:
- 在下发 Modbus 消息的任务中,自定义数据流是否选择正确。
- 如果 DTU 是 MQTT 接入平台,请确认 DTU 硬件上配置的 MQTT 订阅主题必须和任务中的自定义数据流一致。如何找到自定义数据流的 MQTT 订阅主题?
- 如果 DTU 是 TCP 接入平台,请确认任务中必须选择绑定 TCP 的自定义数据流。了解绑定 TCP 数据流
- 检查串口助手工具的串口通讯参数是否和 DTU 的串口通讯参数设置一致。
- 在下发 Modbus 消息的任务中,自定义数据流是否选择正确。
- 检查 DTU 的串口通讯参数是否和 Modbus 设备的串口通讯参数设置一致。
- 检查 DTU 和 Modbus 设备之间 RS485/RS232 物理接线是否正确,可以尝试重新接线再试试。
注意,以上的串口通讯参数包括:波特率、数据位、奇偶校验、停止位等参数。例如:常用的串口通讯参数是:9600、8、N(无奇偶校验)、1。
单片机接入
单片机如何接入?
对于自身不支持通信模块的单片机,例如 STM32,通常有以下接入方式:
- 使用普通通信模块,通过串口发送 AT 指令,实现接入平台。
- 通过透传通信模块,通过串口直接收发数据,实现和平台的通信,支持 HEX、JSON 等格式。
通信模组接入
ESP32/8266 如何接入?
ESP32/8266 是常用的 WiFi 芯片/模组,可以通过两种方式接入 ThingsCloud:
- 使用乐鑫官方 AT 固件,通过独立主控 MCU 通过串口向模组发送 AT 指令,实现接入。
- 请参考教程 ESP8266/ESP32 模组 AT 命令 MQTT 接入
- 这种方式支持任何的主控 MCU,但不支持 ThingsX 的 WiFi 配网功能。
- 使用乐鑫 IDF 或 Arduino 等开发框架,开发专用的固件,通过开发框架提供的网络协议 API,实现 TCP / MQTT / HTTP 等方式接入 ThingsCloud。
- 我们提供了开源的 ThingsCloud ESP32/8266 Arduino SDK,支持 ThingsX App 的 WiFi 配网功能,上手简单,有示例可以快速编译运行。
- 示例 ESP32 + DHT11/DHT22 温湿度传感器接入 ThingsCloud
- 示例 ESP32 + 继电器模块接入 ThingsCloud
4G 模组接入平台的 SDK 有吗?
对于支持可编程开发方式的 4G 模组,我们提供了以下的 SDK 方便硬件开发者快速实现接入平台,完成数据上报和控制下发,并支持一型一密、OTA 等高级功能。
4G 模组 AT 指令如何接入平台?
请参考以下例子,更多模组的 AT 指令可参考模组厂家的 AT 指令手册。
消息协议
设备可以上报 JSON 数据吗?
可以,使用标准的属性上报,或自定义数据流上报,都可以使用 JSON 格式。
二进制消息可以上报到平台吗?
可以,使用自定义数据流上报。
纯文本消息可以上报到平台吗?
可以,使用自定义数据流上报。
设备上报自定义数据流,如何在设备属性中显示?
使用自定义数据上报规则,可以将二进制、Plaintext 文本、JSON 等格式的消息解析到设备属性中。
PLC 如何接入平台?
根据不同的 PLC,可使用 RS485 接口通过 DTU 接入平台,或使用以太网接口通过交换机或路由器接入平台。
在接入协议层面,如果是 Modbus 协议,可使用平台的 Modbus 寄存器配置功能快速接入,支持数据采集和控制下发。如果 PLC 使用私有协议,可通过支持该协议的边缘网关,经过边缘解析后,接入平台。
一型一密及自动创建
设备端能否动态获设备证书?
可以,对于量产及交付客户的设备,通常使用动态获取证书的方式,即实现一型一密。详细介绍请浏览 设备如何动态获取证书?
平台是否支持设备自动创建?
支持,详情浏览 如何自动创建设备?
其它问题
LoRa 网关已经在线,LoRa 终端设备的数据如何上传到平台?
需要在网关和子设备的消息规则中进行相应的配置,请浏览示例:
设备已接入第三方云平台,可以云云对接吗?
可以,请使用云网关,请浏览 使用云网关集成第三方云平台。