Main Content

info

Current USRP radio settings

Add-On Required: This feature requires the Wireless Testbench™ Support Package for NI™ USRP™ Radios add-on.

Description

radioSettings = info(radio) returns a structure array containing the current radio settings for the USRP™ radio hardware associated with the SDRu System object™ radio.

example

Examples

collapse all

Create an SDRu transmitter System object for a USRP N320 radio.

radio = comm.SDRuTransmitter(Platform="N320/N321",IPAddress='192.168.20.2');

Set properties on the System object.

radio.CenterFrequency = 912.3456e6;
radio.LocalOscillatorOffset = 1000;
radio.Gain = 8.25122;
radio.InterpolationFactor = 511
radio = 
  comm.SDRuTransmitter with properties:

                 Platform: 'N320/N321'
                IPAddress: '192.168.20.2'
           ChannelMapping: 1
          CenterFrequency: 912345600
    LocalOscillatorOffset: 1000
                     Gain: 8.2512
                PPSSource: 'Internal'
        EnableTimeTrigger: false
              ClockSource: 'Internal'
          MasterClockRate: 200000000
      InterpolationFactor: 511
        TransportDataType: 'int16'
          EnableBurstMode: false

Use the info function to get information from the radio. The function returns the actual values for the radio. The values can vary from the values you specify when you create the associated System object.

info(radio)
ans = struct with fields:
                    Mboard: 'n320'
                  RXSubdev: 'Rhodium'
                  TXSubdev: 'Rhodium'
    MinimumCenterFrequency: 0
    MaximumCenterFrequency: 6.1000e+09
               MinimumGain: 0
               MaximumGain: 60
                  GainStep: 1
           CenterFrequency: 9.1235e+08
     LocalOscillatorOffset: -1.0014e+03
                      Gain: 8.2512
           MasterClockRate: 200000000
       InterpolationFactor: 510
        BasebandSampleRate: 3.9216e+05

Create an SDRu receiver System object for a multichannel radio configuration.

radio = comm.SDRuReceiver(Platform ="X300",IPAddress ='192.168.60.2');
radio.ChannelMapping = [1 2];
radio.CenterFrequency = [1.2 1.3]*1e9;
radio.Gain = [5 6];

Get the radio information by calling the info function.

info(radio)
ans = struct with fields:
                    Mboard: 'X300'
                  RXSubdev: {'UBX RX'  'UBX RX'}
                  TXSubdev: {'UBX TX'  'UBX TX'}
    MinimumCenterFrequency: [-70000000 -70000000]
    MaximumCenterFrequency: [6.0800e+09 6.0800e+09]
               MinimumGain: [0 0]
               MaximumGain: [37.5000 37.5000]
                  GainStep: [0.5000 0.5000]
           CenterFrequency: [1.2000e+09 1.3000e+09]
     LocalOscillatorOffset: 0
                      Gain: [5 6]
           MasterClockRate: 200000000
          DecimationFactor: 512
        BasebandSampleRate: 390625

Input Arguments

collapse all

USRP radio, specified as a comm.SDRuTransmitter or comm.SDRuReceiver System object. This radio must be connected to the host computer.

Output Arguments

collapse all

Synchronized radio settings information, returned as a structure array. These are the actual settings applied to the USRP radio hardware by the associated System object radio. The information returned varies depending on the USRP radio.

If no information is found or the System object is not associated with a USRP radio attached to the host, info returns an empty structure.

Tips

The actual settings applied to the radio can differ from the properties you set on the System object. Use the info function to verify that the applied settings meet your requirements.

Version History

Introduced in R2011b

expand all