Main Content


Load FPGA and firmware images for USRP radio



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 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, set 'IPAddress' to ''.


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


collapse all

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

status = sdruload('Device'='X310','IPAddress'='')
Checking radio connections...
Ready to write default FPGA image to x310 device at
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 =



Input Arguments

collapse all

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'=''

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'

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'=''

Output Arguments

collapse all

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


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

expand all