History

Mika 081b87b8d9 Add laser_tracking_cli_tool/README.md		2026-05-17 02:07:32 +00:00
..
src	Add laser_tracking_cli_tool/src/tracking.c	2026-05-17 02:07:31 +00:00
Makefile	Add laser_tracking_cli_tool/Makefile	2026-05-17 02:07:31 +00:00
README.md	Add laser_tracking_cli_tool/README.md	2026-05-17 02:07:32 +00:00

README.md

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:

make

Dadurch entsteht das Binary:

./laser_tracking

Aufräumen:

make clean
# oder vollständig:
make distclean

Nutzung

Allgemeine Hilfe:

./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.

./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:

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.

./laser_tracking status