NinjaCross Timer - Bedienungsanleitung

1. Einleitung

Der NinjaCross Timer ist ein professionelles Zeitmessgerät für Ninjacross-Wettkämpfe. Das System ermöglicht die präzise Zeitmessung für bis zu zwei Bahnen gleichzeitig und bietet zahlreiche Features wie RFID-Erkennung, lokales Leaderboard und Internet-Konnektivität über WiFi und MQTT.

2. Systemübersicht

2.1 Komponenten

• ESP32 Master: Hauptprozessor mit Web-Interface
• 4 Wireless-Buttons: Start/Stop Buttons für 2 Bahnen
• RFID-Reader: Optional - für Nutzeridentifikation
• Internet-Verbindung: Über WiFi für Cloud-Synchronisation

2.2 Anzeigen und Status

3. Erste Inbetriebnahme

3.1 Einschalten und Netzwerkverbindung

1. Einschalten: Master einschalten
2. Access Point finden: Suchen Sie nach dem WiFi-Netzwerk mit dem Namen NinjaCross-XXXXX (die letzten Zeichen sind eindeutig für Ihr Gerät)
3. Verbinden: Das Netzwerk ist standardmäßig ohne Passwort
4. IP-Adresse: Das Gerät hat die feste IP 192.168.10.1
5. Alternative: Sie können auch ninjacross.local im Browser verwenden (mDNS)

3.2 Web-Interface öffnen

Öffnen Sie Ihren Webbrowser und geben Sie eine der folgenden Adressen ein:

• http://192.168.10.1 (direkte IP)
• http://ninjacross.local (falls mDNS unterstützt wird)

4. Hauptoberfläche

4.1 Timer-Ansicht

Die Hauptseite zeigt:

• Bahn 1: Links - Timer und Status
• Bahn 2: Rechts - Timer und Status
• Heartbeat-Indikatoren: Oben - Verbindungsstatus der Buttons
• Leaderboard: Unten - Top 6 lokale Zeiten
• Navigation:
  • 🏆 = Leaderboard (Volansicht)
  • ⚙️ = Einstellungen

4.2 Timer-Bedienung

1. Standby: "Drücke beide Buttons einmal" - Buttons initialisieren
2. Bereit: Beide Buttons sind verbunden (grüne Heartbeats)
3. Armiert: Startbutton gedrückt - Timer startet bei freigegebenem Button
4. Läuft: Timer läuft - Zeit wird live angezeigt
5. Geschafft: Stop-Button gedrückt - Zeit wird gespeichert

5. Button-Konfiguration

5.1 Anlernmodus

Der erste Schritt ist das Anlernen Ihrer Wireless-Buttons:

1. Öffnen Sie die Einstellungen (⚙️)
2. Scrollen Sie zu "Button-Konfiguration"
3. Klicken Sie auf "🎯 Anlernmodus starten"
4. Folgen Sie den Anweisungen:
   1. Drücken Sie den Button für Bahn 1 Start
   2. Drücken Sie den Button für Bahn 1 Stop
   3. Drücken Sie den Button für Bahn 2 Start
   4. Drücken Sie den Button für Bahn 2 Stop
5. Die Anzeige zeigt automatisch an, welchen Button Sie drücken müssen
6. Nach erfolgreicher Konfiguration erhalten Sie eine Bestätigung

5.2 Buttons verlernen

Um alle Button-Zuweisungen zu löschen:

1. Einstellungen öffnen
2. "❌ Buttons verlernen" klicken
3. Bestätigung erfordert

5.3 Button-Status anzeigen

Klicken Sie auf "📊 Button-Status anzeigen" um zu sehen:

• Welche Buttons konfiguriert sind
• Batteriestand jedes Buttons in Prozent

6. RFID-Benutzerverwaltung

6.1 RFID-Karte registrieren

Die RFID-Funktion ermöglicht die automatische Zuordnung von Zeiten zu Nutzern:

1. Öffnen Sie "RFID" (🏷️) aus dem Einstellungsmenü
2. Klicken Sie auf "📡 Read Chip"
3. Halten Sie die RFID-Karte an den Reader des Masters
4. Die UID wird automatisch eingefügt
5. Geben Sie den Namen ein
6. Klicken Sie auf "💾 Speichern"

6.2 Kontinuierliches Lesen

Der "Read Chip" Button startet einen kontinuierlichen Lesemodus:

• Statusleiste zeigt: "RFID Lesen gestartet - Karte auflegen!"
• Alle erkannten Karten werden automatisch übernommen
• Nach erfolgreichem Lesen wird die Eingabe fokussiert

7. Einstellungen

7.1 Datum & Uhrzeit

Die Uhrzeit kann manuell oder automatisch gesetzt werden:

• Manuell: Datum und Uhrzeit eingeben, dann "🕐 Uhrzeit setzen"
• Automatisch: "💻 Browser-Zeit übernehmen" verwendet die Zeit Ihres Computers

7.2 Modus

7.3 Lane-Konfiguration

Die Bahnen können identisch oder unterschiedlich konfiguriert werden:

• ⚖️ Identische Lanes: Beide Bahnen sind gleich
• ⚡ Unterschiedliche Lanes: Bahnen mit unterschiedlichen Schwierigkeiten
  • 🟢 Leicht: Standard-Konfiguration
  • 🔴 Schwer: Anspruchsvollere Hindernisse

7.4 Grundeinstellungen

7.5 WLAN-Konfiguration (Lizenz Level 3 erforderlich)

