add AlfaSpid ROT1Prog manual reference notes

README.md

@@ -71,7 +71,7 @@ TX/PTT/Audio
 RF/Hardware
 - `rms.rfroute.shell`: RF route switching via shell commands
 - `rms.rotor.hamlib`: rotor control via hamlib/rotctl
-- Hardware guides: `docs/hardware-rfroute-guide.md`, `docs/rotor-rot1prog-guide.md`
+- Hardware guides: `docs/hardware-rfroute-guide.md`, `docs/rotor-rot1prog-guide.md`, `docs/rotor-alfaspid-rak-rot1prog-manual-notes.md`
 
 VSWR
 - `rms.vswr.native`: native VSWR command provider

WORKING_CONTEXT.md

@@ -1,6 +1,6 @@
 # Working Context
 
-Last updated: 2026-03-16
+Last updated: 2026-03-18
 
 ## Purpose
 
@@ -53,3 +53,9 @@ Expected priority order:
 
 - Access token default/minimum baseline is 3 hours.
 - OpenWebRX+ integrations remain plugin- and deploy-driven; station-specific profile/bandplan data stays outside this repo.
+
+## Recent Doc Update
+
+- Added external-reference notes for AlfaSpid RAK/ROT1Prog manual:
+  - `docs/rotor-alfaspid-rak-rot1prog-manual-notes.md`
+- Linked the new notes page from `README.md` under RF/Hardware guides.

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`