设备的普通证书，包括 ProjectKey 和 AccessToken，用于配置 DTU 连接云平台的身份认证部分。
MQTT 接入点主机名和端口，例如：mqtt://mqtt.iot-api.com:1883，那么其中 mqtt.iot-api.com 是 MQTT 接入点主机名，1883 是端口。请以您的设备详情页的实际信息为准。

配置 DTU 连接到平台

不同的 DTU 产品支持不同的配置方式，通常有 上位机软件 和 Web界面 等方式。

不论是哪种配置方式，都可以找到 MQTT 连接参数的配置界面，主要的配置内容包括：

配置项	填写内容
MQTT 主机名	在设备详情页复制的 MQTT 主机名
MQTT 端口	在设备详情页复制的 MQTT 端口，通常为 `1883`
username	`AccessToken`
password	`ProjectKey`
clientId	空或任意字符串

完成以上配置后，可以先保存 DTU 配置，这一步我们已经完成了 DTU 和 ThingsCloud 平台连接的身份认证配置。

此时，可以为 DTU 上电或重启，若在平台看到设备上线的提示，表明设备已经成功连接到平台。

如果设备未上线，请继续配置下边的 MQTT 主题。

配置 DTU 上的 MQTT 主题

接下来，需要为 DTU 配置 MQTT 主题，用于 DTU 和平台进行数据的上报和下发。

提示

如果希望了解 ThingsCloud 支持的所有 MQTT 主题，请参考设备 MQTT 接入。

使用 JSON 消息格式

如果 DTU 支持 JSON 格式的消息，可以使用 ThingsCloud 的标准 MQTT 主题，如下：

主题	类型	用途	消息格式	说明
attributes	发布	DTU 上报数据到平台	`JSON`
attributes/push	订阅	DTU 接收平台下发的数据	`JSON`	对于不需要下发数据的场景，可以不设置这个主题

需要注意的是，对于以上主题，支持的消息格式必须为 JSON，例如上报数据的消息如下：

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

云平台会自动接收上报数据，生成设备属性，在控制台的设备详情页可以看到属性数据实时更新。

对于 number 类型的属性，云平台还提供了时序图表，方便浏览历史曲线。

使用 HEX 消息格式

若 DTU 不支持 JSON 格式，或者您使用的是 DTU 的透传模式，例如用于转发 Modbus RTU 设备的 HEX 格式消息，那就需要用到自定义数据流的 MQTT 主题。

提示

ThingsCloud 除了内置的 MQTT 标准主题外，还支持灵活强大的自定义数据流的主题，前边我们提到过，这需要您先创建设备类型，并添加自定义数据流。

关于 自定义数据流 的详细介绍，请浏览自定义数据流。

每个自定义数据流会生成一组 MQTT 主题，包括一个发布主题和一个订阅主题，用来实现设备上报数据给云平台，以及接收云平台下发的数据。

在前边的步骤中，我们在创建设备类型时，选择了创建自定义数据流，数据格式设置为 Modbus RTU，那么平台会自动生成如下主题：

主题	类型	功能	消息格式
data/stream	发布	DTU 上报数据到平台	`HEX`
data/stream/set	订阅	DTU 接收平台下发的数据	`HEX`

将以上这两个主题填入 DTU 的配置软件中，便可实现 DTU 和平台之间双向传输 Modbus 指令。

关于平台如何自动解析 Modbus 指令，提取相应的数据，生成设备属性，请浏览教程：

RS485/Modbus 设备通过 DTU 透传接入 ThingsCloud

智能解析 Modbus 指令的过程，可以在设备消息日志中看到，如下图：

一些注意事项

如果 DTU 默认开启了一些预设主题的订阅，请将其关闭。否则会由于该主题不在云平台支持的标准主题范围内，被云平台限制 MQTT 接入。
在免费版项目中，DTU 发布数据的时间间隔不要低于 30 秒，否则可能会被云平台断开。付费版项目支持更短的上报间隔时间。

DTU TCP 透传方式接入云平台

TCP 透传是 DTU 比较常见的一种云平台连接方式，也是几乎所有 DTU 产品都支持的连接方式。这种方式让 DTU 作为一种透明转发的工作模式，将子设备发来的消息，直接转发给云平台，同时也将云平台下发的消息，转发给子设备。

总体来说，如果您熟悉了前边的 MQTT 接入配置方法，那么 TCP 透传的配置方法基本类似，不同之处在于 TCP 接入点和设备身份认证的方式。

接下来我们介绍 DTU TCP 透传方式的接入步骤。

提示

