findsdru

Status of USRP radios connected to host computer

Syntax

A = findsdru

A = findsdru(IPAddress)

A = findsdru(serialNum)

A = findsdru(___,Name=Value)

Description

A = findsdru returns a structure that contains the model number, IP address, serial number, and status of each USRP™ radio that is connected to the host computer.

A = findsdru(IPAddress) returns information for only the USRP radio with the specified IP address.

A = findsdru(serialNum) returns information for only the USRP radio with the specified serial number.

A = findsdru(___,Name=Value)returns the information about the connected radios with optional name-value arguments. The arguments that you don't specify retain their default values.

Examples

Report Status for All USRP Radios Connected to Host Computer

Before running this example, verify that your USRP radio is configured for host-radio communication by following the steps in Guided USRP Radio Support Package Hardware Setup.

Get the model number, IP address, serial number, and status of each USRP radio that is connected to the host computer.

A = findsdru

Checking radio connections...

A = struct with fields:
     Platform: 'B210'
    IPAddress: ''
    SerialNum: '31B92DD'
       Status: 'Success'

Input Arguments

IPAddress — IP address of USRP radio

dotted-quad character vector

IP address of the USRP radio that is connected to the host computer, specified as a dotted-quad character vector.

Data Types: char

serialNum — Serial number of USRP radio

character vector

Serial number of the USRP radio that is connected to the host computer, specified as a character vector.

Data Types: char

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: StatusOnly=false

StatusOnly — Option to get status of connected radios faster

true (default) | false

Option to enable or disable the ability of findsdru function to find the connected radios and get their availability status faster, specified as a logical true or false. Specify this argument as true to get the radio status faster. Specify this argument as false to get the detailed status regarding firmware compatibility, no response from the device, and other UHD errors. For more information about the execution times, see Reduced execution time for findsdru

Example: StatusOnly=false

Data Types: logical

Output Arguments

A — Information about connected USRP devices

structure

Information about connected USRP devices, returned as a structure containing these fields.

Fields	Description
Platform	Model number of the USRP device
IPAddress	IP address of the USRP device
SerialNum	Serial number of the USRP device
Status	Status information of the USRP device

The Status field of this structure displays one of the messages described in this table.

Status Value	Definition
Success	USRP device is available.
No devices found	No USRP devices found.
Not compatible	Device with incompatible firmware. To communicate with this device, you must update the firmware to the version returned by the function getSDRuDriverVersion. For more information on firmware, see USRP Radio Firmware Update.
Not responding	Device is not responding because of any of these reasons. The device is not attached to the host computer. If you are having an Ethernet connectivity problem, see Check Ethernet Configuration. No device with the specified IP address exists. The subnet address of the host computer does not match the subnet address of the device. The subnet address is the third field of the IP address. Verify that the subnet value of the host and radio are the same. For example, your NIC has an IP address of 192.168.10.1, and the IP address of the USRP radio is 192.168.20.2. The IP addresses differ in the third octet. For more information on subnet addresses, see Check Subnet Values on Host and Radio. Note For X3xx series radios, you will see this additional warning message that directs you to the hardware setup. Warning: Device at '192.168.60.2' is not responding because subnet value of host network interface does not match with device subnet value. To configure host network interface click Here. The specified serial number is invalid.
Busy	Device is in use. The device is already owned by a block, a block dialog, or a System object™.
Unknown error	Unknown problem.

Version History

Introduced in R2012b

R2022b: Reduced execution time for findsdru

The approximate execution time for the findsdru function with StatusOnly argument specified as true to find a single radio and get its availability status is:

R2022a: 15.283560 s

R2022b: 2.240098 s

The code execution was timed on a Windows^® 10, Intel^® Xeon^® W-2133 CPU @ 3.60 GHz installed RAM 64.0 GB test system.

However, to check for the detailed status regarding firmware compatibility, no response from the device, and other UHD errors, set the value of StatusOnly to false. In this case, findsdru takes same time to execute as compared to the R2022a release.