Skip to content

Commit

Permalink
Update links to images in new sorted directories
Browse files Browse the repository at this point in the history
  • Loading branch information
eliba authored and LoQue90 committed Feb 27, 2024
1 parent 149be7c commit 0db1dab
Show file tree
Hide file tree
Showing 27 changed files with 153 additions and 158 deletions.
52 changes: 26 additions & 26 deletions archive/arduino.md
Original file line number Diff line number Diff line change
Expand Up @@ -27,11 +27,11 @@ Wird benötigt, um den Code auf den Controller zu spielen.

[Link zu Arduino](https://www.arduino.cc/en/Main/Software)

![Screenshot der Arduino Homepage](../../img/1.png)
![Screenshot der Arduino Homepage](../../img/archive/arduino/1.png)

## Installation der Arduino IDE

![Arduino Installation](../../img/installation.gif)
![Arduino Installation](../../img/archive/arduino/installation.gif)

Hinweise zur Installation befinden sich auf der [Arduino Homepage](https://www.arduino.cc/en/Guide).

Expand All @@ -52,14 +52,14 @@ Diese erreicht ihr unter: Datei > Voreinstellungen
<details markdown="block">
<summary> Windows </summary>

![Windows Arduino Voreinstellungen](../../img/8.png)
![Windows Arduino Voreinstellungen](../../img/archive/arduino/8.png)

</details>

<details markdown="block">
<summary> Linux (Ubuntu) </summary>

![Linux (Ubuntu)](../../img/arduino-voreinstellungen-ubu.png)
![Linux (Ubuntu)](../../img/archive/arduino/arduino-voreinstellungen-ubiu.png)

</details>

Expand All @@ -75,22 +75,22 @@ Dies erreicht ihr unter: Werkzeuge > Board: "[\<Version\>]" > Boardverwalter...
<details markdown="block">
<summary> Windows </summary>

![Windows Arduino Boardverwalter](../../img/9.png)
![Windows Arduino Boardverwalter](../../img/archive/arduino/9.png)

</details>

<details markdown="block">
<summary> Linux (Ubuntu) </summary>

![Linux (Ubuntu) Boardverwalter](../../img/arduino-boardverwalter-ubu.png)
![Linux (Ubuntu) Boardverwalter](../../img/archive/arduino/arduino-boardverwalter-ubu.png)

</details>

Bitte die aktuelle Version installieren.

Typ \<Alle\> > "esp": "**esp8266** by **ESP8266 Community**"

![ESP8266 installieren](../../img/boardtreiber.gif)
![ESP8266 installieren](../../img/archive/arduino/boardtreiber.gif)

Nun ist die Arduino IDE vorbereitet. Weiter geht es mit den Bibliotheken.

Expand Down Expand Up @@ -121,70 +121,70 @@ Alternativ müssen folgende Libraries per Hand installiert werden:

Die Installation der einzelnen Bibliotheken erfolgt wieder über die Verwaltung in Arduino IDE:

![Bibliotheken verwalten](../../img/12.png)
![Bibliotheken verwalten](../../img/archive/arduino/12.png)

<details markdown="block">
<summary> OneWire </summary>

![](../../img/13.png)
![](../../img/archive/arduino/13.png)
</details>

<details markdown="block">
<summary>
DallasTemperature
</summary>

![](../../img/14.png)
![](../../img/archive/arduino/14.png)
</details>

<details markdown="block">
<summary> U8x8lib </summary>

1. Geht auf [https://github.com/olikraus/u8g2](https://github.com/olikraus/u8g2)
1. Code > Download Zip
![](../../img/15.png)
![](../../img/archive/arduino/15.png)
1. Legt die Dateien im [Arduino Libraries Ordner](#bibliotheken-installieren) ab
1. Erstellen einen Ordner: `U8x8lib`
1. Den Inhalt aus dem ZIP File Ordner: u8g2-master.zip\u8g2-master\cppsrc UND csrc in den neu erstellten Ordner kopieren (ja, es sind eine ganze Menge Dateien :))
![](../../img/16.png)
![](../../img/17.png)
![](../../img/archive/arduino/16.png)
![](../../img/archive/arduino/17.png)
</details>

<details markdown="block">
<summary> PID_v1.h </summary>

1. Geht auf [https://github.com/br3ttb/Arduino-PID-Library](https://github.com/br3ttb/Arduino-PID-Library)
1. Code > Download Zip
![](../../img/arduino-pid-lib.png)
![](../../img/archive/arduino/arduino-pid-lib.png)
1. Legt die Dateien im [Arduino Libraries Ordner](#bibliotheken-installieren) ab
1. Erstellen einen Ordner: `PID_v1`
1. Die vier Dateien aus dem ZIP File kopieren und in den neuen Ordner einfügen:
![](../../img/19.png)
![](../../img/20.png)
![](../../img/archive/arduino/19.png)
![](../../img/archive/arduino/20.png)
</details>

<details markdown="block">
<summary> Blynk </summary>

1. Geht auf [https://www.blynk.cc/getting-started/](https://www.blynk.cc/getting-started/)
![](../../img/21.png)
![](../../img/archive/arduino/21.png)
1. Geht auf [https://github.com/blynkkk/blynk-library/releases/tag/v0.5.4](https://github.com/blynkkk/blynk-library/releases/tag/v0.5.4)
![](../../img/22.png)
![](../../img/23.png)
![](../../img/25.png)
![](../../img/26.png)
![](../../img/archive/arduino/22.png)
![](../../img/archive/arduino/23.png)
![](../../img/archive/arduino/25.png)
![](../../img/archive/arduino/26.png)
1. Wechseln in den [Arduino Libraries Ordner](#bibliotheken-installieren)
![](../../img/27.png)
![](../../img/28.png)
![](../../img/archive/arduino/27.png)
![](../../img/archive/arduino/28.png)
</details>

## Board einstellen

![](../../img/29.png)
![](../../img/Bildschirmfoto-2019-07-03-um-00.01.26.png)
![](../../img/archive/arduino/29.png)
![](../../img/archive/arduino/Bildschirmfoto-2019-07-03-um-00.01.26.png)

Wenn alle Bibliotheken installiert sind, müsste es wie folgt aussehen:

![](../../img/31.png)
![](../../img/archive/arduino/31.png)

Somit ist alles nun für das Einrichten von Blynk und das Flashen von dem Code vorbereitet. Dann kann der erste Test beginnen.
8 changes: 4 additions & 4 deletions archive/software-part-II.md
Original file line number Diff line number Diff line change
Expand Up @@ -262,21 +262,21 @@ WIFICINNECTIONDELAY ist die Zeitspanne bis der nächste Reconnect probiert wird.
Wenn ihr die .ino Datei öffnet, öffnet sich automatisch im zweiten Tab die userConfig.h mit den wichtigen Einstellungen. Danach auf den Pfeil klicken für den Upload auf den Microkontroller. Achtet darauf, dass Ihr den Auth-Code der Blynk-App und die WLAN-Zugangsdaten im Code der userConfig.h hinterlegt habt.
![](../img/image-2.png)
![](../img/archive/software-part-II/image-2.png)
Bitte achtet vorher drauf, dass Ihr in den Board Einstellungen den richtigen COM Port ausgewählt habt.
Diesen könnt ihr auch auch im Gerätemanager prüfen (falls ihr ihn nicht wisst):
![](../img/34.png)
![](../img/archive/software-part-II/34.png)
![](../img/35.png)
![](../img/archive/software-part-II/35.png)
## Testen
Wenn alles geklappt habt könnt ihr auf dem Serial Monitor erkennen, wie sich der Microkontroller mit Blynk verbindet.
![](../img/36.png)
![](../img/archive/software-part-II/36.png)
Klappt das und ist der Temperatursensor korrekt angeschlossen seht ihr am Handy in der Blynk App die Raumtemperatur.
Jetzt könnt iht nach und nach die anderen Bauteile verbinden (Relais) und weiter testen.
Expand Down
2 changes: 1 addition & 1 deletion de/bestellliste.md
Original file line number Diff line number Diff line change
Expand Up @@ -168,7 +168,7 @@ Das Display wird für keine Ausbaustufe zwangsläufig benötigt. Ohne Display l

| Regulärer Lauf | Auszug Monitoring (Grafana) |
| :---: | :---: |
| ![Herzschlag-artiges Blinken der Lampe auf dem Bedienfeld der Kaffeemaschine](../img/blink.gif) | ![Graph im Monitoring: Temperaturverlauf beim Aufheizen und während des Haltens der Zieltemperatur](../img/blink_monitoring3.png) |
| ![Herzschlag-artiges Blinken der Lampe auf dem Bedienfeld der Kaffeemaschine](../img/bestellliste/blink.gif) | ![Graph im Monitoring: Temperaturverlauf beim Aufheizen und während des Haltens der Zieltemperatur](../img/bestellliste/blink_monitoring3.png) |

Wer es einfach mag, kann das Display entweder neben die Maschine legen, oder an einem der Bleche fixieren. Wie ihr einzelnen Bauberichten entnehmen könnt ([Link](https://clevercoffee.de/rancilio-silvia-e-konstantin/)), kann das Display natürlich auch sauber hinter einem der Bleche integriert oder mit einem 3D-gedruckten Gehäuse an der Maschine befestigt werden.

Expand Down
8 changes: 4 additions & 4 deletions de/customization/Display.md
Original file line number Diff line number Diff line change
Expand Up @@ -25,12 +25,12 @@ Diese können in der Userconfig ausgewählt werden:
Es gibt Anzeigen, die unabhänbgig vom Displaytemplate angezeigt werden:

### Kaltstart:
![Displayanzeige Kaltstart](../../img/disp-kaltstart.jpg)
![Displayanzeige Kaltstart](../../img/customization/display/disp-kaltstart.jpg)

Dies zeigt an, dass sich die Maschine noch im Kaltstart befindet. Inkl. der aktuellen Temperatur.

### Brewtimer:
![Brewtimer](../../img/disp-brewtimer.jpg)
![Brewtimer](../../img/customization/display/disp-brewtimer.jpg)

Der Brewtimer (oder Shottimer) wird ebenfalls in der Userconfig ausgewählt:

Expand All @@ -41,7 +41,7 @@ Bei OnlyPID sind standardmaüßig 35 Sekunden hinterlegt.


## Standard Design - DISPLAYTEMPLATE 1
![Display Template 1](../../img/Displaytemplate1.png)
![Display Template 1](../../img/customization/display/Displaytemplate1.png)

Erläuterung zur Anzeige:
Oben sind von (links) folgende Symbole zu sehen:
Expand All @@ -59,7 +59,7 @@ Die mittige Anzeige (von oben)


## Minimal Design - DISPLAYTEMPLATE 2
![Display Template 2](../../img/disp-minimal-default.jpg)
![Display Template 2](../../img/customization/display/disp-minimal-default.jpg)

Erläuterung der Anzeige:
Links wird die Ist-Temperatur angezeigt. Rechts die Solltemperatur. Ist diese erreicht, beginnt das Display zu blinken.
Expand Down
12 changes: 6 additions & 6 deletions de/customization/PIDV3.md
Original file line number Diff line number Diff line change
Expand Up @@ -19,7 +19,7 @@ Inhaltsverzeichnis

Der PID-Regler soll die folgenden Betriebszustände korrekt handhaben:

![PID-Einführung](../../img/Bildschirmfoto-2020-11-04-um-20.51.31-1536x733.png)
![PID-Einführung](../../img/customization/pidv3/Bildschirmfoto-2020-11-04-um-20.51.31-1536x733.png)

Bereiche | Erklärung
:--|:--
Expand All @@ -32,7 +32,7 @@ Beide Modi sind aber optional weiterhin aktivierbar.

Die zugehörigen Werte lassen sich im Webinterface auf der Seite "Parameters" einstellen:

![PID-Parametersmenu](../../img/PIDparametersmenu.png)
![PID-Parametersmenu](../../img/customization/pidv3/PIDparametersmenu.png)

Parameter | Erklärung
:--|:--
Expand Down Expand Up @@ -94,23 +94,23 @@ Insofern ein kleiner Maximalwert für den Integralteil festegelegt ist, hat Tn f
### Exemplarische Kurvenverläufe

Folgende Messreihe zeigt euch, wie eine Veränderung von P und Tv das Kaltstartverhalten verändert (Tn ist hier fix bei Tn = 200):
![PID-P-I-Veränderung](../../img/PV-TV-Ansicht-1.png)
![PID-P-I-Veränderung](../../img/customization/pidv3/PV-TV-Ansicht-1.png)

Im Detail sieht es wie folgt am Setpoint aus:

![PID-P-I-Veränderung](../../img/PV-TV-Ansicht-2.png)
![PID-P-I-Veränderung](../../img/customization/pidv3/PV-TV-Ansicht-2.png)

Eine Erhöhnung von kP führt zu deutlichem Überschwingen, eine Erhöhung von Tv kann aber wiederum gegensteuern. Insgesamt liefern aber alle 9 Wertepaare bereits relativ gute Ergebnisse. Eine zusätzliche Veränderung entsteht durch der Parameter PID Integrator Max. Ist dieser größer, hat der aufgeladene "Puffer" (der Integrator) beim Start einen stärkeren Einfluss auf das Heizen und es dauert eine längere Zeit, diesen bei Überschreiten des Sollwertes wieder zu reduzieren.
Wenn das Gegenteil der Fall ist und der PID Integrator Max zu klein gewählt wird, kann der Integrator die bleibende Regelabweichung nicht ausreichend überwinden und der Sollwert wird nicht erreicht.

![PID-P-I-Veränderung](../../img/Imax-Ansicht.png)
![PID-P-I-Veränderung](../../img/customization/pidv3/Imax-Ansicht.png)

### Brühvorgang

Bei der Ausbaustufe "PID Only" (ohne Plus) ist die "PID BD Time (s)" und "PID BD Sensitivity" nur noch notwendig, um die Zeitanzeige im Display korrekt anzuzeigen. Diese Werte haben keinen Einfluss mehr auf den PID, solange "Enable Brew PID" deaktiviert ist. Mit Aktivierung von "Enable Brew PID", können nochmals eigene PID-Werte für den Brühvorgang gesetzt werden. Diese sind für die Dauer von "PID BD Time (s)" aktiv.
Es ist in der Regel aber nicht ratsam, während des Brühens stärker nachzuheizen, da die Maschine selbst bereits temperaturstabil durch ihr aufgeheiztes Metall ist (z.B. Rancilio Silvia, andere Maschinen evtl. abweichend). Durch zu starkes Nachheizen steigt dann die Temperatur im Sieb sogar noch an, was für den Kaffeegeschmack eher nachteilig sein kann. Bei kleineren/günstigeren Maschinen kann die Temperaturstabilität aber weniger gut sein, so dass ein sofortiges Nachheizen (Enable Brew PID) dort sinnvoll sein kann.

![PID-Parametersmenu BD](../../img/PIDparametersBDmenu.png)
![PID-Parametersmenu BD](../../img/customization/pidv3/PIDparametersBDmenu.png)

Parameter | Erklärung
:--|:--
Expand Down
6 changes: 3 additions & 3 deletions de/customization/brueherkennung.md
Original file line number Diff line number Diff line change
Expand Up @@ -140,15 +140,15 @@ Im Fall zwei (220V Sensor / Optokoppler) sollte es dann wie folgt verbunden sein
|3,3V |VCC |
|PIN 16 / BREW|OUT |

![QM Opto](../../img/qm-opto.png)
![QM Opto](../../img/customization/brewdetection/qm-opto.png)
</details>


### Brüherkennung mittels Software (PID Only)

Ohne zu tief in die technischen Details der Erkennung einzusteigen soll dir dennoch kurz die grundlegende Funktionsweise erläutert werden. Der Mikrocontroller überwacht bei aktivierter 'Brüherkennung mittels Software' (`BREWDETECTION 1` bzw. `FEATURE_BREWDETECTION 1`+`BREWDETECTION_TYPE 1`) kontinuierlich die Temperatur. Dabei wird die zeitliche Veränderung der Heizrate/Kühlrate für ein fortlaufendes Zeitfenster analysiert. Das Ergebnis ist dann die „heat average“. Kühlt die Maschine ab wird dieser Wert negativ, bei einem Hochheizen entsprechend positiv.

![Brüherkennung](../../img/fullsizeoutput_1c57.jpeg)
![Brüherkennung](../../img/customization/brewdetection/fullsizeoutput_1c57.jpeg)

Die Brüherkennung „horcht“ nun auf diesen „heat average“ und überprüft ob ein definierter, negativer Grenzwert überschritten wird ab dem die Maschine von einem Bezug ausgehen soll. Dieser wird bei „brew heater detection limit“ definiert. Hierbei ist zu beachten, dass hier der absolute Werte eingetragen wird: 70 entspricht -70. Die Übersetzung in den negativen Wert erfolgt im Quellcode!

Expand All @@ -173,7 +173,7 @@ Quick Mill (Modell 0835 & 3000) | 80 | 0 | 80 | 100 | tbd.

Ausgangssituation sind folgende PID Parameter:

![PID Parameter](../../img/Screenshot-at-M%C3%A4rz-15-07-47-28.png)
![PID Parameter](../../img/customization/brewdetection/Screenshot-at-März-15-07-47-28.png)

Bei dem Vergleich von einem Bezug mit und ohne Brüherkennung ist zu sehen, dass die Solltemperatur zu einem ähnlichen Zeitpunkt „durchschritten“ wird, aber ohne Erkennung die Temperatur nach oben ausschlägt (96 °C). Die Erkennung kann hier ein deutlich besseres Ergebnis liefern (ca. 93,5 °C). Auch fällt die Temperatur beim Bezug nicht so rapide nach unten ab, da die Heizung schneller reagieren kann.

Expand Down
4 changes: 2 additions & 2 deletions de/customization/monitoring.md
Original file line number Diff line number Diff line change
Expand Up @@ -19,7 +19,7 @@ Inhaltsverzeichnis

Die Blynk-App kann so eingerichtet werden, dass via eines sog. Webhooks ein Monitoring genutzt werden kann. Dafür wird [Grafana](https://grafana.com/) genutzt. Damit sind auch die vorhandenen PID-Charts erstellt entstanden:

![PID-Einführung](../../img/Bildschirmfoto-2020-11-04-um-20.51.31-1536x733.png)
![PID-Einführung](../../img/customization/monitoring/Bildschirmfoto-2020-11-04-um-20.51.31-1536x733.png)

## Übersicht

Expand All @@ -37,7 +37,7 @@ Folgendes Video erklärt die einzelnen Schritte:

In eurer `userConfig.h` muss Grafana aktiviert sein (sprich auf `1` gesetzt):

![Grafana](../../img/grafana-on.png)
![Grafana](../../img/customization/monitoring/grafana-on.png)

<!-- markdown-link-check-disable -->
### Schritt für Schritt
Expand Down
8 changes: 4 additions & 4 deletions de/customization/pid-werte.md
Original file line number Diff line number Diff line change
Expand Up @@ -23,7 +23,7 @@ Hier möchten wir dir die wesentlichen Bedienelemente der PID in Blynk erläuter

Wir haben festgestellt, dass ein Regler benötigt wird, um perfekt auf Solltemperatur zu regeln und dieser übergibt dann an den zweiten Regler für den regulären Betrieb. Dieser muss sich dann um das perfekte Regeln am Sollpunkt kümmern. Der Brühvorgang stellt eine besondere Abweichung dar, die wir versuchen mit der Brüherkennung zu optimieren. Auch dies ist ein separater Regler.

![PID-Einführung](../../img/Bildschirmfoto-2020-11-04-um-20.51.31-1536x733.png)
![PID-Einführung](../../img/customization/pid-werte/Bildschirmfoto-2020-11-04-um-20.51.31-1536x733.png)

Bereich | Erklärung
:--|:--
Expand All @@ -41,13 +41,13 @@ Es somit drei Regler/Bereiche:

Der Kaltstart ist aktiv bis zur Solltemperatur, danach gilt der reguläre PID. Wir haben die User Config (userConfig.h) so vorkonfiguriert, dass dieser Kaltstart ohne euer Zutun mit Standardwerten funktioniert. Diesen könnt ihr aber auch selber konfiguriert werden. Den PID für den regulären Betrieb findet ihr im „Hauptmenü“. Natürlich müsst ihr auch eine Solltemperatur definieren.

![Erklärung Brüherkennung](../../img/Bildschirmfoto-2020-11-04-um-19.43.11.png)
![Erklärung Brüherkennung](../../img/customization/pid-werte/Bildschirmfoto-2020-11-04-um-19.43.11.png)

Reguläre PID Einstellung (roter Kasten)

Der Kaltstart befindet sich im „Expertenmodus“ Reiter in der Blynk App. Dieser ist nur aktiv wenn in der **User Config „Coldstart = 2“ gewählt wird!** Sonst gelten vordefinierte Standardwerte.

![Erklärung Brüherkennung](../../img/Bildschirmfoto-2020-11-04-um-19.46.38.png)
![Erklärung Brüherkennung](../../img/customization/pid-werte/Bildschirmfoto-2020-11-04-um-19.46.38.png)

Kaltstart im Expertenmodus

Expand Down Expand Up @@ -98,7 +98,7 @@ Quick Mill (Modell 0835 & 3000) | 250 | 35

Folgende Grafik soll euch bei der Einstellungen vom Kaltstart helfen, wenn ihr diesen selber einstellen wollt. Das Grundprinzip des Reglern beim Kaltstart ist hier beschrieben (auf Englisch): [Link](http://brettbeauregard.com/blog/2017/06/introducing-proportional-on-measurement/).

![PID-Kurven](../../img/image.png)
![PID-Kurven](../../img/customization/pid-werte/image.png)

Diese Grafik zeigt euch qualitativ, wie sich die Kaltstartkurve verschiebt, wenn P oder I verändert werden. Das Ziel von dem Kaltstart sollte sein, dass die Maschine ohne ein nennenswerte Überschwingen perfekt auf die Solltemperatur landet. (vgl. Kurve P 45, I 130).

Expand Down
2 changes: 1 addition & 1 deletion de/hardware/Einbau.md
Original file line number Diff line number Diff line change
Expand Up @@ -129,7 +129,7 @@ Es gibt unzählig viele Möglichkeiten das Display zu positionieren. Folgend kö

Displayhalterung | Powered by Dremel
:---:|:---:
![Display](../../img/Display.jpg)|![](https://clevercoffee.de/wp-content/uploads/2021/04/IMG_20210404_151123.jpg)
![Display](../../img/hardware/einbau/Display.jpg)|![](https://clevercoffee.de/wp-content/uploads/2021/04/IMG_20210404_151123.jpg)

Wer einen Dremel besitzt, etwas Geschick mitbringt und kein Problem damit hat, dass Änderungen irreversibel sind, kann damit eine sehr saubere und solide Lösung ausarbeiten.

Expand Down
Loading

0 comments on commit 0db1dab

Please sign in to comment.