Main Content

findsdru

Status of USRP radios connected to host computer

collapse all in page

Add-On Required: This feature requires the Communications Toolbox Support Package for USRP Radio add-on.

Syntax

radios = findsdru
radios = findsdru(IPAddress)
radios = findsdru(serialNum)
radios = findsdru(___,StatusOnly=logical)

Description

radios = 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.

example

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

example

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

radios = findsdru(___,StatusOnly=logical) specifies the option to return the detailed status of the radio, in addition to the input arguments in the previous syntaxes.

example

Examples

collapse all

This example uses:

Open Live Script

Get the model number, IP address, serial number, and status of each USRP radio that is connected to the host computer and has been set up using the steps in Guided USRP Radio Support Package Hardware Setup.

radios = findsdru
Checking radio connections...

radios=1×2 struct array with fields:
    Platform
    IPAddress
    SerialNum
    Status

Query the contents of the first element in the array.

radios(1)
ans = struct with fields:
     Platform: 'B210'
    IPAddress: ''
    SerialNum: '30AD2D5'
       Status: 'Success'

This example uses:

Open Live Script

Get the model number, IP address, serial number, and status of a USRP radio with the IP address 192.168.20.10 that is connected to the host computer. Set the status only flag to false to get the detailed status information.

radio = findsdru('192.168.20.10',StatusOnly=false)
Checking radio connections...

radio = struct with fields:
     Platform: 'N200/N210/USRP2'
    IPAddress: '192.168.20.10'
    SerialNum: 'E1R10Z5UP'
       Status: 'Success'

Input Arguments

collapse all

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

Data Types: char

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

Data Types: char

Option to get status of connected radios faster, specified as one of these options.

  • true — Enable the findsdru to return the radio status faster.

  • false — Enable the findsdru to get the detailed status regarding firmware compatibility, no response from the device, and other UHD errors.

For more information about the reduction in execution times, see Reduced execution time for findsdru.

Example: StatusOnly=false

Data Types: logical

Output Arguments

collapse all

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

FieldsDescription
PlatformModel number of the USRP device
IPAddressIP address of the USRP device
SerialNumSerial number of the USRP device
StatusStatus information of the USRP device

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

Status ValueDefinition
SuccessUSRP device is available.
No devices foundNo USRP devices found.
Not compatibleDevice 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.

  • The specified serial number is invalid.

BusyDevice is in use. The device is already owned by a block, a block dialog, or a System object™.
Unknown errorUnknown problem.

Version History

Introduced in R2012b

expand all

See Also

Functions

Objects

Blocks

Topics