WaterP1MeterKit is the first and only solution that combines P1 energy meter reading and water meter monitoring in a single device — with support for WiFi, Ethernet, and PoE!
🎉 As the very first water meter kit ever made for Home Assistant, we are the best choice for measuring your water meter and/or energy meter. 100% local, open-source, and built for Home Assistant users!
| Feature | WaterP1MeterKit |
|---|---|
| 📊 Dual Monitoring | Measure both P1 energy AND water simultaneously — or choose just one |
| 🌐 Triple Connectivity | WiFi, Ethernet, and PoE support (V2+) |
| 🏠 100% Local | No cloud, no subscriptions — runs entirely on your Home Assistant |
| 🔌 Single Device | No need for separate energy and water monitors |
- 🔄 Flexible monitoring: Choose to monitor only energy, only water, or both at the same time with a single kit!
- ⚡ P1 Energy monitoring: Full DSMR support (2.2 - 5.0) — consumption, production, voltage, current, gas
- 💧 Water monitoring: Real-time water flow (L/min) and total consumption (m³)
- 🌡️ Environment sensors: Temperature and humidity monitoring (HDC1080)
- 🌐 WiFi + Ethernet + PoE: Choose your preferred connectivity (PoE on V2+)
- 🔒 Fully local: No cloud required — works offline with Home Assistant
- 📦 Pre-flashed: Comes ready to use with WiFi firmware out of the box
- 🔧 Expansion port: V3 supports water leak sensor or door sensor add-ons
Learn more on our website: https://waterp1meterkit.nl/en
The WaterP1MeterKit stores your water consumption persistently — your meter reading survives reboots and firmware updates!
| Sensor | Description |
|---|---|
| Water Total Consumption | Raw pulses since boot (resets on reboot) - Use this for Energy Dashboard! |
| Water Meter Initial Value | Set your current physical meter reading (input field) |
| Water Meter Total | Initial Value + Total Consumption = Your actual meter reading |
- Read your physical water meter (e.g.,
125.500 m³) - Enter this value in Water Meter Initial Value in Home Assistant
- Water Meter Total will now show your actual meter reading and track all usage
💡 Energy Dashboard: Keep using
Water Total Consumption- it works perfectly! Home Assistant tracks the history even when it resets on reboot.💡 Actual meter reading: Use
Water Meter Totalto see your real water meter value (matches your physical meter).
The kit uses smart saving to protect flash memory while keeping your data safe:
| Trigger | When? | Always saves? |
|---|---|---|
| Interval check | Every 5 minutes | Only if 50+ liters difference |
| Shutdown | OTA, restart, factory reset | ✅ Always |
💡 Why 50 liters? A typical faucet uses 6-10 L/min. In 5 minutes that's ~30-50 liters. This threshold ensures your data is saved at least once during normal water usage while protecting flash memory for long device lifetime.
The kit saves your meter reading:
- Every 5 minutes (if 50+ liters used since last save)
- On every shutdown (OTA, restart, factory reset)
| Scenario | Water Meter Total |
Max Loss |
|---|---|---|
| OTA firmware update | ✅ Saved before reboot | 0 L |
| Manual restart | ✅ Saved before reboot | 0 L |
| Factory reset | ✅ Saved before reset | 0 L |
| Power outage | ~50 L |
📊 Perspective: 50 liters on a yearly consumption of ~40,000+ liters is just 0.1%. For most households, occasional power outages will have negligible impact on accuracy.
We have 3 hardware versions, each with WiFi and Ethernet firmware variants:
| Feature | V1 | V2 | V3 |
|---|---|---|---|
| WiFi | ✅ | ✅ | ✅ |
| Ethernet | ✅ | ✅ | ✅ |
| PoE | ❌ | ✅ | ✅ |
| Water Sensor | Fixed | Fixed | Detachable |
| Expansion Port | ❌ | ❌ | ✅ |
| Improved Precision | - | - | ✅ |
See the README in each version folder for detailed specifications.
- Hardware: Connect power (USB-C or PoE for V2/V3)
- Connect: All devices come pre-flashed with WiFi firmware out of the box
- Onboarding: WiFi builds support captive portal for easy setup
- Switch to Ethernet: After connecting to Home Assistant, you can easily switch to Ethernet firmware using a simple switch in the device settings
📺 Installation videos available on YouTube for popular water meters: Sensus, Itron, Actaris, Schlumberger, Elster, and Honeywell.
For full documentation see our quick start guide: https://smarthomeshop.io/quick-start-waterp1meterkit
waterp1meterkit/
├── waterp1meterkit-v1/ # V1 ESPHome configurations
│ ├── base.yaml # Shared configuration
│ ├── waterp1meterkit-wifi.yaml
│ └── waterp1meterkit-ethernet.yaml
├── waterp1meterkit-v2/ # V2 ESPHome configurations (+ PoE)
│ ├── base.yaml
│ ├── waterp1meterkit-wifi.yaml
│ └── waterp1meterkit-ethernet.yaml
├── waterp1meterkit-v3/ # V3 ESPHome configurations (+ detachable sensor)
│ ├── base.yaml
│ ├── waterp1meterkit-wifi.yaml
│ └── waterp1meterkit-ethernet.yaml
├── .github/workflows/ # CI to build and publish firmware to gh-pages
└── images/
Pre-built firmware is available on the gh-pages branch:
- V1 WiFi:
waterp1meterkit-v1-wifi-manifest.json - V1 Ethernet:
waterp1meterkit-v1-ethernet-manifest.json - V2 WiFi:
waterp1meterkit-v2-wifi-manifest.json - V2 Ethernet:
waterp1meterkit-v2-ethernet-manifest.json - V3 WiFi:
waterp1meterkit-v3-wifi-manifest.json - V3 Ethernet:
waterp1meterkit-v3-ethernet-manifest.json
PRs and issues are welcome. Please keep changes modular and follow ESPHome best practices.
- 🌐 Product info and guides: https://waterp1meterkit.nl/en
- 🛒 Store: https://smarthomeshop.io
- 💬 Community & support (Discord): https://smarthomeshop.io/discord
This project is released under the MIT License (see LICENSE).