技术交流

学习资料
立即试用 商务报价
专业版
社区版 专业版 云服务 Edge Edge PE 网关 授权服务 Trendz分析 Mobile 应用程序 Mobile PE应用程序
文档 指南 安装 架构 API 常见问题

本页目录

ThingsBoard专业版入门

介绍

本教程主要演示ThingsBoard的基本用法并掌握:

  • 设备连接；
  • 数据发布；
  • 数据展示；
  • 警报触发；
  • 通知推送。

教程将连接和可视化来自温度传感器的数据以及简单使用。

必备条件

你需要能够访问Things Boards专业版， 建议使用Thingsboard云服务， 另一种选项是通过安装指南进行独立部署。

步骤1. 创建设备

做为入门教程我们将使用UI手动配置设备。

  • 登录并打开设备页面
  • 导航到“ALL”设备分组
  • 单击"+"图标
  • 输入设备名称
  • 倒序显示设备列表
image
登录并打开设备页面
image
导航到“ALL”设备分组
image
单击"+"图标
image
输入设备名称
image
倒序显示设备列表

你也可以通过：

  • 批量配置的CSV文件创建多个设备；
  • 设备配置自动创建设备， 因此无需手动创建设备。
  • REST API以编程方式创建设备和其它实体；

步骤2. 连接设备

ThingsBoard支持各种设备凭证进行设备连接，建议使用默认生成的设备凭证进行连接。

  • 打开设备详情
  • 复制访问令牌
image
打开设备详情
image
复制访问令牌

在此示例中我们将使用简单的命令通过HTTP或MQTT发布数据， 现在已经创建好设备可以发布遥测数据。

HTTPLinux, macOS或Windows
MQTTLinux或macOS
MQTTWindows
CoAPLinux or macOS
其他协议Modbus, SNMP, LoRaWAN等

Ubuntu安装curl：

1

sudo apt-get install curl

macOS安装curl：

1

brew install curl

Windows安装curl：

Windows 10 b17063已经默认安装cURL。 如果你是老版Windows操作系统更多信息参见MSDB博客。 你可以在此处查看官方安装指南。


如果你已经在Windows, Ubuntu和macOS安装cURL工具。

替换$THINGSBOARD_HOST_NAME和$ACCESS_TOKEN为对应值。

1

curl -v -X POST -d "{\"temperature\": 25}" https://$THINGSBOARD_HOST_NAME/api/v1/$ACCESS_TOKEN/telemetry --header "Content-Type:application/json"

例如$THINGSBOARD_HOST_NAME是本机地址$ACCESS_TOKEN是ABC123:

1

curl -v -X POST -d "{\"temperature\": 25}" https://localhost/api/v1/ABC123/telemetry --header "Content-Type:application/json"

Ubuntu安装mqtt客户端：

1

sudo apt-get install mosquitto-clients

macOS安装mqtt客户端：

1

brew install mosquitto-clients

替换$THINGSBOARD_HOST_NAME和$ACCESS_TOKEN为对应值。

1

mosquitto_pub -d -q 1 -h "$THINGSBOARD_HOST_NAME" -p "1883" -t "v1/devices/me/telemetry" -u "$ACCESS_TOKEN" -m {"temperature":25}

例如$THINGSBOARD_HOST_NAME是本机地址$ACCESS_TOKEN是ABC123:

1

mosquitto_pub -d -q 1 -h "localhost" -p "1883" -t "v1/devices/me/telemetry" -u "ABC123" -m {"temperature":25}

成功之后输出以下内容：

1
2
3
4
5

Client mosqpub|xxx sending CONNECT
Client mosqpub|xxx received CONNACK
Client mosqpub|xxx sending PUBLISH (d0, q1, r0, m1, 'v1/devices/me/telemetry', ... (16 bytes))
Client mosqpub|xxx received PUBACK (Mid: 1)
Client mosqpub|xxx sending DISCONNECT

注意：从ThingsBoard3.2开始可以使用基础的MQTT凭据（客户端 ID、用户名和密码的组合） 并使用设备配置文件自定义主题名称和payload类型在此处查看更多信息。



安装Chrome的MQTTBox插件：

  • 创建MQTT客户端
  • 输入topic和payload单击"Publish"按钮
image
创建MQTT客户端
image
输入topic和payload单击"Publish"按钮



如果你在Windows/Linux/MacOS机器上安装了Node.js和NPM可以通过命令安装coap-cli：

1

npm install coap-cli -g

