简介
ThingsBoard 是一个开源的物联网平台,用于数据收集、处理、可视化和设备管理。 本指南将帮助您快速将设备接入 ThingsBoard 平台,支持通过 MQTT 或 HTTP 协议进行通信。
准备工作
- 已部署的 ThingsBoard 实例(可使用官方云服务或自建)
- 设备访问凭证(Access Token)
- 网络连接能力(支持 MQTT 或 HTTP)
获取设备 Access Token
- 登录 ThingsBoard 控制台
- 进入“设备”页面,点击“+”添加新设备
- 创建后,点击设备名称,在“详情”页中复制“Access Token”
通过 HTTP 接入设备
使用 POST 请求发送遥测数据:
POST /api/v1/{ACCESS_TOKEN}/telemetry
Host: your-thingsboard-host.com
Content-Type: application/json
{
"temperature": 25.4,
"humidity": 60
}
示例(使用 curl):
curl -v -X POST https://demo.thingsboard.io/api/v1/ABC123/telemetry \
--header "Content-Type: application/json" \
--data '{"temperature":25.4,"humidity":60}'
通过 MQTT 接入设备
MQTT 服务器地址通常为 mqtt://your-thingsboard-host.com:1883(或 8883 for TLS)。
客户端 ID 可任意设置,用户名填写设备的 Access Token,密码留空。
发布遥测数据到主题:
v1/devices/me/telemetry
消息体为 JSON 格式:
{"temperature": 25.4, "humidity": 60}
常见问题
- 数据未显示? 检查 Access Token 是否正确,网络是否通畅。
- 支持哪些协议? ThingsBoard 支持 HTTP、MQTT、CoAP 等。
- 如何调试? 使用平台内置的“最新遥测”和“事件”标签页查看日志。