diff --git a/laser_tracking_cli_tool/README.md b/laser_tracking_cli_tool/README.md new file mode 100644 index 0000000..4e1da56 --- /dev/null +++ b/laser_tracking_cli_tool/README.md @@ -0,0 +1,126 @@ +# laser_tracking_cli_tool + +**WICHTIGER HINWEIS – ALLE INHALTE SIND EXPERIMENTELL UND KI-GENERIERT** + +## Warnung + +Dieses Kommandozeilenprogramm wurde vollständig von einer KI generiert. +Es ist rein experimentell und wurde in **KEINER** Weise auf Sicherheit, +Korrektheit oder Robustheit geprüft. + +- **KEIN PRODUKTIVEINSATZ!** +- **KEINE GARANTIE FÜR FUNKTIONALITÄT ODER SICHERHEIT!** +- Kann Abstürze, Speicherfehler, undefiniertes Verhalten oder + Sicherheitslücken verursachen +- Nur für Lern-, Demonstrations- und Forschungszwecke gedacht + +## Beschreibung + +`laser_tracking` ist ein kleines, simuliertes CLI-Tool in C, das ein +Laser-Tracking-System für Satelliten nachbildet. Es steuert **keine** +reale Hardware, sondern erzeugt lediglich plausible Statuswerte. + +Es orientiert sich lose an einem Experiment zur Messung von +Laserreflexionen von Satelliten und kann genutzt werden, um typische +CLI-Abläufe (Starten eines Trackings, Statusabfragen) zu demonstrieren. + +## Sicherheit + +Dieses Programm simuliert nur ein Tracking-System, trotzdem gilt: + +- Führen Sie reale Laserexperimente nur mit geeigneter Schutzbrille und + ausschließlich mit Geräten im zulässigen Leistungsbereich (z. B. + < 5 mW) durch. +- Achten Sie bei eigenen Experimenten darauf, dass weder Personen noch + Fahrzeuge in einen eventuellen Strahlbereich geraten. +- Beachten Sie gesetzliche Vorgaben und holen Sie ggf. erforderliche + Genehmigungen ein. + +## Build + +Voraussetzungen: + +- Linux-Umgebung +- GCC oder kompatibler C-Compiler +- Make + +Build-Schritte: + +```bash +make +``` + +Dadurch entsteht das Binary: + +- `./laser_tracking` + +Aufräumen: + +```bash +make clean +# oder vollständig: +make distclean +``` + +## Nutzung + +Allgemeine Hilfe: + +```bash +./laser_tracking --help +``` + +### Globale Optionen + +- `-h`, `--help` – Hilfe anzeigen +- `-v`, `--version` – Version ausgeben +- `-q`, `--quiet` – weniger Ausgaben +- `--debug` – Debug-Ausgaben aktivieren +- `--seed N` – Zufalls-Seed setzen (z. B. für reproduzierbare Simulationen) + +### Kommandos + +#### `start` + +Startet ein simuliertes Tracking für einen Satelliten. + +```bash +./laser_tracking start --sat COMM-SAT-RX --elev 67 +``` + +Optionen: + +- `--sat NAME` – Name/ID des Ziel-Satelliten +- `--elev WINKEL` – Elevationswinkel in Grad (0.0–90.0) + +Beispielausgabe: + +```text +tracking – target=COMM-SAT-RX, elev=67.00deg +Tracking simuliert gestartet. Status: + active : yes + last_update : 2026-01-01 23:45:11 CET + deviation : 0.0300 deg +``` + +#### `status` + +Gibt einen aktuellen, simulierten Tracking-Status aus. + +```bash +./laser_tracking status +``` + +Beispielausgabe: + +```text +Tracking-Status: + active : yes + last_update : 2026-01-01 23:59:59 CET + deviation : 0.0500 deg +``` + +## Lizenz + +Dieses Projekt ist experimentell. Verwenden Sie den Code ausschließlich +auf eigene Verantwortung für Lern- und Demonstrationszwecke.