sdrdev

Create radio object for interfacing with USRP embedded series radio hardware

Add-On Required: This feature requires the Communications Toolbox Support Package for USRP Embedded Series Radio add-on.

Syntax

dev = sdrdev(DeviceName)

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

sdrdev

list = sdrdev

Description

dev = sdrdev(DeviceName) creates a radio object to interface with the USRP™ embedded series 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(DeviceName,'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 USRP Embedded Series 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 USRP E3xx 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 radio hardware.

dev = sdrdev('E3xx')

dev = 
  SDRDevE3xx with properties:

     IPAddress: '192.168.3.2'
    DeviceName: 'E3xx'

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: 33a4ba3394d87d450fb69d6f9a84bbbf'

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 USRP embedded series radio hardware

'E3xx'

Name of USRP embedded series radio hardware, specified as 'E3xx'. You can interface with any of these radio hardware devices:

• USRP E310

• USRP E312

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 the IPAddress accordingly.

Data Types: char | string

Output Arguments

dev — Interface to the radio hardware

comm.SDRDevE3xx radio object

Interface to the radio hardware, returned as a comm.SDRDevE3xx radio object.

list — Names of USRP embedded series radio hardware

cell array of character vectors

Names of USRP embedded series radio hardware, returned as a cell array of character vectors.

Version History

Introduced in R2016b