ThingsBoard 入门

本教程的目的是演示最新的 ThingsBoard 功能的基本用法。您将学习如何：

• 将设备连接到 ThingsBoard；
• 将数据从设备推送到 ThingsBoard；
• 构建实时最终用户仪表板；
• 定义阈值并触发警报；
• 通过电子邮件、短信或其他系统设置有关新警报的推送通知。

在本指南中，我们将连接并可视化来自温度传感器的数据以使其保持简单。

先决条件

您需要启动并运行 ThingsBoard 服务器。最简单的方法是使用Live Demo服务器。

另一种选择是使用安装指南安装ThingsBoard。Windows 用户应遵循本指南。

步骤 1. 配置设备

举例来说，让我们添加一个设备，它将把以下数据传输到 ThingsBoard 平台：设备的名称和温度读数作为遥测。

要添加新设备，请按照以下步骤操作：

• 登录您的 ThingsBoard 实例并转到“实体”部分的“设备”页面；
• 点击表格右上角的“+”图标，然后从下拉菜单中选择“添加新设备”；
• 输入设备名称。例如，“我的新设备”。此时无需进行其他更改。点击“添加”；
• 将打开一个窗口，您可以在其中检查设备与 ThingsBoard 的连接。此步骤是可选的。我们现在关闭此窗口，然后在下一步中更详细地检查连接；
• 恭喜您添加了第一台设备！随着您添加更多设备，设备将添加到表格顶部，因为表格会自动按设备创建时间对设备进行排序，最新的设备将排在最前面。

添加新设备时，您会收到通知。您可以点击右上角的“铃铛”图标查看。

在此了解有关通知的更多信息以及如何配置它们。

您还可以使用：

• 使用 UI 从 CSV 文件批量配置多个设备；
• 设备配置允许设备固件自动配置设备，因此您无需手动配置每个设备；
• REST API以编程方式配置设备和其他实体；

步骤2.连接设备

现在，让我们检查设备与 ThingsBoard 平台的连接。为此，请使用“检查连接”功能代表您的设备发布遥测数据（例如温度读数）。您可以在添加设备时和之后执行此操作。

• 点击您的设备，然后点击“设备详情”窗口中的“检查连接”按钮；
• 在打开的窗口中选择消息传递协议和您的操作系统。安装必要的客户端工具并复制命令；
• 执行之前复制的命令。成功发布“温度”读数后，设备状态应从“非活动”更改为“活动”，并且您应该看到已发布的“温度”读数。现在，关闭连接窗口。

您也可以使用ThingsBoard API 参考。在这里，您可以找到有关所有支持的设备连接协议的更多详细信息。

步骤 3. 创建仪表板

ThingsBoard 中的仪表板允许用户可视化和监控从物联网设备收集的数据。

让我们创建一个仪表板并向其中添加三个小部件，以显示实体列表及其最新值，以及显示与指定实体相关的警报信号。

步骤 3.1 创建一个空的仪表板

要创建新的仪表板，请按照以下步骤操作：

• 通过屏幕左侧的主菜单进入“仪表盘”页面，点击屏幕右上角的“+”号，在下拉菜单中选择“创建新仪表盘”；
• 在打开的对话框中，需要输入仪表板标题，描述是可选的。点击“添加”;
• 创建仪表板后，它将自动打开，您可以立即开始向其中添加小部件。要保存仪表板，请单击右上角的“保存”按钮；
• 您的第一个仪表板已成功创建。随着您继续添加新仪表板，它们将出现在列表顶部。此默认排序基于创建时间戳。

步骤 3.2 添加实体表小部件

“实体表”小部件显示实体及其最新值的列表。实体列表对应于选定的设备或其他实体，并具有附加全文搜索和分页选项功能的过滤器。

要添加表格小部件，我们需要从小部件库中选择它。小部件被分组到小部件包中。每个小部件都有一个数据源。这就是小部件“知道”要显示什么数据的方式。要查看我们在步骤 2 中发送的“温度”数据的最新值，我们应该配置数据源。

让我们添加你的第一个小部件：

