ARTICLE DETAIL

资讯详情

深耕网站视觉设计与运营推广的一线实战洞察。

Home Assistant 小米 IR 遥控器操作:用 xiaomi_miio.remote_set_led_on 开启蓝色状态 LED

Home Assistant 小米 IR 遥控器操作:用 xiaomi_miio.remote_set_led_on 开启蓝色状态 LED Home Assistant 小米 IR 遥控器操作用 xiaomi_miio.remote_set_led_on 开启蓝色状态 LED【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io导读xiaomi_miio.remote_set_led_on是 Home Assistant 中xiaomi_miio集成提供的一个面向小米红外遥控器的操作action用于点亮遥控器上的蓝色状态 LED。本篇指南以仓库文档 source/_actions/xiaomi_miio.remote_set_led_on.markdown 为主体结合xiaomi_miio集成的 IR Remote 平台文档讲解该操作的触发场景、UI 与 YAML 两种配置方式、目标Target选择机制以及它与 LED 关闭、命令学习等关联操作的配合用法。读完本文你将能在自动化或脚本中精确控制小米 IR 遥控器的 LED 指示灯并理解其与 IR 命令学习流程之间的协同关系。操作定义它做了什么根据 source/_actions/xiaomi_miio.remote_set_led_on.markdown 的说明Remote set LED on操作的作用是Turns on the blue status LED of a Xiaomi IR remote.即打开小米 IR 遥控器如米家万能遥控器上的蓝色状态指示灯。与之对应的关闭操作是xiaomi_miio.remote_set_led_off文档元数据中也将这两个操作列为互相关联的操作。典型使用场景从该操作与关联操作的设计关系可以推断蓝色 LED 主要承担设备状态指示功能常见的使用场景包括学习命令时的视觉反馈使用 xiaomi_miio.remote_learn_command 让遥控器进入学习模式前先点亮 LED 以便确认设备处于工作/学习状态。夜间静默在入睡时段自动关闭 LED避免指示灯的光线干扰。连接与存活验证手动或定时点亮 LED快速确认遥控器与 Home Assistant 之间的网络通信正常。作为自动化状态的可视化指示例如门被打开时点亮 LED作为无需额外硬件的提示信号。注意文档并未声明该 LED 一定与学习模式绑定以上场景属于合理推断实际行为以你的设备型号为准。在用户界面中使用该操作如果偏好可视化配置Home Assistant 的自动化编辑器会引导你一步步完成操作设置无需编写 YAML。仓库文档给出了如下操作路径进入设置 自动化与场景Settings Automations scenes。打开一个现有的自动化或脚本也可以选择创建自动化 创建新自动化。如果是新建自动化在何时When部分添加一个触发器。脚本不需要触发器它们由其他流程显式调用。在然后执行Then do部分选择添加操作Add action。选择要控制的对象在按目标By target下详见下文 目标Targets 一节选择你要控制的小米 IR 遥控器。在针对该目标显示的操作列表中选择Remote set LED on。点击保存Save。在 YAML 中使用该操作若直接编写 YAML操作名固定为xiaomi_miio.remote_set_led_on。仓库文档给出的基础示例如下action: xiaomi_miio.remote_set_led_on target: entity_id: remote.xiaomi_miio_remote这段配置会点亮remote.xiaomi_miio_remote这个遥控器实体的蓝色 LED。实体 ID 中的remote.前缀表明该实体属于remote遥控器领域。常见调用形式在自动化触发器中调用alias: 点亮客厅遥控器 LED triggers: - trigger: state entity_id: binary_sensor.front_door to: on actions: - action: xiaomi_miio.remote_set_led_on target: entity_id: remote.living_room_remote在脚本中调用sequence: - action: xiaomi_miio.remote_set_led_on target: device_id: 3f2b1c5e9a8d4f7btarget支持使用实体 ID 或设备 ID具体取决于你的配置习惯。用 YAML 成对控制 LED由于该操作只负责点亮若要实现开/关联动可与关闭操作配合使用sequence: - action: xiaomi_miio.remote_set_led_on target: entity_id: remote.xiaomi_miio_remote - delay: 00:00:05 - action: xiaomi_miio.remote_set_led_off target: entity_id: remote.xiaomi_miio_remote目标Targets该操作必须指定目标。根据仓库文档 source/_includes/actions/targets.md 的说明目标就是操作的作用对象Home Assistant 会对目标背后的每一个匹配remote领域实体执行操作。支持以下目标类型实体Entity某一个具体的remote实体例如remote.living_room。设备Device某个设备下隶属的全部remote实体。区域Area某个房间/区域内全部的remote实体。楼层Floor某个楼层上全部的remote实体。标签Label共享某个标签的全部remote实体。你还可以在一次操作中组合不同类型的目标例如同时指定一个实体和一个区域让操作一次性作用于两者。这一机制意味着你可以用一个操作统一控制家里所有小米 IR 遥控器的 LED例如在离家场景中全部熄灭、在回家场景中全部点亮。关联操作与命令学习流程该操作的文档元数据声明了两个关联操作related_actions关联操作作用xiaomi_miio.remote_set_led_off关闭小米 IR 遥控器的蓝色 LED见 xiaomi_miio.remote_set_led_off.markdownxiaomi_miio.remote_learn_command让遥控器进入学习模式录制红外命令见 xiaomi_miio.remote_learn_command.markdown其中remote_learn_command与本文主题关系最为紧密学习命令时你可以用remote_set_led_on先点亮 LED 确认设备就绪然后执行学习操作。学习操作支持两个可选参数slot存储槽位保存学习到的 IR 命令的槽位类型为整数默认值 1。timeout超时等待学习命令的最长秒数超过后放弃类型为整数默认值 10 秒。YAML 示例action: xiaomi_miio.remote_learn_command target: entity_id: remote.xiaomi_miio_remote data: slot: 1 timeout: 30学习完成后Home Assistant 会以通知形式在概览Overview中显示学习到的命令可直接复制进你的配置。深入xiaomi_miio 集成的 IR Remote 平台要使用上述操作前提是已经通过xiaomi_miio集成配置好小米 IR 遥控器。仓库中的集成文档 source/_integrations/xiaomi_miio.markdown 对 IR Remote 平台给出了完整配置说明remote: - platform: xiaomi_miio name: bathroom remote host: 192.168.42.42 token: YOUR_TOKEN slot: 1 timeout: 30 commands: activate_towel_heater: command: - raw:base64:[optional_frequency] read_bad_poem: command: - raw:base64:[optional_frequency] - pronto:pronto_hex:[optional_repeat]配置参数说明来自集成文档参数必填类型默认值说明host是string-遥控器的 IP 地址token是string-遥控器的 API Tokenname否string-遥控器的名称slot否integer1保存学习命令所用的槽位timeout否integer30学习新命令的超时时间秒commands否map-命令列表每条命令由command键定义集成平台支持两种 IR 命令格式Raw原始命令通过xiaomi_miio.remote_learn_command操作学习得到格式为raw:base64可附带可选的频率参数例如raw:Z6UFANEAAAAjAQAAAwkAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAQIAE:38400。Pronto Hex Code设备厂商通常提供的十六进制码格式为pronto:pronto_hex可附带可选的重发次数。可以看到本文核心操作xiaomi_miio.remote_set_led_on并不依赖这些命令配置它只负责 LED 的开关但了解整个平台配置有助于你将 LED 状态与命令学习、发送流程整体打通。试运行与排障仓库文档还提供了先试后写的建议打开设置 工具 操作Settings Tools Actions搜索该操作填入字段并点击执行操作Perform action即可在不编写任何 YAML 的情况下看到真实实体上的效果。这是验证目标实体 ID 是否正确、设备是否在线的最快方式。常见排查思路实体 ID 错误确认target中填写的实体确实属于remote领域且由 xiaomi_miio 平台创建可以在设置 设备与服务中查看实际实体 ID。设备离线LED 无法点亮时先确认遥控器与 Home Assistant 的网络连通性以及 Token 是否有效。效果不直观LED 状态变化属于硬件层面的短暂动作若在操作日志中看到成功但无法确认灯亮可考虑配合remote_set_led_off做一次开/关循环来验证。小结xiaomi_miio.remote_set_led_on是 Home Assistant 对小米 IR 遥控器硬件状态控制的一个小而实用的操作通过一行 YAML 或几步 UI 操作即可点亮遥控器的蓝色 LED。把它与 xiaomi_miio.remote_set_led_off、xiaomi_miio.remote_learn_command 以及 xiaomi_miio 集成 的 IR Remote 平台配置结合起来就能实现 LED 指示、红外命令学习与发送的完整闭环控制。【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表