XiaomiGateway3项目新增Linptech设备支持的技术解析

项目背景

XiaomiGateway3是一个开源项目，主要用于支持小米生态链设备在智能家居系统中的集成与控制。该项目通过网关实现对各类智能设备的统一管理，为用户提供便捷的设备接入和控制体验。

新增设备支持

最新版本中，项目新增了对Linptech品牌多款设备的支持，主要包括窗帘电机和智能开关两大类产品。

1. Linptech智能窗帘电机C2 (linp.curtain.c2)

该设备型号为10807，主要特性包括：

• 支持标准窗帘控制功能（开启、停止、关闭）
• 可设置窗帘位置百分比（0-100%）
• 支持电机反转功能
• 提供多种工作模式选择（默认模式、双模式、左模式、右模式）

技术实现上，项目通过以下参数映射实现控制：

• 电机状态映射（motor）：0=停止，1=开启，2=关闭
• 位置控制（position）：百分比数值控制
• 目标位置设置（target-position）：可输入数值设置
• 电机反转（motor_reverse）：开关控制
• 工作模式（mode）：四种可选模式

2. Linptech平开窗驱动器WD2 (linp.wopener.wd2lb)

该设备型号为13203，主要特性包括：

• 窗户开合控制功能
• 位置百分比控制
• 电池状态监测
• 防夹灵敏度设置

技术实现细节：

• 电机控制与窗帘电机类似
• 增加了电池状态监测（battery）和充电状态（battery_status）
• 防夹灵敏度可调（anti_pinch_sensitivity）：从非常低到高共4档

3. Linptech QT1系列智能开关

项目更新了对QT1系列智能开关的支持，新增了白灯和橙灯亮度调节功能。该系列包括：

• 单键版（linp.switch.qt1db1）
• 双键版（linp.switch.qt1db2）
• 三键版（linp.switch.qt1db3）
• 四键版（linp.switch.qt1db4）

主要更新内容：

• 新增亮度控制参数（brightness_white和brightness_orange）
• 支持0-100%的亮度调节
• 保持原有的开关控制、无线模式、LED指示灯等功能
• 触控灵敏度可调（Off/Low/Medium/High）

技术实现要点

1. 设备识别：通过设备型号ID（如10807、13203等）和产品型号（如linp.curtain.c2）进行设备识别和分类。

2. 参数映射：

   • 使用MapConv进行枚举值到文本的映射
   • 使用MathConv进行数值范围的控制
   • 使用BaseConv进行基本参数的传递

3. 特殊处理：

   • 窗帘位置控制采用CurtainPosConv特殊转换器
   • 按钮动作使用ConstConv固定值映射

4. 实体类型：

   • 根据功能需要映射为switch、cover、sensor等不同类型的HA实体
   • 部分参数标记为ENTITY_CONFIG表示配置项

使用建议

对于终端用户，建议：

1. 确保使用最新版本的XiaomiGateway3插件
2. 添加设备时注意选择正确的设备类型
3. 窗帘设备可充分利用位置百分比控制实现精准定位
4. 智能开关的灯光亮度可根据实际需求调节

对于开发者，可以关注：

1. 设备参数映射的实现方式
2. 特殊转换器的使用场景
3. 新设备支持的添加模式

总结

本次更新显著扩展了XiaomiGateway3对Linptech设备的支持范围，特别是新增了窗帘电机和平开窗驱动器两类产品，并完善了QT1系列智能开关的功能。这些更新使得用户能够更全面地控制这些智能设备，提升了智能家居系统的兼容性和用户体验。