29 KiB
Receiving guide
What to tune to, which demodulator to use, and what to watch out for. Frequencies are from the
plugin documentation, or from the standard named where a readme has no table; call get_docs
for the full readme of any plugin named here, and describe_settings before setting any key.
Several bands differ by region: the APRS frequency, pager bands, the broadcast FM raster and
airband channel spacing all do. Where a table below offers alternatives, check where the
receiver is with get_location, or ask, rather than picking one.
Choosing a device sample rate
The device sample rate sets how much spectrum you can see and process at once. Rules of thumb:
- A narrowband mode (voice, APRS, AIS, pagers) needs only tens of kHz, so a low device rate such as 250 kS/s to 1 MS/s is enough and uses far less CPU.
- The channel's own bandwidth is set separately, on the channel, not on the device.
- Several channels can share one device as long as each one's offset falls inside the device bandwidth. That is the cheap way to receive two nearby frequencies at once.
- A few modes need a minimum rate, listed below. Setting less than the minimum produces nothing.
- The key differs by device: an RTL-SDR has
devSampleRateandlog2Decim(the baseband is the rate divided by 2 to the power oflog2Decim), most otherssampleRate;describe_settingswith the device's hwType shows which.listenandscanset the rate themselves for an RTL-SDR and the test source, and say so when they have left another device's rate as it was.
Minimum device sample rates:
| Mode | Minimum | Why |
|---|---|---|
| ADS-B | 2 MS/s | 2 Mchip/s chip rate. Higher rates decode more distant aircraft |
| DAB | 2.048 MS/s | Fixed by the standard |
| DVB-T and DVB-T2 | 9.142857 MS/s for 8 MHz channels | 8/7 times the bandwidth is the native rate (64/7 MS/s for 8 MHz; 131/71, about 1.845 MS/s, for DVB-T2's 1.7 MHz). Rates from 0.875 to 2.2 times it are resampled, at a CPU cost. An RTL-SDR can't run fast enough for 5 MHz and over |
| DVB-S and DVB-S2 | 1.2 times the symbol rate | The signal is 1 + roll-off times the symbolRate wide, and losing a little of its edges costs under 0.3 dB. More leaves room for it being off centre and for the device's filter: 33 MS/s or more for 27.5 MS/s broadcasts (a USRP B210 or similar), 27.6 MS/s or more for 23 MS/s, 1 MS/s for QO-100's 333 or 500 kS/s. Measuring the symbol rate (symbolRate 0) needs about 1.7 times, to see the noise floor beside the signal. Use standard 4, 5 or 6: standard 0 is terrestrial, and needs 8 MS/s for an 8 MHz channel whatever the signal |
| DJI DroneID | 15.36 MS/s | 9 MHz wide OFDM with a 1024 point FFT. Beyond an RTL-SDR: use a HackRF, USRP, PlutoSDR or similar |
| DRM | 48 kS/s, 192 kS/s for mode E | The channel is resampled to 192 kHz when it can be, else to 48 kHz, which carries only the HF modes A to D |
| Broadcast FM | 240 kS/s | Must exceed the channel RF bandwidth. 256 kS/s is recommended for a 180 kHz channel |
Aircraft
| What | Channel | Frequency | Notes |
|---|---|---|---|
| ADS-B and Mode S | ADSBDemod |
1090 MHz | Needs at least 2 MS/s. Recommend 2.4 MS/s for RTL SDR. Feeds aircraft to the map |
| Airband voice | AMDemod |
118 to 137 MHz | Amplitude modulation, not FM. 8 kHz channel bandwidth |
| VOR navaids | VORDemod, VORDemodMC |
108 to 117.975 MHz | VORDemodMC receives several VORs at once for a position fix |
| ILS localizer | ILSDemod |
108 to 112 MHz | Horizontal guidance |
| ILS glide slope | ILSDemod |
329 to 335 MHz | Vertical guidance, paired with the localizer |
| DJI drones (DroneID) | DroneIDDemod |
2399.5 to 2474.5 MHz and 5721.5 to 5831.5 MHz | Needs at least 15.36 MS/s. OcuSync drones (Mini 2, Mini 3, Air 2S, Mavic 3...) send a burst every 640 ms while the motors run, staying on a channel for a while, then changing channel or band. Gives drone, pilot and home positions. listen with mode droneid |
Ships
| What | Channel | Frequency | Notes |
|---|---|---|---|
| AIS | AISDemod |
161.975 MHz and 162.025 MHz | The two channels are 50 kHz apart, so one device at 162 MHz covers both with two channels at offsets of -25 kHz and +25 kHz. listen with mode ais at 162000000 does exactly that, and adds the AIS feature, which lists the ships and puts them on the map |
| DSC distress and calling | DSCDemod |
2187.5 kHz, 8414.5 kHz, 16804.5 kHz, 156.525 MHz | The VHF one is marine channel 70 - but isn't yet supported |
| NAVTEX | NavtexDemod |
518 kHz, 490 kHz, 4209.5 kHz | 518 kHz is English international, 490 kHz national languages |
Amateur and data
| What | Channel | Frequency | Notes |
|---|---|---|---|
| APRS and AX.25 packet | PacketDemod |
144.800 MHz in Europe, 144.390 MHz in North America | listen with mode aprs adds the APRS feature, which decodes and maps the stations; mode packet is the demodulator alone |
| M17 digital voice | M17Demod |
144 and 430 MHz bands | Also carries data packets |
| chirpmodem | ChirpModemDemod |
223.58 MHz (1.25 m band), or as arranged | Chirp spread spectrum, SF and bandwidth not signalled: listen with mode chirpmodem sets SF9 at 62.5 kHz; change spreadFactor and bandwidth with set_channel_settings to match the transmitter. Frames go to get_packets with source, destination and body |
| FT8 and other digital HF | FT8Demod |
HF band segments | Needs an HF capable receiver |
| SSB and CW | SSBDemod, WDSPRx |
HF | WDSPRx has the more capable receiver chain |
| RTTY | RTTYDemod |
HF | |
| DMR, dPMR, D-Star, YSF, NXDN | DSDDemod |
Varies by band plan | listen with mode dmr, dpmr, dstar, ysf or nxdn sets the deviation and baud rate the standard needs. Needs the AMBE feature or hardware for voice |
Weather, time and utility
| What | Channel | Frequency | Notes |
|---|---|---|---|
| Radiosondes (RS41) | RadiosondeDemod |
400 to 406 MHz | Balloons are up around 00:00 and 12:00 UTC. The Radiosonde feature decodes and maps them; listen with mode sonde adds it |
| NOAA APT weather images | APTDemod |
NOAA 15 at 137.620 MHz, NOAA 18 at 137.912 MHz, NOAA 19 at 137.100 MHz | Historical: the NOAA APT satellites were retired in 2025, so there is nothing live to receive. The demodulator still decodes recordings |
| Time signals | RadioClock |
MSF 60 kHz, DCF77 77.5 kHz, TDF 162 kHz, WWVB 60 kHz, JJY 40 kHz, RBU 66.666 kHz, PCSK-225 225 kHz | Needs a receiver that covers VLF or LF |
| Inmarsat STD-C | InmarsatDemod |
1537.70, 1541.45, 1537.10 MHz | L band, needs a suitable antenna and often an LNA |
Broadcast
| What | Channel | Frequency | Notes |
|---|---|---|---|
| Broadcast FM | BFMDemod |
87.5 to 108 MHz | Use this rather than WFMDemod for broadcast: it decodes stereo and RDS. Stations sit on a 100 kHz raster (87.5, 87.6, 87.7...) everywhere except the Americas, where they are on the odd tenths 200 kHz apart; scan with a 100 kHz step, as a 200 kHz step from 87.5 MHz lands beside every even-tenth station and never on it |
| Wideband FM | WFMDemod |
Various | Plain wideband FM with no RDS |
| DAB | DABDemod |
Band III | Fixed 2.048 MS/s |
| DVB-T and DVB-T2 television | DVBDemod |
UHF channels 21 to 48 (470 to 694 MHz in Europe) | Channel n is centred on 474 + 8 (n - 21) MHz; a channel shown with a minus (e.g. 30-) is 166.667 kHz lower. Set the channel's bandwidth (8000000 in most of Europe; also 10000000, 7000000, 6000000, 5000000 and 1700000, of which 10 and 1.7 MHz are DVB-T2 only). standard 0 finds either (3 for the T2-Lite profile); lowPriority 1 decodes a hierarchical DVB-T multiplex's low priority stream. Needs a device that runs at 9.142857 MS/s |
| DVB-S and DVB-S2 satellite television | DVBDemod |
Ku band 10.7 to 12.75 GHz, received through an LNB at 950 to 2150 MHz (Sky Q wideband LNB: 290 to 2340 MHz) | Turn on the device's transverter mode with the delta set to the LNB's local oscillator (9750000000 universal low band, 10600000000 high band, 10410000000 Sky Q) so the centre frequency is the downlink's. The LNB needs 13 V (vertical) or 18 V (horizontal), and a 22 kHz tone for a universal LNB's high band, from a power inserter; SDRangel can't supply or switch them. standard 4 finds either (5 DVB-S, 6 DVB-S2), with symbolRate set (or 0 to measure it from the strongest signal in the channel, which then takes the whole baseband: keep the device rate within 64 times the symbol rate): Astra 2 (28.2 E) HD multiplexes are 23000000 DVB-S2 8PSK, SD ones 22000000 or 27500000 DVB-S. QO-100's wideband transponder (10491 to 10499 MHz) carries amateur DVB-S2 at 333000 or 500000 (also 125000 to 2000000) |
| DRM (Digital Radio Mondiale) | DRMDemod |
LW, MW and SW broadcast bands; mode E (DRM+) in VHF bands I and II | Tune to the nominal channel frequency, as broadcast schedules list it. The robustness mode and occupancy are detected. On HF the signal is 4.5 to 20 kHz wide, in mode E 100 kHz. listen with mode drm puts the channel clear of the device's DC spike |
| AM broadcast | AMDemod |
LW, MW, SW bands |
Checking DAB reception quality
After starting the device and selecting a programme, wait briefly and call
get_channel_report again. Do not treat sync: 1, a populated programme list or
audioActive: 1 alone as proof of clean reception: DAB audio can still be distorted.
DABDemodReport has:
- Margin:
mscBER, the bit error rate before error correction. About 0.06 is a clean signal; audio errors start at about 0.1. - Noise and impairments:
cn, the carrier to noise ratio from the null symbol, which sees noise and interference.snrcomes from the demodulated symbols. Ansnrwell belowcnmeans overload of the receiver, multipath or interference. - Gain advice:
gainStatus(0 OK, 1 increase, 2 reduce, 3 check) withgainAdvice. It comes frominputLevel(dBFS),clipping(% of samples) andsnragainstcn.
To set an RTL-SDR's gain, read its supported values from get_device_report. Step gain with
set_device_settings in the direction gainStatus says, waiting a few seconds after each
change. Keep the setting with the lowest mscBER, which is usually near -25 dBFS input. Do not
use the highest gain: the tuner compresses above about -15 dBFS and clips near -8 dBFS. If
no gain gives a usable mscBER, investigate frequency, antenna and local interference.
Checking DRM reception
DRMDemodReport.syncState goes from searching and acquiring to locked within a few
seconds of a usable signal. services then lists up to four services with their labels as the
SDC arrives, which takes a few more seconds; select one by setting selectedServiceIdentifier
to its serviceIdentifier with set_channel_settings (-1 plays the first audio service).
audioActive: 1 means the selected service produced decoded audio in the last 2.5 seconds.
mscMERDB, valid when mscMERAvailable is 1, is the quality measure: higher is better, so
use it to compare antennas, gains and frequencies of the same broadcast rather than against a
fixed figure. textMessage carries the station's text; error gives the reason there is no
audio or no decoding, such as a codec the build cannot decode (capabilities lists those it
can). When slideshowPresent is 1 the selected service sends MOT slideshow images;
slideshowImages counts those received and slideshowName names the latest. The
saveSlideshowImage channel action writes it to a file, with slideshowMimeType giving its
format. When websitePresent is 1 the selected service sends a MOT Broadcast Website:
websiteFiles of websiteObjects files have arrived, websiteStartPage names its start page,
and the saveWebsite channel action writes the files received into a directory. A service can be
a data service without audio (dataService 1); select it by its serviceIdentifier like an
audio service to decode its slideshow or website, and audioActive stays 0. journalineServices and journalineObjects count the Journaline news services and the
menus and pages received from them. To read the news, call get_channel_report with
includeJournaline: journaline has an entry per news service (services names the services
that carry it) with its objects. Object 0 is the main menu; a menu object's items link to
other objects by linkId, a text object's items are paragraphs and a list object's items
are table cells. The station repeats its news in a carousel, so menu entries can link to objects
that have not arrived yet: the whole service can take a few minutes. An HF signal fades, so
read the report more than once before judging it; a syncState that keeps returning to
reacquiring means the signal is too weak, or the device gain is overloading it as for DAB.
Short range and IoT
| What | Channel | Frequency | Notes |
|---|---|---|---|
| LoRa | ChirpChatDemod |
433, 868, 915 MHz ISM bands | Bandwidth and spreading factor must match the transmitter exactly or nothing decodes |
| Meshtastic | MeshtasticDemod |
433 MHz (EU_433), 868 MHz (EU_868), 902 MHz (US) | Set the region to match the network |
| MeshCore | MeshcoreDemod |
Same ISM bands as Meshtastic | |
| POCSAG pagers | PagerDemod |
Regional, commonly 138 to 160 MHz. 153.350 MHz in UK. | FSK with a 4.5 kHz shift |
| End of train devices | EndOfTrainDemod |
457.9375 MHz North America and India, 477.7 MHz Australia, 450.2625 MHz New Zealand |
Scanning for activity
scan steps a Frequency Scanner over a range or a list and reports what was active. Read
active for the answer: every frequency above the threshold with its level, strongest first.
heard is where the scanner parked and for how long, which distinguishes intermittent signals
such as airband calls; on a band of continuous carriers it parks on the first one it finds and
stays, so heard names one station where active names them all. It only finds what it
lands on, so the step has to match the channel spacing the band actually uses:
a step that is too coarse lands beside the channels rather than on them, and a channel wide
enough to catch the neighbour then reports it 100 kHz off and weaker, where nothing decodes.
Give stepFrequency only to override the spacing below; without it scan uses the spacing
usual for the mode.
| What | mode |
Range | Spacing | Notes |
|---|---|---|---|---|
| Broadcast FM | bfm |
87.5 to 108 MHz | 100 kHz | The Americas use only the odd tenths, 200 kHz apart; everywhere else every tenth. scan insists on 100 kHz for this mode |
| Airband voice | am |
118 to 137 MHz | 25 kHz | Europe also uses 8.33 kHz channels (stepFrequency 8333 from a 25 kHz frequency lands on all of them). The whole band at 8.33 kHz is over the 2000 frequency limit, so take it in sub bands |
| Marine VHF, PMR446, amateur FM | nfm |
156 to 162 MHz marine, 446.0 to 446.2 MHz PMR, 144 to 146 and 430 to 440 MHz amateur | 12.5 kHz (PMR446 6.25 kHz, marine 25 kHz) | |
| Digital voice | dmr, dpmr, dstar, ysf, nxdn |
Same bands as nfm |
12.5 kHz (dPMR and NXDN 2400 baud 6.25 kHz) | Each sets the DSD demodulator's FM deviation and baud rate for the standard (DMR 5.4 kHz, dPMR 2.7 kHz at 2400 baud, D-Star 3.5 kHz, YSF 7 kHz, NXDN 2.7 kHz; nxdn24 for the 2400 baud variant), which the decoder needs to recover symbols; dsd alone is the plugin's defaults, D-Star's. DMR gets both time slots on. Detects the carrier; decoding voice needs the AMBE feature or hardware |
| POCSAG pagers | pager |
Regional, commonly 138 to 160 MHz | 12.5 kHz | Finds the carriers; the messages themselves are shown only in the GUI, the API carries none |
| Radiosondes (RS41) | sonde |
400 to 406 MHz | 10 kHz | Only worth it around launch times, 00:00 and 12:00 UTC. Decoded frames come from get_packets |
| SSB and CW | ssb, usb, lsb |
HF band segments | 3 kHz | The scanner measures power in a 3 kHz channel; a busy band segment needs the threshold raised |
Do not scan for these; they are on fixed frequencies, so listen or add_channel is the tool:
- ADS-B: 1090 MHz only.
- DroneID: 2399.5, 2414.5, 2429.5, 2444.5, 2459.5 and 2474.5 MHz, and 5721.5 to 5831.5 MHz.
A drone stays on one channel for many bursts, but can change channel and band. Set the
channel's
scansetting to 1 to step through them, pausing where bursts are found (scanBand0 = 2.4 GHz, 1 = 5.8 GHz, 2 = both). It retunes the device, so don't use it while other channels need the device frequency. - DAB: fixed Band III blocks 5A to 13F (174.928 to 239.200 MHz, 1.712 MHz apart). Start a
dabchannel on each block in turn and read the programme list from its report. - DRM: the frequencies in the broadcasters' published schedules; listen to each directly.
- AIS: 161.975 and 162.025 MHz.
- DSC: 2187.5 kHz, 8414.5 kHz, 16804.5 kHz and 156.525 MHz.
- NAVTEX: 518, 490 and 4209.5 kHz.
- APRS: 144.800 MHz in Europe, 144.390 MHz in North America.
- Time signals, Inmarsat, end of train: the frequencies in the tables above.
Frequencies asked for by name
| Name | Frequency |
|---|---|
| Airband guard (emergency) | 121.500 MHz |
| Airband air to air | 123.450 MHz |
| Marine channel 16 (distress and calling) | 156.800 MHz |
| Marine channel 70 (DSC, data not voice) | 156.525 MHz |
| Marine channels 6, 12, 13, 67 | 156.300, 156.600, 156.650, 156.375 MHz |
| PMR446 channels 1 to 16 | 446.00625 MHz plus 12.5 kHz per channel, to 446.19375 MHz |
| 2 m amateur FM calling | 145.500 MHz in Europe, 146.520 MHz in North America |
| 70 cm amateur FM calling | 433.500 MHz in Europe, 446.000 MHz in North America |
DAB Band III blocks, for one dab channel per block (1.712 MHz apart; the ensemble on each
depends on the country, and its report names it):
| Block | MHz | Block | MHz | Block | MHz | Block | MHz |
|---|---|---|---|---|---|---|---|
| 5A | 174.928 | 7A | 188.928 | 9A | 202.928 | 11A | 216.928 |
| 5B | 176.640 | 7B | 190.640 | 9B | 204.640 | 11B | 218.640 |
| 5C | 178.352 | 7C | 192.352 | 9C | 206.352 | 11C | 220.352 |
| 5D | 180.064 | 7D | 194.064 | 9D | 208.064 | 11D | 222.064 |
| 6A | 181.936 | 8A | 195.936 | 10A | 209.936 | 12A | 223.936 |
| 6B | 183.648 | 8B | 197.648 | 10B | 211.648 | 12B | 225.648 |
| 6C | 185.360 | 8C | 199.360 | 10C | 213.360 | 12C | 227.360 |
| 6D | 187.072 | 8D | 201.072 | 10D | 215.072 | 12D | 229.072 |
| 13A | 230.784 | 13B | 232.496 | 13C | 234.208 | 13D | 235.776 |
| 13E | 237.488 | 13F | 239.200 |
Reading the results
Decoded output lands in one of three places, depending on the mode. Reading the wrong one looks like an empty band.
| Mode | Where the output is | What to read |
|---|---|---|
Voice: nfm, am, ssb, bfm, wfm, dsd |
Audio on the default output | capture_audio records a few seconds and reports the peak level, which tells silence (squelch closed, or nothing there) from speech |
| Broadcast FM | Channel report | BFMDemodReport.rdsReport: station name, programme type, radio text, once RDS has locked |
| DAB | Channel report | DABDemodReport: sync, snr, cn, mscBER, gainAdvice, ensembleName, programs; select a programme with set_channel_settings and read audioActive (see Checking DAB reception quality) |
| DVB-T and DVB-T2 (and DVB-S and S2) | Channel report | DVBDemodReport: state (Locked when the transport stream is being decoded), standard, mode, constellation, codeRate, mer, and postViterbiBER for DVB-T and DVB-S (below 2e-4 is error free) or ldpcIterations and bchFailures for DVB-T2 and DVB-S2; for DVB-S2 also modcod, esN0 (dB, compare with the MODCOD's threshold), plFrames and plHeaderMisses, and measuredSymbolRate for both satellite standards. What's on: epgNowTitle, epgNowStart (UTC), epgNowDuration (s), epgNowDescription and epgNextTitle, epgNextStart of epgServiceId (the serviceId setting, or the first TV service); the guide takes a minute or so to arrive, and is cached. Recording to .ts files in recordDirectory: channel_action {"record": 1} (or 0 to stop) records the service selected, or with recordMode 0 the whole multiplex; {"recordEvent": 1, "serviceId": id, "eventId": id} records a programme from the guide (0 cancels), starting recordStartPadding s early and ending recordEndPadding s late; the report has recording, recordingFile, recordingSize and scheduledRecordings. channel_action {"play": 1, "serviceId": id} plays a service from the guide, retuning the device to its multiplex if it's on another. Audio and subtitles: audioLanguage and subtitleLanguage (ISO 639-2, e.g. eng), audioDescription 1 to mix in audio description and subtitles 1 to show subtitles, where the service has them. Video, the service list and the full guide are in the GUI; with udpEnabled the transport stream goes to udpAddress:udpPort for VLC |
| DRM | Channel report | DRMDemodReport: syncState, mscMERDB, services, audioActive, textMessage, error; select a service with set_channel_settings (see Checking DRM reception) |
| ADS-B | Map items | get_map_items lists the aircraft with position, altitude, heading and callsign; the channel report only has counts and the tracked target |
| AIS, APRS and AX.25, LoRa, M17, Meshtastic, MeshCore, Inmarsat, radiosondes, chirpmodem | Packet buffer | get_packets, which decodes AIS position reports, APRS positions, RS41 frames and chirpmodem MAC frames. Ships, stations and sondes also appear in get_map_items when the Map feature is present |
| DroneID | Packet buffer and map items | get_packets decodes serial number, model, drone position, altitude and speed, and pilot and home positions. get_map_items lists the drone, pilot and home point when the Map feature is present |
| VOR | Channel report | VORDemodReport.radial with validRadial, and the Morse ident |
| Pagers, DSC, NAVTEX, RTTY, FT8 | GUI only | The decoded messages are shown in the plugin's window; the API carries the channel power only. Say so rather than reporting the band as empty |
How long to wait before reading: RDS a few seconds, the full station name up to ten; DAB sync about two seconds and the programme list five to ten; DRM lock a few seconds and the service labels and audio up to ten; ADS-B ten seconds if aircraft are in range; AIS half a minute, as each ship transmits every few seconds at most; APRS minutes, as stations transmit rarely; radiosonde frames once a second while a sonde is up; DroneID several seconds, as the drone only spends part of the time on any one channel; VOR a few seconds for a valid radial. A single read immediately after tuning proves nothing; read the report again after the interval before concluding a signal has no data.
What has been on a band over time
One spectrum is one instant. get_spectrum_history reads the history the GUI keeps for
scrolling the waterfall, switching scrolling on if it is off, and reports per bin the maximum,
the mean and the occupancy over the last seconds, plus a signalList: every run of bins
that rose above the floor, with its frequency, width, peak, dutyCycle and when it was first
and last seen. A carrier has a duty cycle near 1, a voice channel a fraction, a pager burst
almost nothing; a hopper shows as many short signals. It costs no channels and no retuning, so
it is the first thing to try on an unfamiliar band, before scan. Only rows taken with the
device tuned and sampling as it is now count, so after a retune wait for new history.
get_waterfall_image shows the same history as a picture, frequency across and time down,
for the cases where the shape matters: drift, hopping, burst timing.
Judging a signal level
Power figures (signalDb, channelPowerDB, the scanner's power) are relative to the device
and its gain, so no fixed number means "signal present". Compare against the noise floor
instead: scan measures it, reports it as noiseFloorDb and sets its own threshold 12 dB
above it. Treat a channel within about 6 dB of the floor as empty, and a reading of -150 as
"not settled yet", which listen says when it sees it. A real signal stands out by 15 dB or
more, a broadcast FM station typically by 20 to 30 dB. When everything reads at the floor,
the receiver is not hearing anything at all: check the device is running, the gain, and the
antenna, in that order.
Gain
tune_gain finds the gain for you: it steps the device through its range, measures the noise
floor and the strongest signal (or the one at a given frequency) at each, and applies the gain
where the signal stands furthest above the floor, preferring the lower of any that tie. On a
quiet band it goes by the floor alone: the lowest gain at which the antenna's noise, not the
converter's, sets the floor, short of overload. Use it
after tuning to the band of interest and before judging weak signals; the reply's table shows
where the front end starts to overload. It turns the device's AGC off, which a manual gain
requires. It knows the RTL-SDR, HackRF, Airspy, LimeSDR, PlutoSDR and USRP; for another
device read describe_settings and give it the gain key and values. listen and scan run
it themselves when they create a device set or move one to another band, and say what they
set; pass tuneGain false to keep a gain you have chosen. Once the gain is applied the main
spectrum is autoscaled, so its reference level and range suit the new gain; autoscale
false leaves the display as it was. A change of mode or a move within a
band does not trigger it, as the gain suits the band and the antenna rather than the mode.
RTL-SDR gain is in tenths of a decibel (402 is 40.2 dB) and only the values in
get_device_report's supported list take effect; agc hands control to the tuner, which is
poor on weak signals. listen and scan set 40 dB with AGC off on a device set they create,
and leave one they found exactly as it was set. Too little gain shows as every channel at
the floor; too much as a collapsing SNR on a strong signal, distortion, and spurious copies
of strong stations across the band. When a strong signal decodes badly, reduce gain by one
supported step and read the report again, as the DAB section above describes; keep the
setting that gives the best SNR rather than the highest level.
RDS is the first casualty of overload: a broadcast FM station can sound clean and still decode
no RDS groups at all when the front end is compressed, and the report may then claim stereo
while showing no pid. On a strong-signal site the RTL-SDR decodes RDS best with only a few dB
of gain. Decimation matters too: a 180 kHz channel in a 256 kS/s baseband sits against the edge
of the decimation filters, so listen and scan use 512 kS/s or more for broadcast FM, and
put the channel far enough from the device centre that the DC spike is outside it.
Utility channels
These do not demodulate a protocol but are useful for looking and recording.
| What | Channel | Use |
|---|---|---|
FileSink |
Records baseband IQ to a file | The capture tools use this |
SigMFFileSink |
Records IQ in SigMF format | For interchange with other tools |
ChannelAnalyzer |
Inspects a signal's spectrum and waveform | For working out what an unknown signal is |
FreqScanner |
Scans a range for activity | For finding active frequencies |
ChannelPower |
Measures power in a channel | For comparing signal strengths |
HeatMap |
Maps signal strength against position | Coverage surveys |
Common reasons nothing is received
- The device is not running. Call
start_device. Settings can be changed while stopped, but no samples flow. - The signal is outside the device bandwidth. A channel's
inputFrequencyOffsetis relative to the device centre frequency, and must fall within half the sample rate either side. - The sample rate is below the minimum for the mode, most often with ADS-B.
- The device cannot tune there. An RTL-SDR covers about 24 to 1766 MHz; below that (DSC,
NAVTEX, FT8, AM, SSB and DRM on HF, the time signals) it receives only in direct sampling mode
(
noModModein its settings, with poor sensitivity) or through an upconverter. Check the device's readme for its range before tuning outside VHF and UHF. - The radio is already in use. One dongle serves one device set.
listenandscanreuse the set that holds it;add_devicesetfor the same hardware fails or fights for it. Put a second frequency on the same set as another channel, if its offset fits the baseband. - The squelch is closed.
capture_audioreports the peak level and warns when the audio is silent, which usually means squelch rather than a broken setup. - Gain is too low or too high. Too low buries the signal in noise; too high overloads the front end. Check the device report and the spectrum.
- The antenna is wrong for the band. Nothing in software fixes a 2 metre whip at 1090 MHz.
- A bias tee is needed for a powered antenna or LNA, and is off by default.
- The satellite or balloon is not overhead. APT, radiosondes and Inmarsat all depend on this.