dApp Library

A complete tutorial on how to deploy a dApp can be found on the OpenRAN Gym website. Please refer to that guide to instrument your system.

Installation

Clone the repository

hatch build
pip3 install dist/*.tar.gz

Launch the Spectrum Sharing dApp

OAI should start before running the dApp

python3 examples/spectrum_dapp.py

This dApp implements a spectrum sharing use case discussed in our paper.

The dApp can be controlled through the following command-line arguments:

• ota bool (false): If true, use the OAI and spectrum configurations for OTA else use the ones of Colosseum
• control bool (false): If set to true, performs the PRB masking
• energy-gui bool (false): If set to true, creates and show the energy spectrum
• iq-plotter-gui bool (false): If set to true, creates and show the sensed spectrum
• save-iqs bool (false): Specify if this is data collection run or not. In the first case I/Q samples will be saved
• timed bool (false): Run with a 5-minute time limit

If you use the dApp concept and/or the framework to develop your own dApps, please cite the following paper:

@ARTICLE{lacava2025dApps,
author={Andrea Lacava and Leonardo Bonati and Niloofar Mohamadi and Rajeev Gangula and Florian Kaltenberger and Pedram Johari and Salvatore D'Oro and Francesca Cuomo and Michele Polese and Tommaso Melodia},
title: {dApps: Enabling Real-Time AI-Based Open RAN Control},
url={https://arxiv.org/pdf/2501.16502},
year={2025}
}