Skip to content

Configuring channels for multichannel mode

Tomasz Lemiech edited this page Feb 10, 2018 · 12 revisions

Multichannel mode explained

If you have ever used any graphical SDR console (like SDRSharp or GQRX) you already have an idea of how multichannel mode works. You tune the receiver to a particular center frequency and then you can observe a specific chunk of frequency spectrum all at once. The width of this chunk is equal to the sampling rate configured on the device. Once you have the waterfall running, you may click anywhere on it to listen to any narrowband channel that fits in the spectrum chunk that you see. RTLSDR-Airband does the same thing - except that it can simultaneously demodulate multiple narrowband channels and produce a separate audio stream for each one.

Channel configuration

channels is a list of channels to be received. Each channel is a separate group of settings enclosed in braces { }. As we are working in multichannel mode, you may define any number of channels you want.

Syntax

channels: (
  {
    freq = 123.45;
#   modulation = "am";
#   afc = 0;
    outputs: ( ... );
  }
);

Want more channels? Just repeat the braced section several times and separate individual sections with a comma, like this:

channels: (
  {
    freq = 123.45;
#   modulation = "am";
#   afc = 0;
    outputs: ( ... );
  },
  {
    freq = 123.6;
#   modulation = "am";
#   afc = 0;
    outputs: ( ... );
  }
# , .... more channels here
);

Remember, do not put a comma after the closing brace of the last channel. This is a syntax error.

Explanation of keywords

  • freq (frequency, required) - this is the frequency of your channel of interest.
  • modulation (string, optional) - channel modulation, either "am" (the default) or "nfm". The latter is only available if NFM support has been enabled when building the program, otherwise you will get "unknown modulation" error on program start.
  • afc (integer, optional) - automatic frequency correction. The default is 0 (off). When turned on (by putting a positive number here) it will attempt to switch to adjacent FFT bin in case when the signal power there is higher than in the FFT bin chosen for the configured channel frequency. Most probably you won't need this in practice.
  • outputs (list, required) - a list of outputs where the produced audio is to be sent. Each channel must have at least one output configured.

Now you may want to read about:

Or if you don't need this, jump straight to:

Clone this wiki locally