替换$THINGSBOARD_HOST_NAME和$ACCESS_TOKEN为对应值。

1

echo -n '{"temperature": 25}' | coap post coap://$THINGSBOARD_HOST_NAME/api/v1/$ACCESS_TOKEN/telemetry

例如$THINGSBOARD_HOST_NAME是本机地址$ACCESS_TOKEN是ABC123:

1

echo -n '{"temperature": 25}' | coap post coap://localhost/api/v1/ABC123/telemetry



ThingsBoard支持许多其他协议 请浏览连接图以找到你需要的解决方案。

注意：建议开始使用通过MQTT连接的模拟设备了解平台功能。



数据发布成功后可以在遥测选项卡中进行查看：

  • 打开设备详情
  • 打开遥测选项卡
image
打开设备详情
image
打开遥测选项卡

步骤3. 创建仪表板

下面文档中将创建一个仪表板并添加部件。

步骤3.1 创建空仪表板

  • 单击"+"图标添加仪表板
  • 输入仪表板名称
  • 倒序显示仪表板列表
image
单击"+"图标添加仪表板
image
输入仪表板名称
image
倒序显示仪表板列表

步骤3.2 添加别名

做为入门教程我们将使用“单一实体”别名来引用唯一实体，你也可以配置引用多个设备的别名例如某种类型或与某种资产相关的设备， 别名是部件的单个实体或实体组的引用可以是静态或者动态的引用， 你也可以在此处了解有关不同别名的更多信息。

  • 进入编辑模式
  • 单击“别名”图标
  • 单击”添加别名“".
  • 输入别名称
  • 单击“添加”后“保存”
  • 单击”应用更改“
image
进入编辑模式
image
单击“别名”图标
image
单击”添加别名“".
image
输入别名称
image
单击“添加”后“保存”
image
单击”应用更改“

步骤3.3 添加表格部件

从部件库中选中表格部件 并且每个部件都有一个数据源用于显示数据， 如果要显示第2步中的最新数据我们必须配置数据源。

  • 单击“添加”部件按钮
  • 单击“卡片”部件包择“最新值”部件
  • 添加数据源
  • 选择实体别名
  • 拖动改变部件尺寸
image
单击“添加”部件按钮
image
单击“卡片”部件包择“最新值”部件
image
添加数据源
image
选择实体别名
image
拖动改变部件尺寸

现在已经添加了一个表格部件你可以发送最新的遥测数据，数据会实时显示在表格中。

步骤3.4 添加图表部件

从部件库中选中图表部件 图表部件显示同一数据key的多个历史值, 通过配置时间显示更多数据。

  • 进入编辑模式
  • 单击“添加”部件
  • 单击“创建”部件图标
  • 选择“图表”部件包使用"Timeseries-Flot"部件
  • 单击“添加数据源”
  • 选择实体别名
  • 拖动改变部件尺寸
  • 发布遥测数据
  • 进入编辑模式，修改间隔和聚合函数
image
进入编辑模式
image
单击“添加”部件
image
单击“创建”部件图标
image
选择“图表”部件包使用"Timeseries-Flot"部件
image
单击“添加数据源”
image
选择实体别名
image
拖动改变部件尺寸
image
发布遥测数据
image
进入编辑模式，修改间隔和聚合函数

现在已经添加了一个图表部件你可以发送遥测数据，数据会实时显示在图表中。

步骤3.5 添加警报部件

  • 进入编辑模式
  • 单击“添加”部件
  • 单击“创建”部件
  • 选择“警报”部件包使用"Alarm"部件
  • 单击“添加数据源”
  • 选择实体别名
  • 拖动改变部件尺寸
image
进入编辑模式
image
单击“添加”部件
image
单击“创建”部件
image
选择“警报”部件包使用"Alarm"部件
image
单击“添加数据源”
image
选择实体别名
image
拖动改变部件尺寸

现在已经添加了一个警报部件，可以开始配置报警规则。

步骤4. 配置警报规则

如果数据大于25度时将触发警报规则功能发出警报， 因此需要编辑设备配置添加新的警报规则， “My New Device”使用的”default”设备配置， 建议为每一个对应的设备类型创建一个专用的设备配置教程中为了简单省略了此步骤。

  • 打开设备配置
  • 单击default配置
  • 选择“警报”选项卡
  • 单击"添加"警报规则
  • 单击“+”图标添加报警规则
  • 单击"添加"过滤条件
  • 输入键名单击“添加”
  • 选择操作符并输入阈值
  • 单击“保存”
  • 单击”应用更改“
