diff --git a/Bedienungsanleitung_NinjaCross_Timer.html b/Bedienungsanleitung_NinjaCross_Timer.html new file mode 100644 index 0000000..a8ed284 --- /dev/null +++ b/Bedienungsanleitung_NinjaCross_Timer.html @@ -0,0 +1,674 @@ + + + + +NinjaCross Timer - Bedienungsanleitung + + + + + +

NinjaCross Timer - Bedienungsanleitung

+ +
+

Version: 1.0

+

Hersteller: AquaMaster MQTT

+

Datum: 2024

+
+ +

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

+ + + +

2.2 Anzeigen und Status

+ + + + + + + + + + + + + + + + + + + + + + + + + + +
KomponenteBeschreibung
Heartbeat-Indikatoren4 grüne/rote Punkte zeigen die Verbindung der Buttons an (Start1, Stop1, Start2, Stop2)
Timer-AnzeigeLive-Zeit für beide Bahnen
Status-AnzeigeBereit, Läuft, Geschafft, Standby
LeaderboardTop 6 Zeiten lokal gespeichert
Batterie-WarnungBanner bei niedriger Batterie der Buttons
+ +

3. Erste Inbetriebnahme

+ +

3.1 Einschalten und Netzwerkverbindung

+ +
    +
  1. Einschalten: Master einschalten
    2. +
  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. +
  3. Verbinden: Das Netzwerk ist standardmäßig ohne Passwort
    4. +
  4. IP-Adresse: Das Gerät hat die feste IP 192.168.10.1
    5. +
  5. Alternative: Sie können auch ninjacross.local im Browser verwenden (mDNS)
    6. +
+ +
+

Wichtig: Der Access Point benötigt kein Passwort.

+
+ +

3.2 Web-Interface öffnen

+ +

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

+ + + +

4. Hauptoberfläche

+ +

4.1 Timer-Ansicht

+ +

Die Hauptseite zeigt:

+ + + +

4.2 Timer-Bedienung

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

Tipp: Die Anzeige blendet automatisch die Schwimmer-Namen ein, wenn sie via RFID erkannt werden.

+
+ +

5. Button-Konfiguration

+ +

5.1 Anlernmodus

+ +

Der erste Schritt ist das Anlernen Ihrer Wireless-Buttons:

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

Erfolg: Nach dem Anlernen sollten alle 4 Heartbeat-Indikatoren grün leuchten.

+
+ +

5.2 Buttons verlernen

+ +

Um alle Button-Zuweisungen zu löschen:

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

5.3 Button-Status anzeigen

+ +

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

+ + + +

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. +
  2. Klicken Sie auf "📡 Read Chip"
    3. +
  3. Halten Sie die RFID-Karte an den Reader des Masters
    4. +
  4. Die UID wird automatisch eingefügt
    5. +
  5. Geben Sie den Namen ein
    6. +
  6. Klicken Sie auf "💾 Speichern"
    7. +
+ +
+

Funktionsweise: Beim nächsten Scannen der RFID-Karte an einem Button wird automatisch der Name angezeigt und die Zeit diesem Nutzer zugeordnet.

+
+ +

6.2 Kontinuierliches Lesen

+ +

Der "Read Chip" Button startet einen kontinuierlichen Lesemodus:

+ + + +

7. Einstellungen

+ +

7.1 Datum & Uhrzeit

+ +

Die Uhrzeit kann manuell oder automatisch gesetzt werden:

+ + + +

7.2 Modus

+ + + + + + + + + + + + + + +
ModusBeschreibung
👤 IndividualBeide Bahnen arbeiten unabhängig - ideale für Training
🏆 WettkampfBeide Bahnen starten synchron - für Wettkämpfe
+ +

7.3 Lane-Konfiguration

+ +

Die Bahnen können identisch oder unterschiedlich konfiguriert werden:

+ + + +

7.4 Grundeinstellungen

+ + + + + + + + + + + + + + + + + + + + + + +
EinstellungStandardBeschreibung
Maximale Zeit300 SekundenNach dieser Zeit wird eine Bahn automatisch zurückgesetzt
Anzeigedauer20 SekundenWie lange die letzte Zeit angezeigt bleibt
Min. Zeit Leaderboard5 SekundenZeiten unter diesem Wert werden nicht gespeichert (Missbrauchsschutz)
+ +

7.5 WLAN-Konfiguration (Lizenz Level 3 erforderlich)

+ +
+

Wichtig: Um das System mit einem bestehenden WLAN zu verbinden wird eine Lizenz Level 3 oder höher.

