sdrdev

Create radio object for interfacing with Xilinx Zynq-based radio hardware

Syntax

dev = sdrdev(DeviceName)

dev = sdrdev(___,'IPAddress',IPAddress)

sdrdev

list = sdrdev

Description

dev = sdrdev(DeviceName) creates a radio object to interface with the radio hardware identified by DeviceName. This object enables you to configure the radio hardware and host computer for proper communication. To verify host-hardware communication, call info(dev) after creating the radio object.

Note

To receive or transmit data through the radio, you must create a receiver or a transmitter System object™ instead of a radio object. To create these objects, use the sdrrx and sdrtx functions.

dev = sdrdev(___,'IPAddress',IPAddress) creates a radio object for the specified IP address. Use this syntax only if you configure the radio hardware with an IP address other than the default during hardware setup.

sdrdev or list = sdrdev lists supported radio device names included with the Communications Toolbox™ Support Package for Xilinx^® Zynq^®-Based Radio. The list does not reflect what devices are attached to the host. For a list of supported hardware in this support package, see Hardware and Software Requirements.

Examples

Interface with AD936x 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 radio object for your AD936x-based Zynq radio hardware.

dev = sdrdev('AD936x')

dev = 
  SDRDevAD936x with properties:

     IPAddress: '192.168.3.2'
    DeviceName: 'AD936x'

Use this object to get radio hardware information.

info(dev)

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

ans = struct with fields:
       Status: 'Full information'
       libiio: 'Host version: 0.17.g5bdc242'
          HDL: 'PCORE Version: 10.0b'
    Bitstream: 'Custom bitstream loaded, Path: /mnt/system.bit, MD5: fe4892c9e6ac1f5aeb5831c4b3359978'

You can also use this object to test host-radio connectivity.

testConnection(dev)

## Pinging radio IP address
## Checking compatibility of software with hardware
## Testing data path from Zynq board to host
## All tests PASSED.

ans = logical
   1

Interface with 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 radio object for your FMCOMMS5 radio hardware.

dev = sdrdev('FMCOMMS5')

dev = 
  SDRDevFMCOMMS5 with properties:

     IPAddress: '192.168.3.2'
    DeviceName: 'FMCOMMS5'

Use this object to get radio hardware information.

info(dev)

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

ans = struct with fields:
       Status: 'Full information'
       libiio: 'Host version: 0.17.g5bdc242'
          HDL: 'PCORE Version: 10.0b'
    Bitstream: 'Custom bitstream loaded, Path: /mnt/system.bit, MD5: dee2b953a32c1bcf4ace01e4582c9b19'

You can also use this object to test host-radio connectivity.

testConnection(dev)

## Pinging radio IP address
## Checking compatibility of software with hardware
## Testing data path from Zynq board to host
## All tests PASSED.

ans = logical
   1

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

IPAddress — IP address of radio hardware

'192.168.3.2' (default) | dotted-quad character vector

IP address of the radio hardware, specified as a dotted-quad character vector.

This value must match the physical IP address of the radio hardware assigned during hardware setup. For more information, see Guided Host-Radio Hardware Setup. If you configure the radio hardware with an IP address other than the default, update IPAddress accordingly.

Data Types: char | string

Output Arguments

dev — Interface to the radio hardware

Xilinx Zynq-based radio object

Interface to the radio hardware, returned as a Xilinx Zynq-based radio object. For example:

• comm.SDRDevAD936x

• comm.SDRDevFMCOMMS5

list — Names of Xilinx Zynq-based radio hardware

cell array of character vectors

Names of Xilinx Zynq-based radio hardware, returned as a cell array of character vectors.

Version History

Introduced in R2014b