SondeDeck
SondeDeck is a handheld RS41 radiosonde recovery receiver firmware for the LilyGO T-Deck Plus.
It uses the onboard SX1262 radio to receive RS41 radiosonde frames, decodes telemetry on-device, displays recovery/navigation information on the TFT, supports optional SD logging, and provides a phone-friendly web dashboard over Wi-Fi.
SondeDeck can query SondeHub predictions in read-only mode, but it is not affiliated with or endorsed by SondeHub.
Current release
Version: v1.3
v1.3 adds country-aware launch-site frequency presets, preset/manual frequency source modes, 0.1 MHz manual scan stepping, and web-panel controls for device settings.
Supported hardware
SondeDeck currently targets:
- LilyGO T-Deck Plus
- ESP32-S3
- SX1262 radio
- ST7789 TFT display
- GT911 touchscreen
- Onboard GPS
- Optional microSD card
Supported radiosondes
Currently supported:
- Vaisala RS41 / RS41-SG style frames
Not currently supported:
- DFM
- M10
- LMS6
- iMet
- MRZ
- Other sonde families
Main features
- RS41 receive and decode using the onboard SX1262 radio
- Country-aware launch-site frequency presets
- Manual/set-frequency mode from 400.0 MHz to 406.0 MHz
- Preset scanning within the selected country
- Manual scanning in 0.1 MHz steps
- Recovery-focused TFT interface
- Touchscreen Home screen
- Web/Home/Info bottom control bar
- Keyboard and trackball controls retained
- Local GPS support
- Sonde GPS decoding
- Range, bearing, and elevation guidance from local GPS to sonde
- SD card logging
- Saved Wi-Fi configuration from the device UI
- Phone-friendly web dashboard
- Web-panel controls for settings and frequency changes
- Google Maps link for sonde GPS position
- Read-only SondeHub prediction lookup by serial
- Battery percentage display
- Screen brightness control
- Keyboard brightness control
- Touch input enable/disable setting
- Splash, Help, status-icon Help, and About pages
v1.3 highlights
v1.3 updates the frequency system so presets are no longer just bare frequencies. Each preset now stores:
{"UK", 403400000UL, "Castor Bay", "03918"}
The Frequency page displays this as:
403.400MHz
Castor Bay 03918
The selected country is set from the Settings page and only countries present in the preset list can be selected.
Frequency presets
Presets are sorted by country alphabetically, and by frequency inside each country.
{"FR", 404000000UL, "Brest", "07110"},
{"IRE", 400500000UL, "Valentia", "03953"},
{"UK", 401100000UL, "MOD Shoeburyness", "03693"},
{"UK", 403400000UL, "Castor Bay", "03918"},
{"UK", 403700000UL, "Larkhill", "03743"},
{"UK", 404000000UL, "Reading Uni", "-92"},
{"UK", 404100000UL, "MOD Aberporth", "03502"},
{"UK", 404400000UL, "MOD South Uist", "03023"},
{"UK", 404500000UL, "Cardington", "03559"},
{"UK", 405100000UL, "MOD Eskmeals", "-81"},
{"UK", 405100000UL, "Albemarle", "03238"},
{"UK", 405500000UL, "Watnall", "03354"},
{"UK", 405700000UL, "Camborne", "03808"},
{"UK", 405800000UL, "Herstmonceux", "03882"}
Frequency modes
SondeDeck now has two frequency source modes:
Preset
Set Freq
Preset mode:
- Z/X steps through presets for the selected country only
- S toggles scanning through presets for the selected country only
- The Frequency and Overview pages show the country, site name and site code
Set Freq mode:
- Z/X changes the manual frequency in 0.1 MHz steps
- S toggles scanning from 400.0 MHz to 406.0 MHz in 0.1 MHz steps
- The web panel can directly set the manual frequency in MHz
Frequency controls:
F Frequency page
Z/X Previous/next preset or manual 0.1 MHz step
S Scan on/off
V Toggle Preset / Set Freq mode
Country setting:
Y Settings page
G Cycle country
Country, source mode and manual frequency are stored in ESP32 flash using Preferences.
Web panel
The web panel is no longer display-only. It now includes controls for:
- Country selection
- Preset / Set Freq source mode
- Previous/next frequency
- Manual MHz input
- Scan on/off
- SD logging on/off
- Screen brightness cycling
- Keyboard brightness cycling
- Touch input on/off
- Auto dim on/off
- Counter reset
- Wi-Fi SSID/password update
Radio receive/decode remains the priority. The web server is handled with short non-blocking requests and the dashboard uses the cached status JSON.
Web routes:
GET /
GET /api/status
GET /api/control?cmd=...
POST /api/control?cmd=...
Web Mode
Web Mode uses Wi-Fi client/STA mode only. SondeDeck connects to an existing Wi-Fi network, such as your phone hotspot, and your phone opens the SondeDeck IP address.
Web Mode does not create its own access point.
Starting Web Mode:
Tap Web in the bottom control bar
or press:
M
Exiting Web Mode from the device:
Space
While Web Mode is active:
- normal TFT page drawing is stopped
- touch is ignored on the device
- trackball is ignored on the device
- keyboard is ignored except Space
- radio capture/decode continues
- local GPS continues
- SD logging continues if enabled
- Wi-Fi and web serving continue
Web dashboard data
The phone dashboard shows:
- sonde heard / waiting state
- sonde serial
- frame number
- RSSI and peak RSSI
- sonde GPS state
- sonde latitude/longitude/altitude
- local GPS state
- local latitude/longitude/altitude
- range, bearing, and elevation
- selected country, site name and site code
- frequency source mode
- scan state
- SD/logging state
- battery percentage
- Wi-Fi status and IP address
When sonde GPS is valid, the dashboard shows:
Open sonde in Google Maps
Wi-Fi configuration
Wi-Fi can be configured from the Online page.
Controls:
O Online page
N Edit SSID
C Edit password
Enter Save
Ball Save
Backspace delete
Space Cycle ABC / 123 / SYM input mode
Wi-Fi credentials are saved in ESP32 flash using Preferences.
There is no Wi-Fi scanning. SondeDeck simply tries the saved SSID/password.
Wi-Fi states:
W-- no SSID configured
W.. SSID configured but not connected
ONL connected
Wi-Fi text input modes
When editing Wi-Fi text, normal page/action controls are locked out.
Input modes:
ABC -> 123 -> SYM -> ABC
123 mode:
W E R -> 1 2 3
S D F -> 4 5 6
Z X C -> 7 8 9
Q/P -> 0 fallback
SYM mode:
Q T Y U I O P -> # ( ) - ' " @
A G H J K -> * / _ ; :
V B N M -> ? ! , $
The physical printed 0/microphone key may not report through the keyboard library on some units, so Q and P are used as fallback 0 keys in 123 mode.
Home screen
After the boot splash, SondeDeck opens to a Home screen with a 4x2 grid for the eight main pages:
- Overview
- Sonde
- Recovery
- Local GPS
- Logging
- Settings
- Frequency
- Online
Each Home tile has a small status dot where relevant.
Bottom control bar
The bottom bar is:
[Web] [Home] [Info]
Controls:
- Web starts Web Mode
- Home returns to the Home screen
- Info cycles Help -> Icons -> About
Top status bar
Status fields:
G12 local GPS fix with satellite count
G.. GPS data present, no fix yet
G-- no local GPS data/fix
S+ sonde frame with usable GPS
S? sonde frame seen, no usable sonde GPS
S-- no sonde frame yet
R+ recovery ready: local GPS and sonde GPS available
R? partial recovery state: one GPS source missing
R-- recovery not ready
LOG SD logging active
SD SD available, logging off
SD! SD unavailable or error
LCK valid frequency / sonde lock
SCN scanning active
F-- no sonde on current frequency and scanning off
ONL online / Wi-Fi connected
W.. Wi-Fi configured but not connected
W-- Wi-Fi not configured
Controls
Keyboard shortcuts:
Q Overview
W Sonde details
E Recovery
R Local GPS
T Logging
Y Settings
F Frequency
O Online
H Home
Space Help -> Icons -> About -> return
Info Help -> Icons -> About
U/I Move between Home tiles / pages
Enter Open selected Home tile
Ball Return Home from pages / open selected Home tile from Home
L Toggle SD logging
B Cycle screen brightness
K Cycle keyboard brightness
D Toggle touch input on/off
P Toggle auto dim
A Reset counters and peak RSSI
M Start Web Mode
G Cycle country on Settings page
V Toggle Preset / Set Freq mode on Settings/Frequency page
S Toggle scan on/off
Z/X Previous/next preset or manual frequency step
Default UI settings
Touch input: ON
Screen brightness: 75%
Keyboard brightness: 0%
Auto dim: OFF
Default country: UK
Default frequency: Camborne 405.700 MHz
GPS configuration
The T-Deck Plus GPS configuration confirmed during testing is:
Baud: 38400
ESP RX: GPIO44
ESP TX: GPIO43
Arduino HardwareSerial::begin() uses this order:
begin(baud, config, rxPin, txPin)
SD card logging
If an SD card is present, SondeDeck can log sonde telemetry and recovery history.
Logging can be toggled from the Logging page, the web panel, or with:
L
If no SD card is present, SondeDeck continues running normally without logging.
Configuration files
Important project configuration files:
src/config/version.h
src/config/wifi_config.h
src/config/frequency_config.h
src/board_pins.h
Version information is set in:
src/config/version.h
For v1.3:
constexpr const char* VERSION = "v1.3";
Building
Install PlatformIO, then from the project root run:
pio run
Upload to the T-Deck Plus:
pio run -t upload
Open serial monitor:
pio device monitor -b 115200
A clean build can be forced with:
pio run -t clean
pio run
Known limitations
- RS41 only
- No SDR waterfall
- No offline wind-model prediction
- SondeHub predictions require internet and external SondeHub data
- SondeDeck does not upload telemetry to SondeHub
- Web panel control requires the phone/device to reach SondeDeck on the same Wi-Fi/hotspot network
- Local GPS may not fix indoors
- The physical printed
0/microphone key may not report through the keyboard library
Safety and legal notes
Only receive signals you are legally allowed to receive in your location.
Radiosonde recovery may involve access restrictions, private land, roads, weather, water, cliffs, trees, livestock, and other hazards. Follow local laws and obtain permission where required.
License
SondeDeck is released under the GNU General Public License v3.0 or later.
See:
LICENSE
THIRD_PARTY.md