Tuya Local项目：ORNO SIGO门铃设备集成技术解析

设备概况

ORNO SIGO是一款基于Tuya平台的无线门铃设备，型号为OR-DB-MK-174，产品ID为anic3m16jmjo80ao。该设备属于"Wireless Doorbell"类别，具有多种铃声选择和音量调节功能。

技术特性分析

设备通信协议

该门铃设备使用Tuya的3.4版本协议进行本地通信，支持以下主要功能点(DPS)：

1. 铃声选择：DPS 2，整型值，范围1-52，对应52种不同的铃声
2. 音量控制：DPS 3，整型值，范围0-4，共5个音量级别
3. 门铃呼叫事件：DPS 10，只读整型值，用于触发门铃事件
4. 移动通知开关：DPS 6，布尔值，控制是否推送移动通知

铃声映射配置

设备支持丰富的铃声选项，从经典的"Westminster Chimes"到"Jingle Bells"等节日音乐，共52种选择。在配置文件中，每种铃声都对应一个特定的DPS值，例如：

• 3: Westminster Chimes
• 4: Für Elise
• 6: Turkey March
• 47: Jingle Bells
• 52: Cuckoo

音量级别处理

音量控制采用5级调节方案，在配置中将其映射为0.2-1.0的浮点值：

• 0 → 0.20
• 1 → 0.40
• 2 → 0.60
• 3 → 0.80
• 4 → 1.00

集成配置要点

在Tuya Local项目中集成该设备时，需要注意以下技术细节：

1. YAML配置文件结构：需要正确定义siren、switch和event三种实体类型
2. 铃声选择问题：当前版本可能存在UI界面与后端服务的兼容性问题，导致铃声选择功能异常
3. 音量参数处理：在服务调用中应避免同时包含音量参数，或等待Home Assistant后续版本修复相关UI问题

设备功能实现

门铃事件处理

设备通过DPS 5和DPS 10实现门铃事件的上报和处理：

1. 支持原始事件(null)和响铃(ring)两种事件类型
2. 事件消息采用UTF16 BE格式编码
3. 可通过event实体类实现门铃事件的自动化触发

移动通知控制

通过DPS 6的布尔值开关，可以控制是否向移动设备推送门铃通知。该功能在配置中被归类为config类别，适合作为设备配置选项而非主要功能。

兼容性说明

该设备与WHM04门铃型号功能相似，但由于铃声列表和音量级别等细节差异，需要单独配置。开发者在集成时应注意：

1. 铃声映射表必须与设备实际支持的铃声完全匹配
2. 音量级别转换需要正确处理5级到浮点的映射关系
3. 事件处理机制需要考虑设备特有的上报格式

通过正确配置，Tuya Local项目可以充分发挥ORNO SIGO门铃设备的各项功能，实现本地化智能控制。