Zur Konfiguration:

1. WLAN Name (SSID) eingeben
2. WLAN Passwort eingeben
3. Aktueller STA IP-Status wird angezeigt
4. Nach dem Speichern startet das Gerät neu

7.6 Standort (Lizenz Level 3 erforderlich)

Wählen Sie Ihren Standort aus einem Dropdown-Menü:

• Beim Eingeben einer gültigen Lizenz werden verfügbare Standorte aus der API geladen
• Ohne Lizenz werden Fallback-Standorte angezeigt
• Der gewählte Standort wird lokal gespeichert

7.7 OTA Update (Lizenz Level 2 erforderlich)

1. Klicken Sie auf "🔄 Update durchführen"
2. Bestätigen Sie die Abfrage
3. Das Gerät lädt die neueste Firmware herunter und installiert sie automatisch
4. Während des Updates darf der Strom nicht unterbrochen werden!

7.8 Buttons Updaten

Sendet eine Update-Nachricht über MQTT an alle konfigurierten Buttons:

1. Klicken Sie auf "📡 Buttons Updaten"
2. Die Buttons erhalten die aktuelle Konfiguration
3. Nutzen Sie dies nach Button-Wartung oder Konfigurationsänderungen

8. Leaderboard

8.1 Lokales Leaderboard

Die Hauptseite zeigt die Top 6 Zeiten:

• 🏆 Gold für Platz 1
• 🥈 Silber für Platz 2
• 🥉 Bronze für Platz 3
• Platz 4-6 in Standard-Darstellung

8.2 Volle Leaderboard-Ansicht

Öffnen Sie die Leaderboard-Seite (🏆):

• Zeigt alle erfassten Zeiten
• Gruppiert in 2 Zeilen zu je 5 Einträgen
• Wird alle 5 Sekunden automatisch aktualisiert

8.3 Beste Zeiten zurücksetzen

Einstellungen → "🏆 Zeiten verwalten" → "🔄 Beste Zeiten zurücksetzen"

9. System-Information

Die Einstellungsseite zeigt folgende Systemdaten:

10. Lizenz-System

10.1 Lizenz-Level

10.2 Lizenz eingeben

1. Einstellungen → "🔧 Lizenz"
2. Lizenzschlüssel eingeben
3. "💾 Lizenz speichern" klicken
4. System-Information aktualisiert sich automatisch

11. Batterie-Überwachung

Das System überwacht kontinuierlich die Batteriestände der Wireless-Buttons:

• Warnung: Bei Batteriestand ≤ 15% erscheint ein Banner
• Anzeige: "⚠️ Niedrige Batterie erkannt!" mit Geräteliste
• Detailliert: Über Button-Status-Anzeige werden alle Batteriestände angezeigt

12. API & Technische Details

12.1 API-Endpunkte

12.2 WebSocket-Daten

Der WebSocket liefert Echtzeit-Updates:

• Button-Status und Heartbeats
• Timer-Daten (live)
• RFID-Erkennung
• Batterie-Status

13. Troubleshooting

13.1 Buttons verbinden sich nicht

• Heartbeat rot: Button außerhalb der Reichweite oder Batterie leer
• Lösung: Batterien prüfen, Button näher zum Master bringen
• Neu anlernen: Einstellungen → Buttons verlernen → Anlernmodus starten

13.2 WiFi-Verbindung funktioniert nicht

• Standard: Nutzen Sie den Access Point NinjaCross-XXXXX
• Mit Lizenz Level 3: Konfigurieren Sie das WLAN in den Einstellungen
• Falls Netzwerk nicht gefunden wird: Gerät neustarten

13.3 IP-Adresse unbekannt

• 192.168.10.1 ist die Standard IP
• Alternative: ninjacross.local
• Router-Konfiguration: DHCP-Range darf 192.168.10.1 nicht blocken

13.4 Timer startet nicht

• Prüfen Sie alle 4 Heartbeat-Indikatoren (müssen grün sein)
• Start-Button muss vor dem Drücken des Stop-Buttons gedrückt werden
• Bahn muss "Bereit" Status zeigen

13.5 RFID wird nicht erkannt

• RFID-Lesemodus aktivieren: "📡 Read Chip" klicken
• Karte langsam über den Reader führen
• Neu versuchen wenn nach 5 Sekunden nichts passiert

14. Wartung

14.1 Regelmäßige Wartung

• Täglich: Batteriestände prüfen
• Wöchentlich: Leaderboard zurücksetzen (falls gewünscht)
• Monatlich: OTA Update prüfen
• Jährlich: Firmware aktualisieren

14.2 Firmware-Updates

1. Lizenz Level 2+ erforderlich
2. Einstellungen → OTA Update
3. Keine Unterbrechung während des Updates
4. Update dauert ca. 1-2 Minuten

15. Support & Kontakt

Bei Fragen oder Problemen:

• Dokumentation prüfen
• Troubleshooting-Abschnitt beachten
• System-Informationen für Support bereitstellen

16. Anhang

16.1 Tastenkombinationen im Web-Interface

• Enter in UID-Feld: Sprung zum Namensfeld
• Browser-Refresh: Aktualisiert alle Daten

16.2 Unterstützte Browser

• Chrome/Edge (empfohlen)
• Firefox
• Safari
• Mobile Browser (iOS/Android)

16.3 Technische Spezifikationen

Ende der Bedienungsanleitung
NinjaCross Timer v1.0