sdrinfo

Report information about attached RTL-SDR radios

Syntax

HARDWAREINFO = sdrinfo()
HARDWAREINFO = sdrinfo(DEVADDR)

Description

HARDWAREINFO = sdrinfo() returns a cell array of structures with information about all known RTL-SDR radios attached to the host. If the function does not find any radios, the array is empty.

HARDWAREINFO = sdrinfo(DEVADDR) returns a structure with information about a radio attached to the host at the address DEVADDR.

  • The structure of information is specific to the type of radio attached.

  • If you do not specify a device address, the function attempts to find all attached radios.

  • If the function finds an incompatible radio at the specified address, it returns a warning.

Input Arguments

collapse all

DEVADDR is a character vector containing a scalar non-negative integer.

Example: '1' specifies USB address 1.

Output Arguments

collapse all

For USB-connected radios, HARDWAREINFO contains the following radio information:

FieldContains
RadioNameDevice name
RadioAddressUSB address of the RTL-SDR radio
RadioIsOpenFlag for open devices
TunerNameTuner chip name
ManufacturerManufacturer name
ProductProduct name
GainValuesTuner chip supported gain values, in dB. These values are displayed only when the System object™ property EnableTunerAGC is set to false or the block parameter Tuner Gain source is set to Dialog or Property.
RTLCrystalFrequencyRTL chip crystal oscillator frequency, in Hz
TunerCrystalFrequencyTuner chip crystal oscillator frequency, in Hz
SamplingMode

Sampling mode. Values:

  • disabled

  • I-ADC

  • Q-ADC

OffsetTuning

Offset tuning mode. Values:

  • disabled

  • enabled

Note

With an RTL-SDR radio,sdrinfo returns all valid radio fields that are applicable, as long as the System object or block is unlocked. If the block or System object is currently running, sdrinfo returns only the top three fields: RadioName, RadioAddress, and RadioIsOpen.

Examples

Get radio information for an RTL-SDR radio.

hwinfo = sdrinfo('0');
hwinfo = 

                RadioName: 'ezcap USB 2.0 DVB-T/DAB/FM dongle'
             RadioAddress: '0'
              RadioIsOpen: 0
                TunerName: 'R820T'
             Manufacturer: 'Realtek'
                  Product: 'RTL2838UHIDIR'
               GainValues: [29x1 double]
      RTLCrystalFrequency: 28800000
    TunerCrystalFrequency: 28800000
             SamplingMode: 'Quadrature'
             OffsetTuning: 'Disabled'

Call sdrinfo using a USB port address with no radio plugged into the USB port.

>> sdrinfo('0')
ans = 

     {}

The function returns an empty cell array.

See Also

Functions

System Objects

Blocks