findsdru
Status of USRP radios connected to host computer
Description
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
returns
the information about the connected radios with optional name-value arguments. The arguments
that you don't specify retain their default values.A
= findsdru(___,Name=Value
)
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.
|
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 R2012bR2022b: 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.
See Also
Blocks
Functions
Objects
Beispiel öffnen
Sie haben eine geänderte Version dieses Beispiels. Möchten Sie dieses Beispiel mit Ihren Änderungen öffnen?
MATLAB-Befehl
Sie haben auf einen Link geklickt, der diesem MATLAB-Befehl entspricht:
Führen Sie den Befehl durch Eingabe in das MATLAB-Befehlsfenster aus. Webbrowser unterstützen keine MATLAB-Befehle.
Select a Web Site
Choose a web site to get translated content where available and see local events and offers. Based on your location, we recommend that you select: .
You can also select a web site from the following list:
How to Get Best Site Performance
Select the China site (in Chinese or English) for best site performance. Other MathWorks country sites are not optimized for visits from your location.
Americas
- América Latina (Español)
- Canada (English)
- United States (English)
Europe
- Belgium (English)
- Denmark (English)
- Deutschland (Deutsch)
- España (Español)
- Finland (English)
- France (Français)
- Ireland (English)
- Italia (Italiano)
- Luxembourg (English)
- Netherlands (English)
- Norway (English)
- Österreich (Deutsch)
- Portugal (English)
- Sweden (English)
- Switzerland
- United Kingdom (English)