跳至主要內容

设备接入常见问题

约 3468 字大约 12 分钟

设备接入常见问题

设备接入概览

ThingsCloud 支持哪些品牌的物联网设备接入？

ThingsCloud 不限定接入设备的具体品牌和型号。通过 ThingsCloud 平台的开放协议，任何设备都可以 直连 或 通过网关连接 到 ThingsCloud。

设备接入方式

  • 直连设备：具备蜂窝网络、WiFi、以太网等通信能力的设备，可直接接入平台
  • 网关设备：作为子设备和平台之间的桥梁，帮助不具备联网能力的设备接入
  • 子设备：通过网关设备接入平台，通信方式不限

任何设备厂商、硬件开发者都可以将设备接入 ThingsCloud。

看看哪些设备在接入 ThingsCloud

设备可使用哪些通信方式接入平台？

不同类型的设备支持的通信方式不同：

通信方式说明

直连设备或网关设备可通过以下方式接入：

  • 蜂窝网络（2G/3G/4G/5G/NB-IoT）
  • WiFi
  • 以太网

子设备通过网关设备接入，子设备和网关之间的通信方式包括：RS485/RS232、以太网、CAN、蓝牙/BLE、ZigBee、LoRa、433MHz 等。

详细说明请浏览 设备通信方式

平台支持哪些设备接入协议？

ThingsCloud 支持多种设备接入协议，满足不同场景需求：

接入协议一览

直连设备或网关设备支持的接入协议：

子设备支持的通信协议：

  • 标准工业协议：Modbus RTU、Modbus TCP、OPC UA、Profinet、BACnet
  • 自定义协议：完全不限

其中 Modbus RTU 和 Modbus TCP 可借助平台的 Modbus 智能转换功能实现快速接入。

详细说明请浏览 设备接入指南

设备 MQTT 接入

设备如何通过 MQTT 协议接入平台？

ThingsCloud 支持设备通过 MQTT 协议接入平台，包括普通设备和网关设备。

MQTT 接入文档

可以模拟设备 MQTT 接入平台吗？

可以，使用 MQTT 客户端工具可以模拟真实的设备，快速熟悉和测试平台的接入协议。

模拟工具和教程

推荐使用以下工具和教程：

MQTTX 工具：

MQTT.fx 视频教程：

我的设备使用 MQTT 无法连接平台，如何解决？

建议使用 MQTT 客户端工具（如 MQTTX 或 MQTT.fx）模拟设备 MQTT 接入平台，连接成功后，对照连接参数，可以帮助您排查自己的设备是否配置正确。

排查方向

主要检查以下配置：

  • MQTT 服务器地址和端口
  • Client ID、用户名、密码
  • 设备证书是否正确
  • 网络连接是否正常

如何使用通信模组的 AT 命令实现 MQTT 接入平台？

单片机或嵌入式设备在使用通信模组接入云平台时，可利用 TCP 或 MQTT 的相关 AT 命令，快速接入 ThingsCloud 云平台。

相关文档

详细说明请参考 通信模组 AT 接入

平台有提供设备端 SDK 吗？

ThingsCloud 提供了针对部分模组的开源 SDK，方便硬件开发者快速实现设备接入。

设备 SDK

请参考 设备 SDK 接入

设备 MQTT 接入平台，发布和订阅主题（Topic）有哪些？

ThingsCloud 支持一套简洁的 MQTT 主题（Topic）规范，大大简化了硬件设备接入的过程。

MQTT 主题规范

详细说明请浏览 MQTT 主题一览

是否可以自定义 MQTT 主题（Topic）？

可以，对于个性化场景，平台提供了灵活的自定义主题功能。

自定义主题

您可以创建自定义数据流来实现自定义主题，并配合消息规则以及云函数，可实现任何通信格式的需求。

详细说明请浏览 自定义数据流

设备 TCP 接入

可以模拟设备 TCP 接入平台吗？

可以，您可以使用任何 TCP 测试工具，按照平台的设备 TCP 接入协议，设置地址和端口，连接后立即发送注册包，即可完成连接。

TCP 接入文档

详细介绍请浏览 设备 TCP 接入

设备端 TCP 配置都正确，为什么还是连接不上平台？

如果设备端已配置正确的地址、端口、注册包，仍然无法上线，请检查设备类型中是否创建了自定义数据流，并绑定 TCP 通道。

TCP 数据流配置

详细说明请浏览 设备 TCP 接入

DTU & Modbus 设备接入

DTU 如何接入平台？

DTU 通常可使用 TCP 客户端 或 MQTT 客户端 模式接入平台。

DTU 接入方式

RS485/Modbus 设备如何接入平台？

RS485/Modbus 设备通常通过 DTU 模块接入平台。

Modbus 设备接入

详情请浏览 RS485/Modbus 设备通过 DTU 透传接入 ThingsCloud

Modbus 设备已经回复 HEX 报文，为什么无法解析出属性值？

如果在设备调试日志中回复的 HEX 报文正确，仍然无法解析生成属性值，请检查设备所属设备类型的 Modbus 配置。

Modbus 寄存器配置

特别注意要正确设置 Modbus 寄存器读写类型：

  • 使用 03 功能码查询 → 数值寄存器读写类型设置为 读写
  • 使用 04 功能码查询 → 数值寄存器读写类型设置为 只读