TCP 接入方式不仅支持 DTU 接入，也是更多单片机及通信模组最常见的接入方式，关于 TCP 接入的详细介绍，请参考设备 TCP 接入。

创建项目

首先，在云平台创建项目，点此进入控制台。在创建项目时，选择适合您的公有区。

创建设备类型

接着，进入项目中，由于 TCP 接入方式需要使用到设备类型的 自定义数据流，所以先来创建一个设备类型。如下图：

创建方式：选择 创建自定义类型
类型名称：起个名字，例如：我的DTU
设备接入类型：直连设备

提示

如果使用 Modbus 云网关功能，接入类型请选择网关，当然您可以创建后随时修改。

什么是 Modbus 云网关？

设备通信方式：选择 DTU 的联网方式，例如：4G 或 WiFi
设备接入协议：选择 Modbus RTU 透传
创建默认自定义数据流：开启
自定义数据流消息格式：选择 Modbus RTU
是否支持 TCP 接入：开启

完成创建，我们进入刚创建的 设备类型详情页 > 自定义数据流，可以看到已经默认创建了一个标识符为 stream 的自定义数据流，并且 已开启 TCP。如下图：

这相当于我们为该设备类型下的所有设备，开放了 TCP 接入通道。至于这里的标识符和 Topic 等信息，我们可以忽略，在使用 TCP 通道时没有实际作用。

提示

关于 自定义数据流 的详细介绍，请浏览自定义数据流。

创建设备

接下来，我们来正式创建一个设备，为设备绑定刚创建的设备类型，这样新设备便拥有了之前配置好的 TCP 接入通道。如下图：

获得 TCP 连接参数

设备创建成功后，进入 设备详情页 > 连接，找到以下信息：

设备的普通证书，包括 ProjectKey 和 AccessToken，用于配置 DTU 连接云平台的身份认证部分。
TCP 接入点主机名和端口，例如：tcp://device.iot-api.com:28801，那么其中 device.iot-api.com 是 TCP 接入点主机名，28801 是端口。请以您的设备详情页的实际信息为准。

配置 DTU 连接云平台

不同的 DTU 产品支持不同的配置方式，通常有 上位机软件 和 Web界面 等方式。

不论是哪种配置方式，要配置的内容项基本相同，它们包括：

配置项	填写内容
TCP 主机名	在设备详情页复制的 TCP 主机名
TCP 端口	在设备详情页复制的 TCP 端口
注册包	使用 ASCII 明文形式，格式为：`ProjectKey`&`AccessToken`
心跳包	可选，用于设备 TCP 协议层的保活，支持 ASCII 或 HEX 等任意格式，例如：`1` 或 `Ox00`

注册包

这里特别说明一下注册包，举个例子：

假如您的设备普通证书是：

AccessToken：1234567890
ProjectKey：ABCDEFG

那么注册包就是：

ABCDEFG&1234567890

如果 DTU 不支持设置 ASCII 明文形式，只支持 HEX 格式，您可以自行转为 HEX 格式，例如上边的注册包，转为 HEX 格式就是：

41 42 43 44 45 46 47 26 31 32 33 34 35 36 37 38 39 30

推荐一个在线的 ASCII 和 HEX 转换工具

完成以上配置后，可以先保存 DTU 配置。

到目前为止，我们在 DTU 端已经完成了 TCP 透传方式连接 ThingsCloud 的所有配置。

数据发送和接收测试（可选）

为了测试 DTU 和云平台是否已经通过 TCP 透传成功连接，您可以在 设备详情页 > 消息 中，开启 调试状态，用于查看设备发送和接收的消息。

常用的测试方法，例如：

用配置 DTU 的专用上位机软件，将 DTU 切换到透传模式，然后向 DTU 发送数据，在云平台设备消息列表中刷新，检查是否会显示相应的消息。
同样在 DTU 的透传模式下，用其它任何串口调试工具，连接到 DTU 的从机端口，例如：RS485 端口，模拟子设备发送消息给 DTU，在云平台设备消息列表中刷新，检查是否会显示相应的消息。

通过 DTU 上报终端设备的真实数据

最后，我们给 DTU 接上终端设备，例如一个 RS485 Modbus 温湿度传感器，通过 Modbus RTU 任务 来定时下发 Modbus 查询指令，并通过 Modbus RTU规则 来自动解析 Modbus 消息，生成设备的属性数据。如下图：

关于平台如何自动解析 Modbus 指令，提取相应的数据，生成设备属性，请浏览教程：

RS485/Modbus 设备通过 DTU 透传接入 ThingsCloud

提示

关于消息规则和任务的详细介绍，请参考：