info

Characteristic information of RTL-SDR receiver device

Syntax

infostruct = info(rx)

Description

infostruct = info(rx) returns a structure containing characteristic information for the RTL-SDR receiver 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

rx — RTL-SDR receiver System object™ to get information from

comm.SDRRTLReceiver System object

RTL-SDR receiver System object to get information from, specified by the comm.SDRRTLReceiver System object connected to the RTL-SDR device.

Output Arguments

infostruct — Information about RTL-SDR receiver device

structure

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

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 scalars

Receiver gain values, returned as a vector of scalars.

Dependencies

This property applies when the EnableTunerAGC property of the rx object is true.

RTLCrystalFrequency — RTL crystal frequency in Hz

positive integer

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

TunerCrystalFrequency — Tuner crystal frequency in Hz

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 SamplingMode is returned as 'Quadrature', direct sampling is disabled.

OffsetTuning — Offset tuning mode

'Disabled' | 'Enabled'

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

CenterFrequency — Actual current value of center frequency in Hz

positive integer

Actual current value of the center frequency in Hz, returned as a positive integer.

SampleRate — Actual current sample rate in samples per second

positive integer

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

TunerGain — Actual current AGC value in dB

scalar

Actual current AGC value in dB, returned as a scalar.

Dependencies

This property applies when the EnableTunerAGC property of the rx object is false.

FrequencyCorrection — Actual current frequency correction value in ppm

positive integer

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