Wires and what they carry
Every port has a type and a contract. A wire joins an output to an input of the same type, and the server refuses one the contract does not allow. This page is generated by cargo xtask codegen from the node catalog.
Port types
| Type | Carries |
|---|---|
| IQ | Decoders on a lane retune it unless the lane is locked |
| Baseband | |
| Audio | Live audio |
| Events | Decoded events. Calls and transmissions bring their clip |
| Video | |
| Control | |
| Position | |
| Array | |
| Bearing | A live bearing that steers an array |
Event kinds
| Kind | Name | Shows as | Facts |
|---|---|---|---|
transmission | Transmission | Transmissions | log, duration, clip |
rds | RDS | Stations | log, station |
pocsag | POCSAG | Pagers | log, station |
flex | FLEX | Pagers | log, station |
ermes | ERMES | Pagers | log, station |
eot | End-of-Train | Trains | log, station |
sarsat | 406 MHz beacon | Beacons | log, station, geo |
tetrapol | Tetrapol | Radios | log, station |
adsb | ADS-B | Aircraft | log, station, geo |
ais | AIS | Vessels | log, station, geo |
aprs | APRS | Stations | log, station, geo |
rtty | RTTY | RTTY | log, text |
morse | Morse | Morse | log, text |
cw_skimmer | CW skimmer | CW spots | log |
selcall | Selcall | Selcall | log |
navtex | NAVTEX | Stations | log, station |
acars | ACARS | Aircraft | log, station |
tone | Tone | Tones | log |
scrambler | Scrambler | Scramblers | log |
dv | Digital voice | Radios | log, station, geo, voice |
call | Call | Calls | log, station, voice, duration, clip |
ft8 | FT8 | Stations | log, station, spot |
ft4 | FT4 | Stations | log, station, spot |
psk | PSK | PSK | log, text |
wspr | WSPR | Stations | log, station, spot |
ident | Signal ID | Signals | log |
broadcast_data | Broadcast data | Services | log |
broadcast | Broadcast | Services | |
radio_clock | Radio clock | Clocks | log, station |
gnss | GNSS lab | Satellites | log, station |
sstv | SSTV | Pictures | log, picture |
vor | VOR | Beacons | log, station |
ils | ILS | ILS | log |
dsc | DSC | Vessels | log, station, geo |
inmarsat_stdc | Inmarsat STD-C | Vessels | log, station, geo |
inmarsat_aero | Inmarsat Aero | Aircraft | log, station, geo |
vdl2 | VDL Mode 2 | Aircraft | log, station, geo |
hfdl | HFDL | Aircraft | log, station, geo |
iridium | Iridium | Bursts | log, station, geo |
df | Bearing | Bearings | log, station, geo, bearing |
df_fix | Fix | Fixes | log, station, geo |
radar | Radar | Tracks | log, station, geo |
radar_sites | Radar sites | Sites | station, geo |
nav | Guidance | Targets | station, geo |
satellite | Satellite | Satellites | station, geo |
dect | DECT | Base stations | log, station |
gsm | GSM | Cells | log, station |
apt | NOAA APT | Pictures | log, picture |
lrpt | Meteor LRPT | Pictures | log, picture |
wefax | WEFAX | Pictures | log, picture |
radiosonde | Radiosonde | Sondes | log, station, geo |
lora | LoRa | Nodes | log, station, geo |
remote_id | Remote ID | Drones | log, station, geo |
ble | BLE | Devices | log, station |
wifi_occupancy | Wi-Fi load | Wi-Fi load | log |
ism_survey | 2.4 GHz | 2.4 GHz | log |
ism | ISM sensor | Sensors | log, station |
noise_figure | Noise figure | Noise figure | log |
per | PER | PER | log |
sid | SID | SID | log |
stanag | STANAG | STANAG | log |
Sources
Device
A radio, where every patch starts
| Port | Way | Type | Carries | Wires |
|---|---|---|---|---|
iq | out | IQ | radio | many, one per lane |
Recording
Plays back a recorded IQ file
| Port | Way | Type | Carries | Wires |
|---|---|---|---|---|
iq | out | IQ | radio | many, one per lane |
Signal generator
Test signals without a radio
| Port | Way | Type | Carries | Wires |
|---|---|---|---|---|
iq | out | IQ | synthetic | many |
GPS position
Your station location, live or fixed
| Port | Way | Type | Carries | Wires |
|---|---|---|---|---|
position | out | Position | many |
Channels
Channel
Tunes and decodes one signal
Ports follow the decoder the node runs.
| Port | Way | Type | Carries | Wires |
|---|---|---|---|---|
iq | in | IQ | radio, synthetic, derived | many lanes. every radio that may carry this decoder; it runs on the one that hears it |
control | in | Control | tune, doppler, sweep | one. a scanner, signal hunt or satellite drives this decoder; its radio follows |
position | in | Position | one | |
baseband | out | Baseband | many | |
audio | out | Audio | many | |
events | out | Events | any kind | many. Decoded messages and calls. Analog calls need squelch |
video | out | Video | many |
Tools
Array
Radio lanes as one antenna array
| Port | Way | Type | Carries | Wires |
|---|---|---|---|---|
lane | in | IQ | radio | one, one per array lane. One radio lane per antenna, in antenna order |
position | in | Position | one. Array place and heading | |
array | out | Array | many |
Spectrum monitor
Catches and decodes everything in view
| Port | Way | Type | Carries | Wires |
|---|---|---|---|---|
iq | in | IQ | radio, synthetic, derived | one |
events | out | Events | any kind | many |
DMR trunk system
Follows calls across a DMR trunk system
| Port | Way | Type | Carries | Wires |
|---|---|---|---|---|
iq | in | IQ | radio, synthetic, derived | one. the radio the control channel sits on; the system runs its own decoders |
events | out | Events | Digital voice, Call | many |
audio | out | Audio | many |
Event filter
Passes only matching events
| Port | Way | Type | Carries | Wires |
|---|---|---|---|---|
events | in | Events | any kind | many |
events | out | Events | any kind | many |
Audio FX
Filters, denoise and AGC
| Port | Way | Type | Carries | Wires |
|---|---|---|---|---|
audio | in | Audio | many | |
audio | out | Audio | many |
Scanner
Steps through frequencies, stops on activity
| Port | Way | Type | Carries | Wires |
|---|---|---|---|---|
iq | in | IQ | radio, synthetic, derived | one. The lane it watches |
control | out | Control | sweep | one |
Signal hunt
Walks you towards a transmitter
| Port | Way | Type | Carries | Wires |
|---|---|---|---|---|
iq | in | IQ | radio, synthetic, derived | one. The lane it watches |
control | out | Control | sweep | one |
position | in | Position | one. Where you stand and which way you point | |
events | out | Events | Bearing | many. Sweep and mark bearings |
Satellite
Predicts passes and follows Doppler
| Port | Way | Type | Carries | Wires |
|---|---|---|---|---|
position | in | Position | one | |
control | out | Control | tune, doppler, point | many. decoders to tune and Doppler correct, rotators to point |
events | out | Events | Satellite | many. Position and ground track for a Map |
Direction finder
Bearings from an array
| Port | Way | Type | Carries | Wires |
|---|---|---|---|---|
array | in | Array | one | |
events | out | Events | Bearing | many. True bearings |
bearing | out | Bearing | many. Live bearing to steer a beam |
Beamformer
Steer, null or combine an array
| Port | Way | Type | Carries | Wires |
|---|---|---|---|---|
array | in | Array | one | |
steer | in | Bearing | one. A direction finder to steer at | |
beam | out | IQ | derived | many. The combined lane |
Passive radar
Aircraft echoes of FM, DAB or DVB-T
| Port | Way | Type | Carries | Wires |
|---|---|---|---|---|
array | in | Array | one | |
tx | in | Position | one. GPS node fixed at the transmitter | |
adsb | in | Events | ADS-B | many. ADS-B decoder used as truth |
events | out | Events | Radar, Radar sites | many. Track events |
Stitch
Spread lanes joined into one wide band
| Port | Way | Type | Carries | Wires |
|---|---|---|---|---|
array | in | Array | one | |
wide | out | IQ | derived | many. Every lane joined |
Spatial spectrum
Bearing over frequency
| Port | Way | Type | Carries | Wires |
|---|---|---|---|---|
array | in | Array | one |
Correlator
Baseline visibilities
| Port | Way | Type | Carries | Wires |
|---|---|---|---|---|
array | in | Array | one |
Polarimeter
Polarisation of two crossed antennas
| Port | Way | Type | Carries | Wires |
|---|---|---|---|---|
array | in | Array | one | |
beam | out | IQ | derived | many. Matched to the wave |
Triangulation
Crosses bearings into a position
| Port | Way | Type | Carries | Wires |
|---|---|---|---|---|
events | in | Events | Bearing | many. Bearings |
position | in | Position | one. Vehicle to guide | |
events | out | Events | Fix, Guidance | many |
Outputs
Scope
Spectrum and waterfall
| Port | Way | Type | Carries | Wires |
|---|---|---|---|---|
iq | in | IQ | radio, synthetic, derived | one |
Baseband scope
Constellation and eye of one channel
| Port | Way | Type | Carries | Wires |
|---|---|---|---|---|
baseband | in | Baseband | one |
Speaker
Plays channel audio
| Port | Way | Type | Carries | Wires |
|---|---|---|---|---|
audio | in | Audio | many |
Map
Decoded positions on a map
| Port | Way | Type | Carries | Wires |
|---|---|---|---|---|
events | in | Events | 20 kinds | many |
position | in | Position | many |
Signal survey
Maps signal strength while you move
| Port | Way | Type | Carries | Wires |
|---|---|---|---|---|
iq | in | IQ | radio, synthetic, derived | one |
position | in | Position | one |
Propagation map
Where FT8, FT4 and WSPR signals came from
| Port | Way | Type | Carries | Wires |
|---|---|---|---|---|
events | in | Events | FT8, FT4, WSPR | many, keeps history |
position | in | Position | one |
Readout
Current decoder state
| Port | Way | Type | Carries | Wires |
|---|---|---|---|---|
events | in | Events | any kind | many |
Decoder log
Every decoded message in a table
| Port | Way | Type | Carries | Wires |
|---|---|---|---|---|
events | in | Events | 57 kinds | many, keeps history, clips |
Event output
Sends events out, saves call audio
| Port | Way | Type | Carries | Wires |
|---|---|---|---|---|
events | in | Events | 57 kinds | many |
Video
ATV frames and decoded pictures
| Port | Way | Type | Carries | Wires |
|---|---|---|---|---|
video | in | Video | many, keeps pictures |
Recorder
Records a radio's full IQ
| Port | Way | Type | Carries | Wires |
|---|---|---|---|---|
iq | in | IQ | radio, synthetic, derived | one |
position | in | Position | one |
Audio recorder
Records channel audio to WAV
| Port | Way | Type | Carries | Wires |
|---|---|---|---|---|
audio | in | Audio | many |
Baseband recorder
Records one channel's IQ
| Port | Way | Type | Carries | Wires |
|---|---|---|---|---|
baseband | in | Baseband | many |
Time machine
Saves IQ from before you pressed record
| Port | Way | Type | Carries | Wires |
|---|---|---|---|---|
iq | in | IQ | radio, synthetic, derived | one |
position | in | Position | one |
Network IQ
Streams IQ to other programs
| Port | Way | Type | Carries | Wires |
|---|---|---|---|---|
iq | in | IQ | radio, synthetic, derived | one |
baseband | in | Baseband | one |
Export
Saves logged rows as CSV or JSON
| Port | Way | Type | Carries | Wires |
|---|---|---|---|---|
events | in | Events | 57 kinds | many, keeps history |
Rotator
Points an antenna at a satellite
| Port | Way | Type | Carries | Wires |
|---|---|---|---|---|
control | in | Control | point | one. The satellite to follow |