vfo-knob-aethersdr
The AetherSDR firmware
vfo-knob-aethersdr is a dial for AetherSDR,
talking to it over TCI, AetherSDR's own control protocol — so the knob is
not polling, it is told. Tune at the desktop and the knob follows; turn the
knob and the desktop moves. Audio comes from AetherSDR to the knob's jack, and
the knob's microphone goes back — or AetherSDR's own, the computer's, with
the knob for its PTT. Its face wears AetherSDR's dark theme.
The pictures are the knob's own screens; the orange marks are what your hand does.
Two ways to connect
- The USB-C cable (preferred). Plugged into the computer running AetherSDR, the knob is a USB network adapter: it hands the computer an address and talks TCI over the cable. Windows 10 (1903 or later), Windows 11, macOS and Linux need nothing installed. The knob looks for the computer as it starts: one already running on its battery stays on WiFi when it is plugged in, until Reboot on its page, with the cable in, starts it on the cable.
- WiFi. Set an SSID and the AetherSDR computer on the configuration page, and power the knob from any charger, or run it on its battery.
The USB-C socket only works one way round. The other way it reaches the board's second chip, the knob finds no computer, and says so. Turn the plug over. Unplugged, on its own battery, there is no cable to turn: the knob says nothing of it and goes to WiFi.
First run
- In AetherSDR, enable the TCI server — the
TCIpanel in the button bar — and set it to start by itself in Settings, so the knob finds it every time. - Over the cable, open
http://10.55.42.1— useradmin, passwordadmin— and change the password: the page nags until you do, since it can key a transmitter. Over WiFi it asks for a password of the knob's own first, 8 to 32 characters, and shows nothing else until it has one. - For WiFi, set the SSID and the AetherSDR computer. That host is only for WiFi: over the cable the knob always talks to the computer it is plugged into. Up to four computers can be listed, each with a name for the dial.
Until AetherSDR answers, the knob says so, with its addresses — over the cable, the computer's firewall is the usual reason: see the README's If the knob says NO LINK.
The internet over the cable
Over the cable the knob reaches the computer, and beyond it only if the computer passes its traffic on. Tuning, transmitting and the page never need the internet. The time does: the clock screensavers say NO TIME YET until they have it. So do the knob's own update checks; without them the page checks for it. From 1.24.2 the knob sends the computer everything not meant for it, and asks Cloudflare's and Google's name servers (1.1.1.1, 8.8.8.8). The computer passes it on with NAT:
Linux. The first two last until the computer restarts. The third is only for ufw, which drops forwarded traffic by default, and it stays:
sudo sysctl -w net.ipv4.ip_forward=1
sudo iptables -t nat -A POSTROUTING -s 10.55.42.0/24 ! -d 10.55.42.0/24 -j MASQUERADE
sudo ufw route allow from 10.55.42.0/24
macOS, not tried yet. en0 stands for the Mac's own way to the
internet; route get default names it:
sudo sysctl -w net.inet.ip.forwarding=1
echo "nat on en0 from 10.55.42.0/24 to any -> (en0)" | sudo pfctl -a com.apple/vfoknob -f -
sudo pfctl -E
Windows, tried on Windows 11. Internet Connection Sharing does it, on every edition, once it is pointed at the knob's addresses: out of the box it gives the cable addresses of its own (192.168.137.x), and the knob would lose the computer. First, from an administrator PowerShell:
$p = 'HKLM:\SYSTEM\CurrentControlSet\Services\SharedAccess\Parameters'
Set-ItemProperty $p ScopeAddress 10.55.42.2
Set-ItemProperty $p ScopeAddressBackup 10.55.42.2
Restart-Service SharedAccess
Then Win+R, ncpa.cpl: the knob is the connection with UsbNcm Host
Device under its name. Right-click the one that has the internet (WiFi or
Ethernet), Properties > Sharing, tick Allow other network users to
connect through this computer's Internet connection, and under Home
networking connection choose the knob's. ipconfig should show 10.55.42.2 on
the knob's adapter; if it shows 192.168.137.1, untick the sharing, run
Restart-Service SharedAccess, and tick it again. Windows can forget the
sharing when it restarts; Microsoft's fix
(KB4055559),
as administrator too:
New-ItemProperty HKLM:\Software\Microsoft\Windows\CurrentVersion\SharedAccess EnableRebootPersistConnection -Value 1 -PropertyType DWord
Set-Service SharedAccess -StartupType Automatic
The knob needs no restart: the time comes within a few minutes. The knob still offers the computer no route, so the computer's own traffic never goes down the cable.
The face
| Part | Tap | |
|---|---|---|
| S-meter | hold: the address card, and LOCK | S-units, peak held a second; dBm under the reading |
| Battery | — | the knob's own, over the reading, while it runs on it: full to empty by the quarter, green from half its charge up, yellow under that, red at a fifth and below. None on USB power, nor on the air |
| AGC | the AGC editor | OFF, SLOW, MED, FAST |
| RF.G | — | greyed: AetherSDR's TCI does not carry the RF gain |
| Band | the band editor | the band's own frequency, on a tap on the panel |
| Mode | the mode editor | USB, LSB, CW, CW-R, AM, SAM, FM, NFM, DIGU, DIGL, RTTY |
| Filter | the filter editor | its width, on the side of the carrier the mode uses |
| Frequency | a digit: the tuning step | the underlined digit is the step |
| Step, RIT | RIT: its editor | RIT in amber when set |
| Volume, mic gain | their editors | the knob's own levels |
| PTT | key, and key off | see Transmitting |
Turn the knob to tune: a slow turn moves a step at a time, a flick crosses a band. Band and mode change on a tap on the panel; filter, AGC, RIT, volume and mic gain apply as you turn, and any tap closes them.
Swipe from the right for the DSP: the noise blanker (NB), noise reduction (NR), automatic notch (ANF) and, in CW, the audio peak filter (APF), each lit when on and dimmed when off. Turn to one; a tap switches it, and the menu stays. Their levels stay as AetherSDR has them. Before AetherSDR has said which it has, the swipe opens nothing.
Unplugged, the knob runs on its own battery and shows its charge at the top of the arc, as a phone does — on every firmware's face. On USB power the charge cannot be read, and none shows. The address card says which: battery 85 %, or on USB power.
Another computer
On WiFi, with more than one computer listed, swipe up: turn to one, tap the panel, and the knob restarts into it. Over the cable there is no choosing — the cable reaches one computer.
Transmitting
PTT is a toggle: tap to key, tap again to unkey. It keys as the finger lifts from a tap — a swipe that starts on it never keys — and on the air a touch unkeys at once. The face turns to transmit: SWR across the left half, forward power across the right, the microphone on the thin inner ring, the mic level on AetherSDR's own scale.
With the computer's microphone
Until set, the knob transmits its own microphone, or a Bluetooth headset's. To transmit with AetherSDR's own microphone input instead — a USB microphone on the computer, say — set Transmit with to AetherSDR's own microphone under Audio on the configuration page. The knob's PTT then keys AetherSDR as a foot switch would: AetherSDR transmits from its own input, and the knob's microphone stays off. The mic level on the face is AetherSDR's either way, so it shows the computer's microphone. It applies from the next time you key.
The transmit time-out is the radio's own: set it in AetherSDR, Radio Setup → TX → Timeout. The radio enforces it itself, so it holds even if the knob, the link or the computer does not.
A Bluetooth headset
A Bluetooth headset can be the knob's ear and microphone, and its call button the PTT: a press keys, the next unkeys. The slab keeps PTT, with the headset's logo at its right end — red while the headset has its microphone muted, when neither its button nor the slab keys — and the knob's own microphone is off. Its battery shows beside the logo, green, yellow or red, where the headset reports it (its battery). Pairing, the companion firmware and the boom arm as the PTT: the headset guide. A Bluetooth speaker plays the knob's audio with the jack, and you transmit with the knob's own microphone: the guide.
Locking the knob
Hold the S-meter for the address card, let go, and tap LOCK, which has come up over the S-meter. A padlock shows at the top of the arc. A turn tunes nothing, a tap or a swipe opens nothing, and nothing keys: not the slab, nor a headset's button or its boom arm. Unkeying is never locked: on the air, a tap on the slab or the headset's button still unkeys. The padlock goes red for a moment when it refuses something. A question the knob asks still takes its answer.
To unlock, hold the S-meter again and tap UNLOCK. With no link it is over the warning. A restart unlocks too.
| The card's LOCK | Locked |
|---|---|
Another firmware
Hold the S-meter for the address card, then hold it again for three seconds until the knob buzzes, and turn: see the setup guide. It needs WiFi: over the cable the knob says so and carries on.