From 8b84093ddc7a0195453a697fb49ef85c4cacdb95 Mon Sep 17 00:00:00 2001 From: "github-actions[bot]" Date: Sun, 13 Apr 2025 19:50:25 +0000 Subject: [PATCH] Deployed ec107cb with MkDocs version: 1.6.1 --- Choosing-the-Model/index.html | 192 ++++++++-------------------------- img/ana-class100.png | Bin 73081 -> 50277 bytes img/dig-class100.png | Bin 89653 -> 51048 bytes img/dig-class11.png | Bin 91384 -> 48724 bytes search/search_index.json | 2 +- 5 files changed, 46 insertions(+), 148 deletions(-) diff --git a/Choosing-the-Model/index.html b/Choosing-the-Model/index.html index 770438b..1dc955d 100644 --- a/Choosing-the-Model/index.html +++ b/Choosing-the-Model/index.html @@ -267,42 +267,13 @@ dig-class11 -
  • -1.1.2 +1.1.2 - dig-class100 / dig-cont + dig-class100 and dig-cont -
    • @@ -316,29 +287,11 @@ @@ -349,17 +302,6 @@ Different types of models (normal vs. quantized) - @@ -783,42 +725,13 @@ dig-class11 -
  • -1.1.2 +1.1.2 - dig-class100 / dig-cont + dig-class100 and dig-cont -
    • @@ -832,29 +745,11 @@ @@ -865,17 +760,6 @@ Different types of models (normal vs. quantized) - @@ -893,48 +777,62 @@

    This page tries to help you on which model to select. For more technical/deeper explanations have a look on Neural-Network-Types.

    1.1 Digit Models

    -

    For digits on water meters, gas-meters or power meters you can select between two main types of models.

    -

    1.1.1 dig-class11

    -

    This model can recognize full digits. It was the first model version. All intermediate states shown a "N" for not a number. But in post process it uses older values to fill up the "N" values if possible.

    +

    For digits on water meters, gas-meters or power meters you can select between two main types of models:

    + +

    1.1.1 dig-class11

    +

    This model can recognize full digits. It was the first model version. All intermediate states shown a N for not a number. But in post process it uses older values to fill up the N values if possible.

    -

    It's possibly a good fallback, if dig-cont/dig-class100 results are not good.

    -

    1.1.1.1 Main features

    +

    It's possibly a good fallback, if dig-cont or dig-class100 results are not good.

    +

    Main features:

    -

    1.1.2 dig-class100 / dig-cont

    -

    These models are used to get a continuous reading with intermediate states. To see what the models are doing, you can go to the Recognition page.

    +

    1.1.2 dig-class100 and dig-cont

    +

    These models are used to get a continuous reading with intermediate states. To see what the models are doing, you can go to the Recognition page of your device.

    -

    1.1.2.1 Main features

    +

    Main features:

    -

    Look here for a list of digit images used for the training.

    -

    1.1.2.2 dig-class100 vs. dig-cont

    -

    The difference is in the internal processing.

    -

    The dig-class100 is a standard classification model. Each tenth step is an output.

    -

    dig-cont uses two outputs and arctangent to get the result. You see very complicated.

    +

    The difference between dig-class100 and dig-cont is in the internal processing. +The dig-class100 is a standard classification model. Each tenth step is an output. +dig-cont uses two outputs and arctangent to get the result. You see very complicated.

    +
    +

    Note

    Try both models on your device and take the one that gives you the best results.

    +
    +

    Look here for a list of digit images used for the training.

    1.2 Analog pointer models

    -

    1.2.1 ana-class100 / ana-cont

    -

    For pointers on water meters use the analog models. You can only choose between ana-class100 and ana-cont. Both do mainly the same.

    +

    1.2.1 ana-class100 and ana-cont

    +

    For pointers on water meters use the analog models:

    -

    1.2.1.1 Main features

    +

    You can choose between two models:

    + +

    Both do mainly the same.

    +

    Main features:

    -

    Look here for a list of pointer images used for the training

    -

    1.2.1.2 ana-class100 vs. ana-cont

    -

    The difference is in the internal processing.

    +

    Again, the difference between ana-class100 and ana-cont is in the internal processing.

    +
    +

    Note

    Take the one that gives you the best results. Both models learn from the same data.

    +
    +

    Look here for a list of pointer images used for the training

    1.3 Different types of models (normal vs. quantized)

    The normally trained network is calculating with internal floating point numbers. The saving of floating point numbers naturally takes more space than an integer type. Often the increased accuracy is not needed. Therefore there is the option, to "quantize" a neural network. In this case the internal values are rescaled to integer values, which is called "quantization". The stored tflite files are usually much smaller and runs faster on the edgeAI-device. -Usually the models are distrusted therefore in both versions. They can be distinguished by a "-q" at the end of the logfile.

    -

    1.3.0.1 Example:

    +Usually the models are distrusted therefore in both versions. They can be distinguished by a q at the end of the logfile.

    +

    Example:

    diff --git a/img/ana-class100.png b/img/ana-class100.png index f7b7a9eecfb45889332718193ca3b6721cf19de1..08111f3ff9b5638550bd4b8513fffac094e0a977 100644 GIT binary patch literal 50277 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

    wC3n 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 literal 73081 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 R=752I(&E3wYD5fz{s)ar*~tI^ literal 89653 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�co;B8& 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 literal 91384 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

    l0UmLV!{-r|Xqjrs6W!vpvH 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 to the AI-on-the-edge-device project!

    This is the documentation. For the source code, please head to github.com/jomjol/AI-on-the-edge-device.

    Artificial intelligence based systems have been established in our everyday lives. Just think of speech or image recognition. Most of the systems rely on either powerful processors or a direct connection to the cloud for doing the calculations up there. With the increasing power of modern processors the AI systems are coming closer to the end user - which is usually called edge computing. Here this edge computing is brought into a practice-oriented example, where a AI network is implemented on a ESP32 device so: AI on the edge.

    "},{"location":"#key-features","title":"Key features","text":"
    • Tensorflow Lite (TFlite) integration - including easy to use wrapper
    • Inline image processing (feature detection, alignment, ROI extraction)
    • Small and cheap device (3x4.5x2 cm\u00b3, < 10 EUR)
    • Camera and illumination integrated
    • Web surface to administrate and control
    • OTA-Interface to update directly through the web interface
    • Full integration into Home Assistant
    • Support for Influx DB 1 and 2
    • MQTT
    • REST API
    "},{"location":"#idea","title":"Idea","text":""},{"location":"#hardware","title":"Hardware","text":""},{"location":"#web-interface","title":"Web interface","text":""},{"location":"#configuration-interface","title":"Configuration Interface","text":"

    Have fun in studying the new possibilities and ideas

    This is about image recognition and digitization, done totally on a cheap ESP32 board using artificial intelligence in form of convolutional neural networks (CNN). Everything, from image capture (OV2640), image preprocessing (auto alignment, ROI identification) all the way down to the image recognition (CNN structure) and result plausibility is done on a cheap 10 EUR device.

    This all is integrated in an easy to do setup and use environment, taking care for all the background processing and handling, including regular job scheduler. The user interface is an integrated web server, that can be easily adjusted and offers the data as an API in different options.

    The task to be demonstrated here is an automated readout of an analog water meter. The water consumption is to be recorded within a house automatization and the water meter is totally analog without any electronic interface. Therefore, the task is solved by regularly taking an image of the water meter and digitizing the reading.

    There are two types of CNN implemented, a classification network for reading the digit numbers and a single output network for digitize the analog pointers for the sub digit readings.

    This project is an evolution of the water-meter-system-complete, which uses ESP32-CAM just for taking the image and a 1GB-Docker image to run the neural network's backbone. Here everything is integrated in an ESP32-CAM module with 8MB of RAM and a SD card as data storage.

    "},{"location":"#additional-tutorials","title":"Additional Tutorials","text":"

    A lot of people created useful Youtube videos which might help you getting started. Here a small selection:

    • youtube.com/watch?v=HKBofb1cnNc
    • youtube.com/watch?v=yyf0ORNLCk4
    • youtube.com/watch?v=XxmTubGek6M
    • youtube.com/watch?v=mDIJEyElkAU
    • youtube.com/watch?v=SssiPkyKVVs
    • youtube.com/watch?v=MAHE_QyHZFQ
    • youtube.com/watch?v=Uap_6bwtILQ
    "},{"location":"Additional-Information/","title":"Additional Information","text":"

    The following links point to additional information in other repos:

    "},{"location":"Additional-Information/#digits","title":"Digits","text":"
    • Training the CNN neural network
    • Training and using a neural network to readout the value of a digit counter
    "},{"location":"Additional-Information/#analog","title":"Analog","text":"
    • Training and using a neural network to read out the value of an analog display
    • Training the CNN neural network
    "},{"location":"Alignment/","title":"Alignment References","text":"

    The alignment references are used in every round to re-align the taken image to the reference coordinates. Two alignment structures must be defined and the taken image then in each round is shifted and rotated according to their position with the target to be in exactly the same position as the reference image.

    Note

    The alignment structures needs to be unique and have a good contrast. It is advised to have them as far apart as possible.

    "},{"location":"Alignment/#precondition","title":"Precondition","text":"

    Please make sure to have setup your camera properly and taken a good Reference Image.

    "},{"location":"Alignment/#define-two-reference-images","title":"Define two Reference Images","text":"

    You can switch between this two marks with (1).

    Then define the reference area in the image by either directly drag and drop with the mouse or use the input boxes below. To apply the currently marked image part you need to push \"Update Reference\" (2).

    In some cases it might be useful to use a reference with a higher contrast. This can be achieved by pushing Enhance Contrast\" (3). The result will be calculated on the ESP32 - so be a bit patient, before you see it active.

    To save push \"Save to config.ini\" (4).

    Note

    A reboot is not required at this point of time.

    As next you should define the Digit and Analog ROIs.

    "},{"location":"Best-Practice/","title":"Best Practice","text":"

    This page shows some best practices:

    "},{"location":"Best-Practice/#camera-placement","title":"Camera Placement","text":"
    • Move the Camera as close as possible (~4cm), this will help get rid of reflections. -> focus can be adjusted by turning the outer black ring of the camera.
    • If the LED reflections are too strong, put tape over the LED to diffuse the light
    • Change the ImageSize to QVGA under \"Expert mode\" configuration when close enough, this will be faster and is often good enough for digit recognition.
    "},{"location":"Best-Practice/#reflections","title":"Reflections","text":"
    • Try to get rid of the reflections by rotating the camera, so that the reflections are at positions, where no number is.
    • By using the external LED option, you can place WS2812 LEDs freely away from the main axis.
    • Users report, that a handy cover foil could also help
    "},{"location":"Best-Practice/#post-processing","title":"Post-processing","text":"
    • Filter out the Number \"9\", as \"3\" will often be misread for a \"9\" and void every number between 3 and 9 due to it being negative flow.
    • Split the readings into two, while the decimal numbers might move to fast to be recognized, at least the slower moving part will produce a correct reading. -> keep in mind that the offset needs to be adjusted, a.e if you have a comma reading of \"3\", it needs to become \"0.3\". This can be done wherever the data ends up being sent, like home assistant using sensor templates.
    • If you are using a low resolution and only digit mode, processing can often be done in <1 minute. Check the logs to confirm how fast it is and then set the interval accordingly under \"Expert mode\" in configuration, as the normal mode will lock you to 3+ minutes.
    "},{"location":"Build-Instructions/","title":"Build the Project","text":"

    See README.md in the main repo.

    "},{"location":"Choosing-the-Model/","title":"Model Selection","text":"

    Notes

    See Neural Network Types for additional details.

    In the Graphical Configuration Page, you can choose different models depending on your needs.

    This page tries to help you on which model to select. For more technical/deeper explanations have a look on Neural-Network-Types.

    "},{"location":"Choosing-the-Model/#digit-models","title":"Digit Models","text":"

    For digits on water meters, gas-meters or power meters you can select between two main types of models.

    "},{"location":"Choosing-the-Model/#dig-class11","title":"dig-class11","text":"

    This model can recognize full digits. It was the first model version. All intermediate states shown a \"N\" for not a number. But in post process it uses older values to fill up the \"N\" values if possible.

    It's possibly a good fallback, if dig-cont/dig-class100 results are not good.

    "},{"location":"Choosing-the-Model/#main-features","title":"Main features","text":"
    • well suited for LCD digits
    • the ExtendedResolution option is not supported. (Only in conjunction with ana-class100 / ana-cont)
    "},{"location":"Choosing-the-Model/#dig-class100-dig-cont","title":"dig-class100 / dig-cont","text":"

    These models are used to get a continuous reading with intermediate states. To see what the models are doing, you can go to the Recognition page.

    "},{"location":"Choosing-the-Model/#main-features_1","title":"Main features","text":"
    • suitable for all digit displays.
    • Advantage over dig-class11 that results continue to be calculated in the transition between digits.
    • With the ExtendedResolution option, higher accuracy is possible by adding another digit.

    Look here for a list of digit images used for the training.

    "},{"location":"Choosing-the-Model/#dig-class100-vs-dig-cont","title":"dig-class100 vs. dig-cont","text":"

    The difference is in the internal processing.

    The dig-class100 is a standard classification model. Each tenth step is an output.

    dig-cont uses two outputs and arctangent to get the result. You see very complicated.

    Try both models on your device and take the one that gives you the best results.

    "},{"location":"Choosing-the-Model/#analog-pointer-models","title":"Analog pointer models","text":""},{"location":"Choosing-the-Model/#ana-class100-ana-cont","title":"ana-class100 / ana-cont","text":"

    For pointers on water meters use the analog models. You can only choose between ana-class100 and ana-cont. Both do mainly the same.

    "},{"location":"Choosing-the-Model/#main-features_2","title":"Main features","text":"
    • for all analogue pointers, especially for water meters.
    • With the ExtendedResolution option, higher accuracy is possible by adding another digit.

    Look here for a list of pointer images used for the training

    "},{"location":"Choosing-the-Model/#ana-class100-vs-ana-cont","title":"ana-class100 vs. ana-cont","text":"

    The difference is in the internal processing.

    Take the one that gives you the best results. Both models learn from the same data.

    "},{"location":"Choosing-the-Model/#different-types-of-models-normal-vs-quantized","title":"Different types of models (normal vs. quantized)","text":"

    The normally trained network is calculating with internal floating point numbers. The saving of floating point numbers naturally takes more space than an integer type. Often the increased accuracy is not needed. Therefore there is the option, to \"quantize\" a neural network. In this case the internal values are rescaled to integer values, which is called \"quantization\". The stored tflite files are usually much smaller and runs faster on the edgeAI-device. Usually the models are distrusted therefore in both versions. They can be distinguished by a \"-q\" at the end of the logfile.

    "},{"location":"Choosing-the-Model/#example","title":"Example:","text":"Type Name Normal dig-cont_0610_s3.tflite Quantized dig-cont_0610_s3-q.tflite"},{"location":"Configuration/","title":"Graphical Configuration","text":"

    Most of the settings can be modified on the Settings page:

    It can be reached via the menu Settings > Configuration.

    Note

    • To activate the changes, the device needs to be restarted after saving the changes.
    • Most of the commands need processing on the ESP32 device. This is not very fast - so please be patient.

    All parameters are documented on the Parameters page and as tooltips on the config page.

    "},{"location":"Configuration/#expert-parameters","title":"Expert Parameters","text":"

    Some parameters are treated as Expert Parameters and are hidden by default. Tick the checkbox in the top left corner to enable them:

    The Expert Parameters then will be shown with a red background:

    "},{"location":"Configuration/#manual-editing-of-the-config-file","title":"Manual Editing of the Config File","text":"

    Even more configuration parameters can be edited manually in the config.ini:

    To edit the config.ini file directly, click on the Edit Config.ini directly button.

    "},{"location":"Configuration/#background-information","title":"Background Information","text":"

    Note

    You do not need to understand this! But you might be interested in it.

    The principle is very simple and can most easily be described as a flow of processing steps. Each step has a dedicated parameter description in the config.ini, which is indicated by brackets [name_of_step]. The steps are processed in the order written in the config file. That means, that you first have to describe the image taking, then the aligning and cutting and only after that you can start to config a neural network. The last step is the post processing.

    "},{"location":"Configuration/#processing-steps-overview","title":"Processing steps - Overview","text":"

    In the following you get a short overview over the available steps. This order is also the suggested order for the processing flow. Single steps can be left out, if not needed (e.g. omit the analog part, if only digits are present)

    "},{"location":"Configuration/#1-takeimage","title":"1. [TakeImage]","text":"

    This steps parametrises the taking of the image by the ESP32-CAM. Size, quality and storage for logging and debugging can be set.

    "},{"location":"Configuration/#2-alignment","title":"2. [Alignment]","text":"

    Image preprocessing, including image alignment with reference images

    "},{"location":"Configuration/#3-digits","title":"3. [Digits]","text":"

    Neural network evaluation of an image for digits. The neural network is defined by a tflite formatted file and the output is a number between 0 .. 9 or NaN (if image is not unique enough)

    "},{"location":"Configuration/#4-analog","title":"4. [Analog]","text":"

    Neural network evaluation of analog counter. The neural network is defined by a tflite formatted file and the output is a number between 0.0 .. 9.9, representing the position of the pointer.

    "},{"location":"Configuration/#5-postprocessing","title":"5. [PostProcessing]","text":"

    Summarized the individually converted pictures to the overall result. It also implements some error corrections and consistency checks to filter wrong reading.

    For more details look at Correction Algorithm).

    "},{"location":"Configuration/#6-mqtt","title":"6. [MQTT]","text":"

    Transfer of the readings to a MQTT server.

    "},{"location":"Configuration/#7-autotimer","title":"7. [AutoTimer]","text":"

    Configuration of the automated flow start at the start up of the ESP32.

    "},{"location":"Configuration/#8-debug","title":"8. [Debug]","text":"

    Configuration for debugging details

    "},{"location":"Correction%20Algorithm/","title":"Correction Algorithm","text":"

    After the digitization of the images and the composition to a number a checking and correction algorithm is applied. This is explained here.

    There are several reasons, that a check might be necessary:

    1. In case of digits there is the output of \"N\" (=NaN = Not-a-Number) in case the digit cannot be detected correctly. This happens for example if the image shows a digit between to states
    2. The replacement of the \"N\" with a previous value could be not sufficient, due to the fact, that it might have changed.
    3. There is a misreading of one one of the numbers. This can always happen in case of neural network processing.
    "},{"location":"Correction%20Algorithm/#terms-and-definitions","title":"Terms and definitions","text":""},{"location":"Correction%20Algorithm/#prevalue","title":"PreValue","text":"

    The last correct read value. PreValue is here a bit missleading, because normally it is the same as the last value. In the next round of reading it will be used to check nagtive rates, high rates (MaxRateValue / MaxRateType) and CCheckDigitIncreaseConsistency (dig-class11 only). Either from a previous correctly identified value or manual setting by the user.

    "},{"location":"Correction%20Algorithm/#digits","title":"Digits","text":"

    Value that are digitized from a digit number. There are 11 allowed values for this:

    1. Digits: 0, 1, 2, ... 9
    2. N = Not-a-Number - representing a not unique state between two numbers
    "},{"location":"Correction%20Algorithm/#analogs","title":"Analogs","text":"

    This are value derived from a pointer like meter. This never has the state \"N\".

    "},{"location":"Correction%20Algorithm/#checkdigitincreaseconsistency","title":"CheckDigitIncreaseConsistency","text":"

    If this is enabled an \"intelligent\" algorithm is used to derive from zero-crossing of discrete digit positions, if the number should have been increased. This is relevant because in some of the digit meters, the increase of a digit to the next number can be seen, before the sub-digit has gone through zero.

    For example: 16.6 --> 16.7 --> 1N.8 --> 17.9 corrected to 16.9 --> 17.0 --> 17.1

    As you can see, the 17.9 is a false reading as the 7 is assumed to be already readable, although the sub-digit has not crossed the zero. In this case the CheckDigitIncreaseConsistency algorithm will correct this to 16.9

    A detailed description of the algorithm can be found below (not yet ready!)

    "},{"location":"Correction%20Algorithm/#allownegativerates","title":"AllowNegativeRates","text":"

    Most of the meters only have increasing numbers and do not count backwards. Therefore a negative rate (= negative change compared to the PreValue) is surely a false value. This can be checked an flagged as false reading

    The AllowNegativeRates property ensures that the result does not become negative in the event of incorrect readings. This can happen, for example, if the alignment of the image did not work properly. But also the neural networks sometimes flip between two states for similar images.

    If AllowNegativeRates = true, the result is discarded if it is smaller than the pre-value of the last readout and the output shows an error \"Negative rate..\"

    If the ExtendedResolution setting is true, there is an exception where the value does not become smaller, but no error is output. This only applies if the value +/- 0.2 of the last digit is inaccurate.

    "},{"location":"Correction%20Algorithm/#decimalshift","title":"DecimalShift","text":"

    The DecimalShift setting puts the decimal point in the right place. It acts like a shift. Negative values shift the decimal point to the left. Positive values move the decimal point to the right, filling with zero.

    "},{"location":"Correction%20Algorithm/#analogtodigittransitionstart","title":"AnalogToDigitTransitionStart","text":"

    For detailed description see Analog-digit-transition.

    "},{"location":"Correction%20Algorithm/#maxratevalue-and-maxratetype","title":"MaxRateValue and MaxRateType","text":"

    Here the maximum change from one to the next reading can be limited. If a false reading of the neural network results in a change larger than this, the reading is flagged as false. There a two types of comparisons possible

    1) AbsolutChange: Here the difference between the PreValue and the current reading is compared directly, independent how much time has passed since the last reading. 2) RelativeRate: in this case a change rate in the unit of change/minute is calculated, taking the time between the last and the current reading into account. Be careful, that with increasing time, the absolute allowed change increases. Example: relative rate of 0.05 m\u00b3/minute --> after 20 minutes a maximum change of 20 minutes * 0.05 m\u00b3/minute = 1 m\u00b3 is possible. That means that a false reading of 1 m\u00b3 cannot be detected false after about 20 minutes in this case Assume, that there might be no change in the meter for hours (e.g. during the night) a much bigger change could also be accepted.

    "},{"location":"Correction%20Algorithm/#extendedresolution","title":"ExtendedResolution","text":"

    Newer models such as dig-cont and dig-class100 have a high resolution of the values and can thus represent another digit by using the value of the last digit or pointer (ex. 7.8 in the last digit).

    If the value is set to true, the result of the last digit is used completely.

    When using dig-class11 models, the setting is ignored.

    Due to inaccuracies of the neural networks, it sometimes happens that the results jump back and forth between two decimal places. Therefore, when using \u00c0llowNegatives= false, no error is output if the value is only off by 0.2. Nevertheless, the value then remains at the higher determined value.

    "},{"location":"Correction%20Algorithm/#ignoreleadingnan","title":"IgnoreLeadingNaN","text":"

    The parameter is only be used, if a dig-class11 model is selected. \u00ccgnoreLeadingNaN removes in the CheckDigitIncreaseConsistency process the leading N values.

    "},{"location":"Correction%20Algorithm/#flow-chart","title":"Flow Chart","text":""},{"location":"Correction%20Algorithm/#checkdigitincreaseconsistency-algorithm","title":"CheckDigitIncreaseConsistency Algorithm","text":"

    The check digit increase consistency algorithm is functional for the digits only. Due to the fact, that the rotation might be a little bit earlier or later compared to the zero crossing of the digit before, errors during the reading before and after a zero crossing can be wrong. Therefore a simple algorithm can be applied, checking the consistency of zero crossing and changes in the following digit. This is applied to one after the other digit, starting with the lowest priority digits.

    "},{"location":"Demo-Mode/","title":"Demo Mode","text":"

    For Demo and Testing Purpose, the device can use pre-recorded raw images.

    You need to enable it in the configuration (TakeImage > Demo) and also provide the needed files on the SD card.

    For each round one image gets used, starting with the first image for the first round.

    For the reference image and the alignment also the first image gets used.

    Once the last image got reached, it starts again with the first one.

    "},{"location":"Demo-Mode/#sd-card-structure","title":"SD Card Structure","text":"
    demo/\n\u251c\u2500\u2500 520.8983.jpg\n\u251c\u2500\u2500 520.9086.jpg\n\u251c\u2500\u2500 520.9351.jpg\n\u251c\u2500\u2500 ...\n\u2514\u2500\u2500 files.txt\n
    • The jpg files can have any name
    • The jpg files must be smaller than 30'000 bytes
    • The files.txt must contains a list of those files, eg:
      520.8983.jpg\n520.9086.jpg\n520.9351.jpg\n
    "},{"location":"Demo-Mode/#collecting-images-of-your-device","title":"Collecting images of your device","text":"

    There are several ways to collect images from your device:

    1. Use the Parameter RawImagesLocation to store them directly onto your SD card.
    2. Use the Webhook to send the raw image on each round to a dedicated server, see Webhook resp. ../Parameter UploadImg.

    3. Another option is to pull the images periodically from http://<IP>/img_tmp/raw.jpg. Eg. with an external service. Below is a (Linux)-Bash script to do it:

      #!/bin/bash\nwhile [[ true ]]; do\n    echo \"fetching value...\"\n    wget -q http://192.168.1.151/value -O value.txt\n\n    value=`cat value.txt`\n    echo \"Value: $value\"\n\n    diff=`diff value.txt value_previous.txt`\n    changed=$?\n    #echo \"Diff: $diff\"\n\n        if [[ $changed -ne 0 ]]; then\n            echo \"Value changed:\"\n            echo $diff\n            echo \"fetching image...\"\n            wget -q http://192.168.1.151/img_tmp/raw.jpg -O $value.jpg\n        else\n            echo \"Value did not change, skipping image fetching!\"\n        fi\n\n        cp value.txt value_previous.txt\n\n        echo \"waiting 60s...\"\n        sleep 60\ndone\n
    "},{"location":"Demo-Mode/#use-prepared-images","title":"Use prepared images","text":"

    Instead of recoding your own images, you can use one of the selections of prepared images below.

    "},{"location":"Demo-Mode/#how-does-it-work","title":"How does it work","text":"

    The Demo Mode tries to interfere as less as possible with the normal behavior. Whenever a Cam framebuffer gets taken (esp_camera_fb_get()), it replaces the framebuffer with the image from the SD card.

    "},{"location":"Demo-Mode/#example-data-of-a-water-meter","title":"Example Data of a Water Meter","text":"

    You can use the following demo images if you want:

    It covers a meter range from 530.00688 to 531.85882.

    "},{"location":"Demo-Mode/#animation","title":"Animation","text":"

    Animation of the watermeter (77 MB!)

    "},{"location":"Demo-Mode/#selection-of-84-images","title":"Selection of 84 images","text":"

    Demo_Images_Watermeter_530.00688-532.08243_84_images.zip

    "},{"location":"Demo-Mode/#selection-of-42-images","title":"Selection of 42 images","text":"

    Demo_Images_Watermeter_530.00688-532.08243_42_images.zip

    "},{"location":"Demo-Mode/#all-images-843-images","title":"All images (843 images)","text":"

    Demo_Images_Watermeter_530.00688-532.08243_843_images.zip

    "},{"location":"Error-Codes/","title":"Reduced webinterface (error indication and tracing)","text":"

    Whenever an error occurs during boot process which avoids loading of regular processing and regular webinterface, a reduced webinterface gets loaded to have at least some visual feedback and the possibilitiy to figure out the root cause by browsing the logfiles or trigger another OTA update.

    The error code(s) get printed with specific error codes. This page lists the possible error codes, their meaning and possible solutions.

    Notes

    Here the error codes are defined in source code: error codes.

    "},{"location":"Error-Codes/#critical-errors","title":"Critical Errors","text":"

    Those Errors make the normal operation of the device impossible. Most likely they are caused by a hardware issue!

    "},{"location":"Error-Codes/#0x00000001-psram-bad","title":"0x00000001 PSRAM bad","text":"

    Your device most likely has no PSRAM at all or it is too small (needs to have at least 4 MBytes)! See Hardware Compatibility.

    Usually the log shows something like this: 

    psram: PSRAM ID read error: 0xffffffff\ncpu_start: Failed to init external RAM!\n

    "},{"location":"Error-Codes/#0x00000002-heap-too-small","title":"0x00000002 Heap too small","text":"

    The firmware failed to allocate enough memory. This most likely is a consequential error of a bad PSRAM!

    "},{"location":"Error-Codes/#0x00000004-cam-bad","title":"0x00000004 Cam bad","text":"

    The attached camera can not be initialized. This usually is because on of the following reasons:

    • The camera is not supported, see Hardware Compatibility
    • The camera is not attached properly -> Try to remove and attach it again. Make sure you move the black part enough into the socket!
    • The camera or the camera cable is damaged
    "},{"location":"Error-Codes/#0x00000008-sd-card-basic-check-failed","title":"0x00000008 SD card basic check failed","text":"

    One or more basic SD card checks failed.

    The following checks are performed during boot sequence:

    • Write a file (sdcard/sdcheck.txt) to SD card with some generic text
    • Read the written file back
    • CRC verification
    • Delete the file

    Detailed error indication (write, rerad or delete error) can be derived from blinking code of red board status LED. Please refer to StatusLED-BlinkCodes

    Recommendation: Reformat SD card and check again or try another SD card

    "},{"location":"Error-Codes/#0x00000010-sd-folder-or-file-presence-check-failed","title":"0x00000010 SD folder or file presence check failed","text":"

    One or more mandatory folders and/or files are missing on SD card. To have early indication that SD card is potentially ready for operation, some folder and files, which are mandatory are presence checked. This is not a 100% check and a successful test does not mean everthing is OK.

    The following folders / files get checked during boot sequence:

    • /sdcard/config
    • /sdcard/html
    • /sdcard/demo --> created automatically in firmware
    • /sdcard/firmware --> created automatically in firmware
    • /sdcard/img_tmp --> created automatically in firmware
    • /sdcard/log --> created automatically in firmware
    • /sdcard/wlan.ini
    • /sdcard/config/config.ini
    • /sdcard/html/index.html
    • /sdcard/html/ota_page.html
    • /sdcard/html/log.html
    • /sdcard/html/common.js
    • /sdcard/html/version.txt

    Notes

    This list might be outdated, see the source code for the latest implementation: SDCardCheckRW()

    Recommendation: Check logs and / or redo a Over-The-Air Update (OTA Update) to ensure proper SD card structure

    "},{"location":"Error-Codes/#non-critical-errors","title":"Non-Critical Errors","text":"

    Those Errors can be caused by an error during initialization. It is possible that the error has no impact at all or that a reboot solves it.

    "},{"location":"Error-Codes/#0x00000100-cam-framebuffer-bad","title":"0x00000100 Cam Framebuffer bad","text":"

    The firmware was unable to initialize the Camera Framebuffer. The firmware will continue to work, but other consequential error might arise. A reboot of the device might help.

    This might also be caused by a corrupred SD-Card, see CAM is not working anymore\" on init #2390

    "},{"location":"Error-Codes/#0x00000200-ntp-failed","title":"0x00000200 NTP failed","text":"

    The firmware failed to get the world time from an NTP server. The firmware will continue to work, but has a wrong time.

    "},{"location":"Error-Debugging/","title":"Often observed issues","text":""},{"location":"Error-Debugging/#hardware-failure","title":"Hardware failure","text":"
    • Camera not working --> check the interface, test another module
    • Low cost module with no or only 2MB memory instead of 4MB --> test another module
    • SD card issues --> test another SD card
    • Wifi reception bad / unstable --> bad antenna, test another module or use external antenna

    More information in terms of hardware, component and basic configuration issues can be found here: Reboot reasons

    "},{"location":"Error-Debugging/#roi-misaligned","title":"ROI misaligned","text":"

    This typically happens if you have suboptimal \"Alignment Marks\". A very simple and working solution is to put put higly contrasted stickers on your meter and put \"Alignment Marks\" on it (see picture below)

    If after those adjustment you still have some issues, you can try to adjust your alignment settings in expert mode:

    "},{"location":"Error-Debugging/#my-analog-meter-are-recognized-as-digit-counter-or-vice-versa","title":"My Analog Meter are recognized as Digit Counter or vice versa","text":"
    1. First, check that your ROI are correctly defined (yey!)
    2. Second, verify that the name of your ROI analog and digit ROIs are different
    "},{"location":"Error-Debugging/#recognition-is-working-well-but-number-arent-sorted-correctly","title":"Recognition is working well, but number aren't sorted correctly","text":"

    You have to sort your ROI correctly (Bigger to smaller). Select your ROI and click either \"move next\" or \"move previous\". Repeat until your ROI are correctly sorted

    "},{"location":"External-LED/","title":"External LED","text":"

    The internal flash LED is very close to the camera axis. This results in reflection, especially in case of flat glass surfaces such as for power meters. To circumvent this problem, it is now possible to control external LEDs, which than can be places somewhere else in the setup. As not simples LEDs are used, but RGB LEDs with a digital interface like WS2812 not only the position, but also the color and intensity of the illumination can now be adjusted. The following image shows a direct comparison of the \"old\" internal flash LED and two off axis LEDs.

    There is also a new meter adapter available. This has two features: designed for small clearings in front of the meter and prepared for WS2812 LEDs.

    "},{"location":"External-LED/#1-hardware-installation-of-the-led-stripe","title":"1. Hardware installation of the LED stripe","text":"

    The control line of the LED stripe is connected with a 470 Ohm resistor to the GPIO12. For power supply stabilization a capacitor between 5V and ground is recommended. Here a 470\u00b5F polymer capacitor is used. As a power supply a 5V from the ESP32 is used like in the following wiring.

    "},{"location":"External-LED/#2-software-configuration","title":"2. Software configuration","text":"

    The handling of the WS2812 LED controller needs some other libraries, therefore it is controlled within a dedicated section called GPIO Settings. The external LED stripe is connected to GPIO12. After activating the \"GPIO Settings\" section, the internal flash is per default disabled. In order to activate the external LED, you need to activate GPIO 12 state and select \"extern flash light ws281x ...\".

    Parameter Meaning LED-Type There are several types of controller implemented: WS2812(B), WS2813, SK6812 Numbers of LED Number of LEDs on the LED stripe LED Color The color and intensity can be controlled directly by a red/green/blue value, each within the range from 0 (off) to 255 (full)

    Enabling the GPIO settings automatically disables the flash LED. Therefore you can enable it here manually by checking GPIO4 and choose \"build-in led flash light\". It is not recommended to use both illumination parallel.

    "},{"location":"FAQs/","title":"Frequently Asked Questions","text":""},{"location":"FAQs/#my-device-reboots-frequently-what-can-i-do","title":"My device reboots frequently. What can I do?","text":"

    There are several reasons for frequent reboots:

    • Frequent HTML requests
    • Wrong configuration, missing configuration files
    • Unstable hardware - see Hardware Compatibility.

    There is a dedicated page about this: Frequent Reboots.

    "},{"location":"FAQs/#bad-webui-responsiveness-what-can-i-do","title":"Bad WebUI responsiveness. What can I do?","text":"

    This is usually due to hardware or WLAN issues. There are already many entries in discussion section, some of which have good tipps.

    Possible checks / ideas:

    • ESP32CAM hardware antenna design is very poor in connection with camera frequency.
    • Simple test: When the device is in operation, putting your thumb on the camera connector and the directly adjacent components should make the device respond more quickly.
    • Possible optimization: Here, an attempt was made to dampen the frequency influences somewhat by shielding. Shielding Example
    • WLAN channel: Preferably use channel 1, 6 or 11
    • Performance can vary depending on the AP manufacturer. If necessary, check with a mobile hotspot or other device to exclude AP influence
    • Try with an external antenna
    • Avoid VLAN, currently not fully supported
    • Temporarily deactivate virus scanner / firewall on the end device for testing purpose
    • Use sufficiently dimensioned power supply
    • Use a branded SD card (formatted with Windows, MAC often causes problems)

    Check discussion section for possible further tipps.

    "},{"location":"FAQs/#how-accurate-are-the-detections","title":"How accurate are the detections?","text":"

    It is hard to give a specific accuracy number. It depends on many factors, e.g.

    • How in-focus is your camera?
    • How sturdy is the camera mount? Does it slightly move over extended periods of time?
    • What type of meter are you reading? Is the meter already in the training data set?
    • Are you trying to read digits, an analog dial, or both?
    • etc.

    Anecdotally, the authors of this page have great success with the meter. While the AI algorithm itself is not perfect and sometimes returns NaN or incorrect values, other post-processing / prevalue / sanity checks help ensure such invalid values are filtered out. With the correct settings, one author has been running this device for 1 month without any incorrect values reported.

    See the FAQs below for more details and configuration hints.

    "},{"location":"FAQs/#my-numbers-are-not-correctly-detected-what-can-i-do","title":"My numbers are not correctly detected. What can I do?","text":"
    • There is a dedicated page about the correct setting ROI Configuration.
    • This page also includes the instructions for gathering new images for the training.
    "},{"location":"FAQs/#how-can-i-ensure-invalid-numbers-are-never-reported","title":"How can I ensure invalid numbers are never reported?","text":"

    As mentioned above, the AI algorithm is not perfect. Sometimes it may read an incorrect value.

    We can tune the software to almost never report an incorrect value. There is a tradeoff though: the software may report stale values - i.e. it will drop incorrect values for a potentially long period of time, resulting in the meter reading being outdated by hours. If never receiving an incorrect value is important to you, consider tolerating this tradeoff.

    You can change the following settings to reduce incorrect readings (but potentially increase staleness of data):

    • Set a prevalue via the UI, then change PostProcessing configuration option PreValueAgeStartup to a much larger number (e.g. 43200 = 30 days).
    • Change PostProcessing configuration option MaxRateType to be time based instead of absolute. Set MaxRateValue to something realistic (e.g. 5 gal/min). You can often find the max flow rate your meter supports directly on the cover.
    • Reduce AutoTimer configuration option Interval to the lowest it can be (e.g. 3 min). The more often you take readings, the less likely for data staleness to occur.
    "},{"location":"FAQs/#even-after-i-have-setup-everything-perfect-there-is-a-false-reading-especially-around-the-zero-crossing-roll-over-to-next-number","title":"Even after I have setup everything perfect there is a false reading - especially around the zero crossing (roll over to next number)","text":"
    • The roll over behavior is different for the different meters. E.g.:
    • Rolling over start with different previous position (e.g. at 7, 8 or 9)

    • The neutral position (no rolling) is not perfectly at zero, but rather at something like 7.9 or 8.1, even if it should be exactly 8

    • The \"PostProcessingAlgo\" is trying to judge out of the individual readings, what number it should be.

    • For example if the previous number is a \"1\", but the next number seems to be a \"8.9\", most probably there was a \"zero crossing\" and the number is a \"9\" and not still an \"8\"

    • Currently the setting of the algorithm is set to fit most of the meters and cases. But the parameters do not fit perfectly for all situations. Therefore there might be intermediate states, where the reading is false. This is especially the case, at the positions, where the roll over (zero crossing) is just starting.

    • To prevent a sending of false parameters, there is the possibility to limit the maximum allowed change (MaxRateChange). Usually after some time and movement of the counters a bit further, the reading is getting back to a stable reading.
    • To handle this, a parametrized setting would be needed. This is rather complicated to implement as subtle changes make a relevant difference. Currently this is not implemented. So please be a bit patient with your meter :-)
    "},{"location":"FAQs/#pre-value","title":"Pre-Value","text":"

    PreValue is here a bit missleading, because normally it is the same as the last value. In the next round of reading it will be used to check nagtive rates, high rates (MaxRateValue / MaxRateType) and CheckDigitIncreaseConsistency (dig-class11 only). Either from a previous correctly identified value or manual setting by the user.

    If you use post processes, enable the pre-value. The pre-value must be set at first time. Set it to the current raw value.

    If the device runs in errors, the pre-value will not be updated, as long as the preValueAgeStartup time between the last valid value (or startup time) and current time is not exceeded. After it the preValue will be set again, if no other error occured. So the device can not run in an endless error, like high rate.

    "},{"location":"FAQs/#rate-too-high-read","title":"\"Rate too high - Read: ...\"","text":"

    In configuration you can set the MaxRateValue and MaxRateType. The settings suppress improbably high values that can come from false readings. To do this, the value must be set correctly depending on your meter.

    Before doing this, you should be clear about the type of rating you want to use.

    • Absolute change is the interval between two readings - no matter how often the readings happen.
    • RateChange is the change per minute. This is calculated from the time difference between the last and the current reading.

    If there is an interval of 5 minutes between readings and a MaxRateValue of 1, an error \"Rate too high - Read: ...\" if

    • Absolute change: the difference is > 1
    • RateChange: the difference is > 1 / 5
    "},{"location":"FAQs/#train-on-my-own-images","title":"Train on my own images","text":"

    Look at Learn models with your own images and Cookbook running the jupyter notebook with my own data.

    "},{"location":"FAQs/#what-does-aioted-mean","title":"What does AIOTED mean?","text":"

    This is just the abbreviation of AI-on-the-edge-device.

    "},{"location":"Frequent-Reboots/","title":"Basic hardware / configuration issues","text":"

    If the device is behaving eratically or not running as expected you can use the following tools trying to identify the root cause:

    1. Internal logging (config.ini) --> Set to DEBUG log level
    2. Reduced web interface (only error indication visualization, Error codes on reduced webinterface)
    3. Red board LED: Status LED Blinkcodes
    4. Serial log of the UART interface (USB access needed, only local, same as for flashing the firmware)

    There are in principle two reboots types:

    1. Sporadic random reboots (always different timing and situation)
    2. Repeating boot loops (reoccuring, always stop working after same precondition)
    "},{"location":"Frequent-Reboots/#sporadic-random-reboots","title":"Sporadic random reboots","text":"

    Sporadic random reboots could have the following reasons:

    • In general: Unstable system due to software issues (e.g. overload during HTML access, ...) --> Trying the figure out what's the root cause to fix the issue
    • Bad power supply --> The power supply need to stable to ensure proper operation of the device. If it's not stable the device tents to sporadic reboots (brownout detection)

    In general: There are several mechanisms in the firmware (like saving previous values), to have a \"smooth\" reboot without too many notable disturbance.

    "},{"location":"Frequent-Reboots/#system-instabilities","title":"System instabilities","text":"

    If your system is sometimes running smoothly over several runs and sometimes reboots obviously randomly, you have an partially unstable device.

    You can check this in the standard log file on the SD card:

    2021-12-26T06:34:09: task_autodoFlow - round done\n2021-12-26T06:34:09: CPU Temperature: 56.1\n2021-12-26T06:38:00: task_autodoFlow - next round - Round #23\n

    Here you see, that the round #23 is starting, so obviously there were no reboots in the last 22 rounds. There is hardware (ESP32CAM), where only 2-3 stable rounds are possible and others, where way more than 100 rounds without any reboots is possible. There is noting you can do about it, beside testing different hardware.

    "},{"location":"Frequent-Reboots/#overload-during-html-access","title":"Overload during HTML access","text":"

    If you frequently access the web server over HTML requests, the firmware tends to reboot. This especially happens during the first run and when the ESP32 is busy with the digitization flow.

    The reason for this are running out of memory during a flow, minor memory leakage in combination with missing error handling.

    There is noting you can do about this kind of reboot, beside two thing:

    1. Support the firmware development with improved and tested part of code
    2. Be patient :-)
    "},{"location":"Frequent-Reboots/#bad-or-insufficient-power-supply","title":"Bad or insufficient power supply","text":"

    A good and stabilized power supply is essential to have error free operation. The device is quite picky in terms of proper power supply. Especially the wifi module have some load spikes which the power supply needs to cover. If the power is not stable enough, the brwonout mechanism is protecting against strange behaviour and force a reboot whenever the voltage drops below a specific level. You can see this in random reboots which indication is logfile: --> Reset reason: Brownout

    "},{"location":"Frequent-Reboots/#repeating-boot-loops","title":"Repeating boot loops","text":"

    Repeating boot loops at the same situation during the flow has a systematic problem either in the hardware or the configuration. It usually happens during initialization state or processing the first round as there all needed parts of the firmware have been loaded for the first time.

    To identify the root cause the logfiles, the reduced web interface, the red board LED or the serial log of the UART interface (no remote access, USB access needed) is helpful.

    Possible issues:

    • SD card related issues
    • RAM related issues
    • Configuration related issues
    "},{"location":"Frequent-Reboots/#sd-card-related-issues","title":"SD card related issues","text":"

    The ESP32CAM is a little bit \"picky\" with the supported SD cards. Due to the limited availability of GPIOs the SD card can only be accessed via 1-wire mode. Therefore not all SD cards are supported. The following error cases can occur:

    "},{"location":"Frequent-Reboots/#sd-card-wrong-filesystem-only-fat32-is-supported","title":"SD card: Wrong filesystem (only FAT32 is supported)","text":"

    If this SD card error is detected only the following indications are available. No web interface will be accessible.

    • Red board LED is blinking. The blinking codes are described here: Status LED Blinkcodes
    • Error messages on serial log (UART interface)
    "},{"location":"Frequent-Reboots/#sd-card-not-detected-not-supported","title":"SD card not detected / not supported","text":"

    If this SD card error is detected the following indication are available. No web interface will be accessible.

    • Red board LED is blinking. The blinking codes are described here: Status LED Blinkcodes
    • Error messages on serial log (UART interface)
    "},{"location":"Frequent-Reboots/#sd-card-detected-but-files-are-not-readable-writeable","title":"SD card detected but files are not readable / writeable","text":"

    The SD card is detected, but the files cannot be read or written. A basic SD card check for SD reading / writing is performed on every boot. This not 100% guarantee that SD card is working but it's at least a indication.

    If this SD card error is detected the following indications are available:

    • The reduced web interface will be loaded to have visual feedback of error situation. Regualar processing is disabled, though. Within this reduced web interface logs can be viewed to have further indication what's the root cause. Error code desciption can be found here: Error codes on reduced webinterface
    • Error messages in logfile
    • Red board LED is blinking. The blinking codes are described here: Status LED Blinkcodes
    • Error messages on serial log (UART interface)
    "},{"location":"Frequent-Reboots/#ram-related-issues","title":"RAM related issues","text":"

    In order to run the firmware, 4 MB of external RAM (PSRAM) are mandatory. Usually, the ESP32CAM is equipped with 8MB (64Mbit) PSRAM chip, whereof only 4MB can be used effectively (direct addressable). Unfortunately, there is hardware around, where no PSRAM or only 2MB of PSRAM is present - even if you have bought a device where a 8MB PSRAM was promoted. These modules are not suiable for this firmware because the external RAM is needed to handle the CNN files and camera images. There is nothing to do, than to buy a new ESP32CAM with really 64MBit of PSRAM.

    "},{"location":"Frequent-Reboots/#too-less-external-ram-psram","title":"Too less external RAM (PSRAM)","text":"

    During the boot process the available RAM is going to be checked.

    If there is too less RAM (PSRAM or total HEAP < 4MB) detected, the follwoing indications are available:

    • The reduced web interface will be loaded to have visual feedback of error situation. Regualar processing is disabled, though. Within this reduced web interface logs can be viewed to have further indication what's the root cause. Error code desciption can be found here: Error codes on reduced webinterface
    • Error messages in logfile
    • Red board LED is blinking. The blinking codes are described here: Status LED Blinkcodes
    • Error messages on serial log (UART interface)
    "},{"location":"Frequent-Reboots/#configuration-related-issues","title":"Configuration related issues","text":""},{"location":"Frequent-Reboots/#folders-and-files-missing","title":"Folders and files missing","text":"

    Most of the relevant folders and files are checked during boot. The complete list can be found here: Error codes on reduced webinterface

    If a relevant folder or file is missing the following indications are available:

    • The reduced web interface will be loaded to have visual feedback of error situation. Regualar processing is disabled, though. Within this reduced web interface logs can be viewed to have further indication what's the root cause. Error code desciption can be found here: Error codes on reduced webinterface
    • Error messages in logfile
    • Red board LED is blinking. The blinking codes are described here: Status LED Blinkcodes
    • Error messages on serial log (UART interface)
    "},{"location":"Frequent-Reboots/#cnn-model-file-not-available-corrupt","title":"CNN model file not available / corrupt","text":"

    Additionally for operation CNN model files on SD card are mandatory, one CNN model file for analog counter and for for digit numbers each.

    • /config/XXXXX.tflite (XXXXX is the file name, that is written in the config.ini)

    If the files which are configured in config.ini are not present or corrupt, the process is going to be interrupted (or at worst case a device crash occurs). Please check logs files to have an indicator for the root cause.

    This a logfile extract (DEBUB log level) where digit CNN model file is not present. The system is initializing the system and trying to load the model files: 

    [0d00h05m11s] 2023-03-27T12:25:14 [TFLITE] CTfLiteClass::LoadModel\n[0d00h05m11s] 2023-03-27T12:25:14 [TFLITE] CTfLiteClass::ReadFileToModel: /sdcard\n[0d00h05m11s] 2023-03-27T12:25:14 [PSRAM] Failed to allocate 0 bytes in PSRAM for 'TFLITE->modelfile'!\n[0d00h05m11s] 2023-03-27T12:25:14 [TFLITE] CTfLiteClass::ReadFileToModel: Can't allocate enough memory: 0\n[0d00h05m12s] 2023-03-27T12:25:14 [HEAP] CTfLiteClass::ReadFileToModel Heap Total: 2266214 | SPI Free: 2205939 | SPI Large Block: 2162688 | SPI Min Free: 2205423 | Int Free: 60275 | Int Large Block: 55296 | Int Min Free: 46451\n[0d00h05m12s] 2023-03-27T12:25:14 [CNN] Can't load tflite model -> Init aborted!\n[0d00h05m12s] 2023-03-27T12:25:14 [HEAP] getNetworkParameter-LoadModel Heap Total: 2266214 | SPI Free: 2205939 | SPI Large Block: 2162688 | SPI Min Free: 2205423 | Int Free: 60275 | Int Large Block: 55296 | Int Min Free: 46451\n[0d00h05m12s] 2023-03-27T12:25:14 [PSRAM] Freeing memory in PSRAM used for 'TFLITE->modelfile'...\n[0d00h05m12s] 2023-03-27T12:25:14 [PSRAM] Freeing memory in PSRAM used for 'TFLITE->tensor_arena'...\n[0d00h05m12s] 2023-03-27T12:25:14 [PSRAM] Allocated 819200 bytes in PSRAM for 'TFLITE->tensor_arena'\n[0d00h05m12s] 2023-03-27T12:25:14 [TFLITE] CTfLiteClass::LoadModel\n[0d00h05m12s] 2023-03-27T12:25:14 [TFLITE] CTfLiteClass::ReadFileToModel: /sdcard/config/ana-cont_1105_s2_q.tflite\n[0d00h05m12s] 2023-03-27T12:25:15 [PSRAM] Allocated 53328 bytes in PSRAM for 'TFLITE->modelfile'\n[0d00h05m12s] 2023-03-27T12:25:15 [TFLITE] CTfLiteClass::MakeAllocate\n[0d00h05m12s] 2023-03-27T12:25:15 [PSRAM] Freeing memory in PSRAM used for 'TFLITE->modelfile'...\n[0d00h05m12s] 2023-03-27T12:25:15 [PSRAM] Freeing memory in PSRAM used for 'TFLITE->tensor_arena'...\n

    • Bad config example:

    • [0d00h05m11s] 2023-03-27T12:25:14 [TFLITE] CTfLiteClass::ReadFileToModel: /sdcard --> model file missing: check configuration or file presence

    • Good config example:

    • [0d00h05m12s] 2023-03-27T12:25:14 [TFLITE] CTfLiteClass::ReadFileToModel: /sdcard/config/ana-cont_1105_s2_q.tflite --> model file found: config OK
    "},{"location":"Hardware-Compatibility/","title":"Hardware Compatibility","text":""},{"location":"Hardware-Compatibility/#general-remark","title":"General Remark","text":"

    Although a board looks similar, it can have major differences, e.g.:

    • Processor
    • Ram (Size! & Type) -> this Project needs at least 4MB RAM!
    • Flashrom
    • Camera Modules
    • Onboard/External Antenna
    • Quality of Components
    • Manufacture Quality of the PCB and soldering
    • Different Components
    • \"Clone\" Components -> ESPxx
    • etc.

    This can cause different Power Consumption, Power Requirements, compatibility issues, etc.

    Most manufacturers and sellers buy what's cheap today on the Asian markets. In the end, it looks like it is sometimes a trial and error approach which ESP32-CAM Module works reliably.

    Below you find some remarks and experiences from the community:

    "},{"location":"Hardware-Compatibility/#esp32-core-itself","title":"ESP32 core itself","text":"Chip Version Image Status ESP32-D0WDQ6 (revision 1) \u2714\ufe0f"},{"location":"Hardware-Compatibility/#psram","title":"PSRAM","text":"

    There seems to be a lot of \"fake\" chips, or maybe wrongly configured ESP32 Boards.

    For AP MEMORY, all \"real\" APS6404*3SQR chips should work.

    For ESP PSRAM, all \"real\" PSRAM64* should work.

    64Mbit density = 8Mbyte PSRAM

    This Table is just a snapshot of chips which worked

    Labeling on PSRAM module Image Status IPUS / IPS640LS0 / 1815XBGN \u2714\ufe0f AP MEMORY / 6404L-3SOR / 1040H / 110089G \u2714\ufe0f AP MEMORY / 6404L-3SQR / 12205 / 150047G \u2714\ufe0f 8MB AP MEMORY / 6404L-3SQR / 12208 / 150047G \u2714\ufe0f 8MB AP MEMORY / 6404L-350R / 1120A / 130027G \u274c PSRAM not accessible AP MEMORY / 6404L-35QR / 11208 / 130025G \u274c PSRAM not accessible AP MEMORY / 6404L-3SQR / 13100 / 180026G \u274c PSRAM not accessible AP MEMORY / 6404L-3SQR / 11207 / 130024G \u274c PSRAM not accessible AP MEMORY / 6404L-3SQR / 1120A / 130027G \u2714\ufe0f 8MB AP MEMORY / 6404L-3SQR / 1120B / 130028G \u2714\ufe0f 8MB AP MEMORY / 6404L-3SQR / 1120D / 130030G \u2714\ufe0f 8MB AP MEMORY / 1604M-3SQR / 0280A / 070036G \u274c 2MB only! ESP PSRAM64H 462021 / 1B00286 \u2714\ufe0f ESP PSRAM64H 412021 / 1A0039G \u2714\ufe0f 8MB ESP PSRAM64H 402021 / 1A0017N \u274c PSRAM not accessible ESP PSRAM16M 302020 \u274c 2MB only! ESP PSRAM16H 202020 / 050022G \u274c 2MB only!"},{"location":"Hardware-Compatibility/#ov2640-camera","title":"OV2640 - Camera","text":"

    The experience with the camera only is based on single modules. It is well possible, that this module had a damage overall and other modules of the same type will work. Give it a try and report to me!

    Labeling on Flex-Connector Image Status TY-OV2 / 640-V2.0 \u2714\ufe0f DCX-OV2 / 640-V2 \u2714\ufe0f DC-26 / 40-V3 \u2714\ufe0f 3x \u274c 1x"},{"location":"Hardware-Compatibility/#esp32-modules","title":"ESP32 Modules","text":"Module Image Status ESP32CAM / Different versions on the market!Especially the PSRAM is sometimes labeled wrong(Label: 4MB, Real: only 2 MB --> will not work!) \u2714\ufe0fwith >=4 MB PSRAM! ESP32-S3-EYENo Flash LED, pins different used (e.g. LCD display) NOT OKAY"},{"location":"Hardware-Compatibility/#sd-cards","title":"SD Cards","text":"

    Due to the limited free available GPIOs (due to all the extensions needed like: camera, SD card, LED-flash, ...) the SD card is connected in 1-wire mode. There are some cards, that are compatible with the esp32cam module for unknown reasons. It is observed, that smaller cards (up to 4 GB) tend to be more stable and larger cards have more problems. But quite some exceptions in the forums (4 GB cards not working, 16 GB cards working like a charm).

    "},{"location":"Hardware-Compatibility/#devices-known-to-work","title":"Devices known to work","text":""},{"location":"Hardware-Compatibility/#modules-old-list-not-up-to-date-anymore","title":"Modules (Old list, not up-to-date anymore):","text":"

    See https://github.com/jomjol/AI-on-the-edge-device/discussions/1732 for a more recent list.

    • https://arduino-projekte.info/produkt/esp32-cam-v2-integriertem-ch340-mit-ov2640-kamera-modul/ (see https://github.com/jomjol/AI-on-the-edge-device/discussions/1041)

    • https://www.amazon.de/-/en/gp/product/B0B51CQ13R

    • https://www.reichelt.de/entwicklerboards-esp32-kamera-2mp-25--debo-cam-esp32-p266036.html?PROVID=2788&gclid=CjwKCAiAqaWdBhAvEiwAGAQlttJnV4azXWDYeaFUuNioMICh-jvxKp6Cifmcep9vvtoT2JRCDqBczRoC7Q0QAvD_BwE (27.12.2022)

    "},{"location":"Hardware-Compatibility/#sd-card","title":"SD Card","text":"
    • Sandisk 2GB Micro SD Class 2 Sandisk 2GB AITRIP ESP32 and CAM ESP-32/CAM
    • Amazon US - Aideepen ESP32-CAM W BT Board ESP32-CAM-MB Micro USB to Serial Port CH-340G with OV2640 2MP Camera Module Dual Mode with Amazon US - Cloudisk 5Pack 4GB Micro SD Card 4 GB MicroSD Memory Card Class6
    "},{"location":"Hardware-Compatibility/#weak-wifi","title":"Weak Wifi","text":"

    The ESP32-CAM supports an external antenna. It requires some soldering skills but can improve the connection quality. See https://randomnerdtutorials.com/esp32-cam-connect-external-antenna/

    "},{"location":"Influx-DB/","title":"Influx DB","text":"

    The device also supports direct sending of data to an Influx DB.

    See also Influx Graph in Home Assistant.

    "},{"location":"Installation/","title":"Installation","text":"

    The installation requires multiple steps:

    1. Get the right hardware and wire it up
    2. Flash the firmware onto the ESP32
    3. Write the data to the SD card
    4. Start it

    For point 2 and 3 we provide multiple ways to do it. Pick the one that looks the easiest for you!

    "},{"location":"Installation/#1-hardware","title":"1. Hardware","text":""},{"location":"Installation/#esp32-cam","title":"ESP32-CAM","text":"
    • OV2640 camera module
    • Micro SD card slot
    • 4 or 8 MB PSRAM.

    It can be easily found on the typical internet stores, searching for ESP32-CAM for less than 10 EUR. How ever since the hardware is cheap and coming from China, you unluckily could pick a malfunctioning device. See Hardware Compatibility for further advice!

    "},{"location":"Installation/#usb-uart-interface","title":"USB->UART interface","text":"

    For first time flashing the firmware a USB -> UART connector is needed. Later firmware upgrades than can be flashed via OTA.

    "},{"location":"Installation/#power-supply","title":"Power supply","text":"

    For power supply a 5V source is needed. Most easily this can be done via a USB power supply. The power supply should support minimum 500mA. For buffering current peaks some users reported to use a large electrolytic capacitor like a 2200uF between ground and VCC.

    Warning

    In several internet forums there are problems reported, in case the ESP32-CAM is only supplied with 3.3V.

    "},{"location":"Installation/#housing","title":"Housing","text":"

    A small 3D-printable example for a very small case can be found in Thingiverse here: https://www.thingiverse.com/thing:4571627

    Warning

    The focus of the OV2640 needs to be adjusted, as it is normally set from ~40cm to infinity. In order to get an image that is big enough, it needs to be changed to about 10cm. Therefore the sealing glue on the objective ring needs to be removed with a scalpel or sharp knife. Afterwards the objective can be rotated clockwise until the image is sharp again.

    "},{"location":"Installation/#wiring","title":"Wiring","text":"

    Beside the 5V power supply, only for the first flashing a connection to the USB-UART connector, including a short cut of GPIO0 to GND for bootloader start.

    A example for wiring can be found here:

    It is also possible to use external LEDs for the illumination instead of the internal flash LED. This is described here

    "},{"location":"Installation/#2-firmware","title":"2. Firmware","text":""},{"location":"Installation/#web-installer","title":"Web Installer","text":"

    There is a Web Installer available which will work right out of the web browser Edge and Chrome. You can access it with the following link: Web Installer

    This is the preferred way for beginners as it also allows access to the USB Log:

    "},{"location":"Installation/#manual-flashing","title":"Manual Flashing","text":""},{"location":"Installation/#files","title":"Files","text":"

    Grab the firmware from the

    • Releases page (Stable, tested versions), or the
    • Automatically build development branch (experimental, untested versions). Please have a look on Living on the Edge first!

    You need:

    • partitions.bin
    • bootloader.bin
    • firmware.bin
    "},{"location":"Installation/#flashing-using-the-flash-tool-from-espressif-gui","title":"Flashing using the Flash Tool from Espressif (GUI)","text":"

    Get the Flash Download Tool from Espressif.

    Download and extract the Flash tool, after starting choose \"Developer Mode\", then \"ESP32-DownloadTool\" and you are in the setup of the flashing tool. Connect the ESP32-CAM with the USB-UART connection and identify the COM-Port.

    Warning

    If you are re-flashing the code again, it is strongly recommended to erase the flash memory before flashing the firmware. Especially if you used OTA in between, which might cause remaining information on the flash, to still boot from an old image in the OTA-area, which is not erased by a normal flash.

    Put your ESP32 in bootloader mode and push start, then it will identify the board and you can configure the bin-configuration according to the following table:

    Filename Offset bootloader.bin 0x1000 partitions.bin 0x8000 firmware.bin 0x10000

    "},{"location":"Installation/#flashing-using-the-python-based-esptool-console","title":"Flashing using the Python based esptool (Console)","text":"

    For this you need a python environment (e.g. Anaconda in Win10). Here you need to install the esptool:

    pip install esptool\n
    Then connect the ESP32 with the USB-UART connector to the system, put it in boot mode and with the following command you can erase the flash and flash bootloader, partitions and firmware in two steps:

    esptool erase_flash\nesptool write_flash 0x01000 bootloader.bin 0x08000 partitions.bin 0x10000 firmware.bin\n
    - Maybe you need to specify the COM-port if it is not detected by default. - If the erase command throws the error A fatal error occurred: ESP32 ROM does not support function erase_flash., your esptool might be too old, see https://techoverflow.net/2022/02/08/how-to-fix-esp32-a-fatal-error-occurred-esp32-rom-does-not-support-function-erase_flash/

    With some Python installations this may not work and you\u2019ll receive an error, try python -m pip install esptool or pip3 install esptool.

    Further recommendations can be found on the espressif webpage.

    "},{"location":"Installation/#3-sd-card","title":"3. SD Card","text":"

    The software expects an SD card prepared with certain directory and file structure in order to work properly. SD card most top directory should look like this:

    This initial setup needs only to be done once as further updates (Firmware as well as SD card content) are possible with the Over-The-Air Update mechanism.

    "},{"location":"Installation/#notes","title":"Notes","text":"
    • Due to the limited availability of GPIOs (OV2640, Flash-Light, PSRAM & SD card) the communication mode to the SD card is limited to 1-line SD-Mode. It showed up, that this results in problems with very large SD-Cards (64GB, sometimes 32 GB) and some no name low cost SD-cards.
    • There must be no partition table on the SD-card (no GPT, but only MBR for the single partition)
    • Following setting are necessary for formatting the SD-card: SINGLE PARTITION, MBR, FAT32 - 32K. NOT exFAT
    • Some ESP32 devices share their SD-card and/or camera GPIOs with the pins for TX and RX. If you see errors like \u201cFailed to connect\u201d then your chip is probably not entering the bootloader properly. Remove the respective modules temporarily to free the GPIOs for flashing. You may find more information about troubleshooting on the homepage of Espressif.

    The ESP32 indicates problems with the SD card during startup with a fast, endless blinking. In this case, please try another SD card.

    "},{"location":"Installation/#manual-setup-with-an-sd-card-reader-on-a-pc","title":"Manual Setup with an SD Card Reader on a PC","text":"
    1. Take the AI-on-the-edge-device__manual-setup__*.zip from the Release page.
    2. Open it and extract the sd-card.zip.
    3. Open it and extract all files onto onto your SD card.
    4. On the SD card, open the wlan.ini file and configure it as needed:
      • Set the corresponding SSID and password
      • The other parameters are optional

    !!! Note The device provides a File Server which can be used to show, edit or delete the files on the SD card. For security reasons, the wlan.ini file is excluded from this and is hidden from external access to protect the password.

    After this, you can insert the SD card into the ESP32 board and start it.

    "},{"location":"Installation/#remote-setup-using-the-built-in-access-point","title":"Remote Setup using the built-in Access Point","text":"

    On startup of the ESP32, it checks if the wlan.ini or the config/config.ini are available on the SD card. If not, the ESP32 switches to a special mode. In this mode, it provides a Wifi Access Point which can be used to add the missing wlan.ini or the config/config.ini file.

    1. Take the AI-on-the-edge-device__remote-setup__*.zip from the Release page.

    2. Connect to Access Point of the device. The SSID is \"AI-on-the-Edge\" and you can access it without any password:

      The device has the following fixed IP: http://192.168.4.1.

    3. Upload initial configuration to SD card

      Use the select file and upload button to start the upload. A warning will show up if you have chosen a possible wrong file (without default configuration).

    4. Store WLAN access information.

      After the upload, a new page will be shown:

      Enter your SSID and password.

      Note

      Only basic settings are supported. If you need advanced configuration (fixed ip, ...), you need to use the manual setup as documented above.

      Warning

      • Carefully check your wifi settings. To change them later on, you need to take out the SD card and edit the wlan.ini manually (or delete it and start again).
      • The information is transferred without encryption!

      Finish the step by pushing Write wlan.ini

    5. Reboot

      The final step is the reboot:

      Warning

      It will take up to 3 minutes. Afterwards you can find your device in the local network. Check your router for the IP. You can find it also in the USB Console output.

    "},{"location":"Installation/#4-initial-startup","title":"4. Initial Startup","text":"

    After the firmware is flashed and the SD card is setup properly, you can start it. After power on the connection status is indicated by 3x blinking of the red on board LED.

    WLAN-Status indication:

    • 5 x fast blinking (< 1 second): connection still pending
    • 3 x slow blinking (1 second on/off): WLAN connection established

    Notes

    It is normal that at first one or two times a pending connection is indicated.

    "},{"location":"Integration-Home-Assistant/","title":"Integration into Home Assistant","text":"

    There are 3 ways to get the data into your Home Assistant:

    1. Using MQTT (Automatically Setup Entities using Home Assistant MQTT Discovery)
    2. Using MQTT (Manually Setup Entities)
    3. Using REST calls

    The first one is the easier way if you already have MQTT in use.

    "},{"location":"Integration-Home-Assistant/#using-mqtt-automatically-setup-entities-using-home-assistant-mqtt-discovery","title":"Using MQTT (Automatically Setup Entities using Home Assistant MQTT Discovery)","text":"

    Starting with Version >12.0.1, AI-on-the-edge-devices support Home Assistant Discovery.

    1. Check here to learn more about it and how to enable it in Homeassistant.

    2. You also have to enable it in the MQTT settings of your device:

      Make sure to select the right Meter Type to get the right units!

    On the next start of the device, it will send discovery topics and Home Assistant should pick them up and show them under Settings > Integrations > MQTT:

    "},{"location":"Integration-Home-Assistant/#using-mqtt-manually-setup-entities","title":"Using MQTT (Manually Setup Entities)","text":"

    First make sure with an MQTT client (for example MQTT Explorer) that MQTT works as expected and to get a list of the available topics!

    Then add a sensor for each property: 

    mqtt:\n  sensor:\n    - state_topic: \"wasserzaehler/main/value\"\n      name: \"Watermeter Value\"\n      unique_id: watermeter_value\n      unit_of_measurement: 'm\u00b3'\n      state_class: total_increasing\n      device_class: water # Needs Home Assistant 2022.11!\n      icon: 'mdi:water-pump'\n      availability_topic: wasserzaehler/connection\n      payload_available: connected\n      payload_not_available: connection lost\n\n    - state_topic: \"wasserzaehler/main/rate\"\n      name: \"Watermeter Rate\"\n      unique_id: watermeter_rate\n      unit_of_measurement: 'm\u00b3/min'\n      state_class: measurement\n      device_class: water # Needs Home Assistant 2022.11!\n      icon: 'mdi:water-pump'\n      availability_topic: wasserzaehler/connection\n      payload_available: connected\n      payload_not_available: connection lost\n\n    - state_topic: \"wasserzaehler/main/error\"\n      name: \"Watermeter Error\"\n      unique_id: watermeter_error\n      icon: \"mdi:water-alert\"\n      availability_topic: wasserzaehler/connection\n      payload_available: connected\n      payload_not_available: connection lost    \n\n    - state_topic: \"wasserzaehler/uptime\"\n      name: \"Watermeter Uptime\"\n      unique_id: watermeter_uptime\n      unit_of_measurement: 's'\n      state_class: measurement\n      device_class: duration\n      entity_category: diagnostic\n      icon: \"mdi:timer-outline\"\n      availability_topic: wasserzaehler/connection\n      payload_available: connected\n      payload_not_available: connection lost\n
    If you run the discovery once, you can also extract the information from there (MQTT Info, untested): 
    mqtt: # Extracted form the Discovery but untested!\n  sensor:\n      - name: Value\n        unique_id: wasserzaehler-main_value\n        icon: mdi:gauge\n        state_topic: wasserzaehler/main/value\n        unit_of_measurement: m\u00b3\n        device_class: water\n        state_class: total_increasing\n        availability_topic: wasserzaehler/connection\n        payload_available: connected\n        payload_not_available: connection lost\n

    If you want to convert the m\u00b3 to l, use a template sensor: 

    template:\n  - sensor:\n    - name: \"Watermeter in l\"\n      unique_id: watermeter_in_l\n      icon: \"mdi:gauge\"\n      state: \"{{ states('sensor.watermeter_value')|float(default=0) * 1000 }}\" # Convert 1 m3 => 1000 l\n      unit_of_measurement: l\n      availability: \"{{ states('sensor.watermeter_value') not in ['unknown', 'unavailable', 'none'] }}\"\n

    If you you want to have the consumption per day, you can use an Utility Meter. it is a helper and can be used to reset the total increasing values once a day

    utility_meter:\n  utility_meter_gas_per_day:\n    source: sensor.gasmeter_value\n    cycle: daily\n\n  utility_meter_water_per_day:\n    source: sensor.watermeter_value\n    cycle: daily\n

    Note that you also can add it using the UI.

    "},{"location":"Integration-Home-Assistant/#examples","title":"Examples","text":""},{"location":"Integration-Home-Assistant/#statistics-graph","title":"Statistics Graph","text":"

    Creating Statistics Graphs (e.g. usage per day) is easy using the Energy Dashboard:

    Note that there seems to be a bug in the graph, see https://github.com/home-assistant/frontend/issues/13995!

    "},{"location":"Integration-Home-Assistant/#influxdb-graphs","title":"InfluxDb Graphs","text":"

    See also Influx-DB.

    If you have setup InfluxDB already, it is also possible to fetch statistics from there, e.g. daily usage: 

    from(bucket: \"HomeAssistant\")\n|> range(start: v.timeRangeStart, stop: v.timeRangeStop)\n  |> filter(fn: (r) => r[\"entity_id\"] == \"wasserverbrauch_tag\")\n  |> filter(fn: (r) => r[\"_field\"] == \"value\")\n  |> timeShift(duration: -1d)\n  |> aggregateWindow(every: 1d, fn: max, createEmpty: false)\n  |> yield(name: \"mean\")\n

    "},{"location":"Integration-Home-Assistant/#using-rest","title":"Using REST","text":"

    When using REST, Home Assistant has to periodically call an URL on the ESP32 which in return provides the requested data.

    See REST API for a list of available URLs.

    The most practical one is the json entrypoint which provides the most relevant data JSON formatted: http://<IP>/json This would return: 

    {\n\"main\":\n  {\n    \"value\": \"512.3020\",\n    \"raw\": \"0512.3020\",\n    \"error\": \"no error\",\n    \"rate\": 0.000000,\n    \"timestamp\": \"2022-10-02T20:32:06\"\n   [..]\n  }\n}\n

    To do such a REST call, you need to create a REST sensor: 

    sensor:\n\n- platform: rest\n  name: \"Gasmeter JSON\" \n  resource: http://<IP>/json\n  json_attributes:\n    - main\n  value_template: '{{ value_json.value }}'\n  headers:\n    Content-Type: application/json\n  scan_interval: 60\n\ntemplate:\n  sensor:\n  - name: \"Gasmeter Value from JSON\"\n    unique_id: gas_meter_value_from_json\n    state: \"{{ state_attr('sensor.gasmeter_json','main')['value'] }}\"\n    unit_of_measurement: 'm\u00b3'\n\n  - name: \"Watermeter Value from JSON\"\n    unique_id: water_meter_value_from_json\n    state: >-\n            {{ state_attr('sensor.watermeter_json','main')['value'] | float }}\n    unit_of_measurement: 'm\u00b3'\n    device_class: water\n    state_class: total_increasing\n    icon: mdi:gauge\n

    The 2nd way is to use the html api call from value.html :

    sensor: - platform: rest resource: http://<IP>/value.html name: cold_water unique_id: cold_water_from_rest unit_of_measurement: \"L\" device_class: water state_class: total_increasing icon: mdi:gauge scan_interval : 120

    See also https://community.home-assistant.io/t/rest-sensor-nested-json/243420/9

    "},{"location":"Integration-Home-Assistant/#photo","title":"Photo","text":"

    REST can also be used to show the photo of the last round:

    To access it, use http://<IP>/img_tmp/alg_roi.jpg resp http://<IP>/img_tmp/raw.jpg.

    "},{"location":"Learn-models-with-your-own-images/","title":"Learn a model with your own images","text":"

    Once you have collected and selected your own images (see Collect images to improve the models), you can train your very own model with them.

    This is an optional step and only suggested for advances users!

    For training the model you will need a python and Jupyter installation.

    All current labeled images you can find under ziffer_sortiert_raw

    "},{"location":"Learn-models-with-your-own-images/#dig-class11-models-digits","title":"dig-class11 models (digits)","text":"

    Fork and checkout neural-network-digital-counter-readout.

    Install all requirements for running the notebooks.

    pip install -r requirements.txt\n

    Put your labeled images into /ziffer_sortiert_raw folder and run

    1. Image_Preparation.ipynb
    2. Train_CNN_Digital-Readout-Small-v2.ipynb

    It creates a dig-class11_xxxx_s2.tflite model, you can upload to the config folder on your device and test it.

    "},{"location":"Learn-models-with-your-own-images/#dig-class100-dig-cont-models-digits","title":"dig-class100 / dig-cont models (digits)","text":"

    Fork and checkout neural-network-digital-counter-readout.

    All labeled images you can find under Images

    Install all requirements for running the notebooks.

    pip install -r requirements.txt\n

    Put your labeled images into images/collected/<typeofdevice>/<your_short>/

    Run dig-class100-s2.ipynb. The model to upload to your device you can find under '/output'.

    "},{"location":"Learn-models-with-your-own-images/#ana-class100ana-cont-models-analog-pointers","title":"ana-class100/ana-cont models (analog pointers)","text":"

    Fork and checkout neural-network-analog-needle-readout.

    All labeled images you can find under data_raw_all

    Install all requirements for running the notebooks.

    pip install -r requirements.txt\n

    Put your labeled images into images/collected/<typeofdevice>/<your_short>/

    After every adding of images you need to run Image_Preparation.ipynb before you train the models.

    Run Train_CNN_Analog-Readout_100-Small1_Dropout.ipynb and/or Train_CNN_Analog-Readout_Version-Small2.ipynb. The model to upload to your device you can find in the project folder.

    "},{"location":"Learn-models-with-your-own-images/#share-your-images","title":"Share your images","text":"

    If the results are good you can share the images as pull-request. Please images only!

    See Share your images for details.

    "},{"location":"MQTT-API/","title":"MQTT API","text":"

    The device is capable to register to a MQTT broker to publish data and subscribe to specific topics.

    Note

    Only MQTT v3.1.1 is supported.

    The MQTT service has to be enabled and configured properly in the device configuration via web interface (Settings -> Configuration -> section MQTT)

    The following parameters have to be defined: * URI * MainTopic (optional, if not set, the hostname is used) * ClientID (optional, if not set, AIOTED- + the MAC address gets used to make sure the ID is unique) * User (optional) * Password (optional) * RetainFlag (optional)

    "},{"location":"MQTT-API/#published-topics","title":"Published topics","text":""},{"location":"MQTT-API/#status","title":"Status","text":"

    The following overhead data are available under the main topic (i.e. watermeter):

    Topic Description watermeter/MAC The MAC address of the ESP module. watermeter/IP The IP address of the ESP module. watermeter/Hostname The network host name of the ESP module. watermeter/Interval The round interval as configured during setup or in Parameters -> Interval. watermeter/Connection Network connection status. watermeter/Uptime Seconds up since last boot. watermeter/FreeMem Free memory in kB. watermeter/wifiRSSI Quality of WiFi signal. watermeter/CPUTemp Temperature of the ESP CPU in degrees celsius."},{"location":"MQTT-API/#result","title":"Result","text":"

    The following calculation data are available under the sup-topic main (i.e. watermeter/main):

    Topic Description watermeter/main/error Informs about the flow status. On success, the value is no error. watermeter/main/raw The value before performing post processing. watermeter/main/value The value after performing post processing. watermeter/main/rate How much flow was consumed in one minute. watermeter/main/rate_per_time_unit How much flow was consumed in one minute. The time unit gets set with the Home Assistant Discovery, e.g. h (hours) or m (minutes). watermeter/main/changeabsolut Difference between the previous and actual read value. watermeter/main/rate_per_digitization_round How much flow was consumed in one minute. watermeter/main/timestamp Timestamp of the last valid reading (equal to timestamp of previous value) watermeter/main/Status Informs about the last performed step of the watermeter (i.e. Flow finished). watermeter/main/json This is a JSON formatted object containing the following values: value, raw, pre, error, rate, timestamp."},{"location":"MQTT-API/#gpio","title":"GPIO","text":"

    MainTopic/{GPIO topic}, e.g. watermeter/GPIO/GPIO12

    "},{"location":"MQTT-API/#gpiogpiopinnumber","title":"GPIO/GPIO{PinNumber}","text":"

    Depending on device configuration (Settings --> Configuration --> section GPIO)

    "},{"location":"MQTT-API/#subscribed-topics","title":"Subscribed topics","text":"

    MainTopic/{subscribed topic}, e.g. watermeter/ctrl/flow_start

    "},{"location":"MQTT-API/#control","title":"Control","text":""},{"location":"MQTT-API/#ctrlflow_start","title":"ctrl/flow_start","text":"

    Trigger a flow start by publishing to this topic.

    This will automatically reset the flow interval.

    "},{"location":"MQTT-API/#ctrlset_prevalue","title":"ctrl/set_prevalue","text":"

    Note

    This feature is available since version 15.2.0.

    Set the last valid value (previous value) to given value or the actual RAW value. Payload needs to be provided in JSON notation.

    Payload:

    • Set to given value (value >= 0): {\"numbersname\": \"<NUMBERSNAME>\", \"value\": <VALUE>}

      • \"numbersname\":Provide name of number sequence, e.g. \"main\"
      • \"value\": provide the value to be set, eg. 12345.67890

    • Set to actual RAW value (value < 0, a valid RAW value is mandatory): {\"numbersname\": \"<NUMBERSNAME>\", \"value\": -1}

      • \"numbersname\": Provide name of number sequence, e.g. \"main\"
      • \"value\": Provide any negative number
    "},{"location":"MQTT-API/#gpiogpiopinnumber_1","title":"GPIO/GPIO{PinNumber}","text":"

    Depending on device configuration (Settings --> Configuration --> section GPIO)

    "},{"location":"Neural-Network-Types/","title":"Neural Network Types","text":"

    Note

    For an overview, see Choosing the Model.

    This section is describing the different types of neural networks, that are used with the AI-on-the-edge approach and gives an introduction on how and where to use them.

    "},{"location":"Neural-Network-Types/#overview-neural-network-type","title":"Overview neural network type","text":"

    There are two types of input:

    • digits with rolling number (top town)

    • analog pointers (clockwise rotating pointer)

    There are two types of neural networks:

    • classification networks with discrete output neurons for each result class:
    • 11 classes for digits (0, 1, ... 8, 9 + \"Not-A-Number\")
    • 100 classes for digits or analog pointers (0.1, 0.2, 0.3, ... , 9.7, 9.8, 9.9)
    • continuous output networks with a continuous output in the interval [0, 10[

    No setting of the type in the firmware is necessary. The type can detect by the output structure automatically.

    Warning

    • It is very important to choose the right network type (digits or analog pointers). Technically a wrong network will work and create output, but that would be totally arbitrary
    • Not all type of pointers are trained in all networks.
    • For the 11 classes digits network there many different types of digits trained. The reason is, that you 1) only need 20-30 training images and 2) the data collection is ongoing much longer
    • For the continuous and 100 classes network especially for the digits, there are only a few types of digits trained up to now
    • Therefore sometimes for the digits it is more effective to choose the simpler 11 classes network type (= default).
    "},{"location":"Neural-Network-Types/#naming-convention","title":"Naming convention","text":"Classification11 classes0, 1, ... 9 + \"N\" Classification100 classes0.0, 0.1, ... 9.9 ContinuousInterval[0, 10[ Digits dig-class11_XXX.tflite dig-class100_XXX.tflite dig-cont_XXX.tflite Analog Pointers ana-class100_XXX.tflite ana-cont_XXX.tflite

    XXX contains the versioning and a parameter for different sizes with the following naming:

    XXX = versioning_sY

    • versioning = version or in newer networks the training data

    • Y = Neural network size (typically s1, s2, ..., s4). Whereas s1 is the maximum sized neural network and s4 is the smallest.

    Optional the naming ends with an \"_q\" to signal, that the tflite file has been quantized (size reduction with minimum accuracy loss).

    Example: dig-class11_1410_s2_q.tflite

    • Classification network for digits with 11 classes (0, 1, 2, 3, 4, 5, 6, 7, 8, 9, N)
    • Version 1410 = 14.1.0
    • s2 = Size 2 (Medium)
    • q = Quantized Version
    "},{"location":"Neural-Network-Types/#overview-of-trained-types-and-details","title":"Overview of trained types and details","text":""},{"location":"Neural-Network-Types/#analog-pointer-ana-cont_xxxtflite-ana-class100_xxxtflite","title":"Analog Pointer (\"ana-cont_XXX.tflite\" & \"ana-class100_XXX.tflite\")","text":"

    This is to transfer the direction of a pointer into a continuous number between 0 and 1, whereas 0 (=1) is the upwards position (12 o'clock), 0.25 corresponds to the 3 o'clock positions and so on. This network is a envelop for all different types of pointers. Currently there are no dedicated network trainings for specific types of pointers.

    There are two types of network structure, currently both are supported. The \"class100\" is a pure classification network, that might need a bit more accuracy in the labeling. \"cont\" is a no classic approach with a continuous output off only 2 neurons (details see below).

    "},{"location":"Neural-Network-Types/#types-of-counters-trained","title":"Types of counters trained:","text":""},{"location":"Neural-Network-Types/#training-data-needs","title":"Training data needs","text":"
    • Quadratic images, minimum size: 32x32 pixel
    • Typically 100 - 200 images with a resolution of 1/100 of the full rotation (every 0.1 value or 3.6\u00b0)
    • Naming: x.y_ARBITRARY.jpg, where x.y = value 0.0 ... 9.9
    "},{"location":"Neural-Network-Types/#cnn-technical-details","title":"CNN Technical details:","text":""},{"location":"Neural-Network-Types/#input","title":"Input","text":"
    • 32 x 32 RGB images
    "},{"location":"Neural-Network-Types/#output","title":"Output","text":"
    • ana-cont_XXX.tflite:
    • 2 neurons with output in range [-1, 1] - representing a sinus / cosine encoding of the angle

    • needs to be converted to angle with arctan-hyperbolic function

    • ana-class100_XXX.tflite

    • 100 neurons representing the classes from 0.0, 0.1, ... 9.8, 9.9
    "},{"location":"Neural-Network-Types/#digits-with-11-classes-dig-class11_xxxtflite","title":"Digits with 11 classes (\"dig-class11_XXX.tflite\")","text":"

    The digit type is a classical classification network, with 11 classes representing the numbers 0, 1, ... 9 and the special class \"N\". It is trained for the rolling ring of gas and electric meters. As there is sometime a status between two images, the special class \"N\" is representing Not-A-Number for the case, that the image cannot be unique classified to one number e.g. because it is between two digits. For this type the lowest amount of training data per type is needed, resulting in a large variety of type being already part of the training set.

    "},{"location":"Neural-Network-Types/#types-of-counters-trained_1","title":"Types of counters trained:","text":""},{"location":"Neural-Network-Types/#training-data-needs_1","title":"Training data needs","text":"
    • RGB images, with minimum size: 20x32 pixel

    • Typically 10 - 20 images (1-2 for each digit and an arbitrary number for the \"N\" class

    • Naming: x_ARBITRARY.jpg, where x = value 0 ... 9 + N

    "},{"location":"Neural-Network-Types/#cnn-technical-details_1","title":"CNN Technical details:","text":""},{"location":"Neural-Network-Types/#input_1","title":"Input","text":"
    • 20 x 32 RGB images
    "},{"location":"Neural-Network-Types/#output_1","title":"Output","text":"
    • 11 neurons for image classification (last layer normalized to 1)
    • Neuron 0 to 9 represent the corresponding numbers \"0\" to \"9\"
    • Neuron 10 represents the \"Not-A-Number\" class, telling, that the image is not uniquely classified
    "},{"location":"Neural-Network-Types/#digits-with-rolling-results-dig-class100_xxxtflite-dig-cont_xxxtflite","title":"Digits with rolling results (\"dig-class100_XXX.tflite\" & \"dig-cont_XXX.tflite\")","text":"

    This type of network tries to overcome the problem, that there are intermediate values, when a rolling digit is between two numbers. Previous this was the \"N\" class. In this network type, there are also sub-digit values trained, so that the intermediate state can be used as additional information for the algorithms.

    "},{"location":"Neural-Network-Types/#types-of-counters-trained_2","title":"Types of counters trained:","text":""},{"location":"Neural-Network-Types/#training-data-needs_2","title":"Training data needs","text":"
    • RGB images, with minimum size: 20x32 pixel

    • Typically 100 - 200 images (1-2 for each possible position)

    • Naming: x.y_ARBITRARY.jpg, where x.y = 0.0, 0.1, ... 9.9 representing the intermediate state

    "},{"location":"Neural-Network-Types/#cnn-technical-details_2","title":"CNN Technical details:","text":""},{"location":"Neural-Network-Types/#input_2","title":"Input","text":"
    • 20 x 32 RGB images
    "},{"location":"Neural-Network-Types/#output_2","title":"Output","text":"
    • dig-cont_XXX.tflite:
    • 10 neurons representing the digits 0, 1, ... 9. The intermediate values are represented by weighted normalized values of two neighboring output neurons

    • needs to be converted to angle with arctan-hyperbolic function

    • dig-class100_XXX.tflite

    • 100 neurons representing the classes from 0.0, 0.1, ... 9.8, 9.9
    "},{"location":"New-Releases-Notification/","title":"Notification about new Releases","text":"

    Do you want to get notified about a new release? There are several ways for it:

    "},{"location":"New-Releases-Notification/#github-notifications","title":"Github Notifications","text":"

    You will need a Github Account for this!

    1. Log into your Github account on Github.
    2. Go to AI-on-the-edge-device.
    3. On the top right side, click onto Watch and select Custom:
    4. Select Releases.

    You will get an email when a new release gets created.

    See also Github Documentation.

    "},{"location":"New-Releases-Notification/#codereleaseio","title":"CodeRelease.io","text":"

    Alternatively or if you do not want to create a Github account, CodeRelease.io can be an alternative.

    You also have to subscribe with an email address but no account is required.

    "},{"location":"Parameters/","title":"Parameters","text":"

    This page lists all available Configuration Parameters. If a parameter or section has a tick box on its left side, you can disable it. In such case the functionality gets disabled respectively the default values will be used.

    Note

    This is an auto-generated page! See the README for details!

    "},{"location":"Parameters/#section-takeimage","title":"Section TakeImage","text":""},{"location":"Parameters/#parameter-camaelevel","title":"Parameter CamAeLevel","text":"

    Auto-Exposure-Level

    range on OV2640 (-2 .. 2) range on OV3660 and OV5640 (-5 .. 5)

    Section: TakeImage

    Default Value: 0

    See here for the ov2640 camera datasheet. See here for the ov5640 camera datasheet.

    Warning

    This is an Expert Parameter! Only change it if you understand what it does!

    After changing this parameter you need to update your reference image and alignment markers!

    Note

    The exposure offset for automatic exposure, lower values produce darker image.

    Note

    This parameter can also be set on the Reference Image configuration page!

    "},{"location":"Parameters/#parameter-camaec","title":"Parameter CamAec","text":"

    Auto-Exposure-Control

    • When true, the camera attempts to automatically control the exposure.
    • When false, the CamAecValue setting is used instead.

    Section: TakeImage

    Default Value: true

    See here for the ov2640 camera datasheet. See here for the ov5640 camera datasheet.

    Warning

    This is an Expert Parameter! Only change it if you understand what it does!

    After changing this parameter you need to update your reference image and alignment markers!

    Note

    This parameter can also be set on the Reference Image configuration page!

    "},{"location":"Parameters/#parameter-camaec2","title":"Parameter CamAec2","text":"

    Auto-Exposure-Control2

    • When true, the sensor\u2019s \"night mode\" is enabled, extending the range of automatic gain control.
    • When false, the sensor\u2019s \"night mode\" is disabled.

    Section: TakeImage

    Default Value: true

    See here for the ov2640 camera datasheet. See here for the ov5640 camera datasheet.

    Warning

    This is an Expert Parameter! Only change it if you understand what it does!

    After changing this parameter you need to update your reference image and alignment markers!

    Note

    This may resolve some over-exposure and under-exposure issues.

    Note

    This parameter can also be set on the Reference Image configuration page!

    "},{"location":"Parameters/#parameter-camaecvalue","title":"Parameter CamAecValue","text":"

    Auto-Exposure-Value

    Range (0 .. 1200)

    Section: TakeImage

    Default Value: 160

    See here for the ov2640 camera datasheet. See here for the ov5640 camera datasheet.

    Warning

    This is an Expert Parameter! Only change it if you understand what it does!

    After changing this parameter you need to update your reference image and alignment markers!

    Note

    Access the exposure value of the camera, higher values produce brighter images.

    Note

    This parameter can also be set on the Reference Image configuration page!

    "},{"location":"Parameters/#parameter-camagc","title":"Parameter CamAgc","text":"

    Auto-Gain-Control

    • When true, the camera attempts to automatically control the sensor gain, up to the value in the CamGainceiling property.
    • When false, the CamAgcGain setting is used instead.

    Section: TakeImage

    Default Value: true

    See here for the ov2640 camera datasheet. See here for the ov5640 camera datasheet.

    Warning

    This is an Expert Parameter! Only change it if you understand what it does!

    After changing this parameter you need to update your reference image and alignment markers!

    "},{"location":"Parameters/#parameter-camagcgain","title":"Parameter CamAgcGain","text":"

    Auto-Gain-Control-Value

    Range (0 .. 30)

    Section: TakeImage

    Default Value: 15

    See here for the ov2640 camera datasheet. See here for the ov5640 camera datasheet.

    Warning

    This is an Expert Parameter! Only change it if you understand what it does!

    After changing this parameter you need to update your reference image and alignment markers!

    Note

    This is used when CamAgc is off.

    Note

    Access the gain level of the sensor, higher values produce brighter images.

    "},{"location":"Parameters/#parameter-camautosharpness","title":"Parameter CamAutoSharpness","text":"

    Auto-Sharpness

    • When true, the camera attempts to automatically adjusts the sharpness.
    • When false, the CamSharpness setting is used instead.

    Section: TakeImage

    Default Value: false

    See here for the ov2640 camera datasheet. See here for the ov5640 camera datasheet.

    Warning

    This is an Expert Parameter! Only change it if you understand what it does!

    After changing this parameter you need to update your reference image and alignment markers!

    Note

    The OV2640 does not officially support auto sharpness, this is an experimental parameter!

    Note

    This parameter can also be set on the Reference Image configuration page!

    "},{"location":"Parameters/#parameter-camawb","title":"Parameter CamAwb","text":"

    Auto-White-Balance

    • When true, the camera attempts to automatically control white balance.
    • When false, the CamWbMode setting is used instead.

    Section: TakeImage

    Default Value: true

    See here for the ov2640 camera datasheet. See here for the ov5640 camera datasheet.

    Warning

    This is an Expert Parameter! Only change it if you understand what it does!

    After changing this parameter you need to update your reference image and alignment markers!

    "},{"location":"Parameters/#parameter-camawbgain","title":"Parameter CamAwbGain","text":"

    Auto-White-Balance-Gain

    • Enable/Disable CamAwbGain control.

    Section: TakeImage

    Default Value: true

    See here for the ov2640 camera datasheet. See here for the ov5640 camera datasheet.

    Warning

    This is an Expert Parameter! Only change it if you understand what it does!

    After changing this parameter you need to update your reference image and alignment markers!

    "},{"location":"Parameters/#parameter-cambpc","title":"Parameter CamBpc","text":"

    Black-Pixel-Correction

    • Enable/Disable black point compensation, this can make black parts of the image darker.

    Section: TakeImage

    Default Value: true

    See here for the ov2640 camera datasheet. See here for the ov5640 camera datasheet.

    Warning

    This is an Expert Parameter! Only change it if you understand what it does!

    After changing this parameter you need to update your reference image and alignment markers!

    "},{"location":"Parameters/#parameter-cambrightness","title":"Parameter CamBrightness","text":"

    Image-Brightness

    Range (-2 .. 2)

    Section: TakeImage

    Default Value: 0

    See here for the ov2640 camera datasheet. See here for the ov5640 camera datasheet.

    Warning

    After changing this parameter you need to update your reference image and alignment markers!

    Note

    This parameter can also be set on the Reference Image configuration page!

    "},{"location":"Parameters/#parameter-camcolorbar","title":"Parameter CamColorbar","text":"

    Colorbar

    currently not implemented.

    Section: TakeImage

    Default Value: false

    See here for the ov2640 camera datasheet. See here for the ov5640 camera datasheet.

    Warning

    This is an Expert Parameter! Only change it if you understand what it does!

    "},{"location":"Parameters/#parameter-camcontrast","title":"Parameter CamContrast","text":"

    Image-Contrast

    Range (-2 .. 2)

    Section: TakeImage

    Default Value: 0

    See here for the ov2640 camera datasheet. See here for the ov5640 camera datasheet.

    Warning

    After changing this parameter you need to update your reference image and alignment markers!

    Note

    This parameter can also be set on the Reference Image configuration page!

    "},{"location":"Parameters/#parameter-camdcw","title":"Parameter CamDcw","text":"

    Image-Downsize

    • When CamDcw is on, the image that you receive will be the size that you requested (VGA, QQVGA, etc).
    • When CamDcw is off, the image that you receive will be one of UXGA, SVGA, or CIF.

    Section: TakeImage

    Default Value: true

    See here for the ov2640 camera datasheet. See here for the ov5640 camera datasheet.

    Warning

    This is an Expert Parameter! Only change it if you understand what it does!

    After changing this parameter you need to update your reference image and alignment markers!

    If CamZoom is used, this must be activated.

    Note

    If CamDcw is off, and you pick a different image size, this implicitly turns CamDcw back on again.

    "},{"location":"Parameters/#parameter-camdenoise","title":"Parameter CamDenoise","text":"

    Image-Denoise

    • Denoise Image, is only supported by OV3660 and OV5640

    range on OV3660 and OV5640 (0 .. 8)

    Section: TakeImage

    Default Value: 0

    See here for the ov2640 camera datasheet. See here for the ov5640 camera datasheet.

    Warning

    This is an Expert Parameter! Only change it if you understand what it does!

    "},{"location":"Parameters/#parameter-camgainceiling","title":"Parameter CamGainceiling","text":"

    Gain-Ceiling

    Available options:

    • x2
    • x4
    • x8
    • x16
    • x32
    • x64
    • x128

    Default Value for ov2640: x4 Default Value for ov5640: x8

    See here for the ov2640 camera datasheet. See here for the ov5640 camera datasheet.

    Warning

    This is an Expert Parameter! Only change it if you understand what it does!

    After changing this parameter you need to update your reference image and alignment markers!

    Note

    A higher gain means that the sensor has a greater response to light, but also makes sensor noise more visible.

    This is used when CamAgc is on.

    Note

    The Gain is an analog multiplier applied to the raw sensor data. The Ceiling is the maximum gain value that the sensor will use.

    "},{"location":"Parameters/#parameter-camhmirror","title":"Parameter CamHmirror","text":"

    Mirror-Image

    • When true, the camera image is mirrored left-to-right.

    Section: TakeImage

    Default Value: false

    See here for the ov2640 camera datasheet. See here for the ov5640 camera datasheet.

    Warning

    After changing this parameter you need to update your reference image and alignment markers!

    Note

    This parameter can also be set on the Reference Image configuration page!

    "},{"location":"Parameters/#parameter-camlenc","title":"Parameter CamLenc","text":"

    Lens-Correction

    • Enable/Disable lens correction.

    Section: TakeImage

    Default Value: true

    See here for the ov2640 camera datasheet. See here for the ov5640 camera datasheet.

    Warning

    This is an Expert Parameter! Only change it if you understand what it does!

    After changing this parameter you need to update your reference image and alignment markers!

    Note

    This can help compensate for light fall-off at the edge of the sensor area.

    "},{"location":"Parameters/#parameter-camquality","title":"Parameter CamQuality","text":"

    Image-Quality

    Range (8 .. 63)

    Section: TakeImage

    Default Value: 10

    See here for the ov2640 camera datasheet. See here for the ov5640 camera datasheet.

    Warning

    This is an Expert Parameter! Only change it if you understand what it does!

    After changing this parameter you need to update your reference image and alignment markers!

    Value below 10 could result in system instabilities!

    Note

    Quality index for pictures: 8 (highest quality) ... 63 (lowest quality)

    This is similar to the quality setting when exporting a jpeg image from photo editing software.

    "},{"location":"Parameters/#parameter-camrawgma","title":"Parameter CamRawGma","text":"

    Raw-Gamma

    • Enable/Disable raw gamma mode.

    Section: TakeImage

    Default Value: true

    See here for the ov2640 camera datasheet. See here for the ov5640 camera datasheet.

    Warning

    This is an Expert Parameter! Only change it if you understand what it does!

    After changing this parameter you need to update your reference image and alignment markers!

    Note

    The main purpose of the Gamma (GMA) function is to compensate for the non-linear characteristics of the sensor. GMA converts the pixel values according to the Gamma curve to compensate the sensor output under different light strengths. The non-linear gamma curve is approximately constructed with different linear functions. Raw gamma compensates the image in the RAW domain.

    "},{"location":"Parameters/#parameter-camsaturation","title":"Parameter CamSaturation","text":"

    Image-Saturation

    Range (-2 .. 2)

    Section: TakeImage

    Default Value: 0

    See here for the ov2640 camera datasheet. See here for the ov5640 camera datasheet.

    Warning

    After changing this parameter you need to update your reference image and alignment markers!

    Note

    Positive values increase saturation (more vibrant colors), negative values lower it (more muted colors).

    Note

    This parameter can also be set on the Reference Image configuration page!

    "},{"location":"Parameters/#parameter-camsharpness","title":"Parameter CamSharpness","text":"

    Image-Sharpness

    Range (-2 .. 2)

    Section: TakeImage

    Default Value: 0

    See here for the ov2640 camera datasheet. See here for the ov5640 camera datasheet.

    Warning

    This is an Expert Parameter! Only change it if you understand what it does!

    After changing this parameter you need to update your reference image and alignment markers!

    Note

    The OV2640 does not officially support sharpness, this is an experimental parameter!

    Note

    Positive values increase sharpness (more defined edges), negative values lower it (softer edges).

    This is used when CamAutoSharpness is off.

    Note

    This parameter can also be set on the Reference Image configuration page!

    "},{"location":"Parameters/#parameter-camspecialeffect","title":"Parameter CamSpecialEffect","text":"

    Image-Special-Effect

    Available options:

    • no_effect
    • negative
    • grayscale
    • red
    • green
    • blue
    • retro

    Section: TakeImage

    Default Value: no_effect

    See here for the ov2640 camera datasheet. See here for the ov5640 camera datasheet.

    Warning

    This is an Expert Parameter! Only change it if you understand what it does!

    After changing this parameter you need to update your reference image and alignment markers!

    Note

    This parameter can also be set on the Reference Image configuration page!

    "},{"location":"Parameters/#parameter-camvflip","title":"Parameter CamVflip","text":"

    Flip-Image

    • When true, the camera image is flipped top-to-bottom.

    Section: TakeImage

    Default Value: false

    See here for the ov2640 camera datasheet. See here for the ov5640 camera datasheet.

    Warning

    After changing this parameter you need to update your reference image and alignment markers!

    Note

    On some OV5640 Cameras, the image becomes reddish when Vflip is used in conjunction with the zoom function!

    Note

    This parameter can also be set on the Reference Image configuration page!

    "},{"location":"Parameters/#parameter-camwbmode","title":"Parameter CamWbMode","text":"

    White-Balance-Mode

    Available options:

    • auto
    • sunny
    • cloudy
    • office
    • home

    Section: TakeImage

    Default Value: auto

    See here for the ov2640 camera datasheet. See here for the ov5640 camera datasheet.

    Warning

    After changing this parameter you need to update your reference image and alignment markers!

    Note

    This is used when CamAwb is off.

    Note

    This parameter can also be set on the Reference Image configuration page!

    "},{"location":"Parameters/#parameter-camwpc","title":"Parameter CamWpc","text":"

    White-Pixel-Correction

    • Enable/Disable white point compensation, his can make white parts of the image whiter.

    Section: TakeImage

    Default Value: true

    See here for the ov2640 camera datasheet. See here for the ov5640 camera datasheet.

    Warning

    After changing this parameter you need to update your reference image and alignment markers!

    Note

    This parameter can also be set on the Reference Image configuration page!

    "},{"location":"Parameters/#parameter-camzoom","title":"Parameter CamZoom","text":"

    Digital-Zoom

    • Enable/Disable digital zoom.

    Section: TakeImage

    Default Value: false

    See here for the ov2640 camera datasheet. See here for the ov5640 camera datasheet.

    Warning

    This is an Expert Parameter! Only change it if you understand what it does!

    After changing this parameter you need to update your reference image and alignment markers!

    Note

    It is always zoomed into the center of the image, if CamZoomOffsetX and CamZoomOffsetY are zero.

    Note

    This parameter can also be set on the Reference Image configuration page!

    "},{"location":"Parameters/#parameter-camzoomoffsetx","title":"Parameter CamZoomOffsetX","text":"

    Digital-Zoom-OffsetX

    range on OV2640 (-480 .. 480) range on OV3660 (-704 .. 704) range on OV5640 (-960 .. 960)

    Section: TakeImage

    Default Value: 0

    See here for the ov2640 camera datasheet. See here for the ov5640 camera datasheet.

    Warning

    This is an Expert Parameter! Only change it if you understand what it does!

    After changing this parameter you need to update your reference image and alignment markers!

    Note

    X displacement of the image from the center. Positive values \u200b\u200bshift the image to the right, negative values \u200b\u200bto the left. The maximum possible offset depends on the value of the CamZoomSize.

    Note

    This parameter can also be set on the Reference Image configuration page!

    "},{"location":"Parameters/#parameter-camzoomoffsety","title":"Parameter CamZoomOffsetY","text":"

    Digital-Zoom-OffsetY

    range on OV2640 (-360 .. 360) range on OV3660 (-528 .. 528) range on OV5640 (-720 .. 720)

    Section: TakeImage

    Default Value: 0

    See here for the ov2640 camera datasheet. See here for the ov5640 camera datasheet.

    Warning

    This is an Expert Parameter! Only change it if you understand what it does!

    After changing this parameter you need to update your reference image and alignment markers!

    Note

    Y displacement of the image from the center. Positive values \u200b\u200bmove the image up, negative values \u200b\u200bmove the image down. The maximum possible offset depends on the value of the CamZoomSize.

    Note

    This parameter can also be set on the Reference Image configuration page!

    "},{"location":"Parameters/#parameter-camzoomsize","title":"Parameter CamZoomSize","text":"

    Digital-Zoom-Size

    range on OV2640 (0 .. 29) range on OV3660 (0 .. 43) range on OV5640 (0 .. 59)

    Section: TakeImage

    Default Value: 0

    See here for the ov2640 camera datasheet. See here for the ov5640 camera datasheet.

    Warning

    This is an Expert Parameter! Only change it if you understand what it does!

    After changing this parameter you need to update your reference image and alignment markers!

    Note

    Zoom factor/level of the digital zoom, the larger the value, the more it zooms in.

    Note

    This parameter can also be set on the Reference Image configuration page!

    "},{"location":"Parameters/#parameter-demo","title":"Parameter Demo","text":"

    Enable to use demo images instead of the real camera images. Make sure to have a /demo folder on your SD-Card and make sure it contains the expected files! Check here for details.

    Section: TakeImage

    Default Value: false

    Warning

    This is an Expert Parameter! Only change it if you understand what it does!

    "},{"location":"Parameters/#parameter-ledintensity","title":"Parameter LEDIntensity","text":"

    Set the Flash LED Intensity: (0 .. 100)

    Section: TakeImage

    Default Value: 50

    Note

    After changing this parameter you need to update your reference image and alignment markers!

    Note

    This parameter can also be set on the Reference Image configuration page!

    "},{"location":"Parameters/#parameter-rawimageslocation","title":"Parameter RawImagesLocation","text":"

    Location on the SD-Card to store the raw images.

    Section: TakeImage

    Default Value: /log/source

    Warning

    A SD-Card has limited write cycles. Since the device does not do Wear Leveling, this can wear out your SD-Card!

    "},{"location":"Parameters/#parameter-rawimagesretention","title":"Parameter RawImagesRetention","text":"

    Number of days to keep the raw images (0 = forever)

    Unit: Days

    Section: TakeImage

    Default Value: 15

    "},{"location":"Parameters/#parameter-waitbeforetakingpicture","title":"Parameter WaitBeforeTakingPicture","text":"

    Waiting time between switching the flash light (onboard LED) on and taking the picture.

    Unit: seconds

    Section: TakeImage

    Default Value: 5

    Warning

    This is an Expert Parameter! Only change it if you understand what it does!

    "},{"location":"Parameters/#section-alignment","title":"Section Alignment","text":""},{"location":"Parameters/#parameter-alignmentalgo","title":"Parameter AlignmentAlgo","text":"

    Section: Alignment

    Default Value: Default

    Warning

    This is an Expert Parameter! Only change it if you understand what it does!

    Algorithm used for the alignment step.

    Available options:

    • Default: Use only red color channel
    • HighAccuracy: Use all 3 color channels (3x slower)
    • Fast: First time use HighAccuracy, then only check if the image is shifted
    • Off: Disable alignment algorithm

    "},{"location":"Parameters/#parameter-initialrotate","title":"Parameter InitialRotate","text":"

    Section: Alignment

    Default Value: 0

    Unit: Degrees

    Note

    This parameter can also be set on the Reference Image configuration page!

    Note

    After changing this parameter you need to update your reference image and alignment markers!

    Initial rotation of image before alignment in degree (-360 .. +360)

    "},{"location":"Parameters/#parameter-searchfieldx","title":"Parameter SearchFieldX","text":"

    Section: Alignment

    Default Value: 20

    Unit: Pixels

    Warning

    This is an Expert Parameter! Only change it if you understand what it does!

    X-size (width) in which the reference is searched.

    Note

    Since the alignment is one of the steps using a lot of computation time, the search field should be as small as possible. The calculation time goes quadratic with the search field size.

    "},{"location":"Parameters/#parameter-searchfieldy","title":"Parameter SearchFieldY","text":"

    Section: Alignment

    Default Value: 20

    Unit: Pixels

    Warning

    This is an Expert Parameter! Only change it if you understand what it does!

    Y-size (height) in which the reference is searched.

    Note

    Since the alignment is one of the steps using a lot of computation time, the search field should be as small as possible. The calculation time goes quadratic with the search field size.

    "},{"location":"Parameters/#section-digits","title":"Section Digits","text":""},{"location":"Parameters/#parameter-cnngoodthreshold","title":"Parameter CNNGoodThreshold","text":"

    Section: Digits

    Default Value: 0.5

    Warning

    This is an Expert Parameter! Only change it if you understand what it does!

    Threshold above which the classification should be to accept the value (only meaningful for digits).

    Warning

    This is only supported for the dig-class100 models!

    "},{"location":"Parameters/#parameter-model","title":"Parameter Model","text":"

    Section: Digits

    Default Value: /config/dig-cont_*.tflite (See /config/config.ini)

    Path to CNN model file for image recognition. See here for details.

    "},{"location":"Parameters/#parameter-roiimageslocation","title":"Parameter ROIImagesLocation","text":"

    Section: Digits

    Default Value: /log/digit

    Location to store separated digit images on the SD-Card.

    Warning

    A SD-Card has limited write cycles. Since the device does not do Wear Leveling, this can wear out your SD-Card!

    "},{"location":"Parameters/#parameter-roiimagesretention","title":"Parameter ROIImagesRetention","text":"

    Section: Digits

    Default Value: 3

    Unit: Days

    Days to keep the separated digit images (0 = forever).

    "},{"location":"Parameters/#section-analog","title":"Section Analog","text":""},{"location":"Parameters/#parameter-cnngoodthreshold_1","title":"Parameter CNNGoodThreshold","text":"

    Section: Analog

    Default Value: 0.5

    Warning

    This is an Expert Parameter! Only change it if you understand what it does!

    Threshold above which the classification should be to accept the value (only meaningful for digits).

    Warning

    This is only supported for the ana-class100 models!

    "},{"location":"Parameters/#parameter-extendedresolution","title":"Parameter ExtendedResolution","text":"

    Warning

    This parameter is unused! Use NUMBER.ExtendedResolution instead!

    "},{"location":"Parameters/#parameter-model_1","title":"Parameter Model","text":"

    Section: Analog

    Default Value: /config/ana-cont_*.tflite (See /config/config.ini)

    Path to CNN model file for image recognition. See here for details.

    "},{"location":"Parameters/#parameter-roiimageslocation_1","title":"Parameter ROIImagesLocation","text":"

    Section: Analog

    Default Value: /log/analog

    Location to store separated analog images on the SD-Card.

    Warning

    A SD-Card has limited write cycles. Since the device does not do Wear Leveling, this can wear out your SD-Card!

    "},{"location":"Parameters/#parameter-roiimagesretention_1","title":"Parameter ROIImagesRetention","text":"

    Section: Analog

    Default Value: 3

    Unit: Days

    Days to keep the separated analog images (0 = forever).

    "},{"location":"Parameters/#section-postprocessing","title":"Section PostProcessing","text":""},{"location":"Parameters/#parameter-allownegativerates","title":"Parameter AllowNegativeRates","text":"

    Warning

    This parameter is unused! Use NUMBER.AllowNegativeRates instead!

    "},{"location":"Parameters/#parameter-errormessage","title":"Parameter ErrorMessage","text":"

    Section: PostProcessing

    Default Value: true

    Warning

    This is an Expert Parameter! Only change it if you understand what it does!

    Do not show error message in return value. In an error case, the last valid number will be used for the various transmission protocols (MQTT, InfluxDB, REST, ...).

    "},{"location":"Parameters/#parameter-allownegativerates_1","title":"Parameter AllowNegativeRates","text":"

    Section: PostProcessing

    Default Value: false

    Allow a meter to count backwards (decreasing values).

    Note

    This is unusual (it means there is a negative rate) and not wanted in most cases!

    Note

    This parameter must be prefixed with <NUMBER> followed by a dot (eg. main.AllowNegativeRates). <NUMBER> is the name of the number sequence defined in the ROI's.

    "},{"location":"Parameters/#parameter-analogtodigittransitionstart","title":"Parameter AnalogToDigitTransitionStart","text":"

    Section: PostProcessing

    Default Value: 9.2

    This can be used if you have wrong values, but the recognition of the individual ROIs are correct. Look for the start of changing of the first digit and note the analog pointer value behind. Set it here. Only used on combination of digits and analog pointers. See here for details.

    Range: 6.0 .. 9.9.

    Note

    This parameter must be prefixed with <NUMBER> followed by a dot (eg. main.AnalogToDigitTransitionStart). <NUMBER> is the name of the number sequence defined in the ROI's.

    "},{"location":"Parameters/#parameter-changeratethreshold","title":"Parameter ChangeRateThreshold","text":"

    Section: PostProcessing

    Default Value: 2

    Range: 0 .. 9.

    Threshold parameter for change rate detection. This parameter is intended to compensate for small reading fluctuations that occur when the meter does not change its value for a long time (e.g. at night) or slightly turns backwards. This can eg. happen on watermeters.

    It is only applied to the last digit of the read value (See example below). If the read value is within PreValue +/- Threshold, no further calculation is carried out and the Value/Prevalue remains at the old value.

    Note

    This parameter must be prefixed with <NUMBER> followed by a dot (eg. main.ChangeRateThreshold). <NUMBER> is the name of the number sequence defined in the ROI's.

    "},{"location":"Parameters/#example","title":"Example","text":"
    • Smallest ROI provides value for 0.000'x (Eg. a water meter with 4 pointers behind the decimal point)
    • ChangeRateThreshold = 2
    "},{"location":"Parameters/#with-extended-resolution-disabled","title":"With Extended Resolution disabled","text":"

    PreValue: 123.456'7 -> Threshold = +/-0.000'2. All changes between 123.456'5 and 123.456'9 get ignored

    "},{"location":"Parameters/#with-extended-resolution-enabled","title":"With Extended Resolution enabled","text":"

    PreValue: 123.456'78 -> Threshold = +/-0.000'02. All changes between 123.456'76 and 123.456'80 get ignored.

    "},{"location":"Parameters/#parameter-checkdigitincreaseconsistency","title":"Parameter CheckDigitIncreaseConsistency","text":"

    Section: PostProcessing

    Default Value: false

    Warning

    This is an Expert Parameter! Only change it if you understand what it does!

    An additional consistency check. It especially improves the zero crossing check between digits.

    Note

    This parameter must be prefixed with <NUMBER> followed by a dot (eg. main.CheckDigitIncreaseConsistency). <NUMBER> is the name of the number sequence defined in the ROI's.

    "},{"location":"Parameters/#parameter-decimalshift","title":"Parameter DecimalShift","text":"

    Section: PostProcessing

    Default Value: 0

    Shift the decimal separator (positiv or negativ). Eg. to move from m\u00b3 to liter (1 m\u00b3 equals 1000 liters), you need to set it to +3.

    Note

    This parameter must be prefixed with <NUMBER> followed by a dot (eg. main.DecimalShift). <NUMBER> is the name of the number sequence defined in the ROI's.

    "},{"location":"Parameters/#parameter-extendedresolution_1","title":"Parameter ExtendedResolution","text":"

    Section: PostProcessing

    Default Value: false

    Use the decimal place of the last analog counter for increased accuracy.

    Note

    This parameter is only supported on the *-class* and *-const models! See Choosing-the-Model for details.

    Note

    This parameter must be prefixed with <NUMBER> followed by a dot (eg. main.ExtendedResolution). <NUMBER> is the name of the number sequence defined in the ROI's.

    "},{"location":"Parameters/#parameter-ignoreleadingnan","title":"Parameter IgnoreLeadingNaN","text":"

    Section: PostProcessing

    Default Value: true

    Leading N's will be deleted before further processing. This is only relevant for models which use N! See here for details.

    Note

    This parameter must be prefixed with <NUMBER> followed by a dot (eg. main.IgnoreLeadingNaN). <NUMBER> is the name of the number sequence defined in the ROI's.

    "},{"location":"Parameters/#parameter-maxratetype","title":"Parameter MaxRateType","text":"

    Section: PostProcessing

    Default Value: AbsoluteChange

    Defines if the Change Rate is calculated as the difference between the last two readings (AbsoluteChange = difference) or as the difference normalized to the interval (RateChange = difference per minute).

    Note

    This parameter must be prefixed with <NUMBER> followed by a dot (eg. main.MaxRateType). <NUMBER> is the name of the number sequence defined in the ROI's.

    "},{"location":"Parameters/#parameter-maxratevalue","title":"Parameter MaxRateValue","text":"

    Section: PostProcessing

    Default Value: 0,05

    Maximum allowed change between two readings, if exceeded the last reading will be rejected. Depending on the settings of <NUMBER>.MaxRateType the MaxRateValue is either treated as the difference between the two measurements (AbsoluteChange = difference) not taking the set time interval into account or as the difference normalized to the interval (RateChange = difference per minute).

    If negative rate is disallowed and no maximum rate value is set, one false high reading will lead to a period of missing measurements until the measurement reaches the previous false high reading. E.g. if the counter is at 600,00 and it's read incorrectly as610,00, all measurements will be skipped until the counter reaches 610,00. Setting the MaxRateValue to 0,05 leads to a rejection of all readings with a difference > 0,05, in this case 610,00. The rejection also applies to correct readings with a difference > 0,05!

    Note

    This parameter must be prefixed with <NUMBER> followed by a dot (eg. main.MaxRateValue). <NUMBER> is the name of the number sequence defined in the ROI's.

    "},{"location":"Parameters/#parameter-prevalueagestartup","title":"Parameter PreValueAgeStartup","text":"

    Section: PostProcessing

    Default Value: 720

    Warning

    This is an Expert Parameter! Only change it if you understand what it does!

    Time in minutes, how long a previous read value is valid after reboot.

    "},{"location":"Parameters/#parameter-prevalueuse","title":"Parameter PreValueUse","text":"

    Section: PostProcessing

    Default Value: true

    Use the previous value (value from previous round) for consistency checks. This also works through a reboot of the device!

    "},{"location":"Parameters/#section-mqtt","title":"Section MQTT","text":""},{"location":"Parameters/#parameter-cacert","title":"Parameter CACert","text":"

    Section: MQTT

    Default Value: \"\"

    Example: /config/certs/RootCA.crt.

    Warning

    This is an Expert Parameter! Only change it if you understand what it does!

    Path to the CA certificate file.

    This is part of the configuration to enable TLS 1.2 for MQTT.

    The CA Certificate is used by the client to validate the broker is who it claims to be. It allows the client to authenticate the server, which is the first part of the MTLS handshake.

    Usually there is a common RootCA certificate for the MQTT broker. More information is available here.

    For more information on how to create your own certificate, see: mosquitto.org or emqx.com.

    Note

    This also means that you might have to change the protocol and port in uri to mqtts://example.com:8883!

    Only Certificates up to 4096 Bit are supported!

    "},{"location":"Parameters/#parameter-clientcert","title":"Parameter ClientCert","text":"

    Section: MQTT

    Default Value: \"\"

    Example: /config/certs/client.crt.

    Warning

    This is an Expert Parameter! Only change it if you understand what it does!

    Path to the Client Certificate file.

    This is part of the configuration to enable TLS 1.2 for MQTT.

    The Client Certificate is used by the client to prove its identity to the server, in conjunction with the Client Key. It is the second part of the MTLS handshake.

    Usually there is a one pair of Client Certificate/Key for each client that connects to the MQTT broker. More information is available here.

    For more information on how to create your own certificate, see: mosquitto.org or emqx.com.

    Note

    If set, ClientKey must be set too. This also means that you might have to change the protocol and port in uri to mqtts://example.com:8883!

    "},{"location":"Parameters/#parameter-clientid","title":"Parameter ClientID","text":"

    Section: MQTT

    Default Value: watermeter

    Client ID used to connect to the MQTT broker. If disabled, the hostname will be used.

    "},{"location":"Parameters/#parameter-clientkey","title":"Parameter ClientKey","text":"

    Section: MQTT

    Default Value: \"\"

    Example: /config/certs/client.key.

    Warning

    This is an Expert Parameter! Only change it if you understand what it does!

    Path to the Client Key file.

    This is part of the configuration to enable TLS 1.2 for MQTT.

    The Client Key is used by the client to prove its identity to the server, in conjunction with the Client Certificate. It is the second part of the MTLS handshake.

    Usually there is a one pair of Client Certificate/Key for each client that connects to the MQTT broker

    For more information on how to create your own certificate, see: mosquitto.org or emqx.com.

    Note

    If set, ClientCert must be set too. This also means that you might have to change the protocol and port in uri to mqtts://example.com:8883!

    "},{"location":"Parameters/#parameter-domoticztopicin","title":"Parameter DomoticzTopicIn","text":"

    Section: MQTT

    Default Value: domoticz/in

    Domoticz \"in\" topic as configured on the \"MQTT Client Gateway\" setup page on the Domoticz system. Used to publish counter/s value/s.

    Parameter <NUMBER>.DomoticzIDX is required (see below).

    "},{"location":"Parameters/#parameter-homeassistantdiscovery","title":"Parameter HomeassistantDiscovery","text":"

    Section: MQTT

    Default Value: true

    Enable or disable the Homeassistant Discovery. See here for details about the discovery.

    "},{"location":"Parameters/#parameter-maintopic","title":"Parameter MainTopic","text":"

    Section: MQTT

    Default Value: watermeter

    MQTT main topic, under which the counters are published.

    The single value will be published with the following key: MAINTOPIC/NUMBER/RESULT_TOPIC

    With:

    • NUMBER: The name of the value (a meter might have more than one value). The names get defined in the analog and digit ROI configuration (defaults to main).
    • RESULT_TOPIC: Automatically filled with the right name, eg. value, rate, timestamp, error, ....

    The general connection status can be found in MAINTOPIC/CONNECTION. See MQTT Result Topics for a full list of topics.

    Note

    The main topic is allowed to contain / which can be used to split it into multiple levels, eg. /basement/meters/watermeter/1/ if you have multiple water meters in your basement.

    The nodeId for the Home Assistant MQTT Service Discovery must follow the schema <discovery_prefix>/<component>/[<node_id>/]<object_id>/config. The node_id is not configurable but derived from the MainTopic by stripping any but the last topic level. A MainTopic with the value home/basement/watermeter is transformed into the node_id watermeter, resulting in the discovery topic homeassistant/sensor/watermeter/value/config for the current value.

    "},{"location":"Parameters/#parameter-metertype","title":"Parameter MeterType","text":"

    Section: MQTT

    Default Value: other

    Select the Meter Type so the sensors have the right units in Homeassistant.

    Please also make sure that the selected Meter Type matches the dimension of the value provided by the meter! Eg. if your meter provides m\u00b3, you need to also set it to m\u00b3. Alternatively you can set the parameter DecimalShift to 3 so the value is converted to liters!

    List of supported options:

    • other
    • water_m3 (uses m^3/min as rate)
    • water_l (uses l/h as rate, not officially supported by Homeassistant!)
    • water_gal (uses gal/h as rate, not officially supported by Homeassistant!)
    • water_ft3 (uses ft^3/min as rate)
    • gas_m3 (uses m^3/min as rate)
    • gas_ft3 (uses ft^3/min as rate)
    • energy_wh (uses W as rate)
    • energy_kwh (uses KW as rate)
    • energy_mwh (uses MW as rate)
    • energy_gj (uses GJ/h as rate, not officially supported by Homeassistant!)
    • temperature_c (uses +C/min as rate)
    • temperature_f (uses \u00b0F/min as rate)
    • temperature_k (uses K/min as rate)

    Note

    Not all options are supported by Homeassistant, see SensorDeviceClass.VOLUME_FLOW_RATE in https://developers.home-assistant.io/docs/core/entity/sensor/#available-device-classes!

    "},{"location":"Parameters/#parameter-domoticzidx","title":"Parameter DomoticzIDX","text":"

    Section: MQTT

    Default Value: 0

    The Idx number for the counter device. Can be obtained from the devices setup page on the Domoticz system.

    Note

    This parameter must be prefixed with <NUMBER> followed by a dot (eg. main.DomoticzIDX). <NUMBER> is the name of the number sequence defined in the ROI's.

    "},{"location":"Parameters/#parameter-retainmessages","title":"Parameter RetainMessages","text":"

    Section: MQTT

    Default Value: true

    Enable or disable the Retain Flag for all MQTT entries.

    Warning

    Disabling (set to false) this does not clear the last retained value on the MQTT broker! This must be done manually, see How to Delete Retained Messages in MQTT? and this discussion!

    "},{"location":"Parameters/#parameter-uri","title":"Parameter Uri","text":"

    Section: MQTT

    Default Value: mqtt://example.com:1883

    URI to the MQTT broker including the port. E.g. mqtt://192.168.1.1:1883.

    "},{"location":"Parameters/#parameter-validateservercert","title":"Parameter ValidateServerCert","text":"

    Section: MQTT

    Default Value: true

    Warning

    This is an Expert Parameter! Only change it if you understand what it does!

    Enable or disable the validation of the server certificate CN field.

    If enabled (true), the certificate sent by the server is validated using the configured Root CA Certificate file. The server name in uri is compared with the CN field of the server certificate. A connection is only established if they agree. It ensures the origin of the server.

    If disabled (false), the ESP32 skipped any validation of server certificate CN field. This reduces the security of TLS and makes the MQTT client susceptible to MITM attacks.

    Note

    This also means that you might have to change the protocol and port in to mqtts://example.com:8883!

    If you use public brokers, is recommended to set this parameter to \"enabled (true)\".

    "},{"location":"Parameters/#parameter-password","title":"Parameter password","text":"

    Section: MQTT

    Default Value: PASSWORD

    Password for MQTT authentication.

    "},{"location":"Parameters/#parameter-user","title":"Parameter user","text":"

    Section: MQTT

    Default Value: USERNAME

    Username for MQTT authentication.

    "},{"location":"Parameters/#section-influxdb","title":"Section InfluxDB","text":""},{"location":"Parameters/#parameter-database","title":"Parameter Database","text":"

    Section: InfluxDB

    Default Value: ''

    Name of the InfluxDB v1 Database into which to publish the values.

    Note

    See section InfluxDBv2 for InfluxDB v2 support!

    "},{"location":"Parameters/#parameter-field","title":"Parameter Field","text":"

    Section: InfluxDB

    Default Value: undefined

    Dedicated definition of the field for InfluxDB use for saving in the Influx database (e.g.: \"watermeter/value\").

    Note

    This parameter must be prefixed with <NUMBER> followed by a dot (eg. main.Field). <NUMBER> is the name of the number sequence defined in the ROI's.

    "},{"location":"Parameters/#parameter-measurement","title":"Parameter Measurement","text":"

    Section: InfluxDB

    Default Value: undefined

    Name of the InfluxDB v1 Measurement to use to publish the value.

    Note

    See section InfluxDBv2 for InfluxDB v2 support!

    "},{"location":"Parameters/#parameter-uri_1","title":"Parameter Uri","text":"

    Section: InfluxDB

    Default Value: undefined

    URI of the HTTP interface to InfluxDB v1, without trailing slash, e.g. http://192.168.1.1:8086.

    Note

    See section InfluxDBv2 for InfluxDB v2 support!

    "},{"location":"Parameters/#parameter-password_1","title":"Parameter password","text":"

    Section: InfluxDB

    Default Value: undefined

    Password for the InfluxDB v1 authentication.

    Note

    See section InfluxDBv2 for InfluxDB v2 support!

    "},{"location":"Parameters/#parameter-user_1","title":"Parameter user","text":"

    Section: InfluxDB

    Default Value: undefined

    Username for the InfluxDB v1 authentication.

    Note

    See section InfluxDBv2 for InfluxDB v2 support!

    "},{"location":"Parameters/#section-influxdbv2","title":"Section InfluxDBv2","text":""},{"location":"Parameters/#parameter-bucket","title":"Parameter Bucket","text":"

    Section: InfluxDBv2

    Default Value: ''

    Name of the InfluxDB v2 Bucket into which to publish the values.

    "},{"location":"Parameters/#parameter-database_1","title":"Parameter Database","text":"

    Warning

    This parameter is unused! Use Basket instead!

    "},{"location":"Parameters/#parameter-field_1","title":"Parameter Field","text":"

    Section: InfluxDBv2

    Default Value: undefined

    Field for InfluxDB v2 to use for saving.

    Note

    This parameter must be prefixed with <NUMBER> followed by a dot (eg. main.Field). <NUMBER> is the name of the number sequence defined in the ROI's.

    "},{"location":"Parameters/#parameter-measurement_1","title":"Parameter Measurement","text":"

    Section: InfluxDBv2

    Default Value: undefined

    Name of the InfluxDB v2 Measurement to use to publish the value.

    "},{"location":"Parameters/#parameter-org","title":"Parameter Org","text":"

    Section: InfluxDBv2

    Default Value: undefined

    Organisation (Org) for InfluxDB v2 authentication

    "},{"location":"Parameters/#parameter-token","title":"Parameter Token","text":"

    Section: InfluxDBv2

    Default Value: undefined

    Token for InfluxDB v2 authentication

    "},{"location":"Parameters/#parameter-uri_2","title":"Parameter Uri","text":"

    Section: InfluxDBv2

    Default Value: undefined

    URI of the HTTP interface to InfluxDB v2, without trailing slash, e.g. http://192.168.1.1:8086.

    "},{"location":"Parameters/#section-gpio","title":"Section GPIO","text":""},{"location":"Parameters/#parameter-io0","title":"Parameter IO0","text":"

    Section: GPIO

    Default Value: input disabled 10 false false

    Warning

    This is an Expert Parameter! Only change it if you understand what it does!

    This parameter can be used to configure the GPIO IO0 pin.

    Warning

    This pin is only usable with restrictions! It must be disabled when the camera is used. Additionally, it is used to activate Bootloader mode and must therefore be HIGH after a reset!

    Parameters:

    • GPIO 0 state: One of input, input pullup, input pulldown or output.
    • GPIO 0 use interrupt: Enable interrupt trigger
    • GPIO 0 PWM duty resolution: LEDC PWM duty resolution in bit
    • GPIO 0 enable MQTT: Enable MQTT publishing/subscribing
    • GPIO 0 enable HTTP: Enable HTTP write/read
    • GPIO 0 name: MQTT topic name (empty = GPIO0). Allowed characters: a-z, A-Z, 0-9, _, -.

    "},{"location":"Parameters/#parameter-io1","title":"Parameter IO1","text":"

    Section: GPIO

    Default Value: input disabled 10 false false

    Warning

    This is an Expert Parameter! Only change it if you understand what it does!

    This parameter can be used to configure the GPIO IO1 pin.

    Warning

    This pin is by default used for the serial communication as TX pin (USB logging)!

    Parameters:

    • GPIO 1 state: One of input, input pullup, input pulldown or output.
    • GPIO 1 use interrupt: Enable interrupt trigger
    • GPIO 1 PWM duty resolution: LEDC PWM duty resolution in bit
    • GPIO 1 enable MQTT: Enable MQTT publishing/subscribing
    • GPIO 1 enable HTTP: Enable HTTP write/read
    • GPIO 1 name: MQTT topic name (empty = GPIO1). Allowed characters: a-z, A-Z, 0-9, _, -.

    "},{"location":"Parameters/#parameter-io12","title":"Parameter IO12","text":"

    Section: GPIO

    Default Value: input-pullup disabled 10 false false

    Warning

    This is an Expert Parameter! Only change it if you understand what it does!

    This parameter can be used to configure the GPIO IO12 pin.

    Note

    This pin is usable without known restrictions!

    Parameters:

    • GPIO 12 state: One of external-flash-ws281x, input, input pullup, input pulldown or output.
    • GPIO 12 use interrupt: Enable interrupt trigger
    • GPIO 12 PWM duty resolution: LEDC PWM duty resolution in bit
    • GPIO 12 enable MQTT: Enable MQTT publishing/subscribing
    • GPIO 12 enable HTTP: Enable HTTP write/read
    • GPIO 12 name: MQTT topic name (empty = GPIO12). Allowed characters: a-z, A-Z, 0-9, _, -.

    "},{"location":"Parameters/#parameter-io13","title":"Parameter IO13","text":"

    Section: GPIO

    Default Value: input-pullup disabled 10 false false

    Warning

    This is an Expert Parameter! Only change it if you understand what it does!

    This parameter can be used to configure the GPIO IO13 pin.

    Note

    This pin is usable without known restrictions!

    Parameters:

    • GPIO 13 state: One of input, input pullup, input pulldown or output.
    • GPIO 13 use interrupt: Enable interrupt trigger
    • GPIO 13 PWM duty resolution: LEDC PWM duty resolution in bit
    • GPIO 13 enable MQTT: Enable MQTT publishing/subscribing
    • GPIO 13 enable HTTP: Enable HTTP write/read
    • GPIO 13 name: MQTT topic name (empty = GPIO13). Allowed characters: a-z, A-Z, 0-9, _, -.

    "},{"location":"Parameters/#parameter-io3","title":"Parameter IO3","text":"

    Section: GPIO

    Default Value: input disabled 10 false false

    Warning

    This is an Expert Parameter! Only change it if you understand what it does!

    This parameter can be used to configure the GPIO IO3 pin.

    Warning

    This pin is by default used for the serial communication as RX pin (USB logging)!

    Parameters:

    • GPIO 3 state: One of input, input pullup, input pulldown or output.
    • GPIO 3 use interrupt: Enable interrupt trigger
    • GPIO 3 PWM duty resolution: LEDC PWM duty resolution in bit
    • GPIO 3 enable MQTT: Enable MQTT publishing/subscribing
    • GPIO 3 enable HTTP: Enable HTTP write/read
    • GPIO 3 name: MQTT topic name (empty = GPIO3). Allowed characters: a-z, A-Z, 0-9, _, -.

    "},{"location":"Parameters/#parameter-io4","title":"Parameter IO4","text":"

    Section: GPIO

    Default Value: built-in-led disabled 10 false false

    Warning

    This is an Expert Parameter! Only change it if you understand what it does!

    This parameter can be used to configure the GPIO IO4 pin.

    Warning

    This pin is only usable with restrictions! By default, it is used for build-in flash light (onboard LED).

    Parameters:

    • GPIO 4 state: One of built-in-led, input, input pullup, input pulldown or output.
    • GPIO 4 use interrupt: Enable interrupt trigger
    • GPIO 4 PWM duty resolution: LEDC PWM duty resolution in bit
    • GPIO 4 enable MQTT: Enable MQTT publishing/subscribing
    • GPIO 4 enable HTTP: Enable HTTP write/read
    • GPIO 4 name: MQTT topic name (empty = GPIO4). Allowed characters: a-z, A-Z, 0-9, _, -.

    "},{"location":"Parameters/#parameter-ledcolor","title":"Parameter LEDColor","text":"

    Section: GPIO

    Default Value: 150 150 150

    Color of the attached LEDs to GPIO12 in Red, Green Blue from 0 (full off) .. 255 (full on) (See IO12 parameter).

    "},{"location":"Parameters/#parameter-lednumbers","title":"Parameter LEDNumbers","text":"

    Section: GPIO

    Default Value: 2

    Number of LEDs on the external LED-stripe attached to GPIO12 (See IO12 parameter).

    "},{"location":"Parameters/#parameter-ledtype","title":"Parameter LEDType","text":"

    Section: GPIO

    Default Value: WS2812 Type of the WS2812x which is connected to GPIO12 (See IO12 parameter).

    "},{"location":"Parameters/#parameter-maintopicmqtt","title":"Parameter MainTopicMQTT","text":"

    Section: GPIO

    Default Value: wasserzaehler/GPIO

    Note

    This parameter is not accessible through the Web Interface Configuration Page!

    The GPIO Interface is prepared to report it's status and status changes as a MQTT topic. With this parameter you configure the MQTT main topic, under which the status is published. As this parameter is still experimental it can only be set manually in the config.ini itself and has not been tested in detail so far.

    "},{"location":"Parameters/#section-autotimer","title":"Section AutoTimer","text":""},{"location":"Parameters/#parameter-autostart","title":"Parameter AutoStart","text":"

    Section: AutoTimer

    Default Value: true

    Warning

    This parameter is no longer available. The flow is now always enabled. If you want it to be disabled, set an interval which is high enough (eg. 1440 = 24h).

    "},{"location":"Parameters/#parameter-interval","title":"Parameter Interval","text":"

    Section: AutoTimer

    Default Value: 5

    Unit: Minutes

    Interval in which the Flow (Digitization Round) is run. It will run immediately on startup and then the next time after the given interval. If a round takes longer than this interval, the next round gets postponed until the current round completes.

    If the flow gets started by a MQTT message or the REST API call, the interval automatically gets reset.

    Note

    If you want the flow to be disabled, set an interval which is high enough (eg. 1440 = 24h).

    "},{"location":"Parameters/#section-datalogging","title":"Section DataLogging","text":""},{"location":"Parameters/#parameter-datafilesretention","title":"Parameter DataFilesRetention","text":"

    Section: DataLogging

    Default Value: 3

    Unit: Days

    Number of days to keep the data files (0 = forever).

    "},{"location":"Parameters/#parameter-datalogactive","title":"Parameter DataLogActive","text":"

    Section: DataLogging

    Default Value: true Activate data logging to the SD-Card.

    The files will be stored in /log/data/data_YYYY-MM-DD.csv. See Data Logging for details.

    Warning

    A SD-Card has limited write cycles. Since the device does not do Wear Leveling, this can wear out your SD-Card!

    "},{"location":"Parameters/#section-debug","title":"Section Debug","text":""},{"location":"Parameters/#parameter-loglevel","title":"Parameter LogLevel","text":"

    Section: Debug

    Default Value: 1 (ERROR) Define the log level for the logging to the SD-Card.

    Available options:

    • 1: ERROR
    • 2: WARNING
    • 3: INFO
    • 4: DEBUG

    As higher the level, as more log messages get written to the SD-Card.

    Warning

    DEBUG or INFO might damage the SD-Card if enabled long term due to excessive writes to the SD-Card! A SD-Card has limited write cycles. Since the device does not do Wear Leveling, this can wear out your SD-Card!

    "},{"location":"Parameters/#parameter-logfilesretention","title":"Parameter LogfilesRetention","text":"

    Section: Debug

    Default Value: 3

    Unit: Days

    Number of days to keep the log files (0 = forever).

    "},{"location":"Parameters/#section-system","title":"Section System","text":""},{"location":"Parameters/#parameter-cpufrequency","title":"Parameter CPUFrequency","text":"

    Section: System

    Default Value: 160

    Set the CPU Frequency.

    Warning

    Setting it to 240 will lead to a faster device, but it will also require a stronger power supply! Additionally, depending on the quality of your ESP32-CAM, it might run unstable!

    Possible values:

    • 160
    • 240

    "},{"location":"Parameters/#parameter-hostname","title":"Parameter Hostname","text":"

    Section: System

    Default Value: undefined

    Warning

    This is an Expert Parameter! Only change it if you understand what it does!

    Hostname for the device. It gets automatically transferred to /wlan.ini on the SD-Card at the next startup.

    "},{"location":"Parameters/#parameter-rssithreshold","title":"Parameter RSSIThreshold","text":"

    Section: System

    Default Value: 0

    Possible values: -100 .. 0 (0 = disabled).

    Warning

    This is an Expert Parameter! Only change it if you understand what it does!

    This parameter activates a client triggered AP switching functionality (simplified roaming). If actual RSSI value is lower (more negative) than RSSIThreshold, all WIFI channels will be scanned for configured access point SSID. If an access point is in range which has better RSSI value (less negative) than actual RSSI value + 5 dBm, the device is trying to connect to this access point with the better RSSI value.

    Note

    The RSSI check only gets initiated at the end of each round to avoid any disturbance of processing.

    Note

    It gets automatically transferred to /wlan.ini on the SD-Card at next startup.

    "},{"location":"Parameters/#parameter-setupmode","title":"Parameter SetupMode","text":"

    Section: System

    Default Value: true

    Note

    This parameter is not accessible through the Web Interface Configuration Page!

    Set this parameter to true to stay in the Setup Mode after the next start of the device.

    "},{"location":"Parameters/#parameter-timeserver","title":"Parameter TimeServer","text":"

    Section: System

    Default Value: pool.ntp.org

    Warning

    This is an Expert Parameter! Only change it if you understand what it does!

    Time server to synchronize system time. If it is disabled or undefined, pool.ntp.org will be used. You can also set it to the IP of your router. Many routers like Fritzboxes can act as a local NTP server. To disable NTP, you need to activate it but set the TimeServer config to be empty (\"\"). In such case the time always starts at 01.01.1970 after each power cycle!

    "},{"location":"Parameters/#parameter-timezone","title":"Parameter TimeZone","text":"

    Section: System

    Default Value: CET-1CEST,M3.5.0,M10.5.0/3

    Time zone in POSIX syntax (Europe/Berlin = CET-1CEST,M3.5.0,M10.5.0/3 - incl. daylight saving) Check the table on http://<DEVICE IP>/timezones.html to find the settings for your region.

    "},{"location":"Parameters/#section-webhook","title":"Section Webhook","text":""},{"location":"Parameters/#parameter-apikey","title":"Parameter ApiKey","text":"

    Section: Webhook

    Default Value: undefined

    ApiKey sent as Header

    "},{"location":"Parameters/#parameter-uploadimg","title":"Parameter UploadImg","text":"

    Section: Webhook

    Default Value: 0 (NEVER)

    Available options:

    • 0: NEVER
    • 1: ALWAYS
    • 2: ON_ERROR

    "},{"location":"Parameters/#parameter-uri_3","title":"Parameter Uri","text":"

    Section: Webhook

    Default Value: undefined

    URI of the HTTP Endpoint receiving requests, e.g. http://192.168.1.1/watermeter/webhook.

    "},{"location":"Password-Protection/","title":"Password Protection","text":"

    The Web Interface and the REST API can be protected by a password.

    To do so, you have to set the username and password in the wlan.ini file on the SD-Card. Uncomment (remove the leading ;) and update the two lines with http_username and http_password: 

    http_username = \"myusername\"\nhttp_password = \"mypassword\"\n

    Warning

    This is be a WEAK and INSECURE way to protect the Web Interface and the REST API. There was no audit nor a security review to check the correct implementation of the protection! The password gets transmitted unencrypted (plain text), this means it is very easy to extract it for somebody who has access to your WIFI!

    USE AT YOUR OWN RISK!

    Notes

    The file wlan.ini file on the SD-Card can not be accessed through the Web interface.

    "},{"location":"REST-API/","title":"REST API","text":"

    Various information is directly accessible over specific REST calls.

    To use it, just append them to the IP, separated with a /, e.g. http://192.168.1.1/json

    Note

    For more detailed information to the REST handler, have a look to the code in the repository: registered handlers

    "},{"location":"REST-API/#control","title":"Control","text":""},{"location":"REST-API/#flow_start","title":"flow_start","text":"

    Trigger the next flow + Payload: - No payload needed

    This will automatically reset the flow interval.

    "},{"location":"REST-API/#setprevalue","title":"setPreValue","text":"

    Set the last valid value (previous value) to given value or the actual RAW value. + Payload: - Set to given value (value >= 0), e.g. /setPreValue?numbers=main&value=1234.5678 * numbers= Provide name of number sequence, e.g. main * value= provide the value to be set

        - Set to actual RAW value (value < 0, a valid RAW value is mandatory), e.g. `/setPreValue?numbers=main&value=-1`\n       * `numbers=` Provide name of number sequence, e.g. main\n       * `value=` provide yna negative number\n
    "},{"location":"REST-API/#gpio","title":"GPIO","text":"

    • Control a GPIO output

      • The GPIO entrypoint also support parameters:
      • /GPIO?GPIO={PinNumber}&Status=high
      • /GPIO?GPIO={PinNumber}&Status=low
      • Example: /GPIO?GPIO=12&Status=high

    • Read a GPIO input

      • The GPIO entrypoint also support parameters:
      • /GPIO?GPIO={PinNumber}
      • Example: /GPIO?GPIO=12
    "},{"location":"REST-API/#reboot","title":"reboot","text":"

    Trigger a reboot of the device

    "},{"location":"REST-API/#mqtt_publish_discovery","title":"mqtt_publish_discovery","text":"

    Trigger re-sending of the Home Assistant discovery topics. The topics will get send at the end of the next round.

    "},{"location":"REST-API/#results","title":"Results","text":""},{"location":"REST-API/#json","title":"json","text":"

    Show result in JSON syntax - Example: { \"main\": { \"value\": \"521.17108\", \"raw\": \"521.17108\", \"pre\": \"521.17108\", \"error\": \"no error\", \"rate\": \"0.023780\", \"timestamp\": \"2023-01-13T16:00:42+0100\" } }

    "},{"location":"REST-API/#value","title":"value","text":"

    Show single result values - The value entrypoint also support parameters: - http://<IP>/value?all=true&type=value - http://<IP>/value?all=true&type=raw - http://<IP>/value?all=true&type=error - http://<IP>/value?all=true&type=prevalue

    "},{"location":"REST-API/#img_tmprawjpg","title":"img_tmp/raw.jpg","text":"

    Capture and show a new raw image

    "},{"location":"REST-API/#img_tmpalgjpg","title":"img_tmp/alg.jpg","text":"

    Show last aligned image

    "},{"location":"REST-API/#img_tmpalg_roijpg","title":"img_tmp/alg_roi.jpg","text":"

    Show last aligned image including ROI overlay

    "},{"location":"REST-API/#status","title":"Status","text":""},{"location":"REST-API/#statusflow","title":"statusflow","text":"

    Show the actual step of the flow incl. timestamp - Example: Take Image (15:56:34)

    "},{"location":"REST-API/#rssi","title":"rssi","text":"

    Show the WIFI signal strength (Unit: dBm) - Example: -51

    "},{"location":"REST-API/#cpu_temperature","title":"cpu_temperature","text":"

    Show the CPU temperature (Unit: \u00b0C) - Example: 38

    "},{"location":"REST-API/#sysinfo","title":"sysinfo","text":"

    Show system infos in JSON syntax - Example: [{\"firmware\": \"\",\"buildtime\": \"2023-01-25 12:41\",\"gitbranch\": \"HEAD\",\"gittag\": \"\",\"gitrevision\": \"af13c68+\",\"html\": \"Development-Branch: HEAD (Commit: af13c68+)\",\"cputemp\": \"64\",\"hostname\": \"WaterMeterTest\",\"IPv4\": \"192.168.xxx.xxx\",\"freeHeapMem\": \"2818330\"}]

    "},{"location":"REST-API/#starttime","title":"starttime","text":"

    Show starttime - Example: 20230113-154634

    "},{"location":"REST-API/#uptime","title":"uptime","text":"

    Show uptime - Example: 0d 00h 15m 50s

    "},{"location":"REST-API/#camera","title":"Camera","text":""},{"location":"REST-API/#lighton","title":"lighton","text":"

    Switch the camera flashlight on

    "},{"location":"REST-API/#lightoff","title":"lightoff","text":"

    Switch the camera flashlight off

    "},{"location":"REST-API/#capture","title":"capture","text":"

    Capture a new image (without flashlight)

    "},{"location":"REST-API/#capture_with_flashlight","title":"capture_with_flashlight","text":"

    Capture a new image with flashlight

    "},{"location":"REST-API/#stream","title":"stream","text":"

    Stream a live video of the camera.

    It has a slow refresh rate of only 2 FPS to avoid stressing the system. Flow processing continues to work in the background, albeit possibly a bit slower.

    When the flashlight parameter is set, it turns on the flaslight. Both http://<IP>/stream?flashlight=true and http://<IP>/stream?flashlight turn on the flashlight.

    LIMITATION: To avoid using extra memory, no additional dedicated stream webserver is implemented for this feature (instead, the web interface server is reused in a kind of \"blocking way\"). This means that either the web interface is fully functional or the stream is active, but not both at the same time. However, this is sufficient for the intended use case.

    "},{"location":"REST-API/#save","title":"save","text":"

    Save a new image to SD card - The save entrypoint also support parameters: - http://<IP>/save?filename=test.jpg&delay=1000

    "},{"location":"REST-API/#logs","title":"Logs","text":""},{"location":"REST-API/#log","title":"log","text":"

    Last part of todays log (last 80 kBytes))

    "},{"location":"REST-API/#logfileact","title":"logfileact","text":"

    Full log of today

    "},{"location":"REST-API/#loghtml","title":"log.html","text":"

    Opens the log html page

    "},{"location":"REST-API/#diagnostics","title":"Diagnostics","text":""},{"location":"REST-API/#heap","title":"heap","text":"

    print relevant memory (heap) information - Example: Heap info: Heap Total: 1888926 | SPI Free: 1827431 | SPI Larg Block: 1802240 | SPI Min Free: 758155 | Int Free: 61495 | Int Larg Block: 55296 | Int Min Free: 36427

    "},{"location":"REST-API/#prometheusopenmetrics","title":"Prometheus/OpenMetrics","text":""},{"location":"REST-API/#metrics","title":"metrics","text":"

    Provides a set of metrics that can be scraped by prometheus. See Prometheus/OpenMetrics for details.

    "},{"location":"REST-API/#password-protection","title":"Password Protection","text":"

    The Web Interface and the REST API can be protected by a password, see Password-Protection.

    "},{"location":"ROI-Configuration/","title":"ROIs (Regions of Interest)","text":"

    Notes

    You are using a neural network approach which is trained to fit as many different type of meters as possible. The accuracy will never be 100%. It is normal to see a missing reading once in a while. There are several precautions to detect this. For details see the section PostProcessing on the configuration page.

    The most critical components for an accurate detection are:

    1. Correct setting of the Regions Of Interest (ROIs) for detection of the image.

      This must be done manually for each device/installation!

    2. Using a well trained Model.

      Have a look on the Digit Counters resp. Analog Needles to check if your types are contained. If your number types are not contained, you should take the effort to record them so we can add them to the training data. See Collect images to improve the models on how to collect new training data.

    "},{"location":"ROI-Configuration/#precondition","title":"Precondition","text":"

    Please make sure to have:

    1. Setup your camera properly and taken a good Reference Image.
    2. Selected good Alignment References.
    "},{"location":"ROI-Configuration/#define-the-rois","title":"Define the ROIs","text":"

    For each digit or analog pointer, a ROI must be defined.

    You can even have multiple independent Numbers (eg. electerical meters mostly have 2 numbers for the high and low tariff).

    Depending if you have only one of those types, you can enable/disable (1) it on the top left corner:

    You can switch between the individual ROIs with the Drop down box (2). If you need additional ROIs or delete them you can do this with the control at (3). Like for the Alignment References, you can change the position, size and name of a ROI in the text fields or define them via drag and drop through the mouse button. Make sure the ROIs are in the right order, matching the significance of a digit/analog counter!

    Warning

    The order of the ROIs defines how the individual digits are combined to the total number. The first ROI is the digit with the highest order (left side), then the second and so on. You can control the order in the selector tab and change it with the buttons \"move Next\" or \"move Previous\".

    In most cases digits are ordered equidistantly (have the same distance between each other) and have the same size. Because of this, the Web Interface keeps their sizes and distance the same. If you need individual sizes or distances, untick the settings (4).

    In almost all cases the sizes and y values should be identical! The ratio between x and y might need adjustment. But make sure it is the same for all digits.

    Same for the analog counters, the sizes should be identical and the x and y as well.

    Note

    Don't forget to save the settings with \"Save\" and do not reboot at this stage.

    "},{"location":"ROI-Configuration/#analog-counters","title":"Analog Counters","text":"

    For analog counters the ROI setting is rather straight forward as the meter is usually quadratic with a clear center. The circle should exactly fit to the outer size of the meter and the cross should be in the middle of the pointer.

    Here is an example with the details for the ROI ana1:

    "},{"location":"ROI-Configuration/#digits","title":"Digits","text":"

    For the Digit Meters it is a little bit more complicated, as there are different options of digit models which can be choosen.

    "},{"location":"ROI-Configuration/#correct-size-for-roi","title":"Correct Size for ROI","text":"

    First of all, choose the right size of the ROI. The configuration of ROIs differs a bit on the selected model (see below).

    If you are in the initial setup, the model will be selectable in the next step. By default it is a dig-cont resp. ana-cont model.

    In Model Selection you find the differences between the different available models. Pick the one you think fits best your purpose. If you don't get to good result, try another model.

    Here we only show the different configuration of the ROIs.

    1. Digit Meters with only recognized full digits (0, 1, 2, 3, ... 9)

      Suggested Model: dig-class11-*.tfl

      Advantage: broad variety of types included in the training.

      Disadvantage: partially rotated numbers cannot be detected.

    2. Digit Meters with sub-digit resolution (0.0, 0.1, 0.2, .... 9.8, 9.9)

      Suggested Model: dig-cont-*.tfl or dig-class100-*.tfl

      Advantage: partial numbers can be detected and a better post processing is possible.

      Disadvantage: only limited types of meter types are trained due to the high effort for the training data.

    "},{"location":"ROI-Configuration/#how-to-setup-the-digit-rois-perfectly","title":"How to setup the digit ROIs perfectly","text":"

    Details and the corresponding \"perfect\" setting is explained below. For a first run you can choose the following general settings:

    • There is an inner and an outer frame for the ROIs.
    • Make the inner frame exactly the size of the number.
    Example 1 Example 2 \u2714\ufe0f Okay \u274c Not Okay \u274c Not Okay"},{"location":"ROI-Configuration/#setup-using-dig-class11-models","title":"Setup using dig-class11 models","text":"

    dig-class11 - Models recognize the complete digit only. Here it is not relevant if the ROI fits the Border of the digit window.

    For this model, there should be a border of 20% of the image size around the number itself. This border is shown in the ROI setup image by the inner thinner rectangle. This rectangle should fit perfectly around the number when the number has not started to rotate to the next position:

    Example 1 Example 2 \u2714\ufe0f Okay \u274c Not Okay \u274c Not Okay

    If you have perfect alignment and still are not getting satisfying results, most probably your numbers are not part of the training data yet. See Collect images to improve the models on how to collect new training data.

    "},{"location":"ROI-Configuration/#setup-using-dig-class100-or-dig-cont-models","title":"Setup using dig-class100 or dig-cont Models","text":"

    These models recognize the tenths (fractions) between the numbers. Those models require a different ROI setup; the height must be set differently and more accurately.

    First, the width can be set like for a dig-class11 model, i.e. 20% margin left and right.

    The height of the outer rectangle should be set to the upper and lower edge of the number window. To achieve this, you might need to unlock the aspect ratio:

    Here an example:

    Example 1 \u2714\ufe0f Okay \u274c Not Okay"},{"location":"ROI-Configuration/#saving","title":"Saving","text":"

    Once you are done, push Save to persist your setup.

    A reboot is required to apply the changed configuration!

    "},{"location":"Reference-Image/","title":"Reference Image","text":"

    Note

    The Reference Image is the basis for the coordinate system of the ROIs. Therefore it is very important, to have a well aligned image, that is not rotated.

    At first an example image is shown. To define a new reference image push the button \"Create new Reference\" (2) and afterwards \"Take Image\" (2). It might take some seconds for processing, then your actual camera image should be shown. Then play with the provided parameters to get a good result.

    "},{"location":"Reference-Image/#focus","title":"Focus","text":"

    This is the first time, where you have access to the camera image. It most likely is out of focus and not sharp! Ensure a sharp image of the camera by adjusting the focal length of the ESP OV2640 camera.

    Note

    Try to adjust the focus for the clearest possible image!

    In order to use it for reading a meter, the focal-length of the OV2640 camera has to be manipulated. By default it only results in sharp image for distance bigger than around ~40cm which is not ideal for our purpose.

    Therefore you need to remove the fixing glue of the OV2640 lens with a sharp knife. After this you can rotate the lens in and out. Rotating it by about a quarter of a turn counterclockwise results in a focus plane shift of about 10cm. You need to figure out your best setting with a little bit of trial and error for your specific environment.

    Error

    Be very carefully when rotating the lens. Best is to held the camera itself with one hand or a plier and rotate the lens with the other hand. Make sure not to rotate the whole camera as this can damage the ribbon cable!

    Warning

    This modification will void any warranty, as the sealing of the lens objective is broken!

    Warning

    This modification will render the camera unsuitable for general, web-cam type applications unless the focal length is changed back to the original setting.

    "},{"location":"Reference-Image/#correct-horizontal-alignment","title":"Correct Horizontal Alignment","text":"

    Ensure an exact horizontal alignment of the number:

    \u2714\ufe0f Okay \u274c Not Okay

    Warning

    Updating the reference image also means that all alignment images and ROIs needs to be configured again. Therefore do this step later only with caution.

    If everything is done, you can save the result with \"Update Reference Image\" (4).

    Note

    A reboot is not required at this point of time.

    As next you should update the Alignment References.

    "},{"location":"Reference-Image/#dealing-with-reflections","title":"Dealing with Reflections","text":"

    Reflections can be caused by the flash LED and make it hard to provide a reliable detection. There are various ways to deal with them:

    • Attach a diffusor in front of the LED, eg. a filt (Filz) or parchment paper. Also white paper can do the job.
    • Rotate the ESP-CAM so the LED is on another place.
    • Reduce the LED intensity.
    • Use external LED stripes, eg WS2812x.
    "},{"location":"Release-creation/","title":"Release Procedure","text":"

    Follow these steps to create a release:

    1. Document all relevant changes in the Changelog in the main branch. To get a list of commits, you can call git log --oneline or check commits/main/. Summarize the relevant changes since the last release.
    2. Wait for the GitHub action to run successfully.
    3. Test it to see if everything worsk as expected.
    4. Update the contributors list in the README.md by triggering the Manually update contributors list action.

    5. Go to releases/new to create a new release. Fill in a new tag and select \"Create new tag: xxx on publish\". A tag should have the format x.y.z. It is suggested to first select \"Set as a pre-release\" at the bottom.

    6. Wait for the GitHub-Action of release creation. After all is done:

      • the release should be created
      • the artifacts are downloadable from release
      • The documented changes were applied to the release
    7. In case of a full release (not a pre-release), check that the Web Installer shows the right version. If needed, run he action manually: github.com/jomjol/AI-on-the-edge-device/actions/workflows/manual-update-webinstaller.yml.
    "},{"location":"StatusLED-BlinkCodes/","title":"Board status LED (blink codes)","text":"

    This page lists possible blink codes of the red LED located on the ESP32-CAM board, their meaning and possible solutions.

    The error code source definition can be found here.

    "},{"location":"StatusLED-BlinkCodes/#general-design-approach","title":"General design approach:","text":"
    • 250ms blink code to identify source
    • 500ms defined LED off
    • 250ms blink code to identify error / status code
    • 1,5s defined LED off to signal repetition
    • Repetition blink code: infinite for critical errors and status indication or 2x for warning indication
    • e.g. 3x blinks | 500ms LED off | 2x blinks --> error: SD card not found
    source source blink count error / warning / status status blink count repeat infinite WLAN_CONN 1 Disconnected (No Access Point) 1 WLAN_CONN 1 Disconnected (Authentication failure) 2 WLAN_CONN 1 Disconnected (Timeout) 3 WLAN_CONN 1 Disconnected (further reasons) 4 WLAN_INIT 2 wlan.ini empty or not readable 1 X WLAN_INIT 2 SSID or password empty 2 X WLAN_INIT 2 WIFI init error (details console) 3 X SDCARD_INIT 3 SD card filesystem mount failed 1 X SDCARD_INIT 3 SD card not found (0x107) 2 X SDCARD_INIT 3 SD card init failed (details console) 3 X SDCARD_CHECK 4 Basic check: file creation/write error 1 X SDCARD_CHECK 4 Basic check: file read/CRC error 2 X SDCARD_CHECK 4 Basic check: file delete error 3 X SDCARD_CHECK 4 Basic check: folder/file presence 4 X CAM_INIT 5 Camera init failed (details console) 1 X CAM_INIT 5 Camera framebuffer check failed 2 PSRAM_INIT 6 RAM init failed: Not found/defective 1 X PSRAM_INIT 6 External SPI RAM < 4MB 2 X PSRAM_INIT 6 Total heap < 4MB 3 X TIME_CHECK 7 Missing time sync (check every round) 1 OTA_OR_AP 8 OTA process ongoing 1 X OTA_OR_AP 8 Soft AP started (for remote config) 2 X FLASHLIGHT N/A LED on when flashlight is on solid, no blink"},{"location":"StatusLED-BlinkCodes/#error-warning","title":"ERROR / WARNING","text":""},{"location":"StatusLED-BlinkCodes/#source-wlan_conn-wlan-disconnected","title":"Source WLAN_CONN: WLAN disconnected","text":"

    Note

    Only warning indication, blink code repetition: 2x --> General info: WLAN disconnect reason code description

    "},{"location":"StatusLED-BlinkCodes/#wlan-disconnected-no-access-point","title":"WLAN disconnected (No Access Point)","text":"

    WLAN connection is interrupted due to no access point in range.

    "},{"location":"StatusLED-BlinkCodes/#wlan-disconnected-authentication-failure","title":"WLAN Disconnected (Authentication failure)","text":"

    WLAN connection is interrupted due to an authentication failure. If error repeats check WLAN config in wlan.ini (username, password)

    "},{"location":"StatusLED-BlinkCodes/#wlan-disconnected-timeout","title":"WLAN Disconnected (Timeout)","text":"

    WLAN connection is interrupted due to an timeout because no beacon from AP is received in a timely manner. Most probably access point is not available anymore or connection is not reliable.

    "},{"location":"StatusLED-BlinkCodes/#wlan-disconnected-further-reasons","title":"WLAN Disconnected (Further reasons)","text":"

    WLAN connection is interrupted due to further reasons. Disconnect reason is printed in warining message. Please check serial console output or logfile from sd card (using another device to retrieve logfile /sdcard/log/message/). Please refer to this page to have additional infos in terms of WLAN disconnect reasons --> WLAN disconnect reason code description

    "},{"location":"StatusLED-BlinkCodes/#source-wlan_init-wlan-initialization","title":"Source WLAN_INIT: WLAN initialization","text":"

    Note

    All critical errors, regular boot not possible

    "},{"location":"StatusLED-BlinkCodes/#wlanini-empty-or-not-readable","title":"wlan.ini empty or not readable","text":"

    The wlan.ini file is present but content is either not readable or no content present. Please check for further errors in terms of SD card readability or content of wlan.ini which is located in /sdcard (most top folder od SD card)

    "},{"location":"StatusLED-BlinkCodes/#ssid-or-password-empty","title":"SSID or password empty","text":"

    The mandatory parameters SSID (name of WIFI network) and / or password is empty. Please configure those parameters in wlan.ini and try again.

    "},{"location":"StatusLED-BlinkCodes/#wifi-init-error-details-console","title":"WIFI init error (details console)","text":"

    A general WIFI initialization error occured. Please check serial console output or logfile from sd card (using another device to retrieve logfile /sdcard/log/message/)

    "},{"location":"StatusLED-BlinkCodes/#source-sdcard_init-sd-card-initialization","title":"Source SDCARD_INIT: SD card initialization","text":"

    Note

    All critical errors, regular boot not possible

    "},{"location":"StatusLED-BlinkCodes/#sd-card-filesystem-mount-failed","title":"SD card filesystem mount failed","text":"

    Failed to mount FAT filesystem on SD card. Check SD card filesystem (only FAT supported) or try another card. Possible further infos: Please check serial console output.

    "},{"location":"StatusLED-BlinkCodes/#sd-card-not-found-error-code-0x107","title":"SD card not found (Error code 0x107)","text":"

    SD card init failed. Check if SD card is properly inserted into SD card slot or try another card. Possible further infos: Please check serial console output.

    "},{"location":"StatusLED-BlinkCodes/#sd-card-init-failed-details-console","title":"SD card init failed (details console)","text":"

    A general SD card initialization error occured. Please check serial console output.

    "},{"location":"StatusLED-BlinkCodes/#source-sdcard_check-sd-card-basic-check","title":"Source SDCARD_CHECK: SD card basic check","text":"

    Note

    All critical errors, normal boot not possible. Reduced WebUI is going to be loaded for further diagnostic possibilities or redo firmware update.

    "},{"location":"StatusLED-BlinkCodes/#file-creation-write-error","title":"File creation / write error","text":"

    A basic check of SD card is performed at boot. Failed to create the test file or writing content to the file failed. Most likely SD card is defective or not supported. Please check logs with log viewer in reduced web interface, serial console output or try another card.

    Recommendation: Format or try another card

    "},{"location":"StatusLED-BlinkCodes/#file-read-crc-verfication-error","title":"File read / CRC verfication error","text":"

    A basic check of SD card is performed at boot. Failed to read the test file or CRC of read back content failed. Most likely SD card is defective. Please check logs with log viewer in reduced web interface or serial console output for further error indication or try another card.

    Recommendation: Format or try another card

    "},{"location":"StatusLED-BlinkCodes/#file-delete-error","title":"File delete error","text":"

    A basic check of SD card is performed at boot. Failed to delelte the test file. Most likely SD card is defective. Please check logs with log viewer in reduced web interface or serial console output for further error indication or try another card.

    Recommendation: Format or try another card

    "},{"location":"StatusLED-BlinkCodes/#folder-file-presence-failed","title":"Folder / File presence failed","text":"

    A basic check of SD card is performed at boot. One or more menadatory folder / file are not found on SD card. Please check logs with log viewer in reduced web interface or serial console output for further error indication.

    Recommendation: Repeat installation using AI-on-the-edge-device__update__*.zip

    "},{"location":"StatusLED-BlinkCodes/#source-cam_init-camera-initialization","title":"Source CAM_INIT: Camera initialization","text":""},{"location":"StatusLED-BlinkCodes/#camera-init-failed-details-console","title":"Camera init failed (details console)","text":"

    Note

    Critical error, normal boot not possible. Reduced WebUI is going to be loaded for further diagnostic possibilities or redo firmware update.

    A general camera initialization error occured. Please check logs with log viewer in reduced web interface or serial console output for further error indication.

    Recommendation: Check for proper electrical connection, whether camera model is supported and whether power supply is sufficient.

    "},{"location":"StatusLED-BlinkCodes/#camera-framebuffer-check-failed","title":"Camera framebuffer check failed","text":"

    The framebuffer of the camera was not readable. The firmware will trying to continue regular boot, but further errors can occur which block regular processing. Please check logs with logfile viewer if processing is behaving irregular.

    Recommendation: Check for proper electrical commenection, wether camera model is supported and wether power supply is suffcient.

    "},{"location":"StatusLED-BlinkCodes/#source-psram_init-external-ram-spi-ram-initialization","title":"Source PSRAM_INIT: External RAM (SPI RAM) initialization","text":"

    Note

    A critical errors, normal boot not possible. Reduced WebUI is going to be loaded for further diagnostic possibilities or redo firmware update.

    "},{"location":"StatusLED-BlinkCodes/#spi-ram-init-failed-not-founddefective","title":"SPI RAM init failed: Not found/defective","text":"

    External RAM (SPI RAM) initialization failed. Most likely external RAM not accessable or defective. Normal operation is not possible without having external RAM.

    "},{"location":"StatusLED-BlinkCodes/#external-spi-ram-4mb","title":"External SPI RAM < 4MB","text":"

    External RAM (SPI RAM) initialization successful, but external RAM size is too small. A size of >= 4MB is necessary to run this firmware.

    "},{"location":"StatusLED-BlinkCodes/#total-heap-4mb","title":"Total heap < 4MB","text":"

    Total available system memory (heap) is too small. A size of >= 4MB is necessary to run this firmware.

    "},{"location":"StatusLED-BlinkCodes/#source-time_check-external-ram-spi-ram-initialization","title":"Source TIME_CHECK: External RAM (SPI RAM) initialization","text":""},{"location":"StatusLED-BlinkCodes/#missing-time-sync-check-every-round","title":"Missing time sync (check every round)","text":"

    Note

    Only warning indication, blink code repetition: 2x

    If system is configured to be synced with a NTP server the sync status is checked after every round (in state: \"Flow finished\". An warming message is also printed to log). If the time is not synced after serveral rounds, please check for proper configuration.

    "},{"location":"StatusLED-BlinkCodes/#status","title":"STATUS","text":"

    Note

    All only status indication

    "},{"location":"StatusLED-BlinkCodes/#source-ota_or_ap-ota-update-access-point-mode","title":"Source OTA_OR_AP: OTA Update / Access point mode","text":""},{"location":"StatusLED-BlinkCodes/#ota-process-ongoing","title":"OTA process ongoing","text":"

    An OTA is performed right now. Please wait until OTA is completed. System is rebooting automatically. If system is not coming up, please check serial console output.

    "},{"location":"StatusLED-BlinkCodes/#soft-ap-started-for-remote-config","title":"Soft AP started (for remote config)","text":"

    The built-in access point functionality is started to perform initial remote remote setup. Further description: Installtion --> Section Remote Setup using the built-in Access Point

    "},{"location":"StatusLED-BlinkCodes/#source-flashlight-flashlight","title":"Source FLASHLIGHT: Flashlight","text":""},{"location":"StatusLED-BlinkCodes/#led-on-when-flashlight-is-on","title":"LED on when flashlight is on","text":"

    The LED is solid on as long the flashlight is on. This feature has lower priority than the other LED codes. Whenever another code occurs this feature will be overrided.

    "},{"location":"Testing/","title":"Testing Option for VSCode","text":"

    You can test your functions directly on the device.

    "},{"location":"Testing/#structure","title":"Structure","text":"

    All tests are under directory \"test\" in the project and not compiled with default build option of platformio. The main function is in file test_suite_controlflow.cpp. In method app_main() you can add your own tests.

    "},{"location":"Testing/#include-my-own-test","title":"Include my own test","text":"

    In method app_main() of test_suite_controlflow.cpp you can add your own tests. Include your test-file in the top like

    #include \"components/jomjol-flowcontroll/test_flow_postrocess_helper.cpp\"

    components is a subfolder of tests here. Not the components directory of root source.

    In the bottom add your test function.

    RUN_TEST(testNegative);

    Your test function should have a TEST_ASSERT_EQUAL_*. For more information look at unity-testing.

    "},{"location":"Testing/#run-tests","title":"Run tests","text":"

    You will need a testing device. best with usb adapter. Before you upload your tests you will need to setup the device with initial setup procedure described in [[Installation]]

    Now you can use Visual Studio Code or a standard console to upload the test code. In VS Code (tab platformio) open Advanced and select Test.

    Alternatively you can run it in console/terminal with platformio test --environment esp32cam.

    In my environment the serial terminal not opens. I have to do it for myself. You will see much logging. If any test fails it logs it out. Else it logs all test passed in the end.

    "},{"location":"Testing/#troubleshooting","title":"Troubleshooting","text":"

    If you test very much cases in one function, the device runs in Stack Overflow and an endless boot. Reduce the count of test cases or split the test function in multiple functions.

    "},{"location":"Upload-files-by-script/","title":"Scripted File Upload","text":"

    To upload a file e.g. using curl, you first have to delete it and then upload it: 

    curl -d '' http://192.168.1.153/delete/html/index.html\ncurl --data-binary @ota_page.html http://192.168.1.153/upload/html/index.html\n

    "},{"location":"WLAN-disconnect-reason/","title":"WLAN disconnect reasons","text":"

    In the logfile the WLAN disconnect reason code are printed whenever a disconnect event occurs (WARNING LEVEL or higher).

    Further information and additional description of reason codes can be found here: WLAN disconnect reason code description

    "},{"location":"Watermeter-specific-analog---digit-transition/","title":"Analog/Digit Transition on Water Meters","text":"

    At first, for the most water meters the default configuration should be work. But the digit, especially the last digit differs in some devices.

    "},{"location":"Watermeter-specific-analog---digit-transition/#normal-transition","title":"\"Normal\" transition","text":"

    In most cases, the transition of the last digit starts when the analogue pointer is > 9.

    Often the last digit \"hangs\" a bit on this devices and comes not over zero. So it is not easy to see which digit is correct. In the first example 4 or still 3? (3 is correct).

    "},{"location":"Watermeter-specific-analog---digit-transition/#early-transition","title":"Early transition","text":"

    Some units start the transition very early or run with the analogue pointer. In the third example, is it a 3 or a 2?

    "},{"location":"Watermeter-specific-analog---digit-transition/#inaccuracies-in-image-recognition","title":"Inaccuracies in image recognition","text":"

    The models for image recognition are good, but have inaccuracies in the range +/- 0.2. In order to obtain as many correct results as possible, a treatment is carried out in the post process in the range of 9.8-0.2 for the analogue pointer, which must start differently depending on the type of counter.

    "},{"location":"Watermeter-specific-analog---digit-transition/#how-to-configure-for-my-meter-type","title":"How to configure for my meter type","text":"

    If you have a devices with \"normal\" transition you should not have any issues. On devices with \"early\" transition, you can set the option AnalogToDigitTransitionStart to a value between 6 and 8. See the parameter documentation for details.

    "},{"location":"Webhook/","title":"Webhook","text":""},{"location":"Webhook/#purpose","title":"Purpose","text":"

    The idea behind this webhook feature is to provide an alternative to MQTT and InfluxDB for transmitting data, such as water meter readings from a vacation home, to a standard PHP webspace.

    You can call the webhook to upload the data or the raw image of a round to a server.

    "},{"location":"Webhook/#configuration","title":"Configuration","text":"

    To configure the webhook feature, you only need to define a URI and an API key. The URI is where the webhook will send the data, and the API key is used to authenticate the requests, ensuring that only authorized devices can send data to your server. Optionally, \"Upload Image\" can be used to configure whether an additional PUT request should be sent to the same URI with the current image. A parameter timestamp is appended to establish a correlation.

    "},{"location":"Webhook/#example-of-a-post-request","title":"Example of a POST Request","text":"

    Below is an example of the JSON payload that might be sent in a POST request to the webhook:

    "},{"location":"Webhook/#request-headers","title":"Request Headers","text":"
    APIKEY: your-api-key-here\n
    "},{"location":"Webhook/#json-payload","title":"JSON Payload","text":"
    [\n  {\n    \"timestamp\": \"2024-08-09T11:44:44+0200\",\n    \"timestampLong\": 1723196684,\n    \"name\": \"main\",\n    \"rawValue\": \"0345.42647\",\n    \"value\": \"345.42648\",\n    \"preValue\": \"345.42648\",\n    \"rate\": \"0.000000\",\n    \"changeAbsolute\": \"0.00000\",\n    \"error\": \"no error\"\n  },\n  {\n    \"timestamp\": \"2024-08-09T11:44:44+0200\",\n    \"timestampLong\": 1723196684,\n    \"name\": \"test\",\n    \"rawValue\": \"34\",\n    \"value\": \"34\",\n    \"preValue\": \"34\",\n    \"rate\": \"0.000000\",\n    \"changeAbsolute\": \"0\",\n    \"error\": \"no error\"\n  }\n]\n
    "},{"location":"Webhook/#basic-example-of-a-server-using-php","title":"Basic Example of a server using PHP","text":"
    <?php\n$expectedApiKey = 'your-api-key-here';\n\n$receivedApiKey = isset($_SERVER['HTTP_APIKEY']) ? $_SERVER['HTTP_APIKEY'] : '';\n\nif ($receivedApiKey !== $expectedApiKey) {\n    http_response_code(403); // 403 Forbidden\n    echo json_encode(['status' => 'error', 'message' => 'Invalid API key']);\n    exit;\n}\n\n$method = $_SERVER['REQUEST_METHOD'];\n\nif ($method === 'POST') {\n    // Handle POST request: Write data to CSV\n    $csvFile = 'webhook_log.csv';\n\n    $jsonData = file_get_contents('php://input');\n\n    $dataArray = json_decode($jsonData, true);\n    if (!$jsonData || !is_array($dataArray)) {\n        http_response_code(400); // 400 Bad Request\n        echo json_encode(['status' => 'error', 'message' => 'Invalid JSON data']);\n        exit;\n    }\n\n    $csvHandle = fopen($csvFile, 'a');\n    if ($csvHandle === false) {\n        http_response_code(500); // 500 Internal Server Error\n        echo json_encode(['status' => 'error', 'message' => 'Unable to open CSV file']);\n        exit;\n    }\n\n    foreach ($dataArray as $data) {\n        $csvRow = [\n            $data['timestampLong'], \n            $data['name'], \n            $data['rawValue'], \n            $data['value'], \n            $data['preValue'], \n            $data['rate'], \n            $data['changeAbsolute'], \n            $data['error']\n        ];\n        fputcsv($csvHandle, $csvRow);\n    }\n\n    fclose($csvHandle);\n\n    http_response_code(200); // 200 OK\n    echo json_encode(['status' => 'success', 'message' => 'Data written to CSV file']);\n} elseif ($method === 'PUT') {\n    // Handle PUT request: Save image\n    $timestamp = $_GET['timestamp'];\n\n    if (!ctype_digit($timestamp) || $timestamp < 0 || $timestamp > PHP_INT_MAX) {\n        http_response_code(400); // 400 Bad Request\n        echo json_encode(['status' => 'error', 'message' => 'Invalid timestamp']);\n        exit;\n    }\n\n    $imageFilePath = 'uploaded_image_' . $timestamp . '.jpg';\n\n    $imageData = file_get_contents('php://input');\n\n    if (!$imageData) {\n        http_response_code(400); // 400 Bad Request\n        echo json_encode(['status' => 'error', 'message' => 'No image data received']);\n        exit;\n    }\n\n    if (file_put_contents($imageFilePath, $imageData) === false) {\n        http_response_code(500); // 500 Internal Server Error\n        echo json_encode(['status' => 'error', 'message' => 'Unable to save the image']);\n        exit;\n    }\n\n    http_response_code(200); // 200 OK\n    echo json_encode(['status' => 'success', 'message' => 'Image uploaded successfully']);\n} else {\n    // Handle unsupported HTTP methods\n    http_response_code(405); // 405 Method Not Allowed\n    echo json_encode(['status' => 'error', 'message' => 'Method not allowed']);\n}\n?>\n
    "},{"location":"Webhook/#basic-example-of-a-server-using-python","title":"Basic Example of a server using Python","text":"
    from flask import Flask, request, jsonify\nimport csv\nimport os\n\napp = Flask(__name__)\n\n# List of allowed API keys\nALLOWED_API_KEYS = {\n    '123',\n    '456',\n    '789'\n}\n\n@app.before_request\ndef check_api_key():\n    # Get the API key from the request headers\n    received_api_key = request.headers.get('APIKEY')\n\n    # Check if the received API key is in the allowed list\n    if received_api_key not in ALLOWED_API_KEYS:\n        return jsonify({'status': 'error', 'message': 'Invalid API key'}), 403\n\n    # Attach the API key to the request object for later use\n    request.api_key = received_api_key\n\n@app.route('/webhook', methods=['POST', 'PUT'])\ndef webhook():\n    # Create a directory for the API key if it doesn't exist\n    api_key_dir = os.path.join('data', request.api_key)\n    os.makedirs(api_key_dir, exist_ok=True)\n\n    if request.method == 'POST':\n        # Handle POST request: Write data to CSV\n        data = request.get_json()\n        if not data or not isinstance(data, list):\n            return jsonify({'status': 'error', 'message': 'Invalid JSON data'}), 400\n\n        csv_file = os.path.join(api_key_dir, 'webhook_log.csv')\n        try:\n            with open(csv_file, 'a', newline='') as csvfile:\n                csv_writer = csv.writer(csvfile)\n                for item in data:\n                    csv_writer.writerow([\n                        item.get('timestampLong'),\n                        item.get('name'),\n                        item.get('rawValue'),\n                        item.get('value'),\n                        item.get('preValue'),\n                        item.get('rate'),\n                        item.get('changeAbsolute'),\n                        item.get('error')\n                    ])\n            return jsonify({'status': 'success', 'message': 'Data written to CSV file'}), 200\n        except Exception as e:\n            return jsonify({'status': 'error', 'message': 'Unable to open CSV file'}), 500\n\n    elif request.method == 'PUT':\n        # Handle PUT request: Save image\n        timestamp = request.args.get('timestamp')\n        if not timestamp or not timestamp.isdigit() or int(timestamp) < 0:\n            return jsonify({'status': 'error', 'message': 'Invalid timestamp'}), 400\n\n        image_data = request.data\n        if not image_data:\n            return jsonify({'status': 'error', 'message': 'No image data received'}), 400\n\n        image_file_path = os.path.join(api_key_dir, f'{timestamp}.jpg')\n        try:\n            with open(image_file_path, 'wb') as image_file:\n                image_file.write(image_data)\n            return jsonify({'status': 'success', 'message': 'Image uploaded successfully'}), 200\n        except Exception as e:\n            return jsonify({'status': 'error', 'message': 'Unable to save the image'}), 500\n\n    else:\n        # Handle unsupported HTTP methods\n        return jsonify({'status': 'error', 'message': 'Method not allowed'}), 405\n\nif __name__ == '__main__':\n    app.run(host='0.0.0.0', port=5001)\n
    "},{"location":"collect-new-images/","title":"Collect images to improve the models","text":"

    If your device has new, different digits or pointers it might be that the existing models don't recognize them well. In such case you can collect your images and so we can train the model better. This helps you and also others as the models get more accurate. Adding more images also helps if you have a model that is already known, but the neural models do not produce good results.

    Experienced users can do the training also by themselves, see Learn a model with your own images.

    "},{"location":"collect-new-images/#before-you-start","title":"Before you start","text":"

    Before you go ahead, please check if your digits/pointers are not yet contained in the training data. A visual overview is available at digits resp. pointers.

    Poor recognition is often caused by blurred images, low contrast or incorrect setting of the ROIs. Therefore, check these possibilities first, as additional training will bring little improvement here. See ROI Configuration for details.

    "},{"location":"collect-new-images/#collecting-images","title":"Collecting images","text":"

    The neural network is trained based on a set of images that have already been collected over time. If your digits are included or at least very similar to included images, the chance is very high that the neural network is working fine for you as well.

    The neural network configuration is stored in the TensorFlow Lite format as *.tfl or *.tflite in the /config directory on the SD card. A model can be updated (or a new one added) by uploading the new file and activating it on the configuration page or in the config file /config/config.ini.

    In order to incorporate new digits a training set of images is required. The training images needs to be collected in the final setup with the help of the Digits or Analog log settings (not to be confused with the Data or Debug log). Enable the logging of the images on the configuration page or in the config file /config/config.ini:

    Now be patient! You have to wait until it has collected an image of each digit of every type. They will be placed on the SD card in the folder /log/digit/ resp. /log/analog/.

    After some days, there will be a lot of images, many of them very similar. Because of this, it is important to select only a subset of them for the model training.

    The tools shown below can help you with that.

    "},{"location":"collect-new-images/#collecting-images-for-dig-class100dig-contana-class100","title":"Collecting images for dig-class100/dig-cont/ana-class100","text":"

    For digits use Collectmeterdigits resp. for pointers use collectmeteranalog to fetch the images from the device and select a subset of them. Please read the detailed instructions on the mentioned links for details!

    If the fetching of the images is too slow for you, a faster way to get the images to your PC is to remove the SD-card from the ESP32 module and insert it into the card reader of yur PC. Then search for two..three images of each digit (not more! :-)). You will have to make sure to label the images yourself matching the effective value they are supposed to show.

    "},{"location":"collect-new-images/#share-your-images","title":"Share your images","text":"

    In most cases we will integrate your images in the training dataset of the models. Only if we fear a degradation of the models or you need a different behavior, we might not include the data in the standard models (see at bottom of page for reasons).

    To provide your images to us for training the model, open an Github Issue and append the zipped images ito it.

    "},{"location":"collect-new-images/#images-can-be-rejected-if","title":"Images can be rejected if","text":"
    • You provide too many images. More than 1000 images of your device are really to much.
    • Images which are not good enough (see ROI Configuration) will be rejected. It would reduce the accuracy of the networks.
    • Images with too little focus will be rejected.
    • Images with too much blur are rejected.

    Our models are to small to recognize everything in any quality. So we use only images of medium or good quality.

    "},{"location":"data-logging/","title":"Data Logging","text":"

    When Data Logging is enabled (See parameter DataLogActive), the results of every round gets written to the SD-Card.

    The data files are stored in /log/data on the SD-Card.

    "},{"location":"data-logging/#data-format","title":"Data Format","text":"

    The data is stored as CSV with the following columns: time, name-of-number, raw-value, return-value, pre-value, change-rate, change-absolute, error-text, cnn-digit, cnn-analog

    "},{"location":"initial-setup/","title":"Initial Setup","text":"

    After setting up the device (firmware, SD card, WLAN) the device will connect to the wifi access point and start in an initial setup configuration:

    With the buttons on the top you can navigate through 5 steps which guide you through the necessary setup:

    1. Create the Reference Image. It is the base for the position referencing and the identification of the digits and counters.
    2. Define two unique Reference Marks. They is used to align the individual camera images and identify the absolute positions.
    3. Define ROIs for the Digits. They will be used to digitize the digit part of your meter. If your meter has no digits, this step can be skipped.
    4. Define ROIs for the Analog Counters. (Only required in case your meter has analog counters)
    5. General Settings. Further configuration of your device.

    All settings can be accessed later in the normal operation mode.

    Note

    Don't forget to save each step with \"Save\", and do not reboot at this stage.

    "},{"location":"initial-setup/#finish-the-setup-and-change-to-the-normal-operation-mode","title":"Finish the Setup and change to the Normal Operation mode","text":"

    With the last step (1) you leave the Setup Mode and reboot to the Normal Operation mode.

    "},{"location":"initial-setup/#access-to-the-setup-pages-in-the-normal-operation-mode","title":"Access to the Setup Pages in the Normal Operation mode","text":"

    You always can access all the settings during the normal operation mode via the Settings menu:

    • (1) Access to the General Settings.
    • (2) Update of the Reference Image.
    • (3) Update of the Alignment Marks.
    • (4)/(5) Update of the ROIs.
    "},{"location":"ota/","title":"Over-The-Air (OTA) Update","text":"

    You can do an OTA (over-the-air) update via the Web Interface. Grab the firmware from the

    • Releases page (Stable, tested versions), or the
    • Automatically build development branch (experimental, untested versions). Please inform yourself on Living on the Edge first!
    "},{"location":"ota/#update-procedure","title":"Update Procedure","text":"
    1. Create a backup of your configuration. Either use the Backup/Restore function of your device for this (menu System > Backup/Restore) or back the files manually up using the File Server (menu File Server, folder config). It is recommended to at least save the config file config.ini!
    2. Head to the menu System > OTA Update and follow the instructions there.

    If you do an update between major versions, it might be needed to modify the config file config.ini as it's syntax or context has changed. To do so, go to the menu Settings > Configuration (after the update completed and the device restarted) and check if it warns you about an unset parameter.

    "},{"location":"ota/#update-from-version-v1200-or-newer","title":"Update from version v12.0.0 or newer","text":"

    You can use the over the air update mechanism, which uploads the update via a ZIP files.

    The update file is located on the release page. Please choose the zip file with the following naming: AI-on-the-edge-device__update__*.zip

    Go to the menu System --> OTA Update and follow the instructions there. After a final automatic reboot you should have the new version running.

    "},{"location":"ota/#update-from-version-older-than-v1200","title":"Update from version older than v12.0.0","text":"

    If you update from an version older than 12.0.1, you should firstly update to version 12.0.1. Background are not fully backward compatible changes in the config.ini, that are taken care of in this version.

    Warning

    Make sure to read the instructions below carefully!

    1. Backup your configuration (use the System -> Backup/Restore page)!

    2. Upload and update the update-*.zip file from the release 12.0.1 see here .

    3. Let it restart and check on the System -> Info page that the Firmware as well as the Web UI got updated. If only one got updated, redo the update. If it fails several times, you also can update the Firmware and the Web UI separately.

    4. Safe way:

      1. Update first the firmware.bin (extract it from one of the provided zip files) and do the Reboot
      2. Update with the full zip file (update-*.zip, ignore the version warning after the reboot)

    5. Please go to Settings -> Configuration and address the changed parameters:

      • DataLogging (storing the values for data graph)
      • Debug (extended by different debug reporting levels)

    6. Make sure it starts to do the digitization (check the Error field on the overview page). If it does not start a round within a minute, restart the device.

    Note

    If the system is working now without any issues, please open the configuration editor once and save the config.ini. This will update the file to the newest content.

    Now you can safely update to the newest version.

    "},{"location":"outdated--Integrated-Functions/","title":"Integrated Functions","text":"

    Warning

    This page no longer is maintained!

    "},{"location":"outdated--Integrated-Functions/#wasserzaehler","title":"wasserzaehler","text":"

    http://IP-ESP32/wasserzaehler.html

    This is the main purpose of this device. It returns the converted image as a number with different option. The output can be modified either by the configuration parameters or by HTML parameters.

    Details can be found here: tbd

    "},{"location":"outdated--Integrated-Functions/#picture-server","title":"Picture Server","text":"

    http://IP-ESP32/capture

    http://IP-ESP32/capture_with_flashlight

    This is a implementation of the camera interface of https://github.com/jomjol/water-meter-picture-provider

    It is fully compatible including the parameters (quality=..., size=... ) . This allows to use this ESP32 system in parallel to the corresponding docker system: https://github.com/jomjol/water-meter-system-complete, from which this project is basically the successor.

    "},{"location":"outdated--Integrated-Functions/#file-server","title":"File server","text":"

    Access: http://IP-ESP32/fileserver/

    Simple file server, that allows viewing, upload, download and deleting of single files of the SD-card content.

    The usage is self explaining. The file path or file can directly be accessed by the URL after file server.

    Example for config.ini : http://IP-ESP/fileserver/config/config.ini

    "},{"location":"outdated--Integrated-Functions/#ota-update","title":"OTA-Update","text":"

    http://IP-ESP32/ota?file=firmware.bin

    Here an over the air update can be triggered. The firmware file is expected to be located in the sub directory /firmware/ and can be uploaded with the file server. By the parameter file the name of the firmware file needs to be given.

    "},{"location":"outdated--Integrated-Functions/#reboot","title":"Reboot","text":"

    http://IP-ESP32/reboot

    A reboot with a delay of 5 seconds is initiated, e.g. after firmware update.

    ATTENTION: currently this is not working properly - hardware power off is needed instead. Work in progress!

    "},{"location":"outdated--Integrated-Functions/#simple-web-server","title":"Simple Web Server","text":"

    If none of the above URLs are fitting, a very simple web server checks, if there is a fitting file from the sub directory /html This can be used for a very simple web server for information or simple web pages.

    "},{"location":"prometheus-openmetrics/","title":"Prometheus/OpenMetrics","text":"

    A set of metrics is exported via the /metrics REST API path on the device. Besides the current value, a set of device properties are exported. Multiple sequences (aka numbers) are supported via a label. The metrics are provided in text wire format.

    Example:

    $ curl http://<IP>/metrics\n# HELP ai_on_the_edge_device_flow_value current value of meter readout\n# TYPE ai_on_the_edge_device_flow_value gauge\nai_on_the_edge_device_flow_value{sequence=\"main\"} 240.7064\n# HELP ai_on_the_edge_device_cpu_temperature_celsius current cpu temperature in celsius\n# TYPE ai_on_the_edge_device_cpu_temperature_celsius gauge\nai_on_the_edge_device_cpu_temperature_celsius 41\n# HELP ai_on_the_edge_device_rssi_dbm current WiFi signal strength in dBm\n# TYPE ai_on_the_edge_device_rssi_dbm gauge\nai_on_the_edge_device_rssi_dbm -67\n# HELP ai_on_the_edge_device_memory_heap_free_bytes available heap memory\n# TYPE ai_on_the_edge_device_memory_heap_free_bytes gauge\nai_on_the_edge_device_memory_heap_free_bytes 716303\n# HELP ai_on_the_edge_device_uptime_seconds device uptime in seconds\n# TYPE ai_on_the_edge_device_uptime_seconds gauge\nai_on_the_edge_device_uptime_seconds 214267\n# HELP ai_on_the_edge_device_rounds_total data aquisition rounds since device startup\n# TYPE ai_on_the_edge_device_rounds_total counter\nai_on_the_edge_device_rounds_total 239\n
    "},{"location":"prometheus-openmetrics/#prometheus-scrape-config","title":"Prometheus Scrape Config","text":"

    The following scrape config (add to prometheus.yml) can be used as an example to ingest available metrics with prometheus:

    scrape_configs:\n  - job_name: watermeter\n    scrape_interval: 300s\n    metrics_path: /metrics\n    static_configs:\n      - targets: ['<IP>']\n
    "},{"location":"prometheus-openmetrics/#references","title":"References","text":"
    • OpenMetrics
    "},{"location":"unstable-installation/","title":"Living on the Edge","text":"
    • The main branch contains the latest version of the Firmware and the Web Interface. It might already contain a fix for your issue. But it is work in progress, don't expect it to work stable or be an improvement for your AI-on-the-edge-device! Also it might break the OTA Update and thus require manual flashing over USB! For normal users it is better tu use a release.
    • Any other branch is used to develop a feature or fix, only use them when you know what it is about!
    "},{"location":"unstable-installation/#i-still-want-to-try-it","title":"I still want to try it","text":"

    Ok, then grab the latest main build from Github Actions Page and proceed as following:

    1. Pick the most top successful (green) build:
    2. Scroll down and download the AI-on-the-edge-device__update__*.zip:
    3. Flash the zip file using the OTA Update page of your device.
    "}]} \ No newline at end of file +{"config":{"lang":["en"],"separator":"[\\s\\-]+","pipeline":["stopWordFilter"]},"docs":[{"location":"","title":"Welcome","text":"

    Welcome to the AI-on-the-edge-device project!

    This is the documentation. For the source code, please head to github.com/jomjol/AI-on-the-edge-device.

    Artificial intelligence based systems have been established in our everyday lives. Just think of speech or image recognition. Most of the systems rely on either powerful processors or a direct connection to the cloud for doing the calculations up there. With the increasing power of modern processors the AI systems are coming closer to the end user - which is usually called edge computing. Here this edge computing is brought into a practice-oriented example, where a AI network is implemented on a ESP32 device so: AI on the edge.

    "},{"location":"#key-features","title":"Key features","text":"
    • Tensorflow Lite (TFlite) integration - including easy to use wrapper
    • Inline image processing (feature detection, alignment, ROI extraction)
    • Small and cheap device (3x4.5x2 cm\u00b3, < 10 EUR)
    • Camera and illumination integrated
    • Web surface to administrate and control
    • OTA-Interface to update directly through the web interface
    • Full integration into Home Assistant
    • Support for Influx DB 1 and 2
    • MQTT
    • REST API
    "},{"location":"#idea","title":"Idea","text":""},{"location":"#hardware","title":"Hardware","text":""},{"location":"#web-interface","title":"Web interface","text":""},{"location":"#configuration-interface","title":"Configuration Interface","text":"

    Have fun in studying the new possibilities and ideas

    This is about image recognition and digitization, done totally on a cheap ESP32 board using artificial intelligence in form of convolutional neural networks (CNN). Everything, from image capture (OV2640), image preprocessing (auto alignment, ROI identification) all the way down to the image recognition (CNN structure) and result plausibility is done on a cheap 10 EUR device.

    This all is integrated in an easy to do setup and use environment, taking care for all the background processing and handling, including regular job scheduler. The user interface is an integrated web server, that can be easily adjusted and offers the data as an API in different options.

    The task to be demonstrated here is an automated readout of an analog water meter. The water consumption is to be recorded within a house automatization and the water meter is totally analog without any electronic interface. Therefore, the task is solved by regularly taking an image of the water meter and digitizing the reading.

    There are two types of CNN implemented, a classification network for reading the digit numbers and a single output network for digitize the analog pointers for the sub digit readings.

    This project is an evolution of the water-meter-system-complete, which uses ESP32-CAM just for taking the image and a 1GB-Docker image to run the neural network's backbone. Here everything is integrated in an ESP32-CAM module with 8MB of RAM and a SD card as data storage.

    "},{"location":"#additional-tutorials","title":"Additional Tutorials","text":"

    A lot of people created useful Youtube videos which might help you getting started. Here a small selection:

    • youtube.com/watch?v=HKBofb1cnNc
    • youtube.com/watch?v=yyf0ORNLCk4
    • youtube.com/watch?v=XxmTubGek6M
    • youtube.com/watch?v=mDIJEyElkAU
    • youtube.com/watch?v=SssiPkyKVVs
    • youtube.com/watch?v=MAHE_QyHZFQ
    • youtube.com/watch?v=Uap_6bwtILQ
    "},{"location":"Additional-Information/","title":"Additional Information","text":"

    The following links point to additional information in other repos:

    "},{"location":"Additional-Information/#digits","title":"Digits","text":"
    • Training the CNN neural network
    • Training and using a neural network to readout the value of a digit counter
    "},{"location":"Additional-Information/#analog","title":"Analog","text":"
    • Training and using a neural network to read out the value of an analog display
    • Training the CNN neural network
    "},{"location":"Alignment/","title":"Alignment References","text":"

    The alignment references are used in every round to re-align the taken image to the reference coordinates. Two alignment structures must be defined and the taken image then in each round is shifted and rotated according to their position with the target to be in exactly the same position as the reference image.

    Note

    The alignment structures needs to be unique and have a good contrast. It is advised to have them as far apart as possible.

    "},{"location":"Alignment/#precondition","title":"Precondition","text":"

    Please make sure to have setup your camera properly and taken a good Reference Image.

    "},{"location":"Alignment/#define-two-reference-images","title":"Define two Reference Images","text":"

    You can switch between this two marks with (1).

    Then define the reference area in the image by either directly drag and drop with the mouse or use the input boxes below. To apply the currently marked image part you need to push \"Update Reference\" (2).

    In some cases it might be useful to use a reference with a higher contrast. This can be achieved by pushing Enhance Contrast\" (3). The result will be calculated on the ESP32 - so be a bit patient, before you see it active.

    To save push \"Save to config.ini\" (4).

    Note

    A reboot is not required at this point of time.

    As next you should define the Digit and Analog ROIs.

    "},{"location":"Best-Practice/","title":"Best Practice","text":"

    This page shows some best practices:

    "},{"location":"Best-Practice/#camera-placement","title":"Camera Placement","text":"
    • Move the Camera as close as possible (~4cm), this will help get rid of reflections. -> focus can be adjusted by turning the outer black ring of the camera.
    • If the LED reflections are too strong, put tape over the LED to diffuse the light
    • Change the ImageSize to QVGA under \"Expert mode\" configuration when close enough, this will be faster and is often good enough for digit recognition.
    "},{"location":"Best-Practice/#reflections","title":"Reflections","text":"
    • Try to get rid of the reflections by rotating the camera, so that the reflections are at positions, where no number is.
    • By using the external LED option, you can place WS2812 LEDs freely away from the main axis.
    • Users report, that a handy cover foil could also help
    "},{"location":"Best-Practice/#post-processing","title":"Post-processing","text":"
    • Filter out the Number \"9\", as \"3\" will often be misread for a \"9\" and void every number between 3 and 9 due to it being negative flow.
    • Split the readings into two, while the decimal numbers might move to fast to be recognized, at least the slower moving part will produce a correct reading. -> keep in mind that the offset needs to be adjusted, a.e if you have a comma reading of \"3\", it needs to become \"0.3\". This can be done wherever the data ends up being sent, like home assistant using sensor templates.
    • If you are using a low resolution and only digit mode, processing can often be done in <1 minute. Check the logs to confirm how fast it is and then set the interval accordingly under \"Expert mode\" in configuration, as the normal mode will lock you to 3+ minutes.
    "},{"location":"Build-Instructions/","title":"Build the Project","text":"

    See README.md in the main repo.

    "},{"location":"Choosing-the-Model/","title":"Model Selection","text":"

    Notes

    See Neural Network Types for additional details.

    In the Graphical Configuration Page, you can choose different models depending on your needs.

    This page tries to help you on which model to select. For more technical/deeper explanations have a look on Neural-Network-Types.

    "},{"location":"Choosing-the-Model/#digit-models","title":"Digit Models","text":"

    For digits on water meters, gas-meters or power meters you can select between two main types of models:

    • dig-class11
    • dig-class100 and dig-cont
    "},{"location":"Choosing-the-Model/#dig-class11","title":"dig-class11","text":"

    This model can recognize full digits. It was the first model version. All intermediate states shown a N for not a number. But in post process it uses older values to fill up the N values if possible.

    It's possibly a good fallback, if dig-cont or dig-class100 results are not good.

    Main features:

    • well suited for LCD digits
    • the ExtendedResolution option is not supported. (Only in conjunction with ana-class100 or ana-cont)
    "},{"location":"Choosing-the-Model/#dig-class100-and-dig-cont","title":"dig-class100 and dig-cont","text":"

    These models are used to get a continuous reading with intermediate states. To see what the models are doing, you can go to the Recognition page of your device.

    Main features:

    • suitable for all digit displays.
    • Advantage over dig-class11 that results continue to be calculated in the transition between digits.
    • With the ExtendedResolution option, higher accuracy is possible by adding another digit.

    The difference between dig-class100 and dig-cont is in the internal processing. The dig-class100 is a standard classification model. Each tenth step is an output. dig-cont uses two outputs and arctangent to get the result. You see very complicated.

    Note

    Try both models on your device and take the one that gives you the best results.

    Look here for a list of digit images used for the training.

    "},{"location":"Choosing-the-Model/#analog-pointer-models","title":"Analog pointer models","text":""},{"location":"Choosing-the-Model/#ana-class100-and-ana-cont","title":"ana-class100 and ana-cont","text":"

    For pointers on water meters use the analog models:

    You can choose between two models:

    • ana-class100
    • ana-cont

    Both do mainly the same.

    Main features:

    • for all analogue pointers, especially for water meters.
    • With the ExtendedResolution option, higher accuracy is possible by adding another digit.

    Again, the difference between ana-class100 and ana-cont is in the internal processing.

    Note

    Take the one that gives you the best results. Both models learn from the same data.

    Look here for a list of pointer images used for the training

    "},{"location":"Choosing-the-Model/#different-types-of-models-normal-vs-quantized","title":"Different types of models (normal vs. quantized)","text":"

    The normally trained network is calculating with internal floating point numbers. The saving of floating point numbers naturally takes more space than an integer type. Often the increased accuracy is not needed. Therefore there is the option, to \"quantize\" a neural network. In this case the internal values are rescaled to integer values, which is called \"quantization\". The stored tflite files are usually much smaller and runs faster on the edgeAI-device. Usually the models are distrusted therefore in both versions. They can be distinguished by a q at the end of the logfile.

    Example:

    Type Name Normal dig-cont_0610_s3.tflite Quantized dig-cont_0610_s3-q.tflite"},{"location":"Configuration/","title":"Graphical Configuration","text":"

    Most of the settings can be modified on the Settings page:

    It can be reached via the menu Settings > Configuration.

    Note

    • To activate the changes, the device needs to be restarted after saving the changes.
    • Most of the commands need processing on the ESP32 device. This is not very fast - so please be patient.

    All parameters are documented on the Parameters page and as tooltips on the config page.

    "},{"location":"Configuration/#expert-parameters","title":"Expert Parameters","text":"

    Some parameters are treated as Expert Parameters and are hidden by default. Tick the checkbox in the top left corner to enable them:

    The Expert Parameters then will be shown with a red background:

    "},{"location":"Configuration/#manual-editing-of-the-config-file","title":"Manual Editing of the Config File","text":"

    Even more configuration parameters can be edited manually in the config.ini:

    To edit the config.ini file directly, click on the Edit Config.ini directly button.

    "},{"location":"Configuration/#background-information","title":"Background Information","text":"

    Note

    You do not need to understand this! But you might be interested in it.

    The principle is very simple and can most easily be described as a flow of processing steps. Each step has a dedicated parameter description in the config.ini, which is indicated by brackets [name_of_step]. The steps are processed in the order written in the config file. That means, that you first have to describe the image taking, then the aligning and cutting and only after that you can start to config a neural network. The last step is the post processing.

    "},{"location":"Configuration/#processing-steps-overview","title":"Processing steps - Overview","text":"

    In the following you get a short overview over the available steps. This order is also the suggested order for the processing flow. Single steps can be left out, if not needed (e.g. omit the analog part, if only digits are present)

    "},{"location":"Configuration/#1-takeimage","title":"1. [TakeImage]","text":"

    This steps parametrises the taking of the image by the ESP32-CAM. Size, quality and storage for logging and debugging can be set.

    "},{"location":"Configuration/#2-alignment","title":"2. [Alignment]","text":"

    Image preprocessing, including image alignment with reference images

    "},{"location":"Configuration/#3-digits","title":"3. [Digits]","text":"

    Neural network evaluation of an image for digits. The neural network is defined by a tflite formatted file and the output is a number between 0 .. 9 or NaN (if image is not unique enough)

    "},{"location":"Configuration/#4-analog","title":"4. [Analog]","text":"

    Neural network evaluation of analog counter. The neural network is defined by a tflite formatted file and the output is a number between 0.0 .. 9.9, representing the position of the pointer.

    "},{"location":"Configuration/#5-postprocessing","title":"5. [PostProcessing]","text":"

    Summarized the individually converted pictures to the overall result. It also implements some error corrections and consistency checks to filter wrong reading.

    For more details look at Correction Algorithm).

    "},{"location":"Configuration/#6-mqtt","title":"6. [MQTT]","text":"

    Transfer of the readings to a MQTT server.

    "},{"location":"Configuration/#7-autotimer","title":"7. [AutoTimer]","text":"

    Configuration of the automated flow start at the start up of the ESP32.

    "},{"location":"Configuration/#8-debug","title":"8. [Debug]","text":"

    Configuration for debugging details

    "},{"location":"Correction%20Algorithm/","title":"Correction Algorithm","text":"

    After the digitization of the images and the composition to a number a checking and correction algorithm is applied. This is explained here.

    There are several reasons, that a check might be necessary:

    1. In case of digits there is the output of \"N\" (=NaN = Not-a-Number) in case the digit cannot be detected correctly. This happens for example if the image shows a digit between to states
    2. The replacement of the \"N\" with a previous value could be not sufficient, due to the fact, that it might have changed.
    3. There is a misreading of one one of the numbers. This can always happen in case of neural network processing.
    "},{"location":"Correction%20Algorithm/#terms-and-definitions","title":"Terms and definitions","text":""},{"location":"Correction%20Algorithm/#prevalue","title":"PreValue","text":"

    The last correct read value. PreValue is here a bit missleading, because normally it is the same as the last value. In the next round of reading it will be used to check nagtive rates, high rates (MaxRateValue / MaxRateType) and CCheckDigitIncreaseConsistency (dig-class11 only). Either from a previous correctly identified value or manual setting by the user.

    "},{"location":"Correction%20Algorithm/#digits","title":"Digits","text":"

    Value that are digitized from a digit number. There are 11 allowed values for this:

    1. Digits: 0, 1, 2, ... 9
    2. N = Not-a-Number - representing a not unique state between two numbers
    "},{"location":"Correction%20Algorithm/#analogs","title":"Analogs","text":"

    This are value derived from a pointer like meter. This never has the state \"N\".

    "},{"location":"Correction%20Algorithm/#checkdigitincreaseconsistency","title":"CheckDigitIncreaseConsistency","text":"

    If this is enabled an \"intelligent\" algorithm is used to derive from zero-crossing of discrete digit positions, if the number should have been increased. This is relevant because in some of the digit meters, the increase of a digit to the next number can be seen, before the sub-digit has gone through zero.

    For example: 16.6 --> 16.7 --> 1N.8 --> 17.9 corrected to 16.9 --> 17.0 --> 17.1

    As you can see, the 17.9 is a false reading as the 7 is assumed to be already readable, although the sub-digit has not crossed the zero. In this case the CheckDigitIncreaseConsistency algorithm will correct this to 16.9

    A detailed description of the algorithm can be found below (not yet ready!)

    "},{"location":"Correction%20Algorithm/#allownegativerates","title":"AllowNegativeRates","text":"

    Most of the meters only have increasing numbers and do not count backwards. Therefore a negative rate (= negative change compared to the PreValue) is surely a false value. This can be checked an flagged as false reading

    The AllowNegativeRates property ensures that the result does not become negative in the event of incorrect readings. This can happen, for example, if the alignment of the image did not work properly. But also the neural networks sometimes flip between two states for similar images.

    If AllowNegativeRates = true, the result is discarded if it is smaller than the pre-value of the last readout and the output shows an error \"Negative rate..\"

    If the ExtendedResolution setting is true, there is an exception where the value does not become smaller, but no error is output. This only applies if the value +/- 0.2 of the last digit is inaccurate.

    "},{"location":"Correction%20Algorithm/#decimalshift","title":"DecimalShift","text":"

    The DecimalShift setting puts the decimal point in the right place. It acts like a shift. Negative values shift the decimal point to the left. Positive values move the decimal point to the right, filling with zero.

    "},{"location":"Correction%20Algorithm/#analogtodigittransitionstart","title":"AnalogToDigitTransitionStart","text":"

    For detailed description see Analog-digit-transition.

    "},{"location":"Correction%20Algorithm/#maxratevalue-and-maxratetype","title":"MaxRateValue and MaxRateType","text":"

    Here the maximum change from one to the next reading can be limited. If a false reading of the neural network results in a change larger than this, the reading is flagged as false. There a two types of comparisons possible

    1) AbsolutChange: Here the difference between the PreValue and the current reading is compared directly, independent how much time has passed since the last reading. 2) RelativeRate: in this case a change rate in the unit of change/minute is calculated, taking the time between the last and the current reading into account. Be careful, that with increasing time, the absolute allowed change increases. Example: relative rate of 0.05 m\u00b3/minute --> after 20 minutes a maximum change of 20 minutes * 0.05 m\u00b3/minute = 1 m\u00b3 is possible. That means that a false reading of 1 m\u00b3 cannot be detected false after about 20 minutes in this case Assume, that there might be no change in the meter for hours (e.g. during the night) a much bigger change could also be accepted.

    "},{"location":"Correction%20Algorithm/#extendedresolution","title":"ExtendedResolution","text":"

    Newer models such as dig-cont and dig-class100 have a high resolution of the values and can thus represent another digit by using the value of the last digit or pointer (ex. 7.8 in the last digit).

    If the value is set to true, the result of the last digit is used completely.

    When using dig-class11 models, the setting is ignored.

    Due to inaccuracies of the neural networks, it sometimes happens that the results jump back and forth between two decimal places. Therefore, when using \u00c0llowNegatives= false, no error is output if the value is only off by 0.2. Nevertheless, the value then remains at the higher determined value.

    "},{"location":"Correction%20Algorithm/#ignoreleadingnan","title":"IgnoreLeadingNaN","text":"

    The parameter is only be used, if a dig-class11 model is selected. \u00ccgnoreLeadingNaN removes in the CheckDigitIncreaseConsistency process the leading N values.

    "},{"location":"Correction%20Algorithm/#flow-chart","title":"Flow Chart","text":""},{"location":"Correction%20Algorithm/#checkdigitincreaseconsistency-algorithm","title":"CheckDigitIncreaseConsistency Algorithm","text":"

    The check digit increase consistency algorithm is functional for the digits only. Due to the fact, that the rotation might be a little bit earlier or later compared to the zero crossing of the digit before, errors during the reading before and after a zero crossing can be wrong. Therefore a simple algorithm can be applied, checking the consistency of zero crossing and changes in the following digit. This is applied to one after the other digit, starting with the lowest priority digits.

    "},{"location":"Demo-Mode/","title":"Demo Mode","text":"

    For Demo and Testing Purpose, the device can use pre-recorded raw images.

    You need to enable it in the configuration (TakeImage > Demo) and also provide the needed files on the SD card.

    For each round one image gets used, starting with the first image for the first round.

    For the reference image and the alignment also the first image gets used.

    Once the last image got reached, it starts again with the first one.

    "},{"location":"Demo-Mode/#sd-card-structure","title":"SD Card Structure","text":"
    demo/\n\u251c\u2500\u2500 520.8983.jpg\n\u251c\u2500\u2500 520.9086.jpg\n\u251c\u2500\u2500 520.9351.jpg\n\u251c\u2500\u2500 ...\n\u2514\u2500\u2500 files.txt\n
    • The jpg files can have any name
    • The jpg files must be smaller than 30'000 bytes
    • The files.txt must contains a list of those files, eg:
      520.8983.jpg\n520.9086.jpg\n520.9351.jpg\n
    "},{"location":"Demo-Mode/#collecting-images-of-your-device","title":"Collecting images of your device","text":"

    There are several ways to collect images from your device:

    1. Use the Parameter RawImagesLocation to store them directly onto your SD card.
    2. Use the Webhook to send the raw image on each round to a dedicated server, see Webhook resp. ../Parameter UploadImg.

    3. Another option is to pull the images periodically from http://<IP>/img_tmp/raw.jpg. Eg. with an external service. Below is a (Linux)-Bash script to do it:

      #!/bin/bash\nwhile [[ true ]]; do\n    echo \"fetching value...\"\n    wget -q http://192.168.1.151/value -O value.txt\n\n    value=`cat value.txt`\n    echo \"Value: $value\"\n\n    diff=`diff value.txt value_previous.txt`\n    changed=$?\n    #echo \"Diff: $diff\"\n\n        if [[ $changed -ne 0 ]]; then\n            echo \"Value changed:\"\n            echo $diff\n            echo \"fetching image...\"\n            wget -q http://192.168.1.151/img_tmp/raw.jpg -O $value.jpg\n        else\n            echo \"Value did not change, skipping image fetching!\"\n        fi\n\n        cp value.txt value_previous.txt\n\n        echo \"waiting 60s...\"\n        sleep 60\ndone\n
    "},{"location":"Demo-Mode/#use-prepared-images","title":"Use prepared images","text":"

    Instead of recoding your own images, you can use one of the selections of prepared images below.

    "},{"location":"Demo-Mode/#how-does-it-work","title":"How does it work","text":"

    The Demo Mode tries to interfere as less as possible with the normal behavior. Whenever a Cam framebuffer gets taken (esp_camera_fb_get()), it replaces the framebuffer with the image from the SD card.

    "},{"location":"Demo-Mode/#example-data-of-a-water-meter","title":"Example Data of a Water Meter","text":"

    You can use the following demo images if you want:

    It covers a meter range from 530.00688 to 531.85882.

    "},{"location":"Demo-Mode/#animation","title":"Animation","text":"

    Animation of the watermeter (77 MB!)

    "},{"location":"Demo-Mode/#selection-of-84-images","title":"Selection of 84 images","text":"

    Demo_Images_Watermeter_530.00688-532.08243_84_images.zip

    "},{"location":"Demo-Mode/#selection-of-42-images","title":"Selection of 42 images","text":"

    Demo_Images_Watermeter_530.00688-532.08243_42_images.zip

    "},{"location":"Demo-Mode/#all-images-843-images","title":"All images (843 images)","text":"

    Demo_Images_Watermeter_530.00688-532.08243_843_images.zip

    "},{"location":"Error-Codes/","title":"Reduced webinterface (error indication and tracing)","text":"

    Whenever an error occurs during boot process which avoids loading of regular processing and regular webinterface, a reduced webinterface gets loaded to have at least some visual feedback and the possibilitiy to figure out the root cause by browsing the logfiles or trigger another OTA update.

    The error code(s) get printed with specific error codes. This page lists the possible error codes, their meaning and possible solutions.

    Notes

    Here the error codes are defined in source code: error codes.

    "},{"location":"Error-Codes/#critical-errors","title":"Critical Errors","text":"

    Those Errors make the normal operation of the device impossible. Most likely they are caused by a hardware issue!

    "},{"location":"Error-Codes/#0x00000001-psram-bad","title":"0x00000001 PSRAM bad","text":"

    Your device most likely has no PSRAM at all or it is too small (needs to have at least 4 MBytes)! See Hardware Compatibility.

    Usually the log shows something like this: 

    psram: PSRAM ID read error: 0xffffffff\ncpu_start: Failed to init external RAM!\n

    "},{"location":"Error-Codes/#0x00000002-heap-too-small","title":"0x00000002 Heap too small","text":"

    The firmware failed to allocate enough memory. This most likely is a consequential error of a bad PSRAM!

    "},{"location":"Error-Codes/#0x00000004-cam-bad","title":"0x00000004 Cam bad","text":"

    The attached camera can not be initialized. This usually is because on of the following reasons:

    • The camera is not supported, see Hardware Compatibility
    • The camera is not attached properly -> Try to remove and attach it again. Make sure you move the black part enough into the socket!
    • The camera or the camera cable is damaged
    "},{"location":"Error-Codes/#0x00000008-sd-card-basic-check-failed","title":"0x00000008 SD card basic check failed","text":"

    One or more basic SD card checks failed.

    The following checks are performed during boot sequence:

    • Write a file (sdcard/sdcheck.txt) to SD card with some generic text
    • Read the written file back
    • CRC verification
    • Delete the file

    Detailed error indication (write, rerad or delete error) can be derived from blinking code of red board status LED. Please refer to StatusLED-BlinkCodes

    Recommendation: Reformat SD card and check again or try another SD card

    "},{"location":"Error-Codes/#0x00000010-sd-folder-or-file-presence-check-failed","title":"0x00000010 SD folder or file presence check failed","text":"

    One or more mandatory folders and/or files are missing on SD card. To have early indication that SD card is potentially ready for operation, some folder and files, which are mandatory are presence checked. This is not a 100% check and a successful test does not mean everthing is OK.

    The following folders / files get checked during boot sequence:

    • /sdcard/config
    • /sdcard/html
    • /sdcard/demo --> created automatically in firmware
    • /sdcard/firmware --> created automatically in firmware
    • /sdcard/img_tmp --> created automatically in firmware
    • /sdcard/log --> created automatically in firmware
    • /sdcard/wlan.ini
    • /sdcard/config/config.ini
    • /sdcard/html/index.html
    • /sdcard/html/ota_page.html
    • /sdcard/html/log.html
    • /sdcard/html/common.js
    • /sdcard/html/version.txt

    Notes

    This list might be outdated, see the source code for the latest implementation: SDCardCheckRW()

    Recommendation: Check logs and / or redo a Over-The-Air Update (OTA Update) to ensure proper SD card structure

    "},{"location":"Error-Codes/#non-critical-errors","title":"Non-Critical Errors","text":"

    Those Errors can be caused by an error during initialization. It is possible that the error has no impact at all or that a reboot solves it.

    "},{"location":"Error-Codes/#0x00000100-cam-framebuffer-bad","title":"0x00000100 Cam Framebuffer bad","text":"

    The firmware was unable to initialize the Camera Framebuffer. The firmware will continue to work, but other consequential error might arise. A reboot of the device might help.

    This might also be caused by a corrupred SD-Card, see CAM is not working anymore\" on init #2390

    "},{"location":"Error-Codes/#0x00000200-ntp-failed","title":"0x00000200 NTP failed","text":"

    The firmware failed to get the world time from an NTP server. The firmware will continue to work, but has a wrong time.

    "},{"location":"Error-Debugging/","title":"Often observed issues","text":""},{"location":"Error-Debugging/#hardware-failure","title":"Hardware failure","text":"
    • Camera not working --> check the interface, test another module
    • Low cost module with no or only 2MB memory instead of 4MB --> test another module
    • SD card issues --> test another SD card
    • Wifi reception bad / unstable --> bad antenna, test another module or use external antenna

    More information in terms of hardware, component and basic configuration issues can be found here: Reboot reasons

    "},{"location":"Error-Debugging/#roi-misaligned","title":"ROI misaligned","text":"

    This typically happens if you have suboptimal \"Alignment Marks\". A very simple and working solution is to put put higly contrasted stickers on your meter and put \"Alignment Marks\" on it (see picture below)

    If after those adjustment you still have some issues, you can try to adjust your alignment settings in expert mode:

    "},{"location":"Error-Debugging/#my-analog-meter-are-recognized-as-digit-counter-or-vice-versa","title":"My Analog Meter are recognized as Digit Counter or vice versa","text":"
    1. First, check that your ROI are correctly defined (yey!)
    2. Second, verify that the name of your ROI analog and digit ROIs are different
    "},{"location":"Error-Debugging/#recognition-is-working-well-but-number-arent-sorted-correctly","title":"Recognition is working well, but number aren't sorted correctly","text":"

    You have to sort your ROI correctly (Bigger to smaller). Select your ROI and click either \"move next\" or \"move previous\". Repeat until your ROI are correctly sorted

    "},{"location":"External-LED/","title":"External LED","text":"

    The internal flash LED is very close to the camera axis. This results in reflection, especially in case of flat glass surfaces such as for power meters. To circumvent this problem, it is now possible to control external LEDs, which than can be places somewhere else in the setup. As not simples LEDs are used, but RGB LEDs with a digital interface like WS2812 not only the position, but also the color and intensity of the illumination can now be adjusted. The following image shows a direct comparison of the \"old\" internal flash LED and two off axis LEDs.

    There is also a new meter adapter available. This has two features: designed for small clearings in front of the meter and prepared for WS2812 LEDs.

    "},{"location":"External-LED/#1-hardware-installation-of-the-led-stripe","title":"1. Hardware installation of the LED stripe","text":"

    The control line of the LED stripe is connected with a 470 Ohm resistor to the GPIO12. For power supply stabilization a capacitor between 5V and ground is recommended. Here a 470\u00b5F polymer capacitor is used. As a power supply a 5V from the ESP32 is used like in the following wiring.

    "},{"location":"External-LED/#2-software-configuration","title":"2. Software configuration","text":"

    The handling of the WS2812 LED controller needs some other libraries, therefore it is controlled within a dedicated section called GPIO Settings. The external LED stripe is connected to GPIO12. After activating the \"GPIO Settings\" section, the internal flash is per default disabled. In order to activate the external LED, you need to activate GPIO 12 state and select \"extern flash light ws281x ...\".

    Parameter Meaning LED-Type There are several types of controller implemented: WS2812(B), WS2813, SK6812 Numbers of LED Number of LEDs on the LED stripe LED Color The color and intensity can be controlled directly by a red/green/blue value, each within the range from 0 (off) to 255 (full)

    Enabling the GPIO settings automatically disables the flash LED. Therefore you can enable it here manually by checking GPIO4 and choose \"build-in led flash light\". It is not recommended to use both illumination parallel.

    "},{"location":"FAQs/","title":"Frequently Asked Questions","text":""},{"location":"FAQs/#my-device-reboots-frequently-what-can-i-do","title":"My device reboots frequently. What can I do?","text":"

    There are several reasons for frequent reboots:

    • Frequent HTML requests
    • Wrong configuration, missing configuration files
    • Unstable hardware - see Hardware Compatibility.

    There is a dedicated page about this: Frequent Reboots.

    "},{"location":"FAQs/#bad-webui-responsiveness-what-can-i-do","title":"Bad WebUI responsiveness. What can I do?","text":"

    This is usually due to hardware or WLAN issues. There are already many entries in discussion section, some of which have good tipps.

    Possible checks / ideas:

    • ESP32CAM hardware antenna design is very poor in connection with camera frequency.
    • Simple test: When the device is in operation, putting your thumb on the camera connector and the directly adjacent components should make the device respond more quickly.
    • Possible optimization: Here, an attempt was made to dampen the frequency influences somewhat by shielding. Shielding Example
    • WLAN channel: Preferably use channel 1, 6 or 11
    • Performance can vary depending on the AP manufacturer. If necessary, check with a mobile hotspot or other device to exclude AP influence
    • Try with an external antenna
    • Avoid VLAN, currently not fully supported
    • Temporarily deactivate virus scanner / firewall on the end device for testing purpose
    • Use sufficiently dimensioned power supply
    • Use a branded SD card (formatted with Windows, MAC often causes problems)

    Check discussion section for possible further tipps.

    "},{"location":"FAQs/#how-accurate-are-the-detections","title":"How accurate are the detections?","text":"

    It is hard to give a specific accuracy number. It depends on many factors, e.g.

    • How in-focus is your camera?
    • How sturdy is the camera mount? Does it slightly move over extended periods of time?
    • What type of meter are you reading? Is the meter already in the training data set?
    • Are you trying to read digits, an analog dial, or both?
    • etc.

    Anecdotally, the authors of this page have great success with the meter. While the AI algorithm itself is not perfect and sometimes returns NaN or incorrect values, other post-processing / prevalue / sanity checks help ensure such invalid values are filtered out. With the correct settings, one author has been running this device for 1 month without any incorrect values reported.

    See the FAQs below for more details and configuration hints.

    "},{"location":"FAQs/#my-numbers-are-not-correctly-detected-what-can-i-do","title":"My numbers are not correctly detected. What can I do?","text":"
    • There is a dedicated page about the correct setting ROI Configuration.
    • This page also includes the instructions for gathering new images for the training.
    "},{"location":"FAQs/#how-can-i-ensure-invalid-numbers-are-never-reported","title":"How can I ensure invalid numbers are never reported?","text":"

    As mentioned above, the AI algorithm is not perfect. Sometimes it may read an incorrect value.

    We can tune the software to almost never report an incorrect value. There is a tradeoff though: the software may report stale values - i.e. it will drop incorrect values for a potentially long period of time, resulting in the meter reading being outdated by hours. If never receiving an incorrect value is important to you, consider tolerating this tradeoff.

    You can change the following settings to reduce incorrect readings (but potentially increase staleness of data):

    • Set a prevalue via the UI, then change PostProcessing configuration option PreValueAgeStartup to a much larger number (e.g. 43200 = 30 days).
    • Change PostProcessing configuration option MaxRateType to be time based instead of absolute. Set MaxRateValue to something realistic (e.g. 5 gal/min). You can often find the max flow rate your meter supports directly on the cover.
    • Reduce AutoTimer configuration option Interval to the lowest it can be (e.g. 3 min). The more often you take readings, the less likely for data staleness to occur.
    "},{"location":"FAQs/#even-after-i-have-setup-everything-perfect-there-is-a-false-reading-especially-around-the-zero-crossing-roll-over-to-next-number","title":"Even after I have setup everything perfect there is a false reading - especially around the zero crossing (roll over to next number)","text":"
    • The roll over behavior is different for the different meters. E.g.:
    • Rolling over start with different previous position (e.g. at 7, 8 or 9)

    • The neutral position (no rolling) is not perfectly at zero, but rather at something like 7.9 or 8.1, even if it should be exactly 8

    • The \"PostProcessingAlgo\" is trying to judge out of the individual readings, what number it should be.

    • For example if the previous number is a \"1\", but the next number seems to be a \"8.9\", most probably there was a \"zero crossing\" and the number is a \"9\" and not still an \"8\"

    • Currently the setting of the algorithm is set to fit most of the meters and cases. But the parameters do not fit perfectly for all situations. Therefore there might be intermediate states, where the reading is false. This is especially the case, at the positions, where the roll over (zero crossing) is just starting.

    • To prevent a sending of false parameters, there is the possibility to limit the maximum allowed change (MaxRateChange). Usually after some time and movement of the counters a bit further, the reading is getting back to a stable reading.
    • To handle this, a parametrized setting would be needed. This is rather complicated to implement as subtle changes make a relevant difference. Currently this is not implemented. So please be a bit patient with your meter :-)
    "},{"location":"FAQs/#pre-value","title":"Pre-Value","text":"

    PreValue is here a bit missleading, because normally it is the same as the last value. In the next round of reading it will be used to check nagtive rates, high rates (MaxRateValue / MaxRateType) and CheckDigitIncreaseConsistency (dig-class11 only). Either from a previous correctly identified value or manual setting by the user.

    If you use post processes, enable the pre-value. The pre-value must be set at first time. Set it to the current raw value.

    If the device runs in errors, the pre-value will not be updated, as long as the preValueAgeStartup time between the last valid value (or startup time) and current time is not exceeded. After it the preValue will be set again, if no other error occured. So the device can not run in an endless error, like high rate.

    "},{"location":"FAQs/#rate-too-high-read","title":"\"Rate too high - Read: ...\"","text":"

    In configuration you can set the MaxRateValue and MaxRateType. The settings suppress improbably high values that can come from false readings. To do this, the value must be set correctly depending on your meter.

    Before doing this, you should be clear about the type of rating you want to use.

    • Absolute change is the interval between two readings - no matter how often the readings happen.
    • RateChange is the change per minute. This is calculated from the time difference between the last and the current reading.

    If there is an interval of 5 minutes between readings and a MaxRateValue of 1, an error \"Rate too high - Read: ...\" if

    • Absolute change: the difference is > 1
    • RateChange: the difference is > 1 / 5
    "},{"location":"FAQs/#train-on-my-own-images","title":"Train on my own images","text":"

    Look at Learn models with your own images and Cookbook running the jupyter notebook with my own data.

    "},{"location":"FAQs/#what-does-aioted-mean","title":"What does AIOTED mean?","text":"

    This is just the abbreviation of AI-on-the-edge-device.

    "},{"location":"Frequent-Reboots/","title":"Basic hardware / configuration issues","text":"

    If the device is behaving eratically or not running as expected you can use the following tools trying to identify the root cause:

    1. Internal logging (config.ini) --> Set to DEBUG log level
    2. Reduced web interface (only error indication visualization, Error codes on reduced webinterface)
    3. Red board LED: Status LED Blinkcodes
    4. Serial log of the UART interface (USB access needed, only local, same as for flashing the firmware)

    There are in principle two reboots types:

    1. Sporadic random reboots (always different timing and situation)
    2. Repeating boot loops (reoccuring, always stop working after same precondition)
    "},{"location":"Frequent-Reboots/#sporadic-random-reboots","title":"Sporadic random reboots","text":"

    Sporadic random reboots could have the following reasons:

    • In general: Unstable system due to software issues (e.g. overload during HTML access, ...) --> Trying the figure out what's the root cause to fix the issue
    • Bad power supply --> The power supply need to stable to ensure proper operation of the device. If it's not stable the device tents to sporadic reboots (brownout detection)

    In general: There are several mechanisms in the firmware (like saving previous values), to have a \"smooth\" reboot without too many notable disturbance.

    "},{"location":"Frequent-Reboots/#system-instabilities","title":"System instabilities","text":"

    If your system is sometimes running smoothly over several runs and sometimes reboots obviously randomly, you have an partially unstable device.

    You can check this in the standard log file on the SD card:

    2021-12-26T06:34:09: task_autodoFlow - round done\n2021-12-26T06:34:09: CPU Temperature: 56.1\n2021-12-26T06:38:00: task_autodoFlow - next round - Round #23\n

    Here you see, that the round #23 is starting, so obviously there were no reboots in the last 22 rounds. There is hardware (ESP32CAM), where only 2-3 stable rounds are possible and others, where way more than 100 rounds without any reboots is possible. There is noting you can do about it, beside testing different hardware.

    "},{"location":"Frequent-Reboots/#overload-during-html-access","title":"Overload during HTML access","text":"

    If you frequently access the web server over HTML requests, the firmware tends to reboot. This especially happens during the first run and when the ESP32 is busy with the digitization flow.

    The reason for this are running out of memory during a flow, minor memory leakage in combination with missing error handling.

    There is noting you can do about this kind of reboot, beside two thing:

    1. Support the firmware development with improved and tested part of code
    2. Be patient :-)
    "},{"location":"Frequent-Reboots/#bad-or-insufficient-power-supply","title":"Bad or insufficient power supply","text":"

    A good and stabilized power supply is essential to have error free operation. The device is quite picky in terms of proper power supply. Especially the wifi module have some load spikes which the power supply needs to cover. If the power is not stable enough, the brwonout mechanism is protecting against strange behaviour and force a reboot whenever the voltage drops below a specific level. You can see this in random reboots which indication is logfile: --> Reset reason: Brownout

    "},{"location":"Frequent-Reboots/#repeating-boot-loops","title":"Repeating boot loops","text":"

    Repeating boot loops at the same situation during the flow has a systematic problem either in the hardware or the configuration. It usually happens during initialization state or processing the first round as there all needed parts of the firmware have been loaded for the first time.

    To identify the root cause the logfiles, the reduced web interface, the red board LED or the serial log of the UART interface (no remote access, USB access needed) is helpful.

    Possible issues:

    • SD card related issues
    • RAM related issues
    • Configuration related issues
    "},{"location":"Frequent-Reboots/#sd-card-related-issues","title":"SD card related issues","text":"

    The ESP32CAM is a little bit \"picky\" with the supported SD cards. Due to the limited availability of GPIOs the SD card can only be accessed via 1-wire mode. Therefore not all SD cards are supported. The following error cases can occur:

    "},{"location":"Frequent-Reboots/#sd-card-wrong-filesystem-only-fat32-is-supported","title":"SD card: Wrong filesystem (only FAT32 is supported)","text":"

    If this SD card error is detected only the following indications are available. No web interface will be accessible.

    • Red board LED is blinking. The blinking codes are described here: Status LED Blinkcodes
    • Error messages on serial log (UART interface)
    "},{"location":"Frequent-Reboots/#sd-card-not-detected-not-supported","title":"SD card not detected / not supported","text":"

    If this SD card error is detected the following indication are available. No web interface will be accessible.

    • Red board LED is blinking. The blinking codes are described here: Status LED Blinkcodes
    • Error messages on serial log (UART interface)
    "},{"location":"Frequent-Reboots/#sd-card-detected-but-files-are-not-readable-writeable","title":"SD card detected but files are not readable / writeable","text":"

    The SD card is detected, but the files cannot be read or written. A basic SD card check for SD reading / writing is performed on every boot. This not 100% guarantee that SD card is working but it's at least a indication.

    If this SD card error is detected the following indications are available:

    • The reduced web interface will be loaded to have visual feedback of error situation. Regualar processing is disabled, though. Within this reduced web interface logs can be viewed to have further indication what's the root cause. Error code desciption can be found here: Error codes on reduced webinterface
    • Error messages in logfile
    • Red board LED is blinking. The blinking codes are described here: Status LED Blinkcodes
    • Error messages on serial log (UART interface)
    "},{"location":"Frequent-Reboots/#ram-related-issues","title":"RAM related issues","text":"

    In order to run the firmware, 4 MB of external RAM (PSRAM) are mandatory. Usually, the ESP32CAM is equipped with 8MB (64Mbit) PSRAM chip, whereof only 4MB can be used effectively (direct addressable). Unfortunately, there is hardware around, where no PSRAM or only 2MB of PSRAM is present - even if you have bought a device where a 8MB PSRAM was promoted. These modules are not suiable for this firmware because the external RAM is needed to handle the CNN files and camera images. There is nothing to do, than to buy a new ESP32CAM with really 64MBit of PSRAM.

    "},{"location":"Frequent-Reboots/#too-less-external-ram-psram","title":"Too less external RAM (PSRAM)","text":"

    During the boot process the available RAM is going to be checked.

    If there is too less RAM (PSRAM or total HEAP < 4MB) detected, the follwoing indications are available:

    • The reduced web interface will be loaded to have visual feedback of error situation. Regualar processing is disabled, though. Within this reduced web interface logs can be viewed to have further indication what's the root cause. Error code desciption can be found here: Error codes on reduced webinterface
    • Error messages in logfile
    • Red board LED is blinking. The blinking codes are described here: Status LED Blinkcodes
    • Error messages on serial log (UART interface)
    "},{"location":"Frequent-Reboots/#configuration-related-issues","title":"Configuration related issues","text":""},{"location":"Frequent-Reboots/#folders-and-files-missing","title":"Folders and files missing","text":"

    Most of the relevant folders and files are checked during boot. The complete list can be found here: Error codes on reduced webinterface

    If a relevant folder or file is missing the following indications are available:

    • The reduced web interface will be loaded to have visual feedback of error situation. Regualar processing is disabled, though. Within this reduced web interface logs can be viewed to have further indication what's the root cause. Error code desciption can be found here: Error codes on reduced webinterface
    • Error messages in logfile
    • Red board LED is blinking. The blinking codes are described here: Status LED Blinkcodes
    • Error messages on serial log (UART interface)
    "},{"location":"Frequent-Reboots/#cnn-model-file-not-available-corrupt","title":"CNN model file not available / corrupt","text":"

    Additionally for operation CNN model files on SD card are mandatory, one CNN model file for analog counter and for for digit numbers each.

    • /config/XXXXX.tflite (XXXXX is the file name, that is written in the config.ini)

    If the files which are configured in config.ini are not present or corrupt, the process is going to be interrupted (or at worst case a device crash occurs). Please check logs files to have an indicator for the root cause.

    This a logfile extract (DEBUB log level) where digit CNN model file is not present. The system is initializing the system and trying to load the model files: 

    [0d00h05m11s] 2023-03-27T12:25:14 [TFLITE] CTfLiteClass::LoadModel\n[0d00h05m11s] 2023-03-27T12:25:14 [TFLITE] CTfLiteClass::ReadFileToModel: /sdcard\n[0d00h05m11s] 2023-03-27T12:25:14 [PSRAM] Failed to allocate 0 bytes in PSRAM for 'TFLITE->modelfile'!\n[0d00h05m11s] 2023-03-27T12:25:14 [TFLITE] CTfLiteClass::ReadFileToModel: Can't allocate enough memory: 0\n[0d00h05m12s] 2023-03-27T12:25:14 [HEAP] CTfLiteClass::ReadFileToModel Heap Total: 2266214 | SPI Free: 2205939 | SPI Large Block: 2162688 | SPI Min Free: 2205423 | Int Free: 60275 | Int Large Block: 55296 | Int Min Free: 46451\n[0d00h05m12s] 2023-03-27T12:25:14 [CNN] Can't load tflite model -> Init aborted!\n[0d00h05m12s] 2023-03-27T12:25:14 [HEAP] getNetworkParameter-LoadModel Heap Total: 2266214 | SPI Free: 2205939 | SPI Large Block: 2162688 | SPI Min Free: 2205423 | Int Free: 60275 | Int Large Block: 55296 | Int Min Free: 46451\n[0d00h05m12s] 2023-03-27T12:25:14 [PSRAM] Freeing memory in PSRAM used for 'TFLITE->modelfile'...\n[0d00h05m12s] 2023-03-27T12:25:14 [PSRAM] Freeing memory in PSRAM used for 'TFLITE->tensor_arena'...\n[0d00h05m12s] 2023-03-27T12:25:14 [PSRAM] Allocated 819200 bytes in PSRAM for 'TFLITE->tensor_arena'\n[0d00h05m12s] 2023-03-27T12:25:14 [TFLITE] CTfLiteClass::LoadModel\n[0d00h05m12s] 2023-03-27T12:25:14 [TFLITE] CTfLiteClass::ReadFileToModel: /sdcard/config/ana-cont_1105_s2_q.tflite\n[0d00h05m12s] 2023-03-27T12:25:15 [PSRAM] Allocated 53328 bytes in PSRAM for 'TFLITE->modelfile'\n[0d00h05m12s] 2023-03-27T12:25:15 [TFLITE] CTfLiteClass::MakeAllocate\n[0d00h05m12s] 2023-03-27T12:25:15 [PSRAM] Freeing memory in PSRAM used for 'TFLITE->modelfile'...\n[0d00h05m12s] 2023-03-27T12:25:15 [PSRAM] Freeing memory in PSRAM used for 'TFLITE->tensor_arena'...\n

    • Bad config example:

    • [0d00h05m11s] 2023-03-27T12:25:14 [TFLITE] CTfLiteClass::ReadFileToModel: /sdcard --> model file missing: check configuration or file presence

    • Good config example:

    • [0d00h05m12s] 2023-03-27T12:25:14 [TFLITE] CTfLiteClass::ReadFileToModel: /sdcard/config/ana-cont_1105_s2_q.tflite --> model file found: config OK
    "},{"location":"Hardware-Compatibility/","title":"Hardware Compatibility","text":""},{"location":"Hardware-Compatibility/#general-remark","title":"General Remark","text":"

    Although a board looks similar, it can have major differences, e.g.:

    • Processor
    • Ram (Size! & Type) -> this Project needs at least 4MB RAM!
    • Flashrom
    • Camera Modules
    • Onboard/External Antenna
    • Quality of Components
    • Manufacture Quality of the PCB and soldering
    • Different Components
    • \"Clone\" Components -> ESPxx
    • etc.

    This can cause different Power Consumption, Power Requirements, compatibility issues, etc.

    Most manufacturers and sellers buy what's cheap today on the Asian markets. In the end, it looks like it is sometimes a trial and error approach which ESP32-CAM Module works reliably.

    Below you find some remarks and experiences from the community:

    "},{"location":"Hardware-Compatibility/#esp32-core-itself","title":"ESP32 core itself","text":"Chip Version Image Status ESP32-D0WDQ6 (revision 1) \u2714\ufe0f"},{"location":"Hardware-Compatibility/#psram","title":"PSRAM","text":"

    There seems to be a lot of \"fake\" chips, or maybe wrongly configured ESP32 Boards.

    For AP MEMORY, all \"real\" APS6404*3SQR chips should work.

    For ESP PSRAM, all \"real\" PSRAM64* should work.

    64Mbit density = 8Mbyte PSRAM

    This Table is just a snapshot of chips which worked

    Labeling on PSRAM module Image Status IPUS / IPS640LS0 / 1815XBGN \u2714\ufe0f AP MEMORY / 6404L-3SOR / 1040H / 110089G \u2714\ufe0f AP MEMORY / 6404L-3SQR / 12205 / 150047G \u2714\ufe0f 8MB AP MEMORY / 6404L-3SQR / 12208 / 150047G \u2714\ufe0f 8MB AP MEMORY / 6404L-350R / 1120A / 130027G \u274c PSRAM not accessible AP MEMORY / 6404L-35QR / 11208 / 130025G \u274c PSRAM not accessible AP MEMORY / 6404L-3SQR / 13100 / 180026G \u274c PSRAM not accessible AP MEMORY / 6404L-3SQR / 11207 / 130024G \u274c PSRAM not accessible AP MEMORY / 6404L-3SQR / 1120A / 130027G \u2714\ufe0f 8MB AP MEMORY / 6404L-3SQR / 1120B / 130028G \u2714\ufe0f 8MB AP MEMORY / 6404L-3SQR / 1120D / 130030G \u2714\ufe0f 8MB AP MEMORY / 1604M-3SQR / 0280A / 070036G \u274c 2MB only! ESP PSRAM64H 462021 / 1B00286 \u2714\ufe0f ESP PSRAM64H 412021 / 1A0039G \u2714\ufe0f 8MB ESP PSRAM64H 402021 / 1A0017N \u274c PSRAM not accessible ESP PSRAM16M 302020 \u274c 2MB only! ESP PSRAM16H 202020 / 050022G \u274c 2MB only!"},{"location":"Hardware-Compatibility/#ov2640-camera","title":"OV2640 - Camera","text":"

    The experience with the camera only is based on single modules. It is well possible, that this module had a damage overall and other modules of the same type will work. Give it a try and report to me!

    Labeling on Flex-Connector Image Status TY-OV2 / 640-V2.0 \u2714\ufe0f DCX-OV2 / 640-V2 \u2714\ufe0f DC-26 / 40-V3 \u2714\ufe0f 3x \u274c 1x"},{"location":"Hardware-Compatibility/#esp32-modules","title":"ESP32 Modules","text":"Module Image Status ESP32CAM / Different versions on the market!Especially the PSRAM is sometimes labeled wrong(Label: 4MB, Real: only 2 MB --> will not work!) \u2714\ufe0fwith >=4 MB PSRAM! ESP32-S3-EYENo Flash LED, pins different used (e.g. LCD display) NOT OKAY"},{"location":"Hardware-Compatibility/#sd-cards","title":"SD Cards","text":"

    Due to the limited free available GPIOs (due to all the extensions needed like: camera, SD card, LED-flash, ...) the SD card is connected in 1-wire mode. There are some cards, that are compatible with the esp32cam module for unknown reasons. It is observed, that smaller cards (up to 4 GB) tend to be more stable and larger cards have more problems. But quite some exceptions in the forums (4 GB cards not working, 16 GB cards working like a charm).

    "},{"location":"Hardware-Compatibility/#devices-known-to-work","title":"Devices known to work","text":""},{"location":"Hardware-Compatibility/#modules-old-list-not-up-to-date-anymore","title":"Modules (Old list, not up-to-date anymore):","text":"

    See https://github.com/jomjol/AI-on-the-edge-device/discussions/1732 for a more recent list.

    • https://arduino-projekte.info/produkt/esp32-cam-v2-integriertem-ch340-mit-ov2640-kamera-modul/ (see https://github.com/jomjol/AI-on-the-edge-device/discussions/1041)

    • https://www.amazon.de/-/en/gp/product/B0B51CQ13R

    • https://www.reichelt.de/entwicklerboards-esp32-kamera-2mp-25--debo-cam-esp32-p266036.html?PROVID=2788&gclid=CjwKCAiAqaWdBhAvEiwAGAQlttJnV4azXWDYeaFUuNioMICh-jvxKp6Cifmcep9vvtoT2JRCDqBczRoC7Q0QAvD_BwE (27.12.2022)

    "},{"location":"Hardware-Compatibility/#sd-card","title":"SD Card","text":"
    • Sandisk 2GB Micro SD Class 2 Sandisk 2GB AITRIP ESP32 and CAM ESP-32/CAM
    • Amazon US - Aideepen ESP32-CAM W BT Board ESP32-CAM-MB Micro USB to Serial Port CH-340G with OV2640 2MP Camera Module Dual Mode with Amazon US - Cloudisk 5Pack 4GB Micro SD Card 4 GB MicroSD Memory Card Class6
    "},{"location":"Hardware-Compatibility/#weak-wifi","title":"Weak Wifi","text":"

    The ESP32-CAM supports an external antenna. It requires some soldering skills but can improve the connection quality. See https://randomnerdtutorials.com/esp32-cam-connect-external-antenna/

    "},{"location":"Influx-DB/","title":"Influx DB","text":"

    The device also supports direct sending of data to an Influx DB.

    See also Influx Graph in Home Assistant.

    "},{"location":"Installation/","title":"Installation","text":"

    The installation requires multiple steps:

    1. Get the right hardware and wire it up
    2. Flash the firmware onto the ESP32
    3. Write the data to the SD card
    4. Start it

    For point 2 and 3 we provide multiple ways to do it. Pick the one that looks the easiest for you!

    "},{"location":"Installation/#1-hardware","title":"1. Hardware","text":""},{"location":"Installation/#esp32-cam","title":"ESP32-CAM","text":"
    • OV2640 camera module
    • Micro SD card slot
    • 4 or 8 MB PSRAM.

    It can be easily found on the typical internet stores, searching for ESP32-CAM for less than 10 EUR. How ever since the hardware is cheap and coming from China, you unluckily could pick a malfunctioning device. See Hardware Compatibility for further advice!

    "},{"location":"Installation/#usb-uart-interface","title":"USB->UART interface","text":"

    For first time flashing the firmware a USB -> UART connector is needed. Later firmware upgrades than can be flashed via OTA.

    "},{"location":"Installation/#power-supply","title":"Power supply","text":"

    For power supply a 5V source is needed. Most easily this can be done via a USB power supply. The power supply should support minimum 500mA. For buffering current peaks some users reported to use a large electrolytic capacitor like a 2200uF between ground and VCC.

    Warning

    In several internet forums there are problems reported, in case the ESP32-CAM is only supplied with 3.3V.

    "},{"location":"Installation/#housing","title":"Housing","text":"

    A small 3D-printable example for a very small case can be found in Thingiverse here: https://www.thingiverse.com/thing:4571627

    Warning

    The focus of the OV2640 needs to be adjusted, as it is normally set from ~40cm to infinity. In order to get an image that is big enough, it needs to be changed to about 10cm. Therefore the sealing glue on the objective ring needs to be removed with a scalpel or sharp knife. Afterwards the objective can be rotated clockwise until the image is sharp again.

    "},{"location":"Installation/#wiring","title":"Wiring","text":"

    Beside the 5V power supply, only for the first flashing a connection to the USB-UART connector, including a short cut of GPIO0 to GND for bootloader start.

    A example for wiring can be found here:

    It is also possible to use external LEDs for the illumination instead of the internal flash LED. This is described here

    "},{"location":"Installation/#2-firmware","title":"2. Firmware","text":""},{"location":"Installation/#web-installer","title":"Web Installer","text":"

    There is a Web Installer available which will work right out of the web browser Edge and Chrome. You can access it with the following link: Web Installer

    This is the preferred way for beginners as it also allows access to the USB Log:

    "},{"location":"Installation/#manual-flashing","title":"Manual Flashing","text":""},{"location":"Installation/#files","title":"Files","text":"

    Grab the firmware from the

    • Releases page (Stable, tested versions), or the
    • Automatically build development branch (experimental, untested versions). Please have a look on Living on the Edge first!

    You need:

    • partitions.bin
    • bootloader.bin
    • firmware.bin
    "},{"location":"Installation/#flashing-using-the-flash-tool-from-espressif-gui","title":"Flashing using the Flash Tool from Espressif (GUI)","text":"

    Get the Flash Download Tool from Espressif.

    Download and extract the Flash tool, after starting choose \"Developer Mode\", then \"ESP32-DownloadTool\" and you are in the setup of the flashing tool. Connect the ESP32-CAM with the USB-UART connection and identify the COM-Port.

    Warning

    If you are re-flashing the code again, it is strongly recommended to erase the flash memory before flashing the firmware. Especially if you used OTA in between, which might cause remaining information on the flash, to still boot from an old image in the OTA-area, which is not erased by a normal flash.

    Put your ESP32 in bootloader mode and push start, then it will identify the board and you can configure the bin-configuration according to the following table:

    Filename Offset bootloader.bin 0x1000 partitions.bin 0x8000 firmware.bin 0x10000

    "},{"location":"Installation/#flashing-using-the-python-based-esptool-console","title":"Flashing using the Python based esptool (Console)","text":"

    For this you need a python environment (e.g. Anaconda in Win10). Here you need to install the esptool:

    pip install esptool\n
    Then connect the ESP32 with the USB-UART connector to the system, put it in boot mode and with the following command you can erase the flash and flash bootloader, partitions and firmware in two steps:

    esptool erase_flash\nesptool write_flash 0x01000 bootloader.bin 0x08000 partitions.bin 0x10000 firmware.bin\n
    - Maybe you need to specify the COM-port if it is not detected by default. - If the erase command throws the error A fatal error occurred: ESP32 ROM does not support function erase_flash., your esptool might be too old, see https://techoverflow.net/2022/02/08/how-to-fix-esp32-a-fatal-error-occurred-esp32-rom-does-not-support-function-erase_flash/

    With some Python installations this may not work and you\u2019ll receive an error, try python -m pip install esptool or pip3 install esptool.

    Further recommendations can be found on the espressif webpage.

    "},{"location":"Installation/#3-sd-card","title":"3. SD Card","text":"

    The software expects an SD card prepared with certain directory and file structure in order to work properly. SD card most top directory should look like this:

    This initial setup needs only to be done once as further updates (Firmware as well as SD card content) are possible with the Over-The-Air Update mechanism.

    "},{"location":"Installation/#notes","title":"Notes","text":"
    • Due to the limited availability of GPIOs (OV2640, Flash-Light, PSRAM & SD card) the communication mode to the SD card is limited to 1-line SD-Mode. It showed up, that this results in problems with very large SD-Cards (64GB, sometimes 32 GB) and some no name low cost SD-cards.
    • There must be no partition table on the SD-card (no GPT, but only MBR for the single partition)
    • Following setting are necessary for formatting the SD-card: SINGLE PARTITION, MBR, FAT32 - 32K. NOT exFAT
    • Some ESP32 devices share their SD-card and/or camera GPIOs with the pins for TX and RX. If you see errors like \u201cFailed to connect\u201d then your chip is probably not entering the bootloader properly. Remove the respective modules temporarily to free the GPIOs for flashing. You may find more information about troubleshooting on the homepage of Espressif.

    The ESP32 indicates problems with the SD card during startup with a fast, endless blinking. In this case, please try another SD card.

    "},{"location":"Installation/#manual-setup-with-an-sd-card-reader-on-a-pc","title":"Manual Setup with an SD Card Reader on a PC","text":"
    1. Take the AI-on-the-edge-device__manual-setup__*.zip from the Release page.
    2. Open it and extract the sd-card.zip.
    3. Open it and extract all files onto onto your SD card.
    4. On the SD card, open the wlan.ini file and configure it as needed:
      • Set the corresponding SSID and password
      • The other parameters are optional

    !!! Note The device provides a File Server which can be used to show, edit or delete the files on the SD card. For security reasons, the wlan.ini file is excluded from this and is hidden from external access to protect the password.

    After this, you can insert the SD card into the ESP32 board and start it.

    "},{"location":"Installation/#remote-setup-using-the-built-in-access-point","title":"Remote Setup using the built-in Access Point","text":"

    On startup of the ESP32, it checks if the wlan.ini or the config/config.ini are available on the SD card. If not, the ESP32 switches to a special mode. In this mode, it provides a Wifi Access Point which can be used to add the missing wlan.ini or the config/config.ini file.

    1. Take the AI-on-the-edge-device__remote-setup__*.zip from the Release page.

    2. Connect to Access Point of the device. The SSID is \"AI-on-the-Edge\" and you can access it without any password:

      The device has the following fixed IP: http://192.168.4.1.

    3. Upload initial configuration to SD card

      Use the select file and upload button to start the upload. A warning will show up if you have chosen a possible wrong file (without default configuration).

    4. Store WLAN access information.

      After the upload, a new page will be shown:

      Enter your SSID and password.

      Note

      Only basic settings are supported. If you need advanced configuration (fixed ip, ...), you need to use the manual setup as documented above.

      Warning

      • Carefully check your wifi settings. To change them later on, you need to take out the SD card and edit the wlan.ini manually (or delete it and start again).
      • The information is transferred without encryption!

      Finish the step by pushing Write wlan.ini

    5. Reboot

      The final step is the reboot:

      Warning

      It will take up to 3 minutes. Afterwards you can find your device in the local network. Check your router for the IP. You can find it also in the USB Console output.

    "},{"location":"Installation/#4-initial-startup","title":"4. Initial Startup","text":"

    After the firmware is flashed and the SD card is setup properly, you can start it. After power on the connection status is indicated by 3x blinking of the red on board LED.

    WLAN-Status indication:

    • 5 x fast blinking (< 1 second): connection still pending
    • 3 x slow blinking (1 second on/off): WLAN connection established

    Notes

    It is normal that at first one or two times a pending connection is indicated.

    "},{"location":"Integration-Home-Assistant/","title":"Integration into Home Assistant","text":"

    There are 3 ways to get the data into your Home Assistant:

    1. Using MQTT (Automatically Setup Entities using Home Assistant MQTT Discovery)
    2. Using MQTT (Manually Setup Entities)
    3. Using REST calls

    The first one is the easier way if you already have MQTT in use.

    "},{"location":"Integration-Home-Assistant/#using-mqtt-automatically-setup-entities-using-home-assistant-mqtt-discovery","title":"Using MQTT (Automatically Setup Entities using Home Assistant MQTT Discovery)","text":"

    Starting with Version >12.0.1, AI-on-the-edge-devices support Home Assistant Discovery.

    1. Check here to learn more about it and how to enable it in Homeassistant.

    2. You also have to enable it in the MQTT settings of your device:

      Make sure to select the right Meter Type to get the right units!

    On the next start of the device, it will send discovery topics and Home Assistant should pick them up and show them under Settings > Integrations > MQTT:

    "},{"location":"Integration-Home-Assistant/#using-mqtt-manually-setup-entities","title":"Using MQTT (Manually Setup Entities)","text":"

    First make sure with an MQTT client (for example MQTT Explorer) that MQTT works as expected and to get a list of the available topics!

    Then add a sensor for each property: 

    mqtt:\n  sensor:\n    - state_topic: \"wasserzaehler/main/value\"\n      name: \"Watermeter Value\"\n      unique_id: watermeter_value\n      unit_of_measurement: 'm\u00b3'\n      state_class: total_increasing\n      device_class: water # Needs Home Assistant 2022.11!\n      icon: 'mdi:water-pump'\n      availability_topic: wasserzaehler/connection\n      payload_available: connected\n      payload_not_available: connection lost\n\n    - state_topic: \"wasserzaehler/main/rate\"\n      name: \"Watermeter Rate\"\n      unique_id: watermeter_rate\n      unit_of_measurement: 'm\u00b3/min'\n      state_class: measurement\n      device_class: water # Needs Home Assistant 2022.11!\n      icon: 'mdi:water-pump'\n      availability_topic: wasserzaehler/connection\n      payload_available: connected\n      payload_not_available: connection lost\n\n    - state_topic: \"wasserzaehler/main/error\"\n      name: \"Watermeter Error\"\n      unique_id: watermeter_error\n      icon: \"mdi:water-alert\"\n      availability_topic: wasserzaehler/connection\n      payload_available: connected\n      payload_not_available: connection lost    \n\n    - state_topic: \"wasserzaehler/uptime\"\n      name: \"Watermeter Uptime\"\n      unique_id: watermeter_uptime\n      unit_of_measurement: 's'\n      state_class: measurement\n      device_class: duration\n      entity_category: diagnostic\n      icon: \"mdi:timer-outline\"\n      availability_topic: wasserzaehler/connection\n      payload_available: connected\n      payload_not_available: connection lost\n
    If you run the discovery once, you can also extract the information from there (MQTT Info, untested): 
    mqtt: # Extracted form the Discovery but untested!\n  sensor:\n      - name: Value\n        unique_id: wasserzaehler-main_value\n        icon: mdi:gauge\n        state_topic: wasserzaehler/main/value\n        unit_of_measurement: m\u00b3\n        device_class: water\n        state_class: total_increasing\n        availability_topic: wasserzaehler/connection\n        payload_available: connected\n        payload_not_available: connection lost\n

    If you want to convert the m\u00b3 to l, use a template sensor: 

    template:\n  - sensor:\n    - name: \"Watermeter in l\"\n      unique_id: watermeter_in_l\n      icon: \"mdi:gauge\"\n      state: \"{{ states('sensor.watermeter_value')|float(default=0) * 1000 }}\" # Convert 1 m3 => 1000 l\n      unit_of_measurement: l\n      availability: \"{{ states('sensor.watermeter_value') not in ['unknown', 'unavailable', 'none'] }}\"\n

    If you you want to have the consumption per day, you can use an Utility Meter. it is a helper and can be used to reset the total increasing values once a day

    utility_meter:\n  utility_meter_gas_per_day:\n    source: sensor.gasmeter_value\n    cycle: daily\n\n  utility_meter_water_per_day:\n    source: sensor.watermeter_value\n    cycle: daily\n

    Note that you also can add it using the UI.

    "},{"location":"Integration-Home-Assistant/#examples","title":"Examples","text":""},{"location":"Integration-Home-Assistant/#statistics-graph","title":"Statistics Graph","text":"

    Creating Statistics Graphs (e.g. usage per day) is easy using the Energy Dashboard:

    Note that there seems to be a bug in the graph, see https://github.com/home-assistant/frontend/issues/13995!

    "},{"location":"Integration-Home-Assistant/#influxdb-graphs","title":"InfluxDb Graphs","text":"

    See also Influx-DB.

    If you have setup InfluxDB already, it is also possible to fetch statistics from there, e.g. daily usage: 

    from(bucket: \"HomeAssistant\")\n|> range(start: v.timeRangeStart, stop: v.timeRangeStop)\n  |> filter(fn: (r) => r[\"entity_id\"] == \"wasserverbrauch_tag\")\n  |> filter(fn: (r) => r[\"_field\"] == \"value\")\n  |> timeShift(duration: -1d)\n  |> aggregateWindow(every: 1d, fn: max, createEmpty: false)\n  |> yield(name: \"mean\")\n

    "},{"location":"Integration-Home-Assistant/#using-rest","title":"Using REST","text":"

    When using REST, Home Assistant has to periodically call an URL on the ESP32 which in return provides the requested data.

    See REST API for a list of available URLs.

    The most practical one is the json entrypoint which provides the most relevant data JSON formatted: http://<IP>/json This would return: 

    {\n\"main\":\n  {\n    \"value\": \"512.3020\",\n    \"raw\": \"0512.3020\",\n    \"error\": \"no error\",\n    \"rate\": 0.000000,\n    \"timestamp\": \"2022-10-02T20:32:06\"\n   [..]\n  }\n}\n

    To do such a REST call, you need to create a REST sensor: 

    sensor:\n\n- platform: rest\n  name: \"Gasmeter JSON\" \n  resource: http://<IP>/json\n  json_attributes:\n    - main\n  value_template: '{{ value_json.value }}'\n  headers:\n    Content-Type: application/json\n  scan_interval: 60\n\ntemplate:\n  sensor:\n  - name: \"Gasmeter Value from JSON\"\n    unique_id: gas_meter_value_from_json\n    state: \"{{ state_attr('sensor.gasmeter_json','main')['value'] }}\"\n    unit_of_measurement: 'm\u00b3'\n\n  - name: \"Watermeter Value from JSON\"\n    unique_id: water_meter_value_from_json\n    state: >-\n            {{ state_attr('sensor.watermeter_json','main')['value'] | float }}\n    unit_of_measurement: 'm\u00b3'\n    device_class: water\n    state_class: total_increasing\n    icon: mdi:gauge\n

    The 2nd way is to use the html api call from value.html :

    sensor: - platform: rest resource: http://<IP>/value.html name: cold_water unique_id: cold_water_from_rest unit_of_measurement: \"L\" device_class: water state_class: total_increasing icon: mdi:gauge scan_interval : 120

    See also https://community.home-assistant.io/t/rest-sensor-nested-json/243420/9

    "},{"location":"Integration-Home-Assistant/#photo","title":"Photo","text":"

    REST can also be used to show the photo of the last round:

    To access it, use http://<IP>/img_tmp/alg_roi.jpg resp http://<IP>/img_tmp/raw.jpg.

    "},{"location":"Learn-models-with-your-own-images/","title":"Learn a model with your own images","text":"

    Once you have collected and selected your own images (see Collect images to improve the models), you can train your very own model with them.

    This is an optional step and only suggested for advances users!

    For training the model you will need a python and Jupyter installation.

    All current labeled images you can find under ziffer_sortiert_raw

    "},{"location":"Learn-models-with-your-own-images/#dig-class11-models-digits","title":"dig-class11 models (digits)","text":"

    Fork and checkout neural-network-digital-counter-readout.

    Install all requirements for running the notebooks.

    pip install -r requirements.txt\n

    Put your labeled images into /ziffer_sortiert_raw folder and run

    1. Image_Preparation.ipynb
    2. Train_CNN_Digital-Readout-Small-v2.ipynb

    It creates a dig-class11_xxxx_s2.tflite model, you can upload to the config folder on your device and test it.

    "},{"location":"Learn-models-with-your-own-images/#dig-class100-dig-cont-models-digits","title":"dig-class100 / dig-cont models (digits)","text":"

    Fork and checkout neural-network-digital-counter-readout.

    All labeled images you can find under Images

    Install all requirements for running the notebooks.

    pip install -r requirements.txt\n

    Put your labeled images into images/collected/<typeofdevice>/<your_short>/

    Run dig-class100-s2.ipynb. The model to upload to your device you can find under '/output'.

    "},{"location":"Learn-models-with-your-own-images/#ana-class100ana-cont-models-analog-pointers","title":"ana-class100/ana-cont models (analog pointers)","text":"

    Fork and checkout neural-network-analog-needle-readout.

    All labeled images you can find under data_raw_all

    Install all requirements for running the notebooks.

    pip install -r requirements.txt\n

    Put your labeled images into images/collected/<typeofdevice>/<your_short>/

    After every adding of images you need to run Image_Preparation.ipynb before you train the models.

    Run Train_CNN_Analog-Readout_100-Small1_Dropout.ipynb and/or Train_CNN_Analog-Readout_Version-Small2.ipynb. The model to upload to your device you can find in the project folder.

    "},{"location":"Learn-models-with-your-own-images/#share-your-images","title":"Share your images","text":"

    If the results are good you can share the images as pull-request. Please images only!

    See Share your images for details.

    "},{"location":"MQTT-API/","title":"MQTT API","text":"

    The device is capable to register to a MQTT broker to publish data and subscribe to specific topics.

    Note

    Only MQTT v3.1.1 is supported.

    The MQTT service has to be enabled and configured properly in the device configuration via web interface (Settings -> Configuration -> section MQTT)

    The following parameters have to be defined: * URI * MainTopic (optional, if not set, the hostname is used) * ClientID (optional, if not set, AIOTED- + the MAC address gets used to make sure the ID is unique) * User (optional) * Password (optional) * RetainFlag (optional)

    "},{"location":"MQTT-API/#published-topics","title":"Published topics","text":""},{"location":"MQTT-API/#status","title":"Status","text":"

    The following overhead data are available under the main topic (i.e. watermeter):

    Topic Description watermeter/MAC The MAC address of the ESP module. watermeter/IP The IP address of the ESP module. watermeter/Hostname The network host name of the ESP module. watermeter/Interval The round interval as configured during setup or in Parameters -> Interval. watermeter/Connection Network connection status. watermeter/Uptime Seconds up since last boot. watermeter/FreeMem Free memory in kB. watermeter/wifiRSSI Quality of WiFi signal. watermeter/CPUTemp Temperature of the ESP CPU in degrees celsius."},{"location":"MQTT-API/#result","title":"Result","text":"

    The following calculation data are available under the sup-topic main (i.e. watermeter/main):

    Topic Description watermeter/main/error Informs about the flow status. On success, the value is no error. watermeter/main/raw The value before performing post processing. watermeter/main/value The value after performing post processing. watermeter/main/rate How much flow was consumed in one minute. watermeter/main/rate_per_time_unit How much flow was consumed in one minute. The time unit gets set with the Home Assistant Discovery, e.g. h (hours) or m (minutes). watermeter/main/changeabsolut Difference between the previous and actual read value. watermeter/main/rate_per_digitization_round How much flow was consumed in one minute. watermeter/main/timestamp Timestamp of the last valid reading (equal to timestamp of previous value) watermeter/main/Status Informs about the last performed step of the watermeter (i.e. Flow finished). watermeter/main/json This is a JSON formatted object containing the following values: value, raw, pre, error, rate, timestamp."},{"location":"MQTT-API/#gpio","title":"GPIO","text":"

    MainTopic/{GPIO topic}, e.g. watermeter/GPIO/GPIO12

    "},{"location":"MQTT-API/#gpiogpiopinnumber","title":"GPIO/GPIO{PinNumber}","text":"

    Depending on device configuration (Settings --> Configuration --> section GPIO)

    "},{"location":"MQTT-API/#subscribed-topics","title":"Subscribed topics","text":"

    MainTopic/{subscribed topic}, e.g. watermeter/ctrl/flow_start

    "},{"location":"MQTT-API/#control","title":"Control","text":""},{"location":"MQTT-API/#ctrlflow_start","title":"ctrl/flow_start","text":"

    Trigger a flow start by publishing to this topic.

    This will automatically reset the flow interval.

    "},{"location":"MQTT-API/#ctrlset_prevalue","title":"ctrl/set_prevalue","text":"

    Note

    This feature is available since version 15.2.0.

    Set the last valid value (previous value) to given value or the actual RAW value. Payload needs to be provided in JSON notation.

    Payload:

    • Set to given value (value >= 0): {\"numbersname\": \"<NUMBERSNAME>\", \"value\": <VALUE>}

      • \"numbersname\":Provide name of number sequence, e.g. \"main\"
      • \"value\": provide the value to be set, eg. 12345.67890

    • Set to actual RAW value (value < 0, a valid RAW value is mandatory): {\"numbersname\": \"<NUMBERSNAME>\", \"value\": -1}

      • \"numbersname\": Provide name of number sequence, e.g. \"main\"
      • \"value\": Provide any negative number
    "},{"location":"MQTT-API/#gpiogpiopinnumber_1","title":"GPIO/GPIO{PinNumber}","text":"

    Depending on device configuration (Settings --> Configuration --> section GPIO)

    "},{"location":"Neural-Network-Types/","title":"Neural Network Types","text":"

    Note

    For an overview, see Choosing the Model.

    This section is describing the different types of neural networks, that are used with the AI-on-the-edge approach and gives an introduction on how and where to use them.

    "},{"location":"Neural-Network-Types/#overview-neural-network-type","title":"Overview neural network type","text":"

    There are two types of input:

    • digits with rolling number (top town)

    • analog pointers (clockwise rotating pointer)

    There are two types of neural networks:

    • classification networks with discrete output neurons for each result class:
    • 11 classes for digits (0, 1, ... 8, 9 + \"Not-A-Number\")
    • 100 classes for digits or analog pointers (0.1, 0.2, 0.3, ... , 9.7, 9.8, 9.9)
    • continuous output networks with a continuous output in the interval [0, 10[

    No setting of the type in the firmware is necessary. The type can detect by the output structure automatically.

    Warning

    • It is very important to choose the right network type (digits or analog pointers). Technically a wrong network will work and create output, but that would be totally arbitrary
    • Not all type of pointers are trained in all networks.
    • For the 11 classes digits network there many different types of digits trained. The reason is, that you 1) only need 20-30 training images and 2) the data collection is ongoing much longer
    • For the continuous and 100 classes network especially for the digits, there are only a few types of digits trained up to now
    • Therefore sometimes for the digits it is more effective to choose the simpler 11 classes network type (= default).
    "},{"location":"Neural-Network-Types/#naming-convention","title":"Naming convention","text":"Classification11 classes0, 1, ... 9 + \"N\" Classification100 classes0.0, 0.1, ... 9.9 ContinuousInterval[0, 10[ Digits dig-class11_XXX.tflite dig-class100_XXX.tflite dig-cont_XXX.tflite Analog Pointers ana-class100_XXX.tflite ana-cont_XXX.tflite

    XXX contains the versioning and a parameter for different sizes with the following naming:

    XXX = versioning_sY

    • versioning = version or in newer networks the training data

    • Y = Neural network size (typically s1, s2, ..., s4). Whereas s1 is the maximum sized neural network and s4 is the smallest.

    Optional the naming ends with an \"_q\" to signal, that the tflite file has been quantized (size reduction with minimum accuracy loss).

    Example: dig-class11_1410_s2_q.tflite

    • Classification network for digits with 11 classes (0, 1, 2, 3, 4, 5, 6, 7, 8, 9, N)
    • Version 1410 = 14.1.0
    • s2 = Size 2 (Medium)
    • q = Quantized Version
    "},{"location":"Neural-Network-Types/#overview-of-trained-types-and-details","title":"Overview of trained types and details","text":""},{"location":"Neural-Network-Types/#analog-pointer-ana-cont_xxxtflite-ana-class100_xxxtflite","title":"Analog Pointer (\"ana-cont_XXX.tflite\" & \"ana-class100_XXX.tflite\")","text":"

    This is to transfer the direction of a pointer into a continuous number between 0 and 1, whereas 0 (=1) is the upwards position (12 o'clock), 0.25 corresponds to the 3 o'clock positions and so on. This network is a envelop for all different types of pointers. Currently there are no dedicated network trainings for specific types of pointers.

    There are two types of network structure, currently both are supported. The \"class100\" is a pure classification network, that might need a bit more accuracy in the labeling. \"cont\" is a no classic approach with a continuous output off only 2 neurons (details see below).

    "},{"location":"Neural-Network-Types/#types-of-counters-trained","title":"Types of counters trained:","text":""},{"location":"Neural-Network-Types/#training-data-needs","title":"Training data needs","text":"
    • Quadratic images, minimum size: 32x32 pixel
    • Typically 100 - 200 images with a resolution of 1/100 of the full rotation (every 0.1 value or 3.6\u00b0)
    • Naming: x.y_ARBITRARY.jpg, where x.y = value 0.0 ... 9.9
    "},{"location":"Neural-Network-Types/#cnn-technical-details","title":"CNN Technical details:","text":""},{"location":"Neural-Network-Types/#input","title":"Input","text":"
    • 32 x 32 RGB images
    "},{"location":"Neural-Network-Types/#output","title":"Output","text":"
    • ana-cont_XXX.tflite:
    • 2 neurons with output in range [-1, 1] - representing a sinus / cosine encoding of the angle

    • needs to be converted to angle with arctan-hyperbolic function

    • ana-class100_XXX.tflite

    • 100 neurons representing the classes from 0.0, 0.1, ... 9.8, 9.9
    "},{"location":"Neural-Network-Types/#digits-with-11-classes-dig-class11_xxxtflite","title":"Digits with 11 classes (\"dig-class11_XXX.tflite\")","text":"

    The digit type is a classical classification network, with 11 classes representing the numbers 0, 1, ... 9 and the special class \"N\". It is trained for the rolling ring of gas and electric meters. As there is sometime a status between two images, the special class \"N\" is representing Not-A-Number for the case, that the image cannot be unique classified to one number e.g. because it is between two digits. For this type the lowest amount of training data per type is needed, resulting in a large variety of type being already part of the training set.

    "},{"location":"Neural-Network-Types/#types-of-counters-trained_1","title":"Types of counters trained:","text":""},{"location":"Neural-Network-Types/#training-data-needs_1","title":"Training data needs","text":"
    • RGB images, with minimum size: 20x32 pixel

    • Typically 10 - 20 images (1-2 for each digit and an arbitrary number for the \"N\" class

    • Naming: x_ARBITRARY.jpg, where x = value 0 ... 9 + N

    "},{"location":"Neural-Network-Types/#cnn-technical-details_1","title":"CNN Technical details:","text":""},{"location":"Neural-Network-Types/#input_1","title":"Input","text":"
    • 20 x 32 RGB images
    "},{"location":"Neural-Network-Types/#output_1","title":"Output","text":"
    • 11 neurons for image classification (last layer normalized to 1)
    • Neuron 0 to 9 represent the corresponding numbers \"0\" to \"9\"
    • Neuron 10 represents the \"Not-A-Number\" class, telling, that the image is not uniquely classified
    "},{"location":"Neural-Network-Types/#digits-with-rolling-results-dig-class100_xxxtflite-dig-cont_xxxtflite","title":"Digits with rolling results (\"dig-class100_XXX.tflite\" & \"dig-cont_XXX.tflite\")","text":"

    This type of network tries to overcome the problem, that there are intermediate values, when a rolling digit is between two numbers. Previous this was the \"N\" class. In this network type, there are also sub-digit values trained, so that the intermediate state can be used as additional information for the algorithms.

    "},{"location":"Neural-Network-Types/#types-of-counters-trained_2","title":"Types of counters trained:","text":""},{"location":"Neural-Network-Types/#training-data-needs_2","title":"Training data needs","text":"
    • RGB images, with minimum size: 20x32 pixel

    • Typically 100 - 200 images (1-2 for each possible position)

    • Naming: x.y_ARBITRARY.jpg, where x.y = 0.0, 0.1, ... 9.9 representing the intermediate state

    "},{"location":"Neural-Network-Types/#cnn-technical-details_2","title":"CNN Technical details:","text":""},{"location":"Neural-Network-Types/#input_2","title":"Input","text":"
    • 20 x 32 RGB images
    "},{"location":"Neural-Network-Types/#output_2","title":"Output","text":"
    • dig-cont_XXX.tflite:
    • 10 neurons representing the digits 0, 1, ... 9. The intermediate values are represented by weighted normalized values of two neighboring output neurons

    • needs to be converted to angle with arctan-hyperbolic function

    • dig-class100_XXX.tflite

    • 100 neurons representing the classes from 0.0, 0.1, ... 9.8, 9.9
    "},{"location":"New-Releases-Notification/","title":"Notification about new Releases","text":"

    Do you want to get notified about a new release? There are several ways for it:

    "},{"location":"New-Releases-Notification/#github-notifications","title":"Github Notifications","text":"

    You will need a Github Account for this!

    1. Log into your Github account on Github.
    2. Go to AI-on-the-edge-device.
    3. On the top right side, click onto Watch and select Custom:
    4. Select Releases.

    You will get an email when a new release gets created.

    See also Github Documentation.

    "},{"location":"New-Releases-Notification/#codereleaseio","title":"CodeRelease.io","text":"

    Alternatively or if you do not want to create a Github account, CodeRelease.io can be an alternative.

    You also have to subscribe with an email address but no account is required.

    "},{"location":"Parameters/","title":"Parameters","text":"

    This page lists all available Configuration Parameters. If a parameter or section has a tick box on its left side, you can disable it. In such case the functionality gets disabled respectively the default values will be used.

    Note

    This is an auto-generated page! See the README for details!

    "},{"location":"Parameters/#section-takeimage","title":"Section TakeImage","text":""},{"location":"Parameters/#parameter-camaelevel","title":"Parameter CamAeLevel","text":"

    Auto-Exposure-Level

    range on OV2640 (-2 .. 2) range on OV3660 and OV5640 (-5 .. 5)

    Section: TakeImage

    Default Value: 0

    See here for the ov2640 camera datasheet. See here for the ov5640 camera datasheet.

    Warning

    This is an Expert Parameter! Only change it if you understand what it does!

    After changing this parameter you need to update your reference image and alignment markers!

    Note

    The exposure offset for automatic exposure, lower values produce darker image.

    Note

    This parameter can also be set on the Reference Image configuration page!

    "},{"location":"Parameters/#parameter-camaec","title":"Parameter CamAec","text":"

    Auto-Exposure-Control

    • When true, the camera attempts to automatically control the exposure.
    • When false, the CamAecValue setting is used instead.

    Section: TakeImage

    Default Value: true

    See here for the ov2640 camera datasheet. See here for the ov5640 camera datasheet.

    Warning

    This is an Expert Parameter! Only change it if you understand what it does!

    After changing this parameter you need to update your reference image and alignment markers!

    Note

    This parameter can also be set on the Reference Image configuration page!

    "},{"location":"Parameters/#parameter-camaec2","title":"Parameter CamAec2","text":"

    Auto-Exposure-Control2

    • When true, the sensor\u2019s \"night mode\" is enabled, extending the range of automatic gain control.
    • When false, the sensor\u2019s \"night mode\" is disabled.

    Section: TakeImage

    Default Value: true

    See here for the ov2640 camera datasheet. See here for the ov5640 camera datasheet.

    Warning

    This is an Expert Parameter! Only change it if you understand what it does!

    After changing this parameter you need to update your reference image and alignment markers!

    Note

    This may resolve some over-exposure and under-exposure issues.

    Note

    This parameter can also be set on the Reference Image configuration page!

    "},{"location":"Parameters/#parameter-camaecvalue","title":"Parameter CamAecValue","text":"

    Auto-Exposure-Value

    Range (0 .. 1200)

    Section: TakeImage

    Default Value: 160

    See here for the ov2640 camera datasheet. See here for the ov5640 camera datasheet.

    Warning

    This is an Expert Parameter! Only change it if you understand what it does!

    After changing this parameter you need to update your reference image and alignment markers!

    Note

    Access the exposure value of the camera, higher values produce brighter images.

    Note

    This parameter can also be set on the Reference Image configuration page!

    "},{"location":"Parameters/#parameter-camagc","title":"Parameter CamAgc","text":"

    Auto-Gain-Control

    • When true, the camera attempts to automatically control the sensor gain, up to the value in the CamGainceiling property.
    • When false, the CamAgcGain setting is used instead.

    Section: TakeImage

    Default Value: true

    See here for the ov2640 camera datasheet. See here for the ov5640 camera datasheet.

    Warning

    This is an Expert Parameter! Only change it if you understand what it does!

    After changing this parameter you need to update your reference image and alignment markers!

    "},{"location":"Parameters/#parameter-camagcgain","title":"Parameter CamAgcGain","text":"

    Auto-Gain-Control-Value

    Range (0 .. 30)

    Section: TakeImage

    Default Value: 15

    See here for the ov2640 camera datasheet. See here for the ov5640 camera datasheet.

    Warning

    This is an Expert Parameter! Only change it if you understand what it does!

    After changing this parameter you need to update your reference image and alignment markers!

    Note

    This is used when CamAgc is off.

    Note

    Access the gain level of the sensor, higher values produce brighter images.

    "},{"location":"Parameters/#parameter-camautosharpness","title":"Parameter CamAutoSharpness","text":"

    Auto-Sharpness

    • When true, the camera attempts to automatically adjusts the sharpness.
    • When false, the CamSharpness setting is used instead.

    Section: TakeImage

    Default Value: false

    See here for the ov2640 camera datasheet. See here for the ov5640 camera datasheet.

    Warning

    This is an Expert Parameter! Only change it if you understand what it does!

    After changing this parameter you need to update your reference image and alignment markers!

    Note

    The OV2640 does not officially support auto sharpness, this is an experimental parameter!

    Note

    This parameter can also be set on the Reference Image configuration page!

    "},{"location":"Parameters/#parameter-camawb","title":"Parameter CamAwb","text":"

    Auto-White-Balance

    • When true, the camera attempts to automatically control white balance.
    • When false, the CamWbMode setting is used instead.

    Section: TakeImage

    Default Value: true

    See here for the ov2640 camera datasheet. See here for the ov5640 camera datasheet.

    Warning

    This is an Expert Parameter! Only change it if you understand what it does!

    After changing this parameter you need to update your reference image and alignment markers!

    "},{"location":"Parameters/#parameter-camawbgain","title":"Parameter CamAwbGain","text":"

    Auto-White-Balance-Gain

    • Enable/Disable CamAwbGain control.

    Section: TakeImage

    Default Value: true

    See here for the ov2640 camera datasheet. See here for the ov5640 camera datasheet.

    Warning

    This is an Expert Parameter! Only change it if you understand what it does!

    After changing this parameter you need to update your reference image and alignment markers!

    "},{"location":"Parameters/#parameter-cambpc","title":"Parameter CamBpc","text":"

    Black-Pixel-Correction

    • Enable/Disable black point compensation, this can make black parts of the image darker.

    Section: TakeImage

    Default Value: true

    See here for the ov2640 camera datasheet. See here for the ov5640 camera datasheet.

    Warning

    This is an Expert Parameter! Only change it if you understand what it does!

    After changing this parameter you need to update your reference image and alignment markers!

    "},{"location":"Parameters/#parameter-cambrightness","title":"Parameter CamBrightness","text":"

    Image-Brightness

    Range (-2 .. 2)

    Section: TakeImage

    Default Value: 0

    See here for the ov2640 camera datasheet. See here for the ov5640 camera datasheet.

    Warning

    After changing this parameter you need to update your reference image and alignment markers!

    Note

    This parameter can also be set on the Reference Image configuration page!

    "},{"location":"Parameters/#parameter-camcolorbar","title":"Parameter CamColorbar","text":"

    Colorbar

    currently not implemented.

    Section: TakeImage

    Default Value: false

    See here for the ov2640 camera datasheet. See here for the ov5640 camera datasheet.

    Warning

    This is an Expert Parameter! Only change it if you understand what it does!

    "},{"location":"Parameters/#parameter-camcontrast","title":"Parameter CamContrast","text":"

    Image-Contrast

    Range (-2 .. 2)

    Section: TakeImage

    Default Value: 0

    See here for the ov2640 camera datasheet. See here for the ov5640 camera datasheet.

    Warning

    After changing this parameter you need to update your reference image and alignment markers!

    Note

    This parameter can also be set on the Reference Image configuration page!

    "},{"location":"Parameters/#parameter-camdcw","title":"Parameter CamDcw","text":"

    Image-Downsize

    • When CamDcw is on, the image that you receive will be the size that you requested (VGA, QQVGA, etc).
    • When CamDcw is off, the image that you receive will be one of UXGA, SVGA, or CIF.

    Section: TakeImage

    Default Value: true

    See here for the ov2640 camera datasheet. See here for the ov5640 camera datasheet.

    Warning

    This is an Expert Parameter! Only change it if you understand what it does!

    After changing this parameter you need to update your reference image and alignment markers!

    If CamZoom is used, this must be activated.

    Note

    If CamDcw is off, and you pick a different image size, this implicitly turns CamDcw back on again.

    "},{"location":"Parameters/#parameter-camdenoise","title":"Parameter CamDenoise","text":"

    Image-Denoise

    • Denoise Image, is only supported by OV3660 and OV5640

    range on OV3660 and OV5640 (0 .. 8)

    Section: TakeImage

    Default Value: 0

    See here for the ov2640 camera datasheet. See here for the ov5640 camera datasheet.

    Warning

    This is an Expert Parameter! Only change it if you understand what it does!

    "},{"location":"Parameters/#parameter-camgainceiling","title":"Parameter CamGainceiling","text":"

    Gain-Ceiling

    Available options:

    • x2
    • x4
    • x8
    • x16
    • x32
    • x64
    • x128

    Default Value for ov2640: x4 Default Value for ov5640: x8

    See here for the ov2640 camera datasheet. See here for the ov5640 camera datasheet.

    Warning

    This is an Expert Parameter! Only change it if you understand what it does!

    After changing this parameter you need to update your reference image and alignment markers!

    Note

    A higher gain means that the sensor has a greater response to light, but also makes sensor noise more visible.

    This is used when CamAgc is on.

    Note

    The Gain is an analog multiplier applied to the raw sensor data. The Ceiling is the maximum gain value that the sensor will use.

    "},{"location":"Parameters/#parameter-camhmirror","title":"Parameter CamHmirror","text":"

    Mirror-Image

    • When true, the camera image is mirrored left-to-right.

    Section: TakeImage

    Default Value: false

    See here for the ov2640 camera datasheet. See here for the ov5640 camera datasheet.

    Warning

    After changing this parameter you need to update your reference image and alignment markers!

    Note

    This parameter can also be set on the Reference Image configuration page!

    "},{"location":"Parameters/#parameter-camlenc","title":"Parameter CamLenc","text":"

    Lens-Correction

    • Enable/Disable lens correction.

    Section: TakeImage

    Default Value: true

    See here for the ov2640 camera datasheet. See here for the ov5640 camera datasheet.

    Warning

    This is an Expert Parameter! Only change it if you understand what it does!

    After changing this parameter you need to update your reference image and alignment markers!

    Note

    This can help compensate for light fall-off at the edge of the sensor area.

    "},{"location":"Parameters/#parameter-camquality","title":"Parameter CamQuality","text":"

    Image-Quality

    Range (8 .. 63)

    Section: TakeImage

    Default Value: 10

    See here for the ov2640 camera datasheet. See here for the ov5640 camera datasheet.

    Warning

    This is an Expert Parameter! Only change it if you understand what it does!

    After changing this parameter you need to update your reference image and alignment markers!

    Value below 10 could result in system instabilities!

    Note

    Quality index for pictures: 8 (highest quality) ... 63 (lowest quality)

    This is similar to the quality setting when exporting a jpeg image from photo editing software.

    "},{"location":"Parameters/#parameter-camrawgma","title":"Parameter CamRawGma","text":"

    Raw-Gamma

    • Enable/Disable raw gamma mode.

    Section: TakeImage

    Default Value: true

    See here for the ov2640 camera datasheet. See here for the ov5640 camera datasheet.

    Warning

    This is an Expert Parameter! Only change it if you understand what it does!

    After changing this parameter you need to update your reference image and alignment markers!

    Note

    The main purpose of the Gamma (GMA) function is to compensate for the non-linear characteristics of the sensor. GMA converts the pixel values according to the Gamma curve to compensate the sensor output under different light strengths. The non-linear gamma curve is approximately constructed with different linear functions. Raw gamma compensates the image in the RAW domain.

    "},{"location":"Parameters/#parameter-camsaturation","title":"Parameter CamSaturation","text":"

    Image-Saturation

    Range (-2 .. 2)

    Section: TakeImage

    Default Value: 0

    See here for the ov2640 camera datasheet. See here for the ov5640 camera datasheet.

    Warning

    After changing this parameter you need to update your reference image and alignment markers!

    Note

    Positive values increase saturation (more vibrant colors), negative values lower it (more muted colors).

    Note

    This parameter can also be set on the Reference Image configuration page!

    "},{"location":"Parameters/#parameter-camsharpness","title":"Parameter CamSharpness","text":"

    Image-Sharpness

    Range (-2 .. 2)

    Section: TakeImage

    Default Value: 0

    See here for the ov2640 camera datasheet. See here for the ov5640 camera datasheet.

    Warning

    This is an Expert Parameter! Only change it if you understand what it does!

    After changing this parameter you need to update your reference image and alignment markers!

    Note

    The OV2640 does not officially support sharpness, this is an experimental parameter!

    Note

    Positive values increase sharpness (more defined edges), negative values lower it (softer edges).

    This is used when CamAutoSharpness is off.

    Note

    This parameter can also be set on the Reference Image configuration page!

    "},{"location":"Parameters/#parameter-camspecialeffect","title":"Parameter CamSpecialEffect","text":"

    Image-Special-Effect

    Available options:

    • no_effect
    • negative
    • grayscale
    • red
    • green
    • blue
    • retro

    Section: TakeImage

    Default Value: no_effect

    See here for the ov2640 camera datasheet. See here for the ov5640 camera datasheet.

    Warning

    This is an Expert Parameter! Only change it if you understand what it does!

    After changing this parameter you need to update your reference image and alignment markers!

    Note

    This parameter can also be set on the Reference Image configuration page!

    "},{"location":"Parameters/#parameter-camvflip","title":"Parameter CamVflip","text":"

    Flip-Image

    • When true, the camera image is flipped top-to-bottom.

    Section: TakeImage

    Default Value: false

    See here for the ov2640 camera datasheet. See here for the ov5640 camera datasheet.

    Warning

    After changing this parameter you need to update your reference image and alignment markers!

    Note

    On some OV5640 Cameras, the image becomes reddish when Vflip is used in conjunction with the zoom function!

    Note

    This parameter can also be set on the Reference Image configuration page!

    "},{"location":"Parameters/#parameter-camwbmode","title":"Parameter CamWbMode","text":"

    White-Balance-Mode

    Available options:

    • auto
    • sunny
    • cloudy
    • office
    • home

    Section: TakeImage

    Default Value: auto

    See here for the ov2640 camera datasheet. See here for the ov5640 camera datasheet.

    Warning

    After changing this parameter you need to update your reference image and alignment markers!

    Note

    This is used when CamAwb is off.

    Note

    This parameter can also be set on the Reference Image configuration page!

    "},{"location":"Parameters/#parameter-camwpc","title":"Parameter CamWpc","text":"

    White-Pixel-Correction

    • Enable/Disable white point compensation, his can make white parts of the image whiter.

    Section: TakeImage

    Default Value: true

    See here for the ov2640 camera datasheet. See here for the ov5640 camera datasheet.

    Warning

    After changing this parameter you need to update your reference image and alignment markers!

    Note

    This parameter can also be set on the Reference Image configuration page!

    "},{"location":"Parameters/#parameter-camzoom","title":"Parameter CamZoom","text":"

    Digital-Zoom

    • Enable/Disable digital zoom.

    Section: TakeImage

    Default Value: false

    See here for the ov2640 camera datasheet. See here for the ov5640 camera datasheet.

    Warning

    This is an Expert Parameter! Only change it if you understand what it does!

    After changing this parameter you need to update your reference image and alignment markers!

    Note

    It is always zoomed into the center of the image, if CamZoomOffsetX and CamZoomOffsetY are zero.

    Note

    This parameter can also be set on the Reference Image configuration page!

    "},{"location":"Parameters/#parameter-camzoomoffsetx","title":"Parameter CamZoomOffsetX","text":"

    Digital-Zoom-OffsetX

    range on OV2640 (-480 .. 480) range on OV3660 (-704 .. 704) range on OV5640 (-960 .. 960)

    Section: TakeImage

    Default Value: 0

    See here for the ov2640 camera datasheet. See here for the ov5640 camera datasheet.

    Warning

    This is an Expert Parameter! Only change it if you understand what it does!

    After changing this parameter you need to update your reference image and alignment markers!

    Note

    X displacement of the image from the center. Positive values \u200b\u200bshift the image to the right, negative values \u200b\u200bto the left. The maximum possible offset depends on the value of the CamZoomSize.

    Note

    This parameter can also be set on the Reference Image configuration page!

    "},{"location":"Parameters/#parameter-camzoomoffsety","title":"Parameter CamZoomOffsetY","text":"

    Digital-Zoom-OffsetY

    range on OV2640 (-360 .. 360) range on OV3660 (-528 .. 528) range on OV5640 (-720 .. 720)

    Section: TakeImage

    Default Value: 0

    See here for the ov2640 camera datasheet. See here for the ov5640 camera datasheet.

    Warning

    This is an Expert Parameter! Only change it if you understand what it does!

    After changing this parameter you need to update your reference image and alignment markers!

    Note

    Y displacement of the image from the center. Positive values \u200b\u200bmove the image up, negative values \u200b\u200bmove the image down. The maximum possible offset depends on the value of the CamZoomSize.

    Note

    This parameter can also be set on the Reference Image configuration page!

    "},{"location":"Parameters/#parameter-camzoomsize","title":"Parameter CamZoomSize","text":"

    Digital-Zoom-Size

    range on OV2640 (0 .. 29) range on OV3660 (0 .. 43) range on OV5640 (0 .. 59)

    Section: TakeImage

    Default Value: 0

    See here for the ov2640 camera datasheet. See here for the ov5640 camera datasheet.

    Warning

    This is an Expert Parameter! Only change it if you understand what it does!

    After changing this parameter you need to update your reference image and alignment markers!

    Note

    Zoom factor/level of the digital zoom, the larger the value, the more it zooms in.

    Note

    This parameter can also be set on the Reference Image configuration page!

    "},{"location":"Parameters/#parameter-demo","title":"Parameter Demo","text":"

    Enable to use demo images instead of the real camera images. Make sure to have a /demo folder on your SD-Card and make sure it contains the expected files! Check here for details.

    Section: TakeImage

    Default Value: false

    Warning

    This is an Expert Parameter! Only change it if you understand what it does!

    "},{"location":"Parameters/#parameter-ledintensity","title":"Parameter LEDIntensity","text":"

    Set the Flash LED Intensity: (0 .. 100)

    Section: TakeImage

    Default Value: 50

    Note

    After changing this parameter you need to update your reference image and alignment markers!

    Note

    This parameter can also be set on the Reference Image configuration page!

    "},{"location":"Parameters/#parameter-rawimageslocation","title":"Parameter RawImagesLocation","text":"

    Location on the SD-Card to store the raw images.

    Section: TakeImage

    Default Value: /log/source

    Warning

    A SD-Card has limited write cycles. Since the device does not do Wear Leveling, this can wear out your SD-Card!

    "},{"location":"Parameters/#parameter-rawimagesretention","title":"Parameter RawImagesRetention","text":"

    Number of days to keep the raw images (0 = forever)

    Unit: Days

    Section: TakeImage

    Default Value: 15

    "},{"location":"Parameters/#parameter-waitbeforetakingpicture","title":"Parameter WaitBeforeTakingPicture","text":"

    Waiting time between switching the flash light (onboard LED) on and taking the picture.

    Unit: seconds

    Section: TakeImage

    Default Value: 5

    Warning

    This is an Expert Parameter! Only change it if you understand what it does!

    "},{"location":"Parameters/#section-alignment","title":"Section Alignment","text":""},{"location":"Parameters/#parameter-alignmentalgo","title":"Parameter AlignmentAlgo","text":"

    Section: Alignment

    Default Value: Default

    Warning

    This is an Expert Parameter! Only change it if you understand what it does!

    Algorithm used for the alignment step.

    Available options:

    • Default: Use only red color channel
    • HighAccuracy: Use all 3 color channels (3x slower)
    • Fast: First time use HighAccuracy, then only check if the image is shifted
    • Off: Disable alignment algorithm

    "},{"location":"Parameters/#parameter-initialrotate","title":"Parameter InitialRotate","text":"

    Section: Alignment

    Default Value: 0

    Unit: Degrees

    Note

    This parameter can also be set on the Reference Image configuration page!

    Note

    After changing this parameter you need to update your reference image and alignment markers!

    Initial rotation of image before alignment in degree (-360 .. +360)

    "},{"location":"Parameters/#parameter-searchfieldx","title":"Parameter SearchFieldX","text":"

    Section: Alignment

    Default Value: 20

    Unit: Pixels

    Warning

    This is an Expert Parameter! Only change it if you understand what it does!

    X-size (width) in which the reference is searched.

    Note

    Since the alignment is one of the steps using a lot of computation time, the search field should be as small as possible. The calculation time goes quadratic with the search field size.

    "},{"location":"Parameters/#parameter-searchfieldy","title":"Parameter SearchFieldY","text":"

    Section: Alignment

    Default Value: 20

    Unit: Pixels

    Warning

    This is an Expert Parameter! Only change it if you understand what it does!

    Y-size (height) in which the reference is searched.

    Note

    Since the alignment is one of the steps using a lot of computation time, the search field should be as small as possible. The calculation time goes quadratic with the search field size.

    "},{"location":"Parameters/#section-digits","title":"Section Digits","text":""},{"location":"Parameters/#parameter-cnngoodthreshold","title":"Parameter CNNGoodThreshold","text":"

    Section: Digits

    Default Value: 0.5

    Warning

    This is an Expert Parameter! Only change it if you understand what it does!

    Threshold above which the classification should be to accept the value (only meaningful for digits).

    Warning

    This is only supported for the dig-class100 models!

    "},{"location":"Parameters/#parameter-model","title":"Parameter Model","text":"

    Section: Digits

    Default Value: /config/dig-cont_*.tflite (See /config/config.ini)

    Path to CNN model file for image recognition. See here for details.

    "},{"location":"Parameters/#parameter-roiimageslocation","title":"Parameter ROIImagesLocation","text":"

    Section: Digits

    Default Value: /log/digit

    Location to store separated digit images on the SD-Card.

    Warning

    A SD-Card has limited write cycles. Since the device does not do Wear Leveling, this can wear out your SD-Card!

    "},{"location":"Parameters/#parameter-roiimagesretention","title":"Parameter ROIImagesRetention","text":"

    Section: Digits

    Default Value: 3

    Unit: Days

    Days to keep the separated digit images (0 = forever).

    "},{"location":"Parameters/#section-analog","title":"Section Analog","text":""},{"location":"Parameters/#parameter-cnngoodthreshold_1","title":"Parameter CNNGoodThreshold","text":"

    Section: Analog

    Default Value: 0.5

    Warning

    This is an Expert Parameter! Only change it if you understand what it does!

    Threshold above which the classification should be to accept the value (only meaningful for digits).

    Warning

    This is only supported for the ana-class100 models!

    "},{"location":"Parameters/#parameter-extendedresolution","title":"Parameter ExtendedResolution","text":"

    Warning

    This parameter is unused! Use NUMBER.ExtendedResolution instead!

    "},{"location":"Parameters/#parameter-model_1","title":"Parameter Model","text":"

    Section: Analog

    Default Value: /config/ana-cont_*.tflite (See /config/config.ini)

    Path to CNN model file for image recognition. See here for details.

    "},{"location":"Parameters/#parameter-roiimageslocation_1","title":"Parameter ROIImagesLocation","text":"

    Section: Analog

    Default Value: /log/analog

    Location to store separated analog images on the SD-Card.

    Warning

    A SD-Card has limited write cycles. Since the device does not do Wear Leveling, this can wear out your SD-Card!

    "},{"location":"Parameters/#parameter-roiimagesretention_1","title":"Parameter ROIImagesRetention","text":"

    Section: Analog

    Default Value: 3

    Unit: Days

    Days to keep the separated analog images (0 = forever).

    "},{"location":"Parameters/#section-postprocessing","title":"Section PostProcessing","text":""},{"location":"Parameters/#parameter-allownegativerates","title":"Parameter AllowNegativeRates","text":"

    Warning

    This parameter is unused! Use NUMBER.AllowNegativeRates instead!

    "},{"location":"Parameters/#parameter-errormessage","title":"Parameter ErrorMessage","text":"

    Section: PostProcessing

    Default Value: true

    Warning

    This is an Expert Parameter! Only change it if you understand what it does!

    Do not show error message in return value. In an error case, the last valid number will be used for the various transmission protocols (MQTT, InfluxDB, REST, ...).

    "},{"location":"Parameters/#parameter-allownegativerates_1","title":"Parameter AllowNegativeRates","text":"

    Section: PostProcessing

    Default Value: false

    Allow a meter to count backwards (decreasing values).

    Note

    This is unusual (it means there is a negative rate) and not wanted in most cases!

    Note

    This parameter must be prefixed with <NUMBER> followed by a dot (eg. main.AllowNegativeRates). <NUMBER> is the name of the number sequence defined in the ROI's.

    "},{"location":"Parameters/#parameter-analogtodigittransitionstart","title":"Parameter AnalogToDigitTransitionStart","text":"

    Section: PostProcessing

    Default Value: 9.2

    This can be used if you have wrong values, but the recognition of the individual ROIs are correct. Look for the start of changing of the first digit and note the analog pointer value behind. Set it here. Only used on combination of digits and analog pointers. See here for details.

    Range: 6.0 .. 9.9.

    Note

    This parameter must be prefixed with <NUMBER> followed by a dot (eg. main.AnalogToDigitTransitionStart). <NUMBER> is the name of the number sequence defined in the ROI's.

    "},{"location":"Parameters/#parameter-changeratethreshold","title":"Parameter ChangeRateThreshold","text":"

    Section: PostProcessing

    Default Value: 2

    Range: 0 .. 9.

    Threshold parameter for change rate detection. This parameter is intended to compensate for small reading fluctuations that occur when the meter does not change its value for a long time (e.g. at night) or slightly turns backwards. This can eg. happen on watermeters.

    It is only applied to the last digit of the read value (See example below). If the read value is within PreValue +/- Threshold, no further calculation is carried out and the Value/Prevalue remains at the old value.

    Note

    This parameter must be prefixed with <NUMBER> followed by a dot (eg. main.ChangeRateThreshold). <NUMBER> is the name of the number sequence defined in the ROI's.

    "},{"location":"Parameters/#example","title":"Example","text":"
    • Smallest ROI provides value for 0.000'x (Eg. a water meter with 4 pointers behind the decimal point)
    • ChangeRateThreshold = 2
    "},{"location":"Parameters/#with-extended-resolution-disabled","title":"With Extended Resolution disabled","text":"

    PreValue: 123.456'7 -> Threshold = +/-0.000'2. All changes between 123.456'5 and 123.456'9 get ignored

    "},{"location":"Parameters/#with-extended-resolution-enabled","title":"With Extended Resolution enabled","text":"

    PreValue: 123.456'78 -> Threshold = +/-0.000'02. All changes between 123.456'76 and 123.456'80 get ignored.

    "},{"location":"Parameters/#parameter-checkdigitincreaseconsistency","title":"Parameter CheckDigitIncreaseConsistency","text":"

    Section: PostProcessing

    Default Value: false

    Warning

    This is an Expert Parameter! Only change it if you understand what it does!

    An additional consistency check. It especially improves the zero crossing check between digits.

    Note

    This parameter must be prefixed with <NUMBER> followed by a dot (eg. main.CheckDigitIncreaseConsistency). <NUMBER> is the name of the number sequence defined in the ROI's.

    "},{"location":"Parameters/#parameter-decimalshift","title":"Parameter DecimalShift","text":"

    Section: PostProcessing

    Default Value: 0

    Shift the decimal separator (positiv or negativ). Eg. to move from m\u00b3 to liter (1 m\u00b3 equals 1000 liters), you need to set it to +3.

    Note

    This parameter must be prefixed with <NUMBER> followed by a dot (eg. main.DecimalShift). <NUMBER> is the name of the number sequence defined in the ROI's.

    "},{"location":"Parameters/#parameter-extendedresolution_1","title":"Parameter ExtendedResolution","text":"

    Section: PostProcessing

    Default Value: false

    Use the decimal place of the last analog counter for increased accuracy.

    Note

    This parameter is only supported on the *-class* and *-const models! See Choosing-the-Model for details.

    Note

    This parameter must be prefixed with <NUMBER> followed by a dot (eg. main.ExtendedResolution). <NUMBER> is the name of the number sequence defined in the ROI's.

    "},{"location":"Parameters/#parameter-ignoreleadingnan","title":"Parameter IgnoreLeadingNaN","text":"

    Section: PostProcessing

    Default Value: true

    Leading N's will be deleted before further processing. This is only relevant for models which use N! See here for details.

    Note

    This parameter must be prefixed with <NUMBER> followed by a dot (eg. main.IgnoreLeadingNaN). <NUMBER> is the name of the number sequence defined in the ROI's.

    "},{"location":"Parameters/#parameter-maxratetype","title":"Parameter MaxRateType","text":"

    Section: PostProcessing

    Default Value: AbsoluteChange

    Defines if the Change Rate is calculated as the difference between the last two readings (AbsoluteChange = difference) or as the difference normalized to the interval (RateChange = difference per minute).

    Note

    This parameter must be prefixed with <NUMBER> followed by a dot (eg. main.MaxRateType). <NUMBER> is the name of the number sequence defined in the ROI's.

    "},{"location":"Parameters/#parameter-maxratevalue","title":"Parameter MaxRateValue","text":"

    Section: PostProcessing

    Default Value: 0,05

    Maximum allowed change between two readings, if exceeded the last reading will be rejected. Depending on the settings of <NUMBER>.MaxRateType the MaxRateValue is either treated as the difference between the two measurements (AbsoluteChange = difference) not taking the set time interval into account or as the difference normalized to the interval (RateChange = difference per minute).

    If negative rate is disallowed and no maximum rate value is set, one false high reading will lead to a period of missing measurements until the measurement reaches the previous false high reading. E.g. if the counter is at 600,00 and it's read incorrectly as610,00, all measurements will be skipped until the counter reaches 610,00. Setting the MaxRateValue to 0,05 leads to a rejection of all readings with a difference > 0,05, in this case 610,00. The rejection also applies to correct readings with a difference > 0,05!

    Note

    This parameter must be prefixed with <NUMBER> followed by a dot (eg. main.MaxRateValue). <NUMBER> is the name of the number sequence defined in the ROI's.

    "},{"location":"Parameters/#parameter-prevalueagestartup","title":"Parameter PreValueAgeStartup","text":"

    Section: PostProcessing

    Default Value: 720

    Warning

    This is an Expert Parameter! Only change it if you understand what it does!

    Time in minutes, how long a previous read value is valid after reboot.

    "},{"location":"Parameters/#parameter-prevalueuse","title":"Parameter PreValueUse","text":"

    Section: PostProcessing

    Default Value: true

    Use the previous value (value from previous round) for consistency checks. This also works through a reboot of the device!

    "},{"location":"Parameters/#section-mqtt","title":"Section MQTT","text":""},{"location":"Parameters/#parameter-cacert","title":"Parameter CACert","text":"

    Section: MQTT

    Default Value: \"\"

    Example: /config/certs/RootCA.crt.

    Warning

    This is an Expert Parameter! Only change it if you understand what it does!

    Path to the CA certificate file.

    This is part of the configuration to enable TLS 1.2 for MQTT.

    The CA Certificate is used by the client to validate the broker is who it claims to be. It allows the client to authenticate the server, which is the first part of the MTLS handshake.

    Usually there is a common RootCA certificate for the MQTT broker. More information is available here.

    For more information on how to create your own certificate, see: mosquitto.org or emqx.com.

    Note

    This also means that you might have to change the protocol and port in uri to mqtts://example.com:8883!

    Only Certificates up to 4096 Bit are supported!

    "},{"location":"Parameters/#parameter-clientcert","title":"Parameter ClientCert","text":"

    Section: MQTT

    Default Value: \"\"

    Example: /config/certs/client.crt.

    Warning

    This is an Expert Parameter! Only change it if you understand what it does!

    Path to the Client Certificate file.

    This is part of the configuration to enable TLS 1.2 for MQTT.

    The Client Certificate is used by the client to prove its identity to the server, in conjunction with the Client Key. It is the second part of the MTLS handshake.

    Usually there is a one pair of Client Certificate/Key for each client that connects to the MQTT broker. More information is available here.

    For more information on how to create your own certificate, see: mosquitto.org or emqx.com.

    Note

    If set, ClientKey must be set too. This also means that you might have to change the protocol and port in uri to mqtts://example.com:8883!

    "},{"location":"Parameters/#parameter-clientid","title":"Parameter ClientID","text":"

    Section: MQTT

    Default Value: watermeter

    Client ID used to connect to the MQTT broker. If disabled, the hostname will be used.

    "},{"location":"Parameters/#parameter-clientkey","title":"Parameter ClientKey","text":"

    Section: MQTT

    Default Value: \"\"

    Example: /config/certs/client.key.

    Warning

    This is an Expert Parameter! Only change it if you understand what it does!

    Path to the Client Key file.

    This is part of the configuration to enable TLS 1.2 for MQTT.

    The Client Key is used by the client to prove its identity to the server, in conjunction with the Client Certificate. It is the second part of the MTLS handshake.

    Usually there is a one pair of Client Certificate/Key for each client that connects to the MQTT broker

    For more information on how to create your own certificate, see: mosquitto.org or emqx.com.

    Note

    If set, ClientCert must be set too. This also means that you might have to change the protocol and port in uri to mqtts://example.com:8883!

    "},{"location":"Parameters/#parameter-domoticztopicin","title":"Parameter DomoticzTopicIn","text":"

    Section: MQTT

    Default Value: domoticz/in

    Domoticz \"in\" topic as configured on the \"MQTT Client Gateway\" setup page on the Domoticz system. Used to publish counter/s value/s.

    Parameter <NUMBER>.DomoticzIDX is required (see below).

    "},{"location":"Parameters/#parameter-homeassistantdiscovery","title":"Parameter HomeassistantDiscovery","text":"

    Section: MQTT

    Default Value: true

    Enable or disable the Homeassistant Discovery. See here for details about the discovery.

    "},{"location":"Parameters/#parameter-maintopic","title":"Parameter MainTopic","text":"

    Section: MQTT

    Default Value: watermeter

    MQTT main topic, under which the counters are published.

    The single value will be published with the following key: MAINTOPIC/NUMBER/RESULT_TOPIC

    With:

    • NUMBER: The name of the value (a meter might have more than one value). The names get defined in the analog and digit ROI configuration (defaults to main).
    • RESULT_TOPIC: Automatically filled with the right name, eg. value, rate, timestamp, error, ....

    The general connection status can be found in MAINTOPIC/CONNECTION. See MQTT Result Topics for a full list of topics.

    Note

    The main topic is allowed to contain / which can be used to split it into multiple levels, eg. /basement/meters/watermeter/1/ if you have multiple water meters in your basement.

    The nodeId for the Home Assistant MQTT Service Discovery must follow the schema <discovery_prefix>/<component>/[<node_id>/]<object_id>/config. The node_id is not configurable but derived from the MainTopic by stripping any but the last topic level. A MainTopic with the value home/basement/watermeter is transformed into the node_id watermeter, resulting in the discovery topic homeassistant/sensor/watermeter/value/config for the current value.

    "},{"location":"Parameters/#parameter-metertype","title":"Parameter MeterType","text":"

    Section: MQTT

    Default Value: other

    Select the Meter Type so the sensors have the right units in Homeassistant.

    Please also make sure that the selected Meter Type matches the dimension of the value provided by the meter! Eg. if your meter provides m\u00b3, you need to also set it to m\u00b3. Alternatively you can set the parameter DecimalShift to 3 so the value is converted to liters!

    List of supported options:

    • other
    • water_m3 (uses m^3/min as rate)
    • water_l (uses l/h as rate, not officially supported by Homeassistant!)
    • water_gal (uses gal/h as rate, not officially supported by Homeassistant!)
    • water_ft3 (uses ft^3/min as rate)
    • gas_m3 (uses m^3/min as rate)
    • gas_ft3 (uses ft^3/min as rate)
    • energy_wh (uses W as rate)
    • energy_kwh (uses KW as rate)
    • energy_mwh (uses MW as rate)
    • energy_gj (uses GJ/h as rate, not officially supported by Homeassistant!)
    • temperature_c (uses +C/min as rate)
    • temperature_f (uses \u00b0F/min as rate)
    • temperature_k (uses K/min as rate)

    Note

    Not all options are supported by Homeassistant, see SensorDeviceClass.VOLUME_FLOW_RATE in https://developers.home-assistant.io/docs/core/entity/sensor/#available-device-classes!

    "},{"location":"Parameters/#parameter-domoticzidx","title":"Parameter DomoticzIDX","text":"

    Section: MQTT

    Default Value: 0

    The Idx number for the counter device. Can be obtained from the devices setup page on the Domoticz system.

    Note

    This parameter must be prefixed with <NUMBER> followed by a dot (eg. main.DomoticzIDX). <NUMBER> is the name of the number sequence defined in the ROI's.

    "},{"location":"Parameters/#parameter-retainmessages","title":"Parameter RetainMessages","text":"

    Section: MQTT

    Default Value: true

    Enable or disable the Retain Flag for all MQTT entries.

    Warning

    Disabling (set to false) this does not clear the last retained value on the MQTT broker! This must be done manually, see How to Delete Retained Messages in MQTT? and this discussion!

    "},{"location":"Parameters/#parameter-uri","title":"Parameter Uri","text":"

    Section: MQTT

    Default Value: mqtt://example.com:1883

    URI to the MQTT broker including the port. E.g. mqtt://192.168.1.1:1883.

    "},{"location":"Parameters/#parameter-validateservercert","title":"Parameter ValidateServerCert","text":"

    Section: MQTT

    Default Value: true

    Warning

    This is an Expert Parameter! Only change it if you understand what it does!

    Enable or disable the validation of the server certificate CN field.

    If enabled (true), the certificate sent by the server is validated using the configured Root CA Certificate file. The server name in uri is compared with the CN field of the server certificate. A connection is only established if they agree. It ensures the origin of the server.

    If disabled (false), the ESP32 skipped any validation of server certificate CN field. This reduces the security of TLS and makes the MQTT client susceptible to MITM attacks.

    Note

    This also means that you might have to change the protocol and port in to mqtts://example.com:8883!

    If you use public brokers, is recommended to set this parameter to \"enabled (true)\".

    "},{"location":"Parameters/#parameter-password","title":"Parameter password","text":"

    Section: MQTT

    Default Value: PASSWORD

    Password for MQTT authentication.

    "},{"location":"Parameters/#parameter-user","title":"Parameter user","text":"

    Section: MQTT

    Default Value: USERNAME

    Username for MQTT authentication.

    "},{"location":"Parameters/#section-influxdb","title":"Section InfluxDB","text":""},{"location":"Parameters/#parameter-database","title":"Parameter Database","text":"

    Section: InfluxDB

    Default Value: ''

    Name of the InfluxDB v1 Database into which to publish the values.

    Note

    See section InfluxDBv2 for InfluxDB v2 support!

    "},{"location":"Parameters/#parameter-field","title":"Parameter Field","text":"

    Section: InfluxDB

    Default Value: undefined

    Dedicated definition of the field for InfluxDB use for saving in the Influx database (e.g.: \"watermeter/value\").

    Note

    This parameter must be prefixed with <NUMBER> followed by a dot (eg. main.Field). <NUMBER> is the name of the number sequence defined in the ROI's.

    "},{"location":"Parameters/#parameter-measurement","title":"Parameter Measurement","text":"

    Section: InfluxDB

    Default Value: undefined

    Name of the InfluxDB v1 Measurement to use to publish the value.

    Note

    See section InfluxDBv2 for InfluxDB v2 support!

    "},{"location":"Parameters/#parameter-uri_1","title":"Parameter Uri","text":"

    Section: InfluxDB

    Default Value: undefined

    URI of the HTTP interface to InfluxDB v1, without trailing slash, e.g. http://192.168.1.1:8086.

    Note

    See section InfluxDBv2 for InfluxDB v2 support!

    "},{"location":"Parameters/#parameter-password_1","title":"Parameter password","text":"

    Section: InfluxDB

    Default Value: undefined

    Password for the InfluxDB v1 authentication.

    Note

    See section InfluxDBv2 for InfluxDB v2 support!

    "},{"location":"Parameters/#parameter-user_1","title":"Parameter user","text":"

    Section: InfluxDB

    Default Value: undefined

    Username for the InfluxDB v1 authentication.

    Note

    See section InfluxDBv2 for InfluxDB v2 support!

    "},{"location":"Parameters/#section-influxdbv2","title":"Section InfluxDBv2","text":""},{"location":"Parameters/#parameter-bucket","title":"Parameter Bucket","text":"

    Section: InfluxDBv2

    Default Value: ''

    Name of the InfluxDB v2 Bucket into which to publish the values.

    "},{"location":"Parameters/#parameter-database_1","title":"Parameter Database","text":"

    Warning

    This parameter is unused! Use Basket instead!

    "},{"location":"Parameters/#parameter-field_1","title":"Parameter Field","text":"

    Section: InfluxDBv2

    Default Value: undefined

    Field for InfluxDB v2 to use for saving.

    Note

    This parameter must be prefixed with <NUMBER> followed by a dot (eg. main.Field). <NUMBER> is the name of the number sequence defined in the ROI's.

    "},{"location":"Parameters/#parameter-measurement_1","title":"Parameter Measurement","text":"

    Section: InfluxDBv2

    Default Value: undefined

    Name of the InfluxDB v2 Measurement to use to publish the value.

    "},{"location":"Parameters/#parameter-org","title":"Parameter Org","text":"

    Section: InfluxDBv2

    Default Value: undefined

    Organisation (Org) for InfluxDB v2 authentication

    "},{"location":"Parameters/#parameter-token","title":"Parameter Token","text":"

    Section: InfluxDBv2

    Default Value: undefined

    Token for InfluxDB v2 authentication

    "},{"location":"Parameters/#parameter-uri_2","title":"Parameter Uri","text":"

    Section: InfluxDBv2

    Default Value: undefined

    URI of the HTTP interface to InfluxDB v2, without trailing slash, e.g. http://192.168.1.1:8086.

    "},{"location":"Parameters/#section-gpio","title":"Section GPIO","text":""},{"location":"Parameters/#parameter-io0","title":"Parameter IO0","text":"

    Section: GPIO

    Default Value: input disabled 10 false false

    Warning

    This is an Expert Parameter! Only change it if you understand what it does!

    This parameter can be used to configure the GPIO IO0 pin.

    Warning

    This pin is only usable with restrictions! It must be disabled when the camera is used. Additionally, it is used to activate Bootloader mode and must therefore be HIGH after a reset!

    Parameters:

    • GPIO 0 state: One of input, input pullup, input pulldown or output.
    • GPIO 0 use interrupt: Enable interrupt trigger
    • GPIO 0 PWM duty resolution: LEDC PWM duty resolution in bit
    • GPIO 0 enable MQTT: Enable MQTT publishing/subscribing
    • GPIO 0 enable HTTP: Enable HTTP write/read
    • GPIO 0 name: MQTT topic name (empty = GPIO0). Allowed characters: a-z, A-Z, 0-9, _, -.

    "},{"location":"Parameters/#parameter-io1","title":"Parameter IO1","text":"

    Section: GPIO

    Default Value: input disabled 10 false false

    Warning

    This is an Expert Parameter! Only change it if you understand what it does!

    This parameter can be used to configure the GPIO IO1 pin.

    Warning

    This pin is by default used for the serial communication as TX pin (USB logging)!

    Parameters:

    • GPIO 1 state: One of input, input pullup, input pulldown or output.
    • GPIO 1 use interrupt: Enable interrupt trigger
    • GPIO 1 PWM duty resolution: LEDC PWM duty resolution in bit
    • GPIO 1 enable MQTT: Enable MQTT publishing/subscribing
    • GPIO 1 enable HTTP: Enable HTTP write/read
    • GPIO 1 name: MQTT topic name (empty = GPIO1). Allowed characters: a-z, A-Z, 0-9, _, -.

    "},{"location":"Parameters/#parameter-io12","title":"Parameter IO12","text":"

    Section: GPIO

    Default Value: input-pullup disabled 10 false false

    Warning

    This is an Expert Parameter! Only change it if you understand what it does!

    This parameter can be used to configure the GPIO IO12 pin.

    Note

    This pin is usable without known restrictions!

    Parameters:

    • GPIO 12 state: One of external-flash-ws281x, input, input pullup, input pulldown or output.
    • GPIO 12 use interrupt: Enable interrupt trigger
    • GPIO 12 PWM duty resolution: LEDC PWM duty resolution in bit
    • GPIO 12 enable MQTT: Enable MQTT publishing/subscribing
    • GPIO 12 enable HTTP: Enable HTTP write/read
    • GPIO 12 name: MQTT topic name (empty = GPIO12). Allowed characters: a-z, A-Z, 0-9, _, -.

    "},{"location":"Parameters/#parameter-io13","title":"Parameter IO13","text":"

    Section: GPIO

    Default Value: input-pullup disabled 10 false false

    Warning

    This is an Expert Parameter! Only change it if you understand what it does!

    This parameter can be used to configure the GPIO IO13 pin.

    Note

    This pin is usable without known restrictions!

    Parameters:

    • GPIO 13 state: One of input, input pullup, input pulldown or output.
    • GPIO 13 use interrupt: Enable interrupt trigger
    • GPIO 13 PWM duty resolution: LEDC PWM duty resolution in bit
    • GPIO 13 enable MQTT: Enable MQTT publishing/subscribing
    • GPIO 13 enable HTTP: Enable HTTP write/read
    • GPIO 13 name: MQTT topic name (empty = GPIO13). Allowed characters: a-z, A-Z, 0-9, _, -.

    "},{"location":"Parameters/#parameter-io3","title":"Parameter IO3","text":"

    Section: GPIO

    Default Value: input disabled 10 false false

    Warning

    This is an Expert Parameter! Only change it if you understand what it does!

    This parameter can be used to configure the GPIO IO3 pin.

    Warning

    This pin is by default used for the serial communication as RX pin (USB logging)!

    Parameters:

    • GPIO 3 state: One of input, input pullup, input pulldown or output.
    • GPIO 3 use interrupt: Enable interrupt trigger
    • GPIO 3 PWM duty resolution: LEDC PWM duty resolution in bit
    • GPIO 3 enable MQTT: Enable MQTT publishing/subscribing
    • GPIO 3 enable HTTP: Enable HTTP write/read
    • GPIO 3 name: MQTT topic name (empty = GPIO3). Allowed characters: a-z, A-Z, 0-9, _, -.

    "},{"location":"Parameters/#parameter-io4","title":"Parameter IO4","text":"

    Section: GPIO

    Default Value: built-in-led disabled 10 false false

    Warning

    This is an Expert Parameter! Only change it if you understand what it does!

    This parameter can be used to configure the GPIO IO4 pin.

    Warning

    This pin is only usable with restrictions! By default, it is used for build-in flash light (onboard LED).

    Parameters:

    • GPIO 4 state: One of built-in-led, input, input pullup, input pulldown or output.
    • GPIO 4 use interrupt: Enable interrupt trigger
    • GPIO 4 PWM duty resolution: LEDC PWM duty resolution in bit
    • GPIO 4 enable MQTT: Enable MQTT publishing/subscribing
    • GPIO 4 enable HTTP: Enable HTTP write/read
    • GPIO 4 name: MQTT topic name (empty = GPIO4). Allowed characters: a-z, A-Z, 0-9, _, -.

    "},{"location":"Parameters/#parameter-ledcolor","title":"Parameter LEDColor","text":"

    Section: GPIO

    Default Value: 150 150 150

    Color of the attached LEDs to GPIO12 in Red, Green Blue from 0 (full off) .. 255 (full on) (See IO12 parameter).

    "},{"location":"Parameters/#parameter-lednumbers","title":"Parameter LEDNumbers","text":"

    Section: GPIO

    Default Value: 2

    Number of LEDs on the external LED-stripe attached to GPIO12 (See IO12 parameter).

    "},{"location":"Parameters/#parameter-ledtype","title":"Parameter LEDType","text":"

    Section: GPIO

    Default Value: WS2812 Type of the WS2812x which is connected to GPIO12 (See IO12 parameter).

    "},{"location":"Parameters/#parameter-maintopicmqtt","title":"Parameter MainTopicMQTT","text":"

    Section: GPIO

    Default Value: wasserzaehler/GPIO

    Note

    This parameter is not accessible through the Web Interface Configuration Page!

    The GPIO Interface is prepared to report it's status and status changes as a MQTT topic. With this parameter you configure the MQTT main topic, under which the status is published. As this parameter is still experimental it can only be set manually in the config.ini itself and has not been tested in detail so far.

    "},{"location":"Parameters/#section-autotimer","title":"Section AutoTimer","text":""},{"location":"Parameters/#parameter-autostart","title":"Parameter AutoStart","text":"

    Section: AutoTimer

    Default Value: true

    Warning

    This parameter is no longer available. The flow is now always enabled. If you want it to be disabled, set an interval which is high enough (eg. 1440 = 24h).

    "},{"location":"Parameters/#parameter-interval","title":"Parameter Interval","text":"

    Section: AutoTimer

    Default Value: 5

    Unit: Minutes

    Interval in which the Flow (Digitization Round) is run. It will run immediately on startup and then the next time after the given interval. If a round takes longer than this interval, the next round gets postponed until the current round completes.

    If the flow gets started by a MQTT message or the REST API call, the interval automatically gets reset.

    Note

    If you want the flow to be disabled, set an interval which is high enough (eg. 1440 = 24h).

    "},{"location":"Parameters/#section-datalogging","title":"Section DataLogging","text":""},{"location":"Parameters/#parameter-datafilesretention","title":"Parameter DataFilesRetention","text":"

    Section: DataLogging

    Default Value: 3

    Unit: Days

    Number of days to keep the data files (0 = forever).

    "},{"location":"Parameters/#parameter-datalogactive","title":"Parameter DataLogActive","text":"

    Section: DataLogging

    Default Value: true Activate data logging to the SD-Card.

    The files will be stored in /log/data/data_YYYY-MM-DD.csv. See Data Logging for details.

    Warning

    A SD-Card has limited write cycles. Since the device does not do Wear Leveling, this can wear out your SD-Card!

    "},{"location":"Parameters/#section-debug","title":"Section Debug","text":""},{"location":"Parameters/#parameter-loglevel","title":"Parameter LogLevel","text":"

    Section: Debug

    Default Value: 1 (ERROR) Define the log level for the logging to the SD-Card.

    Available options:

    • 1: ERROR
    • 2: WARNING
    • 3: INFO
    • 4: DEBUG

    As higher the level, as more log messages get written to the SD-Card.

    Warning

    DEBUG or INFO might damage the SD-Card if enabled long term due to excessive writes to the SD-Card! A SD-Card has limited write cycles. Since the device does not do Wear Leveling, this can wear out your SD-Card!

    "},{"location":"Parameters/#parameter-logfilesretention","title":"Parameter LogfilesRetention","text":"

    Section: Debug

    Default Value: 3

    Unit: Days

    Number of days to keep the log files (0 = forever).

    "},{"location":"Parameters/#section-system","title":"Section System","text":""},{"location":"Parameters/#parameter-cpufrequency","title":"Parameter CPUFrequency","text":"

    Section: System

    Default Value: 160

    Set the CPU Frequency.

    Warning

    Setting it to 240 will lead to a faster device, but it will also require a stronger power supply! Additionally, depending on the quality of your ESP32-CAM, it might run unstable!

    Possible values:

    • 160
    • 240

    "},{"location":"Parameters/#parameter-hostname","title":"Parameter Hostname","text":"

    Section: System

    Default Value: undefined

    Warning

    This is an Expert Parameter! Only change it if you understand what it does!

    Hostname for the device. It gets automatically transferred to /wlan.ini on the SD-Card at the next startup.

    "},{"location":"Parameters/#parameter-rssithreshold","title":"Parameter RSSIThreshold","text":"

    Section: System

    Default Value: 0

    Possible values: -100 .. 0 (0 = disabled).

    Warning

    This is an Expert Parameter! Only change it if you understand what it does!

    This parameter activates a client triggered AP switching functionality (simplified roaming). If actual RSSI value is lower (more negative) than RSSIThreshold, all WIFI channels will be scanned for configured access point SSID. If an access point is in range which has better RSSI value (less negative) than actual RSSI value + 5 dBm, the device is trying to connect to this access point with the better RSSI value.

    Note

    The RSSI check only gets initiated at the end of each round to avoid any disturbance of processing.

    Note

    It gets automatically transferred to /wlan.ini on the SD-Card at next startup.

    "},{"location":"Parameters/#parameter-setupmode","title":"Parameter SetupMode","text":"

    Section: System

    Default Value: true

    Note

    This parameter is not accessible through the Web Interface Configuration Page!

    Set this parameter to true to stay in the Setup Mode after the next start of the device.

    "},{"location":"Parameters/#parameter-timeserver","title":"Parameter TimeServer","text":"

    Section: System

    Default Value: pool.ntp.org

    Warning

    This is an Expert Parameter! Only change it if you understand what it does!

    Time server to synchronize system time. If it is disabled or undefined, pool.ntp.org will be used. You can also set it to the IP of your router. Many routers like Fritzboxes can act as a local NTP server. To disable NTP, you need to activate it but set the TimeServer config to be empty (\"\"). In such case the time always starts at 01.01.1970 after each power cycle!

    "},{"location":"Parameters/#parameter-timezone","title":"Parameter TimeZone","text":"

    Section: System

    Default Value: CET-1CEST,M3.5.0,M10.5.0/3

    Time zone in POSIX syntax (Europe/Berlin = CET-1CEST,M3.5.0,M10.5.0/3 - incl. daylight saving) Check the table on http://<DEVICE IP>/timezones.html to find the settings for your region.

    "},{"location":"Parameters/#section-webhook","title":"Section Webhook","text":""},{"location":"Parameters/#parameter-apikey","title":"Parameter ApiKey","text":"

    Section: Webhook

    Default Value: undefined

    ApiKey sent as Header

    "},{"location":"Parameters/#parameter-uploadimg","title":"Parameter UploadImg","text":"

    Section: Webhook

    Default Value: 0 (NEVER)

    Available options:

    • 0: NEVER
    • 1: ALWAYS
    • 2: ON_ERROR

    "},{"location":"Parameters/#parameter-uri_3","title":"Parameter Uri","text":"

    Section: Webhook

    Default Value: undefined

    URI of the HTTP Endpoint receiving requests, e.g. http://192.168.1.1/watermeter/webhook.

    "},{"location":"Password-Protection/","title":"Password Protection","text":"

    The Web Interface and the REST API can be protected by a password.

    To do so, you have to set the username and password in the wlan.ini file on the SD-Card. Uncomment (remove the leading ;) and update the two lines with http_username and http_password: 

    http_username = \"myusername\"\nhttp_password = \"mypassword\"\n

    Warning

    This is be a WEAK and INSECURE way to protect the Web Interface and the REST API. There was no audit nor a security review to check the correct implementation of the protection! The password gets transmitted unencrypted (plain text), this means it is very easy to extract it for somebody who has access to your WIFI!

    USE AT YOUR OWN RISK!

    Notes

    The file wlan.ini file on the SD-Card can not be accessed through the Web interface.

    "},{"location":"REST-API/","title":"REST API","text":"

    Various information is directly accessible over specific REST calls.

    To use it, just append them to the IP, separated with a /, e.g. http://192.168.1.1/json

    Note

    For more detailed information to the REST handler, have a look to the code in the repository: registered handlers

    "},{"location":"REST-API/#control","title":"Control","text":""},{"location":"REST-API/#flow_start","title":"flow_start","text":"

    Trigger the next flow + Payload: - No payload needed

    This will automatically reset the flow interval.

    "},{"location":"REST-API/#setprevalue","title":"setPreValue","text":"

    Set the last valid value (previous value) to given value or the actual RAW value. + Payload: - Set to given value (value >= 0), e.g. /setPreValue?numbers=main&value=1234.5678 * numbers= Provide name of number sequence, e.g. main * value= provide the value to be set

        - Set to actual RAW value (value < 0, a valid RAW value is mandatory), e.g. `/setPreValue?numbers=main&value=-1`\n       * `numbers=` Provide name of number sequence, e.g. main\n       * `value=` provide yna negative number\n
    "},{"location":"REST-API/#gpio","title":"GPIO","text":"

    • Control a GPIO output

      • The GPIO entrypoint also support parameters:
      • /GPIO?GPIO={PinNumber}&Status=high
      • /GPIO?GPIO={PinNumber}&Status=low
      • Example: /GPIO?GPIO=12&Status=high

    • Read a GPIO input

      • The GPIO entrypoint also support parameters:
      • /GPIO?GPIO={PinNumber}
      • Example: /GPIO?GPIO=12
    "},{"location":"REST-API/#reboot","title":"reboot","text":"

    Trigger a reboot of the device

    "},{"location":"REST-API/#mqtt_publish_discovery","title":"mqtt_publish_discovery","text":"

    Trigger re-sending of the Home Assistant discovery topics. The topics will get send at the end of the next round.

    "},{"location":"REST-API/#results","title":"Results","text":""},{"location":"REST-API/#json","title":"json","text":"

    Show result in JSON syntax - Example: { \"main\": { \"value\": \"521.17108\", \"raw\": \"521.17108\", \"pre\": \"521.17108\", \"error\": \"no error\", \"rate\": \"0.023780\", \"timestamp\": \"2023-01-13T16:00:42+0100\" } }

    "},{"location":"REST-API/#value","title":"value","text":"

    Show single result values - The value entrypoint also support parameters: - http://<IP>/value?all=true&type=value - http://<IP>/value?all=true&type=raw - http://<IP>/value?all=true&type=error - http://<IP>/value?all=true&type=prevalue

    "},{"location":"REST-API/#img_tmprawjpg","title":"img_tmp/raw.jpg","text":"

    Capture and show a new raw image

    "},{"location":"REST-API/#img_tmpalgjpg","title":"img_tmp/alg.jpg","text":"

    Show last aligned image

    "},{"location":"REST-API/#img_tmpalg_roijpg","title":"img_tmp/alg_roi.jpg","text":"

    Show last aligned image including ROI overlay

    "},{"location":"REST-API/#status","title":"Status","text":""},{"location":"REST-API/#statusflow","title":"statusflow","text":"

    Show the actual step of the flow incl. timestamp - Example: Take Image (15:56:34)

    "},{"location":"REST-API/#rssi","title":"rssi","text":"

    Show the WIFI signal strength (Unit: dBm) - Example: -51

    "},{"location":"REST-API/#cpu_temperature","title":"cpu_temperature","text":"

    Show the CPU temperature (Unit: \u00b0C) - Example: 38

    "},{"location":"REST-API/#sysinfo","title":"sysinfo","text":"

    Show system infos in JSON syntax - Example: [{\"firmware\": \"\",\"buildtime\": \"2023-01-25 12:41\",\"gitbranch\": \"HEAD\",\"gittag\": \"\",\"gitrevision\": \"af13c68+\",\"html\": \"Development-Branch: HEAD (Commit: af13c68+)\",\"cputemp\": \"64\",\"hostname\": \"WaterMeterTest\",\"IPv4\": \"192.168.xxx.xxx\",\"freeHeapMem\": \"2818330\"}]

    "},{"location":"REST-API/#starttime","title":"starttime","text":"

    Show starttime - Example: 20230113-154634

    "},{"location":"REST-API/#uptime","title":"uptime","text":"

    Show uptime - Example: 0d 00h 15m 50s

    "},{"location":"REST-API/#camera","title":"Camera","text":""},{"location":"REST-API/#lighton","title":"lighton","text":"

    Switch the camera flashlight on

    "},{"location":"REST-API/#lightoff","title":"lightoff","text":"

    Switch the camera flashlight off

    "},{"location":"REST-API/#capture","title":"capture","text":"

    Capture a new image (without flashlight)

    "},{"location":"REST-API/#capture_with_flashlight","title":"capture_with_flashlight","text":"

    Capture a new image with flashlight

    "},{"location":"REST-API/#stream","title":"stream","text":"

    Stream a live video of the camera.

    It has a slow refresh rate of only 2 FPS to avoid stressing the system. Flow processing continues to work in the background, albeit possibly a bit slower.

    When the flashlight parameter is set, it turns on the flaslight. Both http://<IP>/stream?flashlight=true and http://<IP>/stream?flashlight turn on the flashlight.

    LIMITATION: To avoid using extra memory, no additional dedicated stream webserver is implemented for this feature (instead, the web interface server is reused in a kind of \"blocking way\"). This means that either the web interface is fully functional or the stream is active, but not both at the same time. However, this is sufficient for the intended use case.

    "},{"location":"REST-API/#save","title":"save","text":"

    Save a new image to SD card - The save entrypoint also support parameters: - http://<IP>/save?filename=test.jpg&delay=1000

    "},{"location":"REST-API/#logs","title":"Logs","text":""},{"location":"REST-API/#log","title":"log","text":"

    Last part of todays log (last 80 kBytes))

    "},{"location":"REST-API/#logfileact","title":"logfileact","text":"

    Full log of today

    "},{"location":"REST-API/#loghtml","title":"log.html","text":"

    Opens the log html page

    "},{"location":"REST-API/#diagnostics","title":"Diagnostics","text":""},{"location":"REST-API/#heap","title":"heap","text":"

    print relevant memory (heap) information - Example: Heap info: Heap Total: 1888926 | SPI Free: 1827431 | SPI Larg Block: 1802240 | SPI Min Free: 758155 | Int Free: 61495 | Int Larg Block: 55296 | Int Min Free: 36427

    "},{"location":"REST-API/#prometheusopenmetrics","title":"Prometheus/OpenMetrics","text":""},{"location":"REST-API/#metrics","title":"metrics","text":"

    Provides a set of metrics that can be scraped by prometheus. See Prometheus/OpenMetrics for details.

    "},{"location":"REST-API/#password-protection","title":"Password Protection","text":"

    The Web Interface and the REST API can be protected by a password, see Password-Protection.

    "},{"location":"ROI-Configuration/","title":"ROIs (Regions of Interest)","text":"

    Notes

    You are using a neural network approach which is trained to fit as many different type of meters as possible. The accuracy will never be 100%. It is normal to see a missing reading once in a while. There are several precautions to detect this. For details see the section PostProcessing on the configuration page.

    The most critical components for an accurate detection are:

    1. Correct setting of the Regions Of Interest (ROIs) for detection of the image.

      This must be done manually for each device/installation!

    2. Using a well trained Model.

      Have a look on the Digit Counters resp. Analog Needles to check if your types are contained. If your number types are not contained, you should take the effort to record them so we can add them to the training data. See Collect images to improve the models on how to collect new training data.

    "},{"location":"ROI-Configuration/#precondition","title":"Precondition","text":"

    Please make sure to have:

    1. Setup your camera properly and taken a good Reference Image.
    2. Selected good Alignment References.
    "},{"location":"ROI-Configuration/#define-the-rois","title":"Define the ROIs","text":"

    For each digit or analog pointer, a ROI must be defined.

    You can even have multiple independent Numbers (eg. electerical meters mostly have 2 numbers for the high and low tariff).

    Depending if you have only one of those types, you can enable/disable (1) it on the top left corner:

    You can switch between the individual ROIs with the Drop down box (2). If you need additional ROIs or delete them you can do this with the control at (3). Like for the Alignment References, you can change the position, size and name of a ROI in the text fields or define them via drag and drop through the mouse button. Make sure the ROIs are in the right order, matching the significance of a digit/analog counter!

    Warning

    The order of the ROIs defines how the individual digits are combined to the total number. The first ROI is the digit with the highest order (left side), then the second and so on. You can control the order in the selector tab and change it with the buttons \"move Next\" or \"move Previous\".

    In most cases digits are ordered equidistantly (have the same distance between each other) and have the same size. Because of this, the Web Interface keeps their sizes and distance the same. If you need individual sizes or distances, untick the settings (4).

    In almost all cases the sizes and y values should be identical! The ratio between x and y might need adjustment. But make sure it is the same for all digits.

    Same for the analog counters, the sizes should be identical and the x and y as well.

    Note

    Don't forget to save the settings with \"Save\" and do not reboot at this stage.

    "},{"location":"ROI-Configuration/#analog-counters","title":"Analog Counters","text":"

    For analog counters the ROI setting is rather straight forward as the meter is usually quadratic with a clear center. The circle should exactly fit to the outer size of the meter and the cross should be in the middle of the pointer.

    Here is an example with the details for the ROI ana1:

    "},{"location":"ROI-Configuration/#digits","title":"Digits","text":"

    For the Digit Meters it is a little bit more complicated, as there are different options of digit models which can be choosen.

    "},{"location":"ROI-Configuration/#correct-size-for-roi","title":"Correct Size for ROI","text":"

    First of all, choose the right size of the ROI. The configuration of ROIs differs a bit on the selected model (see below).

    If you are in the initial setup, the model will be selectable in the next step. By default it is a dig-cont resp. ana-cont model.

    In Model Selection you find the differences between the different available models. Pick the one you think fits best your purpose. If you don't get to good result, try another model.

    Here we only show the different configuration of the ROIs.

    1. Digit Meters with only recognized full digits (0, 1, 2, 3, ... 9)

      Suggested Model: dig-class11-*.tfl

      Advantage: broad variety of types included in the training.

      Disadvantage: partially rotated numbers cannot be detected.

    2. Digit Meters with sub-digit resolution (0.0, 0.1, 0.2, .... 9.8, 9.9)

      Suggested Model: dig-cont-*.tfl or dig-class100-*.tfl

      Advantage: partial numbers can be detected and a better post processing is possible.

      Disadvantage: only limited types of meter types are trained due to the high effort for the training data.

    "},{"location":"ROI-Configuration/#how-to-setup-the-digit-rois-perfectly","title":"How to setup the digit ROIs perfectly","text":"

    Details and the corresponding \"perfect\" setting is explained below. For a first run you can choose the following general settings:

    • There is an inner and an outer frame for the ROIs.
    • Make the inner frame exactly the size of the number.
    Example 1 Example 2 \u2714\ufe0f Okay \u274c Not Okay \u274c Not Okay"},{"location":"ROI-Configuration/#setup-using-dig-class11-models","title":"Setup using dig-class11 models","text":"

    dig-class11 - Models recognize the complete digit only. Here it is not relevant if the ROI fits the Border of the digit window.

    For this model, there should be a border of 20% of the image size around the number itself. This border is shown in the ROI setup image by the inner thinner rectangle. This rectangle should fit perfectly around the number when the number has not started to rotate to the next position:

    Example 1 Example 2 \u2714\ufe0f Okay \u274c Not Okay \u274c Not Okay

    If you have perfect alignment and still are not getting satisfying results, most probably your numbers are not part of the training data yet. See Collect images to improve the models on how to collect new training data.

    "},{"location":"ROI-Configuration/#setup-using-dig-class100-or-dig-cont-models","title":"Setup using dig-class100 or dig-cont Models","text":"

    These models recognize the tenths (fractions) between the numbers. Those models require a different ROI setup; the height must be set differently and more accurately.

    First, the width can be set like for a dig-class11 model, i.e. 20% margin left and right.

    The height of the outer rectangle should be set to the upper and lower edge of the number window. To achieve this, you might need to unlock the aspect ratio:

    Here an example:

    Example 1 \u2714\ufe0f Okay \u274c Not Okay"},{"location":"ROI-Configuration/#saving","title":"Saving","text":"

    Once you are done, push Save to persist your setup.

    A reboot is required to apply the changed configuration!

    "},{"location":"Reference-Image/","title":"Reference Image","text":"

    Note

    The Reference Image is the basis for the coordinate system of the ROIs. Therefore it is very important, to have a well aligned image, that is not rotated.

    At first an example image is shown. To define a new reference image push the button \"Create new Reference\" (2) and afterwards \"Take Image\" (2). It might take some seconds for processing, then your actual camera image should be shown. Then play with the provided parameters to get a good result.

    "},{"location":"Reference-Image/#focus","title":"Focus","text":"

    This is the first time, where you have access to the camera image. It most likely is out of focus and not sharp! Ensure a sharp image of the camera by adjusting the focal length of the ESP OV2640 camera.

    Note

    Try to adjust the focus for the clearest possible image!

    In order to use it for reading a meter, the focal-length of the OV2640 camera has to be manipulated. By default it only results in sharp image for distance bigger than around ~40cm which is not ideal for our purpose.

    Therefore you need to remove the fixing glue of the OV2640 lens with a sharp knife. After this you can rotate the lens in and out. Rotating it by about a quarter of a turn counterclockwise results in a focus plane shift of about 10cm. You need to figure out your best setting with a little bit of trial and error for your specific environment.

    Error

    Be very carefully when rotating the lens. Best is to held the camera itself with one hand or a plier and rotate the lens with the other hand. Make sure not to rotate the whole camera as this can damage the ribbon cable!

    Warning

    This modification will void any warranty, as the sealing of the lens objective is broken!

    Warning

    This modification will render the camera unsuitable for general, web-cam type applications unless the focal length is changed back to the original setting.

    "},{"location":"Reference-Image/#correct-horizontal-alignment","title":"Correct Horizontal Alignment","text":"

    Ensure an exact horizontal alignment of the number:

    \u2714\ufe0f Okay \u274c Not Okay

    Warning

    Updating the reference image also means that all alignment images and ROIs needs to be configured again. Therefore do this step later only with caution.

    If everything is done, you can save the result with \"Update Reference Image\" (4).

    Note

    A reboot is not required at this point of time.

    As next you should update the Alignment References.

    "},{"location":"Reference-Image/#dealing-with-reflections","title":"Dealing with Reflections","text":"

    Reflections can be caused by the flash LED and make it hard to provide a reliable detection. There are various ways to deal with them:

    • Attach a diffusor in front of the LED, eg. a filt (Filz) or parchment paper. Also white paper can do the job.
    • Rotate the ESP-CAM so the LED is on another place.
    • Reduce the LED intensity.
    • Use external LED stripes, eg WS2812x.
    "},{"location":"Release-creation/","title":"Release Procedure","text":"

    Follow these steps to create a release:

    1. Document all relevant changes in the Changelog in the main branch. To get a list of commits, you can call git log --oneline or check commits/main/. Summarize the relevant changes since the last release.
    2. Wait for the GitHub action to run successfully.
    3. Test it to see if everything worsk as expected.
    4. Update the contributors list in the README.md by triggering the Manually update contributors list action.

    5. Go to releases/new to create a new release. Fill in a new tag and select \"Create new tag: xxx on publish\". A tag should have the format x.y.z. It is suggested to first select \"Set as a pre-release\" at the bottom.

    6. Wait for the GitHub-Action of release creation. After all is done:

      • the release should be created
      • the artifacts are downloadable from release
      • The documented changes were applied to the release
    7. In case of a full release (not a pre-release), check that the Web Installer shows the right version. If needed, run he action manually: github.com/jomjol/AI-on-the-edge-device/actions/workflows/manual-update-webinstaller.yml.
    "},{"location":"StatusLED-BlinkCodes/","title":"Board status LED (blink codes)","text":"

    This page lists possible blink codes of the red LED located on the ESP32-CAM board, their meaning and possible solutions.

    The error code source definition can be found here.

    "},{"location":"StatusLED-BlinkCodes/#general-design-approach","title":"General design approach:","text":"
    • 250ms blink code to identify source
    • 500ms defined LED off
    • 250ms blink code to identify error / status code
    • 1,5s defined LED off to signal repetition
    • Repetition blink code: infinite for critical errors and status indication or 2x for warning indication
    • e.g. 3x blinks | 500ms LED off | 2x blinks --> error: SD card not found
    source source blink count error / warning / status status blink count repeat infinite WLAN_CONN 1 Disconnected (No Access Point) 1 WLAN_CONN 1 Disconnected (Authentication failure) 2 WLAN_CONN 1 Disconnected (Timeout) 3 WLAN_CONN 1 Disconnected (further reasons) 4 WLAN_INIT 2 wlan.ini empty or not readable 1 X WLAN_INIT 2 SSID or password empty 2 X WLAN_INIT 2 WIFI init error (details console) 3 X SDCARD_INIT 3 SD card filesystem mount failed 1 X SDCARD_INIT 3 SD card not found (0x107) 2 X SDCARD_INIT 3 SD card init failed (details console) 3 X SDCARD_CHECK 4 Basic check: file creation/write error 1 X SDCARD_CHECK 4 Basic check: file read/CRC error 2 X SDCARD_CHECK 4 Basic check: file delete error 3 X SDCARD_CHECK 4 Basic check: folder/file presence 4 X CAM_INIT 5 Camera init failed (details console) 1 X CAM_INIT 5 Camera framebuffer check failed 2 PSRAM_INIT 6 RAM init failed: Not found/defective 1 X PSRAM_INIT 6 External SPI RAM < 4MB 2 X PSRAM_INIT 6 Total heap < 4MB 3 X TIME_CHECK 7 Missing time sync (check every round) 1 OTA_OR_AP 8 OTA process ongoing 1 X OTA_OR_AP 8 Soft AP started (for remote config) 2 X FLASHLIGHT N/A LED on when flashlight is on solid, no blink"},{"location":"StatusLED-BlinkCodes/#error-warning","title":"ERROR / WARNING","text":""},{"location":"StatusLED-BlinkCodes/#source-wlan_conn-wlan-disconnected","title":"Source WLAN_CONN: WLAN disconnected","text":"

    Note

    Only warning indication, blink code repetition: 2x --> General info: WLAN disconnect reason code description

    "},{"location":"StatusLED-BlinkCodes/#wlan-disconnected-no-access-point","title":"WLAN disconnected (No Access Point)","text":"

    WLAN connection is interrupted due to no access point in range.

    "},{"location":"StatusLED-BlinkCodes/#wlan-disconnected-authentication-failure","title":"WLAN Disconnected (Authentication failure)","text":"

    WLAN connection is interrupted due to an authentication failure. If error repeats check WLAN config in wlan.ini (username, password)

    "},{"location":"StatusLED-BlinkCodes/#wlan-disconnected-timeout","title":"WLAN Disconnected (Timeout)","text":"

    WLAN connection is interrupted due to an timeout because no beacon from AP is received in a timely manner. Most probably access point is not available anymore or connection is not reliable.

    "},{"location":"StatusLED-BlinkCodes/#wlan-disconnected-further-reasons","title":"WLAN Disconnected (Further reasons)","text":"

    WLAN connection is interrupted due to further reasons. Disconnect reason is printed in warining message. Please check serial console output or logfile from sd card (using another device to retrieve logfile /sdcard/log/message/). Please refer to this page to have additional infos in terms of WLAN disconnect reasons --> WLAN disconnect reason code description

    "},{"location":"StatusLED-BlinkCodes/#source-wlan_init-wlan-initialization","title":"Source WLAN_INIT: WLAN initialization","text":"

    Note

    All critical errors, regular boot not possible

    "},{"location":"StatusLED-BlinkCodes/#wlanini-empty-or-not-readable","title":"wlan.ini empty or not readable","text":"

    The wlan.ini file is present but content is either not readable or no content present. Please check for further errors in terms of SD card readability or content of wlan.ini which is located in /sdcard (most top folder od SD card)

    "},{"location":"StatusLED-BlinkCodes/#ssid-or-password-empty","title":"SSID or password empty","text":"

    The mandatory parameters SSID (name of WIFI network) and / or password is empty. Please configure those parameters in wlan.ini and try again.

    "},{"location":"StatusLED-BlinkCodes/#wifi-init-error-details-console","title":"WIFI init error (details console)","text":"

    A general WIFI initialization error occured. Please check serial console output or logfile from sd card (using another device to retrieve logfile /sdcard/log/message/)

    "},{"location":"StatusLED-BlinkCodes/#source-sdcard_init-sd-card-initialization","title":"Source SDCARD_INIT: SD card initialization","text":"

    Note

    All critical errors, regular boot not possible

    "},{"location":"StatusLED-BlinkCodes/#sd-card-filesystem-mount-failed","title":"SD card filesystem mount failed","text":"

    Failed to mount FAT filesystem on SD card. Check SD card filesystem (only FAT supported) or try another card. Possible further infos: Please check serial console output.

    "},{"location":"StatusLED-BlinkCodes/#sd-card-not-found-error-code-0x107","title":"SD card not found (Error code 0x107)","text":"

    SD card init failed. Check if SD card is properly inserted into SD card slot or try another card. Possible further infos: Please check serial console output.

    "},{"location":"StatusLED-BlinkCodes/#sd-card-init-failed-details-console","title":"SD card init failed (details console)","text":"

    A general SD card initialization error occured. Please check serial console output.

    "},{"location":"StatusLED-BlinkCodes/#source-sdcard_check-sd-card-basic-check","title":"Source SDCARD_CHECK: SD card basic check","text":"

    Note

    All critical errors, normal boot not possible. Reduced WebUI is going to be loaded for further diagnostic possibilities or redo firmware update.

    "},{"location":"StatusLED-BlinkCodes/#file-creation-write-error","title":"File creation / write error","text":"

    A basic check of SD card is performed at boot. Failed to create the test file or writing content to the file failed. Most likely SD card is defective or not supported. Please check logs with log viewer in reduced web interface, serial console output or try another card.

    Recommendation: Format or try another card

    "},{"location":"StatusLED-BlinkCodes/#file-read-crc-verfication-error","title":"File read / CRC verfication error","text":"

    A basic check of SD card is performed at boot. Failed to read the test file or CRC of read back content failed. Most likely SD card is defective. Please check logs with log viewer in reduced web interface or serial console output for further error indication or try another card.

    Recommendation: Format or try another card

    "},{"location":"StatusLED-BlinkCodes/#file-delete-error","title":"File delete error","text":"

    A basic check of SD card is performed at boot. Failed to delelte the test file. Most likely SD card is defective. Please check logs with log viewer in reduced web interface or serial console output for further error indication or try another card.

    Recommendation: Format or try another card

    "},{"location":"StatusLED-BlinkCodes/#folder-file-presence-failed","title":"Folder / File presence failed","text":"

    A basic check of SD card is performed at boot. One or more menadatory folder / file are not found on SD card. Please check logs with log viewer in reduced web interface or serial console output for further error indication.

    Recommendation: Repeat installation using AI-on-the-edge-device__update__*.zip

    "},{"location":"StatusLED-BlinkCodes/#source-cam_init-camera-initialization","title":"Source CAM_INIT: Camera initialization","text":""},{"location":"StatusLED-BlinkCodes/#camera-init-failed-details-console","title":"Camera init failed (details console)","text":"

    Note

    Critical error, normal boot not possible. Reduced WebUI is going to be loaded for further diagnostic possibilities or redo firmware update.

    A general camera initialization error occured. Please check logs with log viewer in reduced web interface or serial console output for further error indication.

    Recommendation: Check for proper electrical connection, whether camera model is supported and whether power supply is sufficient.

    "},{"location":"StatusLED-BlinkCodes/#camera-framebuffer-check-failed","title":"Camera framebuffer check failed","text":"

    The framebuffer of the camera was not readable. The firmware will trying to continue regular boot, but further errors can occur which block regular processing. Please check logs with logfile viewer if processing is behaving irregular.

    Recommendation: Check for proper electrical commenection, wether camera model is supported and wether power supply is suffcient.

    "},{"location":"StatusLED-BlinkCodes/#source-psram_init-external-ram-spi-ram-initialization","title":"Source PSRAM_INIT: External RAM (SPI RAM) initialization","text":"

    Note

    A critical errors, normal boot not possible. Reduced WebUI is going to be loaded for further diagnostic possibilities or redo firmware update.

    "},{"location":"StatusLED-BlinkCodes/#spi-ram-init-failed-not-founddefective","title":"SPI RAM init failed: Not found/defective","text":"

    External RAM (SPI RAM) initialization failed. Most likely external RAM not accessable or defective. Normal operation is not possible without having external RAM.

    "},{"location":"StatusLED-BlinkCodes/#external-spi-ram-4mb","title":"External SPI RAM < 4MB","text":"

    External RAM (SPI RAM) initialization successful, but external RAM size is too small. A size of >= 4MB is necessary to run this firmware.

    "},{"location":"StatusLED-BlinkCodes/#total-heap-4mb","title":"Total heap < 4MB","text":"

    Total available system memory (heap) is too small. A size of >= 4MB is necessary to run this firmware.

    "},{"location":"StatusLED-BlinkCodes/#source-time_check-external-ram-spi-ram-initialization","title":"Source TIME_CHECK: External RAM (SPI RAM) initialization","text":""},{"location":"StatusLED-BlinkCodes/#missing-time-sync-check-every-round","title":"Missing time sync (check every round)","text":"

    Note

    Only warning indication, blink code repetition: 2x

    If system is configured to be synced with a NTP server the sync status is checked after every round (in state: \"Flow finished\". An warming message is also printed to log). If the time is not synced after serveral rounds, please check for proper configuration.

    "},{"location":"StatusLED-BlinkCodes/#status","title":"STATUS","text":"

    Note

    All only status indication

    "},{"location":"StatusLED-BlinkCodes/#source-ota_or_ap-ota-update-access-point-mode","title":"Source OTA_OR_AP: OTA Update / Access point mode","text":""},{"location":"StatusLED-BlinkCodes/#ota-process-ongoing","title":"OTA process ongoing","text":"

    An OTA is performed right now. Please wait until OTA is completed. System is rebooting automatically. If system is not coming up, please check serial console output.

    "},{"location":"StatusLED-BlinkCodes/#soft-ap-started-for-remote-config","title":"Soft AP started (for remote config)","text":"

    The built-in access point functionality is started to perform initial remote remote setup. Further description: Installtion --> Section Remote Setup using the built-in Access Point

    "},{"location":"StatusLED-BlinkCodes/#source-flashlight-flashlight","title":"Source FLASHLIGHT: Flashlight","text":""},{"location":"StatusLED-BlinkCodes/#led-on-when-flashlight-is-on","title":"LED on when flashlight is on","text":"

    The LED is solid on as long the flashlight is on. This feature has lower priority than the other LED codes. Whenever another code occurs this feature will be overrided.

    "},{"location":"Testing/","title":"Testing Option for VSCode","text":"

    You can test your functions directly on the device.

    "},{"location":"Testing/#structure","title":"Structure","text":"

    All tests are under directory \"test\" in the project and not compiled with default build option of platformio. The main function is in file test_suite_controlflow.cpp. In method app_main() you can add your own tests.

    "},{"location":"Testing/#include-my-own-test","title":"Include my own test","text":"

    In method app_main() of test_suite_controlflow.cpp you can add your own tests. Include your test-file in the top like

    #include \"components/jomjol-flowcontroll/test_flow_postrocess_helper.cpp\"

    components is a subfolder of tests here. Not the components directory of root source.

    In the bottom add your test function.

    RUN_TEST(testNegative);

    Your test function should have a TEST_ASSERT_EQUAL_*. For more information look at unity-testing.

    "},{"location":"Testing/#run-tests","title":"Run tests","text":"

    You will need a testing device. best with usb adapter. Before you upload your tests you will need to setup the device with initial setup procedure described in [[Installation]]

    Now you can use Visual Studio Code or a standard console to upload the test code. In VS Code (tab platformio) open Advanced and select Test.

    Alternatively you can run it in console/terminal with platformio test --environment esp32cam.

    In my environment the serial terminal not opens. I have to do it for myself. You will see much logging. If any test fails it logs it out. Else it logs all test passed in the end.

    "},{"location":"Testing/#troubleshooting","title":"Troubleshooting","text":"

    If you test very much cases in one function, the device runs in Stack Overflow and an endless boot. Reduce the count of test cases or split the test function in multiple functions.

    "},{"location":"Upload-files-by-script/","title":"Scripted File Upload","text":"

    To upload a file e.g. using curl, you first have to delete it and then upload it: 

    curl -d '' http://192.168.1.153/delete/html/index.html\ncurl --data-binary @ota_page.html http://192.168.1.153/upload/html/index.html\n

    "},{"location":"WLAN-disconnect-reason/","title":"WLAN disconnect reasons","text":"

    In the logfile the WLAN disconnect reason code are printed whenever a disconnect event occurs (WARNING LEVEL or higher).

    Further information and additional description of reason codes can be found here: WLAN disconnect reason code description

    "},{"location":"Watermeter-specific-analog---digit-transition/","title":"Analog/Digit Transition on Water Meters","text":"

    At first, for the most water meters the default configuration should be work. But the digit, especially the last digit differs in some devices.

    "},{"location":"Watermeter-specific-analog---digit-transition/#normal-transition","title":"\"Normal\" transition","text":"

    In most cases, the transition of the last digit starts when the analogue pointer is > 9.

    Often the last digit \"hangs\" a bit on this devices and comes not over zero. So it is not easy to see which digit is correct. In the first example 4 or still 3? (3 is correct).

    "},{"location":"Watermeter-specific-analog---digit-transition/#early-transition","title":"Early transition","text":"

    Some units start the transition very early or run with the analogue pointer. In the third example, is it a 3 or a 2?

    "},{"location":"Watermeter-specific-analog---digit-transition/#inaccuracies-in-image-recognition","title":"Inaccuracies in image recognition","text":"

    The models for image recognition are good, but have inaccuracies in the range +/- 0.2. In order to obtain as many correct results as possible, a treatment is carried out in the post process in the range of 9.8-0.2 for the analogue pointer, which must start differently depending on the type of counter.

    "},{"location":"Watermeter-specific-analog---digit-transition/#how-to-configure-for-my-meter-type","title":"How to configure for my meter type","text":"

    If you have a devices with \"normal\" transition you should not have any issues. On devices with \"early\" transition, you can set the option AnalogToDigitTransitionStart to a value between 6 and 8. See the parameter documentation for details.

    "},{"location":"Webhook/","title":"Webhook","text":""},{"location":"Webhook/#purpose","title":"Purpose","text":"

    The idea behind this webhook feature is to provide an alternative to MQTT and InfluxDB for transmitting data, such as water meter readings from a vacation home, to a standard PHP webspace.

    You can call the webhook to upload the data or the raw image of a round to a server.

    "},{"location":"Webhook/#configuration","title":"Configuration","text":"

    To configure the webhook feature, you only need to define a URI and an API key. The URI is where the webhook will send the data, and the API key is used to authenticate the requests, ensuring that only authorized devices can send data to your server. Optionally, \"Upload Image\" can be used to configure whether an additional PUT request should be sent to the same URI with the current image. A parameter timestamp is appended to establish a correlation.

    "},{"location":"Webhook/#example-of-a-post-request","title":"Example of a POST Request","text":"

    Below is an example of the JSON payload that might be sent in a POST request to the webhook:

    "},{"location":"Webhook/#request-headers","title":"Request Headers","text":"
    APIKEY: your-api-key-here\n
    "},{"location":"Webhook/#json-payload","title":"JSON Payload","text":"
    [\n  {\n    \"timestamp\": \"2024-08-09T11:44:44+0200\",\n    \"timestampLong\": 1723196684,\n    \"name\": \"main\",\n    \"rawValue\": \"0345.42647\",\n    \"value\": \"345.42648\",\n    \"preValue\": \"345.42648\",\n    \"rate\": \"0.000000\",\n    \"changeAbsolute\": \"0.00000\",\n    \"error\": \"no error\"\n  },\n  {\n    \"timestamp\": \"2024-08-09T11:44:44+0200\",\n    \"timestampLong\": 1723196684,\n    \"name\": \"test\",\n    \"rawValue\": \"34\",\n    \"value\": \"34\",\n    \"preValue\": \"34\",\n    \"rate\": \"0.000000\",\n    \"changeAbsolute\": \"0\",\n    \"error\": \"no error\"\n  }\n]\n
    "},{"location":"Webhook/#basic-example-of-a-server-using-php","title":"Basic Example of a server using PHP","text":"
    <?php\n$expectedApiKey = 'your-api-key-here';\n\n$receivedApiKey = isset($_SERVER['HTTP_APIKEY']) ? $_SERVER['HTTP_APIKEY'] : '';\n\nif ($receivedApiKey !== $expectedApiKey) {\n    http_response_code(403); // 403 Forbidden\n    echo json_encode(['status' => 'error', 'message' => 'Invalid API key']);\n    exit;\n}\n\n$method = $_SERVER['REQUEST_METHOD'];\n\nif ($method === 'POST') {\n    // Handle POST request: Write data to CSV\n    $csvFile = 'webhook_log.csv';\n\n    $jsonData = file_get_contents('php://input');\n\n    $dataArray = json_decode($jsonData, true);\n    if (!$jsonData || !is_array($dataArray)) {\n        http_response_code(400); // 400 Bad Request\n        echo json_encode(['status' => 'error', 'message' => 'Invalid JSON data']);\n        exit;\n    }\n\n    $csvHandle = fopen($csvFile, 'a');\n    if ($csvHandle === false) {\n        http_response_code(500); // 500 Internal Server Error\n        echo json_encode(['status' => 'error', 'message' => 'Unable to open CSV file']);\n        exit;\n    }\n\n    foreach ($dataArray as $data) {\n        $csvRow = [\n            $data['timestampLong'], \n            $data['name'], \n            $data['rawValue'], \n            $data['value'], \n            $data['preValue'], \n            $data['rate'], \n            $data['changeAbsolute'], \n            $data['error']\n        ];\n        fputcsv($csvHandle, $csvRow);\n    }\n\n    fclose($csvHandle);\n\n    http_response_code(200); // 200 OK\n    echo json_encode(['status' => 'success', 'message' => 'Data written to CSV file']);\n} elseif ($method === 'PUT') {\n    // Handle PUT request: Save image\n    $timestamp = $_GET['timestamp'];\n\n    if (!ctype_digit($timestamp) || $timestamp < 0 || $timestamp > PHP_INT_MAX) {\n        http_response_code(400); // 400 Bad Request\n        echo json_encode(['status' => 'error', 'message' => 'Invalid timestamp']);\n        exit;\n    }\n\n    $imageFilePath = 'uploaded_image_' . $timestamp . '.jpg';\n\n    $imageData = file_get_contents('php://input');\n\n    if (!$imageData) {\n        http_response_code(400); // 400 Bad Request\n        echo json_encode(['status' => 'error', 'message' => 'No image data received']);\n        exit;\n    }\n\n    if (file_put_contents($imageFilePath, $imageData) === false) {\n        http_response_code(500); // 500 Internal Server Error\n        echo json_encode(['status' => 'error', 'message' => 'Unable to save the image']);\n        exit;\n    }\n\n    http_response_code(200); // 200 OK\n    echo json_encode(['status' => 'success', 'message' => 'Image uploaded successfully']);\n} else {\n    // Handle unsupported HTTP methods\n    http_response_code(405); // 405 Method Not Allowed\n    echo json_encode(['status' => 'error', 'message' => 'Method not allowed']);\n}\n?>\n
    "},{"location":"Webhook/#basic-example-of-a-server-using-python","title":"Basic Example of a server using Python","text":"
    from flask import Flask, request, jsonify\nimport csv\nimport os\n\napp = Flask(__name__)\n\n# List of allowed API keys\nALLOWED_API_KEYS = {\n    '123',\n    '456',\n    '789'\n}\n\n@app.before_request\ndef check_api_key():\n    # Get the API key from the request headers\n    received_api_key = request.headers.get('APIKEY')\n\n    # Check if the received API key is in the allowed list\n    if received_api_key not in ALLOWED_API_KEYS:\n        return jsonify({'status': 'error', 'message': 'Invalid API key'}), 403\n\n    # Attach the API key to the request object for later use\n    request.api_key = received_api_key\n\n@app.route('/webhook', methods=['POST', 'PUT'])\ndef webhook():\n    # Create a directory for the API key if it doesn't exist\n    api_key_dir = os.path.join('data', request.api_key)\n    os.makedirs(api_key_dir, exist_ok=True)\n\n    if request.method == 'POST':\n        # Handle POST request: Write data to CSV\n        data = request.get_json()\n        if not data or not isinstance(data, list):\n            return jsonify({'status': 'error', 'message': 'Invalid JSON data'}), 400\n\n        csv_file = os.path.join(api_key_dir, 'webhook_log.csv')\n        try:\n            with open(csv_file, 'a', newline='') as csvfile:\n                csv_writer = csv.writer(csvfile)\n                for item in data:\n                    csv_writer.writerow([\n                        item.get('timestampLong'),\n                        item.get('name'),\n                        item.get('rawValue'),\n                        item.get('value'),\n                        item.get('preValue'),\n                        item.get('rate'),\n                        item.get('changeAbsolute'),\n                        item.get('error')\n                    ])\n            return jsonify({'status': 'success', 'message': 'Data written to CSV file'}), 200\n        except Exception as e:\n            return jsonify({'status': 'error', 'message': 'Unable to open CSV file'}), 500\n\n    elif request.method == 'PUT':\n        # Handle PUT request: Save image\n        timestamp = request.args.get('timestamp')\n        if not timestamp or not timestamp.isdigit() or int(timestamp) < 0:\n            return jsonify({'status': 'error', 'message': 'Invalid timestamp'}), 400\n\n        image_data = request.data\n        if not image_data:\n            return jsonify({'status': 'error', 'message': 'No image data received'}), 400\n\n        image_file_path = os.path.join(api_key_dir, f'{timestamp}.jpg')\n        try:\n            with open(image_file_path, 'wb') as image_file:\n                image_file.write(image_data)\n            return jsonify({'status': 'success', 'message': 'Image uploaded successfully'}), 200\n        except Exception as e:\n            return jsonify({'status': 'error', 'message': 'Unable to save the image'}), 500\n\n    else:\n        # Handle unsupported HTTP methods\n        return jsonify({'status': 'error', 'message': 'Method not allowed'}), 405\n\nif __name__ == '__main__':\n    app.run(host='0.0.0.0', port=5001)\n
    "},{"location":"collect-new-images/","title":"Collect images to improve the models","text":"

    If your device has new, different digits or pointers it might be that the existing models don't recognize them well. In such case you can collect your images and so we can train the model better. This helps you and also others as the models get more accurate. Adding more images also helps if you have a model that is already known, but the neural models do not produce good results.

    Experienced users can do the training also by themselves, see Learn a model with your own images.

    "},{"location":"collect-new-images/#before-you-start","title":"Before you start","text":"

    Before you go ahead, please check if your digits/pointers are not yet contained in the training data. A visual overview is available at digits resp. pointers.

    Poor recognition is often caused by blurred images, low contrast or incorrect setting of the ROIs. Therefore, check these possibilities first, as additional training will bring little improvement here. See ROI Configuration for details.

    "},{"location":"collect-new-images/#collecting-images","title":"Collecting images","text":"

    The neural network is trained based on a set of images that have already been collected over time. If your digits are included or at least very similar to included images, the chance is very high that the neural network is working fine for you as well.

    The neural network configuration is stored in the TensorFlow Lite format as *.tfl or *.tflite in the /config directory on the SD card. A model can be updated (or a new one added) by uploading the new file and activating it on the configuration page or in the config file /config/config.ini.

    In order to incorporate new digits a training set of images is required. The training images needs to be collected in the final setup with the help of the Digits or Analog log settings (not to be confused with the Data or Debug log). Enable the logging of the images on the configuration page or in the config file /config/config.ini:

    Now be patient! You have to wait until it has collected an image of each digit of every type. They will be placed on the SD card in the folder /log/digit/ resp. /log/analog/.

    After some days, there will be a lot of images, many of them very similar. Because of this, it is important to select only a subset of them for the model training.

    The tools shown below can help you with that.

    "},{"location":"collect-new-images/#collecting-images-for-dig-class100dig-contana-class100","title":"Collecting images for dig-class100/dig-cont/ana-class100","text":"

    For digits use Collectmeterdigits resp. for pointers use collectmeteranalog to fetch the images from the device and select a subset of them. Please read the detailed instructions on the mentioned links for details!

    If the fetching of the images is too slow for you, a faster way to get the images to your PC is to remove the SD-card from the ESP32 module and insert it into the card reader of yur PC. Then search for two..three images of each digit (not more! :-)). You will have to make sure to label the images yourself matching the effective value they are supposed to show.

    "},{"location":"collect-new-images/#share-your-images","title":"Share your images","text":"

    In most cases we will integrate your images in the training dataset of the models. Only if we fear a degradation of the models or you need a different behavior, we might not include the data in the standard models (see at bottom of page for reasons).

    To provide your images to us for training the model, open an Github Issue and append the zipped images ito it.

    "},{"location":"collect-new-images/#images-can-be-rejected-if","title":"Images can be rejected if","text":"
    • You provide too many images. More than 1000 images of your device are really to much.
    • Images which are not good enough (see ROI Configuration) will be rejected. It would reduce the accuracy of the networks.
    • Images with too little focus will be rejected.
    • Images with too much blur are rejected.

    Our models are to small to recognize everything in any quality. So we use only images of medium or good quality.

    "},{"location":"data-logging/","title":"Data Logging","text":"

    When Data Logging is enabled (See parameter DataLogActive), the results of every round gets written to the SD-Card.

    The data files are stored in /log/data on the SD-Card.

    "},{"location":"data-logging/#data-format","title":"Data Format","text":"

    The data is stored as CSV with the following columns: time, name-of-number, raw-value, return-value, pre-value, change-rate, change-absolute, error-text, cnn-digit, cnn-analog

    "},{"location":"initial-setup/","title":"Initial Setup","text":"

    After setting up the device (firmware, SD card, WLAN) the device will connect to the wifi access point and start in an initial setup configuration:

    With the buttons on the top you can navigate through 5 steps which guide you through the necessary setup:

    1. Create the Reference Image. It is the base for the position referencing and the identification of the digits and counters.
    2. Define two unique Reference Marks. They is used to align the individual camera images and identify the absolute positions.
    3. Define ROIs for the Digits. They will be used to digitize the digit part of your meter. If your meter has no digits, this step can be skipped.
    4. Define ROIs for the Analog Counters. (Only required in case your meter has analog counters)
    5. General Settings. Further configuration of your device.

    All settings can be accessed later in the normal operation mode.

    Note

    Don't forget to save each step with \"Save\", and do not reboot at this stage.

    "},{"location":"initial-setup/#finish-the-setup-and-change-to-the-normal-operation-mode","title":"Finish the Setup and change to the Normal Operation mode","text":"

    With the last step (1) you leave the Setup Mode and reboot to the Normal Operation mode.

    "},{"location":"initial-setup/#access-to-the-setup-pages-in-the-normal-operation-mode","title":"Access to the Setup Pages in the Normal Operation mode","text":"

    You always can access all the settings during the normal operation mode via the Settings menu:

    • (1) Access to the General Settings.
    • (2) Update of the Reference Image.
    • (3) Update of the Alignment Marks.
    • (4)/(5) Update of the ROIs.
    "},{"location":"ota/","title":"Over-The-Air (OTA) Update","text":"

    You can do an OTA (over-the-air) update via the Web Interface. Grab the firmware from the

    • Releases page (Stable, tested versions), or the
    • Automatically build development branch (experimental, untested versions). Please inform yourself on Living on the Edge first!
    "},{"location":"ota/#update-procedure","title":"Update Procedure","text":"
    1. Create a backup of your configuration. Either use the Backup/Restore function of your device for this (menu System > Backup/Restore) or back the files manually up using the File Server (menu File Server, folder config). It is recommended to at least save the config file config.ini!
    2. Head to the menu System > OTA Update and follow the instructions there.

    If you do an update between major versions, it might be needed to modify the config file config.ini as it's syntax or context has changed. To do so, go to the menu Settings > Configuration (after the update completed and the device restarted) and check if it warns you about an unset parameter.

    "},{"location":"ota/#update-from-version-v1200-or-newer","title":"Update from version v12.0.0 or newer","text":"

    You can use the over the air update mechanism, which uploads the update via a ZIP files.

    The update file is located on the release page. Please choose the zip file with the following naming: AI-on-the-edge-device__update__*.zip

    Go to the menu System --> OTA Update and follow the instructions there. After a final automatic reboot you should have the new version running.

    "},{"location":"ota/#update-from-version-older-than-v1200","title":"Update from version older than v12.0.0","text":"

    If you update from an version older than 12.0.1, you should firstly update to version 12.0.1. Background are not fully backward compatible changes in the config.ini, that are taken care of in this version.

    Warning

    Make sure to read the instructions below carefully!

    1. Backup your configuration (use the System -> Backup/Restore page)!

    2. Upload and update the update-*.zip file from the release 12.0.1 see here .

    3. Let it restart and check on the System -> Info page that the Firmware as well as the Web UI got updated. If only one got updated, redo the update. If it fails several times, you also can update the Firmware and the Web UI separately.

    4. Safe way:

      1. Update first the firmware.bin (extract it from one of the provided zip files) and do the Reboot
      2. Update with the full zip file (update-*.zip, ignore the version warning after the reboot)

    5. Please go to Settings -> Configuration and address the changed parameters:

      • DataLogging (storing the values for data graph)
      • Debug (extended by different debug reporting levels)

    6. Make sure it starts to do the digitization (check the Error field on the overview page). If it does not start a round within a minute, restart the device.

    Note

    If the system is working now without any issues, please open the configuration editor once and save the config.ini. This will update the file to the newest content.

    Now you can safely update to the newest version.

    "},{"location":"outdated--Integrated-Functions/","title":"Integrated Functions","text":"

    Warning

    This page no longer is maintained!

    "},{"location":"outdated--Integrated-Functions/#wasserzaehler","title":"wasserzaehler","text":"

    http://IP-ESP32/wasserzaehler.html

    This is the main purpose of this device. It returns the converted image as a number with different option. The output can be modified either by the configuration parameters or by HTML parameters.

    Details can be found here: tbd

    "},{"location":"outdated--Integrated-Functions/#picture-server","title":"Picture Server","text":"

    http://IP-ESP32/capture

    http://IP-ESP32/capture_with_flashlight

    This is a implementation of the camera interface of https://github.com/jomjol/water-meter-picture-provider

    It is fully compatible including the parameters (quality=..., size=... ) . This allows to use this ESP32 system in parallel to the corresponding docker system: https://github.com/jomjol/water-meter-system-complete, from which this project is basically the successor.

    "},{"location":"outdated--Integrated-Functions/#file-server","title":"File server","text":"

    Access: http://IP-ESP32/fileserver/

    Simple file server, that allows viewing, upload, download and deleting of single files of the SD-card content.

    The usage is self explaining. The file path or file can directly be accessed by the URL after file server.

    Example for config.ini : http://IP-ESP/fileserver/config/config.ini

    "},{"location":"outdated--Integrated-Functions/#ota-update","title":"OTA-Update","text":"

    http://IP-ESP32/ota?file=firmware.bin

    Here an over the air update can be triggered. The firmware file is expected to be located in the sub directory /firmware/ and can be uploaded with the file server. By the parameter file the name of the firmware file needs to be given.

    "},{"location":"outdated--Integrated-Functions/#reboot","title":"Reboot","text":"

    http://IP-ESP32/reboot

    A reboot with a delay of 5 seconds is initiated, e.g. after firmware update.

    ATTENTION: currently this is not working properly - hardware power off is needed instead. Work in progress!

    "},{"location":"outdated--Integrated-Functions/#simple-web-server","title":"Simple Web Server","text":"

    If none of the above URLs are fitting, a very simple web server checks, if there is a fitting file from the sub directory /html This can be used for a very simple web server for information or simple web pages.

    "},{"location":"prometheus-openmetrics/","title":"Prometheus/OpenMetrics","text":"

    A set of metrics is exported via the /metrics REST API path on the device. Besides the current value, a set of device properties are exported. Multiple sequences (aka numbers) are supported via a label. The metrics are provided in text wire format.

    Example:

    $ curl http://<IP>/metrics\n# HELP ai_on_the_edge_device_flow_value current value of meter readout\n# TYPE ai_on_the_edge_device_flow_value gauge\nai_on_the_edge_device_flow_value{sequence=\"main\"} 240.7064\n# HELP ai_on_the_edge_device_cpu_temperature_celsius current cpu temperature in celsius\n# TYPE ai_on_the_edge_device_cpu_temperature_celsius gauge\nai_on_the_edge_device_cpu_temperature_celsius 41\n# HELP ai_on_the_edge_device_rssi_dbm current WiFi signal strength in dBm\n# TYPE ai_on_the_edge_device_rssi_dbm gauge\nai_on_the_edge_device_rssi_dbm -67\n# HELP ai_on_the_edge_device_memory_heap_free_bytes available heap memory\n# TYPE ai_on_the_edge_device_memory_heap_free_bytes gauge\nai_on_the_edge_device_memory_heap_free_bytes 716303\n# HELP ai_on_the_edge_device_uptime_seconds device uptime in seconds\n# TYPE ai_on_the_edge_device_uptime_seconds gauge\nai_on_the_edge_device_uptime_seconds 214267\n# HELP ai_on_the_edge_device_rounds_total data aquisition rounds since device startup\n# TYPE ai_on_the_edge_device_rounds_total counter\nai_on_the_edge_device_rounds_total 239\n
    "},{"location":"prometheus-openmetrics/#prometheus-scrape-config","title":"Prometheus Scrape Config","text":"

    The following scrape config (add to prometheus.yml) can be used as an example to ingest available metrics with prometheus:

    scrape_configs:\n  - job_name: watermeter\n    scrape_interval: 300s\n    metrics_path: /metrics\n    static_configs:\n      - targets: ['<IP>']\n
    "},{"location":"prometheus-openmetrics/#references","title":"References","text":"
    • OpenMetrics
    "},{"location":"unstable-installation/","title":"Living on the Edge","text":"
    • The main branch contains the latest version of the Firmware and the Web Interface. It might already contain a fix for your issue. But it is work in progress, don't expect it to work stable or be an improvement for your AI-on-the-edge-device! Also it might break the OTA Update and thus require manual flashing over USB! For normal users it is better tu use a release.
    • Any other branch is used to develop a feature or fix, only use them when you know what it is about!
    "},{"location":"unstable-installation/#i-still-want-to-try-it","title":"I still want to try it","text":"

    Ok, then grab the latest main build from Github Actions Page and proceed as following:

    1. Pick the most top successful (green) build:
    2. Scroll down and download the AI-on-the-edge-device__update__*.zip:
    3. Flash the zip file using the OTA Update page of your device.
    "}]} \ No newline at end of file
    G8)RFMkP$(y{^B^DEpl8P8e1Eh}+@dl*>ga!d8n>dWbL zAIJD|NWi`z0PiEm-9ez;^r9zb7*w>_2uhhuruUT=C;5iM-vL0oD2 z-j&Wf%?>tDeV9Pdm(1@<2u@<#vw^i3U*e8IQFZdZ8j1&>Rou+tH@?jE{C2ueZDORU0p}IZHn316RzsGgd|T5!eb0> z9Jz$T_@K$&H!Q%uYZa}=7{XcdJ)=6A9$hR$ zxenPT0bAZP4m`(5+#~WG<%Ydr6r|laDgfzjMwBgdQvx2(NgC+@*d!W6Dt}>jMX3-& z1I~BQ;VGE=o&VANDMhBL+Un~~3-?BS;@0FP&7^F!^)M<%XR^9l3S;>4ih>W#hRBZ2 zJ2jpy1RsC{r|Y5)w!{~KBh48-9+bWP0+TU%sg>jU7=n2YG^b1!#%+Yp$LcatF%@F< z4PPAe^1En#`m1eV@j;LvnNS*Ri`ken!k2(ImP+@ z9~2$Hn;{>%grVBDqr~9VQh{jQd>wfuV%(a0NGmY#Ux;MB`^C zVBpHL&_l)p6p_&rao^jG^x+(Slq0~13yae?!CHZ{)Q&&CA(EkLq0nFfpCsBe+Hs2W zoy+6Mp5ks>w%J4xGR5zrwEN-HO1KuzrYNNSvr@HQa8%LC{p{c`$Wg6 zhuy8G)0-XcyAVxZ{`4L-xleI1dY!(YUmHhMM!vDwbA4*x_$;2U<-}*^8E~Z8JQ-3PNAJG^#?<>81Gp&d1Qh3$?)^XY0c`sHxD@H7%#mH>?;ARoi zxq@uJv!6t+*)L!(@OR`aw+0CC$5p|olNXfii#i&DEvbm*sC|9Ve~?V!d)>EQYZYPrRI^lPDH#UXRIWLz6Gg-(OhDQGtGaTKzX7)IwoI@P4=| zjmRy$NQ2}T$5Zkia&cw_5#!=#Vh*Aix!!JuH63Xea(N;Td^=TAj-(>m<=5k7dWX@{ zw~}D=vuAH`V6lhY@F4Sn2U8`IV#yEbftp_3_`E~`umYD_``5Cqf#{`D z1u{XX>}{p7JZNbF>KaG9wgh-3sd2V;8u5g*aP~{dnrTLX*~4MI~+GV zMV~sBci=Q_)60tqz-43xNSK)j5*TmQJcZSdgms+_sNKZ{vtkL)6v@J0QS#dxg5`29 z7}he`7M#B`cEF2Ss!*GhQ%&IQnP~mVTOxW!SuC58H|h$hqYtLWk|&G%=1Oswp`o}6 zW@o=FoA$~o#|AeXfbSQZxUP?KCDC_egxhmNV>TVb#`Ttd_>l}3^_hqFg}OxF?RAdn zK~kSmM)CLbnK`C$tb|U9%YKE10ez;{2vZayA{sC>gcGf#XZddYZe!Al#8QeY+Zb5A z$MC(y^?vPQ)ajepX~w;;m(fzna+7UhS%Nr{_sJQCXDiEix_K6f(1a0rAZ%n*)K7@{ zPx+|IO~ON~U&4&g>1Fuo;)qg>XNsk|LY9qHUjpxozSn5AZkXW=8`|{pMOMBP&P7H5W8AiIKn;!z)E-kasfu{ zIttvQ+1$0{3Z&(K2ewX#^R@w-9ls8<9>>1_S*U-?m)89pM*OB^u`i`&n#;O79>5d= z2Yg7Gxbq(w*BQS}_?x`8W!6&v{Qba7cyIr&dCRIw(zoW63fxK)KDFrIjxheDF8VhlcFtgS-4c8-zAv^&)E1(L*e!@6izdQxMUM88NUuhXRh z{s-XWrB(*Dl6by0IkkpHFqy#{d0$e6;zBM);^m8S2%S5Va;~gQs~BQg5+_llicBHQ z%R{4n+?1*Ou@n7${ao>v1tc3u)976Q<dKh{md1|*-@2zr` z^wR(1$Kz$1yHRucnR29l$dq*gnUv93S{Gb&xgaiLaU%IU-OCZnAU^Y+%ZJ{N#a$F; zxcm=mjCeNA5qH>ky-`t8h@U)D@b!60WTHO=Oy$1N);qVk-uzlJYKU`Vys7k5Jw3$s z{gWzYNt4sGWpqhkGH}1XdF5wt_0_k;YmQ*`+)S_4vrIO}b7y>vM}GfDRt~r4Z`ZK9 z2D}vQ(z>&hlhFsK=n>-ZUR}j>cMs5<>)(BeKu=h6&F(?kF&8s^VJYLrX6c*@VdOPY zB4_M_3t5q@oqS9C`_HHG9#P)~K@1(2B%Kd`FBUF3m4DwB9#8K-3pI_uA<`0mdWdV{cGQiEsKLo-wG#YUCs%-v2%FH) zoZRYev)c39ltTM`dS_mGai9A$4;OOYQ@_Bel6q