Pi Race Timer

Der Pi Race Timer ist ein Rennzeitmesssystem, das auf einem Raspberry Pi läuft. Es bietet eine vollständige Lösung zur Messung von Rundenzeiten, der Verwaltung von Fahrern, der Konfiguration von Lichtschranken und bietet ein Webinterface für die Steuerung und Anzeige der Rennzeiten. Der Timer funktioniert mit einer Start- und optional einer Ziellichtschranke, welche über GPIO-Pins des Raspberry Pi ausgelöst werden.

Funktionen

• Start- und Ziel-Lichtschranken: Benutze GPIO-Pins zur Erfassung von Rundenzeiten.
• Runden- und Bestzeiten: Anzeige der aktuellen Runde, Bestzeit und Durchschnittszeit.
• Fahrerverwaltung: Zuordnung von Rundenzeiten zu Fahrern.
• Benutzerdefinierte Rundenanzahl: Anzahl der Runden ist einstellbar.
• Ziel erreicht: Zeigt eine Zielflagge, wenn das Rennen beendet ist.
• Webinterface: Vollständige Steuerung und Anzeige über ein responsives Webinterface.
• Safety Mode & Unterbrechung: Ermöglicht das Anhalten und Fortsetzen des Rennens.
• systemd-Dienst: Der Timer läuft als systemd-Dienst und startet automatisch mit dem Raspberry Pi.

Anforderungen

• Hardware:
  • Raspberry Pi 4
  • Lichtschranken und GPIO-Trigger
• Software:
  • Raspberry Pi OS (Bookworm empfohlen)
  • Python 3.11 oder höher

Installation

Um das Projekt zu installieren, kannst du den folgenden Shell-Befehl ausführen:

curl https://git.geigernet.eu/rainer/pi-race-timer/raw/branch/main/install.sh | bash

Dieser Befehl wird das Repository auf deinen Raspberry Pi klonen, eine virtuelle Umgebung einrichten, alle erforderlichen Python-Abhängigkeiten installieren und den Pi Race Timer als systemd-Dienst einrichten.

Nutzung

1. Projekt starten:

   • Nach der Installation kannst du das Webinterface unter http://:5000 erreichen.

2. Fahrerverwaltung:

   • Füge Fahrer hinzu, wähle Startnummern und konfiguriere die Fahrerfarben.

3. Starten des Rennens:

   • Wähle die Anzahl der Runden und starte das Rennen.
   • Während des Rennens werden die Zeiten für jede Runde sowie Best- und Durchschnittszeiten angezeigt.

4. Lichtschranken:

   • Konfiguriere die Start- und Ziel-Lichtschranken über das Webinterface.

5. Einstellungen/Verwaltung:

   • In den Admin-Einstellungen kannst du die GPIO-Pins für die Lichtschranken anpassen, den systemd-Dienst neu starten oder das System herunterfahren.

Troubleshooting

• Probleme mit den GPIO-Pins: Vergewissere dich, dass der Raspberry Pi korrekt konfiguriert ist und dass keine anderen Prozesse auf die GPIO-Pins zugreifen.
• Systemd-Dienst: Wenn der Dienst nicht startet, überprüfe die Logs mit journalctl -u pi-race-timer für Fehler.

Lizenz

Dieses Projekt steht unter der MIT-Lizenz - siehe die LICENSE Datei für Details.