ESPHome-based salt level monitor for water softener brine tanks using M5Stack ATOM hardware and VL53L0X ToF sensor.
⚠️ Requirements:
Chrome or Edge browser (Web Serial required)
USB-C cable to connect device to computer
M5Stack ATOM S3 Lite or ATOM Lite with VL53L0X ToF sensor
Installation Steps
1Connect Device
Connect your M5Stack ATOM device to your computer via USB-C cable
2Flash Firmware
Choose your hardware and click the button to install
M5Stack ATOM Lite
ESP32-PICO-D4 • ESP-IDF framework • Web server enabled
M5Stack ATOM S3 Lite
ESP32-S3 • Arduino framework • Web server disabled
Note (Mac users): Chrome may crash at 100% - this is ok, read on
If Chrome crashes when installation reaches 100%, the firmware has been successfully installed. Simply unplug and replug the device to continue.
3Configure WiFi
Using Home Assistant app:
Open Home Assistant app → Settings → Devices → Add Device
Select "ESPHome" and enter WiFi credentials when prompted
4Add to Home Assistant
Device will be auto-discovered. Go to Settings → Devices & Services and add the ESPHome device.
5Configure Tank Settings
In Home Assistant, go to the device page and adjust tank height, thresholds, and update interval in the Configuration section.