Aquarius MMX

h1. Zeitmessprotokoll

Neben der Unterstützung für Software-Protokollen von Hardware-Herstellern, wie Omega oder Tag Heuer, zwecks Unterstützung von Zielkameras oder hoch-präzisen Uhren bietet Aquarius ein Software-Protokoll mit dem sich Zeitmessung umsetzen lässt. Das Protokoll lässt sich unabhängig vom Transportmedium (TCP/IP, serielle Schnittstelle) unter @Datei -> Verbindungseinstellungen@ einrichten.

h2. Datenformat

Daten werden im Protokoll zeilenweise übertragen. Als Zeilenumbruch werden sowohl CR-LF-Sequenzen (vgl. ASCII-Code) und einzelne CR-Zeichen akzeptiert. Gesendet werden immer CR-LF-Sequenzen. 

Eine Zeile, die an Aquarius gesendet wird, besteht aus einem Kommando und optionalen Argumenten. Argumente werden durch Leerzeichen voneinander getrennt und vom Kommando getrennt. Argumente bestehen aus Schlüssel-Wert-Paaren. Dem Namen (Schlüssel) des Argumente folgt ein "=", darauf der jeweilige Wert. 

Beispiel: @COMMAND arg1=value1 arg2=value2@

Antworten (sofern vorgesehen) werden von Aquarius ebenfalls zeilenweise gesendet. Eine Leerzeile folgt einer mehrzeiligen Antwort und deren Ende zu signalisieren. 

Groß- und Kleinschreibung ist grundsätzlich relevant.

h2. Kommandos

h3. Status-Abfrage

Mit dem Kommando @STATUS@ (keine Argumente) werden die gestarteten Läufe und die gestarteten Boote abgefragt. Die Antwort enthält so viele Zeilen (ohne abschließende Leerzeile) wie gestartete Boote vorliegen. Neben der Laufnummer werden die (individuelle) Startzeit, Startbahn und Startnummer übermittelt der Boote übermittelt. Die Startzeit wird im Format @hh:mm:ss.ddd@ (ddd = Tausendstel der Sekunde) übertragen. Die Angaben sind durch ein einzelnes Leerzeichen voneinander getrennt. 

Beispiel: @TODO@

h3. Zeitmessdaten senden

@TODO@