ThingsBoard 二次开发 - 设备遥测

最新推荐文章于 2025-06-13 01:42:59 发布
原创 最新推荐文章于 2025-06-13 01:42:59 发布 · 2k 阅读 · 21 ·
CC 4.0 BY-SA版权
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
文章标签：

#物联网 #iot

本文详细描述了如何通过ThingsBoard平台规划遥测数据，利用RabbitMQ进行消息传递，整合元数据并按设备类型分类。内容涉及MQTT通信、规则链设置、RESTAPI接口以及在SpringBoot项目中的实现步骤。

摘要生成于 C知道 ，由 DeepSeek-R1 满血版支持， 前往体验 >

文章目录

# ThgingsBoard

https://iothub.org.cn/docs/iot/
https://iothub.org.cn/docs/iot/dev/dev-telemetry/

一、遥测数据规划

1.遥测规划

  1. 遥测数据上传ThingsBoard平台
  2. ThingsBoard通过规则引擎整合元数据
  3. ThingsBoard通过规则引擎按设备类型对数据分类
  4. ThingsBoard通过规则引擎把消息路由到消息队列（RabbitMQ或Kafka、EMQX），根据设备类型建topic
  5. 消息队列（RabbitMQ）根据topic消费数据，保存到数据库
  6. 根据微服务划分创建数据库，根据时序数据规则创建表

二、准备工作

1.上传遥测

package com.iothub.telemetry;
import com.iothub.mqtt.EmqClient;
import com.iothub.mqtt.MqttProperties;
import com.iothub.mqtt.QosEnum;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.scheduling.annotation.Scheduled;
import org.springframework.stereotype.Component;
import javax.annotation.PostConstruct;

@Component
public class Upload {

    @Autowired
    private EmqClient emqClient;

    @Autowired
    private MqttProperties properties;

    @PostConstruct
    public void init(){
        //连接服务端
        emqClient.connect(properties.getUsername(),properties.getPassword());
        //订阅一个主题
        //emqClient.subscribe("testtopic/#", QosEnum.QoS1);
    }

    @Scheduled(fixedRate = 2000)
    public void publish(){

        String data = getData(2);

        emqClient.publish("v1/devices/me/telemetry",data,
                QosEnum.QoS1,false);
    }

    private String getData(Integer type){

        if (type == 1) {
            // 携带时间戳
            String data = "{\n" +
                    "\t\"ts\": 1451649600512,\n" +
                    "\t\"values\": {\n" +
                    "\t\t\"stringKey\": \"value1\",\n" +
                    "\t\t\"booleanKey\": true,\n" +
                    "\t\t\"doubleKey\": 42.0,\n" +
                    "\t\t\"longKey\": 73,\n" +
                    "\t\t\"jsonKey\": {\n" +
                    "\t\t\t\"someNumber\": 42,\n" +
                    "\t\t\t\"someArray\": [1, 2, 3],\n" +
                    "\t\t\t\"someNestedObject\": {\n" +
                    "\t\t\t\t\"key\": \"value\"\n" +
                    "\t\t\t}\n" +
                    "\t\t}\n" +
                    "\t}\n" +
                    "}";

            return data;

        } else if (type == 2) {
            // 不携带时间戳
            String data = "{\n" +
                    "  \"stringKey\": \"value1\",\n" +
                    "  \"booleanKey\": true,\n" +
                    "  \"doubleKey\": 42.0,\n" +
                    "  \"longKey\": 73,\n" +
                    "  \"jsonKey\": {\n" +
                    "    \"someNumber\": 42,\n" +
                    "    \"someArray\": [1,2,3],\n" +
                    "    \"someNestedObject\": {\"key\": \"value\"}\n" +
                    "  }\n" +
                    "}";

            return data;
        }else {
            // 数组
            String data = "[{\"key1\":\"value1\"}, {\"key2\":true}]";
            return data;
        }
    }
}

server:
  port: 8999
spring:
  application:
    name: tb-telemetry

mqtt:
  broker-url: tcp://82.157.166.86:1883
  client-id: emq-client-telemetry
  username: LuUoLXi3DMqOPqDjm20C
  password:

遥测数据

