# Truma Aventa：基于 BLE 协议调查的 Home Assistant 控制

> Truma Aventa 通过 BLE 在 Home Assistant 中控制第二代 Aventa 车顶空调。实现依据捕获的 TruMessageV3 与 CBOR 消息提供空调、灯光及诊断实体。调查文档记录设备上的 BLE 封帧、地址、命令路由和配对行为，并修正既有协议资料。

- 类型：案例
- 目标：协议
- 类别：独立重建案例
- 关联：独立重建项目
- 来源复核于：2026-11-06
- 收录于：2026-11-08
- 原始资源：<https://github.com/omc69/Truma-Aventa2-HomeAssistant-Integration>
- 一手来源：<https://github.com/omc69/Truma-Aventa2-HomeAssistant-Integration/blob/96b362972c5807f08b5fa3f7b57efa8f0bedfa75/README.md>
- 目录页面：<https://awesomerea.org/zh/resources/truma-aventa2-ha-case/>
- 记录 JSON：<https://awesomerea.org/resources/truma-aventa2-ha-case/record.json>
- 英文版：[English](https://awesomerea.org/resources/truma-aventa2-ha-case/index.md)

## 使用条件与局限

- **前提条件：**文档所述配置需要 Home Assistant 2025.2 或更新版本、Bluetooth 集成及第二代 Aventa comfort。
- **前提条件：**设置过程中须在设备上启动配对。
- **局限：**目前仅测试过第二代 Aventa comfort。
- **许可：**许可证为 MIT。

## 一手来源

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>

## 同分区更多条目：协议

- [PetKit Eversweet Max 2 UVC：还原饮水机 BLE 遥测协议](https://awesomerea.org/zh/resources/petkit-eversweet-ble-gateway-case/index.md) · 案例
- [WalleCube UPS：基于还原的 BLE 协议实现 Home Assistant 控制](https://awesomerea.org/zh/resources/wallecube-bt-ha-case/index.md) · 案例
- [toppingctl：重建 Topping DAC 的 USB HID 控制](https://awesomerea.org/zh/resources/toppingctl-case/index.md) · 案例
- [tuya-ipc-p2p-sdk：Tuya P2P 协议的 Python 摄像头客户端](https://awesomerea.org/zh/resources/tuya-ipc-p2p-sdk-case/index.md) · 案例
- [SYNA8002：重建 ThinkPad 指纹读取器的 SPI 协议](https://awesomerea.org/zh/resources/x1-tablet-gen3-fingerprint-case/index.md) · 案例
- [fx_lcd_software：重建 ID-COOLING FX 显示屏传输协议](https://awesomerea.org/zh/resources/fx-lcd-software-case/index.md) · 案例

## 关于此条目

说明已依据一手来源复核。
原创说明采用 MIT 许可；外部项目、论文与素材保留各自的权利和许可。