1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
|
/*! \page page_identification Device Identification
\tableofcontents
\section id_identifying Identifying USRP Devices
Devices are addressed through key/value string pairs. These string pairs
can be used to narrow down the search for a specific device or group of
devices. Most UHD utility applications and examples have an `--args`
parameter that takes a device address, which is expressed as a delimited
string.
See uhd::device_addr_t for reference.
Note that the device "address" can also take configuration options.
See \ref page_configuration for a list of those options.
\subsection id_identifying_common Common device identifiers
Every device has several ways of identifying it on the host system:
Identifier | Key | Notes | Devices | Example Value
------------------|----------|-----------------------------------------------------------|---------------------|---------------------------------
Serial # | serial | globally unique identifier | All devices | 12345678
IP Address | addr | unique identifier on a network | All network devices | 192.168.10.2
Resource | resource | unique identifier for USRP RIO devices (over PCI Express) | X3x0 | RIO0
Name | name | optional user-set identifier or hostname | All devices | my_usrp1 (User-defined value)
Type | type | hardware series identifier | All devices | usrp1, usrp2, b200, x300, n3xx, x4xx ...
Vendor/Product ID | vid,pid | Both must be provided, as well as `type`. | All USB Devices | vid=0x04b4,pid=0x8613
\subsection id_identifying_cmdline Device discovery via command line
Devices attached to your system can be discovered using the
`uhd_find_devices` program. This program scans your system for
supported devices and prints out an enumerated list of discovered
devices and their addresses. The list of discovered devices can be
narrowed down by specifying device address args.
uhd_find_devices
Device address arguments can be supplied to narrow the scope of the
search.
uhd_find_devices --args="type=usrp1"
-- OR --
uhd_find_devices --args="serial=12345678"
\subsection id_identifying_api Device discovery through the API
The device::find() API call searches for devices and returns a list
of discovered devices.
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~{.cpp}
uhd::device_addr_t hint; //an empty hint discovers all devices
uhd::device_addrs_t dev_addrs = uhd::device::find(hint);
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
The `hint` argument can be populated to narrow the scope of the search.
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~{.cpp}
uhd::device_addr_t hint;
hint["type"] = "usrp1";
uhd::device_addrs_t dev_addrs = uhd::device::find(hint);
-- OR --
uhd::device_addr_t hint;
hint["serial"] = "12345678";
uhd::device_addrs_t dev_addrs = uhd::device::find(hint);
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
\subsection id_identifying_props Device properties
Properties of devices attached to your system can be probed with the
`uhd_usrp_probe` program. This program constructs an instance of the
device and prints out its properties, such as detected daughterboards,
frequency range, gain ranges, etc...
<b>Usage:</b>
uhd_usrp_probe --args <device-specific-address-args>
\section id_naming Naming a USRP Device
For convenience purposes, users may assign a custom name to their USRP
device. The USRP device can then be identified via name, rather than a
difficult to remember serial or address.
A name has the following properties:
- is composed of ASCII characters
- is 0-20 characters
- is not required to be unique
\subsection id_naming_set Set a custom name
Run the following commands:
cd <install-path>/lib/uhd/utils
./usrp_burn_mb_eeprom --args=<optional device args> --values="name=lab1_xcvr"
\subsection id_naming_discovery Discovery via name
The keyword `name` can be used to narrow the scope of the search.
Example with the find devices utility:
uhd_find_devices --args="name=lab1_xcvr"
-- OR --
uhd_find_devices --args="type=usrp1, name=lab1_xcvr"
*/
// vim:ft=doxygen:
|
