Python Libraries

Automatic Gain Control (AGC)

Implementation of an automatic gain control finite state machine:

• agc_fsm_iris.py

Read Digital RSSI values computed by LMS7002M RF transceiver IC and compute RX power:

• digital_rssi.py

Read/Write Data to File

Read/write complex numpy array from/to file prefixed with name, in twos-complement binary format:

• file_rdwr.py

Class used to record data into HDF5 file:

• data_recorder.py

Type Conversion

Convert floating point iq values to uint32 (FPGA format) and vice versa:

• type_conv.py

TX/RX for CSI Collection

Classes for transmitting/receiving and collecting CSI between (i) boards on same Base Station and (ii) Base Station and clients:

• csi_lib.py

OFDM/802.11/LTE

Library that allows users to generate random data stream of OFDM symbols, and modulate/demodulate according to a specified modulation order. Available modulation orders: [BPSK, QPSK, 16-QAM, 64-QAM]

• ofdmtxrx.py

Library for generating different training sequences. Supports the following sequences: [802.11 STS, 802.11 LTS, Zadoff-Chu (3GPP LTE), and Gold Sequence]

• generate_sequence.py

Find the indices of 802.11 LTS in the input signal:

• find_lts.py

Signal Analysis and Power Calculation

Library for CSI analysis:

• channel_analysis.py

Calculate an estimate of the power spectral density employing a Hann window and analyze bins for noise floor and peaks:

• fft_power.py

Detect peaks in data based on their amplitude and other features (original source):

• detect_peaks.py

Detect peaks in a vector (original source):

• peakdet.py

Compute average power in an input signal. Alternative to Matlab’s bandpower function (original source):

• bandpower.py

Plotting Tools

Plot RX waveform (output) from SOUNDER_TXRX.py demo script. Can be used with other output data files as long as the data format remains the same:

• plt_simp.py

Parse and verify contents of hdf5 files (e.g., from channel sounding). The main script is plot_hdf5.py and it relies on the library provided by hdf5_lib.py:

• plot_hdf5.py: Please see more details here.

• hdf5_lib.py

OFDM plotter. Plots (i) TX/RX IQ signals, (ii) Correlation of training sequence, (iii) Constellation, and (iv) Channel magnitude. Mainly used by SISO_OFDM.py script:

• ofdm_plotter.py

Utils

Print sensor values from array of Irises (e.g., temperature sensor for Zynq SoC, RF Front-end, and LMS7):

• print_sensor.py

Find Iris boards on network and list them:

• FindArrays.py

Sample offset calibration. Eliminate sample offset among boards in a Base Station:

• sample_offset_cal.py

Codebooks

Set of sequences primarily used for training. Available sequences: [Gold length 127, Gold length 511, Kasami length 63, and Kasami length 255]:

• gold-127
• gold-511
• kasamilarge-63
• kasamilarge-255