# 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.

- Type: Case study
- Targets: Protocol
- Category: Independent reconstruction cases
- Relationship: Independent reconstruction project
- Sources reviewed: 2026-11-06
- Added to the catalog: 2026-11-08
- Original resource: <https://github.com/omc69/Truma-Aventa2-HomeAssistant-Integration>
- Primary source: <https://github.com/omc69/Truma-Aventa2-HomeAssistant-Integration/blob/96b362972c5807f08b5fa3f7b57efa8f0bedfa75/README.md>
- Catalog page: <https://awesomerea.org/resources/truma-aventa2-ha-case/>
- Record JSON: <https://awesomerea.org/resources/truma-aventa2-ha-case/record.json>
- Chinese version: [简体中文](https://awesomerea.org/zh/resources/truma-aventa2-ha-case/index.md)

## 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.

## Primary sources

1. <https://github.com/omc69/Truma-Aventa2-HomeAssistant-Integration/blob/96b362972c5807f08b5fa3f7b57efa8f0bedfa75/README.md>
2. <https://github.com/omc69/Truma-Aventa2-HomeAssistant-Integration/blob/96b362972c5807f08b5fa3f7b57efa8f0bedfa75/docs/findings.md>

## More in Protocols

- [PetKit Eversweet Max 2 UVC: reconstructing fountain BLE telemetry](https://awesomerea.org/resources/petkit-eversweet-ble-gateway-case/index.md) · Case study
- [WalleCube UPS: Home Assistant control through a reconstructed BLE protocol](https://awesomerea.org/resources/wallecube-bt-ha-case/index.md) · Case study
- [toppingctl: reconstructing Topping DAC control over USB HID](https://awesomerea.org/resources/toppingctl-case/index.md) · Case study
- [tuya-ipc-p2p-sdk: Python camera client for Tuya’s P2P protocol](https://awesomerea.org/resources/tuya-ipc-p2p-sdk-case/index.md) · Case study
- [SYNA8002: reconstructing a ThinkPad fingerprint reader's SPI protocol](https://awesomerea.org/resources/x1-tablet-gen3-fingerprint-case/index.md) · Case study
- [fx_lcd_software: reconstructing ID-COOLING FX display transfers](https://awesomerea.org/resources/fx-lcd-software-case/index.md) · Case study

## About this entry

The description was reviewed against primary sources.
Original editorial content: MIT. Linked projects, papers and assets retain their own rights and licenses.