sdrrx

Create receiver System object for Xilinx Zynq-based radio hardware

Syntax

rx = sdrrx(DeviceName)

rx = sdrrx(DeviceName,Name,Value)

Description

rx = sdrrx(DeviceName) creates a receiver System object™ with default properties that receives data from the radio hardware specified by DeviceName. The object receives data over a gigabit Ethernet network connection.

When you call the receiver System object, the object connects to the radio hardware. The object stays connected until you call the release function. For more information on how to use the object, see the documentation of the corresponding System object.

rx = sdrrx(DeviceName,Name,Value) specifies additional properties using one or more Name,Value pair arguments. Unspecified properties take default values.

Examples

Receive Data from AD936x-Based Radio Hardware

Make sure your radio hardware is configured for host-radio communication by following the steps in Guided Host-Radio Hardware Setup.

Create a receiver System object for the AD936x-based Zynq radio hardware with the specified properties. Use a single channel.

rx = sdrrx('AD936x', ...
    'IPAddress','192.168.3.2', ...
    'CenterFrequency',2.2e9, ...
    'BasebandSampleRate',800e3, ...    
    'ChannelMapping',1)

rx = 
  comm.SDRRxAD936x with properties:

   Main
                DeviceName: 'AD936x'
                 IPAddress: '192.168.3.2'
           CenterFrequency: 2.2000e+09
                GainSource: 'AGC Slow Attack'
            ChannelMapping: 1
        BasebandSampleRate: 800000
            OutputDataType: 'int16'
           SamplesPerFrame: 20000
           EnableBurstMode: false
    ShowAdvancedProperties: false

  Show all properties

Create a log for recording data.

Log = dsp.SignalSink;

Receive and validate data by using the receiver System object. Save valid data using the log.

for counter = 1:20
    [data,validData,overflow] = rx();
    if validData == 1 
        if overflow ~=1 % contiguous data
             Log(data);
        end
    else
        disp('Not valid data.');
    end
end 

## Establishing connection to hardware. This process can take several seconds.

Receive Data from FMCOMMS5 Radio Hardware

Make sure your radio hardware is configured for host-radio communication by following the steps in Guided Host-Radio Hardware Setup.

Create a receiver System object for the FMCOMMS5 radio hardware with the specified properties. Use two channels.

rx = sdrrx('FMCOMMS5', ...    
    'IPAddress','192.168.3.2', ...
    'CenterFrequency',2.2e9, ...
    'BasebandSampleRate',800e3, ...    
    'ChannelMapping',[1 2])

rx = 
  comm.SDRRxFMCOMMS5 with properties:

   Main
                DeviceName: 'FMCOMMS5'
                 IPAddress: '192.168.3.2'
           CenterFrequency: 2.2000e+09
                GainSource: 'AGC Slow Attack'
            ChannelMapping: [1 2]
        BasebandSampleRate: 800000
            OutputDataType: 'int16'
           SamplesPerFrame: 20000
           EnableBurstMode: false
    ShowAdvancedProperties: false

  Show all properties

Create a log for recording data.

Log = dsp.SignalSink;

Receive and validate data by using the receiver System object. Save valid data using the log.

for counter = 1:20
    [data,validData,overflow] = rx();
    if validData == 1 
        if overflow ~=1 % contiguous data
             Log(data);
        end
    else
        disp('Not valid data.');
    end
end 

## Establishing connection to hardware. This process can take several seconds.

Input Arguments

DeviceName — Name of Xilinx^® Zynq^®-based radio hardware

character vector

Name of Xilinx Zynq-based radio hardware, specified as one of the these character vectors:

• 'AD936x' — Use this option to interface with any of the following radio hardware devices:

  • ADI RF SOM

  • Xilinx ZC706 with Analog Devices^® FMCOMMS2/3/4 RF card

  • ZedBoard™ with Analog Devices FMCOMMS2/3/4 RF card

  • Xilinx ZCU102 with Analog Devices FMCOMMS2/3/4 RF card

• 'FMCOMMS5' — Use this option to interface with a Xilinx ZC706 radio hardware with Analog Devices FMCOMMS5 RF card.

Data Types: char | string

Name-Value Pair Arguments

Specify optional comma-separated pairs of Name,Value arguments. Name is the argument name and Value is the corresponding value. Name must appear inside quotes. You can specify several name and value pair arguments in any order as Name1,Value1,...,NameN,ValueN.

Example: 'CenterFrequency',2.5e9

For a full list of property names and values, see the reference page of the corresponding receiver System object rx.

Output Arguments

rx — Receiver

Xilinx Zynq-based radio System object

Receiver for the specified radio hardware, returned as a Xilinx Zynq-based radio System object. For more information on how to use the object, see the corresponding documentation:

• comm.SDRRxAD936x

• comm.SDRRxFMCOMMS5