{"id":62,"date":"2025-01-02T12:05:32","date_gmt":"2025-01-02T12:05:32","guid":{"rendered":"http:\/\/opencistern.com\/?page_id=62"},"modified":"2025-01-03T09:19:17","modified_gmt":"2025-01-03T09:19:17","slug":"get_started","status":"publish","type":"page","link":"https:\/\/opencistern.com\/en\/get_started\/","title":{"rendered":"Let\u00b4s get started"},"content":{"rendered":"\n<p>There are two ways to start with the installation of the sensor.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\"><mark style=\"background-color:rgba(0, 0, 0, 0)\" class=\"has-inline-color has-accent-3-color\">1) Use the fully compiled version<\/mark><\/h2>\n\n\n\n<p>An already compiled version can be downloaded from GitHub.<\/p>\n\n\n\n<figure class=\"wp-block-image size-medium is-resized\"><a href=\"https:\/\/github.com\/diefenbecker\/zisternenmessung\/blob\/main\/opencistern_1030.bin?raw=true\" target=\"_blank\" rel=\" noreferrer noopener\"><img loading=\"lazy\" decoding=\"async\" width=\"300\" height=\"111\" src=\"https:\/\/opencistern.com\/wp-content\/uploads\/2025\/01\/github-300x111.png\" alt=\"\" class=\"wp-image-237\" style=\"width:150px\" srcset=\"https:\/\/opencistern.com\/wp-content\/uploads\/2025\/01\/github-300x111.png 300w, https:\/\/opencistern.com\/wp-content\/uploads\/2025\/01\/github-1024x380.png 1024w, https:\/\/opencistern.com\/wp-content\/uploads\/2025\/01\/github-768x285.png 768w, https:\/\/opencistern.com\/wp-content\/uploads\/2025\/01\/github-18x7.png 18w, https:\/\/opencistern.com\/wp-content\/uploads\/2025\/01\/github-600x222.png 600w, https:\/\/opencistern.com\/wp-content\/uploads\/2025\/01\/github.png 1125w\" sizes=\"auto, (max-width: 300px) 100vw, 300px\" \/><\/a><\/figure>\n\n\n\n<p>To flash the downloaded <em>bin<\/em>-file to the microcontroller, the program \u201cESPEasy Flasher\u201d can be used in addition to various other options. This software can be found on GitHub at <a href=\"https:\/\/github.com\/BattloXX\/ESPEasyFlasher\/releases\/tag\/1.1\" target=\"_blank\" rel=\"noreferrer noopener\">https:\/\/github.com\/BattloXX\/ESPEasyFlasher\/releases\/tag\/1.1<\/a>. <\/p>\n\n\n\n<p>After downloading, simply unzip the ZIP file, copy the downloaded bin file into the same folder, connect the microcontroller to the PC and start FlashESP8266.exe. After selecting the correct COM port and firmware, start the flash process by clicking on \u201cFlash\u201d.<\/p>\n\n\n\n<figure class=\"wp-block-image size-full\"><img loading=\"lazy\" decoding=\"async\" width=\"400\" height=\"241\" src=\"http:\/\/opencistern.com\/wp-content\/uploads\/2025\/01\/espeasy_screenshot-1.png\" alt=\"\" class=\"wp-image-69\" srcset=\"https:\/\/opencistern.com\/wp-content\/uploads\/2025\/01\/espeasy_screenshot-1.png 400w, https:\/\/opencistern.com\/wp-content\/uploads\/2025\/01\/espeasy_screenshot-1-300x181.png 300w\" sizes=\"auto, (max-width: 400px) 100vw, 400px\" \/><\/figure>\n\n\n\n<p>That was all. Go ahead wtih 3)<\/p>\n\n\n\n<h2 class=\"wp-block-heading\"><br><mark style=\"background-color:rgba(0, 0, 0, 0)\" class=\"has-inline-color has-accent-3-color\">2) Compile it yourself with source code<\/mark><\/h2>\n\n\n\n<p>The source code can also be also downloaded from <a href=\"https:\/\/github.com\/diefenbecker\/opencistern\" target=\"_blank\" rel=\"noreferrer noopener\">GitHub<\/a>. This can then be compiled using <em>ArduinoIDE <\/em>or <em>Visual Code (with PlatformIO) <\/em>and loaded directly onto the microcontroller using these environments.<\/p>\n\n\n\n<p>However, you should already have experience in using these tools.<\/p>\n\n\n\n<p>I use some external libraries that have to be integrated into the development environment before compilation. <\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>ESP8266WiFi.h<\/li>\n\n\n\n<li>ESP8266mDNS.h<\/li>\n\n\n\n<li>ESP8266WebServer.h<\/li>\n\n\n\n<li>ESP8266HTTPClient.h<\/li>\n\n\n\n<li>ESP8266httpUpdate.h<\/li>\n\n\n\n<li>Ticker.h<\/li>\n\n\n\n<li>EEPROM.h<\/li>\n\n\n\n<li>Wire.h<\/li>\n<\/ul>\n\n\n\n<p>All libraries listed above are included in the ESP8266 core (<a href=\"https:\/\/github.com\/esp8266\/Arduino\">https:\/\/github.com\/esp8266\/Arduino<\/a>).<strong> Currently it is mandatory to use version 2.4.7! <\/strong>This is done e.g. in the Board-Manager of the Arduino IDE.<\/p>\n\n\n\n<p>Here are other libraries used, depending in part on the connected sensors:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>LiquidCrystal_I2C.h (<a href=\"https:\/\/github.com\/bitbank2\/BitBang_I2C\">https:\/\/github.com\/bitbank2\/BitBang_I2C<\/a>, <a href=\"https:\/\/github.com\/fdebrabander\/Arduino-LiquidCrystal-I2C-library\">https:\/\/github.com\/fdebrabander\/Arduino-LiquidCrystal-I2C-library<\/a>)<\/li>\n\n\n\n<li>ss_oled.h (<a href=\"https:\/\/github.com\/bitbank2\/ss_oled\">https:\/\/github.com\/bitbank2\/ss_oled<\/a>)<\/li>\n\n\n\n<li>PubSubClient.h (<a href=\"https:\/\/pubsubclient.knolleary.net\/\">https:\/\/pubsubclient.knolleary.net\/<\/a>)<\/li>\n\n\n\n<li>NTPClient.h (<a href=\"https:\/\/github.com\/arduino-libraries\/NTPClient\">https:\/\/github.com\/arduino-libraries\/NTPClient<\/a>)<\/li>\n\n\n\n<li>WiFiUdp.h<\/li>\n\n\n\n<li>SimpleTimer.h (<a href=\"https:\/\/github.com\/kiryanenko\/SimpleTimer\">https:\/\/github.com\/kiryanenko\/SimpleTimer<\/a>)<\/li>\n\n\n\n<li>Pushover.h (<a href=\"https:\/\/github.com\/ArduinoHannover\/Pushover\">https:\/\/github.com\/ArduinoHannover\/Pushover<\/a>)<\/li>\n\n\n\n<li>myTypes.h<\/li>\n\n\n\n<li>DHT.h (<a href=\"https:\/\/github.com\/adafruit\/DHT-sensor-library\">https:\/\/github.com\/adafruit\/DHT-sensor-library<\/a>)<\/li>\n\n\n\n<li>VL53L0X.h (<a href=\"https:\/\/github.com\/pololu\/vl53l0x-arduino\">https:\/\/github.com\/pololu\/vl53l0x-arduino<\/a>)<\/li>\n\n\n\n<li>SparkFun_VL53L1X.h (<a href=\"https:\/\/github.com\/sparkfun\/SparkFun_VL53L1X_Arduino_Library\">https:\/\/github.com\/sparkfun\/SparkFun_VL53L1X_Arduino_Library<\/a>)<\/li>\n<\/ul>\n\n\n\n<div style=\"height:48px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<p class=\"is-style-text-annotation has-base-color has-accent-3-background-color has-text-color has-background has-link-color has-xx-large-font-size wp-elements-bcec7b6eaff3609648a6d6c9a98f04c3 is-style-text-annotation--1\"><a href=\"http:\/\/opencistern.com\/wiring\/\" data-type=\"page\" data-id=\"39\">Wiring<\/a><\/p>\n\n\n\n<h2 class=\"wp-block-heading\"><mark style=\"background-color:rgba(0, 0, 0, 0)\" class=\"has-inline-color has-accent-3-color\">3) Start-Up<\/mark><\/h2>\n\n\n\n<p>Once the firmware has been flashed to the Microcontroller and everything is <a href=\"http:\/\/opencistern.com\/wiring\/\" data-type=\"page\" data-id=\"39\">correctly wired<\/a>, the sensor can be put into operation.<\/p>\n\n\n\n<p>The sensor tries to connect to a configured WLAN. If this does not succeed (which is the case during the first start-up), the sensor creates a WLAN access point with the name &#8220;WLAN cistern&#8221; which should be found in the smartphone, for example. Connect to this WLAN.<\/p>\n\n\n\n<p>Now call up the address <a href=\"http:\/\/192.168.4.1\">http:\/\/192.168.4.1<\/a> in the browser of the connected device. This address is usually also displayed and linked in the connection settings of the connected WLAN. The configuration page of the sensor now opens.<\/p>\n\n\n\n<p>Enter the SSID and the password of the home wifi and click on &#8220;Save configuration&#8221;. The other settings (cistern form, etc.) can be made later.<\/p>\n\n\n\n<p>The sensor then restarts and attempts to connect to the home wifi. If this was successful, the access point is no longer accessible and the sensor should have been assigned an IP address in the home network. This can be looked up in the router (e.g. in the Friztbox under &#8220;Home network -&gt; Network&#8221;).<\/p>\n\n\n\n<p>If the &#8220;WLAN cistern&#8221; access point is still visible, the connection to the home WLAN was not successful. Then carry out the above steps again.<\/p>\n\n\n\n<div style=\"height:57px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<p class=\"is-style-text-annotation has-base-color has-accent-3-background-color has-text-color has-background has-link-color has-xx-large-font-size wp-elements-6db7c549578371de159a8031aa48bcd3 is-style-text-annotation--2\">Connectivity<\/p>\n\n\n\n<p><\/p>\n","protected":false},"excerpt":{"rendered":"<p>There are two ways to start with the installation of the sensor. 1) Use the fully compiled version An already compiled version can be downloaded from GitHub. To flash the downloaded bin-file to the microcontroller, the program \u201cESPEasy Flasher\u201d can be used in addition to various other options. This software can be found on GitHub [&hellip;]<\/p>\n","protected":false},"author":1,"featured_media":0,"parent":0,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"","meta":{"footnotes":""},"class_list":["post-62","page","type-page","status-publish","hentry"],"_links":{"self":[{"href":"https:\/\/opencistern.com\/en\/wp-json\/wp\/v2\/pages\/62","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/opencistern.com\/en\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/opencistern.com\/en\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/opencistern.com\/en\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/opencistern.com\/en\/wp-json\/wp\/v2\/comments?post=62"}],"version-history":[{"count":27,"href":"https:\/\/opencistern.com\/en\/wp-json\/wp\/v2\/pages\/62\/revisions"}],"predecessor-version":[{"id":240,"href":"https:\/\/opencistern.com\/en\/wp-json\/wp\/v2\/pages\/62\/revisions\/240"}],"wp:attachment":[{"href":"https:\/\/opencistern.com\/en\/wp-json\/wp\/v2\/media?parent=62"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}