LISYclock Config Editor – Bedienungsanleitung

Version 1.11 | Sprache: Deutsch

Inhaltsverzeichnis

1. Überblick
2. Voraussetzungen & Start
3. Dateioperationen
4. Tab: Clock
5. Tab: General
6. Tab: Events
7. Tab: GI LEDs
8. Tab: Attract Mode
9. Tab: TTS Settings
10. Tab: Update
11. Tab: Debug
12. config.txt – Format & Aufbau
13. Tipps & Hinweise

1. Überblick

Der LISYclock Config Editor ist ein Werkzeug zum komfortablen Bearbeiten der config.txt-Konfigurationsdatei des LISYclock.

• Standalone-Anwendung: eine einzige LISYclock_config_editor.html-Datei, kein Server, kein Build-Schritt
• Einfach LISYclock_config_editor.html im Browser öffnen und loslegen
• Unterstützt direkten Upload/Download zur LISYclock-Hardware über IP (HTTP) oder USB

2. Voraussetzungen & Start

Browser

Starten

1. LISYclock_config_editor.html aus dem Projektverzeichnis lokal im Browser öffnen (Doppelklick oder Datei → Öffnen)
2. Die Anwendung startet sofort mit einer leeren Standardkonfiguration

Wichtig: Für die direkte Kommunikation mit der LISYclock über IP (Tab „Clock”) muss die Datei über file:// geöffnet werden – nicht über HTTPS. Browser blockieren HTTP-Anfragen von HTTPS-Seiten aus Sicherheitsgründen. Der USB-Modus funktioniert unabhängig davon, wie die Datei geöffnet wurde.

3. Dateioperationen

Die Schaltflächen in der Navigationsleiste (oben) steuern alle Dateioperationen:

Der aktuelle Dateiname wird in der Mitte der Navigationsleiste angezeigt. Solange keine Datei geöffnet wurde, erscheint dort „— keine Datei geöffnet —“.

4. Tab: Clock

Dieser Tab ermöglicht die direkte Kommunikation mit der LISYclock-Hardware. Wähle zwischen IP-Modus (WLAN) und USB-Modus (USB-Kabel).

Verbindungsmodus

Mit den Radiobuttons oben im Tab den Verbindungstyp auswählen:

IP-Modus

Trage die IP-Adresse deiner LISYclock ein (z. B. 192.168.1.42). Die Adresse wird im Browser gespeichert und beim nächsten Öffnen automatisch vorausgefüllt.

Ein Klick auf Connect Clock prüft die Erreichbarkeit der Uhr:

Bei erfolgreicher Verbindung werden Firmware-Version und API-Version angezeigt. Stimmt die API-Version nicht mit der erwarteten Version überein, erscheint eine Warnung (die Funktionen können trotzdem eingeschränkt nutzbar sein).

USB-Modus

Klick auf Connect USB baut die Verbindung auf. Der Status-Punkt zeigt den Zustand an:

Hinweis: Die Uhr startet einmal neu, wenn Connect USB geklickt wird. Das ist normal – der Neustart löst den USB-Handshake aus. Warten bis der Status Connected anzeigt.

WLAN-Verbindungstest (nur USB-Modus)

Im USB-Modus kann mit Test WiFi Connection die WLAN-Zugangsdaten aus dem General-Tab zur Uhr gesendet und die Verbindung geprüft werden. Der Status-Punkt zeigt das Ergebnis an.

Konfiguration

Uhrzeit stellen

Ein Klick auf Set Clock Time from PC überträgt die aktuelle Uhrzeit und das Datum des PCs zur Uhr.

Reboot

Ein Klick auf Reboot Clock startet die LISYclock neu. Ein Bestätigungsdialog verhindert versehentliche Neustarts.

Datei hochladen

Beliebige Datei (z. B. MP3, Batch) auf die SD-Karte der Uhr übertragen.

Dateiverwaltung auf der SD-Karte

• Mit Refresh die aktuelle Dateiliste von der SD-Karte laden
  • Die Liste zeigt Name, Größe und Änderungsdatum jeder Datei
  • Einzelne Dateien können heruntergeladen, umbenannt oder gelöscht werden

