hcpy项目中的设备本地控制状态机制解析

最新推荐文章于 2025-06-09 09:01:08 发布

原创最新推荐文章于 2025-06-09 09:01:08 发布 · 422 阅读

CC 4.0 BY-SA版权

hcpy项目中的设备本地控制状态机制解析

hcpy Python tool to talk to Home Connect appliances over the local network (no cloud required) 项目地址: https://gitcode.com/gh_mirrors/hcp/hcpy

概述

在hcpy项目支持的智能家居设备中，特别是Neff品牌的抽油烟机设备，存在一个特殊的本地控制状态机制。当用户通过物理按钮操作设备时，设备会进入一个约15秒的"本地控制激活"状态，在此期间远程控制命令将被拒绝。这一机制对自动化流程的实现提出了特殊要求。

技术细节分析

本地控制状态标识

设备在本地操作时会发送包含以下关键字段的状态更新：

{
  "LocalControlActive": true,
  "ActiveProgram": 55307,
  "VentingLevel": 0,
  "IntensiveLevel": 0,
  "ElapsedProgramTime": 18
}

其中LocalControlActive字段为true表示设备正处于本地控制状态。此时：

官方应用程序会显示"本地操作处于活动状态"的提示
应用程序中的控制按钮会变为灰色不可用状态
通过API发送的远程控制命令会返回403错误

设备差异性

值得注意的是，这一机制在不同设备上表现不同：

抽油烟机设备普遍存在此机制
洗碗机和烹饪处理器等设备通常没有此限制
不同品牌设备的具体实现可能略有差异

对自动化系统的影响

当设备处于本地控制状态时，自动化系统需要注意以下问题：

命令执行失败：在此期间发送的任何控制命令都会被拒绝
状态同步延迟：设备状态更新可能有15秒左右的延迟
自动化流程中断：如果不做特殊处理，自动化流程可能会因此中断

解决方案

自动化系统处理策略

在家庭自动化系统中，可以采用以下策略处理本地控制状态：

if:
  - condition: state
    entity_id: binary_sensor.hood_bsh_common_status_localcontrolactive
    state: "on"
then:
  - wait_for_trigger:
      - entity_id:
          - binary_sensor.hood_bsh_common_status_localcontrolactive
        to: "off"
        trigger: state
    timeout:
      hours: 0
      minutes: 0
      seconds: 15
      milliseconds: 0

这一策略会检测本地控制状态，并在状态激活时等待其结束，最多等待15秒。