kquinsland/levoit-classic-200s-esphome
GitHub: kquinsland/levoit-classic-200s-esphome
为 Levoit Classic 200S 加湿器提供 ESPHome 组件与逆向工程笔记,实现本地控制与协议解析。
Stars: 0 | Forks: 0
# Levoit Classic 200S ESPHome 与 RE
本仓库包含一个用于 Levoit Classic 200S 加湿器的 ESPHome 外部组件,以及用于恢复 ESP32 <-> MCU 协议的逆向工程笔记和工具。
## Home Assistant

通过替换固件,Home Assistant 可以识别并控制设备的主要功能:电源、显示、模式(`off` / `manual` / `auto`)、目标湿度、手动强度、自动停止、当前湿度、温度以及 MCU 暴露的水位信号,此外还包括 MCU 固件版本和解码失败计数器等诊断实体。
## ESPHome
如果主要想用 ESPHome 使用该加湿器,请从此处开始:
- [ESPHome 指南](esphome/readme.md)
- [示例配置](esphome/example.yaml)
- [组件源码](esphome/components/levoit_humidifier)
ESPHome 组件通过 UART 直接与机载的 housekeeping MCU 通信,
因此可以完全替换面向云端的 ESP32 固件。
## 协议与工具
设备在 ESP32 与本地 MCU 之间使用简单的 `9600 8N1` UART 链路。主机发送用于状态查询和控制的帧格式命令,而 MCU 则回推异步状态更新和按钮事件。这足以在本地实现加湿器控制,无需与厂商云通信。
更多细节请参考:
- [协议说明](docs/protocol.md)
- [逆向工程笔记](docs/codex-notes.md)
- [UART 调试工具](tools/mcu_uart_lab/README.md)
该调试工具可以解码实时流量、发送格式化命令,并记录与真实硬件的完整 UART 会话。
标签:ESP32, ESPHome, Home Assistant, Levoit, MCU协议, UART通信, Waymore结果处理, 加湿器, 反向工程, 命令控制, 固件, 数据采集, 智能家居, 本地控制, 物联网, 设备集成, 诊断