Case study
Gree-Wired-Proto: mapping the XK19 wired controller bus
Gree-Wired-Proto maps the RS-485 exchange between a Gree air-conditioner indoor unit and an XK19 wired controller. It records 1200-baud 8N1 serial settings, a 7E 7E header, source and destination bytes, body lengths, XOR checksum and observed message examples.
- Targets
- Protocol
- Category
- Independent reconstruction cases
- Relationship
- Independent reconstruction project
- Sources reviewed
- Evidence class
- C2 code & docs, no demo or download
- Stars
- 7
- Last commit
- 2024-02-13
- License (GitHub)
- GPL-3.0
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 Gree indoor unit and compatible wired controller for observing this bus.
- Limits: The meaning of destination 40 remains unknown.
- License: GPL-3.0 license.
Cite
BibTeX
@misc{gree-wired-proto-case,
title = {{Gree-Wired-Proto: mapping the XK19 wired controller bus}},
howpublished = {\url{https://github.com/maxim-smirnov/gree-wired-proto}},
url = {https://github.com/maxim-smirnov/gree-wired-proto},
urldate = {2026-11-06},
note = {Awesome REA entry: \url{https://awesomerea.org/resources/gree-wired-proto-case/}}
}Plain text
Gree-Wired-Proto: mapping the XK19 wired controller bus. https://github.com/maxim-smirnov/gree-wired-proto (accessed 2026-11-06). Awesome REA entry: https://awesomerea.org/resources/gree-wired-proto-case/
Useful? Star Awesome REA on GitHub2.4k
About this entry
The description was reviewed against primary sources.
Primary sources
- README.md GitHub · maxim-smirnov/gree-wired-proto · Revision 14168a2
More in Protocols
- Nuga library: reconstructing NuPhy BYK916 keyboard control · Case study
- Razer Nari Battery Level: recovering a USB battery-voltage exchange · Case study
- Pix Backpack Go: reconstructing PIX display control over BLE · Case study
- VFS495 fingerprint reader on Linux: reconstructing capture and login · Case study
- VTech VM901: reconstructing camera authentication and media access · Case study
- KATASYMBOL E12 Lab: reconstructing BLE label printing · Case study