ThingsBoard开发入门

实验二 ThingsBoard开发入门

实验目的

通过一个简单的应用案例，掌握如何去创建设备，客户和资产；了解如何去使用cURL命令行传输数据；了解如何仪表板的使用；了解如何去设置警报；掌握客户用户的创建。
实验内容
（1） 阅读Thingsboard入门文档。
（2） 安装并配置cURL工具。
（3） 发布并接收到遥测数据。
（4） 创建警报，并设置相应阈值。
（5） 创建客户用户，登陆查看客户界面。
注：ThingsBoard官网相关内容地址：
英文版
中文版

实验要求

（1） 了解并掌握ThingsBoard的基础操作
（2） 了解cURL的环境配置与使用
（3） 了解并掌握仪表板中的基本操作流程
（4） 了解并掌握ThingsBoard中每个模块之间的联系

实验步骤

本次实验通过模拟连接Thingsboard物联平台，上传设备的遥感数据，并可视化来自温度传感器的数据，来演示最流行的事物板功能的基本用法。我们将学习如何将设备连接到事物板;如何将数据从设备推送到物联网板;如何构建实时最终用户仪表板;如何定义阈值并触发警报;如何建立客户用户。

（1） 添加新设备
登陆到ThingsBoard并打开“设备”页面。单击表格右上角的“+”图标，然后选择“添加新设备”。输入设备名称。例如，“My New Device”。此时不需要其他更改。单击“添加”以添加设备。现在您的设备应该首先列出，因为默认情况下，表使用创建时间对设备进行排序。创建操作如下图所示：

图2-1 添加新设备

（2）连接设备
要连接设备，您需要先获取设备凭据。ThingsBoard支持各种设备凭据。我们建议使用默认的自动生成的凭据，每个设备都会有一个自动生成的访问令牌。单击表中的设备行以打开设备详细信息单击“复制访问令牌”。令牌将被复制到剪贴板。将其保存到安全的地方。操作如下图所示：

图2-2 复制访问令牌

（3）安装并配置cURL
cURL是一个利用URL语法在命令行下工作的文件传输工具。它支持文件上传和下载，是综合传输工具，在本实验中用于模拟数据的发布。
首先下载cURL，下载地址：https://curl.haxx.se/download.html。

然后配置环境变量，类似Java环境的配置。解压安装包，新建系统环境变量，变量名是CURL_HOME变量值是安装包解压到的路径，然后编辑path变量，添加%CURL_HOME%\I386和安装包里的bin路径，确定即可。在CMD中输入curl –help测试。测试结果如图2-3所示：

图2-3 检查本机的cURL环境

然后在该文件夹下打开命令行工具，执行以下命令发布温度数据：
curl -v -X POST -d “{“temperature”: 25}” $THINGSBOAR{D}_{H}OS{T}_{N}AME/api/v1/$ACCESS_TOKEN/telemetry --header “Content-Type:application/json”
其中将$THINGSBOARD主机名和$ACCESS令牌替换为相应的值。成功发布“温度”读数后，应立即在“设备遥测”选项卡中看到它们。

(4) 仪表盘设置
在仪表盘库中新建一个仪表盘，如图2-4所示：

图2-4 新建仪表盘

进入编辑模式。单击右下角的铅笔按钮。单击屏幕右上方的“实体别名”图标。您将看到实体别名的空列表。单击“添加别名”。输入别名，例如“My Device”。选择“单个实体”筛选器类型。选择“设备”作为“类型”，然后键入“My New Device”以启用自动完成。从自动完成中选择您的设备，然后单击它。单击“添加”，然后单击“保存”。最后，单击仪表板编辑器中的“应用更改”以保存更改。然后，您应该再次进入编辑模式。添加实体别名如图所示

图2-5 给实体添加别名

进入编辑模式。单击“添加新小部件”按钮。选择“卡片”小部件捆绑包。选择“最新值”选项卡。单击“实体”小组件的标题。将出现“添加小部件”窗口。单击“添加”以添加数据源。一个小部件可能有多个数据源，但在本例中，我们将仅使用一个数据源。选择“My Device”实体别名。然后单击右侧的输入字段。将显示具有可用数据点的自动完成。选择“Temperature”数据点，然后单击“添加”。如图2-6所示：
选择路径：Cards/Entities table

图2-6 添加一个新的小部件

类似的操作添加图标（Chart）。如图2-7所示：
选择路径Chart/ Timeseries Line Chart
在这里面可以观测到你所发布的温度数据。
添加报警部件（Alarm）如图2-8所示：
选择路径：Alarm Widgets /Alarm table
最后一定要点击“√”按钮，保存好应用修改。

图2-7 添加图标（Chart）

图2-8 添加报警部件（Alarm）

添加完成后的仪表盘界面如下图：

图2-9 完成后的仪表板库界面

（５）配置报警信息
导航到设备配置文件页面。单击默认配置文件行。这将打开设备配置文件详细信息。选择“Alarm　rule”选项卡并切换编辑模式。点击“添加报警规则”。指定报警类型，单击“+”图标添加报警规则条件。单击“添加密钥筛选器”按钮以指定条件。选择键类型，输入键名称，选择值类型，然后单击“添加”。选择操作和输入阈值（大于２５°）。点击“添加”。点击“保存”。最后，单击“应用更改”。如图2-10所示：

图2-10 配置报警信息

（６）报警测试
通过命令行发布温度信息，当温度高于２５°时，观察仪表盘中的报警信息。如下图所示：

图2-11 发布数据测试报警部件

（７）将设备和仪表板分配给客户
ThingsBoard 最重要的功能之一是能够将仪表板分配给客户。您可以将不同的设备分配给不同的客户。然后，您可以创建一个仪表板并将其分配给多个客户。每个客户用户都将看到自己的设备，并且无法看到属于其他客户的设备或任何其他数据。
首先创建一个客户，导航到“客户”页面，单击“+”号以添加客户，添加客户标题（My New Customer），然后单击“添加”。再将设备和仪表板分配给客户。如下图：

图2-12 创建一个客户

现在我们需要创建一个客户用户，导航回“客户”页面，然后单击“管理客户用户”图标。单击“添加用户”图标。指定您将用于以客户用户身份登录的电子邮件，然后单击“添加”。复制激活链接并将其保存到安全位置。稍后将使用它来设置密码。打开用户详细信息。切换编辑模式。选择默认仪表板，然后选中“始终全屏”。应用更改。如下图所示：

图2-13 创建一个客户用户

设置密码并登陆查看客户用户界面，实验结束。

图2-14 登陆客户用户界面