create new tag
, view all tags

OpenAirInterface Documentation

Bad news first: there is no such thing as a single and complete documentation of OpenAirInterface. However, there is sufficient documentation – it is only scattered in several different places. On this page we try to collect the most relevant pointers to information to get you started with OpenAirInterface. It is organized by the source of information.

Source Code

All software development is available through the our SVN repository. The source code contains several READMEs and inline documentation. It is organized as follows:

  • OPENAIR0 : This repository provides open-source real-time HW/SW for different Xilinx targets. Specifically for ExpressMIMO2 which can be used with OpenAir4G, this contains the Spartan6 VHDL implementation for PCIe data acquisition from the Lime RF front-end. It also contains the embedded firmware for the LEON3 processor in the Spartan6.
  • OPENAIR1 (open-source real-time and offline SW): This repository contains all the baseband DSP SIMD-x86 routines for implementing LTE UEs and eNBs (36-211,36-212). It also contains simulation testbenches for all LTE physical/transport channels. Furthermore, implementations of UE/eNB the physical layer procedures (36-213) for use with either real-time or emulation targets are here.
  • OPENAIR2 (open-source real-time and offline SW): This repository contains the LTE MAC (36-321), RLC (36-322), PDCP (36-323). It also contains the necessary scripts for generating the RRC ASN.1 messages (using the asn1c utility) along with the UE and eNB RRC procedures. S1 interfaces are provided for the user and control planes of the eNB.
  • OPENAIR3 (open-source Linux SW suite for cellular and MESH networks). This repository provides scripts and adaptations for the linux networking suite for particular projects.
  • OPENAIR-CN (3GPP-EPC implementation). This repository provides a small-scale 3GPP-EPC implementation, including MME, P and S-Gateway and HSS components.
  • TARGETS : This repository provides different top-level target designs (emulator, RTAI, etc.) for use with and without hardware in emulated or real-time modes.


We often give training session on OpenAirInterface at summer/winter schools. Here is a list of recent presentations.

OpenAirInterface is used in many projects and we often use project deliverables as documentation. The most comprehensive ones are listed here:

Lab sessions

Also have a look at tutorials and labs from the Acropolis Winter School 2012

Additional Information

Check out the other pages on this Twiki for installation, setup and running some of the code. Additional (more detailed, technical) documentation is also available on our BSCW server. If you don't have access and need it, ask us!

-- FlorianKaltenberger - 04 Dec 2013

Topic attachments
I Attachment Action Size Date Who Comment
PDFpdf CHORIST-SP4.D11-V1.0.pdf manage 1309.5 K 12 Oct 2009 - 16:40 FlorianKaltenberger OpenAirMesh specification and implementation
PDFpdf D5.2_v0_9.pdf manage 869.1 K 05 Dec 2013 - 09:34 FlorianKaltenberger Acropolis project deliverable D5.2
PDFpdf EuWInEurecom_D232_1.2.pdf manage 1720.2 K 05 Dec 2013 - 09:37 FlorianKaltenberger Newcom# deliverable 2.3.2
PDFpdf EuWIn_D231.pdf manage 2890.8 K 24 May 2013 - 17:14 FlorianKaltenberger Newcom# deliverable 2.3.1 describing OpenAirInterface
PDFpdf Introduction_to_EMOS_2013.pdf manage 2571.8 K 05 Dec 2013 - 09:33 FlorianKaltenberger  
PDFpdf OAItraining_Newcom_2013.pdf manage 1771.1 K 05 Dec 2013 - 09:36 FlorianKaltenberger  
PDFpdf OpenAirMesh_r2.pdf manage 1989.6 K 25 Feb 2010 - 19:03 FlorianKaltenberger Design and Implementation of a Single-frequency Mesh Network using OpenAirInterface
Unknown file formatpptx Openair5GLab.pptx manage 1977.9 K 27 Oct 2015 - 21:24 FlorianKaltenberger  
PDFpdf Thesis.pdf manage 1245.7 K 27 Oct 2010 - 07:19 FlorianKaltenberger Ankit Bhamri: "Distributed Coding and Modulation for 2-hop Communication via Relays", Master Thesis, TKK, 2010
PDFpdf ThesisTorbjorn.pdf manage 2746.5 K 09 Sep 2010 - 20:01 FlorianKaltenberger Torbjorn Sorby, "Demonstration of Spatial Interweave Cognitive Radio", Master Thesis, NTNU, 2010.
PDFpdf acropolis_summerschool_2013.pdf manage 1833.1 K 05 Dec 2013 - 09:33 FlorianKaltenberger  
Topic revision: r18 - 27 Oct 2015 - FlorianKaltenberger
Copyright 2004-2010 Institut Eurecom & all contributing authors.