← Zur Übersicht

📖 Cocktailmaschine: Handbuch

Bedienung, Einrichtung und Wartung der Cocktailmaschine.

Inhalt:
1. Erste Inbetriebnahme 2. Die Oberfläche 3. Einrichtung 4. Getränke anlegen 5. Getränk ausgeben 6. WLAN & Standalone 7. Tablet-Kiosk 8. Sicherheit & NOT-AUS 9. Hardware / Pins 10. FAQ

1. Erste Inbetriebnahme

Nötig sind Rust mit ESP-Toolchain (espup install), espflash und ldproxy.

  1. Vorlage .cargo/config.toml.example nach .cargo/config.toml kopieren, WIFI_SSID und WIFI_PASS eintragen.
  2. Im Projektordner cargo run --release ausführen. Die Firmware wird per USB geflasht.
  3. Im Browser http://cockimate/ oder die im Monitor angezeigte IP-Adresse öffnen.
Nur 2,4-GHz-WLAN, keine reinen 5-GHz-Netze. Ohne Router-Verbindung öffnet die Maschine ihr eigenes WLAN „Cockimate“ (Abschnitt 6).

2. Die Oberfläche

Gäste sehen nur die Getränke-Auswahl, dazu den Zustand, das Zahnrad ⚙️, das Referenzier-Symbol 🏠 und den NOT-AUS.

Auf das Zahnrad ⚙️ tippen und Passwort eingeben (Standard 1234). Dann erscheinen die Reiter Getränke, Einrichtung, Manuell und Skripte. Das Schloss 🔒 sperrt das Menü wieder.

Das Passwort steht in src/servo-control-migrated.html (SETUP_PASSWORD). Es hält Gäste vom Verstellen ab, ist aber kein echter Zugriffsschutz.

3. Einrichtung

Im Reiter Einrichtung die Maschine einmalig einlernen:

  1. Referenzieren: „🏠 X referenzieren“ und „🏠 Z referenzieren“ drücken.
  2. Slots einlernen: Schlitten mit dem Fahr-Panel unter Slot 1 fahren, „📍 X übernehmen“ drücken. Für alle 6 Slots wiederholen und je Mechanismus oder Pumpe wählen. Bei einer Pumpe zusätzlich die Z-Position einlernen.
  3. Z-Release-Höhe: Z hochfahren, bis der Mechanismus sicher auslöst, dann übernehmen.
  4. Ausgabe: Optional eine eigene Ausgabeposition einlernen. Sonst endet jedes Getränk am Nullpunkt.
  5. Zeiten & Dosierung: Haltezeit, Pause, Rückhub und Pumpenlaufzeit pro Portion einstellen.
  6. Ganz unten „Einstellungen speichern" drücken.
Ein Hub gibt ca. 20 ml ab. Am eigenen Gerät nachmessen und bei Pumpen die „ms pro Portion“ anpassen.

4. Getränke anlegen

Unter Einrichtung → Getränke verwalten „➕ Neues Getränk anlegen“ drücken. Name, Icon und Rezept („Slot × Portionen“) wählen, „✔ Getränk übernehmen“, dann „Getränkeliste speichern“.

Die mitgelieferten Beispiel-Getränke lassen sich bearbeiten oder löschen.

5. Getränk ausgeben

Im Reiter Getränke eine Kachel antippen und bestätigen. Bei „Fertig! 🥂“ das Glas entnehmen.

Referenzieren vom Hauptscreen: Erscheint „Referenzfahrt nötig, hier tippen“, darauf tippen. Die Maschine fährt erst Z frei, dann X. Das geht auch ohne Passwort.

6. WLAN & Standalone

Router-Modus (Standard): Die Maschine nutzt das WLAN aus .cargo/config.toml.

Standalone-Modus: Unter Einrichtung → Netzwerk umschalten und „Speichern & neu starten“ drücken. Dann mit dem WLAN „Cockimate“ verbinden (Passwort cocktail123) und http://192.168.71.1/ öffnen.

Meldet Android „kein Internet“, „Verbindung halten“ bestätigen.

7. Tablet-Kiosk

Auf einem Android-Tablet eine Kiosk-Browser-App einrichten (z. B. „Fully Kiosk Browser“). Die Maschinen-Adresse als Startseite eintragen, Vollbild und „Bildschirm wach halten“ einschalten.

8. Sicherheit & NOT-AUS

Der rote NOT-AUS (auch Taste ESC) stoppt sofort Motoren und Pumpe und verwirft wartende Befehle. Danach „Fortsetzen“ (Reiter Manuell) drücken und neu referenzieren.

Wichtig: Der Software-NOT-AUS ersetzt keinen Hardware-Not-Aus, der die Motorversorgung trennt. Können Personen an bewegliche Teile gelangen, ist ein echter Not-Aus-Taster in der Stromzuleitung dringend zu empfehlen. Betrieb auf eigene Verantwortung.

Weitere Schutzfunktionen: Software-Endlagen, Tempo-Grenzen, Homing-Abbruch, entprellter Endschalter, begrenzte Warteschlangen.

9. Hardware / Pins

AchseFunktionGPIO
XStep / Dir / Enable / Endschalter32 / 33 / 14 / 21
ZStep / Dir / Enable / Endschalter25 / 26 / 27 / 22
-Pumpen-Relais (HIGH = an)19

Pins stehen in src/main.rs („HARDWARE-SETUP“), Wege und Grenzen in src/config.rs. Fährt eine Achse falsch herum, X_DIR_INVERTED bzw. Z_DIR_INVERTED in src/config.rs umstellen.

10. FAQ

Die Maschine taucht nicht im WLAN auf.

SSID und Passwort in .cargo/config.toml prüfen (2,4 GHz). Die IP steht im seriellen Monitor. Notfalls mit dem WLAN „Cockimate“ verbinden.

Ein Getränk startet nicht („Slot X nicht eingelernt").

Einrichtung öffnen, die fehlende Position bzw. Z-Höhe einlernen und speichern.

Die Pumpe läuft nicht.

Slot auf „Pumpe" gestellt? Relais an GPIO 19? „ms pro Portion" sinnvoll eingestellt?

Positionen stimmen nach dem Einschalten nicht.

Eine Referenzfahrt ausführen. Die eingelernten Slots bleiben gespeichert.