Troubleshooting

Common issues and solutions. Also check the GitHub README.

Updating via ESPHome

1. Open the ESPHome add-on in Home Assistant.
2. Find your S0tool, click the three dots.
3. Select Validate, then Install.

USB Drivers

Energy Dashboard

From HA 2022.11, add your data to the Energy Dashboard (S0tool 3.0.*).

Water consumption

• Search for watermeter Totaal and add it under Water consumption.

Water flow New in v3.6.9New in HA 2026.3.0

• Since S0tool v3.6.9 you can also add the water flow sensor to the dashboard.
• Search for watermeter flow and add it under Water flow (Waterdoorstroom).


• If Home Assistant shows a unit warning (unit changed warning), choose "Change historical values from 'l/min' to 'L/min' without conversion" and click Repair.

S0 port (kWh / solar)

• Search for Totaal opgebracht and add it under the relevant energy category.
• Search for Actuele energie and add it under the relevant energy category.

Individual electrical devices

• If you use the s0tool s0 port for a other purpose, you can add individual electrical devices to the Energy Dashboard.
• Search for Totaal opgebracht and add it under the relevant energy category.
• Search for Actuele energie and add it under the relevant energy category.

Changing Total Readings

•   Water Counter — D2
•   S0 Port / kWh — D5
•   Calibration service call

Compatible Water Meters

Know a compatible meter? Add it via Community →

Advanced & Problems

S0tool is adoptable in the ESPHome dashboard.

Submit a Pull Request or open an Issue. More info (Dutch) at huizebruin.nl.