首页
/ 小米智能无线开关在Home Assistant中的配置与自动化实现

小米智能无线开关在Home Assistant中的配置与自动化实现

2025-05-11 20:16:37作者:胡唯隽

设备特性分析

小米智能无线开关(双键版)是一款常见的智能家居控制设备,通过蓝牙协议与网关连接。该设备具有以下操作模式:

  1. 左键操作(按键类型1)
  2. 右键操作(按键类型2)
  3. 双键同时操作(按键类型3)

在Home Assistant中,设备会生成三个对应的事件实体,分别代表不同的触发方式:单击、双击和长按。值得注意的是,在极速模式下,设备仅支持单击操作,不支持双击和长按功能。

实体状态解析

当设备接入Home Assistant后,系统会创建以下类型的实体:

  • event.yeelink_cn_blt_3_[设备ID]_contrl_click_e_3_1012:代表单击事件
  • 其他类似命名的实体代表双击和长按事件

每个实体的状态变化会携带属性信息,其中button属性特别重要:

  • button: 1 表示左键操作
  • button: 2 表示右键操作
  • button: 3 表示双键同时操作

自动化配置要点

基础配置方法

  1. 使用状态触发器(state trigger)监听实体状态变化
  2. 必须添加not_from: unavailablenot_to: unavailable条件,避免设备未就绪时误触发
  3. 通过条件判断button属性值来确定具体是哪个按键被操作

YAML配置示例

automation:
  - alias: "左键单击控制"
    trigger:
      - platform: state
        entity_id: event.yeelink_cn_blt_3_[设备ID]_contrl_click_e_3_1012
        not_from: unavailable
        not_to: unavailable
    condition:
      - condition: template
        value_template: "{{ state_attr(trigger.entity_id, 'button') == 1 }}"
    action:
      - service: light.toggle
        target:
          entity_id: light.[你的灯ID]

图形界面配置技巧

在Home Assistant的自动化图形界面中配置时需注意:

  1. 触发器类型选择"状态"
  2. 实体选择对应的事件实体
  3. 在YAML编辑器中添加not_fromnot_to条件
  4. 添加模板条件判断button属性值

常见问题解决

  1. 自动化不触发:检查设备是否处于极速模式,该模式下仅支持单击
  2. 状态显示未知:确认设备是否正常连接,蓝牙信号是否稳定
  3. 按键识别错误:检查条件判断中的button值是否正确,数字不应加引号

高级应用建议

  1. 可以结合多个条件实现复杂逻辑,如区分单击、双击和长按
  2. 考虑添加防误触逻辑,如时间间隔判断
  3. 对于重要操作,建议添加确认步骤或二次验证

通过以上配置,用户可以充分利用小米智能无线开关的双键功能,在Home Assistant中实现灵活多样的自动化控制场景。

登录后查看全文
热门项目推荐
相关项目推荐