{
    "stringKey": "value1",
    "booleanKey": true,
    "doubleKey": 42.0,
    "longKey": 73,
    "jsonKey": {
        "someNumber": 42,
        "someArray": [1, 2, 3],
        "someNestedObject": {
            "key": "value"
        }
    }
}

元数据

{
    "deviceName": "Test-telemetry",
    "deviceType": "default",
    "ts": "1696730983079"
}

2.RabbitMQ

2.1.Docker部署RabbitMQ
docker run -d  --network host --restart=always --name rabbitmq rabbitmq:management

# 访问地址
http://82.157.166.86:15672/ 
# 账户/密码：
guest/guest
2.2. 创建直连交换机

1.创建直连交换机
在这里插入图片描述

2.创建队列
在这里插入图片描述

3.绑定队列
在这里插入图片描述

2.3.创建主题交换机

1.创建topic交换机
在这里插入图片描述

2.创建队列
在这里插入图片描述

3.绑定交换机
在这里插入图片描述

3.创建规则链

3.1.创建遥测规则链

在这里插入图片描述
在这里插入图片描述
在这里插入图片描述

3.2.整合元数据
# copy keys

{
    "deviceName": "Test-telemetry",
    "deviceType": "default",
    "ts": "1696730983079"
}

在这里插入图片描述
在这里插入图片描述

3.3.按设备类型消息分类
# 按设备类型消息分类

if(msg.deviceType === 'test-telemetry') {
    return ['test-telemetry'];
} else {
    return ['default'];
}

在这里插入图片描述
在这里插入图片描述

三、上传遥测

1.创建设备

在这里插入图片描述
在这里插入图片描述

2.上传遥测数据

{
    "stringKey": "value1",
    "booleanKey": true,
    "doubleKey": 42.0,
    "longKey": 73,
    "jsonKey": {
        "someNumber": 42,
        "someArray": [1, 2, 3],
        "someNestedObject": {
            "key": "value"
        }
    }
}


{
	"stringKey": "value1",
	"booleanKey": true,
	"doubleKey": 42.0,
	"longKey": 73
}

在这里插入图片描述

@Component
public class Upload {

    @Autowired
    private EmqClient emqClient;

    @Autowired
    private MqttProperties properties;

    @PostConstruct
    public void init(){
        //连接服务端
        emqClient.connect(properties.getUsername(),properties.getPassword());
        //订阅一个主题
        //emqClient.subscribe("testtopic/#", QosEnum.QoS1);
    }

    @Scheduled(fixedRate = 2000)
    public void publish(){

        String data = getData(2);

        emqClient.publish("v1/devices/me/telemetry",data,
                QosEnum.QoS1,false);
    }

    private String getData(Integer type){

        if (type == 1) {
            // 携带时间戳
            String data = "{\n" +
                    "\t\"ts\": 1451649600512,\n" +
                    "\t\"values\": {\n" +
                    "\t\t\"stringKey\": \"value1\",\n" +
                    "\t\t\"booleanKey\": true,\n" +
                    "\t\t\"doubleKey\": 42.0,\n" +
                    "\t\t\"longKey\": 73,\n" +
                    "\t\t\"jsonKey\": {\n" +
                    "\t\t\t\"someNumber\": 42,\n" +
                    "\t\t\t\"someArray\": [1, 2, 3],\n" +
                    "\t\t\t\"someNestedObject\": {\n" +
                    "\t\t\t\t\"key\": \"value\"\n" +
                    "\t\t\t}\n" +
                    "\t\t}\n" +
                    "\t}\n" +
                    "}";

            return data;
        } else if (type == 2) {
            // 不携带时间戳
            String data = "{\n" +
                    "  \"stringKey\": \"value1\",\n" +
                    "  \"booleanKey\": true,\n" +
                    "  \"doubleKey\": 42.0,\n" +
                    "  \"longKey\": 73,\n" +
                    "  \"jsonKey\": {\n" +
                    "    \"someNumber\": 42,\n" +
                    "    \"someArray\": [1,2,3],\n" +
                    "    \"someNestedObject\": {\"key\": \"value\"}\n" +
                    "  }\n" +
                    "}";

            return data;
        }else {
            // 数组
            String data = "[{\"key1\":\"value1\"}, {\"key2\":true}]";
            return data;
        }
    }
}

