USRP Device Guide

This guide covers connecting USRP 2901 SDRs to a RemoteRF server or host over USB. Support is included in the built-in usrp schema.

The USRP 2901, a USB-connected 2 × 2 MIMO software-defined radio.
The USRP 2901, a USB-connected 2 × 2 MIMO software-defined radio.

Overview

RemoteRF supports the USRP 2901 through the built-in usrp schema, which also covers other UHD B200-family and N210 radios. Setting profile: usrp2901 in devices.yml binds the entry to a specific USRP 2901 by USB serial number.

The Linux machine physically connected to the radio needs:

  1. UHD 4.10.0.0 (Python API and command-line utilities) installed in the remoterf-server or remoterf-host environment.
  2. A direct USB connection to the USRP 2901 (USB 3 is recommended for higher sample rates or two-channel MIMO streaming; USB 2 works for lower sample rates).
  3. Non-root USB permissions so uhd_find_devices and uhd_usrp_probe succeed without sudo.
  4. A devices.yml entry with device_type: usrp and profile: usrp2901.

Note: If ~/.config/remoterf/drivers/ contains a custom schema registered as usrp, that file overrides the built-in USRP driver. Remove it unless you intend to use a custom schema.

Install and Detect

1. Install UHD 4.10.0.0

RemoteRF requires UHD Python API version 4.10.0.0 on the machine that owns the USRP; other UHD versions are rejected when a session opens. Install the pinned package from conda-forge into the Conda environment used to run serverrf or hostrf, then download the UHD FPGA and firmware images:

conda activate YOUR_REMOTERF_ENV
conda install -y -c conda-forge "uhd=4.10.0.0"
uhd_images_downloader

Verify the installed UHD version in that environment:

python - <<'PY'
import uhd
print(uhd.get_version_string())
PY

The version string should resolve to 4.10.0.0. Distribution apt packages often ship older UHD versions, and the PyPI uhd wheels target Windows, so conda-forge (or building UHD v4.10.0.0 from source) is recommended on Linux.

2. Verify USB Detection

Connect the USRP 2901 over USB and confirm that UHD can find and probe it without sudo:

uhd_find_devices --args "type=b200"
uhd_usrp_probe --args "type=b200,serial=YOUR_SERIAL"

Copy the serial value reported by uhd_find_devices for use in devices.yml.

3. Fix USB Permissions (If Needed)

If UHD only detects the USRP when run with sudo, install the udev rules from your UHD 4.10 installation, reload udevadm, and reconnect the USB cable:

sudo udevadm control --reload-rules
sudo udevadm trigger

If your Linux distribution updated your user’s group membership, sign out and sign back in, then rerun both discovery commands without sudo.

Device Configuration

Add each USRP 2901 to ~/.config/remoterf/devices.yml on the main server (or ~/.config/remoterf/host/devices.yml on a RemoteRF host):

devices:
  - device_id: 7
    device_type: usrp
    name: USRP 2901 A
    init:
      profile: usrp2901
      type: b200
      serial: "31A2B3C"

  - device_id: 8
    device_type: usrp
    name: USRP 2901 B
    init:
      profile: usrp2901
      type: b200
      serial: "32A0D07"

You can also add an entry from the command line (using the interactive wizard or non-interactive flags):

# Interactive guided wizard on the server:
serverrf devices add usrp-2901

# Or non-interactively on the main server:
serverrf devices add usrp-2901 "USRP 2901 A" --serial 31A2B3C --id 7
serverrf devices list

# Or on a RemoteRF host:
hostrf --device --add --usrp-2901 "7:USRP 2901 A:31A2B3C"

Ensure device_type is usrp, init.profile is usrp2901, and init.serial matches the serial reported by UHD. RemoteRF opens the physical radio with type=b200,serial=... when an authenticated client opens a session.

Verification

Restart serverrf -s (or hostrf -s, checking hostrf --device --show on the host) after editing devices.yml and run devices list in the server shell to confirm the USRP 2901 entry is loaded.

Then reserve the USRP from a client machine and open a session in Python:

from remoterf.drivers import ensure_driver

token = "USRP_00@ucla"
ensure_driver(token=token)

from remoterf.drivers.usrp import uhd

with uhd.usrp.MultiUSRP(token=token) as usrp:
    print(usrp.get_pp_string())

If opening the session fails, rerun uhd_usrp_probe under the Linux account running RemoteRF and confirm no other process holds the USB device.

Next Steps