Frequently Asked Questions
Find answers to the most common questions about the WaterFlowKit.
Installation & Setup
1. How do I install the WaterFlowKit?
The WaterFlowKit requires inline installation on your water pipes:
- Turn off water supply to the pipe you want to monitor
- Cut or disconnect the pipe where you want to install the sensor
- Install the flow sensor using the appropriate fittings
- Apply thread seal tape (PTFE tape) to ensure watertight connections
- Connect the sensor cable to the WaterFlowKit
- Power on and connect to WiFi
See the Installation Guide for detailed steps with images.
⚠️ Important: Ensure all connections are properly sealed. We are not responsible for water leaks caused by improper installation.
2. How do I connect the WaterFlowKit to my WiFi network?
Upon starting up, the WaterFlowKit creates a WiFi hotspot:
- Network name:
waterflowkit - Password:
waterflowkit
Connect to this hotspot and follow the on-screen instructions to select your home WiFi network.
Captive portal not opening? Navigate to http://192.168.4.1/ manually in your browser.
3. Which sensor size do I need?
Choose based on your pipe diameter:
| Sensor Model | Thread | Pipe Diameter | Flow Range | Material Options |
|---|---|---|---|---|
| YF-B1 / YF-B7 | G1/2" | ~15mm (DN15) | 1–25 L/min | Brass or Stainless Steel |
| YF-B5 / YF-B6 | G3/4" | ~20mm (DN20) | 1–30 L/min | Brass or Stainless Steel |
| YF-B10 | G1" | ~25mm (DN25) | 1–50 L/min | Brass or Stainless Steel |
| YF-DN40-S | G1½" | ~40mm (DN40) | 5–150 L/min | Stainless Steel only |
| YF-DN50-S | G2" | ~50mm (DN50) | 10–200 L/min | Stainless Steel only |
💡 Tip: Measure your pipe's outer diameter or check existing fittings to determine the correct size.
4. Brass or Stainless Steel — which material should I choose?
All our sensors are available in both Brass and Stainless Steel. Choose based on your application:
Brass (Messing)
- ✅ Robust and affordable
- ✅ Suitable for most household applications
- ✅ Good corrosion resistance
- ✅ Lower cost option
- Best for: Standard home use, hot/cold water, heating systems
Stainless Steel (RVS)
- ✅ Food-safe and hygienic
- ✅ Superior durability and corrosion resistance
- ✅ Recommended for drinking water
- ✅ Longer lifespan in demanding conditions
- Best for: Drinking water, food/beverage, pools, industrial, extra hygiene needs
💡 For most home applications (kitchen, bathroom, heating), Brass sensors are perfectly suitable and more affordable. Choose Stainless Steel when hygiene, durability, or food-safety is important.
6. Do I need the temperature sensor?
The temperature sensor is optional. It's included with:
- YF-B7 (G1/2" with temperature)
- YF-B6 (G3/4" with temperature)
Useful for:
- Monitoring hot water systems
- Heat pump efficiency monitoring
- Solar water heater efficiency
- Detecting hot/cold water mixing issues
How It Works
7. How do the flow sensors measure water?
The sensors use a turbine mechanism:
- Water flows through the sensor
- The flow spins an internal turbine
- The turbine generates electrical pulses
- The WaterFlowKit counts pulses to calculate flow rate
- Each pulse = a specific volume of water (varies by sensor model)
8. How accurate are the flow sensors?
| Sensor | Accuracy |
|---|---|
| YF-B1, YF-B5, YF-B6, YF-B7 | ±3% |
| YF-B10 | ±5% |
| YF-DN40-S, YF-DN50-S | ±3% |
Accuracy depends on:
- Proper installation (avoid air bubbles)
- Flow within the sensor's rated range
- Calibration if needed
9. Can I calibrate the sensors?
Yes! If readings seem off, you can adjust the pulses per liter value in ESPHome:
- Adopt the device in ESPHome
- Find the pulse sensor configuration
- Adjust the
pulse_meterfilter value - Save and install
See Usage Guide — Calibration for details.
Sensor Configuration
10. Can I use two flow sensors at once?
Yes! The WaterFlowKit supports up to 2 flow sensors simultaneously. Perfect for:
- Monitoring hot and cold water lines separately
- Tracking water in vs water out
- Multiple appliance monitoring
11. What if I only use one sensor?
Simply disable the unused sensor entities in Home Assistant:
- Go to Settings → Devices & Services → ESPHome
- Select your WaterFlowKit
- Find the unused sensor entities
- Click on each and toggle Enabled off
12. Can I extend the sensor cable?
The sensor cable is 1 meter long. Extending is possible but:
- Use shielded cable to prevent interference
- Keep extensions as short as possible
- Longer cables may affect accuracy
⚠️ Note: Cable modifications are at your own risk and not covered by warranty.
Power & Connectivity
13. Does the WaterFlowKit require internet access?
No! The WaterFlowKit works 100% locally on your network.
100% Local Operation
All sensor data stays on your local network:
| Data | Where |
|---|---|
| ✅ Flow rate | Local |
| ✅ Temperature | Local |
| ✅ Total volume | Local |
| ✅ Home Assistant communication | Local |
External Communication
The only external communication is for firmware update checks:
| What | Where | Why |
|---|---|---|
| Version check | ESPHome/GitHub | Check if new firmware is available |
No sensor data is ever sent externally.
14. My WaterFlowKit keeps disconnecting from WiFi
Try these solutions:
- Check WiFi signal strength at the installation location
- Use a WiFi extender if signal is weak
- Ensure your router uses 2.4 GHz (5 GHz not supported)
- Check for interference from other devices
Home Assistant Integration
15. How do I add the WaterFlowKit to Home Assistant?
Once connected to WiFi, Home Assistant automatically discovers the WaterFlowKit under Settings → Devices & Services.
If not discovered automatically:
- Go to Settings → Devices & Services
- Click Add Integration → ESPHome
- Enter the device's IP address
16. Which entities should I add to the Energy Dashboard?
For the Energy Dashboard, use:
- Water Flow Sensor 1 Total — Total volume from sensor 1
- Water Flow Sensor 2 Total — Total volume from sensor 2 (if used)
Note: The Energy Dashboard requires cumulative totals, not instantaneous flow rates.
Waterproofing & Safety
17. Is the WaterFlowKit waterproof?
Partially:
| Component | Rating | Meaning |
|---|---|---|
| Flow sensors | IP52 | Protected against dust and light moisture/splashing |
| Main unit | IP20 | Indoor use only, not water resistant |
⚠️ Important: The main unit must be kept dry. Water damage is not covered by warranty.
18. How do I prevent leaks?
- Always use thread seal tape (PTFE tape) on threaded connections
- Tighten fittings firmly but don't overtighten
- Pressure test before final installation
- Check connections after 24 hours
- The temperature sensor fitting may require extra tightening
Comparison with Other Products
19. What's the difference between WaterFlowKit and WaterMeterKit?
| Feature | WaterFlowKit | WaterMeterKit |
|---|---|---|
| Purpose | Monitor individual pipes | Monitor main water meter |
| Installation | Inline (requires plumbing) | Non-invasive (on meter dial) |
| Sensors | Up to 2 flow sensors | 1 optical sensor |
| Temperature | Optional (select models) | No |
| Flow rate | Yes (L/min) | No |
| Total volume | Yes | Yes |
| Best for | Specific water points | Total home consumption |
20. Can I use both WaterFlowKit and WaterMeterKit?
Yes! They complement each other:
- WaterMeterKit on your main meter for total consumption
- WaterFlowKit on specific pipes for detailed monitoring
Firmware & Updates
21. How do I update the firmware?
Updates can be done via:
- ESPHome Addon: Adopt the device and click Update
- USB-C: Flash via web flasher
See Firmware Guide for details.
22. Is the firmware open source?
Yes! The complete ESPHome configuration is available on GitHub.
Warranty & Support
23. What is the warranty period?
The WaterFlowKit comes with a one-year warranty from the date of purchase. See Warranty and Support for details.
24. Are water leaks covered by warranty?
No. We are not responsible for water leaks caused by installation. Ensure all connections are properly sealed and tested before use.