3.RabbitMQ

1.创建队列

telemetry-default-queue、telemetry-queue

在这里插入图片描述

2.创建交换机
在这里插入图片描述

4.配置规则引擎

4.1.整体配置

在这里插入图片描述
在这里插入图片描述
在这里插入图片描述

4.2.整个元数据
{
    "deviceName": "Test-telemetry",
    "deviceType": "default",
    "ts": "1696730983079"
}

在这里插入图片描述

4.3.按设备类型消息分类
if(msg.deviceType === 'test-telemetry') {
    return ['test-telemetry'];
} else {
    return ['default'];
}

在这里插入图片描述

5.测试

在这里插入图片描述
在这里插入图片描述
在这里插入图片描述

{
	"stringKey": "value1",
	"booleanKey": true,
	"doubleKey": 42.0,
	"longKey": 73,
	"jsonKey": {
		"someNumber": 42,
		"someArray": [1, 2, 3],
		"someNestedObject": {
			"key": "value"
		}
	},
	"deviceType": "default",
	"deviceName": "Test-telemetry",
	"ts": "1451649600512"
}

{
	"stringKey": "value1",
	"booleanKey": true,
	"doubleKey": 42.0,
	"longKey": 73,
	"deviceType": "test-telemetry",
	"deviceName": "Test-telemetry1",
	"ts": "1696824491527"
}

四、REST API

1.遥测API

在这里插入图片描述
在这里插入图片描述

# ThgingsBoard

