ebk_co2ampel/README.md

# Projekt: CO² Ampel

Implementierung einer CO² Ampel mit ESP32 + MH-Z19B + SSD1306.

Inspiriert vom Projekt ["CO² Ampeln für alle" von der Un-Hack-Bar](https://www.un-hack-bar.de/2020/10/25/co2-ampeln-fuer-alle/).

Eine weitere tolle Seite mit vielen Infos über das Lüften und CO², auch wie man den Bau einer solchen Ampel in den Unterricht integrieren kann, findet sich unter [co2ampel.org](https://co2ampel.org).

Unsere Ampel ist sehr simpel gehalten, und komplett offline. So verbraucht sie wenig Strom und kann mit einer Powerbank mehrere Stunden betrieben werden.

Auf dem Display erscheint nur der aktuelle Wert und der historische Verlauf der letzten 120 Messwerte als Grafik.

Eine RGB-LED zeigt rot, gelb oder grün, je nach Messwert.

## BOM


| Teil      | Preis China [^1] | Preis DE    |
| --------- | ----------- | ----------- |
| Sensor    | 20 €        | 25 € [^2]   |
| ESP32     | 0,50 €      | 8 €         |
| Buzzer    | 0,20 €      | 3 €         |
| Display   | 3 €         | 6 €         |
| LED       | 0,10 €      | 0,20 €      |
|           |             |             |
| **SUMME** | **23,80 €** | **42,20 €** |


Sensor: Infrared CO2 Sensor	mh-z19
ESP32: Mikrocontroller
Buzzer: Active piezzo buzzer KY-012
Display: OLED Display SSD1306	
LED: ws2812 ("Single Chip") [^3]


[^1]: Lieferzeiten China 1-3 Wochen bei hohen Versandkosten (30-40€)
[^2]: Sensor in Deutschland derzeit nicht erhältlich, Preis oben ist aus Belgien, Lieferzeit ca. 1-2 Wochen
[^3]: ![](https://pads.eigenbaukombinat.de/uploads/upload_4b9853a860606dc2a45d012b6480e01c.png)


## Flashen

Wir benutzen bisher die Arduino IDE. 

### ESP32 Boarddefinitionen

Falls noch nicht geschehen, müssen die Boarddefinitionen für den ESP32 installiert werden. Hierzu im Menü: Datei -> Voreinstellungen. Im Fenster dann bei "Zusätzliche Boardverwalter-URLs" diese URL eintragen:

```
https://dl.espressif.com/dl/package_esp32_index.json
```

Sollte dort schon etwas anderes drin stehen, mit einem Komma getrennt dazuschreiben.

Danach im Menü: Werkzeuge -> Board -> Boardverwalter nach "ESP32" suchen, und installieren.

### Libraries

Die benötigten Libraries installieren wir über die Bibliotheksverwaltung der Arduino IDE (Menü: Sketch -> Bibliothek einbinden -> Bibliotheken verwalten…), und zwar:

* [MH-Z19](https://github.com/crisap94/MHZ19) für das Auslesen des Sensors
* [ESP8266 and ESP32 OLED driver for SSD1306 displays](https://github.com/ThingPulse/esp8266-oled-ssd1306) für die Ansteuerung des Displays

### Flashen

* Als Board muss "ESP32 Dev Module" ausgewählt sein.

* Mit Strg+U kompilieren und auf den ESP laden.




## Wiring

bild: todo