Home

my-flo

Notes on the iFLO bottle-dosing dispenser (ESP32-S2) and an ESPHome configuration that runs it locally under Home Assistant, with the unit working standalone if Home Assistant is unavailable.

Disclaimer

The code (the ESPHome configuration and its Docker setup) and the notes on these pages were produced by Claude, Anthropic's AI assistant, working with the repository owner. Nothing here has been tested on hardware yet, so treat every pin assignment and behavior as unverified until it is confirmed on a real unit. Driving the valve incorrectly could damage the hardware; use this at your own risk.

Pages

• Device Overview — what the device is, hardware and firmware versions
• Network Protocol — onboarding API and cloud registration API
• Hardware GPIO Map — pin assignments, valve driver, battery ADC
• Board and Connectors — PCB photos, connectors, UART/boot pads
• Power and Sleep — wake sources and sleep behavior
• ESPHome Replication Plan — design and status of the ESPHome config
• Flashing and Recovery — backing up and restoring the unit
• Open Tasks — what is still missing