sdrdev

Create radio object for interfacing with USRP® embedded series radio hardware

Description

example

dev = sdrdev(DeviceName) creates a radio object to interface with the USRP®[1] 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

collapse all

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

dev = sdrdev('E3xx')
dev = 

   SDRDevE3xx with properties:
 
     IPAddress: '192.168.3.2'
    DeviceName: 'E3xx'

You can 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: ''E310' default bitstream, Path: /mnt/system.bit, 
               MD5: c248af50bff03fb6f4fb4150ab6d2d1a''
           
           

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

collapse all

Name of USRP® embedded series radio hardware, specified as one of these character vectors:

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

    • USRP® E310

    • USRP® E312

  • 'E310' (to be removed) — Use this option to interface with any of the following radio hardware devices:

    • USRP® E310

    • USRP® E312

Data Types: char | string

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

collapse all

Interface to the radio hardware, returned as a USRP® embedded series radio object. For example:

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

Introduced in R2016b


[1] USRP, USRP2, UHD, and Ettus Research are trademarks of National Instruments Corp.