uhd_find_devices(1)

πŸ“¦
version 4.9.0.1 Β· 2 versions
  • 4.9.0.1 Β· alpine 3.24, arch rolling, debian bookworm, debian trixie, epel 10, epel 9, fedora 43, fedora 44, nixos 26.05, nixpkgs unstable, opensuse-leap 16.0, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking (latest)
  • 4.1.0.5 Β· ubuntu jammy
, in alpine 3.24, arch rolling, debian bookworm, debian trixie, epel 10, epel 9, fedora 43, fedora 44, nixos 26.05, nixpkgs unstable, opensuse-leap 16.0, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

🌸 NAME 🌸

okay so bestie, this is the manual page for uhd_find_devices β€” it's the USRP Hardware Driver Discovery Utility, and it lives in section 1 of the manual (User Commands, iykyk). πŸ’–


✨ DESCRIPTION ✨

It finds UHD-supporting Ettus Research products that are attached by USB, network, or embedded configuration. πŸ¦‹

The UHD package? It's the universal hardware driver for Ettus Research products. The whole goal is to give you a host driver and API for current and future Ettus Research products. You'll be able to use the UHD driver standalone, or with 3rd party applications. no cap πŸ’…

πŸ¦‹ SYNOPSIS πŸ¦‹

uhd_find_devices [OPTIONS]

πŸ’… OPTIONS πŸ’…

πŸŽ€ Device Address Arguments πŸŽ€

  • --args arg β€” hand it a device address argument and let it cook ✨

🌈 This help information 🌈

  • --help β€” prints the help info, iconic behavior fr fr 🫢

πŸ”₯ IDENTIFYING DEVICES πŸ”₯

Devices are addressed through key/value string pairs. Those string pairs are how you narrow down the search for a specific device or a whole group of devices. Most UHD utility applications and examples have a --args parameter that takes a device address, and that device address is expressed as a delimited string. For reference, go read the documentation in types/device_addr.hpp. πŸ“š

Every device has several ways of identifying it on the host system. periodt. πŸ’…

πŸ‘‘ Identifying by hardware identifier

All Ettus Research devices can be found through their hardware series identifier, and those match to devices like this:

  • type=usrp1 β†’ USRP1
  • type=usrp2 β†’ USRP2, USRP N200, USRP N210
  • type=b100 β†’ USRP B100
  • type=b200 β†’ USRP B200, USRP B210
  • type=e3x0 β†’ USRP E310
  • type=x300 β†’ USRP X300, USRP X310
  • type=octoclock β†’ OctoClock

πŸ“ Identifying by serial number

All Ettus Research devices are given a unique serial number (yes, every single one, unique, we love that for them πŸ’–), and you can use it to identify a device like this:

serial=12345678

🌸 Identifying by IP address

USRP2, USRP N200, USRP N210, USRP X300, USRP X310, and OctoClock devices connected to the host machine can all be found through their IP addresses, like this:

addr=192.168.10.2

🧚 Identifying by name

Users have the option of giving their devices short names using the usrp_burn_mb_eeprom and octoclock_burn_eeprom utilities in lib/uhd/utils. Devices that have been given a name can be identified like this:

name=foo

⭐ EXAMPLES ⭐

πŸ’œ Device discovery via command line

Device address arguments can be supplied to narrow the scope of the search. slay. πŸ”₯

uhd_find_devices --args="type=usrp1"

-- OR --

uhd_find_devices --args="serial=12345678"

Find all devices available to this system:

uhd_find_devices

πŸ’« SEE ALSO πŸ’«

🫢 AUTHOR 🫢

This manual page was written by Maitland Bottoms and Nicholas Corgan for the Debian project (but may be used by others). absolute legends, honestly πŸ‘‘

Copyright (c) 2010-2022 Ettus Research, A National Instruments Brand

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.

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.

bestie this one is a real license, not a vibe β€” read it properly, the NO WARRANTY part is doing a lot of heavy lifting 😭

okay that's the whole page, you ate that πŸ’… this one comes to you from UHD version 3.7.0, and it's the uhd_find_devices(1) manual β€” go find those devices, main character πŸ¦‹πŸ’–