{
  "added_at": "2026-11-09",
  "additional_evidence_urls": [
    "https://github.com/cryystyy/fluval-plant-pro-4-homeassistant/blob/dbc1c14df56ebbcce382795e38956b9d77b6e7ed/docs/PROTOCOL.md",
    "https://github.com/cryystyy/fluval-plant-pro-4-homeassistant/blob/dbc1c14df56ebbcce382795e38956b9d77b6e7ed/LICENSE"
  ],
  "category": "reconstruction-cases",
  "class": "hardware",
  "description_en": "The Fluval Plant Pro 4.0 project reconstructs the light's CBOR-over-BLE control protocol from the FluvalConnect Android app. An ESP32 ESPHome configuration sends commands through vendor service FFF0 and exposes power, five color channels, schedules and state updates to Home Assistant.",
  "description_zh": "Fluval Plant Pro 4.0 项目通过分析 FluvalConnect Android 应用重建灯具的 CBOR over BLE 控制协议。ESP32 上的 ESPHome 配置经 FFF0 服务发送指令，并将开关、五路颜色、日程和状态同步接入 Home Assistant。",
  "entry_url": "https://awesomerea.org/resources/fluval-plant-pro-4-ble-case/",
  "entry_url_zh": "https://awesomerea.org/zh/resources/fluval-plant-pro-4-ble-case/",
  "evidence_url": "https://github.com/cryystyy/fluval-plant-pro-4-homeassistant/blob/dbc1c14df56ebbcce382795e38956b9d77b6e7ed/README.md",
  "group": "cases",
  "id": "fluval-plant-pro-4-ble-case",
  "json_url": "https://awesomerea.org/resources/fluval-plant-pro-4-ble-case/record.json",
  "kind": "case-study",
  "markdown_url": "https://awesomerea.org/resources/fluval-plant-pro-4-ble-case/index.md",
  "markdown_url_zh": "https://awesomerea.org/zh/resources/fluval-plant-pro-4-ble-case/index.md",
  "name": "Fluval Plant Pro 4.0: reconstructing BLE light control",
  "name_zh": "Fluval Plant Pro 4.0：重建 BLE 灯光控制",
  "record_type": "resource",
  "relationship": "independent-reconstruction",
  "requirement_facets": [
    "prerequisites",
    "limits",
    "license"
  ],
  "requirements": [
    "Fluval Plant Pro 4.0, an ESP32 with BLE and Wi-Fi, Home Assistant with ESPHome, and the light's Bluetooth MAC address.",
    "The light permits only one Bluetooth connection at a time; remaining status keys 14–22 are undecoded.",
    "MIT license."
  ],
  "requirements_zh": [
    "需要 Fluval Plant Pro 4.0、具备 BLE 和 Wi-Fi 的 ESP32、安装 ESPHome 的 Home Assistant，以及灯具的 Bluetooth MAC 地址。",
    "灯具同一时间只允许一个 Bluetooth 连接；状态键 14–22 尚未解码。",
    "采用 MIT 许可证。"
  ],
  "targets": [
    "app",
    "protocol"
  ],
  "url": "https://github.com/cryystyy/fluval-plant-pro-4-homeassistant",
  "verification": "source-reviewed",
  "verified_at": "2026-11-08"
}