.TH "uhd_find_devices" 1 "3.2.3" UHD "GNU Radio"
.SH NAME
uhd_find_devices \- Universal Hardware Driver Discovery Utility
.SH DESCRIPTION
Find UHD supporting Software Radio Peripherals attached by USB,
network or embedded configuration.
.LP
The UHD is the universal hardware driver for Ettus Research
products. The goal of the UHD is to provide a host driver and api for
current and future Ettus Research products. Users will be able to use
the UHD driver standalone or with 3rd party applications.
.LP
Hardware supporting UHD drivers includes the Universal Software Radio
Peripheral, or USRP, available in several models.
.SH SYNOPSIS
.B  uhd_find_devices [OPTIONS]
.SH OPTIONS
.IP "Device Address Arguments:"
--args \fIarg\fR
.IP "This help information:"
--help
.SH IDENTIFYING USRPS
.sp
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 a \-\-args parameter that takes a device address;
where the device address is expressed as a delimited string.
See the documentation in types/device_addr.hpp for reference.
.SS Common device identifiers
.sp
Every device has several ways of identifying it on the host system:

Identifier	Key	Notes

Serial		serial	globally unique identifier

Address		addr	unique identifier on a network

Name		name	optional user\-set identifier

Type		type	hardware series identifier
.fi
.SH EXAMPLES
.SS Device discovery via command line
.sp
Devices attached to your system can be discovered using the "uhd_find_devices" program.
The find devices 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.
.sp
Device address arguments can be supplied to narrow the scope of the search.
.sp
.nf
.ft C
uhd_find_devices \-\-args="type=usrp1"

\-\- OR \-\-

uhd_find_devices \-\-args="serial=12345678"
.ft P
.fi
.IP "Find all devices available to this system:"
uhd_find_devices
.SH SEE ALSO
The UHD html documentation:
.LP
.B file:///usr/share/doc/uhd-host/manual/html/index.html
.LP
or the GNU Radio project web site:
.B http://gnuradio.org/
.LP
The programs uhd_usrp_probe(1) and the other UHD utilities
usrp2_card_burner.py, usrp_n2xx_net_burner.py found in
the /usr/lib/uhd/utils directory.
.SH AUTHOR
This manual page was written by Maitland Bottoms for the Debian
project (but may be used by others).
.SH COPYRIGHT
Copyright (c) 2010 Ettus Research LLC
.LP
This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.
.LP
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.