• 进入仪表板编辑模式。只需打开仪表板并点击屏幕右上角的“编辑模式”按钮即可；
• 单击屏幕顶部的“添加小部件”按钮，或单击屏幕中央的大“添加新小部件”图标（如果这是此仪表板上的第一个小部件）；
• 找到“表格”小部件包并单击它；
• 选择“实体表”小部件；
• 出现“添加小部件”窗口。在“设备”字段中指定之前创建的设备“我的新设备”作为数据源。“名称”键已添加到“列”部分，该部分负责包含设备名称的列。您需要添加另一个列，该列将显示“温度”键的值。为此，单击“添加列”以添加新字段以输入数据键；
• 点击新出现的数据键输入框。将打开可用数据键列表。选择“温度”数据键；
• 点击小部件右下角的“添加”按钮，完成小部件的添加。
• 要使小部件稍微变大一点，只需抓住右下角并拖动它即可。对新尺寸满意后，不要忘记点击“保存”以将更改保存到仪表板。

恭喜！您已添加第一个小部件。

在“实体表”小部件中，有两列。第一列显示设备的名称，第二列显示“温度”键（设备遥测）的值。因此，每列对应一个添加的键。

现在您可以发送新的遥测读数（如步骤 1中所述），它将立即出现在表中。

步骤 3.3 添加图表小部件

图表小部件允许您使用可自定义的折线图和条形图显示时间序列数据。

要添加图表小部件，我们需要从小部件库中选择它。图表小部件显示同一数据键（在我们的例子中为“温度”）的多个历史值。我们还应该配置时间窗口以使用图表小部件。

• 进入编辑模式，点击屏幕顶部的“添加新小部件”按钮；
• 找到“图表”小部件包并单击它；
• 选择“时间序列图表”小部件；
• 在“设备”字段中指定之前创建的设备“我的新设备”作为数据源。在“系列”部分，指定数据键“温度”，开始监控设备的温度值。然后点击“添加”；
• 调整小部件的大小并应用更改。多次发布不同的遥测值，如步骤 2 中所述。请注意，小部件默认仅显示一分钟的数据。单击“保存”以应用更改；

恭喜！您已添加图表小部件。现在您可以发送新的遥测读数，它将立即显示在图表中。

您还可以打开时间窗口并更改间隔和聚合函数。单击“更新”按钮更新时间窗口设置。

步骤 3.4 添加警报表小部件

报警表小部件显示特定时间窗口内与指定实体相关的报警。通过指定实体作为报警源以及相应的报警字段来配置报警小部件。

• 进入编辑模式，点击屏幕顶部的“添加新小部件”按钮；
• 找到“警报小部件”包并点击它；
• 选择“警报表”小部件；
• 在“设备”字段中指定之前创建的设备“我的新设备”作为数据源，并选择您想要在警报小部件中显示的警报状态和严重程度；
• 恭喜！您已添加警报小部件。默认情况下，新小部件会一个接一个地添加，向下堆叠。让我们稍微整理一下小部件，让它们排列得更整齐。将“时间序列图”小部件拖到仪表板的右上角，为“警报表”小部件腾出空间；
• 向下滚动找到“警报表”小部件。找到后，单击并将其拖到空闲位置。调整其大小以满足您的需求。调整完成后，单击“保存”以保存仪表板。

现在是时候配置警报规则并发出一些警报了。

注意：在本文档中，我们使用单个设备作为小部件的数据源。要使用动态实体（例如，特定类型或与特定资产相关的设备）作为数据源，您应该使用别名。别名是对小部件中使用的单个实体或一组实体的引用。您可以在此处了解有关不同别名的更多信息。

步骤4.配置报警规则

我们将使用报警规则功能，当温度读数大于 25 度时发出警报。为此，我们应该编辑设备配置文件并添加新的报警规则。“我的新设备”使用“默认”设备配置文件。我们建议为每个相应的设备类型创建专用的设备配置文件，但为了简单起见，我们将跳过此步骤。

• 进入“配置文件”部分的“设备配置文件”页面。然后点击默认设备配置文件行以打开其详细信息；
• 进入“报警规则”标签，点击“铅笔”按钮，进入编辑模式；
• 点击“添加报警规则”按钮；
• 指定报警类型，点击“+”图标添加报警规则条件；
• 点击“添加密钥过滤器”按钮，指定条件；
• 选择键类型，输入键名，选择值类型，然后点击“过滤器”部分中的“添加”按钮；
• 选择一个操作，输入阈值，点击右下角的“添加”按钮；
• 点击“保存”；
• 最后，点击“应用更改”。

