info

Characteristic information of RTL-SDR device

Add-On Required: This feature requires the Communications Toolbox Support Package for RTL-SDR Radio add-on.

Syntax

infostruct = info(radio)

Description

infostruct = info(radio) returns the characteristic information for the specified RTL-SDR device.

Examples

Receive Streaming RTL-SDR Data

Receive streaming data from an RTL-SDR device.

Create and initialize an RTL-SDR receiver object. Inspect the object properties.

rxsdr = comm.SDRRTLReceiver('0','CenterFrequency',88.9e6,'SampleRate',250000, ...
    'SamplesPerFrame',2048,'EnableTunerAGC',true,'OutputDataType','double')

rxsdr = 
  comm.SDRRTLReceiver with properties:

           RadioAddress: '0'
        CenterFrequency: 88900000
         EnableTunerAGC: true
             SampleRate: 250000
         OutputDataType: 'double'
        SamplesPerFrame: 2048
    FrequencyCorrection: 0
        EnableBurstMode: false

radioInfo = info(rxsdr)

radioInfo = 
    The following values show radio settings, not the property 
    values of RTL-SDR receiver System object. For more information, 
    type 'help comm.SDRRTLReceiver'.

                RadioName: 'Generic RTL2832U OEM'
             RadioAddress: '0'
                TunerName: 'R820T'
             Manufacturer: 'Realtek'
                  Product: 'RTL2838UHIDIR'
               GainValues: [0 0.9000 1.4000 2.7000 3.7000 7.7000 8.7000 12.5000 14.4000 15.7000 16.6000 19.7000 20.7000 22.9000 25.4000 28 29.7000 32.8000 33.8000 36.4000 37.2000 38.6000 40.2000 42.1000 43.4000 43.9000 44.5000 48 49.6000]
      RTLCrystalFrequency: 28800000
    TunerCrystalFrequency: 28800000
             SamplingMode: 'Quadrature'
             OffsetTuning: 'Disabled'
          CenterFrequency: 88900000
               SampleRate: 250000
      FrequencyCorrection: 0

Stream data from the device. Release the object when finished using it.

for p=1:1000
    rxdata = rxsdr();
end
release(rxsdr)

Input Arguments

radio — RTL-SDR device

comm.SDRRTLReceiver System object™

RTL-SDR device, specified as a comm.SDRRTLReceiver System object. This RTL-SDR device must be connected to the host computer.

Output Arguments

infostruct — Information about RTL-SDR device

structure

Information about the RTL-SDR device, returned as a structure containing these fields. The returned values show the radio settings, not property values of the RTL-SDR device System object specified by the radio input.

RadioName — Device name

character vector

Device name, returned as a character vector.

RadioAddress — USB address of RTL-SDR device

character vector

USB address of the RTL-SDR device, returned as a character vector.

TunerName — Tuner chip name

character vector

Tuner chip name, returned as a character vector.

Manufacturer — Manufacturer name

character vector

Manufacturer name, returned as a character vector.

Product — Product name

character vector

Product name, returned as a character vector.

GainValues — Receiver gain values

vector of integers

Receiver gain values, returned as a vector of integers.

RTLCrystalFrequency — RTL crystal frequency

positive integer

RTL crystal frequency in Hz, returned as a positive integer.

TunerCrystalFrequency — Tuner crystal frequency

positive integer

Tuner crystal frequency in Hz, returned as a positive integer.

SamplingMode — Direct sampling mode

'Quadrature' | 'Direct I' | 'Direct Q'

Direct sampling mode, returned as 'Quadrature', 'Direct I', or 'Direct Q'. When the function returns SamplingMode as 'Quadrature', direct sampling is disabled.

OffsetTuning — Offset tuning mode

'Disabled' | 'Enabled'

Offset tuning mode, returned as 'Disabled' or 'Enabled'.

CenterFrequency — Actual center frequency

positive integer

Actual center frequency in Hz, returned as a positive integer.

SampleRate — Actual sample rate

positive integer

Actual sample rate in samples per second, returned as a positive integer.

TunerGain — Actual AGC value

scalar

Actual automatic gain control (AGC) value in dB, returned as a scalar.

FrequencyCorrection — Actual frequency correction value

positive integer

Actual frequency correction value in ppm, returned as a positive integer.

Tips

• The actual radio computed value and your specified setting can differ. To confirm that the actual radio computed value is close enough to your specified setting, use this info function with the System object at the input radio.

Version History

Introduced in R2014a