Protokoll-Log (nur USB-Modus)

Im USB-Modus erscheint ein Protokoll-Log-Panel, das die gesamte serielle Kommunikation zwischen Editor und Uhr anzeigt.

HTTPS-Warnung

Wenn der Editor über eine HTTPS-URL geöffnet wird, blockiert der Browser alle HTTP-Anfragen zur Uhr (IP-Modus). Lösung: LISYclock_config_editor.html lokal über file:// öffnen.

5. Tab: General

Allgemeine Einstellungen der LISYclock.

WLAN-Einstellungen

WLAN-Zugangsdaten werden in der config.txt gespeichert. Mit Test WiFi Connection im Clock-Tab (USB-Modus) lässt sich prüfen, ob die Zugangsdaten funktionieren.

Display-Helligkeit

Wert von 0 (dunkel) bis 7 (maximale Helligkeit). Entspricht dem Konfigurationsschlüssel DISP_BRIGHT.

FTP-Server

Zeitzone

Beispiel für Mitteleuropa mit Sommerzeit:

CET-1CEST,M3.5.0,M10.5.0/3

Wochentags-Strings

Wenn aktiviert, zeigt die Uhr lokalisierte Wochentagsnamen an. Jedes der 7 Felder (Sonntag–Samstag) darf maximal 6 Zeichen lang sein. Kürzere Einträge werden automatisch mit Leerzeichen auf 6 Zeichen aufgefüllt.

Beispiel (Deutsch): So, Mo, Di, Mi, Do, Fr, Sa

6. Tab: Events

Events definieren zeitgesteuerte Aktionen der LISYclock.

Event-Typen

Zeitformat

Die Zeit eines Events wird als HH:MM:W oder HH:MM-TT.MM.JJJJ angegeben. * steht in jedem Feld für „beliebig”.

Wochentag-Modus: HH:MM:W

Datum-Modus: HH:MM-TT.MM.JJJJ

Aktiv, wenn im Wochentag-Feld * (Datum) ausgewählt ist. Das Datum-Feld erscheint dann zusätzlich.

Beispiele

Bedienung

• + Add Event (Button oben rechts): Fügt einen neuen Event-Eintrag am Ende der Liste hinzu
• ✕ (rechts neben einem Event): Entfernt diesen Event

7. Tab: GI LEDs

Definiert die Startfarben der GI-LEDs (General Illumination).

Felder je LED-Zeile

Farbwähler und RGB-Felder sind miteinander synchronisiert: Eine Änderung im Picker aktualisiert die RGB-Felder und umgekehrt.

Bedienung

• + Add LED: Neuen LED-Eintrag am Ende der Liste anfügen
• ✕: Diesen LED-Eintrag entfernen

8. Tab: Attract Mode

Konfiguriert die Attract-Mode-Beleuchtung (Lauflichter im Standby) in 5 Gruppen (AT1–AT5).

Jede Gruppe ist als aufklappbares Accordion-Panel dargestellt.

Einstellungen je Gruppe

• + Add LED: Neuen LED-Eintrag zur Gruppe hinzufügen
• ✕: LED-Eintrag aus der Gruppe entfernen

9. Tab: TTS Settings

Einstellungen für die Text-to-Speech-Funktion (verwendet den WIT.ai-Dienst).

Den WIT.ai API-Token erhältst du nach kostenloser Registrierung auf wit.ai.

10. Tab: Update

Der Update-Tab bietet drei Möglichkeiten, die Firmware der LISYclock zu aktualisieren.

Lokale Firmware-Datei hochladen (nur IP-Modus)

1. .bin-Firmware-Datei mit dem Datei-Auswahl-Button auswählen
2. Update & Reboot klicken – die Datei wird als update.bin auf die SD-Karte übertragen und die Uhr startet automatisch neu, um das Update einzuspielen

Oder vom lisy.dev-Server

1. Zuerst im Clock-Tab (IP-Modus) mit der Uhr verbinden, damit der Editor die Hardware-Version erkennt
2. Fetch versions klicken – ein Dropdown erscheint mit allen passenden Firmware-Dateien von lisy.dev
3. Die gewünschte Version aus dem Dropdown auswählen
4. Update & Reboot klicken – die Datei wird von lisy.dev heruntergeladen und zur Uhr übertragen