步骤5. 创建闹钟

现在，我们的警报规则已启用（请参阅步骤 4），我们应该代表设备发送新的遥测数据（请参阅步骤 2）以触发警报。请注意，温度值应为 26 或更高才能引发警报。一旦我们发送新的温度读数，我们应该立即在仪表板上看到新的警报。

• 注意新的温度遥测引起新的主动报警；
• 您可以使用“警报表”小部件确认和清除警报；
• 当你收到新的闹钟时，你会在通知中心收到一条消息，点击右上角的铃铛图标即可查看消息。

我们还建议查看有关警报通知的警报规则示例 和文档。

步骤6. 警报通知

ThingsBoard通知中心允许向最终用户发送个性化通知。这些通知可以包括有关设备活动、环境温度变化或 IoT 生态系统中检测到的其他事件的通知。在此处了解有关通知及其配置方法的更多信息。

此外，ThingsBoard 移动应用程序允许用户直接在智能手机上接收即时推送通知。这可确保您无论身在何处都能及时了解 IoT 解决方案中的任何事件。按照本指南了解如何安装 ThingsBoard PE 移动应用程序并设置从 ThingsBoard 实例直接向智能手机发送推送通知。

步骤 7. 将设备和仪表板分配给客户

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

我们已经创建了设备（参见步骤 1）和仪表板（参见步骤 3）。现在是时候创建客户和客户用户，并确保他们可以访问设备的数据和仪表板。

步骤 7.1 创建客户

让我们创建一个客户，标题为“我的新客户”。请参阅以下说明：

• 导航到客户页面。单击“+”号添加客户；
• 输入客户标题并点击“添加”。
• 新客户已创建。

步骤 7.2 将设备分配给客户

让我们将设备分配给客户。客户用户将能够读取和写入遥测数据并向设备发送命令。

• 打开“设备”页面，然后选择您的设备以打开其详细信息；
• 点击“分配给客户”按钮；
• 选择您要分配该设备的客户，然后点击“分配”；
• 您已更改设备的所有者。在“客户”栏中，您可以看到设备所有者的名称；

确保该设备已分配给您的客户。

• 导航到“客户”页面，确保设备已分配给您的客户。在客户列表中找到您的客户，然后单击“管理客户设备”图标；
• 该设备在您的客户那里。

您可以在设备创建阶段让客户成为设备的所有者。

• 点击表格右上角的“+”图标，然后从下拉菜单中选择“添加新设备”；
• 输入设备名称（例如“恒温器”），并在“分配给客户”字段中选择要分配新设备的客户。然后点击“添加”；
• 关闭检查连通性窗口；
• 该设备已创建，并立即属于选定的客户。

步骤 7.3 将仪表板分配给客户

让我们与客户共享我们的仪表板。客户用户将拥有仪表板的只读访问权限。

• 打开“仪表板”页面。标记您的仪表板并点击“分配仪表板”图标；
• 标记“我的新客户”，点击“分配”；
• 导航到“客户”页面。单击“我的新客户”的“管理客户仪表板”图标；
• “我的新仪表板”已分配给您的客户。

步骤 7.4 创建客户用户

最后，让我们创建一个属于客户并有权read-only访问仪表板和设备的用户。您可以选择将仪表板配置为在用户登录平台 Web UI 后立即显示。

• 导航到“客户”页面。在客户列表中找到您的客户，然后单击“管理客户用户”图标；
• 点击表格右上角的“添加用户”图标；
• 指定您将用于以客户用户身份登录的电子邮件，然后单击“添加”；
• 复制激活链接并保存到安全的地方，稍后您将使用它来设置密码。点击“确定”；
• 点击已创建的用户，打开详细信息。点击“铅笔”图标进入编辑模式；
• 选择“我的新仪表板”作为默认仪表板，并勾选“始终全屏”。应用更改。

步骤 7.5 激活客户用户

• 将之前复制的链接粘贴到新的浏览器标签页中，然后按 Enter。想出并输入两次密码，然后按“创建密码”。您将自动以客户用户身份登录；
• 您已以客户用户身份登录。您可以浏览数据并确认/清除警报。