add ROT1Prog PDF and extend manual-based docs

README.md

@@ -72,6 +72,7 @@ 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`, `docs/rotor-alfaspid-rak-rot1prog-manual-notes.md`
+- Manufacturer PDF copy: `docs/RAK_Rot1Prog.pdf`
 
 VSWR
 - `rms.vswr.native`: native VSWR command provider

WORKING_CONTEXT.md

@@ -60,3 +60,4 @@ Expected priority order:
   - `docs/rotor-alfaspid-rak-rot1prog-manual-notes.md`
 - Linked the new notes page from `README.md` under RF/Hardware guides.
 - Expanded `docs/rotor-rot1prog-guide.md` into a full end-to-end setup/calibration/runbook guide.
+- Added local PDF copy `docs/RAK_Rot1Prog.pdf` and integrated additional manual details (modes, setup items, comms, reset/overtravel, 208-condition).

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

@@ -4,6 +4,8 @@ Diese Seite dokumentiert den externen Herstellerleitfaden fuer den AlfaSpid RAK/
 
 - Original-Link: `https://de.scribd.com/document/274143783/AlfaSpid-RAK-Rot1Prog-Manual`
 - Titel auf Scribd: "AlfaSpid Rotator Instruction Manual"
+- Repo-Kopie (PDF): `docs/RAK_Rot1Prog.pdf`
+- Weitere Quelle: `https://www.manualslib.com/manual/3642184/Alfaradio-Alfa-Rot1prog.html`
 
 Wichtig: Diese Datei ist eine technische Zusammenfassung/Einordnung. Fuer vollstaendige Herstellervorgaben (Verdrahtung, Grenzwerte, Modusdetails) immer die Originalanleitung verwenden.
 

docs/rotor-rot1prog-guide.md

@@ -230,3 +230,111 @@ Vor Go-Live einmal komplett:
 
 - Hamlib Plugin: `docs/plugins/rms-rotor-hamlib.md`
 - Hersteller-Referenzhinweis: `docs/rotor-alfaspid-rak-rot1prog-manual-notes.md`
+- Vollstaendiges Hersteller-PDF im Repo: `docs/RAK_Rot1Prog.pdf`
+
+## 16) Herstellerdetails aus ROT1Prog-Manual (15 SEP 2022)
+
+Die folgenden Punkte sind explizit aus der Controller-Anleitung uebernommen und fuer RMS-Betrieb relevant.
+
+### 16.1 Controller-Funktionen und Eckdaten
+
+- Digitale Anzeige mit 1-Grad-Aufloesung.
+- Versorgung: `13.8..18 V` bei ca. `3..8 A`.
+- Elektronische Overtravel-Range: insgesamt `720 Grad` (normal 360 + je 180 Overtravel links/rechts).
+- Programmierbare Limits (u. a. fuer Side-Mount).
+- USB-Schnittstelle fuer PC-Steuerung.
+- Optionales Mouse-Panel mit L/R/Stop und 6 Preset-Tasten.
+
+### 16.2 Front-/Back-Hinweise
+
+- Front: L/R-Tasten, Setup-/Function-Tasten, 4-stellige Anzeige, Overlap-Indikator.
+- Legacy-Serienversion (nicht mehr produziert):
+  - 4-Pin Rotatoranschluss: Pin 1/2 Motor Drive, Pin 3/4 Impulse Sense.
+  - Blue/Brown Motorleitungen sind laut Manual in der Polaritaet unkritisch.
+
+### 16.3 Setup-Menuepunkte (ROT1Prog)
+
+Der Setup-Dialog durchlaeuft u. a. diese Parameter:
+
+- Ratio: `1.00` (Default) bzw. `0.80` bei Ring-Version.
+- Programmierbares High Limit (clockwise).
+- Programmierbares Low Limit (counter-clockwise).
+- Programmierbarer Reset-Wert (`0` oder `180`).
+- Presets `P1..P6`.
+- Program Simulation (Emulation).
+- Heading Adjust (blinkende Zahlen).
+
+### 16.4 Program Simulation / Emulation
+
+Im Manual aufgefuehrte Simulationsmodi:
+
+- `Spid`
+- `Orion`
+- `Hygain`
+- `Yaesu`
+
+Manual-Hinweis: Alfa empfiehlt die Fremdprotokolle nicht aktiv zu supporten; ausserdem koennen manche Programme mit den seriellen Anforderungen nicht sauber arbeiten.
+
+### 16.5 PC-Kommunikation
+
+- Serielle Einstellungen: `1200-8-N-1`.
+- USB-Version mit FTDI `FT232RL`.
+- Linux-Portsuche laut Manual:
+  - `ls /dev/ttyUSB*`
+- macOS-Portsuche laut Manual:
+  - `ls /dev/tty.*`
+
+### 16.6 Betriebsmodi
+
+Laut Manual sind folgende Modi vorgesehen:
+
+- Normal Operations Mode
+- Half Auto Mode
+- Auto Mode
+- Preset Mode (mit optionaler Mouse)
+
+Kurzlogik:
+
+- **Normal**: L/R fahren solange Taste gedrueckt ist.
+- **Half Auto**: Zielrichtung vorwaehlen, nach kurzer Inaktivitaet beginnt automatische Fahrt.
+- **Auto**: Befehle von PC-Software; manuelle Tasten als Override.
+- **Preset**: Preset-Tasten fahren auf gespeicherte Headings.
+
+### 16.7 Reset/Kalibrierung und Overtravel-Anzeige
+
+Manual-Kernpunkte:
+
+- Beim Reset wird nicht automatisch alles auf "True North" gezwungen; Kalibrierung erfolgt bewusst.
+- Reset-Prozedur beeinflusst nicht automatisch Presets/Limits.
+- Overtravel-Indikator:
+  - steady dot fuer eine Seite,
+  - blinking dot fuer die andere Overtravel-Seite.
+
+Fuer RMS bedeutet das: Controller-Referenz immer dokumentieren und nach Servicearbeiten reproduzierbar neu anfahren.
+
+### 16.8 208-Condition (Manual-Fehlerbild)
+
+Die Anleitung beschreibt einen Sonderfall, bei dem der Controller scheinbar ohne Nutzerkommando auf `208` Grad fahren kann (Command-Flood/Overload-Szenario).
+
+Praxisregel fuer RMS:
+
+- Kommandos nicht unnoetig dicht hintereinander feuern.
+- Bei Automationspfaden kleine Guard-Delays einplanen.
+- Bei reproduzierbarem Verhalten zuerst lokale Controllerbedienung und Sense-Leitung pruefen.
+
+### 16.9 Motor-Sense/Schutzhinweis
+
+Laut Manual wird bei fehlender Sense-Rueckmeldung der Motor durch Schutzlogik abgeschaltet.
+
+- Symptom: Motor startet kurz und stoppt wieder.
+- Pruefen: Sense-/Reed-Wiring und mechanische Blockade.
+
+### 16.10 Warranty/Service-Hinweis
+
+Die Anleitung enthaelt 12-Monats-Gewaehrleistung mit einschraenkenden Bedingungen (u. a. kein Schutz bei Fremdgeraetekombination, Blitz, Fehlbedienung etc.).
+
+Fuer RMS-Dokumentation bleibt entscheidend:
+
+- Bei Hardwareauffaelligkeiten zuerst Bench-Test auf Controllerseite,
+- dann RMS-Integration getrennt validieren,
+- und Servicefaelle inkl. Kaufnachweis dokumentieren.