Installation for Targeting NI USRP Radios

To target NI™ USRP™ radio devices with Wireless Testbench™, you must install and configure third-party tools and additional support packages.

For details about which NI USRP radios you can target, see Supported Radio Devices.

Note

Generating a bitstream with this workflow is supported only on a Linux^® operating system (OS). For details about host system requirements, see System Requirements.

Connect and Set Up an NI USRP Radio

The Wireless Testbench software provides hardware targeting support through Wireless Testbench Support Package for NI USRP Radios. For instructions on how to install the support package, see Install Support Package for NI USRP Radios.

To connect and set up your radio, use the radioSetupWizard function to open the Radio Setup wizard and follow the steps. To see your previously saved radio setup configurations, use the radioConfigurations function.

Install and Configure Third-Party Tools

Vivado

Install Vivado^® development tools version 2021.1 and the AR76780 patch.

Python

Check if you have a compatible Python^® version by using the pyenv function. Compatible Python versions are 3.9, 3.10, and 3.11.
```
pe = pyenv
```
If you have a compatible version, proceed to step 2.
If the installed Python version is not compatible, install a compatible version. You can update your system-wide Python to a compatible version, or install a compatible version in a user directory specifically to use with MATLAB^®. Installing a compatible Python version specifically to use with MATLAB avoids version conflicts with other packages in your system.
Install Compatible Python Version to use with MATLAB
1. Download a compatible Python version. For a list of available releases, see Python Source Releases on the vendor website. Run this code in a terminal to install Python in your local user directory, replacing 3.11.11 with your selected version number.
```
mkdir -p /home/$USER/python
cd /home/$USER/python
wget https://www.python.org/ftp/python/3.11.11/Python-3.11.11.tgz
tar -xzf Python-3.11.11.tgz
cd Python-3.11.11
mkdir install
```
2. Configure, compile, and install Python in your local home directory.
```
./configure --prefix=`pwd`/install
make -j8
make install
```
Update Python System-Wide
- In a terminal, run one of the following commands, replacing python3.11 or python311 with a compatible Python version available on your OS.
  - Ubuntu^® or Debian^®
    sudo apt install python3.11
  - Red Hat^® or openSUSE^®
    sudo dnf -y install python311
Install compatible Python packages in a virtual Python environment and add them to the MATLAB path. This enables you to configure a Python environment to use with MATLAB without affecting the system-wide Python environment.
1. In a terminal, create a virtual Python environment in your home directory.
  - If you have a compatible system Python version, run this code in a terminal:
    python3 -m venv /home/$USER/python/environments/wt cd /home/$USER/python/environments/wt
  - If you installed a compatible Python version in your local home directory, run this code in a terminal:
    ./install/bin/python3 -m venv /home/$USER/python/environments/wt cd /home/$USER/python/environments/wt
2. Install compatible versions of these required Python packages: numpy, ruamel.yaml, pyyaml, and mako.
```
./bin/python3 -m pip install "numpy>=1.11,<2.0" "ruamel.yaml>=0.15,<0.18" "pyyaml>=3.13.0" "mako>=0.4.2"
```
3. In MATLAB, use the setenv function to add the path to the executables in the virtual Python environment to the existing path.
  setenv('PATH', ... ['/home/$USER/python/environments/wt/bin',':',getenv('PATH')])
  Run this code at the start of each MATLAB session, or add it to your MATLAB startup script. For details, see Specify Startup Options.

Xterm

Confirm that the Xterm terminal emulator is installed by entering the following code in a terminal:

which xterm

If no executable can be found, install Xterm. Run one of the following commands, depending on your Linux distribution:

Ubuntu or Debian
```
sudo apt install xterm
```
Red Hat or openSUSE
```
sudo dnf -y install xterm
```