XiaomiGateway3项目：PTX Mesh墙壁开关设备支持详解

XiaomiGateway3项目近期新增了对PTX品牌多款Mesh墙壁开关设备的支持。这些设备包括AK Ultra和AK Pro系列的单键、双键和三键版本，为智能家居用户提供了更多选择。

设备型号与功能特性

本次新增支持的设备型号包括：

1. AK Ultra系列：

   • 单键版（型号19642）
   • 双键版（型号19641）
   • 三键版（型号19640）

2. AK Pro系列：

   • 单键版（型号17943）
   • 双键版（型号17944）
   • 三键版（型号17933）

这些设备均采用Mesh 2.0协议，能够无缝接入小米智能家居生态系统。

功能实现细节

开关控制功能

每个物理按键都对应独立的开关通道，可通过以下方式控制：

• 单键版：Channel 1
• 双键版：Channel 1和Channel 2
• 三键版：Channel 1、Channel 2和Channel 3

按键模式配置

每路开关都支持两种工作模式选择：

• 有线+无线模式（Wired And Wireless）
• 纯无线模式（Wireless）

背光控制系统

设备配备了可调节的背光系统，支持：

• 三级亮度调节（Level 0-2）
• 三种工作模式（Default/auto/Not-disturb）

无线动作识别

设备能够识别并上报多种用户操作动作：

• 单击（SINGLE）
• 双击（DOUBLE）
• 长按（HOLD）

对于多键版本，每个按键的上述动作都会独立上报，方便用户进行精细化的自动化配置。

技术实现要点

在XiaomiGateway3项目中，这些设备的支持是通过定义特定的转换器（Converter）实现的。每个设备型号都有对应的spec配置，详细定义了：

• 实体开关控制点
• 模式选择参数
• 背光控制参数
• 动作事件映射关系

值得注意的是，这些设备的动作事件只有在主设备文件中定义时才能正常工作，这是项目当前的一个技术限制。

应用场景建议

这些PTX墙壁开关特别适合以下场景：

1. 需要同时控制多路灯具的房间
2. 需要保留传统墙壁开关功能的智能家居改造
3. 需要精细控制背光显示的夜间使用环境

随着XiaomiGateway3项目对这些设备的完整支持，用户可以更方便地将它们集成到现有的智能家居系统中，实现更丰富的自动化场景。