sdruload

Load FPGA and firmware images for USRP radio

Syntax

sdruload('Device'=radioDevice)

sdruload('Device'=radioDevice, Name=Value)

STATUS = sdruload(___)

Description

sdruload('Device'=radioDevice) loads the default FPGA and UHD™ firmware images for the specified device. For example, sdruload('Device'='X300').

Firmware images are the UHD versions compatible with the Communications Toolbox™ Support Package for USRP™ Radio. This syntax loads the default images to the radio at IP address 192.168.10.2. You can obtain the compatible UHD version number using the getSDRuDriverVersion function.

sdruload('Device'=radioDevice, Name=Value) specifies options using one or more name-value arguments in addition to the input arguments in the previous syntax. For example, to specify the IP address where the radio is located as 192.168.10.2, set 'IPAddress' to '192.168.10.2'.

STATUS = sdruload(___) returns the status information of the call to sdruload.

Examples

Load Default FPGA Image to X300 Device

Load the default FPGA image to an X300 device and return the status of the operation.

status = sdruload('Device'='X310','IPAddress'='192.168.30.5')

Checking radio connections...
Ready to write default FPGA image to x310 device at 192.168.10.2.
Would you like to continue? [yes/no]: yes
Writing FPGA image using uhd_image_loader...
This may take a few minutes and the device will reboot...
Do NOT interrupt this process. Otherwise your device may be bricked.
Image was written successfully.


status =

  logical

   1

Input Arguments

'Device' — USRP radio

'x300' | 'x310' | 'n300' | 'n310' | 'n320' | 'n321'

USRP radio, specified as a USRP radio device from this set {'x300', or 'x310','n300','n310','n320','n321'}.

• If you specify an invalid device, MATLAB^® responds displaying the list of valid devices.

• If the device you specify does not match the device connected, the error message returned by MATLAB lists the connected device name and prompts you to specify the connected device or to connect another device.

Example: 'IPAddress'='192.168.10.2'

Name-Value Arguments

Specify optional pairs of arguments as Name1=Value1,...,NameN=ValueN, where Name is the argument name and Value is the corresponding value. Name-value arguments must appear after other arguments, but the order of the pairs does not matter.

Before R2021a, use commas to separate each name and value, and enclose Name in quotes.

Example: 'Device'='X300'

IPAddress — IP address where the radio is located

character vector

IP address where the radio is located, specified as a comma-separated pair consisting of 'IPAddress' and a valid IP address.

If you changed the IP address from the default when you set up your radio using the Radio Setup wizard, use the radioConfigurations function to find the IP address.

Example: 'IPAddress'='192.168.10.2'

Output Arguments

STATUS — Status of call to sdruload

logical

Status of call to sdruload, returned as true if the operation was successful.

Tips

Use the sdruload function to reload the default hardware image onto your radio device after using a Wireless Testbench™ object that uses a custom prebuilt hardware image. For details, see Wireless Testbench Applications on NI USRP radios.

Version History

Introduced in R2013b

R2024a: Support for N3xx series radio devices

You can now use the sdruload to load FPGA and firmware images for USRP N3xx series devices.

R2024a: Support for N3xx and X3xx series radio devices moved to Wireless Testbench

Support for NI™ USRP N3xx and X3xx series radio devices has moved from Communications Toolbox Support Package for USRP Radio to Wireless Testbench Support Package for NI USRP Radios.