satellite_laser_echo_experi.../laser_tracking_cli_tool/README.md

2.8 KiB
Raw Permalink Blame History

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

Beispielausgabe:

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.