XiaomiGateway3项目新增PTX智能双控墙壁开关支持

在智能家居领域，设备兼容性一直是用户关注的重点。XiaomiGateway3作为小米生态链设备的重要集成平台，近期新增了对PTX Smart Double Wall Switch（型号：PTX-X62-NMIMC1，产品代码：090615.switch.x6kw2）的支持。

设备功能解析

这款双控墙壁开关具有以下核心功能特性：

1. 双路开关控制：

   • 提供两个独立的物理开关通道（switch_1和switch_2）
   • 每个通道可独立控制连接的灯具或电器设备

2. 操作反馈：

   • 支持按钮动作检测（action）
   • 可区分两个按钮的单击操作（BUTTON_1_SINGLE和BUTTON_2_SINGLE）

3. 背光控制：

   • 可配置的背光开关功能（backlight）
   • 便于夜间操作识别

4. 工作模式选择：

   • 每路开关支持两种工作模式配置：
     • 有线+无线混合模式（Wired And Wireless）
     • 纯无线模式（Wireless）

技术实现细节

在XiaomiGateway3项目中，开发者通过以下方式实现了对该设备的支持：

1. 设备识别：

   • 使用产品唯一标识码090615.switch.x6kw2进行设备识别
   • 定义了设备的人类可读名称"PTX Smart Double Wall Switch"

2. 功能映射：

   • 将设备原始功能映射为标准HA实体：
     • 开关状态映射为switch实体
     • 按钮操作映射为sensor实体
     • 工作模式映射为select实体

3. 模式转换：

   • 使用MapConv处理工作模式选择
   • 将原始数值0/1转换为更易理解的文本描述

应用场景

这款双控开关特别适合以下场景：

1. 传统双控改造：

   • 无需重新布线即可实现传统双控开关的智能化改造
   • 保留原有墙面开关的同时增加智能控制功能

2. 混合控制需求：

   • 同时支持物理按键和APP/语音控制
   • 可根据需要配置为纯无线模式

3. 灯光场景控制：

   • 通过按钮动作触发自动化场景
   • 实现单击开灯、双击调光等高级功能

开发者建议

对于希望扩展XiaomiGateway3功能的开发者，可以参考以下实现模式：

1. 设备定义结构：

   • 使用清晰的设备规格描述
   • 明确定义每个功能点与HA实体的映射关系

2. 类型转换处理：

   • 对于枚举值使用MapConv转换为友好文本
   • 对于布尔值使用BoolConv确保类型安全

3. 功能分组：

   • 将配置参数与操作功能分开处理
   • 保持实体命名的统一性和可读性

该设备的成功集成展示了XiaomiGateway3项目良好的扩展性，为更多第三方小米生态链设备的接入提供了参考范例。