Wenn eine Server-Version ausgewählt ist, hat das Dropdown Vorrang vor einer lokal gewählten Datei.

Flash via USB – Vollinstallation (nur USB-Modus)

Klick auf Flash via USB schreibt das vollständige Firmware-Paket (Bootloader, Firmware-Binary, Partitionstabelle und OTA-Daten) direkt per USB auf den ESP32. Keine WLAN-Verbindung erforderlich.

Nur Chrome/Edge. Während des Flashens wird ein Fortschritts-Log unter der Schaltfläche angezeigt. Das USB-Kabel nicht trennen, bis der Vorgang abgeschlossen ist.

11. Tab: Debug

Der Debug-Tab bietet eine reine USB-Seriell-Konsole für fortgeschrittene Benutzer und Entwickler.

Verbindung

Baud Rate (Standard: 115200) und Reset Delay (Standard: 1500 ms) auswählen, dann CONNECT klicken. Der Status-Punkt zeigt den Zustand an:

DTR- und RTS-Signalzustände werden oben rechts angezeigt.

Optionen

Zeilenende

Das an gesendete Befehle angehängte Zeilenende auswählen: NL (\n), CR+NL, CR oder None.

Konsole

Die Konsole zeigt alle seriellen Ausgaben des ESP32 farbkodiert an: - Grün: empfangene Daten - Orange: Systemmeldungen - Rot: Fehler - Dunkelgrau: Boot-Meldungen (wenn Boot Logs aktiviert)

12. config.txt – Format & Aufbau

Grundformat

KEY=value

• Jede Zeile enthält einen Schlüssel und einen Wert, getrennt durch =
• Eine # am Zeilenanfang deaktiviert die Zeile (ohne sie zu löschen)
• Groß-/Kleinschreibung der Schlüsselnamen ist im Editor normalisiert

Besonderheiten

Beispiel-Ausschnitt

WIFI_ENABLE=yes
WIFI_SSID="MeinNetzwerk"
WIFI_PWD="MeinPasswort"
DISP_BRIGHT=5
#FTP_USER=lisy
#FTP_PWD=lisy
# TIMEZONE="CET-1CEST,M3.5.0,M10.5.0/3"
EVENT_SYNC_TIME=2:0:*,10
EVENT_SAY_TIME=14:12:*,"german"
EVENT_TTS=8:0:*,"Guten Morgen!"

13. Tipps & Hinweise

• Chrome oder Edge verwenden: Nur diese Browser unterstützen die File System Access API für native Öffnen/Speichern-Dialoge sowie die Web Serial API für den USB-Modus. In Firefox und Safari erscheinen stattdessen Standard-Datei-Picker bzw. Download-Links; der USB-Modus ist dort nicht verfügbar.

• Lokal öffnen für IP-Verbindung: Wenn die Kommunikation mit der LISYclock im IP-Modus nicht funktioniert, prüfe ob LISYclock_config_editor.html über file:// (lokal) und nicht über https:// geöffnet ist.

• FTP als Alternative: Die fertige config.txt kann auch per FTP auf die SD-Karte der Uhr übertragen werden (wenn der FTP-Server in der Konfiguration aktiviert ist).

• Unbekannte Schlüssel: Wenn der Editor beim Laden unbekannte Schlüssel erkennt, ignoriert er sie und zeigt ein Warnbanner mit den betroffenen Zeilen an. Sie werden beim Speichern nicht übernommen. Falls du benutzerdefinierte Erweiterungen in der config.txt hast, sichere diese vorher separat.

• Keine Undo-Funktion: Der Editor hat keine Rückgängig-Funktion. Bei versehentlichen Änderungen hilft es, die Datei neu zu öffnen (ohne vorher zu speichern).

• USB-Verbindung wird geteilt: Eine im Clock-Tab hergestellte USB-Verbindung wird automatisch mit dem Debug-Tab geteilt und umgekehrt. Es gibt immer nur eine gleichzeitige USB-Verbindung.

Erstellt für LISYclock Config Editor v1.11