Home Assistant Bond 集成使用 bond.set_fan_speed_tracked_state 校正风扇速度的跟踪状态【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io导读本文讲解 Home Assistant 中 Bond 集成Bond Bridge提供的bond.set_fan_speed_tracked_state动作在不向风扇发送任何控制信号的前提下手动更新 Home Assistant 认为风扇当前运行的速度百分比。由于 Bond Bridge 通过单向射频one-way radio控制设备、无法感知设备真实状态本动作是与遥控器、墙壁开关等外部操作保持状态同步的关键工具。读完本文你将掌握该动作的 UI 操作路径、完整 YAML 配置、目标target选择规则以及一个基于遥控器按键事件自动重同步速度的自动化示例。Bond 集成与跟踪状态问题背景Bond Bridge集成文档通过复制原始 RF 遥控器的信号来控制吊扇、遮阳帘、壁炉等设备属于典型的单向射频控制Home Assistant 把指令发给 BondBond 转发给设备但设备不会回报自己的真实状态。因此Home Assistant 中风扇实体的速度属性只是跟踪状态tracked state即 Home Assistant 认为设备所处的状态而不是通过回读得到的实测状态。一旦用户直接用原厂遥控器调整了风扇速度Home Assistant 的跟踪状态就会与真实状态脱钩drift out of sync。bond.set_fan_speed_tracked_state正是为此设计的校正动作。动作语义只更新跟踪状态不发送信号这是理解本动作最关键的一点该动作只更新 Home Assistant 内部跟踪的速度值不向 Bond 或风扇发送任何射频信号执行后风扇继续以原来的真实速度运行物理上不发生任何变化它的用途是重同步resync把 Home Assistant 的认知修正到与真实设备一致。正因如此该动作非常适合用于原厂遥控器操作后的状态同步场景也适合在自动化中把风扇速度纳入状态机判断例如基于fan.xxx.fan_speed属性做后续逻辑之前先确保跟踪值准确。在 UI 中设置跟踪风扇速度如果你习惯用可视化界面UI 操作说明按以下步骤操作进入设置 自动化与场景Settings Automations scenes。打开一个已有的自动化或脚本或选择创建自动化 创建新自动化。若是新建自动化在When何时区域添加触发器脚本无需触发器由其他自动化调用时直接执行。在Then do然后执行区域选择添加动作Add action。选择要控制的对象在按目标By target参见下文目标选择下选择区域、楼层、设备、标签或实体。在针对该目标列出的动作中选择设置风扇速度跟踪状态Set fan speed tracked state。将风扇速度Fan speed设置为风扇实际运行的速度百分比0–100。点击保存。UI 中的选项选项说明Fan speed风扇速度风扇实际运行的速度百分比取值范围 0 到 100YAML 用法与完整参数在 YAML 中该动作以bond.set_fan_speed_tracked_state调用。最基础的示例action: bond.set_fan_speed_tracked_state target: entity_id: fan.living_room_fan data: speed: 50以上配置告诉 Home Assistant实体fan.living_room_fan当前正以 50% 的速度运行。YAML 选项选项必填类型说明speed是整数integer风扇实际运行速度百分比取值范围 0 到 100动作的目标Targets选择规则该动作要求必须指定目标。目标即动作的作用对象可指向实体、设备、区域、楼层或标签Home Assistant 会对该目标背后的每一个 fan 实体执行动作目标说明实体Entity单个 fan 实体如fan.living_room_fan设备Device该设备下的所有 fan 实体区域Area某个房间/区域内的所有 fan 实体楼层Floor某个楼层上的所有 fan 实体标签Label共享同一标签的所有 fan 实体。还可以在同一个动作中混用多种目标类型例如同时指定一个具体实体和一个区域让动作对两者一起生效。实战示例遥控器调速后自动重同步最常见的落地场景遥控器上的某个物理按键通过独立传感器上报告诉 Home Assistant风扇已被设为高速此时用自动化把跟踪速度修正为 100%与真实状态保持一致。场景描述触发器遥控器high高速按键被按下动作设置风扇速度跟踪状态目标客厅风扇风扇速度100。完整 YAML 自动化automation: - alias: Resync the living room fan speed triggers: - trigger: state entity_id: sensor.fan_remote_button to: high actions: - action: bond.set_fan_speed_tracked_state target: entity_id: fan.living_room_fan data: speed: 100这里的思路是把遥控器按键被按下建模为一个传感器状态变化事件sensor.fan_remote_button变为high随后用本动作把 Home Assistant 对风扇速度的认知重同步到真实值。你可以在更多示例说明中看到这类动作的更多真实使用场景并复制适配到自己的配置。相关动作一套完整的跟踪状态同步体系本动作与 Bond 集成的另外三个跟踪状态动作构成完整体系相关动作动作用途bond.set_switch_power_tracked_state更新 Home Assistant 认为 Bond 开关是开还是关参数power_state布尔值bond.set_light_power_tracked_state更新 Home Assistant 认为 Bond 灯是开还是关bond.set_light_brightness_tracked_state更新 Home Assistant 认为 Bond 灯的亮度参数brightness0–255 刻度这些动作遵循相同的仅更新跟踪状态、不发送信号语义适用于同一个重同步场景。如果风扇转速与灯具亮度需要一起校正可在自动化中组合使用。使用注意事项本动作不会向风扇发送信号风扇会保持原样运行请在风扇被原厂遥控器改变速度后使用它来重同步 Home Assistantspeed参数为整数范围 0–100务必填写风扇实际运行的百分比而非期望值动作依赖目标选择未指定有效目标时不会生效参考目标选择一节。前置条件使用该动作的前提是已完成 Bond 集成的配置需要 Bond hub 的主机地址与访问令牌access token并满足集成文档中的固件要求——Bond 桥接器固件需为 v2.10.x 及以上v2.9.x 及以下无法正常工作。BPUP推送更新能力则要求固件 v2.10.8 或更新版本低版本会回退为轮询。【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考