From 44e392d19dca7460701823b6737b3b405229194e Mon Sep 17 00:00:00 2001 From: Joerg Date: Sat, 23 May 2026 19:03:56 +0200 Subject: [PATCH] Update doc --- README.md | 18 +++++++++++++----- 1 file changed, 13 insertions(+), 5 deletions(-) diff --git a/README.md b/README.md index 8d50809..4a7f9a6 100644 --- a/README.md +++ b/README.md @@ -5,10 +5,10 @@ ## Prerequisites - Docker (any recent version) and Docker Compose -- **Analog Devices PlutoSDR** (original rev.B/C - 2(!) Channel-Version (one TX, one RX)) — this image does **not** work with Pluto Plus, Hamgeek AD9363, LibreSDR, or other AD9363-based clones +- **Analog Devices PlutoSDR** (original rev.B/C - 2(!) Channel-Version (one TX, one RX)) or **AD9363-based clone** (e.g. LibreSDR) — device type is selected during setup - **USB-to-Ethernet adapter** (100 Mbit) connected to the Pluto's USB OTG port — Gigabit adapters are not supported and may cause issues - LNB connected to the PlutoSDR -- Original(!) 2channel-Pluto should be GPS-DO stabilized. Currently there's only a XIT to compensate it. Future Version may have a TX-Offset +- Original(!) 2channel-Pluto should be GPS-DO stabilized. Currently there's only a XIT to compensate it. As an additional Feature there's a global TX-Offset-Setting. - The Pluto and the host running Docker must be on the same network The prebuilt image is available for **x86_64** (PCs/servers) and **arm64** (Raspberry Pi 4+, Rock 5 ITX). Docker automatically pulls the correct variant for your hardware. @@ -54,13 +54,17 @@ docker compose up -d 1. Open `http://:3004` in a browser 2. Log in with **admin** / **admin** (you will be forced to change the password) -3. Navigate to **Setup** (or go to `/setup`) +3. You will be redirected to the **Setup** wizard (`/setup`) 4. Configure: + - **Device Type** — select your SDR hardware: ADALM Pluto (AD9364) or AD9363 Clone (LibreSDR) + - **Operating Mode** — `qo100` for satellite operation or `simple` for general-purpose SDR use - **PlutoSDR IP** — the IP address of your Pluto (default: `192.168.6.122`) - - **LNB LO Frequency** — the actual local oscillator frequency of your LNB in Hz. This is *not* the nominal 9750 MHz — e.g. my Bullseye TCXO LNB runs at `9749971700` Hz (9750 MHz minus ~28.3 kHz offset). If you use a different LNB, measure or look up its exact LO frequency. + - **LNB LO Frequency** — the actual local oscillator frequency of your LNB in Hz. This is *not* the nominal 9750 MHz — e.g. my Bullseye TCXO LNB runs at `9749971700` Hz (9750 MHz minus ~28.3 kHz offset). If you use a different LNB, measure or look up its exact LO frequency. (QO-100 mode only) + - **TX Calibration** — frequency calibration offset in Hz for transmitter accuracy + - **TX Offset** — fixed frequency offset applied to TX (e.g. for transverter configurations) 5. Click **Save and Connect** -To change these later, go to **Setup** as admin. +To change these later, go to **Setup** as admin (via the sidebar or `/setup`). ## Admin Page (`/admin`) @@ -76,9 +80,13 @@ The admin page provides full management of the webconsole. Only users with the * ### SDR Settings +- **Device Type** — select SDR hardware profile (Pluto or AD9363 clone) +- **Operating Mode** — `qo100` (satellite) or `simple` (general-purpose) - **PlutoSDR IP** — IP address of the Pluto (default: `192.168.6.122`) - **LNB LO Frequency** — exact local oscillator frequency in Hz (e.g. `9749971700` for a Bullseye TCXO) - **S-Meter Offset** — calibration offset from dBFS to dBm +- **TX Calibration** — transmitter frequency calibration in Hz +- **TX Offset** — fixed TX frequency offset in Hz Changes trigger a reconnect to the SDR bridge.