{
  "added_at": "2026-11-09",
  "additional_evidence_urls": [
    "https://github.com/zmiyajan/aromatic-ble-esphome/blob/a8a2bce5d4fc206818ae06df958c97e2a0c4d19b/PROTOCOL.md"
  ],
  "category": "reconstruction-cases",
  "class": "hardware",
  "description_en": "The Aromatic BLE bridge connects an AF300 Smart scent diffuser to Home Assistant through an ESP32 running ESPHome. Its BLE protocol was derived from Android-app analysis and device probes; the bridge reads and writes power, fan and schedule settings, while protocol notes document GATT characteristics, login frames and commands.",
  "description_zh": "Aromatic BLE bridge 通过运行 ESPHome 的 ESP32 将 AF300 Smart 香薰机接入 Home Assistant。其 BLE 协议来自 Android 应用分析与设备探测；桥接器读写开关、风扇和日程设置，协议文档记录 GATT 特征、登录帧及命令。",
  "entry_url": "https://awesomerea.org/resources/aromatic-ble-esphome-case/",
  "entry_url_zh": "https://awesomerea.org/zh/resources/aromatic-ble-esphome-case/",
  "evidence_class": 2,
  "evidence_status": "observed",
  "evidence_url": "https://github.com/zmiyajan/aromatic-ble-esphome/blob/a8a2bce5d4fc206818ae06df958c97e2a0c4d19b/README.md",
  "group": "cases",
  "id": "aromatic-ble-esphome-case",
  "json_url": "https://awesomerea.org/resources/aromatic-ble-esphome-case/record.json",
  "kind": "case-study",
  "markdown_url": "https://awesomerea.org/resources/aromatic-ble-esphome-case/index.md",
  "markdown_url_zh": "https://awesomerea.org/zh/resources/aromatic-ble-esphome-case/index.md",
  "name": "Aromatic BLE bridge: reconstructing AF300 Smart diffuser control",
  "name_zh": "Aromatic BLE bridge：重建 AF300 Smart 香薰机控制协议",
  "record_type": "resource",
  "relationship": "independent-reconstruction",
  "requirement_facets": [
    "prerequisites",
    "prerequisites",
    "limits",
    "license"
  ],
  "requirements": [
    "An ESP32-C3 bridge, ESPHome and an Aromatic AF300 Smart diffuser are the tested setup.",
    "Configuration requires Wi-Fi credentials, the diffuser password and MAC address; the phone app must release the single BLE connection.",
    "The oil figures are estimates, and custom spray times below 15 seconds were not checked against pump behavior.",
    "MIT license."
  ],
  "requirements_zh": [
    "已测试的配置包括 ESP32-C3 桥接器、ESPHome 和 Aromatic AF300 Smart 香薰机。",
    "配置需要 Wi-Fi 凭据、香薰机密码及 MAC 地址；手机应用需释放唯一的 BLE 连接。",
    "精油用量为估算值；低于 15 秒的自定义喷雾时间尚未核对泵的实际行为。",
    "MIT 许可证。"
  ],
  "scope": "unknown",
  "targets": [
    "protocol"
  ],
  "url": "https://github.com/zmiyajan/aromatic-ble-esphome",
  "verification": "source-reviewed",
  "verified_at": "2026-11-07"
}