Home Assistant ISY994 节点命令操作指南使用 isy994.send_node_command 实现 Beep、调光与快速开关【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io导读isy994.send_node_command是 Home Assistant 中 Universal Devices ISY/IoX 集成domainisy994提供的一个核心操作action它允许你直接向 ISY 控制器上的任意节点发送命令从而调用 Home Assistant 实体界面中未直接暴露的设备能力——例如让 Insteon 设备发出哔声beep、对灯光执行淡入淡出fade或快速开关fast on/off。读完本文你将掌握该操作的完整参数语义、UI 与 YAML 两种使用方式、目标target选择机制以及它与isy994.send_raw_node_command、isy994.send_program_command等兄弟操作的边界与配合方法。操作概览与适用场景该操作的官方定义是Sends a command to an ISY node using its Home Assistant entity使用 Home Assistant 实体向 ISY 节点发送命令定义见 source/_actions/isy994.send_node_command.markdown。它属于isy994集成该集成支持 ISY994 硬件家族以及当前 ISY-on-AnythingIoX硬件如 eisy、Polisy并通过 Local Push 方式通信相关平台包括 binary_sensor、button、climate、cover、fan、light、lock、number、select、sensor、switch 等见 source/_integrations/isy994.markdown。典型场景让设备发出提示音对支持 Beep 的 Insteon 设备发送beep可用于门磁触发、寻物提醒等自动化灯光淡入淡出发送fade_up/fade_down/fade_stop实现类似 ISY 场景中的渐变效果快速开关发送fast_on/fast_off相当于物理设备上双击按键的Fast On/Off行为对应的底层控制事件即DFON/DFOF节点启用/禁用与查询enable/disable控制节点是否响应命令query主动刷新节点状态。该操作在 2025.3 版本的核心变更日志中也有记录source/changelogs/core-2025.3.markdown说明其文档与实现一直处于维护状态。通过用户界面UI使用该操作与 Home Assistant 其他操作一样支持可视化编排无需编写 YAML参见 source/_includes/actions/ui_header.md。在自动化或脚本中使用步骤如下进入设置 自动化与场景{% my automations %}快捷链接打开现有自动化或脚本或选择创建自动化 创建新自动化若是新建自动化需在When触发条件部分添加触发器脚本Script不需要触发器它们由其他流程调用时才执行在Then do执行动作部分选择添加动作Add action选择要控制的设备。在目标By target下详见下文目标选择选择 ISY 实体也可以选择一个区域area、设备device或标签label从该目标可用的动作中选择ISY: Send node commandISY发送节点命令在命令Command字段中选择要发送的命令点击保存。UI 中的选项选项说明Command要发送给节点的命令取值为beep、brighten、dim、disable、enable、fade_down、fade_stop、fade_up、fast_off、fast_on、query之一通过 YAML 使用在 YAML 中该操作以isy994.send_node_command引用参见 source/_includes/actions/yaml_header.md。以下是一个基本示例action: isy994.send_node_command target: entity_id: light.front_porch data: command: fast_on上述配置向light.front_porch节点发送fast_on命令即快速开启灯光。YAML 参数表参数必填类型说明command是string要发送给节点的命令。取值beep、brighten、dim、disable、enable、fade_down、fade_stop、fade_up、fast_off、fast_on、query参数定义见 source/_actions/isy994.send_node_command.markdown 中的 options_yaml 块command为必填字符串其余无需其他参数。目标选择机制Targets该操作必须指定目标target。目标是动作的作用对象你可以将动作指向单个实体、设备、区域、楼层或标签Home Assistant 会对该目标背后每一个匹配的 ISY 实体执行该操作。目标类型行为实体Entity单个特定 ISY 实体如light.front_porch设备Device属于某设备的所有 ISY 实体区域Area某个房间/区域中的所有 ISY 实体楼层Floor某个楼层中的所有 ISY 实体标签Label共享同一标签的所有 ISY 实体你还可以在同一次动作中混合多种目标类型例如同时添加一个具体实体和一个区域作为目标让动作一次性作用于两者。需要特别注意的是与isy994.send_program_command通过地址或名称识别 ISY 程序、不支持目标不同send_node_command面向的是实体化后的节点因此必须以目标方式指定操作对象而send_program_command则直接用address/name定位程序见 source/_actions/isy994.send_program_command.markdown。命令语义与底层映射理解每个命令背后的 ISY 控制事件有助于判断何时使用该操作。在 ISY 的 REST/控制协议中常见控制类型control type包括依据 source/_integrations/isy994.markdown 中关于isy994_control事件的说明DON开On 按钮DOF关Off 按钮DFON快速开通常来自双击 On 按钮DFOF快速关通常来自双击 Off 按钮FDUP淡入按住 On 按钮时FDDOWN淡出按住 Off 按钮时FDSTOP停止淡入淡出松开长按按钮时BRT变亮控制器发出的单次微调变亮指令DIM变暗控制器发出的单次微调变暗指令。可以看到isy994.send_node_command的 11 个命令取值beep、brighten、dim、disable、enable、fade_down、fade_stop、fade_up、fast_off、fast_on、query与这些控制类型高度对应但它是经过 Home Assistant 抽象后的友好命令由集成负责翻译并下发给 ISY 节点因此无需你记忆原始控制码。与 send_raw_node_command 的分工如果你需要发送上述抽象命令之外、尚未被 Home Assistant 完整支持的 ISY REST 命令例如许多 NodeServer 节点的控制指令如DON/DOF则应改用isy994.send_raw_node_command。该操作直接以字符串形式下发原始 ISY REST 命令并额外支持value0–255 的整数值、parameters查询字符串参数字典可用于控制彩色灯泡等标准实体控件未暴露的参数和unit_of_measurement0–120 的 ISY 计量单位定义见 source/_actions/isy994.send_raw_node_command.markdown。# 对比raw 方式直接发送底层命令 action: isy994.send_raw_node_command target: entity_id: light.front_porch data: command: DON经验法则能在 UI 命令下拉框中找到的命令用send_node_command需要直接发送 REST 原语或自定义参数时用send_raw_node_command控制 ISY 程序/文件夹运行、停止、启用、禁用、设置开机自启等时用send_program_command。实战示例示例 1门磁触发时让灯光快速闪烁automation: - alias: Front door opened - fast flash porch light triggers: - trigger: state entity_id: binary_sensor.front_door to: on actions: - action: isy994.send_node_command target: entity_id: light.front_porch data: command: fast_on - delay: 00:00:01 - action: isy994.send_node_command target: entity_id: light.front_porch data: command: fast_off示例 2使用标签批量控制多个 ISY 节点script: porch_lights_off: alias: Turn off all porch lights sequence: - action: isy994.send_node_command target: label: porch_lights data: command: fade_down示例 3混合目标同时控制单个实体与整个区域action: isy994.send_node_command target: entity_id: light.kitchen_pendant area_id: living_room data: command: query示例 4向 Insteon 设备发送 Beep 提示音配合 isy994_control 事件ISY 集成会在设备网络产生控制事件时发出isy994_control事件前提是该设备未被忽略或禁用。下面先触发一个双击事件再让另一个设备发出提示音automation: - alias: Beep hallway device on double tap triggers: - trigger: event event_type: isy994_control event_data: entity_id: light.lr_track_lights_front control: DFON actions: - action: isy994.send_node_command target: entity_id: switch.hallway_beep data: command: beep上述isy994_control事件结构entity_id、control、value、formatted、uom、prec以及常见控制类型说明可参考 source/_integrations/isy994.markdown。使用提示与注意事项节点能力决定命令有效性并非所有节点都支持全部 11 种命令。例如只有支持亮度调节的灯光节点才会对fade_up/fade_down有意义不支持 beep 的设备会忽略该命令。请结合 ISY Admin Console 中节点的实际能力使用。目标解析send_node_command依赖目标实体/设备/区域/楼层/标签当目标背后有多个 ISY 实体时Home Assistant 会对每个匹配实体各执行一次命令因此批量操作时无需逐个写动作。原始命令需求如需DON/DOF等原始 ISY REST 命令或需要附带value/parameters/unit_of_measurement请改用 isy994.send_raw_node_command如需控制 ISY 程序run/stop/enable等请改用 isy994.send_program_command如需重命名节点或场景可使用 isy994.rename_node。自定义设备背景ISY 允许通过HA.*文件夹如HA.switch、HA.light在控制器上创建自定义设备并映射为 Home Assistant 实体详见 source/_integrations/isy994.markdown这些自定义设备的节点同样可以作为send_node_command的目标使用。在 UI 中快速体验你可以在自动化/脚本编辑器中通过动作界面试运行该操作Try itHome Assistant 会给出即时反馈便于验证命令是否被节点接受。小结isy994.send_node_command是打通 Home Assistant 自动化与 ISY 节点原生能力的关键桥梁它以 11 个语义清晰的命令覆盖了提示音、调光、快速开关、启停与查询等高频需求并通过实体/设备/区域/楼层/标签五类目标实现灵活批量控制。配合send_raw_node_command底层 REST 原语与send_program_command程序级控制你可以完整接管 ISY 控制器的节点级与程序级操作无需再依赖 ISY Admin Console 手工干预。【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Home Assistant ISY994 节点命令操作指南：使用 isy994.send_node_command 实现 Beep、调光与快速开关
Home Assistant ISY994 节点命令操作指南使用 isy994.send_node_command 实现 Beep、调光与快速开关【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io导读isy994.send_node_command是 Home Assistant 中 Universal Devices ISY/IoX 集成domainisy994提供的一个核心操作action它允许你直接向 ISY 控制器上的任意节点发送命令从而调用 Home Assistant 实体界面中未直接暴露的设备能力——例如让 Insteon 设备发出哔声beep、对灯光执行淡入淡出fade或快速开关fast on/off。读完本文你将掌握该操作的完整参数语义、UI 与 YAML 两种使用方式、目标target选择机制以及它与isy994.send_raw_node_command、isy994.send_program_command等兄弟操作的边界与配合方法。操作概览与适用场景该操作的官方定义是Sends a command to an ISY node using its Home Assistant entity使用 Home Assistant 实体向 ISY 节点发送命令定义见 source/_actions/isy994.send_node_command.markdown。它属于isy994集成该集成支持 ISY994 硬件家族以及当前 ISY-on-AnythingIoX硬件如 eisy、Polisy并通过 Local Push 方式通信相关平台包括 binary_sensor、button、climate、cover、fan、light、lock、number、select、sensor、switch 等见 source/_integrations/isy994.markdown。典型场景让设备发出提示音对支持 Beep 的 Insteon 设备发送beep可用于门磁触发、寻物提醒等自动化灯光淡入淡出发送fade_up/fade_down/fade_stop实现类似 ISY 场景中的渐变效果快速开关发送fast_on/fast_off相当于物理设备上双击按键的Fast On/Off行为对应的底层控制事件即DFON/DFOF节点启用/禁用与查询enable/disable控制节点是否响应命令query主动刷新节点状态。该操作在 2025.3 版本的核心变更日志中也有记录source/changelogs/core-2025.3.markdown说明其文档与实现一直处于维护状态。通过用户界面UI使用该操作与 Home Assistant 其他操作一样支持可视化编排无需编写 YAML参见 source/_includes/actions/ui_header.md。在自动化或脚本中使用步骤如下进入设置 自动化与场景{% my automations %}快捷链接打开现有自动化或脚本或选择创建自动化 创建新自动化若是新建自动化需在When触发条件部分添加触发器脚本Script不需要触发器它们由其他流程调用时才执行在Then do执行动作部分选择添加动作Add action选择要控制的设备。在目标By target下详见下文目标选择选择 ISY 实体也可以选择一个区域area、设备device或标签label从该目标可用的动作中选择ISY: Send node commandISY发送节点命令在命令Command字段中选择要发送的命令点击保存。UI 中的选项选项说明Command要发送给节点的命令取值为beep、brighten、dim、disable、enable、fade_down、fade_stop、fade_up、fast_off、fast_on、query之一通过 YAML 使用在 YAML 中该操作以isy994.send_node_command引用参见 source/_includes/actions/yaml_header.md。以下是一个基本示例action: isy994.send_node_command target: entity_id: light.front_porch data: command: fast_on上述配置向light.front_porch节点发送fast_on命令即快速开启灯光。YAML 参数表参数必填类型说明command是string要发送给节点的命令。取值beep、brighten、dim、disable、enable、fade_down、fade_stop、fade_up、fast_off、fast_on、query参数定义见 source/_actions/isy994.send_node_command.markdown 中的 options_yaml 块command为必填字符串其余无需其他参数。目标选择机制Targets该操作必须指定目标target。目标是动作的作用对象你可以将动作指向单个实体、设备、区域、楼层或标签Home Assistant 会对该目标背后每一个匹配的 ISY 实体执行该操作。目标类型行为实体Entity单个特定 ISY 实体如light.front_porch设备Device属于某设备的所有 ISY 实体区域Area某个房间/区域中的所有 ISY 实体楼层Floor某个楼层中的所有 ISY 实体标签Label共享同一标签的所有 ISY 实体你还可以在同一次动作中混合多种目标类型例如同时添加一个具体实体和一个区域作为目标让动作一次性作用于两者。需要特别注意的是与isy994.send_program_command通过地址或名称识别 ISY 程序、不支持目标不同send_node_command面向的是实体化后的节点因此必须以目标方式指定操作对象而send_program_command则直接用address/name定位程序见 source/_actions/isy994.send_program_command.markdown。命令语义与底层映射理解每个命令背后的 ISY 控制事件有助于判断何时使用该操作。在 ISY 的 REST/控制协议中常见控制类型control type包括依据 source/_integrations/isy994.markdown 中关于isy994_control事件的说明DON开On 按钮DOF关Off 按钮DFON快速开通常来自双击 On 按钮DFOF快速关通常来自双击 Off 按钮FDUP淡入按住 On 按钮时FDDOWN淡出按住 Off 按钮时FDSTOP停止淡入淡出松开长按按钮时BRT变亮控制器发出的单次微调变亮指令DIM变暗控制器发出的单次微调变暗指令。可以看到isy994.send_node_command的 11 个命令取值beep、brighten、dim、disable、enable、fade_down、fade_stop、fade_up、fast_off、fast_on、query与这些控制类型高度对应但它是经过 Home Assistant 抽象后的友好命令由集成负责翻译并下发给 ISY 节点因此无需你记忆原始控制码。与 send_raw_node_command 的分工如果你需要发送上述抽象命令之外、尚未被 Home Assistant 完整支持的 ISY REST 命令例如许多 NodeServer 节点的控制指令如DON/DOF则应改用isy994.send_raw_node_command。该操作直接以字符串形式下发原始 ISY REST 命令并额外支持value0–255 的整数值、parameters查询字符串参数字典可用于控制彩色灯泡等标准实体控件未暴露的参数和unit_of_measurement0–120 的 ISY 计量单位定义见 source/_actions/isy994.send_raw_node_command.markdown。# 对比raw 方式直接发送底层命令 action: isy994.send_raw_node_command target: entity_id: light.front_porch data: command: DON经验法则能在 UI 命令下拉框中找到的命令用send_node_command需要直接发送 REST 原语或自定义参数时用send_raw_node_command控制 ISY 程序/文件夹运行、停止、启用、禁用、设置开机自启等时用send_program_command。实战示例示例 1门磁触发时让灯光快速闪烁automation: - alias: Front door opened - fast flash porch light triggers: - trigger: state entity_id: binary_sensor.front_door to: on actions: - action: isy994.send_node_command target: entity_id: light.front_porch data: command: fast_on - delay: 00:00:01 - action: isy994.send_node_command target: entity_id: light.front_porch data: command: fast_off示例 2使用标签批量控制多个 ISY 节点script: porch_lights_off: alias: Turn off all porch lights sequence: - action: isy994.send_node_command target: label: porch_lights data: command: fade_down示例 3混合目标同时控制单个实体与整个区域action: isy994.send_node_command target: entity_id: light.kitchen_pendant area_id: living_room data: command: query示例 4向 Insteon 设备发送 Beep 提示音配合 isy994_control 事件ISY 集成会在设备网络产生控制事件时发出isy994_control事件前提是该设备未被忽略或禁用。下面先触发一个双击事件再让另一个设备发出提示音automation: - alias: Beep hallway device on double tap triggers: - trigger: event event_type: isy994_control event_data: entity_id: light.lr_track_lights_front control: DFON actions: - action: isy994.send_node_command target: entity_id: switch.hallway_beep data: command: beep上述isy994_control事件结构entity_id、control、value、formatted、uom、prec以及常见控制类型说明可参考 source/_integrations/isy994.markdown。使用提示与注意事项节点能力决定命令有效性并非所有节点都支持全部 11 种命令。例如只有支持亮度调节的灯光节点才会对fade_up/fade_down有意义不支持 beep 的设备会忽略该命令。请结合 ISY Admin Console 中节点的实际能力使用。目标解析send_node_command依赖目标实体/设备/区域/楼层/标签当目标背后有多个 ISY 实体时Home Assistant 会对每个匹配实体各执行一次命令因此批量操作时无需逐个写动作。原始命令需求如需DON/DOF等原始 ISY REST 命令或需要附带value/parameters/unit_of_measurement请改用 isy994.send_raw_node_command如需控制 ISY 程序run/stop/enable等请改用 isy994.send_program_command如需重命名节点或场景可使用 isy994.rename_node。自定义设备背景ISY 允许通过HA.*文件夹如HA.switch、HA.light在控制器上创建自定义设备并映射为 Home Assistant 实体详见 source/_integrations/isy994.markdown这些自定义设备的节点同样可以作为send_node_command的目标使用。在 UI 中快速体验你可以在自动化/脚本编辑器中通过动作界面试运行该操作Try itHome Assistant 会给出即时反馈便于验证命令是否被节点接受。小结isy994.send_node_command是打通 Home Assistant 自动化与 ISY 节点原生能力的关键桥梁它以 11 个语义清晰的命令覆盖了提示音、调光、快速开关、启停与查询等高频需求并通过实体/设备/区域/楼层/标签五类目标实现灵活批量控制。配合send_raw_node_command底层 REST 原语与send_program_command程序级控制你可以完整接管 ISY 控制器的节点级与程序级操作无需再依赖 ISY Admin Console 手工干预。【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考