info

Characteristic information of RTL-SDR device

collapse all in page

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.

example

Examples

collapse all

This example uses:

Open Live Script

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

collapse all

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

Output Arguments

collapse all

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.

Device name, returned as a character vector.

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

Tuner chip name, returned as a character vector.

Manufacturer name, returned as a character vector.

Product name, returned as a character vector.

Receiver gain values, returned as a vector of integers.

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

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

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

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

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

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

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

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

See Also