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