Skip to content

r0bb10/ESPHome-Microdoser

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

8 Commits
 
 
 
 
 
 

Repository files navigation

Microdoser for ESPHome

Microdoser is a minimal, reliable, and expandable peristaltic dosing system for aquariums and automated liquid control — built as a native ESPHome external component.

It is designed to work entirely offline, without relying on Home Assistant or the cloud for scheduling or logic. Based on ideas and code from Digital-Pump, Aquapi, and RTC_Scheduler.

Features (Alpha Stage)

  • Real-Time Clock (DS3231) based daily scheduling
  • Per-pump dose scheduling with multiple time slots
  • EEPROM tracking of completed doses
  • Calibration system using ml/sec and persistent storage
  • Shared calibration and prime control across pumps
  • Optional safety watchdog for late/missed dose prevention
  • Designed to run fully offline, even if HA is down
  • YAML configuration with minimal surface and no HA dependency

Safety and Watchdog

  • Stable runtime behavior confirmed
  • Persistent calibration and dose tracking
  • Safe offline operation by design
  • Reboots do not trigger repeat dosing
  • Late missed doses are skipped if too old
  • Set watchdog: off to allow recovering late doses
  • Default watchdog: strict skips old missed doses safely

About

Offline-capable peristaltic dosing system for ESPHome, with RTC scheduling, flash persistence, and modular pump control via I²C.

Resources

Stars

Watchers

Forks

Contributors