跳到主要内容

设备注册表

设备注册表是Home Assistant跟踪设备的注册表。设备通过一个或多个实体必威是什么在Home Assistant中表示。例如,电池供电的温度和湿度传感器可能会暴露温度、湿度和电池电量的实体。

设备注册表概述

什么是设备?

家庭助手中的设备表示具有必威是什么自己的控制单元的物理设备。控制单元本身不必是智能的,但它应该控制发生的事情。例如,一个带有4个房间传感器的Ecobee恒温器相当于Home Assistant中的5个设备,一个用于恒温器,包括其内部的所有传感器,每个传感器一个。每个设备存在于特定的地理区域内,并且在该区域内可能有多个输入或输出。

如果您将传感器连接到另一个设备以读取其部分数据,它仍应表示为两个不同的设备。原因是传感器可以移动以读取其他设备的数据。

提供多个端点的设备,其中设备的部分在不同的区域中感测或输出,应拆分为单独的设备,并使用通过U设备属性这允许将单独的端点指定给建筑中的不同区域。

信息

虽然目前不可用,但我们可以考虑为用户提供一个合并设备的选项。

设备属性

属性 描述
区域id 放置设备的区域。
配置项 配置链接到此设备的条目。
配置url 可以在其上配置设备或服务的URL,可以通过使用必威是什么家庭助手://.
连接 一组元组(连接类型,连接标识符). 连接类型在设备注册表模块中定义。
默认名称 此设备的默认名称,如果名称一切就绪。例如,对于显示网络上所有设备的集成非常有用。
默认制造商 如果发生以下情况,设备制造商将被推翻:制造商一切就绪。例如,对于显示网络上所有设备的集成非常有用。
默认_模型 如果发生以下情况,将覆盖设备的型号:模型一切就绪。例如,对于显示网络上所有设备的集成非常有用。
入口类型 条目的类型。可能的价值是没有一个“服务”.
身份证件 设备的唯一ID(由家庭助理生成)必威是什么
标识符 一套(域、标识符)元组。标识符标识外部世界中的设备。例如序列号。
名称 此设备的名称
制造商 该设备的制造商。
模型 设备的型号。
建议面积 设备所在区域的建议名称。
sw_版本 设备的固件版本。
通过U设备 在该设备和家庭助理之间路由消息的设备的标识符。此类设备的示例为集线器或子设备的父设备。这用于在Home Assistant中显示设备拓扑必威是什么。

定义设备

提示

实体设备信息仅在通过配置条目唯一标识属性已定义。

每个实体都可以通过设备信息所有物通过配置条目将实体添加到Home Assistant时,将读取此属性。设备将通过提供的标识符或连接(如序列号或M必威是什么AC地址)与现有设备匹配。如果提供了标识符和连接,设备注册表将首先尝试按标识符进行匹配。每个标识符和每个连接单独匹配(例如,只有一个连接需要匹配才能被视为同一设备)。

#月台内
火光(轻盈):
@财产
def设备信息(自己):
回来{
“标识符”:{
#序列号是特定域中的唯一标识符
(颜色.领域,自己.唯一标识)
},
“姓名”:自己.名称,
“制造商”:自己..制造商名称,
“模型”:自己..产品名称,
“sw_版本”:自己..swversion,
“通过_设备”:(颜色.领域,自己.应用程序编程接口.布里奇德),
}

除了设备属性,设备信息还可以包括默认制造商,默认_模型,默认名称. 如果还没有定义其他值,这些值将添加到设备注册表中。这可用于了解一些信息但不太具体的集成。例如,根据MAC地址识别设备的路由器。

人工登记

组件还能够在没有实体表示它们的情况下注册设备。例如,与灯光进行通信的集线器。

#组件内部
从…起家庭助理.助手进口设备注册博士

设备注册=博士.异步获取(哈斯)

设备注册.异步\u获取\u或\u创建(
配置\u条目\u id=进入.入口id,
连接={(博士.连接\u网络\u MAC,配置.雨衣)},
标识符={(领域,配置.布里奇德)},
制造商=“意味着”,
建议面积=“厨房”,
名称=配置.名称,
模型=配置.模型ID,
sw_版本=配置.swversion,
)
Baidu