OAI-Configuration
OAI-Configuration
Abstract—In contrast to legacy 5G RAN solutions, Open- Software Radio System (srsRAN) [2] and OpenAirInterface
RAN and especially open-source RAN projects provide enhanced (OAI) [3]. At the moment, the OAI software stack is more
configuration possibilities. This enables an operator to tailor complete with respect to the 3GPP specifications, implement-
the network more specific to its needs. At the same time,
this complicates the process of setting up the network, since ing Release 16 (e.g. downlink (DL) localization signals) and
this configuration requires more in-depth understanding of 5G. even Release 17 (e.g. non-terrestrial networks) features. OAI
There is a gap between the 3GPP specifications, representing also strives for O-RAN compliance. For now, it contains the
the theoretical aspects and the actual deployment of a 3GPP F1 and E2 interface with support for FlexRIC and µONOS
compliant network. Therefore, we present a novel explanation RIC, while the O1 and E1 interface is under development.
drawing the link between these specifications and a practical
open-source 5G network, using OpenAirInterface. We further il- In addition, there is also a corresponding OAI-CN implemen-
lustrate the operability of the network in different configurations tation. Thus, the availability of open-source projects enables
with commercial UEs, by applying the presented relations. more researchers to set up their own low-cost, experimental
Index Terms—5G, Open-RAN, Virtualized RAN, open-source 5G network.
Proposing the usage of OAI to provide a low-cost 5G non-
I. I NTRODUCTION public network solution, specialized for industrial applications,
Traditionally, cellular networks consist of closed-source [4] shows the competitiveness between softwarized and tra-
software and hardware components. With the increased level ditional 5G systems in certain use cases. As a result, 5G
of softwarization in 5G networks, new concepts like virtual- enabled robotics control utilizing Multi-Access Edge Com-
ized Radio Access Network (vRAN) and disaggregated Radio puting (MEC) [5]–[8], can be realised with significantly less
Access Network (dRAN) are becoming more feasible and gain expenditure. Furthermore, two companies use this open-source
importance. By now, next generation NodeBs (gNBs) can run software in their commercial products: allbesmart [9] and
completely in software on Commercial off-the-shelf (CotS) firecell [10]. Both of them offer pre-configured workstations
server hardware. Therefore, previously proprietary black-box running their own forked OAI version, in order to improve
base stations emerge into disaggregated and open components. different aspects in contrast to a pure OAI setup. While
The Open Radio Access Network (O-RAN) specifications [1] allbesmart aims for academia and other researchers, firecell
provide the definition of open interfaces and a reference addresses industrial customers. These products facilitate the
architecture for the Radio Access Network (RAN) on top of RAN configuration but at the price of reduced possibilities
the 3rd Generation Partnership Project (3GPP) standards. This foiling one of the key ideas of O-RAN.
extension enables more specific network configurations due In contrast to legacy 5G systems, O-RAN systems provide
to the increased configuration possibilities and an increased enhanced configuration possibilities [4] that can be modified
number of available network components. Additionally, it by the operator. This applies even more to open-source systems
accelerates the open-source development in the area of the like OAI, since it is possible to alter every aspect of the imple-
RAN. mentation. The increased configurability has its price, because
While there is a rather large number of open-source Core the complexity of establishing a working setup also increases.
Networks (CNs), there are only two relevant RAN projects: It is more difficult configure a network fulfilling certain desired
...
PHY layer configuration
Fig. 1. Overview of an end-to-end 5G system including OAI-based parts highlighted in blue. The RAN and CN configuration set the IP-based network
connection between these two parts, whereas only the RAN configuration determines the physical transmission of the gNB.
properties (e.g. frequency band, carrier bandwidth) in a 3GPP- Within the context of this work we chose OAI as example
compliant way. This concerns the cell search and initial attach for an open-source based RAN, which is highly configurable.
procedures in particular. Without proper configuration the The OAI RAN is configured by a single configuration file,
network will not only show reduced performance but an User which contains every relevant aspect of the gNB configura-
Equipment (UE) will not be able to connect at all. To create a tion. However, Setting up a new OAI instance can be very
working RAN configuration, several New Radio (NR) aspects challenging. OAI offers support in form of some read me
have to be taken into consideration. The synchronization signal files [18], which present example configurations. However, the
block (SSB) [11], providing synchronization to an UE, as well OAI tutorials do not aim to explain the background or provide
as the control ressource set (CORESET)0 [12], containing further details.
the first control channel information for further message Currently OAI gets more and more attention by a growing
reception, have to match 3GPP requirements. In addition, the community. As a result, not only the interest in building
newly introduced bandwidth parts (BWPs) [13] are present knowledge in this area increases, there are also more people
in the initial attach. In addition to papers like the mentioned who have the knowledge and are willing to share it [19].
references [11]–[13], the primary sources about NR details Authors in [19] use a rather expensive setup including two
are the 3GPP NR specifications. For instance the TS 38.200 dedicated workstations. Their work focuses on details, in the
series describes the physical layer aspects while the TS 38.300 context of Internet Protocol (IP) routing in the context of
series specifies the higher-layer parts [11]. The difficulty with the CN and Data Network (DN). Besides this, they mention
these documents is not only their dense nature, but also the configuration details regarding the host machine, which are
fact that explanations and requirements to the configuration important to reduce jitter in computing times on an unix
are distributed across multiple specifications. based x86 machines. However, the configuration of the RAN
The remainder of the paper is structured as follows. First, is not explained in detail, as they use an example configuration
Section II provides information about tutorials and comparable provided by the OAI.
explanations about OAI-based systems. An overview about Two online tutorials explain details about the OAI config-
a generic open-source 5G network, its components and the uration process, where one is maintained by the Northeastern
configuration capabilities succeeds in Section III. We present University [20] and the other one by National Instruments
a detailed explanation of the RAN in Section IV and subse- (NI) [21]. However, at the current point in time, their aiming
quently show the connection set-up with different frequency more for help by reproducing the example setup described at
bands in Section V. Finally, Section VI shows the conclusion. the official OAI repo [18], rather than connecting background
knowledge with the configuration process.
II. R ELATED W ORK
The presented publications provide insights from different
In addition to the 3GPP NR RAN specification many perspectives. However, none of those publications is connect-
interpretations and explanations are available. As the standards ing the theoretical background to practical application. In the
describe the radio interface in a holistic way, explanations past in-depth knowledge about RAN configuration was not
which cover a significant part are in form of books [14]–[16]. required for users and to some extent even for operators.
Others are shorter, picking only one specific topic [11]–[13]. Most RAN solutions came as a black-box without many
There are also websites [17] providing a lot of knowledge, configuration options. With today’s open-source based vRAN,
sometimes including high level of detail. All those sources this is no longer the case. A wider audience wants to build up
focus on the theoretical concept behind NR. the required knowledge, to configure their own open-source
based gNB or adapt one to their needs. The novelity of this with 0, is also referred to as reference RB including the
work is to fill this gap by presenting the theoretical background definition of its lowest subcarrier as ”Point A”. This is used as
applied to the actual OAI configuration. common reference point for the RB grid and different settings
regarding the channel bandwidth. A contiguous set of RBs
III. BACKGROUND
with the same SCS form a BWP [13]. Hence it is defined
A. 5G System Architecture by its first RB and the number of used RBs. This concept
A 5G system consists of three major parts: first the CN that was introduced in NR to allow a wider variety of UEs; some
provides connectivity to a DN, second the RAN providing low-cost devices might only support a small bandwidth while
the wireless access and third the UE that connects to this other high-end devices are able to utilize higher bandwidths.
network. OAI provides the software to run each of these Inherently, the BWP is smaller or equal than the total channel
components virtualized on CotS server hardware. Fig. 1 shows bandwidth of the cell. There are different types of BWPs, e.g.
a generic setup containing these elements where the OAI parts the initial BWP that is part of the initial attach procedure.
are highlighted in blue. In the figure there are two types of The cell search and initial attach of an UE require several
UEs; the first UE uses the virtualized approach, utilizing a other concepts. Initially, a UE has to acquire synchronization
Software Defined Radio (SDR), while the second UE uses with network by receiving a SSB. This block contains a
a CotS modem. Fig. 1 illustrates several key aspects of an primary and secondary synchronization signal as well as the
open-source 5G network. Despite advancing virtualization, the Master Information Block (MIB). The MIB is the first Radio
radio transmission part remains implemented on specialized Resource Control (RRC) message and contains information
hardware or SDRs. This is true for both sides, RAN and about the physical resources of the CORESET0. After the
UE. Moreover, the connection between the RAN and the CN reception of this control message, an UE is able to receive
is IP-based. This is reasonable for real-world deployments and decode the first comprehensive RRC message, the System
using multiple gNBs at physically separated locations with a Information Block (SIB)1. The decoded SIB1 contains the
centralized running CN. Nevertheless, RAN and CN can run necessary control information about the initial BWP, where
on the same machine where this connection is purely virtual. all of the dedicated data and control channels are located till
In each case, the provided interface parameters have to match the end of the initial access procedure. Now, the UE can
between the RAN configuration and the CN configuration to receive the RRC setup, exchange the Non-Access Stratum
successfully connect the gNB on the control plane to the (NAS) setup messages and subsequently RRC reconfiguration
Access and Mobility Function (AMF) and on the user plane to messages, which conclude the attach process. The article
the User Plane Function (UPF). Additionally, also the slicing ”5G/NR - Initial Attach” in [17] provides more details about
information, the Tracking Area Code (TAC) and the Public every step of the initial attach procedure.
Land Mobile Network (PLMN) ID have to match in both
configurations because these parameters are processed in the IV. RAN C ONFIGURATION
gNB and the CN independently. This section draws the link between the OAI configuration
The largest part of the RAN configuration influences the and the corresponding theoretical details about the cell search
NR physical layer transmission. Some parameters in the OAI and initial access procedures as presented in Section III-B.
configuration file are important to adapt to the quality of the During this process, an UE first discovers the SSB transmitted
wireless channel. These are Radio Unit (RU) specific settings by the gNB allowing the UE to search for the SIB1. Second,
like attenuation and gain, but also more general aspects like the UE receives the initial BWP and common configurations
power levels for different uplink (UL) and DL procedures via the SIB1. Afterwards, the UE and the network can ex-
or retransmission thresholds. Moreover, the configuration in- change RRC messages. Fig. 2 depicts the information blocks,
cludes the parameters for the channel itself, cell visibility to the RAN transmits throughout the initial attach procedure of
the UE and the initial access procedures. These parameters an UE. The horizontal axis shows the time and the vertical
have to be configured accordingly to the 3GPP specifications, axis indicates the frequency, representing a time-frequency
the capabilities of the UEs and statutory regulations. The grid. All elements in italic are OAI parameters, while the non-
following Section IV illuminates these aspects in detail. italic terms represent the NR related notion of specific parts.
Grey arrows show the size of particular components and the
B. 5G New Radio relationships between them, in contrast to the magenta arrows
This section reviews some basics about 5G NR regarding the indicating the impact of one aspect upon another. Dotted and
radio transmission that are necessary to understand the RAN dashed lines represent the interpretation of the combination of
configuration. At the fundamental level the transmission is different points.
based on orthogonal frequency division multiplexing (OFDM) As mentioned in Section III-A the main motivation to
and therefore divided into different subcarriers. The subcarrier change the frequency range of the transmission are statutory
spacing (SCS) is flexible in NR allowing to adapt the setting to regulations. This holds true for scientific as well as industrial
different total channel bandwidths. Groups of 12 consecutive applications, a license for the utilized frequencies is required
subcarriers form a ressource block (RB), which is a unit for the to operate a 5G network within the licensed spectrum. Hence,
frequency-domain resource allocation. The first block, indexed the starting point of configuring the RAN is to determine the
P/S SS
frequency
PBCH SSB the default value.
CORESET 0 The second present ARFCN parameter is the
dl_carrierBandwidth absoluteFrequencySSB determining the frequency-domain
Center Frequency
... ul_carrierBandwidth position of the SSB. Due to the flexible nature of NR,
the UE monitors multiple predefined positions, the Global
Synchronization Channel Number (GSCN), to detect the
pdcch_ConfigSIB1:
– controlResourceSetZero
SSB and thus see the cell. Hence, there is a synchronization
MIB
... – searchSpaceZero raster containing these predefined locations specified in Table
5.4.3.3-1 of [23]. Fig. 2 shows the SSB with its different
absoluteFrequencySSB
# of consecutive RBS
for the Physical Downlink Control Channel (PDCCH) while
initial DL BWP
the controlResourceSetZero determines the physical resources
of the CORESET0. Hence, the parameters depend on the
desired positioning of the SSB and the CORESET0. Each
of both parameters is four bits in size. There are tables,
Offset (RBs)
Throughput (Mbps)
software components to provide a reference setup, that is as 115
Latency (ms)