add AlfaSpid ROT1Prog manual reference notes

docs/rotor-alfaspid-rak-rot1prog-manual-notes.md

@@ -0,0 +1,46 @@
+# AlfaSpid RAK/ROT1Prog Manual (Kurz-Doku fuer RMS)
+
+Diese Seite dokumentiert den externen Herstellerleitfaden fuer den AlfaSpid RAK/ROT1Prog Controller und ordnet ihn in den RMS-Betrieb ein.
+
+- Original-Link: `https://de.scribd.com/document/274143783/AlfaSpid-RAK-Rot1Prog-Manual`
+- Titel auf Scribd: "AlfaSpid Rotator Instruction Manual"
+
+Wichtig: Diese Datei ist eine technische Zusammenfassung/Einordnung. Fuer vollstaendige Herstellervorgaben (Verdrahtung, Grenzwerte, Modusdetails) immer die Originalanleitung verwenden.
+
+## Inhalt der Herstelleranleitung (laut Dokumentbeschreibung)
+
+Die Anleitung behandelt insbesondere:
+
+- Lieferumfang und grundlegende technische Daten
+- Installation inkl. Verdrahtung/Anschluesse
+- Bench-Test Inbetriebnahme
+- Reset-Prozeduren
+- Betriebsmodi (Normal, Half Auto, Auto, Preset)
+- Setup von Limits und Presets
+- Hinweise fuer laengere Kabelwege
+
+## Relevanz fuer RMS
+
+In RMS wird der Rotor nativ ueber Hamlib/`rotctl` betrieben (typisch Modell-ID `902`).
+
+- Herstelleranleitung -> Hardware/Kalibrierung/Controller-Parameter
+- RMS-Doku -> API/Queue/Guarding/Runtime-Verhalten
+
+Empfohlene Reihenfolge bei Neuaufbau:
+
+1. Hardware und Controller gemaess Herstelleranleitung verdrahten und grundkonfigurieren.
+2. Bench-Test auf Controller-Ebene erfolgreich abschliessen.
+3. Danach RMS-Integration gem. `docs/rotor-rot1prog-guide.md` umsetzen.
+4. Abschliessend Set/Status-Endpunkte in RMS/OpenWebRX verifizieren.
+
+## Mapping Hersteller -> RMS Betrieb
+
+- **Limits/Endanschlaege**: zuerst im Controller korrekt setzen; RMS erwartet valide Positionsrueckmeldung.
+- **Presets am Controller**: optional nutzbar, RMS steuert jedoch primaer ueber Winkelziele (`target`).
+- **Reset/Recover**: bei inkonsistenten Positionswerten zuerst Controllerzustand pruefen, dann RMS-Dienst neu starten.
+- **Lange Kabelwege**: beeinflussen Signalqualitaet; bei sporadischen Lesefehlern zuerst Verdrahtung/Controllerseite ausschliessen.
+
+## Verwandte RMS-Doku
+
+- Rotorbetrieb in RMS: `docs/rotor-rot1prog-guide.md`
+- Hamlib Plugin: `docs/plugins/rms-rotor-hamlib.md`