https://iothub.org.cn/docs/iot/
https://iothub.org.cn/docs/iot/dev/dev-telemetry/
前端使用二开Thingsboard一、二、三事（一）-thingsboard介绍
weixin_43163457的博客
02-18 779
以项目实战为基础，逐步介绍前端在thingsboard系统二次开发中的一些注意事项以及一些thingsboard一些页面功能讲解，为前端人员开发使用thingsboard提供一种可靠思路，打造一个完美的物联网系统。
前端使用二开Thingsboard一、二、三事(二)-设备
weixin_43163457的博客
02-18 291
登录Thingsboard后，进入的第一个页面便是首页，首页展示分为两部分，默认展示的是快捷入口模块点击模块便可进入相应的侧边栏页面，默认显示模块个数与侧边栏展示列一般相同，展示内容可在代码中进行删减，具体操作在上一章中已做介绍，此处不再累述，除了默认展示外，还可根据用户需求制作数据展示首页，如下图：怎么制作数据展示页面是个复杂的过程(二次开发主要集中在这里)，之后会单独讲，此处先说如何切换默认首页和数据展示首页。
【环境搭建和安装】thingsboard二次开发环境搭建
wuwuhe99的博客
03-21 1355
thingsboard环境搭建和安装部署
ThingsBoard（4）（二次开发篇1）（TODO）
fanged的专栏
06-13 1537
特性描述前后端完全分离可独立部署，方便对接第三方系统或替换 UI通信方式REST API + WebSocket，支持高并发与实时性易于二次开发可自定义仪表盘组件、后台业务逻辑、集成机器学习模型、接入外部系统等接口开放文档Swagger UI如果你希望：自定义前端组件（桥梁 3D 模型 + 传感器位置展示）开发自己的 API 或规则链节点将 ML 模型分析接入 ThingsBoard 决策流程我可以为你提供具体的操作示例或开发指南。是否继续？
ThingsBoard 二次开发 - 事件处理
IoTHub - 物联网开源技术社区
01-25 1483
ThingsBaord 二次开发，事件处理，ThingsBoard 作为 PaaS 平台，不修改源码。
ThingsBoard 二次开发 - 设备控制
IoTHub - 物联网开源技术社区
01-24 1682
ThingsBaord 二次开发，设备控制，ThingsBoard 作为 PaaS 平台，不修改源码。
ThingsBoard 二次开发 - 网关 API
IoTHub - 物联网开源技术社区
01-25 1894
ThingsBaord 二次开发，网关 API，ThingsBoard 作为 PaaS 平台，不修改源码。
ThingsBoard 二次开发 - 设备管理
IoTHub - 物联网开源技术社区
01-23 1314
ThingsBaord 二次开发，设备管理，ThingsBoard 作为 PaaS 平台，不修改源码。
thingsboard 二次开发 遥测与属性上传时处理 上传属性修改值 上传属性修改key
qq_43601336的博客
09-23 1935
thingsboard 二次开发 遥测与属性上传时处理 上传属性修改值 上传属性修改key
ThingsBoard二次开发中文文档
最新发布
07-17
目前一些社区和开发者个人博客中整理了部分关于 ThingsBoard 二次开发的中文指南和技术文章，涵盖从源码编译、模块扩展、UI 定制到与外部系统集成等内容。这些文档通常包括： - ThingsBoard 架构解析：介绍其微服务...
thingsboard二次开发 物模型
05-21
### 关于ThingsBoard二次开发中的物模型使用指南 在ThingsBoard的二次开发过程中，物模型（Data Model）是一个非常重要的概念。它定义了设备的数据结构以及这些数据如何被存储、管理和展示。以下是关于ThingsBoard...
Thingsboard二次开发---4.基于Thingsboard的在线组态软件
Diego的博客
08-19 5052
Thingsboard提供了非常强大的物联网功能，其中仪表板功能可以快速的搭建数据大屏，但美中不足的是对于工业组态没有提供很好的工具，本文介绍在thingsboard基础上利用svg技术开发通用组态软件，后续文章会逐步介绍开发的过程。
Thingsboard前端二次开发学习
xiaoming_Super的博客
01-05 1356
目录解析
IoT开源平台Thingsboard二次开发研究
热门推荐
houpanqi的博客
10-25 2万+
ThingsBoard 二次开发指南 参考资料 [TB官方文档（英文）](https://thingsboard.io/docs/) [Protobuf的讲解](https://www.ibm.com/developerworks/cn/linux/l-cn-gpb/index.html) 概述 1 整个ThingsBoard的代码中，变量、方法命名规范; 2 变量和方法的标识符...
ThingsBoard 二次开发 - 设备告警
IoTHub - 物联网开源技术社区
01-24 1431
ThingsBaord 二次开发，设备告警，ThingsBoard 作为 PaaS 平台，不修改源码。
ThingsBoard 二次开发之源码分析 4-启动分析 3
云腾五洲官方博客
10-01 2807
创建AppActor和StatsActor两个Actor,并未创建其他的Actor;在收到的时候，由于之前没有初始化，所以会初始化该应用的所有, 根据②③④点分析，循环切递归的创建了所有的;关于的理解：mailbox理解为一个信箱，里面有一些信件(即入队列的消息)，这些信件有一些是高优先级，有些是普通优先级的，每次取信件的时候，都先看有没高优先级的，先处理高优先级的信件，再处理普通优先级的信件。那么信件处理人是谁呢？信件的处理人就是每一个Actor.实际上的信件处理方法都是每一个Actor的方法；
ThingsBoard通过MQTT发送遥测数据
可乐要加冰！！！
04-06 2242
ThingsBoard支持以JSON格式的key-value字符串值可以是string、bool、float、long或者二进制格式的序列化字符串；找到有关MQTT的更多信息，ThingsBoard服务器支持QoS级别0（最多一次）和QoS级别1（至少一次）以及一组预定义主题的MQTT代理。你可以在网上找到大量的MQTT客户端库，本文中的示例将基于Mosquitto和MQTT.js您可以使用我们的。下面：是发送的数据体（一定是JSON格式的）上面：是对应的Topic的地址。的MQTT CONNECT消息。
Thingsboard二次开发---5.在Thingsboard中增加解决方案管理功能
Diego的博客
10-08 1038
在使用Thingsboard的过程中发现TB虽然非常灵活，但实际的最终用户更希望是针对特定场景的成熟解决方案，页面都做好，不需要再进行配置，所以在原来的基础上增加了解决方案的功能，此方案比较适合给用户提供SaaS化的解决方案，给大家提供一个用TB做项目的思路，供参考。
评论 2
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

IoTHub - 物联网开源技术社区

支持开源技术！ 传播开源文化！

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付：¥1
获取中
扫码支付

您的余额不足，请更换扫码支付或充值

打赏作者

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值