hcpy项目：为洗碗机添加程序终止功能的技术实现

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项目作为一个连接Bosch/Siemens家电与智能家居系统的桥梁，为用户提供了丰富的设备控制能力。近期，项目社区发现了一个功能需求：虽然当前系统支持启动洗碗机程序，但缺乏终止正在运行程序的能力。

技术分析

通过社区成员的探索，发现洗碗机设备本身支持程序终止功能，但在hcpy项目的设备描述文件(devices.json)中，相关功能的访问权限被设置为"none"，导致无法通过MQTT接口调用该功能。

解决方案实现

经过技术验证，将设备描述文件中BSH.Common.Command.AbortProgram特征的access属性从"none"修改为"writeOnly"后，系统即可支持程序终止功能。具体实现步骤如下：

1. 修改devices.json文件中的相关配置：

"features": {
    "512": {
        "name": "BSH.Common.Command.AbortProgram",
        "access": "writeOnly",
        "available": "true",
        "refCID": "01",
        "refDID": "00"
    }
}

2. 通过MQTT发布终止命令：

{"uid": 512,"value": true}

3. 设备响应后会发送状态变更通知，系统可以捕获这些变更来更新设备状态。

技术细节

当程序终止命令执行后，设备会通过/ro/descriptionChange接口发送一系列状态变更通知。这些通知包含了不同功能UID的访问权限变化，例如：

• 程序运行状态下，某些功能的access会从READWRITE变为READ
• 程序终止后，这些功能的access会恢复为READWRITE

这种动态权限变更机制是Bosch/Siemens家电API的一个特点，hcpy项目需要正确解析和处理这些变更通知，以保持设备状态的准确性。

实际应用

对于终端用户来说，这一功能的实现意味着：

1. 可以通过智能家居系统随时终止误启动的程序
2. 在程序运行过程中发现问题时能够及时停止
3. 为自动化场景提供了更多控制选项

对于开发者来说，这一案例展示了hcpy项目如何通过修改设备描述文件和正确使用MQTT接口来扩展设备功能。

总结

hcpy项目通过社区协作不断完善功能，本次程序终止功能的实现展示了项目良好的扩展性。未来可以考虑实现更智能的状态跟踪和权限动态更新机制，以提供更流畅的用户体验。这一改进已经通过验证并合并到项目中，用户更新后即可使用这一实用功能。

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