README.md

Multichannel AWG

This example illustrates the usage of modern UHD4 features to sequence transmissions.

Installation

Building

# The installation target directory
# Note that you can also install globally instead of to your home directory
# in that case, you'd want something like targetdir=/usr/local or just /usr.
targetdir=$HOME/.local/bin

mkdir build
cd build
cmake -DCMAKE_INSTALL_PREFIX=${targetdir} ..
make

Installing – Development

After building, run from the build/ directory

make install
# if you installed to a directory your user can't write to,
# `sudo make install` instead

Installing – Deployment

You can build a binary package for transfer to other machines:

# RPM is for Fedora/Rocky/Alma/CentOS/SuSE/Redhat…
# DEB for debian/Mint/Ubuntu
# NSIS64 for a Windows installer (untested, but should work, needs preparation)
generator=RPM
mkdir build
cd build
cmake ..
make
cpack -G 

Usage

Look at example_data/example_sequence.json; the file contains a configuration section, a section that specifies paths and IDs for the segments to be used, and a sequence section, specifying which segment to play when on which channel (and with how many repetitions).

You can run multichannel_awg -f example_sequence.json from the example_data directory (if you run it from a different directory, correct the paths to the segments accordingly; full paths are allowed!).

To produce example data, the tools/ directory contains the generate_chirps.py tool, which is a GNU Radio program generated from the GRC flow graph generatechirps.grc.

To run the RFNoC version, use multichannel_awg -f example_sequence.json --mode rfnoc.