dj7nt/qo100wc
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Update

Browse Source
This commit is contained in:
Joerg
2026-06-12 07:48:02 +02:00
parent 44e392d19d
commit 96db177fd3
1 changed files with 93 additions and 7 deletions
Download Patch File Download Diff File Expand all files Collapse all files
README.md
+93 -7
View File
@@ -1,17 +1,40 @@
# DJ7NTs QO100 Webconsole # DJ7NTs QO-100 Web SDR Transceiver Console
> **Disclaimer:** This is a proof-of-concept project. Use at your own risk — no guarantees or warranties of any kind. The source code is not fully open-source at this time. > **Disclaimer:** This is a proof-of-concept project. Use at your own risk — no guarantees or warranties of any kind. The source code is not fully open-source at this time. FT8/FT4 digital modes are **experimental**.
## Features
- **Voice SSB** — USB with full DSP chain (NR, AGC, 5-band EQ, notch filter)
- **CW** *(experimental)*— TX with 10 ms envelope ramp
- **FT8 / FT4** *(experimental)* — server-side encode/decode, WSJT-X-style autosequencer, dual-mode decode
- **Multi-user** — admin, user, and guest roles; concurrent users with independent VFO
- **Wavelog integration** — automatic logging
- **Web-based** — no desktop app needed; all DSP runs server-side, browser handles audio I/O
## Supported Operating Modes
| Mode | Description |
|------|-------------|
| **QO-100** | Satellite operation with LNB conversion, beacon tracking (AFC), transponder frequency offset, and bandpass clamping |
| **Simple** | General-purpose SDR — direct frequency tuning, no LNB, no beacon tracking |
## Supported Hardware
| Device | Profile | Notes |
|--------|---------|-------|
| **Analog Devices PlutoSDR** (rev B/C, 2-channel) | `pluto` | GPIO + ADM1177 power monitor, native 576 kHz sample rate. GPS-DO recommended for TX stability; XIT compensates drift. Global TX offset configurable. |
| **AD9363-based clone** (e.g. LibreSDR) | `ad9363-clone` | No GPIO/ADM1177; requires linear-interpolation resampling to 576 kHz; auto-probes multiple sample rates. |
## Prerequisites ## Prerequisites
- Docker (any recent version) and Docker Compose - Docker (any recent version) and Docker Compose
- **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 - **Analog Devices PlutoSDR** (original rev.B/C — 2-channel version, one TX, one RX) or **AD9363-based clone** (e.g. LibreSDR) — 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 - **USB-to-Ethernet adapter** (100 Mbit) connected to the Pluto's USB OTG port, if using a Board without Ethernet — Gigabit adapters are not supported and may cause issues
- LNB connected to the PlutoSDR - LNB connected to the PlutoSDR
- 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. - Pluto should be GPS-DO stabilized. Currently there's only XIT to compensate drift. A global TX offset is available as an additional setting.
- The Pluto and the host running Docker must be on the same network - 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. The prebuilt image is available for **x86_64** (PCs/servers) and **arm64** (Raspberry Pi 4+, Rock 5 ITX). Docker automatically pulls the correct variant.
## Quick Start with Docker Compose ## Quick Start with Docker Compose
@@ -50,6 +73,69 @@ Start:
docker compose up -d docker compose up -d
``` ```
## Sidecar Architecture
The **sidecar** is a Go binary that bridges the server and the Pluto SDR hardware via [libiio](https://github.com/analogdevicesinc/libiio). It handles all I/Q streaming, TX/RX control, and hardware-specific configuration.
### Deployment Modes
| Mode | Description | Usage |
|------|-------------|-------|
| **Local** (default) | Sidecar runs on the host machine, communicates with Pluto over the network | `./pluto-sidecar <ip> --socket <path> --profile pluto` |
| **On-Pluto** | Cross-compiled ARM binary runs directly on the Pluto device. Lower latency, uses local IIO context. Auto-reconnects on errors. | `./pluto-sidecar-arm --local --profile pluto --listen :4242` |
The Docker image includes the sidecar and runs it in **local mode** automatically.
### On-Pluto Deployment
For lowest latency, the sidecar can run directly on the Pluto's ARM Cortex-A9. The ARM binary (`pluto-sidecar-arm`) is cross-compiled with a Docker buildx step and deployed to the Pluto via SSH/SCP. In this mode, the sidecar opens a local IIO context (no network I/O for IQ data) and listens on a TCP port for the server to connect.
### Binary Protocol
Control and data flow over separate channels using a binary frame protocol: `[type:u8][length:u32le][payload]`. The on-Pluto mode additionally supports async transport for low-latency TX.
## FT8 / FT4 Digital Modes *(Experimental)*
Server-side weak-signal digital modes using the `@e04/ft8ts` library (pure TypeScript port of WSJT-X). Both FT8 (15 s slots) and FT4 (7.5 s slots) are decoded simultaneously under a single "FT8/FT4" RX mode.
### Capabilities
- **Dual decode** — FT4 decoded every 7.5 s, FT8 every 15 s; messages tagged with mode
- **Autosequencer** — WSJT-X-style automatic QSO flow (CQ → reply → signal report → 73)
- **Auto mode** — when replying, automatically matches the decoded station's mode (FT8 or FT4)
- **Slot-aligned TX** — transmissions start at slot boundaries; early-TX window (≤2 s FT8 / ≤1.2 s FT4) allows quick autosequence replies
- **Dedicated UI** — waterfall display (2.93 Hz/bin), decode list with color coding, TX panel with message templates
### Signal Path
**RX:** SSB demod (3.2 kHz bandwidth) → HPF → LPF → decimate to 12 kHz → ring buffer → slot-boundary decode jobs (separate workers per mode, depth-3 OSD).
**TX:** `@e04/ft8ts` encode → 12 kHz audio → interpolate to 48 kHz → slot-scheduled → TX worker.
AGC, NR, EQ, and notch are bypassed for FTx — constant-amplitude GFSK signals must not be squashed.
## DSP Pipeline
All signal processing runs server-side (TypeScript/Bun). The browser only handles audio I/O and UI.
### RX
```
576 kHz I/Q
→ frequency shift → ×12 decimation → Hilbert transform → sideband select
→ DC blocker → notch filter → Ephraim-Malah noise reduction
→ AGC → 5-band EQ → low-pass filter → ×6 decimation → 8 kHz PCM → browser
```
### TX
```
48 kHz mic (browser)
→ jitter buffer → TX worker thread
→ mic gain → pre-filter → EQ → pre-emphasis → compressor → limiter → post-filter
→ SSB modulator → ×12 interpolation → 576 kHz I/Q → sidecar → Pluto
```
## First-Time Setup ## First-Time Setup
1. Open `http://<your-host>:3004` in a browser 1. Open `http://<your-host>:3004` in a browser
@@ -92,7 +178,7 @@ Changes trigger a reconnect to the SDR bridge.
### TX Lock ### TX Lock
A global transmit lock that, when enabled, blocks all users from transmitting (PTT, two-tone, etc.) and stops any active transmissions. A global transmit lock that, when enabled, blocks all users from transmitting (PTT, two-tone, FTx, etc.) and stops any active transmissions.
### Activity Log ### Activity Log