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, 云资产清单, 智能家居, 物联网, 空调控制, 红外协议, 逆向工程