Das Team-Cockpit

Das Team-Cockpit zeigt eure Lichtstrecke live im Browser: oben, was eure LED sendet, darunter, was euer Sensor misst, beides auf einer gemeinsamen Zeitachse. Es ist euer wichtigstes Werkzeug für die Fehlersuche, denn die meisten Probleme sieht man hier auf einen Blick: Wechselt das Senderband korrekt, aber die Kurven rühren sich nicht, stimmt etwas an Ausrichtung oder Abstand. Zappeln die Kurven im Takt der Farben, aber euer Programm erkennt trotzdem nichts, liegt der Fehler in euren Schwellen oder eurem Timing.

Öffnen

Team CockpitYour link, live: what your LED sends and what your sensor measures, on one shared timeline. If the two do not match, you are looking at your bug.LiFi Project

Beim ersten Aufruf fragt es nach eurem Teamnamen; danach steht er in der Adresse (etwa .../cockpit?team=team-07), ihr könnt euch die Seite also als Lesezeichen speichern oder den Link im Team teilen. Über „switch team” oben rechts wechselt ihr das Team.

Die Daten kommen automatisch: Sobald euer Programm das Modul lifi_hardware benutzt, sendet es sein Messprotokoll an den Kursserver, und das Cockpit zeigt es an. Ihr müsst dafür nichts konfigurieren.

Die Statuszeile

Oben stehen sechs Werte, die sich laufend aktualisieren: ob gerade Daten ankommen („live”) oder wann zuletzt, die aktuelle LED-Farbe mit Farbmuster, die letzte Messung (die vier Kanäle r, g, b und c), die Messungen pro Sekunde, die eingestellte Verstärkung und Integrationszeit, und der letzte Fehler, falls euer Programm abgestürzt ist.

Die Zeitleiste lesen

Die große Fläche ist eine Zeitleiste, die von Sekunden bis zum ganzen Semester reicht. Was sie zeigt, hängt vom Zoom ab:

Nah herangezoomt (bis etwa 15 Minuten Fensterbreite) seht ihr das Rohsignal: oben das Senderband, in dem jeder Block genau die Farbe hat, die die LED zu dieser Zeit gezeigt hat, darunter die vier Sensorkanäle als Kurven. Der Clear-Kanal (c, die helle Linie) ist der empfindlichste. Gestrichelte senkrechte Marken zeigen, wo eine Sitzung begann oder endete und wo Einstellungen geändert wurden; rote Marken sind Programmabstürze.

Weit herausgezoomt wird dieselbe Fläche zur Aktivitätsübersicht: blaue Balken zeigen, wann und wie intensiv gearbeitet wurde (je höher und heller, desto mehr Messungen), rote Striche darüber markieren Zeiträume mit Fehlern. So findet ihr auch nach Tagen noch die Stelle wieder, an der etwas Interessantes passiert ist.

Unter der Fläche läuft immer eine Achse mit Uhrzeit und Datum mit, und über der Fläche steht der sichtbar gemachte Zeitraum samt Dauer, damit ihr nie raten müsst, wo ihr euch gerade befindet.

Bewegen und Zoomen

Die Bedienung folgt dem, was ihr aus Videoschnitt- oder Kartenprogrammen kennt:

• Scrollrad zoomt hinein und heraus, und zwar um die Stelle, auf die der Mauszeiger zeigt.
• Doppelklick auf einen blauen Aktivitätsbalken springt direkt in dessen Zeitraum; anderswo zoomt er kräftig um die Klickstelle.
• Ziehen mit gedrückter Maustaste verschiebt das Fenster in der Zeit.
• Mauszeiger darüberhalten zeigt Details: über dem Senderband die genauen RGB-Werte und seit wann die Farbe anliegt, über den Kurven die nächstgelegene Messung mit allen vier Werten und Zeitstempel, über Marken deren Bedeutung.
• Die Knöpfe 30 s / 5 min / 1 h / 24 h / all springen zu festen Fenstern, + / − zoomen schrittweise.

Sobald ihr in die Vergangenheit zoomt oder zieht, hält die Ansicht an. Der grüne Knopf „● live” bringt euch zurück ins Jetzt, wo die rechte Kante wieder mit der Uhr mitläuft.

Wenn nichts ankommt

Steht im Status dauerhaft „no data yet”, prüft der Reihe nach: Läuft euer Programm gerade, und benutzt es lifi_hardware? Stimmt der Teamname in der Adresse? Hat euer Rechner Internet? Ohne Netz arbeitet euer Programm übrigens völlig normal weiter, nur das Cockpit bleibt dann leer; alles Wichtige steht weiterhin in eurer lokalen Protokolldatei lifi_log.jsonl. Und falls euer Gerät noch keinem Team zugeordnet ist, meldet euch; das ist in einer Minute erledigt.

Was noch kommt

Das Cockpit wächst im Lauf des Semesters: Hier werden später eure Übungstests für die Challenges starten, und bei den Abnahmen läuft dieselbe Ansicht groß auf dem Beamer. Wie das funktioniert, ergänzen wir auf dieser Seite, sobald es so weit ist.