通用电力线巴士(UPB)
UPB集成允许家庭助理连接到通用Powerline B必威是什么us Powerline接口模块(UPB PIM),以获得状态和控制UPB设备和UPB链接。UPB PIM可以连接到串行端口或通过TCP。集成实现以下平台:
- 光
- 场景
先决条件
UPB集成要求从暴发户
UPB配置程序。为了创建导出,暴发户
,单击左上方的UPB按钮,然后选择导出到文件。这将与.upe
扩大。该文件必须放置在家庭助手安装的配置目录中。必威是什么必威体育存款
配置
可以通过使用此my按钮将通用Powerline Bus(UPB)添加到您的家庭助必威体育存款理实例中:必威是什么
设备配置
使用Upstart,将每个UPB调光器开关配置在手动操作时报告其状态。如果您省略了此步骤,则手动更改为调光器的状态(开/关/亮度)将不是报告给家庭助理。必威是什么
事件
每当UPB链接为:
- 活性
- 停用
- 进入一个新的水平
- 淡出开始
- 淡入淡出
- 眨眼开始
活动是UPB.Scene_changed
。
这event_data
包含以下内容:
命令
:之一活性
,,,,眨
,,,,停用
,,,,fade_started
,,,,fade_stopped
, 或者去
。地址
:链接报告事件的地址。这地址
由UPB网络号和UPB链接编号组成。例如,对于UPB网络编号42和UPB链接编号24地址
将是42_24。brightness_pct
:亮度水平为百分比。brightness_pct
如果亮度是默认的亮度水平,则报告为-1,不适用于链接更改。速度
:链接到过渡到新级别的速率。速度
对于默认过渡速率为-1。
服务
除了家庭助理提供的标准服务必威是什么光和场景集成,以下额外服务由UPB集成提供:
UPB.LIGHT_FADE_START
UPB.LIGHT_FADE_STOP
upb.light_blink
UPB.SCENE_DEACTIVATE
UPB.SCENE_GOTO
UPB.SCENE_FADE_START
UPB.SCENE_FADE_STOP
UPB.SCENE_BLINK
费率过渡时间
采用标准和自定义服务过渡
或a速度
为了改变亮度水平,需要花费几秒钟的时间。UPB系统仅提供一组离散的过渡时间。因此,请求的过渡时间将根据下表更改为最接近的时间。请注意,此表不适用于眨眼率,仅适用于亮度过渡时间。
请求率> = | 要求的费率< | 使用的费率 |
---|---|---|
0秒 | 0.4秒 | 0秒 |
0.4秒 | 1.2秒 | 0.8秒 |
1.2秒 | 2.45秒 | 1.6秒 |
2.45秒 | 4.15秒 | 3.3秒 |
4.15秒 | 5.8秒 | 5.0秒 |
5.8秒 | 8.3秒 | 6.6秒 |
8.3秒 | 15秒 | 10秒 |
15秒 | 25秒 | 20秒 |
25秒 | 45秒 | 30秒 |
45秒 | 90秒 | 60秒 |
1.5分钟 | 3.5分钟 | 2分钟 |
3.5分钟 | 7.5分钟 | 5分钟 |
7.5分钟 | 12.5分钟 | 10分钟 |
12.5分钟 | 22.5分钟 | 15分钟 |
22.5分钟 | 45分钟 | 30分钟 |
45分钟 | ∞ | 1小时 |
服务UPB.LIGHT_FADE_START
开始光线向指定级别的过渡。不可隔离的灯忽略淡出启动命令。
服务数据属性 | 选修的 | 描述 |
---|---|---|
ENTITY_ID |
是的 | UPB光,以开始褪色操作。 |
亮度 |
不* | 在0到255之间的整数对于光的光线应有多大的光度,其中0表示光线关闭,1是最小亮度,而255是最大亮度。*只有一个亮度 和brightness_pct 可能用过了。 |
brightness_pct |
不* | 0到100之间的数字在百分比中指定了光的亮度,其中0表示光线熄灭,1是最小亮度,而100是最大亮度。*只有一个亮度 和brightness_pct 可能用过了。 |
速度 |
是的 | 代表时间(以秒为单位)的数字应为过渡到新状态。有关该时间值的解释方式,请参见“费率转换时间”部分。 |
服务UPB.LIGHT_FADE_STOP
从一个灯级过渡到另一个光线时,请停止光线。停止褪色或goto(使用时发生了light.turn_on
或者light.turn_off
。
服务数据属性 | 选修的 | 描述 |
---|---|---|
ENTITY_ID |
是的 | UPB光,以停止褪色操作。 |
服务UPB.LIGHT_BLINK
开始闪烁。
服务数据属性 | 选修的 | 描述 |
---|---|---|
ENTITY_ID |
是的 | UPB光线可以闪烁。 |
速度 |
不 | 数字在0到4.25之间,代表时间(以秒为单位)闪光的时间(秒)。请注意,UPB实现将眨眼速率限制在一秒钟的1/3速度中。 |
服务UPB.SCENE_DEACTIVATE
停用场景。“停用”一词是一个通用的UPB术语,通常意味着转到OFF状态,但是每个设备制造商都可以为其设备定义不同的定义。
服务数据属性 | 选修的 | 描述 |
---|---|---|
ENTITY_ID |
是的 | UPB场景停用。 |
服务UPB.SCENE_GOTO
开始场景过渡到指定级别。
服务数据属性 | 选修的 | 描述 |
---|---|---|
ENTITY_ID |
是的 | UPB场景过渡。 |
亮度 |
不* | 在0到255之间的整数对于场景的明亮程度,0表示场景关闭,1是最小亮度,而255是最大亮度。*只有一个亮度 和brightness_pct 可能用过了。 |
brightness_pct |
不* | 在0到100之间的数字以百分比为单位,指定场景的光亮程度,其中0表示场景关闭,1是最小亮度,而100是最大亮度。*只有一个亮度 和brightness_pct 可能用过了。 |
速度 |
是的 | 代表时间(以秒为单位)的数字应为过渡到新状态。有关该时间值的解释方式,请参见“费率转换时间”部分。 |
服务UPB.SCENE_FADE_START
开始场景过渡到指定级别。场景中无法偏光的灯忽略了淡出的启动命令。
服务数据属性 | 选修的 | 描述 |
---|---|---|
ENTITY_ID |
是的 | UPB场景过渡。 |
亮度 |
不* | 在0到255之间的整数对于场景的明亮程度,0表示场景关闭,1是最小亮度,而255是最大亮度。*只有一个亮度 和brightness_pct 可能用过了。 |
brightness_pct |
不* | 在0到100之间的数字以百分比为单位,指定场景的光亮程度,其中0表示场景关闭,1是最小亮度,而100是最大亮度。*只有一个亮度 和brightness_pct 可能用过了。 |
速度 |
是的 | 代表时间(以秒为单位)的数字应为过渡到新状态。有关该时间值的解释方式,请参见“费率转换时间”部分。 |
服务UPB.SCENE_FADE_STOP
从一个光层过渡到另一个光线时停止场景。停止褪色或goto。
服务数据属性 | 选修的 | 描述 |
---|---|---|
ENTITY_ID |
是的 | UPB场景,以停止褪色操作。 |
服务UPB.SCENE_BLINK
开始一个场景闪烁。
服务数据属性 | 选修的 | 描述 |
---|---|---|
ENTITY_ID |
是的 | UPB场景可以眨眼。 |
速度 |
不 | 数字在0到4.25之间,表示场景闪烁的时间(以秒为单位)。请注意,UPB实现将眨眼速率限制在一秒钟的1/3速度中。 |
例子
#自动化:-别名:“'具体的场景活性'”描述:“扳机什么时候场景9在网络42是活性”扳机:平台:事件事件类型:UPB.Scene_changedevent_data:命令:活性地址:“42_9”行动:服务:persistent_notification.greate数据:标题:“场景活性”信息:>网络42上的激活场景9:
#脚本:all_lights_on:别名:“全部灯在”描述:“启用二UPB场景命名internior_lights和外部_lights”顺序:-服务:scene.turn_on目标:ENTITY_ID:-scene.interior_lights-scene.exterior_lightsall_lights_off:别名:“全部灯离开”描述:“停用二UPB场景命名internior_lights和外部_lights”顺序:-服务:UPB.SCENE_DEACTIVATE目标:ENTITY_ID:-scene.interior_lights-scene.exterior_lightsKitchen_Fade_on:别名:“厨房褪色到在”描述:“转动在厨房光到75%超过A时期的10秒顺序:-服务:UPB.LIGHT_FADE_START目标:ENTITY_ID:Light.Kitchen数据:brightness_pct:75速度:10
笔记
- UPB设备并不总是报告其当前状态。例如,如果您打电话
UPB.LIGHT_FADE_START
然后,几秒钟后,请致电UPB.LIGHT_FADE_STOP
,所选的UPB设备不会报告其新的亮度水平。但是,如果您打电话homeassistant.update_entity
它将使UPB设备向家庭助理报告其当前状态。必威是什么