pflanzensensor-workshop/README.md

158 lines
5.3 KiB
Markdown
Raw Normal View History

2022-12-20 13:45:03 +01:00
# ESP Pflanzensensor Workshop
Die Projektdokumentation zum Pflanzensensor Workshop.
<https://curious.bio/2022/11/remote-chaos-experience/>
## Komponenten
### Mikrocontroller
* [Wemos D1 mini ESP-8266](https://www.wemos.cc/en/latest/d1/d1_mini.html)
### Luftfeuchtigkeits- und Temperatursensor
* [Asair DHT11](https://asairsensors.com/product/dht11-sensor/)
* [Datenblatt](https://www.mouser.com/datasheet/2/758/DHT11-Technical-Data-Sheet-Translated-Version-1143054.pdf)
### Bodenfeuchtesensor
* Capacitive Soil Moisture Sensor v1.2
* analoges Signal!
* [Datenblatt](https://media.digikey.com/pdf/data%20sheets/dfrobot%20pdfs/sen0193_web.pdf)
* <https://thecavepearlproject.org/2020/10/27/hacking-a-capacitive-soil-moisture-sensor-for-frequency-output/>
## Systemanforderungen
* [Python Runtime Environment](https://www.python.org/)
2022-12-29 14:40:37 +01:00
* [Fritzing Prototyping Editor](https://fritzing.org/)
2022-12-30 11:31:34 +01:00
* [Arduino IDE](https://www.arduino.cc/)
* [VSCodium Code Editor](https://vscodium.com/) alternativ zur Arduino IDE
2022-12-20 13:45:03 +01:00
2022-12-29 17:23:08 +01:00
## Schaltplan
![Beadboard](breadboard.png "breadboard")
2022-12-20 13:45:03 +01:00
2022-12-29 18:17:14 +01:00
![Schaltplan](schaltplan.png "schaltplan")
2022-12-30 11:19:28 +01:00
## Arduino IDE
Download hier: https://www.arduino.cc/
2022-12-30 12:10:45 +01:00
![IDE](ide.png "ide")
2022-12-30 11:54:36 +01:00
Um mit den ESP-basierten Boards entwickeln zu können, müssen diese hinzugefügt werden (Einstellungen -> Board Manager URLs): "http://arduino.esp8266.com/stable/package_esp8266com_index.json,https://dl.espressif.com/dl/package_esp32_index.json" Man kann diese einfach in die Zeile einfügen. Unterschiedeliche Board-Manager-URLs können mit einem Komma getrennt sein.
2022-12-30 11:19:28 +01:00
![Einstellungen](preferences.png "board manager URLs")
2022-12-30 11:54:36 +01:00
Um den DHT11 auszulesen, benötigen wir zusätzlich noch eine Library (Tools -> Manage Libraries): "DHT sensor library for ESPx by beegee_tokyo":
2022-12-30 11:19:28 +01:00
![Library Manager](librarymanager.png "library manager")
2022-12-30 11:29:32 +01:00
Zum Flashen (Upload) muss das richtige Board "LOLIN(WEMOS) D1 mino (clone)" und der richtige Port (ein serieller Port, an dem das Board über USB angeschlossen ist) ausgewählt sein.
![Flash](flash.png "flash")
Hier hilft die Doku sicherlich weiter: https://support.arduino.cc/hc/en-us/articles/4733418441116-Upload-a-sketch-in-Arduino-IDE
2022-12-30 11:23:39 +01:00
## Beispiele
Es gibt zwei Beispiele.
* `serial-out` gibt einfach Messwerte über den Serial Monitor aus.
* `first-webserver` präsentiert die gleichen Messerte auf einer Website
2022-12-30 11:54:36 +01:00
Damit der Webserver im eigenen Netzwerk funktioniert, muss dieser die SSID des Wifis und das Passwort kennen. Es ist am einfachsten, diese Zeile zu löschen:
2022-12-30 11:23:39 +01:00
```
#include "credentials.h" // put your WIFI credentials in here
```
Statt dessen kann man dann die SSID und das Passwort des eigenen WLANS in diesen Zeilen eintragen:
```
// Replace with your network credentials
const char* ssid = secrect_ssid;
const char* password = secret_password;
```
Zum Beispiel so:
```
// Replace with your network credentials
const char* ssid = "MeinKabelWifi";
const char* password = "letMeIn123";
```
2023-02-26 17:08:33 +01:00
## Tasmota
[Tasmota](https://tasmota.github.io/docs/) is an alternative Firmware for ESP8266. It's easy to use as it has a graphical interface.
You can flash Tasmota right from the browser using the [Tasmota Web Installer](https://tasmota.github.io/).
![Flash it](./tasmota/01-flash-1.png)
You have to connect your device with a USB cable and select the right port. Exisisting firmware will be delete.
![Erase everything](./tasmota/02-flash-2.png)
After Tasmota has been flashed to your ESP, you can already set up your wifi.
![Set up Wifi](./tasmota/03-wifi.png)
AFter your device is connected to Wifi, you can switch over to the web UI of your device. Yes, your device now runs an embedded web server. There you can configure your device.
![Embedded web server](./tasmota/04-web-ui.png)
### Configure
Using this Web UI you can configure your device: `Configure -> Configure Module`
We have a DHT11 connected to D1 and an analogue measurement on A0.
![Basic configuration](./tasmota/05-configuration.png)
After configuring it this way, we can see you data in the web UI.
![Flash it](./tasmota/06-overview.png)
2022-12-30 11:19:28 +01:00
## ESPHome
### CLI
2022-12-29 18:17:14 +01:00
2022-12-20 13:45:03 +01:00
```sh
esphome --help
usage: esphome [-h] [-v] [-q] [-s key value] command ...
positional arguments:
command Command to run:
config Validate the configuration and spit it out.
compile Read the configuration and compile a program.
upload Validate the configuration and upload the latest binary.
logs Validate the configuration and show all logs.
run Validate the configuration, create a binary, upload it, and start logs.
clean-mqtt Helper to clear retained messages from an MQTT topic.
wizard A helpful setup wizard that will guide you through setting up ESPHome.
mqtt-fingerprint Get the SSL fingerprint from a MQTT broker.
version Print the ESPHome version and exit.
clean Delete all temporary build files.
dashboard Create a simple web server for a dashboard.
rename Rename a device in YAML, compile the binary and upload it.
options:
-h, --help show this help message and exit
-v, --verbose Enable verbose ESPHome logs.
-q, --quiet Disable all ESPHome logs.
-s key value, --substitution key value
Add a substitution
```
```sh
esphome compile esphome.yaml
esphome upload esphome.yaml
```
2022-12-29 15:46:42 +01:00