Case study

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.

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

Stars: 0
Last commit: 2026-11-07
Language: Python
License (GitHub): MIT

GitHub data as of 2026-11-10

Copy as Markdown View JSON Cite

Evidence

Observed: Code, documentation and a demo observed; no download method found.
Checked: 2026-11-08

How evidence classes are assigned

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.

Cite

BibTeX

@misc{imist-diffuser-case,
  title = {{iMist: local diffuser control from a reconstructed Bluetooth protocol}},
  howpublished = {\url{https://github.com/ElektroGandhi/iMist}},
  url = {https://github.com/ElektroGandhi/iMist},
  urldate = {2026-11-06},
  note = {Awesome REA entry: \url{https://awesomerea.org/resources/imist-diffuser-case/}}
}

Plain text

iMist: local diffuser control from a reconstructed Bluetooth protocol. https://github.com/ElektroGandhi/iMist (accessed 2026-11-06). Awesome REA entry: https://awesomerea.org/resources/imist-diffuser-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 · ElektroGandhi/iMist · Revision 5700d85
docs/PROTOCOL.md GitHub · ElektroGandhi/iMist · Revision 5700d85