sdruload

Load FPGA and firmware images for USRP radio

collapse all in page

Add-On Required: This feature requires the Wireless Testbench™ Support Package for NI™ USRP™ Radios add-on.

Syntax

sdruload(Device=radioDevice)
sdruload(___,Name=Value)
status = sdruload(___)

Description

sdruload loads the default FPGA and UHD™ firmware images to a USRP™ E320, N3xx series, X3xx series, or X410 radio that is connected to the host computer; for 200-series USRP radios, see the Communications Toolbox™ documentation. For details, see sdruload.

sdruload(Device=radioDevice) loads the default FPGA and UHD firmware images for the specified device, Device, to a radio at the default IP address, 192.168.10.2. If your radio is not at the default IP address, use an alternative syntax to specify the IP address.

Note

The default FPGA image provided by the hardware vendor is used to enable Wireless Testbench™ Live Data I/O features.

Firmware images are the UHD versions compatible with Wireless Testbench Support Package for NI™ USRP Radios. You can obtain the compatible UHD version number using the getSDRuDriverVersion function.

example

sdruload(___,Name=Value) specifies options using one or more name-value arguments in addition to the input arguments in the previous syntaxes. For example, to load the default FPGA image to radio at the IP address 192.168.20.2, set the IPAddress name-value argument to 192.168.20.2.

example

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

example

Examples

collapse all

Open Live Script

Load the default FPGA and firmware image to a USRP radio and return the status of the operation.

status = sdruload(Device='N320',IPAddress='192.168.20.2')
Loading bitstream to FPGA...
Loading bitstream to FPGA is now complete.

status = logical
   1

Input Arguments

collapse all

USRP radio, specified as one of the following options:

  • 'e320' — A connected USRP E320 radio. (since R2025a)

  • 'n300' — A connected USRP N300 radio.

  • 'n310' — A connected USRP N310 radio.

  • 'n320' — A connected USRP N320 radio.

  • 'n321' — A connected USRP N321 radio.

  • 'x300' — A connected USRP X300 radio.

  • 'x310' — A connected USRP X310 radio.

  • 'x410' — A connected USRP X410 radio. (since R2025a)

Example: Device='x310'

Name-Value Arguments

collapse all

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: IPAddress='192.168.20.2'

IP address where the radio is located, specified as a dotted-quad character vector. Specify a valid IP address for a radio that you have connected and set up using the Radio Setup wizard.

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

Example: IPAddress='192.168.10.2'

Since R2025a

FPGA image, specified as one of the following options:

  • 'E320_1G' — Loads the 1G variant of the FPGA image to a USRP E320 radio. This FPGA image supports 1 Gigabit streaming rates on the SFP+ port.

  • 'E320_XG' — Loads the XG variant of the FPGA image to a USRP E320 radio. This FPGA image supports 10 Gigabit streaming rates on the SFP+ port.

For more information about how to set up a USRP E320 radio with a 10 Gigabit Ethernet connection, see Set Up USRP E320 Radio for 10 Gigabit Ethernet.

Output Arguments

collapse all

Status of call to sdruload, returned as a logical value. status is returned as true if the FPGA image and firmware image load is 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

expand all

See Also

Functions

Objects

Blocks

Topics