FEATURE_SET.md 14.6 KB
Newer Older
1 2
**Table of Contents**

Remi Hardy's avatar
Remi Hardy committed
3 4 5
1. [Functional Split Architecture](#functional-split-architecture)
2. [OpenAirInterface Block Diagram](#openairinterface-block-diagram)
2. [OpenAirInterface 4G-LTE eNB Feature Set](#openairinterface-4g-lte-enb-feature-set)
6 7 8 9 10 11
   1. [eNB PHY Layer](#enb-phy-layer)
   2. [eNB MAC Layer](#enb-mac-layer)
   3. [eNB RLC Layer](#enb-rlc-layer)
   4. [eNB PDCP Layer](#enb-pdcp-layer)
   5. [eNB RRC Layer](#enb-rrc-layer)
   6. [eNB X2AP](#enb-x2ap)
12 13
   7. [eNB/MCE M2AP](#enbmce-m2ap)
   8. [MCE/MME M3AP](#mcemme-m3ap)
Remi Hardy's avatar
Remi Hardy committed
14
3. [OpenAirInterface 4G-LTE UE Feature Set](#openairinterface-4g-lte-ue-feature-set)
15 16 17 18 19
   1.  [LTE UE PHY Layer](#lte-ue-phy-layer)
   2.  [LTE UE MAC Layer](#lte-ue-mac-layer)
   3.  [LTE UE RLC Layer](#lte-ue-rlc-layer)
   4.  [LTE UE PDCP Layer](#lte-ue-pdcp-layer)
   5.  [LTE UE RRC Layer](#lte-ue-rrc-layer)
Remi Hardy's avatar
Remi Hardy committed
20
4. [OpenAirInterface 5G-NR gNB Feature Set](#openairinterface-5g-nr-feature-set)
21
   1. [General Parameters](#general-parameters)
Remi Hardy's avatar
Remi Hardy committed
22 23 24 25 26
   2. [gNB Physical Layer](#gnb-phy-layer)
   3. [gNB Higher Layers](#gnb-higher-layers)
5. [OpenAirInterface 5G-NR UE Feature Set](#openairinterface-5g-nr-ue-feature-set)
   1. [UE Physical Layer](#ue-phy-layer)
   2. [UE Higher Layers](#ue-higher-layers)
27

Remi Hardy's avatar
Remi Hardy committed
28 29 30 31 32 33 34 35 36 37 38 39 40 41

# Functional Split Architecture #

-  RCC: Radio-Cloud Center
-  RAU: Radio-Access Unit
-  RRU: Remote Radio-Unit
-  IF4.5 / IF5 : similar to IEEE P1914.1
-  FAPI (IF2)  : specified by Small Cell Forum (open-nFAPI implementation)
-  IF1         : F1 in 3GPP Release 15

![Functional Split Architecture](./oai_enb_func_split_arch.png)


# OpenAirInterface Block Diagram #
42

43
![Block Diagram](./oai_enb_block_diagram.png)
44

Remi Hardy's avatar
Remi Hardy committed
45
# OpenAirInterface 4G LTE eNB Feature Set #
46 47 48 49 50 51 52 53 54 55 56 57

## eNB PHY Layer ##

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
58 59
- Downlink (DL) channels are supported: PSS, SSS, PBCH, PCFICH, PHICH, PDCCH, PDSCH, PMCH, MPDCCH
- Uplink (UL) channels are supported: PRACH, PUSCH, PUCCH (format 1/1a/1b), SRS, DRS
60 61
- HARQ support (UL and DL)
- Highly optimized base band processing (including turbo decoder)
62 63
- Multi-RRU support: over the air synchro b/ multi RRU in TDD mode
- Support for CE-modeA for LTE-M. Limited support for repeatition, single-LTE-M connection, legacy-LTE UE attach is disabled.
64 65 66

### Performances ###

67 68 69
**Transmission Mode, Bandwidth** | **Expected Throughput** | **Measured Throughput** | **Measurement Conditions**
-------------------------------- | ----------------------- | ------------------------| ----------------:
FDD DL: 5 MHz, 25 PRBS/ MCS 28   | 16 - 17 Mbit/s          | TM1: 17.0 Mbits/s       | COTS-UE Cat 4 (150/50 Mbps)
70
FDD DL: 10 MHz, 50 PRBS/ MCS 28  | 34 - 35 Mbit/s          | TM1: 34.0 Mbits/s       | COTS-UE Cat 4 (150/50 Mbps)
71 72 73
FDD DL: 20 MHz, 100 PRBS/ MCS 28 | 70 Mbit/s               | TM1: 69.9 Mbits/s       | COTS-UE Cat 4 (150/50 Mbps)
 |  |  | 
FDD UL: 5 MHz, 25 PRBS/ MCS 20   | 9 Mbit/s                | TM1: 8.28 Mbits/s       | COTS-UE Cat 4 (150/50 Mbps)
74
FDD UL: 10 MHz, 50 PRBS/ MCS 20  | 17 Mbit/s               | TM1: 18.3 Mbits/s       | COTS-UE Cat 4 (150/50 Mbps)
75
FDD UL: 20 MHz, 100 PRBS/ MCS 20 | 35 Mbit/s               | TM1: 18.6 Mbits/s       | COTS-UE Cat 4 (150/50 Mbps)
76
 |  | 
77 78 79
TDD DL: 5 MHz, 25 PRBS/ MCS **XX**   | 6.5 Mbit/s          | TM1: 6.71 Mbits/s       | COTS-UE Cat 4 (150/50 Mbps)
TDD DL: 10 MHz, 50 PRBS/ MCS **XX**  | 13.5 Mbit/s         | TM1: 13.6 Mbits/s       | COTS-UE Cat 4 (150/50 Mbps)
TDD DL: 20 MHz, 100 PRBS/ MCS **XX** | 28.0 Mbit/s         | TM1: 27.2 Mbits/s       | COTS-UE Cat 4 (150/50 Mbps)
80
 |  | | 
81 82 83
TDD UL: 5 MHz, 25 PRBS/ MCS **XX**   | 2.0 Mbit/s          | TM1: 3.31 Mbits/s       | COTS-UE Cat 4 (150/50 Mbps)
TDD UL: 10 MHz, 50 PRBS/ MCS **XX**  | 2.0 Mbit/s          | TM1: 7.25 Mbits/s       | COTS-UE Cat 4 (150/50 Mbps)
TDD UL: 20 MHz, 100 PRBS/ MCS **XX** | 3.0 Mbit/s          | TM1: 4.21 Mbits/s       | COTS-UE Cat 4 (150/50 Mbps)
84

85 86 87 88 89
### Number of supported UEs ###

* 16 by default
* up to 256 when compiling with dedicated compile flag
* was tested with 40 COTS-UE
90 91 92 93 94 95

## eNB MAC Layer ##

The MAC layer implements a subset of the **3GPP 36.321** release v8.6 in support of BCH, DLSCH, RACH, and ULSCH channels. 

- RRC interface for CCCH, DCCH, and DTCH
hardy's avatar
hardy committed
96 97 98
- Proportional fair scheduler (round robin scheduler soon), with the following improvements:
	- Up to 30 users tested in the L2 simulator, CCE allocation in the preprocessor ; the scheduler was also simplified and made more modular
	- Adaptative UL-HARQ
Remi Hardy's avatar
Remi Hardy committed
99
	- Remove out-of-sync UEs
hardy's avatar
hardy committed
100
	- No use of the `first_rb` in the UL scheduler ; respects `vrb_map_UL` and `vrb_map` in the DL
101 102 103 104 105 106
- DCI generation
- HARQ Support
- RA procedures and RNTI management
- RLC interface (AM, UM)
- UL power control
- Link adaptation
107
- Connected DRX (CDRX) support for FDD LTE UE. Compatible with R13 from 3GPP. Support for Cat-M1 UE comming soon.  
108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140

## eNB RLC Layer ##

The RLC layer implements a full specification of the 3GPP 36.322 release v9.3.

- RLC TM (mainly used for BCCH and CCCH) 
  * Neither segment nor concatenate RLC SDUs
  * Do not include a RLC header in the RLC PDU
  * Delivery of received RLC PDUs to upper layers
- RLC UM (mainly used for DTCH) 
  * Segment or concatenate RLC SDUs according to the TB size selected by MAC
  * Include a RLC header in the RLC PDU
  * Duplication detection
  * PDU reordering and reassembly
- RLC AM, compatible with 9.3 
  * Segmentation, re-segmentation, concatenation, and reassembly
  * Padding
  * Data transfer to the user
  * RLC PDU retransmission in support of error control and correction
  * Generation of data/control PDUs

## eNB PDCP Layer ##

The current PDCP layer is header compliant with **3GPP 36.323** Rel 10.1.0 and implements the following functions:

- User and control data transfer
- Sequence number management
- RB association with PDCP entity
- PDCP entity association with one or two RLC entities
- Integrity check and encryption using the AES and Snow3G algorithms

## eNB RRC Layer ##

Remi Hardy's avatar
Remi Hardy committed
141
The RRC layer is based on **3GPP 36.331** v15.6 and implements the following functions:
142 143

- System Information broadcast (SIB 1, 2, 3, and 13)
Raphael Defosseux's avatar
Raphael Defosseux committed
144
  * SIB1: Up to 6 PLMN IDs broadcast
145 146 147 148 149 150 151 152
- RRC connection establishment
- RRC connection reconfiguration (addition and removal of radio bearers, connection release)
- RRC connection release
- RRC connection re-establishment
- Inter-frequency measurement collection and reporting (experimental)
- eMBMS for multicast and broadcast (experimental)
- Handover (experimental)
- Paging (soon)
153
- RRC inactivity timer (release of UE after a period of data inactivity)
154 155 156

## eNB X2AP ##

157 158 159 160
The X2AP layer is based on **3GPP 36.423** v14.6.0 and implements the following functions:

 - X2 Setup Request
 - X2 Setup Response 
161 162 163
 - X2 Setup Failure
 - Handover Request 
 - Handover Request Acknowledge
164
 - UE Context Release
Cedric Roux's avatar
Cedric Roux committed
165 166
 - X2 timers (t_reloc_prep, tx2_reloc_overall)
 - Handover Cancel
167
 - X2-U interface implemented
Remi Hardy's avatar
Remi Hardy committed
168 169 170 171
 - EN-DC is implemented
 - X2AP : Handling of SgNB Addition Request / Addition Request Acknowledge / Reconfiguration Complete
 - RRC  : Handling of RRC Connection Reconfiguration with 5G cell info, configuration of 5G-NR measurements
 - S1AP : Handling of E-RAB Modification Indication / Confirmation 
172

173
## eNB/MCE M2AP ##
174

175 176 177 178 179 180 181 182 183 184
The M2AP layer is based on **3GPP 36.443** v14.0.1:
 - M2 Setup Request
 - M2 Setup Response 
 - M2 Setup Failure
 - M2 Scheduling Information
 - M2 Scheduling Information Response 
 - M2 Session Start Request
 - M2 Session Start Response

## MCE/MME M3AP ##
185

186 187 188 189 190 191 192
The M3AP layer is based on **3GPP 36.444** v14.0.1:
 - M3 Setup Request
 - M3 Setup Response 
 - M3 Setup Failure
 - M3 Session Start Request
 - M3 Session Start Response

193

Remi Hardy's avatar
Remi Hardy committed
194
# OpenAirInterface 4G LTE UE Feature Set #
195

196 197 198 199 200 201 202 203 204 205 206 207 208
## LTE UE PHY Layer ##

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)
- 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
209 210 211
- LTE MBMS-dedicated cell (feMBMS) procedures subset for LTE release 14 (experimental)  
- LTE non-MBSFN subframe (feMBMS) Carrier Adquistion Subframe-CAS procedures (PSS/SSS/PBCH/PDSH) (experimental)
- LTE MBSFN MBSFN subframe channel (feMBMS): PMCH (CS@1.25KHz) (channel estimation for 25MHz bandwidth) (experimental) 
212

213 214 215 216 217 218 219 220 221 222
## LTE UE MAC Layer ##

The MAC layer implements a subset of the **3GPP 36.321** release v8.6 in support of BCH, DLSCH, RACH, and ULSCH channels. 

- RRC interface for CCCH, DCCH, and DTCH
- HARQ Support
- RA procedures and RNTI management
- RLC interface (AM, UM)
- UL power control
- Link adaptation
223 224
- MBMS-dedicated cell (feMBMS) RRC interface for BCCH 
- eMBMS and MBMS-dedicated cell (feMBMS) RRC interface for MCCH, MTCH
225 226 227 228 229 230 231 232 233 234 235 236 237 238 239

## LTE UE RLC Layer ##

The RLC layer implements a full specification of the 3GPP 36.322 release v9.3.

## LTE UE PDCP Layer ##

The current PDCP layer is header compliant with **3GPP 36.323** Rel 10.1.0.

## LTE UE RRC Layer ##

The RRC layer is based on **3GPP 36.331** v14.3.0 and implements the following functions:

- System Information decoding
- RRC connection establishment
240
- MBMS-dedicated cell (feMBMS) SI-MBMS/SIB1-MBMS management
241 242 243 244 245 246 247

## LTE UE NAS Layer ##

The NAS layer is based on **3GPP 24.301** and implements the following functions:

- EMM attach/detach, authentication, tracking area update, and more
- ESM default/dedicated bearer, PDN connectivity, and more
frtabu's avatar
frtabu committed
248

249

250 251 252 253 254 255 256
# OpenAirInterface 5G-NR Feature Set #

## General Parameters ##

The following features are valid for the gNB and the 5G-NR UE.

*  Static TDD, 
257
*  FDD
258 259 260
*  Normal CP
*  30 kHz subcarrier spacing
*  Bandwidths up to 80MHz (217 Physical Resource Blocks)
261
*  Intermediate downlink and uplink frequencies to interface with IF equipment
262 263
*  Single antenna port (single beam)
*  Slot format: 14 OFDM symbols in UL or DL
264 265 266
*  Highly efficient 3GPP compliant LDPC encoder and decoder (BG1 and BG2 supported)
*  Highly efficient 3GPP compliant polar encoder and decoder
*  Encoder and decoder for short blocks
267 268


Remi Hardy's avatar
Remi Hardy committed
269
## gNB PHY Layer ##
270

Remi Hardy's avatar
Remi Hardy committed
271 272 273 274
*  30KHz SCS for FR1 and 120 KHz SCS for FR2
*  Generation of NR-PSS/NR-SSS
*  NR-PBCH supports multiple SSBs and flexible periodicity
*  Generation of NR-PDCCH for SIB1 (including generation of DCI, polar encoding, scrambling, modulation, RB mapping, etc)
275 276
   - common search space configured by MIB
   - user-specific search space configured by RRC
Remi Hardy's avatar
Remi Hardy committed
277 278 279 280 281
   - DCI formats: 00, 10 (01 and 11 **under integration**)
*  Generation of NR-PDSCH (including Segmentation, LDPC encoding, rate matching, scrambling, modulation, RB mapping, etc).
   - Single symbol DMRS, DMRS-TypeA-Position Pos2,  DMRS configuration type 1
   - PDSCH mapping type A
*  NR-CSI Generation of sequence at PHY (**under integration**)
282 283
*  NR-PUSCH (including Segmentation, LDPC encoding, rate matching, scrambling, modulation, RB mapping, etc).
*  NR-PUCCH 
Remi Hardy's avatar
Remi Hardy committed
284 285 286 287 288 289 290
   - Format 0 (2 bits, mainly for ACK/NACK)
   - Format 2 (up to 64 bits, mainly for CSI feedback)
*  NR-PRACH
   - Formats 0,1,2,3, A1-A3, B1-B3
*  Highly efficient 3GPP compliant LDPC encoder and decoder (BG1 and BG2 are supported)
*  Highly efficient 3GPP compliant polar encoder and decoder
*  Encoder and decoder for short block
291
   
Remi Hardy's avatar
Remi Hardy committed
292 293 294
## gNB Higher Layers ##

**gNB RRC**  
295 296
- NR RRC (38.331) Rel 15 messages using new asn1c 
- LTE RRC (36.331) also updated to Rel 15 
Remi Hardy's avatar
Remi Hardy committed
297
- Generation of CellGroupConfig (for eNB) and MIB
298
- Generation of system information block 1 (SIB1)
299
- Application to read configuration file and program gNB RRC
Remi Hardy's avatar
Remi Hardy committed
300 301 302 303 304 305 306 307 308
- RRC can configure PDCP, RLC, MAC

**gNB X2AP**
- X2 setup with eNB
- Handling of SgNB Addition Request / Addition Request Acknowledge / Reconfiguration Complete 

**gNB MAC**
- MAC -> PHY configuration using NR FAPI P5 interface
- MAC <-> PHY data interface using FAPI P7 interface for BCH PDU, DCI PDU, PDSCH PDU
309 310
- Scheduler procedures for SIB1
- Scheduler procedures for RA
Remi Hardy's avatar
Remi Hardy committed
311 312
- MAC downlink scheduler (fixed allocations)
- MAC header generation (including timing advance)
Remi Hardy's avatar
Remi Hardy committed
313 314
- ACK / NACK handling and HARQ procedures for downlink
- **As of May 2020** only DL was validated with COTS phone ; UL in progress, validated with OAI UE in noS1 mode
Remi Hardy's avatar
Remi Hardy committed
315 316 317 318 319 320 321 322 323 324 325 326 327 328 329 330 331 332 333 334 335 336 337 338 339 340 341 342 343 344 345 346 347 348 349 350 351

# OpenAirInterface 5G-NR UE Feature Set #

**as of May 2020** only supporting "noS1" mode (DL):
- Creates TUN interface to PDCP to inject and receive user-place traffic
- Will only work with OAI gNB configured in the same mode

##  UE PHY Layer ##

*  Initial synchronization
*  Time tracking based on PBCH DMRS
*  Time tracking based on PBCH DMRS
*  Frequency offset estimation
*  PBCH RX
*  PDCCH RX
*  PDSCH RX, including a first version of dual stream receiver for PDSCH  
*  30KHz SCS for FR1 and 120 KHz SCS for FR2
*  Generation of NR-PSS/NR-SSS
*  NR-PBCH supports multiple SSBs and flexible periodicity
*  Generation of NR-PDCCH for SIB1 (including generation of DCI, polar encoding, scrambling, modulation, RB mapping, etc)
   - common search space configured by MIB
   - user-specific search space configured by RRC
   - DCI formats: 00, 10 (01 and 11 **under integration**)
*  Generation of NR-PDSCH (including Segmentation, LDPC encoding, rate matching, scrambling, modulation, RB mapping, etc).
   - Single symbol DMRS, DMRS-TypeA-Position Pos2,  DMRS configuration type 1
   - PDSCH mapping type A
*  NR-CSI Generation of sequence at PHY (**under integration**)
*  NR-PUSCH (including Segmentation, LDPC encoding, rate matching, scrambling, modulation, RB mapping, etc).
*  NR-PUCCH 
   - Format 0 (2 bits, mainly for ACK/NACK)
   - Format 2 (up to 64 bits, mainly for CSI feedback)
*  NR-PRACH
   - Formats 0,1,2,3, A1-A3, B1-B3
*  Highly efficient 3GPP compliant LDPC encoder and decoder (BG1 and BG2 are supported)
*  Highly efficient 3GPP compliant polar encoder and decoder
*  Encoder and decoder for short block

352

Remi Hardy's avatar
Remi Hardy committed
353
## UE Higher Layers ##
354

355 356 357 358 359 360 361
**UE MAC**
*  Minimum system information (MSI)
    - Initial sync and MIB detection
    - System information block 1 (SIB1) reception
*  MAC -> PHY configuration of PHY via UE FAPI P5 interface
*  Basic MAC to control PHY via UE FAPI P7 interface
*  Random access procedure
362

363

Remi Hardy's avatar
Remi Hardy committed
364
**RLC**
365

Remi Hardy's avatar
Remi Hardy committed
366
**PDCP**
367

368

frtabu's avatar
frtabu committed
369

370
[OAI wiki home](https://gitlab.eurecom.fr/oai/openairinterface5g/wikis/home)
frtabu's avatar
frtabu committed
371

372
[OAI softmodem build procedure](BUILD.md)
frtabu's avatar
frtabu committed
373

374
[Running the OAI softmodem ](RUNMODEM.md)