Water usage tracking - Revision history

Antonin: /* Updating the firmware */ fix markup

2025-07-06T05:29:44Z

Updating the firmware: fix markup

← Older revision		Revision as of 07:29, 6 July 2025
Line 24:		Line 24:
	== Updating the firmware ==		== Updating the firmware ==

	The firmware can be updated in two ways: * either via the web interface * or by flashing the device directly, using a USB-to-Serial adapter. We have one in the electronics workshop for this.		The firmware can be updated in two ways:
			* either via the web interface
			* or by flashing the device directly, using a USB-to-Serial adapter. We have one in the electronics workshop for this.

	To flash via USB, the connections look like this: [[File:../images/water_meter_reader_ftdi.jpg\|Connecting a FTDI adatper to flash the firmware]]		To flash via USB, the connections look like this: [[File:../images/water_meter_reader_ftdi.jpg\|Connecting a FTDI adatper to flash the firmware]]
Line 32:		Line 34:
	<pre>esptool.py erase_flash		<pre>esptool.py erase_flash
	esptool.py write_flash 0x01000 bootloader.bin 0x08000 partitions.bin 0x10000 firmware.bin</pre>		esptool.py write_flash 0x01000 bootloader.bin 0x08000 partitions.bin 0x10000 firmware.bin</pre>

	== Training the digitizer ==		== Training the digitizer ==

Antonin: /* Network settings */ fix markup

2025-07-06T05:29:18Z

Network settings: fix markup

← Older revision		Revision as of 07:29, 6 July 2025
Line 14:		Line 14:
	== Network settings ==		== Network settings ==

	The devices are connected to the <code>kh-iot</code> WiFi network, which means it has limited network access. Their IP addresses are static: * <code>192.168.5.37</code> for the main water meter * <code>192.168.5.38</code> for the warm water meter		The devices are connected to the <code>kh-iot</code> WiFi network, which means it has limited network access. Their IP addresses are static:
			* <code>192.168.5.37</code> for the main water meter
			* <code>192.168.5.38</code> for the warm water meter

	To access its web UI connect to the <code>kh-admin</code> network and go to <code>http://192.168.5.37/</code> (or <code>http://192.168.5.38/</code> for the warm water meter). If you are outside of Kanthaus, use SSH port forwarding via kanthaus-server, such as <code>ssh -L 8080:192.168.5.37:80 kanthaus-server</code>, and then point your browser to <code>http://localhost:8080/</code>.		To access its web UI connect to the <code>kh-admin</code> network and go to <code>http://192.168.5.37/</code> (or <code>http://192.168.5.38/</code> for the warm water meter). If you are outside of Kanthaus, use SSH port forwarding via kanthaus-server, such as <code>ssh -L 8080:192.168.5.37:80 kanthaus-server</code>, and then point your browser to <code>http://localhost:8080/</code>.

Janina at 08:55, 29 January 2025

2025-01-29T08:55:27Z

