Home Assistant Insteon Add All-Link 动作实战手动建立调制解调器与设备的 All-Link 链接【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io本文基于 insteon.add_all_link 动作文档 并结合 Insteon 集成文档系统讲解如何让 Insteon 调制解调器IM即 PLM 或 Hub进入 All-Linking 模式从而手动将设备以控制器或响应者身份接入 All-Link 网络。读完本文你将掌握该动作在 UI 与 YAML 两种形态下的完整用法、Group 与 Mode 两个核心参数的语义以及它与insteon.delete_all_link、insteon.add_default_links等关联动作的协作方式可用于扩展、修复或清理 Insteon 设备间的链接关系。一、All-Link 与 All-Linking 模式是什么在 Insteon 网络中任意两台设备想要互相通信都必须先在各自的All-Link DatabaseALDB中建立一条指向对方的链接记录。ALDB 保存的是该设备与网络内其他设备之间的链接清单它是 Insteon 组网机制的核心数据结构相关管理功能可在 Insteon 集成文档的“Device All-Link Database”一节中找到详细说明见 source/_integrations/insteon.markdown。Add All-Link动作做的事情就是让 Insteon ModemIM进入All-Linking 模式以便你把某个设备链接到它身上。在这一过程中调制解调器既可以作为controller控制器也可以作为responder响应者被链接。这一动作典型的应用场景是手动在调制解调器与设备之间构建一条 All-Link 链接例如用来扩展或修复让 Insteon 设备相互通信的既有链接。当设备响应异常、链接记录缺失或你想重新整理网络拓扑时手动走一遍 All-Linking 流程往往是恢复通信最直接的手段。二、动作触发前的准备在调用本动作之前需要先确认 Insteon 集成已正确接入Hub 或 PLM 已配置具体前置条件如下出自 source/_integrations/insteon.markdownPLM 调制解调器如 2413U、2412U或串口版 2413S/2412S必须已插入 Home Assistant 宿主机并能确认串口路径Linux 下通常是/dev/ttyUSB0可在Settings System Hardware的System hardware中查看。Hub 版本 122422014 年前或 Hub 版本 22245Hub 需在网络上可达并建议在路由器上为其保留固定 IP。Hub v1 使用端口 9761Hub v2 使用端口 25105。Hub v2 凭证用户名和密码印在 Hub 底部标签上。Insteon 设备必须已链接到调制解调器才会出现在 Home Assistant 中——既可以在之前的控制器配置中完成也可以在接入后在 Insteon 配置面板中通过Add device功能补充链接。需要强调的是本动作属于“手动补链”工具它把调制解调器置入 All-Linking 模式后仍需你在物理设备上完成剩下的链接确认动作详见下一节链接才会真正建立。三、在 UI 中执行 Add All-Link 动作按照动作文档source/_actions/insteon.add_all_link.markdown你可以从自动化或脚本中启动 All-Linking 模式进入SettingsAutomations scenes自动化与场景。打开一个已有的自动化或脚本或选择Create automationCreate new automation新建。如果是新建自动化在When何时区域添加一个触发器脚本则不需要触发器——它们在被其他对象调用时才运行。在Then do然后执行区域选择Add action添加动作。在搜索框中搜索并选择Insteon: Add All-Link。填写Group组编号并选择Mode模式。点击Save保存。动作启动之后需要到设备侧完成链接收尾这是 All-Linking 协议的手动握手环节动作文档原文明确说明如果调制解调器作为controller控制器先把调制解调器置于链接模式然后按下设备上的SET按钮如果调制解调器作为responder响应者先按下设备上的SET按钮然后把调制解调器置于链接模式。也就是说物理设备上 SET 按钮的按压时机取决于你选择的 Mode。UI 中的选项选项说明是否必填GroupAll-Link 组编号必填ModeInsteon 调制解调器的链接模式取值为controller或responder必填动作不支持 targets在 UI 中不会提示你选择区域、设备、实体或标签。此外只有具备管理员权限的用户才能运行该动作。四、在 YAML 中使用 Add All-Link 动作在 YAML 配置中该动作以insteon.add_all_link引用。文档给出的基础示例如下source/_actions/insteon.add_all_link.markdownaction: insteon.add_all_link data: group: 1 mode: controller这段配置的作用是让调制解调器以controller身份进入组 1 的 All-Linking 模式。执行后仍需按上一节的流程在设备上按下 SET 按钮完成链接。YAML 中的选项参数说明必填类型groupAll-Link 组编号是integermodeInsteon 调制解调器的链接模式设为controller或responder是string从配置结构可以看出group是整数类型对应 Insteon 网络中的组/场景编号mode是字符串类型只能取controller与responder两个值二者决定了调制解调器在链接关系中的角色也决定了设备端 SET 按钮的操作顺序。在自动化中的完整示例将上述 YAML 嵌入一个真实的自动化场景例如在按下某个实体按钮后让调制解调器以控制器身份进入组 1 的链接模式automation: - alias: Put Insteon modem into All-Linking mode for group 1 triggers: - trigger: state entity_id: input_boolean.start_all_linking to: on actions: - action: insteon.add_all_link data: group: 1 mode: controller - action: input_boolean.turn_off target: entity_id: input_boolean.start_all_linking执行后到目标设备上按下 SET 按钮即可完成本次手动链接。五、与其他 Insteon 动作的配合insteon.add_all_link并不是孤立存在的它和另外两个 All-Link 相关动作构成一组完整的手动链路管理工具insteon.delete_all_link告诉 Insteon Modem 从自身的 ALDB 和设备上移除一条 All-Link 记录适合拆除不再需要的链接或清理废弃设备。它只接受group一个必填参数动作启动后同样需要按下对应设备上的 SET 按钮来完成。示例action: insteon.delete_all_link data: group: 1insteon.add_default_links在设备与 Insteon Modem 之间补回一组默认链接。当设备响应异常、需要恢复与调制解调器之间的标准通信链路时使用它接受entity_id一个必填参数。示例action: insteon.add_default_links data: entity_id: light.1a2b3c这三个动作的定位差异很清晰add_all_link负责手动按需建链add_default_links负责批量恢复标准链路delete_all_link负责拆链。三者均不支持 targets且都仅限管理员执行。此外若你需要在自动化中直接控制已经建好的 Insteon 场景可以使用insteon.scene_on与insteon.scene_off两个动作Insteon 集成文档“Controlling Insteon scenes”一节对此有说明见 source/_integrations/insteon.markdown它们接收 Insteon 组或场景编号。六、注意事项与故障排除操作顺序务必与 Mode 对应Mode 选controller时先启动调制解调器再按设备 SET 键选responder时先按设备 SET 键再启动调制解调器。顺序颠倒会导致链接建立失败。管理员权限与insteon.delete_all_link、insteon.add_default_links一致本动作仅对管理员开放普通用户调用会被拒绝。不支持 targets不要在自动化中为该动作配置targetUI 与 YAML 均不接受区域、设备、实体或标签选择。ALDB 编辑有风险Insteon 集成文档明确警告编辑设备 ALDB 可能使设备失去响应如果发生这种情况只需按 “Add device” 的指引重新将设备链接到调制解调器即可见 source/_integrations/insteon.markdown。集成移除不会清空网络链接移除 Insteon 集成不会改变 Insteon 网络本身设备仍保持彼此链接若要退役调制解调器应先使用 Insteon 面板的Delete device逐个清理设备见 source/_integrations/insteon.markdown。七、小结insteon.add_all_link是 Insteon 网络手动组网的核心动作之一它把调制解调器送入 All-Linking 模式配合设备上的 SET 按钮完成控制器/响应者角色下的物理握手从而建立或修复调制解调器与设备之间的链接。通过本文你已掌握其在 UI 与 YAML 中的完整配置方式、group与mode两个关键参数的语义以及与insteon.delete_all_link、insteon.add_default_links的动作分工结合 Insteon 集成文档 中关于 ALDB、自动发现与配置面板的说明即可独立完成 Insteon 网络的链路搭建与排障。【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考