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 Configuring Devices and Streamers for a list of those options.
Every device has several ways of identifying it on the host system:
|Serial #||serial||globally unique identifier||12345678|
|IP Address||addr||unique identifier on a network||192.168.10.2|
|Resource||resource||unique identifier for USRP RIO devices (over PCI Express)||RIO0|
|Name||name||optional user-set identifier||my_usrp1 (User-defined value)|
|Type||type||hardware series identifier||usrp1, usrp2, b200, x300, ...|
|Vendor/Product ID||vid,pid||For USB devices. Both must be provided||vid=0x04b4,pid=0x8613|
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.
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"
The device::find() API call searches for devices and returns a list of discovered devices.
hint argument can be populated to narrow the scope of the search.
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...
uhd_usrp_probe --args <device-specific-address-args>
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:
Run the following commands:
cd <install-path>/lib/uhd/utils ./usrp_burn_mb_eeprom --args=<optional device args> --values="name=lab1_xcvr"
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"