TexhSB/mirage-ac-protocol

GitHub: TexhSB/mirage-ac-protocol

该项目逆向工程并文档化了 Mirage EICON121-0 空调的红外通信协议,为智能家居集成提供完整的字节级协议参考。

Stars: 0 | Forks: 0

# Mirage AC 协议 (EICON121-0 / KKG27A-C11) 本仓库记录了 EICON121-0 mini-split 空调和 KKG27A-C11 遥控器所使用的红外协议。 该协议是通过运行 ESPHome 的 ESP32 以及红外接收器和发射器进行逆向工程得出的。以下记录的所有数值均已通过物理硬件测试验证。(我只是将其作为一个 esphome 项目来完成,因此暂时不会进一步深入研究。如果你感兴趣,欢迎去探索第 2、11、12 和 13 字节的作用。) ## 已解码的功能 * 开启 / 关机 * 温度设定值 * 制冷 / 制热 / 除湿 / 自动 / 送风模式 * 风速(自动、低速、中速、高速) * Turbo * Quiet * 睡眠 * Health * Clean * Lock * H-Sweep * V-Sweep * 显示切换 * 摄氏度 / 华氏度 * 开启定时器 * 关闭定时器 ## 测试硬件 | 组件 | 型号 | | -------------- | ---------- | | 室内机 | EICON121-0 | | 遥控器 | KKG27A-C11 | | 控制器 | ESP32 | | 软件 | ESPHome | ## 协议结构 数据包长度:14 字节 | 字节 | 功能 | | ---- | ----------------------------- | | 0 | Header (0x56) | | 1 | 温度 / 设定值 | | 2 | 未知 | | 3 | Quiet | | 4 | 模式 + 风速 | | 5 | 扫风 / 显示 / 电源状态 | | 6 | Health / 睡眠 / 制热 / Lock | | 7 | Clean | | 8 | 开启定时器小时数 | | 9 | 温度单位 | | 10 | 关闭定时器小时数 | | 11 | 未知 | | 12 | 未知 | | 13 | 未知 | ## 温度编码 温度似乎按以下方式存储: Byte1 = Temperature + 0x5C 示例: | 温度 | 数值 | | ----- | ----- | | 20°C | 0x70 | | 21°C | 0x71 | ## 字节定义 ### 字节 3 | 数值 | 功能 | | ---- | ------ | | 0x01 | Quiet | ### 字节 4 - 模式 | 数值 | 功能 | | ---- | ------ | | 0x10 | 制热 | | 0x20 | 制冷 | | 0x30 | 除湿 | | 0x40 | 自动 | | 0x50 | 送风 | ### 字节 4 - 风速偏移量 | 数值 | 功能 | | ---- | ------ | | +0 | 自动 | | +1 | 高速 | | +2 | 低速 | | +3 | 中速 | 示例: | 数值 | 含义 | | ---- | ------------- | | 0x20 | 制冷 + 自动 | | 0x21 | 制冷 + 高速 | | 0x22 | 制冷 + 低速 | | 0x23 | 制冷 + 中速 | ### 字节 5 | 数值 | 功能 | | ---- | -------------------- | | 0x01 | H-Sweep | | 0x02 | V-Sweep | | 0x03 | H + V Sweep | | 0x04 | 显示切换 | | 0xC0 | 关机 / 电源状态关闭 | ### 字节 6 | 数值 | 功能 | | ---- | ---------- | | 0x02 | Health | | 0x08 | 睡眠 | | 0x40 | 制热标志 | | 0x80 | Lock | ### 字节 7 | 数值 | 功能 | | ---- | ------ | | 0x40 | Clean | ### 字节 8 开启定时器小时数 示例: | 数值 | 含义 | | ---- | ------------------ | | 0x03 | 3 小时后开启 | | 0x05 | 5 小时后开启 | ### 字节 9 | 数值 | 功能 | | ---- | -------- | | 0x00 | 摄氏度 | | 0xC0 | 华氏度 | ### 字节 10 关闭定时器小时数 示例: | 数值 | 含义 | | ---- | ------------------ | | 0x01 | 1 小时后关闭 | | 0x05 | 5 小时后关闭 | ## 示例数据包 ### 制冷,20°C,自动风速 56:70:00:00:20:00:00:00:00:00:00:00:00:00 ### 关机 56:70:00:00:20:C0:00:00:00:00:00:00:00:00 ### Turbo 56:70:00:00:20:00:00:00:80:00:00:00:00:00 ### Clean 56:70:00:00:20:00:00:40:00:00:00:00:00:00 ## 剩余未知字段 以下字节会被室内机接受,但尚未完全解码: * 字节 2 * 字节 11 * 字节 12 ## 仓库内容 * Mirage_AC_IR_Protocol_Documentation.pdf * Mirage_AC_Captures.txt * README.md ## 许可证 MIT License
标签:ESPHome, Home Assistant, 云资产清单, 智能家居, 物联网, 空调控制, 红外协议, 逆向工程