+
+ +

Zur Konfiguration:

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

Dual-Mode: Das Gerät kann gleichzeitig Access Point (für direkte Verbindung) und WiFi Station (für Internet) betreiben.

+
+ +

7.6 Standort (Lizenz Level 3 erforderlich)

+ +

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

+ + + +

7.7 OTA Update (Lizenz Level 2 erforderlich)

+ +
+

Lizenz erforderlich: OTA-Updates benötigen Lizenz Level 2 oder höher.

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

7.8 Buttons Updaten

+ +

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

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

8. Leaderboard

+ +

8.1 Lokales Leaderboard

+ +

Die Hauptseite zeigt die Top 6 Zeiten:

+ + + +

8.2 Volle Leaderboard-Ansicht

+ +

Öffnen Sie die Leaderboard-Seite (🏆):

+ + + +

8.3 Beste Zeiten zurücksetzen

+ +

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

+ +
+

Achtung: Diese Aktion kann nicht rückgängig gemacht werden!

+
+ +

9. System-Information

+ +

Die Einstellungsseite zeigt folgende Systemdaten:

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
InformationBeschreibung
IP-AdresseAccess Point IP (meist 192.168.10.1)
KanalWiFi-Kanal
MAC-AdresseEindeutige Geräte-ID
InternetJa/Nein - Verbindung zum Internet
Freier SpeicherVerfügbarer RAM in Bytes
Verbundene ButtonsAnzahl konfigurierter Buttons (0-4)
Lizenz gültigStatus der Lizenz
Lizenz Level0-3 - Bestimmt verfügbare Features
+ +

10. Lizenz-System

+ +

10.1 Lizenz-Level

+ + + + + + + + + + + + + + + + + + + + + + +
LevelFeatures
0 (Basis)Standard-Timer, lokales Leaderboard, RFID
1Alle Level 0 Features
2Level 1 + OTA Updates
3Level 2 + WLAN-Station Mode, Standort-Konfiguration
+ +

10.2 Lizenz eingeben

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

11. Batterie-Überwachung

+ +

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

+ + + +
+

Tipp: Der Banner blendet automatisch aus, sobald alle Batterien wieder über 15% sind.

+
+ +

12. API & Technische Details

+ +

12.1 API-Endpunkte

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
EndpointMethodFunktion
/api/dataGETTimer und Status abrufen
/api/reset-bestPOSTBeste Zeiten zurücksetzen
/api/start-learningPOSTAnlernmodus starten
/api/learn/statusGETAnlern-Status abrufen
/api/buttons/statusGETButton-Konfiguration und Batterie
/api/set-max-timePOSTTimer-Einstellungen setzen
/api/get-settingsGETEinstellungen abrufen
/api/set-wifiPOSTWiFi konfigurieren
/api/set-modePOSTModus setzen (Individual/Wettkampf)
/api/infoGETSystem-Informationen
/wsWebSocketLive-Updates für Timer
+ +

12.2 WebSocket-Daten

+ +

Der WebSocket liefert Echtzeit-Updates:

+ + + +

13. Troubleshooting

+ +

13.1 Buttons verbinden sich nicht

+ + + +

13.2 WiFi-Verbindung funktioniert nicht

+ + + +

13.3 IP-Adresse unbekannt

+ + + +

13.4 Timer startet nicht

+ + + +

13.5 RFID wird nicht erkannt

+ + + +
+

Wichtig: Bei andauernden Problemen Gerät neustarten oder Support kontaktieren.

+
+ +

14. Wartung

+ +

14.1 Regelmäßige Wartung

+ + + +

14.2 Firmware-Updates

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

15. Support & Kontakt

+ +

Bei Fragen oder Problemen:

+ + + +
+

Hinweis: Diese Anleitung basiert auf der aktuellen Firmware-Version. Neuere Versionen könnten abweichende Features haben.

+
+ +

16. Anhang

+ +

16.1 Tastenkombinationen im Web-Interface

+ + + +

16.2 Unterstützte Browser

+ + + +

16.3 Technische Spezifikationen

+ + + + + + + + + + + + + + + + + + + + + + + + + + +
KomponenteSpezifikation
ESP32 VersionESP32-WROOM oder kompatibel
WiFi2.4 GHz, WPA2
ProtokollMQTT für Kommunikation
RFID13.56 MHz, NFC-kompatibel
Timer-GenauigkeitMillisekunden
+ +
+ +

+Ende der Bedienungsanleitung
+NinjaCross Timer v1.0 +

+ + +