Main Content

Install Support Package for NI USRP Radios

R2026b

The Wireless Testbench™ Support Package for NI™ USRP™ Radios enables you to connect and set up your NI USRP radio for use in Wireless Testbench. Use one of the following options to install the support package.

Add-Ons Panel

Since R2025a

  1. Open the Add-Ons panel by clicking the Add-Ons icon on the left sidebar of the MATLAB® desktop.

  2. Search for the Wireless Testbench Support Package for NI USRP Radios.

  3. Select the support package from the list and click the Install button.

  4. In the Add-On Installer window, proceed through the steps then click Install.

When the support package installation is complete, you can proceed directly to setting up the radio for use in Wireless Testbench by clicking Setup Now. You can now use the Radio Setup wizard to set up your radio.

File Exchange

Download and install the support package from File Exchange by clicking Download, then running the installer.

When the support package installation is complete, you can proceed directly to setting up the radio for use in Wireless Testbench by clicking Setup Now in the Add-On Installer window. You can now use the Radio Setup wizard to set up your radio.

Hardware Manager App

Since R2024b

First, open the Hardware Manager app. On the Apps tab in the MATLAB Toolstrip, under Test and Measurement, click the app. Alternatively, enter hardwareManager in the MATLAB command prompt. Then, follow these steps.

  1. Click Add Hardware.

  2. For Hardware type/interface, choose Software-Defined Radios (SDR).

  3. For Select your SDR, choose your USRP radio from the dropdown menu.

  4. Click Install.

When the support package installation is complete, you can proceed directly to setting up the radio for use in Wireless Testbench by clicking Setup Now in the Add-On Installer window. You can now use the Radio Setup wizard to set up your radio.

MATLAB Package Manager

You can programmatically install products by using the MATLAB Package Manager (mpm). For more information, see Install Support Packages Noninteractively.

Install Support Package with Restricted or No Internet Access

Since R2025a

On Linux®, the Wireless Testbench Support Package for NI USRP Radios requires third-party Python® packages. During installation, the support package uses pip to download these packages from the Python Package Index (PyPI). If your computer cannot access PyPI, the support package installation fails with this message:

Failed to install the third-party software: PyYAML

If you install by using MATLAB Package Manager (mpm), mpm shows a similar message and exits with code 255. mpm installs the other products that you specify, but not the support package.

To install the support package, use the procedure that matches your network.

If your network blocks PyPI but provides its own package index, set the PIP_INDEX_URL environment variable to that index before you start the installation. To get the URL, contact your system administrator.

  • If you install from MATLAB by using the Add-Ons panel, File Exchange, or the Hardware Manager app, run this command at the MATLAB command prompt. Then start the installation.

    setenv("PIP_INDEX_URL","https://pypi.example.com/simple")

  • If you install by using mpm, run this command in the terminal where you run mpm. If the installation already failed, run the mpm install command for the support package again after you set the variable.

    export PIP_INDEX_URL=https://pypi.example.com/simple

If your computer has no internet access, download the support package and the Python packages on a computer that has internet access. Then, install the support package on the offline computer from an mpm download folder. For more information about download folders, see Install Support Packages Noninteractively.

  1. On a computer that has internet access, download the products, including the support package, by using the mpm download command. Set the --platforms option to glnxa64. For example:

    mpm download --release=R2026b --destination=/home/user/mpm_download --platforms=glnxa64 --products Wireless_Testbench Wireless_Testbench_Support_Package_for_NI_USRP_Radios

  2. Download the Python packages to a folder named wheels by using the Python interpreter in the mpm download folder. In the archives/3p folder of the download, find the folder whose name starts with pythonstandalone_3.11. Extract the cpython_glnxa64.tar.gz file in that folder, and then run pip download by using the extracted interpreter. If the computer that has internet access does not run Linux, the interpreter in the download does not run. In that case, run the same pip download command by using any Python 3 interpreter that has pip. If pip is not installed, create a virtual environment by using python3 -m venv. Replace <folder> with the name of the folder that starts with pythonstandalone_3.11, and then run these commands:

    mkdir /home/user/wt_py
    tar -xzf /home/user/mpm_download/archives/3p/<folder>/cpython_glnxa64.tar.gz -C /home/user/wt_py
    /home/user/wt_py/python/bin/python3 -m pip download --dest /home/user/wheels --no-deps --only-binary=:all: --python-version 3.11 --implementation cp --abi cp311 --platform manylinux2014_x86_64 "pyyaml>3.13.0" "numpy>=1.11,<2.0" "ruamel.yaml>=0.15,<0.18" "Mako>=0.4.2" "MarkupSafe>=2.0.1"

  3. Copy the wheels folder and your mpm download folder to the offline computer. The path to the wheels folder must not contain spaces.

  4. On the offline computer, open a terminal, and use it for the remaining steps. If you install into a folder that requires administrator privileges, open a root shell by using sudo -s.

  5. Set the environment variables that direct pip to the downloaded packages. PIP_FIND_LINKS specifies the folder that contains the packages, PIP_NO_INDEX prevents pip from contacting a package index, and PIP_CONFIG_FILE prevents pip from reading pip configuration files on the computer. Replace the path with the location of your wheels folder.

    export PIP_FIND_LINKS=/home/user/wheels
    export PIP_NO_INDEX=1
    export PIP_CONFIG_FILE=/dev/null

  6. In the same terminal, install the support package by using the mpm install command. Set the --source option to your mpm download folder. If you install without administrator privileges and do not specify the --support-package-destination option, mpm installs the support package in the ~/Documents/MATLAB/SupportPackages/R2026b folder. For more information about mpm install options, see Install Support Packages Noninteractively. For example:

    mpm install --source=/home/user/mpm_download --destination=/home/user/MATLAB --products Wireless_Testbench Wireless_Testbench_Support_Package_for_NI_USRP_Radios

See Also

Tools

Topics