Skip to content

jasonbwilliams/growbot

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Growbot

A Home Assistant custom integration (installable via HACS) that bridges growbot ESPHome Bluetooth proxies to the miflora plant sensors they detect.

What it does

  1. Discovers ESPHome devices whose name starts with growbot (via mDNS/zeroconf and the live Bluetooth scanner registry).
  2. Lets you multi-select which growbot proxies to integrate.
  3. For each selected growbot proxy, lists the Bluetooth devices whose name starts with miflora that that proxy has detected, and lets you select them.
  4. Exposes each selected miflora device as a set of plant sensors — soil moisture, temperature, conductivity (fertility), illuminance, and battery — nested in the device tree under the growbot proxy that sees them.

Requirements / how it works

This integration is a convenience layer on top of Home Assistant's built-in bluetooth and esphome integrations. It does not talk to the ESPHome devices directly; it reads the Bluetooth advertisements they relay.

Before adding it, for each growbot device you must:

  • Flash ESPHome firmware that enables the Bluetooth Proxy (bluetooth_proxy: + esp32_ble_tracker:), with a node/friendly name starting with growbot.
  • Add the device to Home Assistant via the ESPHome integration so it becomes a live Bluetooth scanner.

Once those proxies are online, miflora plant sensors in range are relayed to HA and this integration scopes them per-proxy using the advertisement source.

Installation (HACS)

  1. HACS → Integrations → ⋮ → Custom repositories → add this repo as an Integration.
  2. Install Growbot, then restart Home Assistant.
  3. Settings → Devices & Services → Add IntegrationGrowbot (or accept the zeroconf discovery prompt), and follow the wizard.

Notes & limitations

  • A config entry can hold multiple growbot proxies; each is registered as a hub device, with its miflora sensors nested beneath it (via_device).
  • Parsing uses the xiaomi-ble library, which handles genuine Xiaomi Flower Care (HHCCJCY01) devices. If your miflora* devices use a custom advertisement format, swap the parser in custom_components/growbot/coordinator.py (build_growbot_coordinator).
  • Battery and some realtime values require an active GATT connection through a connectable proxy; passive-only setups may not report them.

License

MIT — see LICENSE.

About

Home Assistant/HACS integration: growbot ESPHome Bluetooth proxies + miflora plant sensors

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages