Aromatic AF300 Smart: zmiyajan/aromatic-ble-esphome

Developer zmiyajan released aromatic-ble-esphome, an ESPHome-based bridge that reverse-engineers the Bluetooth LE protocol of the Aromatic AF300 Smart scent diffuser (protocol CY_V3.0) to bring master power, fan levels and five internal schedule slots into Home Assistant, running on an ESP32-C3 over BLE to the device and WiFi to Home Assistant. Commit history credits Claude Opus 5.5 as a co-author on the bridge, documentation and protocol analysis, and the author warns against writing to the firmware-update service to avoid bricking the device. Known limits include the hard cap of five schedule slots and custom spray times below 15 seconds, which are stored but whose pump execution remains untested; no independent confirmation is reported.

Evidence at a glance Based on the linked sources. The author's reported result and independent confirmation are separate checks. - AI involvement - Reported models: Claude. Tools: ESPHome, ESP32-C3. The writeup below describes the work attributed to AI. - Reported result - Works. This is the directory's source-based outcome classification. - Independent confirmation - Not reported. - Human work and limitations - The project uses a series of probe configurations to facilitate protocol discovery. The author explicitly warns against writing to the firmware-update service to avoid bricking the device. Original sources What was done An ESPHome-based bridge for Aromatic BLE scent diffusers, enabling Home Assistant integration through a reverse-engineered protocol. It supports master control, five schedule slots, and optional light-based automation. The aromatic-ble-esphome https://raw.githubusercontent.com/zmiyajan/aromatic-ble-esphome/HEAD/README.md project provides a bridge between Home Assistant and Aromatic Bluetooth scent diffusers using an ESP32-C3 running ESPHome. The author reverse-engineered the BLE protocol to enable control over master power, fan levels, and five internal schedule slots. The bridge communicates via Bluetooth LE to the diffuser and WiFi to Home Assistant. The implementation includes an optional LDR-based light sensor to trigger spraying only when a room is lit. The author reports that the protocol was derived for interoperability with a device they own, specifically the Aromatic AF300 Smart protocol CY V3.0 . Commit history credits Claude Opus 5.5 as a co-author for the development of the bridge, documentation, and protocol analysis. Known limitations include a hard limit of five schedule slots and the fact that custom spray times below 15 seconds are stored but their execution by the pump remains untested. Reproduce it 1. Flash the ESP32-C3 with the provided bridge firmware. 2. Configure the diffuser's MAC address and 4-digit app password in secrets.yaml. 3. Ensure the official mobile app is closed to allow the bridge to connect.