openairlink

https://github.com/n3martix/openairlink

Science Score: 57.0%

This score indicates how likely this project is to be science-related based on various indicators:

✓
CITATION.cff file
Found CITATION.cff file
✓
codemeta.json file
Found codemeta.json file
✓
.zenodo.json file
Found .zenodo.json file
✓
DOI references
Found 1 DOI reference(s) in README
○
Academic publication links
○
Academic email domains
○
Institutional organization owner
○
JOSS paper metadata
○
Scientific vocabulary similarity
Low similarity (12.5%) to scientific vocabulary

Last synced: 10 months ago · JSON representation ·

Repository

Basic Info

Host: GitHub
Owner: N3Martix
License: gpl-3.0
Language: C++
Default Branch: main
Size: 20.3 MB

Statistics

Stars: 4
Watchers: 2
Forks: 0
Open Issues: 0
Releases: 0

Created about 2 years ago · Last pushed over 1 year ago

Metadata Files

Readme License Citation

OpenAirLink: Reproducible Wireless Channel Emulation using Software Defined Radios

An open-source channel emulator for reproducible testing of wireless mobility scenarios. The emulator implements a FIR filter on Software Defined Radios, the NI USRP (formerly by Ettus). OpenAirLink was developed by the Chair of Communication Networks at the Technical University of Munich.

Requirements

UHD 4.4

To rebuild FPGA image: - Vivado 2021.1 - AR76780 Patch

Installation

Clone this repository: git clone https://github.com/N3Martix/OpenAirLink.git Use following steps to install OpenAirLink: cd ~/OpenAirLink/rfnoc-openairlink mkdir build && cd build cmake -DUHD_FPGA_DIR=<path-to-uhd>/uhd/fpga/ ../ make sudo make install sudo ldconfig Load FPGA image to your USRP: cd ~/OpenAirLink/fpga-openairlink uhd_image_loader --args="type=x300" --fpga-path="usrp_x310_fpga_HG.bit" To check installation, run: LD_PRELOAD=/usr/local/lib/librfnoc-openairlink.so uhd_usrp_probe If OpenAirLink is correctly installed, the output should look like: | _____________________________________________________ | / | | RFNoC blocks on this device: ... | | * 0/FIR#0 | | * 0/FIR#1 | | * 0/Shiftright#0 | | * 0/Shiftright#1 ...

Usage

1. Lanuch OpenAirLink

Lanuch with follow command: cd ~/OpenAirLink/rfnoc-openairlink/build LD_PRELOAD=/usr/local/lib/librfnoc-openairlink.so ./apps/oal_single OpenAirLink also supports two channels running independently and simultaneously. To do so, replace oal_single with oal_dual.

The OpenAirLink's channel configuration has two models:

Manually: By default, OpenAirLink periodically scans the configuration file in the channel_control/ folder to update the channel. The frequency of updates can be adjusted using the --udt argument.
Script: The configuration is sent to the USRP if the emulator's running time exceeds its time index. To run the script mode, use the argument --script.

2. Channel coefficient generation TODO

Currently Supported Hardware

NI USRP X310

Citing AirLink

Please use the citation file provided in the repository. For quick access:

Y. Deshpande, X. Wang and W. Kellerer, "OpenAirLink: Reproducible Wireless Channel Emulation using Software Defined Radios," 2024 IFIP Networking Conference (IFIP Networking), Thessaloniki, Greece, 2024, pp. 1-6, doi: 10.23919/IFIPNetworking62109.2024.10619070.

Contributors

Xianglong Wang
Yash Deshpande

Owner

Name: Xianglong Wang
Login: N3Martix
Kind: user

Repositories: 1
Profile: https://github.com/N3Martix

Citation (CITATION.cff)

# This CITATION.cff file was generated with cffinit.
# Visit https://bit.ly/cffinit to generate yours today!

cff-version: 1.2.0
title: OpenAirLink
message: 'If you use this software, please cite it as below.'
type: software
authors:
  - given-names: 'Yash  '
    family-names: Deshpande
    email: yash.deshpande@tum.de
    orcid: 'https://orcid.org/0000-0003-4721-2492'
  - given-names: Xianglong
    family-names: Wang
    email: xianglong.wang@tumd.de
    orcid: 'https://orcid.org/0009-0002-9238-4509'
  - given-names: Wolfgang
    family-names: Kellerer
    orcid: 'https://orcid.org/0000-0003-4358-8038'
repository-code: 'https://github.com/N3Martix/OpenAirLink'
license: GPL-3.0
version: 1.0.0
date-released: '2024-04-15'
preferred-citation:
 type: article
 authors:
  - family-names: "Deshpande"
    given-names: "Yash"
    orcid: "https://orcid.org/0000-0003-4721-2492"
  - family-names: "Wang"
    given-names: "Xianglong"
    orcid: "https://orcid.org/0009-0002-9238-4509"
  - family-names: "Kellerer"
    given-names: "Wolfgang"
    orcid: "https://orcid.org/0000-0003-4358-8038"
 doi: "10.23919/IFIPNetworking62109.2024.10619070"
 journal: "OpenAirLink: Reproducible Wireless Channel Emulation using Software Defined Radios" 
 month: 06
 title: "OpenAirLink: Reproducible Wireless Channel Emulation using Software Defined Radios"
 issue: 
 volume: 
 year: 2024

ecosyste.ms

Data

Tools

Indexes

Applications

Experiments

Open Source Science