image
打开设备配置
image
单击default配置
image
选择“警报”选项卡
image
单击"添加"警报规则
image
单击“+”图标添加报警规则
image
单击"添加"过滤条件
image
输入键名单击“添加”
image
选择操作符并输入阈值
image
单击“保存”
image
单击”应用更改“

步骤5. 创建警报

现在我们的警报规则已激活（请参阅第4步） 模拟设备数据发送遥测数据（请参阅第2步）以触发警报 温度值应为26或更高才能产生警报并且在仪表板上会立刻显示这条警报数据。

  • 产生最新警报
  • 确认清除警报
image
产生最新警报
image
确认清除警报

步骤6. 警报通知

建议你预先查看了解警报通知相关规则和示例文档。

注意：目前ThingsBoard支持AWS SNS和Twilio这两项付费短信发送服务，你需要创建一个帐户。但是你可以使用REST API call与其他SMS/EMAIL网关集成。

步骤7. 共享仪表板

ThingsBoard最重要的功能之一是能够将仪表板分配给客户， 可以将不同的设备分配给不同的客户。 然后可以创建一个仪表板并将其分配给多个客户，每个用户将看到他自己的设备，将无法看到其它客户的设备或任何其他数据。

已经创建了一个设备（请参见步骤1）和仪表板（请参阅步骤3）， 现在创建客户和用户并确保他们可以访问设备的数据和仪表板， 租户管理员可以为客户提供两种选择：客户管理员可以访问某些实体（设备，仪表板，资产等）：

  • A.将客户成为实体的所有者此选项对于确保只有该客户才能访问设备及其数据很有用（请参见步骤7.2）；
  • B.与客户共享实体此选项可与多个客户共享一个仪表板（请参阅步骤7.3）。

步骤7.1 创建客户

创建一个名称为“My New Customer”的客户。

  • 打开客户分组页面
  • 导航到“ALL”客户分组
  • 单击“+”添加客户
  • 输入标题单击“添加”
image
打开客户分组页面
image
导航到“ALL”客户分组
image
单击“+”添加客户
image
输入标题单击“添加”

步骤7.2 更改设备所有者

让客户成为设备的所有者。

  • 选择设备然后单击“更改所有者”按钮
  • 输入客户名称和信息
  • 单击“更改所有者”按钮
  • 单击确认
  • 设备列表为空，导航到客户分组查看设备
  • 设据在"All"分组中
image
选择设备然后单击“更改所有者”按钮
image
输入客户名称和信息
image
单击“更改所有者”按钮
image
单击确认
image
设备列表为空，导航到客户分组查看设备
image
设据在"All"分组中

步骤7.3 共享仪表板

共享仪表板给客户在实际情况下应该创建一个仪表板组，在这里为了简单直接使用“所有”组。

  • 打开“仪表分组”然后单击“共享”按钮
  • 选择客户并分享
image
打开“仪表分组”然后单击“共享”按钮
image
选择客户并分享

步骤7.4 创建用户

创建一个客户并指定此用户对仪表板和设备的只读访问权限， 可以将仪表板配置为用户登录平台后显示的首页。

  • 打开"客户分层结构"选择“用户”然后单击“添加”
  • 指定email地址
  • 复制激活链接
  • 打开用户详细信息
  • 选择仪表板并启用“始终全屏”模式
image
打开"客户分层结构"选择“用户”然后单击“添加”
image
指定email地址
image
复制激活链接
image
打开用户详细信息
image
选择仪表板并启用“始终全屏”模式

步骤7.5 激活用户

  • 复制激活链接设置密码
  • 浏览数据并确认/清除警报
image
复制激活链接设置密码
image
浏览数据并确认/清除警报

下一步

  • 安装指南 - 学习如何在各种操作系统上安装ThingsBoard。

  • 连接设备 - 学习如何根据你的连接方式或解决方案连接设备。

  • 可 视 化 - 学习如何配置复杂的ThingsBoard仪表板说明。

  • 数据处理 - 学习如何使用ThingsBoard规则引擎。

  • 数据分析 - 学习如何使用规则引擎执行基本的分析任务。

  • 硬件样品 - 学习如何将各种硬件平台连接到ThingsBoard。

  • 高级功能 - 学习高级ThingsBoard功能。


ThingsBoard专业版课程

意见反馈

希望你在github上为ThingsBoard加star帮助我们宣传， 如果你对此示例有任何疑问请在论坛发布。

© 2023 作者：ThingsBoard 蜀ICP备19012996号-2