Case study

Truma Aventa: Home Assistant control from BLE protocol findings

Truma Aventa controls a second-generation Aventa roof air conditioner from Home Assistant over BLE. The implementation uses captured TruMessageV3 and CBOR messages to expose climate, light, and diagnostic entities. Its findings document BLE framing, device addresses, routing, and pairing behavior observed on the appliance, including corrections to a prior protocol reference.

Targets: Protocol
Category: Independent reconstruction cases
Relationship: Independent reconstruction project
Sources reviewed: 2026-11-06
Evidence class: C2 code & docs, no demo or download

Stars: 1
Last commit: 2026-08-24
Language: Python
License (GitHub): MIT

GitHub data as of 2026-11-10

Copy as Markdown View JSON Cite

Evidence

Observed: Code and documentation observed; no download method or demo found.
Checked: 2026-11-08

How evidence classes are assigned

Requirements & limits

Prerequisites: Home Assistant 2025.2 or newer with Bluetooth integration and an Aventa comfort 2nd generation for the documented setup.
Prerequisites: Pairing must be started on the appliance during setup.
Limits: Only the Aventa comfort 2nd generation has been tested.
License: MIT license.

Cite

BibTeX

@misc{truma-aventa2-ha-case,
  title = {{Truma Aventa: Home Assistant control from BLE protocol findings}},
  howpublished = {\url{https://github.com/omc69/Truma-Aventa2-HomeAssistant-Integration}},
  url = {https://github.com/omc69/Truma-Aventa2-HomeAssistant-Integration},
  urldate = {2026-11-06},
  note = {Awesome REA entry: \url{https://awesomerea.org/resources/truma-aventa2-ha-case/}}
}

Plain text

Truma Aventa: Home Assistant control from BLE protocol findings. https://github.com/omc69/Truma-Aventa2-HomeAssistant-Integration (accessed 2026-11-06). Awesome REA entry: https://awesomerea.org/resources/truma-aventa2-ha-case/

Useful? Star Awesome REA on GitHub2.4k

About this entry

The description was reviewed against primary sources.

Report an outdated entry Suggest a translation fix

Primary sources

README.md GitHub · omc69/Truma-Aventa2-HomeAssistant-Integration · Revision 96b3629
docs/findings.md GitHub · omc69/Truma-Aventa2-HomeAssistant-Integration · Revision 96b3629