# 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.

- Type: Case study
- Targets: Protocol
- Category: Independent reconstruction cases
- Relationship: Independent reconstruction project
- Sources reviewed: 2026-11-07
- Added to the catalog: 2026-11-09
- Original resource: <https://github.com/zmiyajan/aromatic-ble-esphome>
- Primary source: <https://github.com/zmiyajan/aromatic-ble-esphome/blob/a8a2bce5d4fc206818ae06df958c97e2a0c4d19b/README.md>
- Catalog page: <https://awesomerea.org/resources/aromatic-ble-esphome-case/>
- Record JSON: <https://awesomerea.org/resources/aromatic-ble-esphome-case/record.json>
- Chinese version: [简体中文](https://awesomerea.org/zh/resources/aromatic-ble-esphome-case/index.md)

## 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.

## Primary sources

1. <https://github.com/zmiyajan/aromatic-ble-esphome/blob/a8a2bce5d4fc206818ae06df958c97e2a0c4d19b/README.md>
2. <https://github.com/zmiyajan/aromatic-ble-esphome/blob/a8a2bce5d4fc206818ae06df958c97e2a0c4d19b/PROTOCOL.md>

## More in Protocols

- [Teclado RGB via USB HID: reconstructing Redragon K552-M lighting commands](https://awesomerea.org/resources/teclado-rgb-usb-hid-case/index.md) · Case study
- [wibox-daemon: reconstructing Fermax Wi-Box control and media transport](https://awesomerea.org/resources/wibox-daemon-case/index.md) · Case study
- [MousePods: reconstructing AirPods 3 RemoteHID motion access](https://awesomerea.org/resources/mousepods-airpods-remotehid-case/index.md) · Case study
- [FitFace Studio: reconstructing Galaxy Fit3 watch-face editing and delivery](https://awesomerea.org/resources/fitface-studio-case/index.md) · Case study
- [fretwire: reconstructing Line 6 HX USB control](https://awesomerea.org/resources/fretwire-case/index.md) · Case study
- [Kreo Hive 65: reconstructing USB HID RGB control](https://awesomerea.org/resources/kreo-hive65-rgb-case/index.md) · Case study

## About this entry

The description was reviewed against primary sources.
Original editorial content: MIT. Linked projects, papers and assets retain their own rights and licenses.