{
  "added_at": "2026-11-08",
  "additional_evidence_urls": [
    "https://github.com/omc69/Truma-Aventa2-HomeAssistant-Integration/blob/96b362972c5807f08b5fa3f7b57efa8f0bedfa75/docs/findings.md"
  ],
  "category": "reconstruction-cases",
  "class": "hardware",
  "description_en": "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.",
  "description_zh": "Truma Aventa 通过 BLE 在 Home Assistant 中控制第二代 Aventa 车顶空调。实现依据捕获的 TruMessageV3 与 CBOR 消息提供空调、灯光及诊断实体。调查文档记录设备上的 BLE 封帧、地址、命令路由和配对行为，并修正既有协议资料。",
  "entry_url": "https://awesomerea.org/resources/truma-aventa2-ha-case/",
  "entry_url_zh": "https://awesomerea.org/zh/resources/truma-aventa2-ha-case/",
  "evidence_class": 2,
  "evidence_status": "observed",
  "evidence_url": "https://github.com/omc69/Truma-Aventa2-HomeAssistant-Integration/blob/96b362972c5807f08b5fa3f7b57efa8f0bedfa75/README.md",
  "group": "cases",
  "id": "truma-aventa2-ha-case",
  "json_url": "https://awesomerea.org/resources/truma-aventa2-ha-case/record.json",
  "kind": "case-study",
  "markdown_url": "https://awesomerea.org/resources/truma-aventa2-ha-case/index.md",
  "markdown_url_zh": "https://awesomerea.org/zh/resources/truma-aventa2-ha-case/index.md",
  "name": "Truma Aventa: Home Assistant control from BLE protocol findings",
  "name_zh": "Truma Aventa：基于 BLE 协议调查的 Home Assistant 控制",
  "record_type": "resource",
  "relationship": "independent-reconstruction",
  "requirement_facets": [
    "prerequisites",
    "prerequisites",
    "limits",
    "license"
  ],
  "requirements": [
    "Home Assistant 2025.2 or newer with Bluetooth integration and an Aventa comfort 2nd generation for the documented setup.",
    "Pairing must be started on the appliance during setup.",
    "Only the Aventa comfort 2nd generation has been tested.",
    "MIT license."
  ],
  "requirements_zh": [
    "文档所述配置需要 Home Assistant 2025.2 或更新版本、Bluetooth 集成及第二代 Aventa comfort。",
    "设置过程中须在设备上启动配对。",
    "目前仅测试过第二代 Aventa comfort。",
    "许可证为 MIT。"
  ],
  "scope": "unknown",
  "targets": [
    "protocol"
  ],
  "url": "https://github.com/omc69/Truma-Aventa2-HomeAssistant-Integration",
  "verification": "source-reviewed",
  "verified_at": "2026-11-06"
}