设备是ThingsBoard中的基础物联网实体，可生成遥测数据（如温度、湿度、GPS坐标等）并传输至ThingsBoard平台，还能响应远程过程调用（RPC）命令。 设备可以是物理对象（如传感器、控制器、追踪器）或虚拟对象（如模拟器），需具备网络连接能力，能够：
- 生成遥测数据——发送温度、湿度、位置等测量数据。
- 通过支持的协议（MQTT、HTTP、CoAP等）将数据传至ThingsBoard平台。
- 响应RPC命令——接收并执行平台发送的远程过程调用。
每台设备：
ThingsBoard支持通过Web界面和REST API进行设备管理。
实践视频课程 🎥
本实践视频课程详细讲解如何在ThingsBoard中创建和管理设备。
课程包含实践示例，帮助您更好地理解仪表板、资源和设备的配置与使用。
如何添加、编辑和删除设备
租户管理员及具有相应权限的用户可在ThingsBoard中创建、编辑或删除设备。
添加新设备
添加新设备的步骤：
- 进入 实体 ⟶ 设备。默认显示「全部」设备组。
- 点击右上角的「+」图标，在下拉菜单中选择「添加新设备」。
- 在设备创建表单中填写必填项：
- 名称——设备的唯一名称。
- 设备配置——默认使用「default」配置，可按需选择其他配置。
-
如需要，可填写附加字段（如label或description）、为设备指定不同owner，并将设备加入分组。
- 点击「Add」。
设备创建成功后会在列表中显示。
随后会弹出窗口，可在其中检查设备与ThingsBoard平台的连接。 此步骤可选。可先关闭窗口，稍后再详细了解连接检查。
您还会收到通知（铃铛图标）提示设备已添加。
创建设备组
设备可属于一个或多个分组，便于组织和管理。
创建新设备组的步骤：
- Go to the "Entities" section - "Devices" page. By default, you navigate to the device group "All". Navigate to the "Groups" tab and click on the "plus" icon in the upper right corner;
- Enter the name of the device group and click "Add";
- Your device group has been added.
管理设备组：添加、移动、移除
在设备页面可向分组添加设备、在分组间移动设备或从分组移除设备。
「全部」设备组始终包含所选所有者级别（租户或客户）下的所有设备。
向分组添加单个设备：
- 打开设备详情➜点击管理所有者和分组。
- 在对话框中按需调整所有者，选择要添加或移除设备的分组。
- 点击保存。
向一个分组添加多台设备：
- 在分组标签页打开任意设备组（如「全部」）。
- 通过名称左侧的复选框勾选设备。
- 点击右上角的「添加到分组」（加号圆圈图标）。
- 在添加到分组窗口选择选择现有实体组或创建新实体组。
- 选择已有分组或创建新设备组。
- 点击添加确认将设备加入分组。
注意：此操作会将设备加入所选分组，但不会从其他分组移除。
将设备移至另一分组：
- 打开特定（非 All）分组。
- 选中设备并点击 Move to group（双箭头图标）。
- 在「Move to group」窗口中选择 Select existing entity group 或 Create new entity group。
- 选择现有设备分组或创建新分组。
- 点击 Move 确认。
此操作会将设备从当前分组移出，并加入所选分组。
从分组中移除设备：
- 打开特定（非 All）分组。
- 选中设备并点击右上角 Remove from group（圆圈减号图标）。
- 确认移除。
注意：设备不会被删除； 它们仍保留在owner的 「All」设备分组中。
编辑设备
可修改设备名称、设备配置、标签，并分配固件和软件。 编辑设备步骤如下：
- In the devices list, locate and click on the desired asset, then click the "pencil" (✏️ Edit) icon on the right to open the edit form.
- Make the necessary changes and click the "Apply changes" button to save them.
删除设备
可通过以下任一方式删除设备：
方式一：
- Click on the "trash can" icon can opposite the device's name you want to delete.
- Confirm deleting the device in the dialog box.
方式二：
- Click on the device that you want to delete. In the device details window, click the "Delete device" button;
- Confirm deleting the device in the dialog box.
检查连接
检查连接是内置功能，提供即用命令，用于通过不同通信协议测试设备与ThingsBoard的连通性。可快速验证网络访问、凭证及遥测是否被正确处理。
使用此功能可发布测试遥测（例如温度为25），并立即确认设备能与平台通信。
验证设备连接：
若连接成功：
- 设备状态由未激活变为已激活。
- 最新遥测标签页会显示遥测数据。
根据您的技术栈连接设备，请参阅连接指南。
高级协议与API选项请参阅ThingsBoard API参考。
管理设备凭证
支持的凭证类型：
- Access Token（默认）。
- X.509 证书。
- MQTT Basic。
要修改或管理凭证，请按以下步骤操作：
- Open "Device details" window and click the "Manage credentials" button;
- Select the desired credential type and generate or enter required fields. Click "Save".
管理设备owner与groups
可更改设备的owner（可为Tenant或Customer，参见 glossary）以控制谁能访问该设备及其数据。更改 owner会将设备移至所选层级，并根据groups更新访问权限。
与Community Edition（CE）仅能将设备分配给特定客户不同，Professional Edition（PE）中还可通过「Manage owner and groups」按钮管理所有者与组成员关系。
操作步骤：
- 点击设备打开其 Device details。
- 点击「Manage owner and groups」按钮。
- 在 Owner 字段中选择 Tenant 或特定 Customer。
- 将设备加入相应设备组，或按需创建新组。
- 点击「Update」确认并应用更改。
注意：组成员关系与所有权的更改会立即生效，并根据所分配组的角色更新用户访问权限。
租户管理员始终有权重新分配或撤销设备所有权。
包含客户实体
在「Devices」页面有「Include customer entities」选项，用于控制列表是否显示归属于客户的设备。
- When the switch is enabled (default state) — the table shows all available devices, including those owned by customers.
- When the switch is disabled — the table shows only your own devices.
共享设备
可将设备加入设备组后，将组共享给客户。
详细步骤请参阅共享设备组一节。
将设备group设为公开
可将设备group设为公开，使其中所有数据对所有人可访问。适用于：
- 创建需访问设备数据的公开演示dashboard。
- 支持开放数据场景。
无法直接共享单个设备，只能共享包含该设备的设备group。
将设备group设为公开的步骤：
- 在列表中找到目标设备group。
- 点击其旁的「Make public」图标。
- 在弹出对话框中确认操作。
设为公开后，引用该group中设备的dashboard或外部系统将无需认证即可访问。
若要恢复为私有，请使用「Make private」图标按相同步骤操作。
共享设备group
可将设备group共享给一个或多个customer。例如，当多个customer需要访问同一设备时适用。
无法共享单个设备，只能共享包含该设备的设备group。
共享设备group的步骤：
- 在列表中找到目标设备group。
- 点击其旁的「Share」图标。
- 从下拉列表中选择目标customer。
- （可选）指定该customer下的 user group 以共享设备group。
- 点击「Share」确认操作。
管理与验证权限
设备group共享后，可随时查看、编辑或撤销权限。
-
在「Device groups」列表中，点击目标group的铅笔按钮打开「Entity group details」。
-
进入Permissions选项卡。
-
在此选项卡可查看该group已授予的全部权限列表。可进行：
-
Add 新权限：点击面板右上角「+」图标。将弹出对话框，可选择role和user group以授予访问权限。
-
Edit 已有权限：点击要修改的权限旁的铅笔图标。
-
Delete 权限：点击垃圾桶图标以移除该user group的访问权限。
设备详情
点击设备将打开窗口，可访问并管理该设备的各项内容。
Copy device ID
可快速获取设备的唯一UUID。点击Copy device Id可复制到剪贴板。该ID用于API调用、集成和脚本。
Copy device credentials
根据认证类型，可复制：
- Access Token
- MQTT Credentials
点击对应按钮即可获取连接设备到ThingsBoard所需的凭证。
Attributes
此选项卡显示client、server和shared attributes——与设备关联的静态或半静态键值对。常见示例包括序列号、型号和固件版本。
Latest telemetry
显示 latest telemetry 值，包括传感器读数、状态更新及其他实时参数。
- 添加遥测：点击「+」图标，输入key名称、值类型和值。
- 删除遥测：点击垃圾桶图标，选择删除模式（all data、latest value、all except latest或按时间段），并确认操作。
Calculated fields
显示由已有attributes或telemetry通过公式计算得出的字段。可在不修改设备固件的情况下定义衍生参数。更多详见 Calculated fields。
Alarm rules
包含定义设备告警生成方式的规则。可查看条件、阈值、触发器及已配置的告警action。更多详见 配置 alarm rules。
Alarms
显示与该设备相关的全部活动及历史 alarms。用于监控设备健康、跟踪告警并识别关键事件。
Events
显示与该设备关联的系统事件，包括日志、警告、错误及其他生命周期相关记录。可用于诊断和活动跟踪。
Relations
显示该设备与其他实体之间的全部有向 relations，如assets、devices、dashboards和rule chains。提供设备在整体系统中位置的上下文。
Audit logs
记录与设备相关的用户操作——创建、更新、配置变更及删除。可用于安全审计和追溯。
Version control
支持使用内置基于Git的 version control 服务导出和恢复ThingsBoard实体。支持备份、协作和配置版本管理。
后续步骤
-
连接设备 - 根据连接技术或方案学习如何连接设备。
-
数据可视化 - 配置ThingsBoard复杂仪表盘的说明。
-
数据处理与操作 - 学习使用ThingsBoard规则引擎。
-
IoT数据分析 - 学习使用规则引擎执行基本分析任务。
-
高级功能 - 了解ThingsBoard高级功能。