Downloads: 1,794   |   (v30)
The OAIBOXTM 5G Lab Manual is the OAIBOXTM companion document that provides step-by-step 5G Lab exercises to be replicated by students AND RESEARCHERS.
- Understand how different 5G NR Air Interface configurations affect end-to-end connectivitY
- Understand the 5G protocol stack, RAN and CN through deep packet inspection
- Understand the 3GPP standard in a real over-the-air environment
- Understand how to change the open-source OAI code base to implement and test advanced wireless algorithms
Thank you for supporting us in acquiring the OAIBOXTM and for providing valuable feedback. This motivates us to invest further in new features and training material.
Practical experimentation with cellular networks has been historically reserved exclusively for network vendors and telecommunication operators, primarily due to high equipment costs and licensing constraints.
In recent years, the state of play has been changing with the advent of open-source 3GPP protocol stacks based on increasingly more affordable Software-Defined Radio (SDR) systems. In this context, the OpenAirInterfaceTM (OAI) project emerges as the leading open-source initiative that provides a reference implementation of 5G base station (gNB), User Equipment (UE), and 5G core network, standard-compliant with 3GPP NR SA and that runs on general-purpose x86 computing platforms along with off-the-shelf SDR hardware platforms.
- The OAI is an open-source project established by EURECOM and welcomes contributions to anyone who signs the license agreement.
- The OAI software stack is used by many different R&D teams worldwide. Apart from being an ideal platform for 5G and 6G collaborative research, we believe that OAI has a strong potential for educating graduate students and training wireless engineers on the practical aspects of 5G cellular networks.
- The OAI code is free for download and use; however, because of its open-source nature and flexibility, it is not meant to be used directly by graduate students in teaching Labs. With the OAIBOXTM product line, Allbesmart wants to offer a plug-and-play solution that works as an abstraction layer of open-source complexities, contributing towards the adoption of OAI in teaching Labs and training centres.
- The OAIBOXTM product was inspired by our experience as developers, key contributors, and testers of the 5G OAI stack. The OAIBOXTM Dashboard is a web-based platform with pre-defined and easy-to-use 5G configurations, accessible through intuitive menus to facilitate hands-on experiments of 5G use cases. End-to-end test results can be measured against KPIs shown in real-time plots that can be stored for further analysis and discussion.
- We are creating a 5G Lab Manual with several 5G Lab exercises to be replicated by students, addressing different aspects of the 5G protocol stack. For each exercise, a Pre-Lab section summarises the most important background of the 3GPP NR standard, including key references to the TS required to understand the outcome of each step-by-step experiment.
- For some Labs, we also explain how to change the 5G configuration in the OAI code base, preparing students and future researchers for advanced uses of OAI beyond the pre-defined 5G lab exercises in the 5G Lab Manual.
- Historically wireless networks have been taught based on theoretical models and reliance on simulation tools constructed under simplifying assumptions and usually addressing a single protocol layer. We believe that the OAIBOX, with its full 5G stack and over-the-air transmission, is a transformative approach to teaching practical aspects of cellular networks, preparing students for the global standard adopted by the industry.
We would like to thank the OAI Software Alliance (OSA) and the overall OAI community that, for many years, has been working to democratise wireless innovation. We hope you enjoy your OAIBOXTM test network!
Prerequisites: A background in digital wireless communications is required. Background in 3GPP standard is helpful but not required.
- OAIBOXTM overview
- Setting up the OAIBOXTM
- The OAIBOXTM Dashboard
- OpenAirInterfaceTM background
- 1.1 Pre LAB-1: 3GPP Background
- 1.1.1 Overview of 5G NR frame structure and resource grid
- 1.2 Change the 5G NR bandwidth in the OAIBOXTM
- 1.2.1 Lab Equipment
- 1.2.2 Lab steps
- 1.3 LAB-1: Report
- 1.4 Advanced topic – Change the 5G NR bandwidth in the OAI configuration files
- 2.1 Pre LAB2: 3GPP Background
- 2.1.1 Overview of 5G NR operating bands
- 2.2 Changing the central frequency in the OAIBOXTM
- 2.2.1 Lab Equipment
- 2.2.2 Lab steps
- 2.3 LAB2: Report
- 2.4 Advanced topic – Change the central frequency carrier in the OAI configuration files
- 3.1 Pre-LAB-3: 3GPP Background
- 3.2 Changing the TDD slot configuration in the OAIBOXTM
- 3.2.1 Lab Equipment
- 3.2.2 Lab steps
- 3.3 LAB-3: Report
- 3.4 Advanced topic – Change the 5G NR TDD slot configuration in the OAI configuration files
- 4.1 Pre LAB-4: 3GPP Background
- 4.1.1 UE capability requirement
- 4.1.2 5G signal spectrum
- 4.1.3 5G NR bit rate computation in FDD
- 4.2 Testing FDD configuration
- 4.2.1 Lab Equipment
- 4.2.2 Lab steps
- 4.3 LAB-4: Report
- 5.1 Pre-LAB-5: 3GPP Background
- 5.2 Changing the MCS in the OAIBOXTM
- 5.2.1 Lab Equipment
- 5.2.2 Lab steps
- 5.3 LAB-5: Report
- 6.1 Pre-LAB-6: 3GPP Background
- 6.2 Changing the BWP configuration in the OAIBOXTM
- 6.2.1 Lab Equipment
- 6.2.2 Lab steps
- 6.3 LAB-6: Report
- 7.1 Pre LAB-7: 3GPP Background
- 7.2 Testing the 5G NR RACH (Random Access Procedure) in OAI
- 7.2.1 Lab steps
- 7.3 LAB-7: Report
- 8.1 Pre LAB-8: 3GPP Background
- 8.1.1 Space-Time Block Coding (STBC)
- 8.1.2 Spatial Multiplexing (SM)
- 8.1.3 Spatial Multiplexing with precoding
- 8.1.4 OAI implementation of the Spatial Multiplexing with precoding
- 8.2 Changing the MIMO configuration
- 8.2.1 Lab Equipment
- 8.2.2 Lab steps
- 8.3 LAB-8: Report
- 9.1 Pre-LAB-9: 3GPP Background
- 9.1.1 LDPC decoding
- 9.1.2 LDPC codes in 3GPP 5G NR
- 9.1.3 Min-Sum LDPC decoding algorithm implemented in OAI
- 9.2 Changing the LDPC configuration in the OAIBOX with a real UE (Quectel)
- 9.2.1 Lab Equipment
- 9.2.2 Lab steps
- 9.2.3 LAB-9.2: Report
- 9.3 Changing the LDPC configuration in the OAIBOX with the nr_ulsim physical simulator
- 9.3.1 Lab Equipment
- 9.3.2 Lab steps
- 9.3.3 LAB-9.3: Report
This is a living document. New LABs will be published here