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.

FLIP USB-C: turn the plug over

First run

  1. In AetherSDR, enable the TCI server — the TCI panel in the button bar — and set it to start by itself in Settings, so the knob finds it every time.
  2. Over the cable, open http://10.55.42.1 — user admin, password admin — 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.
  3. 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.

NO LINK, with the knob's addresses

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

The AetherSDR face, its parts named

PartTap
S-meterhold: the address card, and LOCKS-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
AGCthe AGC editorOFF, SLOW, MED, FAST
RF.G—greyed: AetherSDR's TCI does not carry the RF gain
Bandthe band editorthe band's own frequency, on a tap on the panel
Modethe mode editorUSB, LSB, CW, CW-R, AM, SAM, FM, NFM, DIGU, DIGL, RTTY
Filterthe filter editorits width, on the side of the carrier the mode uses
Frequencya digit: the tuning stepthe underlined digit is the step
Step, RITRIT: its editorRIT in amber when set
Volume, mic gaintheir editorsthe knob's own levels
PTTkey, and key offsee 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.

MODE: USB

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.

DSP: NB, off

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.

On its own battery: the knob's charge at the top of the arc

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.

RADIO: shack-pc, LAN

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.

On the air: SWR 1.3, 50 W of 100

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.

A Bluetooth headset connected: its button is the PTT

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 LOCKLocked
Hold the S-meter for the card, then tap LOCKLocked: the padlock at the top of the arc

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.