详细说明请浏览 Modbus 配置

DTU 已在线，为什么不显示传感器数据？

DTU 成功连接到平台后，DTU 连接的 Modbus 设备数据并不会自动显示，您需要完成必要的配置。

配置步骤

请务必先阅读 RS485/Modbus 设备通过 DTU 透传接入 ThingsCloud，按文中步骤完成配置。

如果配置正确但仍无法显示数据，请在设备详情页打开设备调试日志，检查：

  • 是否可以正确向设备下发 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 消息。

请按以下步骤依次排查问题原因：

排查步骤

1. 确认下发的 Modbus 指令是否正确

  • 检查设备的 Modbus 手册或咨询设备厂家，确认下发的 Modbus 指令是否正确，比如从机地址、功能码、寄存器起始地址、寄存器数量。
  • 用 PC 串口助手工具，通过 USB 转 RS485/RS232 线缆直接连接到 RS485 设备，验证同样的 Modbus 指令是否可以收到设备回复。

2. 如果可以收到设备回复，接下来检查 DTU 透传环节是否正常

  • 使用 PC 串口助手工具，通过 USB 转 RS485/RS232 线缆连接 DTU，测试能否收到平台下发的消息。
  • 如果 PC 串口助手工具收不到平台下发的消息，请检查：
    • 若 DTU 使用 MQTT 接入：DTU 订阅主题必须和任务中的自定义数据流一致。
    • 若 DTU 使用 TCP 接入：任务中必须选择绑定 TCP 的自定义数据流。
  • 检查 DTU 和 Modbus 设备的串口通讯参数是否一致：波特率、数据位、奇偶校验、停止位。例如：常用的串口通讯参数是：
    • 波特率：9600
    • 数据位：8
    • 奇偶校验：N（无奇偶校验）
    • 停止位：1
  • 检查 DTU 和 Modbus 设备之间的物理接线是否接触良好。

以上排查时，要善于使用平台的设备调试功能，详细说明请浏览 消息测试工具

单片机接入

单片机如何接入？

对于自身不支持通信模块的单片机（如 STM32），通常有以下接入方式：

单片机接入方式

  • 使用通信模块，通过串口发送 AT 指令实现接入
  • 通过透传通信模块，通过串口直接收发数据，支持 HEX、JSON 等格式

通信模组接入

ESP32/8266 如何接入？

ESP32/8266 是常用的 WiFi 芯片/模组，可通过以下三种方式接入 ThingsCloud：

ESP32/8266 接入方式

方式一：使用 AT 指令

方式二：使用开发框架

  • 使用乐鑫 IDF 或 Arduino 等开发框架
  • 通过网络协议 API 实现 TCP/MQTT/HTTP 接入

方式三：使用我们提供的 SDK

4G 模组接入平台的 SDK 有吗？

ThingsCloud 提供了针对部分 4G 模组的开源 SDK，支持一型一密、OTA 等高级功能。

4G 模组 SDK

4G 模组 AT 指令如何接入平台？

以下提供了常见 4G 模组的 AT 命令 MQTT 接入教程：

4G 模组 AT 教程

消息协议

设备可以上报 JSON 数据吗？

可以，设备上报 JSON 数据有两种方式：

JSON 数据上报

二进制消息可以上报到平台吗？

可以，使用自定义数据流上报支持二进制/HEX 格式消息。

二进制数据上报

详细说明请浏览 自定义数据流上报

纯文本消息可以上报到平台吗？

可以，使用自定义数据流上报支持 Plaintext 文本格式消息。

文本数据上报

详细说明请浏览 自定义数据流上报

设备上报自定义数据流，如何在设备属性中显示？

使用自定义数据上报规则，可以将各种格式的消息解析到设备属性中。

数据解析

详细说明请浏览 自定义数据上报规则

支持的格式包括：

  • 二进制/HEX
  • Plaintext 文本
  • JSON

PLC 如何接入平台？

根据不同的 PLC 型号，可通过不同方式接入平台：

PLC 接入方式

RS485 接口：

  • 通过 DTU 接入平台
  • 使用 Modbus 协议可借助 Modbus 寄存器配置功能快速接入

以太网接口：

  • 通过交换机或路由器接入平台
  • 支持 Modbus TCP 协议

私有协议：

  • 通过支持该协议的边缘网关接入
  • 经过边缘解析后接入平台

一型一密及自动创建

设备端能否动态获取设备证书？

可以，对于量产及交付客户的设备，通常使用动态获取证书的方式，即实现一型一密。

一型一密

详细介绍请浏览 设备如何动态获取证书？

平台是否支持设备自动创建？

支持，平台提供设备自动创建功能。

自动创建设备

详情请浏览 如何自动创建设备？

其他问题

LoRa 网关已经在线，LoRa 终端设备的数据如何上传到平台？

需要在网关和子设备的消息规则中进行相应的配置。

LoRaWAN 接入示例

设备已接入第三方云平台，可以云云对接吗？

可以，使用云网关功能可以实现与第三方云平台的对接。

云网关

详细说明请浏览 使用云网关集成第三方云平台

ThingsCloud
Copyright © 2026 ThingsCloud