1usrpctl(1) User Commands usrpctl(1)
2
6 usrpctl - USRP Hardware Driver Peripheral Configuration Tool
7
9 Report detailed information on UHD-supported Software Radio Peripherals
10 attached by USB, network, or embedded configuration. Allows update and
11 configuration of attached devices.
12 The UHD package is the universal hardware driver for Ettus Research
14 products. The goal is to provide a host driver and API for current and
15 future Ettus Research products. Users will be able to use the UHD
16 driver standalone or with 3rd party applications.
17 Details include unit names, revision numbers, and available sensors on
19 all attached USRP motherboards and daughterboards.
20
22 usrpctl [ID] COMMAND [OPTIONS]
23
25 ID is the optional device argument. It is used to define a set of USRP
26 devices that COMMAND should be applied to. If ID is omitted COMMAND is
27 applied to all reachable devices.
28 usrpctl understands the device args argument used by other UHD tools
30 like uhd_find_devices.
31
34 Is the action the tool is to take. Every command can be either applied
35 to a single device or a group of devices. Commands that run on a group
36 of devices repeat the command for every device.
37 - Single device commands:
39 - config: Read/write configuration variables (e.g., IP address)
40 - probe: reads extended information about the USRP - Multi device
41 commands:
42 - update: Update binaries (e.g., FPGA image)
43 - reset: Reset the device or parts thereof (e.g., only reset MPM)
44 - find: finds all available USRPs in this network
45
48 The options are not always mandatory. It depends on the given COMMAND.
49
52 The find command takes no further options. If ID is not given it scans
53 the system for available, supported devices and prints a list of dis‐
54 covered devices. The print out is compatible to uhd_find_devices. ID
55 can be used to narrow down the list of discovered devices.
56
59 Print a complete property tree:
60 -tree
61 The probe command can only be applied to a single device so make sure
63 that
64 ID identifies exactly one device. Without arguments it displays
65 detailed information about the device such as name, serial, re‐
66 vision numbers, firmware version sensor information on attached
67 motherboard and daughterboards.
68
71 usrpctl find
72 find all supported devices
73 usrpctl type=x300,product=X310find
75 find all x310 devices
76 usrpctl name=my_usrp find
78 find a device named my_usrp
79 usrpctl addr=192.168.10.2 find
81 find a device with the given IP.
82 usrpctl addr=192.168.10.2 probe
84 display device information for USRP with the given ID
85 usprctl name=my_usrp probe -tree
87 display property tree of device with the name my_usrp
88 SEE ALSO
92 UHD documentation: http://files.ettus.com/manual/
93
95 Copyright (c) 2022 Ettus Research, A National Instruments Brand
96 This program is free software: you can redistribute it and/or modify it
98 under the terms of the GNU General Public License as published by the
99 Free Software Foundation, either version 3 of the License, or (at your
100 option) any later version.
101 This program is distributed in the hope that it will be useful, but
103 WITHOUT ANY WARRANTY; without even the implied warranty of MER‐
104 CHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General
105 Public License for more details.
106UHD 4.0.0 usrpctl(1)