← Older revision		Revision as of 10:55, 29 January 2025
Line 47:		Line 47:

	For debugging purposes it is useful to use the USB-to-Serial adapter to see detailed logs. First, connect the adapter to the device (by crossing the RX/TX wires and connecting GND and +5V). Then, locate the USB-to-Serial adapter by listing the USB devices before and after plugging in. Once you have the path to the device, you can then open it with: <code>screen /dev/ttyUSB0 115200</code>. If screen terminates immediately you might need to add your user to the <code>dialout</code> group, see [https://docs.espressif.com/projects/esp-idf/en/latest/esp32/get-started/establish-serial-connection.html the detailed instructions for serial communication with ESP32].		For debugging purposes it is useful to use the USB-to-Serial adapter to see detailed logs. First, connect the adapter to the device (by crossing the RX/TX wires and connecting GND and +5V). Then, locate the USB-to-Serial adapter by listing the USB devices before and after plugging in. Once you have the path to the device, you can then open it with: <code>screen /dev/ttyUSB0 115200</code>. If screen terminates immediately you might need to add your user to the <code>dialout</code> group, see [https://docs.espressif.com/projects/esp-idf/en/latest/esp32/get-started/establish-serial-connection.html the detailed instructions for serial communication with ESP32].
			[[Category:Technical]]

Worldsdweller: Emoji preservation efforts.

2024-10-18T14:19:29Z

Emoji preservation efforts.

← Older revision		Revision as of 16:19, 18 October 2024
Line 1:		Line 1:
	~~<nowiki>:</nowiki>droplet:~~ We log our water usage over time in [[Grafana]]. To do so, we have two small devices next to our main water meter and warm water meter respectively. They periodically read the meter by taking a picture and recognizing digits in it (currently every 5 minutes). This page describes how those devices are set up, how to maintain them and how to install similar ones elsewhere.		💧 We log our water usage over time in [[Grafana]]. To do so, we have two small devices next to our main water meter and warm water meter respectively. They periodically read the meter by taking a picture and recognizing digits in it (currently every 5 minutes). This page describes how those devices are set up, how to maintain them and how to install similar ones elsewhere.
	[[File:Water meter reader.jpg\|thumb]]		[[File:Water meter reader.jpg\|thumb]]

Doug: Doug moved page Water to Water usage tracking

2024-10-16T08:42:43Z

Doug moved page Water to Water usage tracking

← Older revision	Revision as of 10:42, 16 October 2024
(No difference)

Doug: Post-migration cleanup

2024-10-16T08:42:35Z

Post-migration cleanup

← Older revision		Revision as of 10:42, 16 October 2024
Line 1:		Line 1:
	= :droplet: ~~Water usage tracking =~~		<nowiki>:</nowiki>droplet: We log our water usage over time in [[Grafana]]. To do so, we have two small devices next to our main water meter and warm water meter respectively. They periodically read the meter by taking a picture and recognizing digits in it (currently every 5 minutes). This page describes how those devices are set up, how to maintain them and how to install similar ones elsewhere.
			[[File:Water meter reader.jpg\|thumb]]
	We log our water usage over time in [[~~../digital/grafana.md\|~~Grafana]]. To do so, we have two small devices next to our main water meter and warm water meter respectively. They periodically read the meter by taking a picture and recognizing digits in it (currently every 5 minutes). This page describes how those devices are set up, how to maintain them and how to install similar ones elsewhere.

	[[File:~~../images/water_meter_reader~~.jpg\|thumb~~\|none\|alt=Overview of the water meter reader\|Overview of the water meter reader~~]]

	== Overview ==		== Overview ==

HandbookMigration2024: "migration of handbook pages from https://git.kanthaus.online/kanthaus/handbook"

2024-10-15T10:56:31Z

"migration of handbook pages from https://git.kanthaus.online/kanthaus/handbook"

New page

= :droplet: Water usage tracking =

We log our water usage over time in [[../digital/grafana.md|Grafana]]. To do so, we have two small devices next to our main water meter and warm water meter respectively. They periodically read the meter by taking a picture and recognizing digits in it (currently every 5 minutes). This page describes how those devices are set up, how to maintain them and how to install similar ones elsewhere.

[[File:../images/water_meter_reader.jpg|thumb|none|alt=Overview of the water meter reader|Overview of the water meter reader]]

== Overview ==

The device is an ESP32-CAM board with an OV2640 camera module. It can be obtained from many suppliers (we use [https://arduino-projekte.info/produkt/esp32-cam-mit-ov2640-kamera-modul/ this one]). The software on the device is the [https://github.com/jomjol/AI-on-the-edge-device AI-on-the-edge-device] firmware, which does the digitization and upload to InfluxDB directly from the board itself. General documentation for this firmware is available on [https://github.com/jomjol/AI-on-the-edge-device/wiki its GitHub wiki], this document focuses on the Kanthaus-specific parts.

== Setting up the device ==

First, we need a power source (5V DC) for the board. We have plenty of such adapters in the electronics workshop, all that is needed is to solder the appropriate connectors to plug the power source to the board. The camera that comes with the device is set up for a focal length that is not adapted to this use, so we need to rotate the objective to obtain a sharp image of the meter at a close distance. This requires [https://github.com/jomjol/AI-on-the-edge-device/wiki/Installation removing the glue which holds the objective in place]. This step is quite fiddly, do not bring the lens too close to the sensor either or you could break the camera. The device comes with a default firmware which lets you stream from the camera over WiFi, which helps with checking the sharpness as you make changes. To do so, connect the device to a power source and connect to the WiFi network it creates. Then, go to <code>http://192.168.4.1/</code> and you are able to stream directly from the device’s camera.

The devices use by default an internal WiFi antenna which is not very strong. It is very advisable to use the external antenna instead, but that requires unsoldering a very small resistor and soldering it in another position, which requires some skill.

== Network settings ==

The devices are connected to the <code>kh-iot</code> WiFi network, which means it has limited network access. Their IP addresses are static: * <code>192.168.5.37</code> for the main water meter * <code>192.168.5.38</code> for the warm water meter

To access its web UI connect to the <code>kh-admin</code> network and go to <code>http://192.168.5.37/</code> (or <code>http://192.168.5.38/</code> for the warm water meter). If you are outside of Kanthaus, use SSH port forwarding via kanthaus-server, such as <code>ssh -L 8080:192.168.5.37:80 kanthaus-server</code>, and then point your browser to <code>http://localhost:8080/</code>.

The network settings for the device can be changed by taking out the SD card in it and modifying the <code>wlan.ini</code> file on the card.

== Updating the firmware ==

The firmware can be updated in two ways: * either via the web interface * or by flashing the device directly, using a USB-to-Serial adapter. We have one in the electronics workshop for this.

To flash via USB, the connections look like this: [[File:../images/water_meter_reader_ftdi.jpg|Connecting a FTDI adatper to flash the firmware]]

Flashing the device requires three binary files, which can be copied to device using <code>esptool.py</code> (which can be installed with <code>pip install esptool</code>):

<pre>esptool.py erase_flash
esptool.py write_flash 0x01000 bootloader.bin 0x08000 partitions.bin 0x10000 firmware.bin</pre>
== Training the digitizer ==

Before the device can read the meter, it needs to be calibrated. This would need to be done again for instance when our water meter is renewed. This can be done from the web UI directly. Refer to [https://github.com/jomjol/AI-on-the-edge-device/wiki/Graphical-configuration the official documentation] for more details about the process.

== Development environment ==

The [https://github.com/jomjol/AI-on-the-edge-device/wiki/Build-Instructions official documentation] recommends to use VSCode with the PlatformIO extension to develop, but sadly PlatformIO is not available for VSCodium at the time of writing this. Instead you can relatively easily work with a text editor, and install [https://platformio.org/ PlatformIO] in a Python virtualenv (from the <code>code/</code> subdirectory of the repository):

<pre>python3 -m venv .venv
source .venv/bin/activate
pip install platformio esptool</pre>
and then you can compile the firmware with

<pre>platformio run --environment esp32cam</pre>
This generates the three <code>.bin</code> files required for flashing in the <code>.pio/build/esp32cam</code> subdirectory.

For debugging purposes it is useful to use the USB-to-Serial adapter to see detailed logs. First, connect the adapter to the device (by crossing the RX/TX wires and connecting GND and +5V). Then, locate the USB-to-Serial adapter by listing the USB devices before and after plugging in. Once you have the path to the device, you can then open it with: <code>screen /dev/ttyUSB0 115200</code>. If screen terminates immediately you might need to add your user to the <code>dialout</code> group, see [https://docs.espressif.com/projects/esp-idf/en/latest/esp32/get-started/establish-serial-connection.html the detailed instructions for serial communication with ESP32].