# iMist: local diffuser control from a reconstructed Bluetooth protocol

> iMist implements local Home Assistant control for an aroma diffuser whose Bluetooth command format was inferred by observing reports while its buttons were pressed. Its protocol notes map the fff4 characteristic's aa MM LL mist and light bytes; the integration exposes state, color, mist, schedules, and a sleep timer.

- Type: Case study
- Targets: Protocol
- Category: Independent reconstruction cases
- Relationship: Independent reconstruction project
- Sources reviewed: 2026-11-06
- Added to the catalog: 2026-11-08
- Original resource: <https://github.com/ElektroGandhi/iMist>
- Primary source: <https://github.com/ElektroGandhi/iMist/blob/5700d85eeebb3c764a85500f337f15bea9be603e/README.md>
- Catalog page: <https://awesomerea.org/resources/imist-diffuser-case/>
- Record JSON: <https://awesomerea.org/resources/imist-diffuser-case/record.json>
- Chinese version: [简体中文](https://awesomerea.org/zh/resources/imist-diffuser-case/index.md)

## Requirements & limits

- **Prerequisites:** Home Assistant 2024.11+ with Bluetooth and an iMist diffuser advertising the fff0 service and fff4 characteristic.
- **Limits:** Diffusers using the separate f501 protocol are unsupported; the device has no brightness or water-level sensor.
- **License:** MIT license.

## Primary sources

1. <https://github.com/ElektroGandhi/iMist/blob/5700d85eeebb3c764a85500f337f15bea9be603e/README.md>
2. <https://github.com/ElektroGandhi/iMist/blob/5700d85eeebb3c764a85500f337f15bea9be603e/docs/PROTOCOL.md>

## More in Protocols

- [Toshiba e-STUDIO2323AM: reconstructing a PJL/JBIG print stream for CUPS](https://awesomerea.org/resources/toshiba-estudio2323am-cups-driver-case/index.md) · Case study
- [CustomWatch: a Prixton Life Fit companion from BLE protocol research](https://awesomerea.org/resources/customwatch-case/index.md) · Case study
- [reticos-rgb: Speedlink RETICOS RGB mouse profile protocol](https://awesomerea.org/resources/reticos-rgb-case/index.md) · Case study
- [SPL Lab Web: NEXT LAB measurement client and device protocol](https://awesomerea.org/resources/spl-lab-web-case/index.md) · Case study
- [SainSmartDDS140: a USB oscilloscope client built from protocol research](https://awesomerea.org/resources/sainsmart-dds140-case/index.md) · Case study
- [haylou-rt-tools: reconstructing Haylou RT BLE and watch-face formats](https://awesomerea.org/resources/haylou-rt-tools-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.