Home Assistant Insteon 集成 X10 All lights on 动作使用指南【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io导读本文讲解 Home Assistant Insteon 集成中insteon.x10_all_lights_on动作的完整用法它向同一 X10 家码house code下的所有 X10 灯具广播All lights on命令常用于到家自动化等批量开关灯场景。读完本文你将掌握该动作的 UI 配置步骤、YAML 写法、housecode参数约束以及它与x10_all_lights_off、x10_all_units_off两个兄弟动作的搭配策略。动作概述一次广播点亮整个家码在 Insteon 集成 中X10 设备与 Insteon 设备共享同一套电力线网络。insteon.x10_all_lights_on动作会向使用指定 X10 house code 的全部 X10 灯发送All lights on命令而不是逐个寻址某个单元码unit code。action: insteon.x10_all_lights_on data: housecode: a这一行命令的效果等价于对家码a下所有 X10 灯具分别发送开灯命令但只需一次动作调用即可完成。典型的落地场景是到家自动化——当家庭成员回家时触发该动作把客厅、走廊、厨房的 X10 灯一次性点亮。前置条件X10 设备已在 Insteon 网络上在使用该动作之前需要满足 Insteon 集成的基础环境调制解调器ModemUSB/串口 PowerLinc Modem如 2413U、2448A7、2413S、2412S已接入 Home Assistant 主机或 Insteon Hub v12242端口 9761/ Hub v22245端口 25105在网络中可达。设备已链接linkedX10 灯具必须已与调制解调器建立链接Home Assistant 才能通过电力线广播命令。设备链接可在 Insteon 配置面板 的Add device功能中完成。家码一致性动作的housecode参数必须与你的 X10 设备实际配置的家码一致命令才会被对应设备接收。在 UI 中调用该动作如果你习惯用可视化方式编排自动化Home Assistant 会逐步引导你完成配置无需编写 YAML进入设置自动化与场景。打开一个现有的自动化或脚本或选择创建自动化创建新自动化。若是新建自动化在When何时部分添加一个触发器脚本不需要触发器它们在被其他自动化调用时运行。在Then do然后执行部分选择添加动作Add action。在搜索框中搜索并选择Insteon: X10 all lights on。选择Housecode家码。点击保存。UI 中的选项选项说明是否必填HousecodeX10 家码取值范围a到p是需要注意的是该动作不支持 targets目标。在 UI 中你不会被要求选择区域、设备、实体或标签——因为命令是按家码广播的而不是定向到某个实体。在 YAML 中调用该动作在 YAML 中动作名为insteon.x10_all_lights_on需要放在action字段中参数放在data下。以最基础的自动化为例automation: - alias: 到家点亮所有 X10 灯 triggers: - trigger: state entity_id: person.zhang_san to: home actions: - action: insteon.x10_all_lights_on data: housecode: a该示例在家庭成员回到家时向家码a下的所有 X10 灯发送All lights on命令。脚本中同样可用script: arrive_home_lights: alias: 到家开灯 sequence: - action: insteon.x10_all_lights_on data: housecode: aYAML 参数参考参数类型必填取值范围说明housecodestring是a到pX10 家码。家码用于区分同一电力线网络中的不同设备分组必须与你 X10 设备上的拨码开关设置一致housecode是唯一参数且为必填项。X10 协议中家码范围是a–p共 16 个若填写范围外的值命令将无法被任何 X10 设备正确识别。三个 X10 广播动作的搭配策略该动作与另外两个 X10 广播动作同属 Insteon 集成详见 release 111 更新日志它们构成一套完整的全屋 X10 控制组合动作作用范围典型场景insteon.x10_all_lights_on某家码下的所有 X10 灯到家时统一开灯insteon.x10_all_lights_off某家码下的所有 X10 灯离家或就寝时统一关灯insteon.x10_all_units_off某家码下的所有 X10 设备不限于灯离家时关闭全部设备包括插座等三者的 YAML 写法与参数完全一致区别仅在于动作名和命令语义# 离家关灯仅灯具 - action: insteon.x10_all_lights_off data: housecode: a # 离家全关灯具 其他 X10 设备 - action: insteon.x10_all_units_off data: housecode: a一个完整的离家自动化可以这样组合automation: - alias: 离家全关 triggers: - trigger: state entity_id: person.zhang_san to: not_home actions: - action: insteon.x10_all_units_off data: housecode: a深入理解广播命令的底层机制从实现机制看insteon.x10_all_lights_on属于 Insteon 集成的调制解调器级命令它不经过 Home Assistant 的实体注册表也不面向具体实体而是由集成将 X10 协议帧经由调制解调器PLM 或 Hub注入电力线网络。X10 设备按家码单元码寻址All lights on这类全局命令只匹配家码因此一条命令即可覆盖该家码下的所有灯具。这正是该动作不支持 targets的根本原因——广播语义天然没有实体目标。从源码结构看Insteon 集成把这类全广播动作与常规实体动作如insteon.add_all_link、insteon.print_all_link_database等见 source/_actions 目录分开组织每个动作对应一个独立文档文件。X10 广播动作家族x10_all_units_off、x10_all_lights_on、x10_all_lights_off在三个文档之间通过 front matter 的related_actions字段互相引用方便用户在文档间跳转对比。常见问题与排障动作无效X10 灯没有反应按以下顺序排查确认housecode与你 X10 设备的拨码设置完全一致a–p不区分大小写。确认 Insteon 集成已正常连接调制解调器/Hub且 X10 设备已与调制解调器链接。在设置工具操作Actions中搜索该动作直接填写字段并点击执行操作Perform action观察实际效果——这是不写 YAML 快速验证的最直接方式。X10 灯没被 Home Assistant 识别为实体这不影响本动作的使用。X10 设备的命令是基于家码广播的即使设备未以实体形式出现在 Home Assistant 中只要硬件层面已正确链接广播命令依然有效。若设备确实未在自动发现autodiscovery中被识别可参考 Insteon 集成文档 中的设备覆盖device override与重新链接指引。仍然卡住描述你调用的动作、housecode取值和预期结果在 Home Assistant 社区Discord 频道、官方论坛或 /r/homeassistant寻求帮助时附上以上信息通常能快速定位问题。小结insteon.x10_all_lights_on是 Insteon 集成中用于按家码批量开灯的广播动作UI 侧只需选择 HousecodeYAML 侧只需一个必填的housecode参数a–p。配合insteon.x10_all_lights_off与insteon.x10_all_units_off可以在一两个动作内完成全屋 X10 设备的统一开/关是到家/离家自动化的高效积木。【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考