Osa Eurecom Kaltenberger
Osa Eurecom Kaltenberger
Osa Eurecom Kaltenberger
Florian Kaltenberger
Joint ETSI - OSA workshop,
Sophia-Antipolis, 11.12.2018
07/12/2018 2
What is OpenAirInterface?
07/12/2018 3
Collaborative Web Tools
Main page:
– https://www.openairinterface.org
Code available from
– RAN (eNB + UE)
https://gitlab.eurecom.fr/oai/openairinterface5g
– EPC
https://github.com/OPENAIRINTERFACE/openair-cn
Mailing lists
– https://gitlab.eurecom.fr/oai/openairinterface5g/wikis/MailingList
Developer meetings (Eurecom & Webex)
– General: Tuesday Mornings 11:00 CET
– NR: Friday, alternating between 11:CET (Europe/Asia) and 16:00 CET (Europe/Americas)
Forum in Chinese
– http://bbs.opensource5g.org/forum.php
Other tools:
– https://openairinterface.slack.com
– https://trello.com/oaidev
08/12/2018 4
The OpenAirInterface Software Alliance
07/12/2018 5
OSA Boards
Strategic Board
– OSA strategic members
– Webex meeting every 2 weeks
– Overview of recent activity
– Discussion on
strategic objectives
Legal matters
Links with other organizations (e.g. standardization)
Technical Board
– Members: OSA, Orange, Nokia, Fujitsu, TCL, EURECOM, BCOM, Fraunhofer
IIS, OpenCells
– Roadmap implementation
– Architecture evolution
– Documentation & Coding guidelines
– Review merge requests
Code quality
Adherence to architecture
07/12/2018 7
Main achievements (develop branch) since last
workshop
Technical Board developed/improved
– Workflow / Development / Integration policies,
– Coding guidelines,
– Documentation
Many CI Framework improvements
Multi-UE/RA scheduling improvements
TDD configuration 1 (stabilization & integration in CI)
Parallelization & performance improvements
Rewrite ITTI
Bug Fixes
Code cleanup & debugging tools (see later presentation)
New asn1c
Repository reorganization
– separation of eNB & UE in different executables,
– Preparation for gNB and nrUE
IP packets AT commands
Linux IP
NAS eNB Application NAS S11 Abstraction S1-U
stack
RLC RLC IP IP
PHY PHY
OPENAIRINTERFACE
RAN FEATURES
07/12/2018 9
OpenAirInterface eNB features (PHY)
The Physical layer implements 3GPP 36.211, 36.212, 36.213 and provides the
following features:
– LTE release 8.6 compliant, and implements a subset of release 10;
– FDD and TDD configurations 1 (experimental) and 3;
– Bandwidth: 5, 10, and 20 MHz;
– Transmission modes: 1, 2 (stable), 3, 4, 5, 6, 7 (experimental);
– Max number of antennas: 2
– CQI/PMI reporting: aperiodic, feedback mode 3-0 and 3-1;
– PRACH preamble format 0
– All downlink (DL) channels are supported: PSS, SSS, PBCH, PCFICH, PHICH, PDCCH, PDSCH,
PMCH;
– All uplink (UL) channels are supported: PRACH, PUSCH, PUCCH (format 1/1a/1b), SRS, DRS;
– HARQ support (UL and DL);
– Highly optimized base band processing (including turbo decoder).
– Expected throughputs DL
5 MHz, 25 PRBS/ MCS 28 = 16-17 Mbit/s (measured with COTS UE Cat 3/4)
10 MHz, 50 PRBS/MCS 28 = 34-35 Mbit/s (measured with COTS UE Cat 3/4)
20 MHz, 100 PRBS/MCS 28 = ~70 Mbit/s (measured with COTS UE Cat 3/4)
– Expected throughputs UL
5 MHz, 20 PRBs / MCS 20 = 9 Mbit/s (measured with COTS UE Cat 3/4)
10 MHz, 45 PRBs / MCS 20 = 17 Mbit/s (measured with COTS UE Cat 3/4)
20 MHz, 96 PRBs / MCS 20 = ~35 Mbit/s (measured with COTS UE Cat 3/4)
07/12/2018 10
OpenAirInterface eNB features (MAC)
07/12/2018 11
OpenAirInterface eNB features (PDCP)
07/12/2018 12
OpenAirInterface eNB features (RLC)
07/12/2018 13
OpenAirInterface eNB features (RRC)
08/12/2018 14
eNB Functional Splits
07/12/2018 15
eNB Functional Split Architecture
07/12/2018 16
Buggy/Missing/Incomplete Features in develop
Essential
– TM3/4/8/9/10 : incomplete
– PUCCH2 : incomplete
– TDD configurations : incomplete
– Measurement gap handling : missing
– Carrier Aggregation : incomplete
– X2-handover : MR imminent
– UE needs improvement (more buggy than master)
Needs improvement
– Multi-UE UL/RA scheduling
– RLC AM mode
10/12/2018 17
Experimental/upcoming eNB features
DRX/eDRX handling
Multi RRU handling and synchronization
Rel 13 LTE-M
Rel 14 NB-IoT (see presentation during workshop)
Rel 14 D2D/Sidelink/ProSe
Rel 15 5G-NR
10/12/2018 18
Support for eMTC in OAI
Release 13 eMTC
Public branch
– enhancement-ltem
– Merge with current develop branch completed
Legacy LTE functionality validated on merge, still testing LTE-M
– CI Framework integration => push to develop imminent
Default file
– t ar get s/ PROJECTS/ GENERI C- LTE-
ENB/ CONF/ enb. band13. t m1. 50PRB. emt c. conf
– New elements
Shown on gitlab
Testing status
– Off-network unicast/multicast scenarios (LTE-D2D Mode2)
Tested in both RF and emulation
– On-network unicast/multicast scenarios (LTE-D2D Mode1)
Tested in emulation, not RF yet
– Partial coverage (UE-to-Network relay procedures)
Initial tests in emulation (non-3gpp aligned for now), not in RF yet
Code availability
– Currently under private repository
– To be merged with develop branch of main OAI by beginning of January 2019
Branch: develop-nr
PHY layer additions
– Highly efficient 3GPP compliant LDPC encoder and decoder – Subcarrier spacing: 30kHz (60kHz, 120kHz)
(BG1 and BG2 supported) – Bandwidths: 40MHz, (80MHz, 100MHz)
– Highly efficient 3GPP compliant polar encoder and decoder – Normal cyclic prefix
– NR-PSS and NR-SSS (validated with R&S FSW) – Static TDD
– NR-PBCH single beam (validated with R&S FSW)
– NR-PDCCH (validated with OAI UE)
type 0
DCI formats: 00, 10
– -NR-PDSCH (validated with OAI UE)
Single symbol DMRS, dmrs-TypeA-Position Pos2,
DMRS configuration type 1
PDSCH mapping type A
MAC Come and see our demo!
– Updated FAPI interface to 5G-NR
– Adapted FAPI interface also to UE
Higher layers
– Import of 38.331 RRC messages using asn1c (new version)
– Application to read configuration file and program gNB RRC
– Generation of MIB (validated with R&S FSW)
– RRC -> MAC configuration
– MAC -> PHY configuration using FAPI P5 interface
– MAC dummy scheduler using FAPI P7 interface
Architecture
– Non-standalone (Architecture option 3); initially with emulated 4G link
– standalone (option 2): requires 5G core
- p 27
HARDWARE TARGETS
07/12/2018 28
Hardware Requirements
SDR platform
– ExpressMIMO2 (discontinued)
– USRP B200, X300, N300 (recommended)
– Blade RF
– LMS-SDR
– Skylark Iris
– Syrtem
Host PC
– A powerful x86 PC (recommended)
Intel Core i5, i7, i9
Intel Xeon
Intel Atom
4 cores, > 3GHz, SSE 4, AVX
– Low-cost x86 PC
Up board (up2), Euclid board
– ARM (experimental)
Odroid
Antennas, Duplexers, etc
07/12/2018 29
*needs external RF elements
Comparison ** depends on daughterboard
*** subjective to the author
Frequency range 70MHz – 6GHz DC-6GHz 10 MHz – 6GHz 47MHz to 6GHz 300 MHz –
(depends on 3.8GHz
daughterbrd)
Price €1,130 ~€5,000 ~€10,000 $480 - $720 $299
Duplexing FDD* or TDD* FDD* or TDD* FDD* or TDD FDD* FDD* or TDD*
08/12/2018 30
Other experimental targets
Epiq Sidekiq
– Based on AD 9361
– Mini PCIe or M.2 form factor
CPRI - PCIexpress
– IT Avero
– Based on Xilinx eval board
CPRI gateway Skylark Iris
– Bell Labs
– Based on Xilinx or Intel platform
Epiq Sidekiq SYRTEM UED
Skylark Iris platform
– Based on Lime platform
– Scalable for massive MIMO
SYRTEM UED platform
– Based on Xilinx ZC706 eval board + AD9371 daughterboard
– 2 full duplex channels with up to 122.88 MHz sampling
– Not 100% open source
09/12/2018 31
OAI eNB + OAI UE
INSTALLATION
07/12/2018 32
Software Requirements
Operating system
– Ubuntu >= 16.04.2
works for both openairinterface5g and openair-cn
For real-time operation, a low-latency kernel is recommended
For P/S-GW, gtp kernel module needs to be patched
See details on Wiki
– CentOS Linux release 7.4.1708 (Core)
Better real-time performance than Ubuntu low-latency
07/12/2018 33
OpenAirInterface5G directories
cmake_targets
– New directory for building all the targets
– Contains “mother” build_oai script
targets
– Hardware specific code (drivers, tools, etc)
– lte-softmodem,
openair1
– Basic DSP routines for implementing subset of LTE specifications under x86
(36.211, 36.212, 36.213 3GPP specifications)
– Channel simulation, sounding and PHY abstraction software,
openair2
– MAC/RLC/PDCP/RRC
openair3
– Contains interfaces S1-C, S1-U (GTP, SCTP, S1AP) and NAS UE
common/utils
– Utilities such as the T tracer or the ITTI
07/12/2018 34
Compiling OpenAirInterface5G
09/12/2018 35
How to connect COTS phone to OAI eNB
Additional requirements
– Core network (e.g., OAI EPC, see later in training)
– Sim card with corresponding parameters
Compile eNB
– ./build_oai –w USRP --eNB
Configure eNB
– targets/PROJECTS/GENERIC-LTE-EPC/CONF/
– Select the config file that is most appropriate for your configuration
(Band and Hardware)
– Check
MCC, MNC, TAC (need to match EPC)
downlink_frequency, bandwidth, etc
IP addresses of S1-MME and S1-U interfaces
Run eNB
– sudo ./lte-softmodem –O <file.conf>
09/12/2018 36
How to connect OAI UE to OAI eNB
Compile UE
– ./build_oai –w USRP --eNB [--ue-nas-use-tun | --noS1]
Run UE
– sudo ./lte-softmodem –U –C <freq> -r [25|50|100] –ue-scan-carrier –
ue-txgain xx –ue-rxgain yy (-d)
09/12/2018 37
How to setup RCC and RRU
RCC
– ./build_oai -w USRP -t ETHERNET –eNB
– Check RU parameters in RCC config file
IF name, local and remote IP addresses and ports
local_rf = "no"
tr_preference = "udp_if4p5“
– ./lte-softmodem –O <file.conf>
RRU
– ./build_oai -t ETHERNET –eNB
– Check RU parameters in RCC config file
IF name, local and remote IP addresses and ports
local_rf = “yes"
tr_preference = "udp_if4p5“
– ./lte-softmodem –O <file.conf>
09/12/2018 38
Troubleshooting
07/12/2018 40
Debug tools
The T tracer
– Monitor the eNB in real-time, simulation, or playback mode
Telnet server
– Monitor and change parameters of the eNB in real-time or simulation
eNB UE
Simulators
– ulsim/dlsim PDCP PDCP
– Basic simulator RLC RLC
– L1 simulator
MAC MAC
– L2 FAPI simulator*
PHY PHY
*being integrated into develop
channel
07/12/2018 41
The T tracer
07/12/2018 42
The T tracer: usage of GUI
07/12/2018 43
eNB GUI
HARQ ACK
HARQ NAK
New DCI
Retr. DCI
07/12/2018 44
Telnet server
Easily extendable
Usage
– ./build_oai –w USRP –eNB –build-telnetsrv
– sudo ./lte-softmodem –O <…> --telnetsrv
– Telnet 127.0.0.1 9090
– Use online help
07/12/2018 45
Simulators
dlsim/ulsim
– ./build_oai –phy_simulators
Basic simulator
– ./build_oai –basic-simulator
– See targets/ARCH/tcp_bridge/README.tcp_bridge_oai
L1 simulator (ex oaisim)
– Based in IF5/IF4.5
– ./build_oai --eNB -t ETHERNET --noS1
– eNB: sudo ./lte-softmodem -O ../../../targets/PROJECTS/GENERIC-LTE-
EPC/CONF/rcc.band7.tm1.if4p5.50PRB.lo.conf
– ./build_oai --UE -t ETHERNET --noS1
– UE: sudo ./lte-uesoftmodem -O ../../../targets/PROJETS/GENERIC-LTE-
EPC/CONF/rru.oaisim.conf -A AWGN -r 50 -s 25 --siml1
L2 simulator
– Based on nFAPI (IF2)
– Same build process as L1 simulator but config files for nFAPI
– See targets/DOCS/nfapi-L2-emulator-setup.txt for details
07/12/2018 46
BACKUP
07/12/2018 47
Use case I: classical 3GPP network
08/12/2018 48
Use case II: simplified network
08/12/2018 49
Use case III: cloud-RAN
Main target of EURECOM deployment
08/12/2018 50
Epiq Sidekiq
07/12/2018 51