Case study

Aromatic BLE bridge: reconstructing AF300 Smart diffuser control

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.

Targets: Protocol
Category: Independent reconstruction cases
Relationship: Independent reconstruction project
Sources reviewed: 2026-11-07
Evidence class: C2 code & docs, no demo or download

Stars: 0
Last commit: 2026-10-21
Language: C++
License (GitHub): MIT

GitHub data as of 2026-11-10

Copy as Markdown View JSON Cite

Evidence

Observed: Code and documentation observed; no download method or demo found.
Checked: 2026-11-09

How evidence classes are assigned

Requirements & limits

Prerequisites: An ESP32-C3 bridge, ESPHome and an Aromatic AF300 Smart diffuser are the tested setup.
Prerequisites: Configuration requires Wi-Fi credentials, the diffuser password and MAC address; the phone app must release the single BLE connection.
Limits: The oil figures are estimates, and custom spray times below 15 seconds were not checked against pump behavior.
License: MIT license.

Cite

BibTeX

@misc{aromatic-ble-esphome-case,
  title = {{Aromatic BLE bridge: reconstructing AF300 Smart diffuser control}},
  howpublished = {\url{https://github.com/zmiyajan/aromatic-ble-esphome}},
  url = {https://github.com/zmiyajan/aromatic-ble-esphome},
  urldate = {2026-11-07},
  note = {Awesome REA entry: \url{https://awesomerea.org/resources/aromatic-ble-esphome-case/}}
}

Plain text

Aromatic BLE bridge: reconstructing AF300 Smart diffuser control. https://github.com/zmiyajan/aromatic-ble-esphome (accessed 2026-11-07). Awesome REA entry: https://awesomerea.org/resources/aromatic-ble-esphome-case/

Useful? Star Awesome REA on GitHub2.4k

About this entry

The description was reviewed against primary sources.

Report an outdated entry Suggest a translation fix

Primary sources

README.md GitHub · zmiyajan/aromatic-ble-esphome · Revision a8a2bce
PROTOCOL.md GitHub · zmiyajan/aromatic-ble-esphome · Revision a8a2bce