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