From f779ef9ef67d8473e64e1326040746ae3ec44843 Mon Sep 17 00:00:00 2001 From: OE6DXD Date: Wed, 18 Mar 2026 22:36:25 +0100 Subject: [PATCH] add AlfaSpid ROT1Prog manual reference notes --- README.md | 2 +- WORKING_CONTEXT.md | 8 +++- ...otor-alfaspid-rak-rot1prog-manual-notes.md | 46 +++++++++++++++++++ 3 files changed, 54 insertions(+), 2 deletions(-) create mode 100644 docs/rotor-alfaspid-rak-rot1prog-manual-notes.md diff --git a/README.md b/README.md index 4362e0a..f2958c8 100644 --- a/README.md +++ b/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 diff --git a/WORKING_CONTEXT.md b/WORKING_CONTEXT.md index 26474c1..ec1cede 100644 --- a/WORKING_CONTEXT.md +++ b/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. diff --git a/docs/rotor-alfaspid-rak-rot1prog-manual-notes.md b/docs/rotor-alfaspid-rak-rot1prog-manual-notes.md new file mode 100644 index 0000000..5a77d27 --- /dev/null +++ b/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`