Load FPGA and firmware images for USRP radio
sdruload( loads the default FPGA and
UHD™ firmware images for device specified. For example,
Name,Value pair specifying the device is required, other
Name,Value pairs are optional.
Firmware images are the UHD versions compatible with the Communications Toolbox™ Support Package for USRP™ Radio.
If the device is an N2xx or X3xx series radio, this syntax loads the default images to the radio at IP address 192.168.10.2.
If the device is a USRP2™ radio, this syntax writes the images to an SD card.
You can obtain the compatible UHD version number by entering
getSDRuDriverVersionat the MATLAB® command prompt.
the status information of the call to
STATUS = sdruload(___)
sdruload uses the
uhd_image_loader utility or the
usrp2_card_burner.py Python script provided by Ettus Research™ for burning firmware images to the device.
When burning images with the card burner, it is possible for you to overwrite your hard drive. To avoid accidentally overwriting the wrong drive, when using the card burner script, carefully select the correct drive for the radio.
Load Custom FPGA to N210 Device
Load a custom FPGA image to an N210 device and return the status of the operation.
status = sdruload('Device','N210','IPAddress','192.168.30.8',... 'FPGAImage','c:\sdru\uhdapps\images\usrp_n210_r4_fpga_ex.bin')
Checking radio connections... Ready to write FPGA image usrp_n210_r4_fpga_ex.bin and default firmware image to n210 device at 192.168.30.8. Would you like to continue? [yes/no]: yes Writing images using uhd_image_loader ... ==== Start messages from third party application ==== linux; GNU C++ version 4.9.3; Boost_105600; UHD_003.009.004-vendor Unit: USRP N210 r4 (ECR16TEUP, 192.168.30.8) Firmware image: c:\sdru\uhdapps\images\usrp_n210_fw.bin -- Erasing firmware image...successful. -- Writing firmware image (0%) -- Writing firmware image (1%) . . . -- Writing firmware image (98%) -- Writing firmware image...successful. -- Verifying firmware image (0%) -- Verifying firmware image (1%) . . . -- Verifying firmware image (98%) -- Verifying firmware image...successful. FPGA image: c:\sdru\uhdapps\images\usrp_n210_r4_fpga_ex.bin -- Erasing FPGA image...successful. -- Writing FPGA image (0%) ... -- Writing FPGA image (99%) -- Writing FPGA image...successful. -- Verifying FPGA image (0%) . . . -- Verifying FPGA image (99%) -- Verifying FPGA image...successful. -- Resetting device...successful. ==== End messages from third party application ==== status = logical 1
Specify optional pairs of arguments as
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.
Device — USRP radio
USRP radio, specified as a comma-separated pair consisting of
'Device' and a USRP radio device from this set
Name,Value is required.
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.
Additional software must be installed prior to executing
sdruloadto load firmware for an
'USRP2'radio. For more information, see Update USRP2 Radio Firmware.
IPAddress — IP address where the N2xx or X3xx series radio is located
IP address where the N2xx or X3xx series radio is located, specified
as a comma-separated pair consisting of
a valid IP address.
Drive — SD card drive
Valid SD card drive for USRP2 device, specified as a comma-separated
pair consisting of
'Drive' and a valid SD card
Device is specified as
the images for a USRP2 radio to an SD card at the SD card drive
specified. If you do not specify a value for
the function searches for possible SD card drives and prompts you
to select one.
This option uses the uhd_image_loader utility provided by Ettus Research.
FPGAImage — FPGA image
FPGA image, specified as a comma-separated pair consisting of
a valid FPGA image file. Use this option to load the FPGA image that
is compatible with the UHD version supported by MATLAB and Simulink®.
You can also use this option to load custom FPGA images, including images you generate using the HDL workflow advisor. For more information, see HDL Coder™.
Custom FPGA image uploading is not supported for X300 or X310.
FirmwareImage — Firmware image
Firmware image, specified as a comma-separated pair consisting
'FirmwareImage' and a valid firmware image file.
Use this option to load the UHD firmware image that is compatible
with the UHD version supported by MATLAB and Simulink.
Custom firmware image updating is not supported for X300 or X310.
STATUS — Status of call to
Status of call to
sdruload, returned as
the operation was successful.
Introduced in R2013b