XiaomiGateway3项目新增PTX智能三键墙壁开关支持

设备概述

PTX智能三键墙壁开关是一款支持米家生态系统的智能家居设备，型号为PTX-X62-NMIMC1，设备标识符为090615.switch.x6kw3。该设备具有三个独立的物理按键，每个按键都可以控制对应的电路开关。

技术实现细节

在XiaomiGateway3项目中，开发者通过添加设备描述符来实现对该开关的支持。主要技术实现包括：

1. 设备识别：使用11654作为设备类型ID，并指定了设备名称、型号和标识符。

2. 功能映射：

   • 三个独立的开关控制功能（switch_1、switch_2、switch_3）
   • 按键动作检测（action），支持三个按键的单击事件
   • 背光控制功能（backlight）
   • 三种工作模式选择（Mode_1、Mode_2、Mode_3）

3. 工作模式配置：

   • 每个按键都可以独立设置为"有线+无线"或"纯无线"模式
   • 通过MapConv转换器实现模式与数值的映射关系

功能详解

1. 开关控制：

   • 三个开关分别对应物理设备上的三个按键
   • 通过mi属性指定了每个开关在米家协议中的参数位置

2. 按键事件：

   • 使用ConstConv转换器将原始事件转换为标准化的按钮事件
   • 定义了BUTTON_X_SINGLE常量表示单机事件

3. 背光控制：

   • 可控制开关上的指示灯状态
   • 该功能被标记为配置项(config)

4. 工作模式：

   • "有线+无线"模式：支持物理按键和无线控制
   • "纯无线"模式：仅支持无线控制，禁用物理按键功能

技术意义

该实现的加入使得XiaomiGateway3项目能够完整支持PTX三键智能开关的所有功能，包括：

• 远程控制三个独立的电路
• 接收物理按键的操作事件
• 灵活配置每个按键的工作模式
• 控制设备背光状态

这种实现方式遵循了项目的设备支持规范，通过标准化的转换器将设备原生协议转换为统一的HA实体，保持了项目架构的一致性。

适用场景

该设备特别适合需要多路控制的智能家居场景，如：

• 客厅的多组灯光控制
• 卧室的主灯、氛围灯和夜灯控制
• 办公室的不同区域照明管理

通过XiaomiGateway3项目的支持，用户可以在Home Assistant中实现更复杂的自动化场景，如联动其他设备、设置定时任务等。