ThingsBoard 是一个开源的物联网(IoT)应用平台,它提供了一系列服务,包括设备管理(如识别、注册、所有权和访问控制)、数据收集、数据存储、处理和可视化。设备可以通过标准化协议如MQTT、CoAP或HTTP与ThingsBoard通信,这些通信可以是直接的,也可以通过网关设备实现,允许非IP设备通过IP和公共互联网与服务通信。
ThingsBoard 能够支持多种应用场景,例如在临床、环境或能源过程中监控关键参数的趋势,并在出现问题时产生警报。它也可以用于无线传感器网络的数据可视化,这些网络在物联网系统中扮演着关键角色,通过不同传感器收集的数据可以用于监控环境条件,如温度和湿度,从而提高人们在这些环境中的舒适度
入门
MQTT基础
MQTT是一种轻量级的发布-订阅消息传递协议,可能使其最适合于各种IoT设备。您可以在此处找到有关MQTT的更多信息。
ThingsBoard服务器节点充当MQTT代理,该代理支持QoS级别0(最多一次)和1(至少一次)以及一组预定义的主题。
客户端库设置
您可以在网上找到大量的MQTT客户端库。本文中的示例将基于Mosquitto和MQTT.js。为了设置这些工具之一,您可以使用我们的《Hello World》指南中的说明。
MQTT连接
我们将在本文中使用访问令牌设备凭证,这些凭证稍后将称为$ ACCESS_TOKEN。应用程序需要使用包含$ ACCESS_TOKEN的用户名发送MQTT CONNECT消息。连接序列期间可能的返回码及其原因:
0x00已连接 -已成功连接到ThingsBoard MQTT服务器。
0x04连接被拒绝,用户名或密码错误 -用户名为空。
0x05连接被拒绝,未经授权 -用户名包含无效的$ ACCESS_TOKEN。
键值格式
默认情况下,ThingsBoard支持JSON中的键值内容。键始终是一个字符串,而值可以是字符串,布尔值,双精度或长整数。也可以使用自定义二进制格式或某些序列化框架。有关更多详细信息,请参见协议自定义。例如:
{"stringKey":"value1", "booleanKey":true, "doubleKey":42.0, "longKey":73}
遥测上传API
为了将遥测数据发布到ThingsBoard服务器节点,请将PUBLISH消息发送到以下主题:
v1/devices/me/telemetry
支持的最简单的数据格式是:
{"key1":"value1", "key2":"value2"}
要么
[{"key1":"value1"}, {"key2":"value2"}]
请注意,在这种情况下,服务器端时间戳将分配给上传的数据!
如果您的设备能够获得客户端时间戳,则可以使用以下格式:
{"ts":1451649600512, "values":{"key1":"value1", "key2":"value2"}}
在上面的示例中,我们假设“ 1451649600512”是具有毫秒精度的Unix时间戳。例如,值’1451649600512’对应于’星期五,2016年1月1日12:00:00.512 GMT’。
属性API
ThingsBoard属性API使设备能够
- 将客户端设备属性上载到服务器。
- 从服务器请求客户端和共享设备属性。
- 从服务器订阅共享的设备属性。
- 将属性更新发布到服务器
为了将客户端设备属性发布到ThingsBoard服务器节点,请将PUBLISH消息发送到以下主题:
v1/devices/me/attributes
从服务器请求属性值
为了向ThingsBoard服务器节点请求客户端或共享设备属性,请将PUBLISH消息发送到以下主题:
v1/devices/me/attributes/request/$request_id
其中$ request_id是您的整数请求标识符。在发送带有请求的PUBLISH消息之前,客户端需要订阅
v1/devices/me/attributes/response/+
从服务器订阅属性更新
为了订阅共享设备属性更改,请发送SUBSCRIBE消息到以下主题:
v1/devices/me/attributes
当服务器端组件之一(例如REST API或规则链)更改了共享属性时,客户端将收到以下更新:
{"key1":"value1"}
RPC API
服务器端RPC
为了从服务器订阅RPC命令,请将SUBSCRIBE消息发送到以下主题:
v1/devices/me/rpc/request/+
订阅后,客户端将以发布消息的形式接收到相应主题的各个命令:
v1/devices/me/rpc/request/$request_id
其中
request_id 其中
requestid其中 request_id是整数请求标识符。
客户应发布对以下主题的响应:
v1/devices/me/rpc/response/$request_id
客户端RPC
为了将RPC命令发送到服务器,请将PUBLISH消息发送到以下主题:
v1/devices/me/rpc/request/$request_id
其中$ request_id是整数请求标识符。来自服务器的响应将发布到以下主题:
v1/devices/me/rpc/response/$request_id
参考:https://thingsboard.io/docs/reference/mqtt-api/
相关推荐: 使用NodeRED对接西门子PLC【S7-200 Smart】|实战教程
在现代工业自动化领域,PLC(可编程逻辑控制器)扮演着至关重要的角色。西门子S7-200 Smart系列PLC以其卓越的性能和易用性,成为了许多工程师的首选。本文将详细介绍AIoTedge如何创建一个用于读写西门子S7-200 Smart PLC数据的流程。 …