Repository Status	ESPHome S0tool discord Community

S0tool	Made for ESPHome program

S0tool	Dashboard

Dutch version

For the Dutch version look Here or on my website

How to order the S0tool ?

https://www.huizebruin.nl/shop
At this moment we only ship to : The Netherlands and België

If u cannot buy it u can make it on your own.

You need a couple of thinks
and place a resistor between the D2 and 5V.

Wemos D1 mini ep8266 Aliexpres or Amazon or dutch webshop Opencircuit

Npn Sensor Aliexpres or Amazon or dutch webshop Opencircuit

10K resistor Aliexpres or Amazon or dutch webshop Opencircuit

And a usb cable and minimal a usb power adapter with 5v and 1A

Will it work with my meter check it out here. huizebruin#57

Update:

Datum	Information
05/05/2022	V2 is ready at my home for testing.
06/05/2022	From now you can flash the s0tool directly from your browser with a usb micro cable https://huizebruin.github.io/s0tool/
25/07/2022	Watercounter gives now you Liters every 2 seconds a update to Home Assistant.
04/08/2022	Text translate on Github to English and Dutch.
10/09/2022	Flash page updated now options --> standard / watermeter / 1000imp puls / 2000imp puls .
29/10/2022	Ad watermeter sensor to energy dashboard.
12/11/2022	Fix for watermeter total and watermeter meter counter numbers.
14/11/2022	Fix for watermeter now works with 2 pulses a liter choose 0.0005 and 1 puls a liter choose 0.001 default is 0.001.
18/11/2022	Fix for meter counter for the kWh and water, and some cleanup of the code.

Before update of the S0tool u should use, and above

Program	version
Home Assistant	v2022.11.1
ESPHome	v2022.10.1

Software update information at releases here on Github.

Hardware

Put the sensors ad your 🛒 Look what you need te have te use it.

5V Power and cable

Minimal a 5v 1A Bol.com
usb kabel Bol.com or opencircuit.nl

Or a 5v 2.5A with cable Opencircuit.nl or at Bol.com.

For the water counter

a NPN sensor - Aliexpress or Aliexpress or Aliexpress or in Nederland at Opencircuit.nl
(use npn sensor for 5V not that one thats higher than 6V !!)
I am using the LJ18A3-8-Z/BX-5V

NPN sensor to the S0tool

Cyble sensor V2 to the S0tool

Here u must add a 10K Ohm resistor between the GND and D2

Soon also a sensor for Elster V100 kogelvorm meter for the S0tool at my shop.

For More information about the S0tool look at my Website.

Watermeter to energy dashboard.

From Home Assistant version 2022.11.X it is possible to add the water meter to the energy dashboard with the S0tool from version v22.10.20.

Enegry dashboard	Dashboard

For keeping track of solar panels or heat pump etc.

45A kWh meter with 1000 pulses at kWh Bol.com
40A kWh meter with 2000 pulses at kWh Bol.com
32A kWh meter with 2000 pulses at kWh Amazon
40A kWh meter with 1000 pulses at kWh Amazon

2000 pulses per kWh are given. This means that each plus has a value of 1/2000 = 0.0005 kWh 1000 pulses per kWh are given. This means that each plus has a value of 1/1000 = 0.001 kWh

2000 imp/kWh : gives 2,000 impulses per kWh. is therefore more accurate to do a measurement than the 1000 imp/KWh The more energy you consume or supply back, the faster it will switch.

The s0 connection

How to put it to your setup

There is a small error in v1, in the s0 connection is the GND I.P.V 5v+.

Since 01-07-2022 only V2 is sent out.

Installation:

First you must have installed the CH340 drivers for the wemos d1 to communicate to your pc / laptop .

Go to this link to install the drivers ch340. https://sparks.gogo.co.nz/ch340.html

06/05/2022:
Now also possible to flash the s0tool directly via the browser.
Only possible with a chrome or edge and opera browser.
Connect the s0tool to your PC/laptop with a USB cable and start the procedure. https://huizebruin.github.io/s0tool/

Install Home Assistant & Esphome .
Connect the wemos d1 mini to a USB charger.
Go to ssid: S0tool & password: s0watermeter
Go to 192.168.4.1.
Put the correct SSID and Password in the fields
Wait until it is ready, and then it will indicate the address where it can be found (put it in your router)
Go to your Home Assistant installation, it will report that a new device has been connected. And add this.
If all goes well, the print will connect to Github to download the latest version, and thereby also add it to Esphome
Create a folder in your config folder via explorer and name it utility_meter and put another text file in it and rename it to utility.yaml, and add the code below. And save it (or download it from this repro) and put it in that folder. (Code that is under 10)
Add the following code to your configuration.yaml
utility_meter: !include utility_meter/utility.yaml

#utility_meter:
### watermeter  S0 meter
  waterverbruik_kwartier:
    source: sensor.watermeter_totaal
    cycle: quarter-hourly
  waterverbruik_per_uur:
    source: sensor.watermeter_totaal
    cycle: hourly
enz...

Those in the file are in the folderutility_meter/utility.yaml

Optionally to see if there are new updates, you can create the following sensor in your configuration.yaml:
(or you copy the sensor file from the sensor folder and put it all in your own configuration).

#sensor: # get away if this is your first sensor
  - platform: rest
    resource: https://api.github.com/repos/huizebruin/s0tool/releases/latest
    name: s0tool_versie_github
    value_template: '{{ value_json.tag_name }}'

You can then compare this version with the entity "sensor.s0tool_versie".
These 2 are also in the sensor folder on this Github.

Restart Home Assistant one more time to add everything to your Lovelace screen.
Add this card to automatically get an update on your dashboard, so you know if you are using the latest version.

type: conditional
conditions:
  - entity: sensor.s0tool_gelijk_github
    state_not: 'True'
card:
  type: markdown
  content: The s0tool is not up to date with the GitHub version.

Blueprint for update notifications.

With this you can create an automation that will notify you when a new version is online on Github. You must have added all the above sensors.

Adjusting the meter reading

To adjust the water meter position:

To adjust your kWh meter reading:

Or this option and then search for the right meter and then adjust,
here you can update all meter readings:

Update function

04-08-2022 :
I'm working on a feature to keep this tool always up to date with the latest version on github. This can be done by the ESPHome dashboard by now.

Have fun with this tool.
Any additions / improvements
may be made via Pull requests be supplemented.
Or viaissues requested or added.

Wobbe from Huizebruin.nl

For more information and connection diagrams, etc., take a look at the website.

To cooperate.

This is an active open source project.
We are always open to people who want to use or contribute to the code.

Who else is working on this project :

License

MIT License

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

Make money with your site. Start now, sign up here.

zjean / s0tool