uhd/README.md
Frank Dietze b2d396d436 Prepare for 4.9.0.0 RC2
Update Changelog
- Add mention of new RFNoC OOT block repository to changelog.
  Add link to RFNoC OOT block github repository to README.
Update Readme with reference to new OOT block repo
Update Manifest

Co-authored-by: Niels Garibaldi <niels.steffen.garibaldi@emerson.com>
Co-authored-by: Marian Koop <marian.koop@emerson.com>
2025-08-23 00:21:06 +02:00

85 lines
2.7 KiB
Markdown

# USRP Hardware Driver (UHD™) Software
Welcome to the UHD™ software distribution! UHD is the free & open-source
software driver and API for the Universal Software Radio Peripheral (USRP™) SDR
platform, created and sold by Ettus Research.
UHD supports all Ettus Research USRP™ hardware, including all motherboards and
daughterboards, and the combinations thereof.
## Documentation
For technical documentation related to USRP™ hardware or UHD system
design, check out the [UHD and USRP Manual](http://files.ettus.com/manual/).
That is where you can find
[Installation Instructions](http://files.ettus.com/manual/page_install.html),
help on how to
[build UHD from source](http://files.ettus.com/manual/page_build_guide.html) on
different platforms, development guidelines and reference documentation as well
as device usage guidance.
Additionally, be sure to check out the Ettus Research
[FAQ](https://kb.ettus.com/Technical_FAQ), and the
[Knowledge Base](http://kb.ettus.com) for useful application notes and
tutorials.
## OS Support
UHD is primarily developed on Linux, but we also test and support the following
operating systems.
* Linux (Fedora and Ubuntu)
* Mac OS X (Intel)
* Windows 10
Other operating systems will most likely work, too, but are not officially
supported.
## Applications
UHD can be used to build stand-alone applications with USRP™ hardware, or with
third-party applications. Some common toolkits / frameworks are:
* [GNU Radio](http://gnuradio.org/)
* [RFNoC OOT Blocks](https://github.com/EttusResearch/rfnoc-oot-blocks)
* [NI LabVIEW - UHD RFNoC](https://github.com/ni/labview-usrp-examples)
* [NI LabVIEW](https://www.ni.com/download/ni-usrp-1.3/4711/en/)
* [MathWorks Matlab and Simulink](https://www.mathworks.com/discovery/sdr/usrp.html)
* [REDHAWK](https://redhawksdr.org/)
* [OpenBTS GSM](http://openbts.org)
* [Osmocom GSM](https://osmocom.org)
* [Amarisoft LTE](https://www.amarisoft.com/products-lte-ue-ots-sdr-pcie)
* [Software Radio Systems srsRAN](https://www.srsran.com/)
* [Eurecom OpenAirInterface](https://gitlab.eurecom.fr/oai/openairinterface5g)
## Directories
__host/__
The source code for the user-space driver.
__mpm/__
The source code for the module peripheral manager (MPM). This is code that is
run on embedded devices.
__firmware/__
The source code for all microprocessors in USRP hardware.
__fpga/__
The source code for the UHD FPGA images.
__images/__
This contains the package builder for FPGA and firmware images.
We provide other tools to download image packages, the scripts in here
are mainly relevant for UHD maintainers and -developers.
__tools/__
Additional tools, mainly for debugging purposes. See the readme-file
in that directory for more details on the individual tools.