Case study
Blue Star AC → ESPHome: reconstructing the Wi-Fi port protocol
Blue Star AC → ESPHome reconstructs the UART protocol of Blue Star smart-ready air conditioners and implements local control on an ESP32-C3. Its ESPHome component completes the Tuya MCU handshake, exchanges Blue Star DP101 key/value records and exposes climate controls to Home Assistant for tested IE518TNUR and IA318MXU models.
- Targets
- Protocol
- Category
- Independent reconstruction cases
- Relationship
- Independent reconstruction project
- Sources reviewed
- Evidence class
- C2 code & docs, no demo or download
- Stars
- 11
- Last commit
- 2026-11-03
- Language
- C++
- License (GitHub)
- MIT
GitHub data as of 2026-11-10
Evidence
- Observed
- Code, documentation and a demo observed; no download method found.
- Checked
- 2026-11-08
Requirements & limits
- Prerequisites: A tested Blue Star IE518TNUR or IA318MXU unit with an ESP32-C3, 4-pin connector and voltage divider.
- Prerequisites: ESPHome 2026.10 with the ESP-IDF framework.
- Limits: Other Blue Star models are unconfirmed.
- License: MIT license.
Cite
BibTeX
@misc{blue-star-ac-esphome-case,
title = {{Blue Star AC → ESPHome: reconstructing the Wi-Fi port protocol}},
howpublished = {\url{https://github.com/Vikk20/bluestar-ac-esphome}},
url = {https://github.com/Vikk20/bluestar-ac-esphome},
urldate = {2026-11-06},
note = {Awesome REA entry: \url{https://awesomerea.org/resources/blue-star-ac-esphome-case/}}
}Plain text
Blue Star AC → ESPHome: reconstructing the Wi-Fi port protocol. https://github.com/Vikk20/bluestar-ac-esphome (accessed 2026-11-06). Awesome REA entry: https://awesomerea.org/resources/blue-star-ac-esphome-case/
Useful? Star Awesome REA on GitHub2.4k
About this entry
The description was reviewed against primary sources.
Primary sources
- README.md GitHub · Vikk20/bluestar-ac-esphome · Revision 123ad20
- docs/PROTOCOL.md GitHub · Vikk20/bluestar-ac-esphome · Revision 123ad20
More in Protocols
- Intel NUC M15 Light Bar Control for Linux: reconstructing WMI lighting commands · Case study
- libfprint-microarray: reconstructing the MAFP fingerprint reader USB protocol · Case study
- ntrig-calib: reconstructing Surface Pro 3 digitizer calibration · Case study
- even-utils: experimenting with Even Realities G1 dashboard messages · Case study
- Opel Insignia A: investigating LIN control of the Climatronic panel · Case study
- Opel Insignia climatronic panel: reconstructing LIN control with STM32 · Case study