跳到主要内容

基础概念

节点

节点 (Node) 是基于 ESP32 的单个产品,具有一个关联的标识符 (节点 ID) 和一组由 Claiming 服务提供的凭证。节点支持自定义名称。一个节点可以包含多个设备。

Node

节点属性

节点属性是给定节点的可选自定义元数据,类似于序列号。

设备

设备是一个用户可控制的逻辑实体,如开关、灯泡、恒温器、温度传感器等。一般而言,一个节点仅包含一个设备。不过,ESP32 既支持多个设备,如在一块开发板上集成两个开关,也可以用作 BLE 传感器等其他设备的桥接器。节点下的设备必须拥有唯一名称,用户也可以选择为设备指定一个类型。

设备属性

与节点属性类似,设备属性是给定设备的可选自定义元数据,格式为只读的名-值对,包括固件版本、序列号等信息。节点与多个设备连接时,例如将 Wi-Fi 桥接到有线网络、BLE、Zigbee 等,设备属性可为设备提供关键的元数据支持。

参数

设备的控制和监测参数,如开/关电源状态、亮度、当前/目标温度等。设备中的参数必须拥有唯一名称。参数可以拥有额外的字段,如值、类型、范围、UI 信息等。参数值支持布尔值、整数、浮点数或字符串。

服务

服务是一种实体,其结构与设备非常相似,不同的是,服务是专为无需用户可见的操作设计的。以 OTA 固件升级服务为例,它可以拥有 URL、状态等参数。