docs/release-notes.rst

   1 .. This work is licensed under a Creative Commons Attribution 4.0 International License.
   2 .. http://creativecommons.org/licenses/by/4.0
   3
   4
   5 Release-Notes
   6 **************
   7
   8
   9 This document provides the release notes for D Release of O-DU-L2.
  10
  11 .. contents::
  12    :depth: 3
  13    :local:
  14
  15
  16 Version history
  17 ---------------
  18
  19 +--------------------+--------------------+--------------------+--------------------+
  20 | **Date**           | **Ver.**           | **Author**         | **Comment**        |
  21 |                    |                    |                    |                    |
  22 +--------------------+--------------------+--------------------+--------------------+
  23 | 2021-09-06         | 4.0.0              | Radisys,           | D Release          |
  24 |                    |                    | HCL Technologies   |                    |
  25 |                    |                    | Ltd.               |                    |
  26 +--------------------+--------------------+--------------------+--------------------+
  27 | 2020-12-04         | 3.0.0              | Radisys,           | Cherry Release     |
  28 |                    |                    | HCL Technologies   |                    |
  29 |                    |                    | Ltd.               |                    |
  30 +--------------------+--------------------+--------------------+--------------------+
  31 | 2020-06-17         | 2.0.0              | Radisys            | Bronze Release     |
  32 |                    |                    |                    |                    |
  33 +--------------------+--------------------+--------------------+--------------------+
  34 | 2019-12-29         | 1.0.0              | Radisys            | Amber Release      |
  35 |                    |                    |                    |                    |
  36 +--------------------+--------------------+--------------------+--------------------+
  37
  38
  39 Summary
  40 -------
  41
  42 D
  43 ^^^^^^^^
  44 This release contains the following:
  45
  46  - UL/DL Data transmission on FDD/Mu0/20MHz.
  47
  48  - Support for static TDD at O-DU High on 100 MHz Bandwidth, numerology 1.
  49
  50  - Support for Closed Loop automation use case at O-DU High.
  51
  52  - O-DU low – O-DU high pairwise testing in Radio mode (Broadcast message successfully received at O-DU Low).
  53
  54  - O1 Module
  55       Re-structure O1 module to run as a thread in ODU-High.
  56
  57       CM Support - IP and Port configuration for DU, CU stub and RIC stub via Netconf interface.
  58
  59       VES PNF Registration.
  60
  61       Support for Closed Loop Automation use-case.
  62
  63  - Maintenance release includes :
  64
  65       Memory handling optimization and fixes.
  66
  67       Improvement in logging.
  68
  69       K0, K1 and K2 configuration.
  70
  71       Fixes in proccessing of RACH Indication and RAR.
  72
  73 Cherry
  74 ^^^^^^^^
  75 This release contains the following:
  76
  77 - Implementation of UE attach signalling procedure on single carrier.
  78   All message exchanges within O-DU High are in line with WG8 AAD spec.
  79
  80 - Enhancements to F1-C interface as required for UE attach procedure.
  81
  82 - Enhancements to FAPI interface towards O-DU Low as required for UE attach procedure.
  83
  84 - Support for all short PRACH formats.
  85
  86 - Integration of FAPI P5 messages with Intel's O-DU Low in Timer mode.
  87
  88 - Code support for alignment with latest FAPI interface files from Intel.
  89
  90 - Implementation of O1 interface.
  91
  92 - Partial implementation of Health Check use-case with get-Alarm list API.
  93
  94
  95 Bronze
  96 ^^^^^^^^
  97 This release contains the following:
  98
  99 - Enhancements to F1-C interface for UE attach procedure.
 100
 101 - Implementation of F1-U interface.
 102
 103 - Implementation of E2 interface.
 104
 105 - Support for traffic steering usecase.
 106
 107 - Support for single carrier.
 108
 109 - Implementation of basic scheduler.
 110
 111 - Implementation of Cell broadcast procedure.
 112
 113 - Implementation of UE procedure till msg-4 for single UE. Complete testing of these messages is in progress.
 114
 115 - Implementation of FAPI interface towards O-DU Low using WLS.
 116
 117 - Partial implementation of RLC layer interfaces towards upper and lower layers
 118   conforming to AAD spec.
 119
 120
 121 Amber
 122 ^^^^^
 123 This release contains the following:
 124
 125 - O-DU layer intilaizations
 126
 127 - Implementation of F1-C interface
 128
 129 - Exchange of F1 Setup Request, F1 Setup Response, GNB DU Config Update and GNB DU Config Update ACK between the ODU and CU STUB.
 130
 131
 132 Release Data
 133 ------------
 134
 135 D
 136 ^^^^^^
 137 +--------------------------------------+--------------------------------------+
 138 | **Project**                          | ODUHIGH                              |
 139 |                                      |                                      |
 140 +--------------------------------------+--------------------------------------+
 141 | **Repo/commit-ID**                   | o-du/l2/                             |
 142 |                                      | 897f30ba87c05a3c3eb6feea4539e6631d8c |
 143 |                                      | 4732                                 |
 144 |                                      |                                      |
 145 +--------------------------------------+--------------------------------------+
 146 | **Release designation**              | D Release                            |
 147 |                                      |                                      |
 148 +--------------------------------------+--------------------------------------+
 149 | **Release date**                     | 2021-09-06                           |
 150 |                                      |                                      |
 151 +--------------------------------------+--------------------------------------+
 152 | **Purpose of the delivery**          | D Release                            |
 153 |                                      |                                      |
 154 +--------------------------------------+--------------------------------------+
 155
 156 Cherry
 157 ^^^^^^
 158 +--------------------------------------+--------------------------------------+
 159 | **Project**                          | ODUHIGH                              |
 160 |                                      |                                      |
 161 +--------------------------------------+--------------------------------------+
 162 | **Repo/commit-ID**                   | o-du/l2/                             |
 163 |                                      | fc0bcf28e944ae7ba2423ad3c9a5c794df2dc|
 164 |                                      | 4ff                                  |
 165 |                                      |                                      |
 166 +--------------------------------------+--------------------------------------+
 167 | **Release designation**              | Cherry Release                       |
 168 |                                      |                                      |
 169 +--------------------------------------+--------------------------------------+
 170 | **Release date**                     | 2020-12-04                           |
 171 |                                      |                                      |
 172 +--------------------------------------+--------------------------------------+
 173 | **Purpose of the delivery**          | Cherry Release                       |
 174 |                                      |                                      |
 175 +--------------------------------------+--------------------------------------+
 176
 177 Bronze
 178 ^^^^^^
 179 +--------------------------------------+--------------------------------------+
 180 | **Project**                          | ODUHIGH                              |
 181 |                                      |                                      |
 182 +--------------------------------------+--------------------------------------+
 183 | **Repo/commit-ID**                   | o-du/l2/                             |
 184 |                                      | 27844f9c01c08472b86b1a75adaed0e450a88|
 185 |                                      | 907                                  |
 186 |                                      |                                      |
 187 +--------------------------------------+--------------------------------------+
 188 | **Release designation**              | Bronze Release                       |
 189 |                                      |                                      |
 190 +--------------------------------------+--------------------------------------+
 191 | **Release date**                     | 2020-06-17                           |
 192 |                                      |                                      |
 193 +--------------------------------------+--------------------------------------+
 194 | **Purpose of the delivery**          | Bronze Release                       |
 195 |                                      |                                      |
 196 +--------------------------------------+--------------------------------------+
 197
 198 Amber
 199 ^^^^^
 200 +--------------------------------------+--------------------------------------+
 201 | **Project**                          | ODUHIGH                              |
 202 |                                      |                                      |
 203 +--------------------------------------+--------------------------------------+
 204 | **Repo/commit-ID**                   | o-du/l2/                             |
 205 |                                      | d349ae65e1495488772f87e5cfa1ae71d9eab|
 206 |                                      | 075                                  |
 207 |                                      |                                      |
 208 +--------------------------------------+--------------------------------------+
 209 | **Release designation**              | Amber Release                        |
 210 |                                      |                                      |
 211 +--------------------------------------+--------------------------------------+
 212 | **Release date**                     | 2019-12-29                           |
 213 |                                      |                                      |
 214 +--------------------------------------+--------------------------------------+
 215 | **Purpose of the delivery**          | Amber Release                        |
 216 |                                      |                                      |
 217 +--------------------------------------+--------------------------------------+
 218
 219
 220
 221 Feature Additions
 222 ------------------
 223
 224 **JIRA BACK-LOG:**
 225
 226 D
 227 ^^^^^^^
 228
 229 +-----------------------------------------------+-----------------------------------------------+
 230 | **JIRA REFERENCE**                            | **SLOGAN**                                    |
 231 |                                               |                                               |
 232 +-----------------------------------------------+-----------------------------------------------+
 233 | https://jira.o-ran-sc.org/browse/ODUHIGH-264  | Support for Mu1                               |
 234 |                                               |                                               |
 235 +-----------------------------------------------+-----------------------------------------------+
 236 | https://jira.o-ran-sc.org/browse/ODUHIGH-265  | Support for 100 MHz                           |
 237 |                                               |                                               |
 238 +-----------------------------------------------+-----------------------------------------------+
 239 | https://jira.o-ran-sc.org/browse/ODUHIGH-266  | Support for TDD mode                          |
 240 |                                               |                                               |
 241 +-----------------------------------------------+-----------------------------------------------+
 242 | https://jira.o-ran-sc.org/browse/ODUHIGH-267  | Integration with O-DU Low in Radio mode       |
 243 |                                               |                                               |
 244 +-----------------------------------------------+-----------------------------------------------+
 245 | https://jira.o-ran-sc.org/browse/ODUHIGH-268  | Integration with O-CU                         |
 246 |                                               |                                               |
 247 +-----------------------------------------------+-----------------------------------------------+
 248 | https://jira.o-ran-sc.org/browse/ODUHIGH-269  | Support for E2E testing                       |
 249 |                                               |                                               |
 250 +-----------------------------------------------+-----------------------------------------------+
 251 | https://jira.o-ran-sc.org/browse/ODUHIGH-299  | Closed Loop Automation use-case               |
 252 |                                               |                                               |
 253 +-----------------------------------------------+-----------------------------------------------+
 254 | https://jira.o-ran-sc.org/browse/ODUHIGH-196  | Netconf session for O1 interface for CM       |
 255 |                                               |                                               |
 256 +-----------------------------------------------+-----------------------------------------------+
 257
 258 Cherry
 259 ^^^^^^^
 260
 261 +-----------------------------------------------+-----------------------------------------------+
 262 | **JIRA REFERENCE**                            | **SLOGAN**                                    |
 263 |                                               |                                               |
 264 +-----------------------------------------------+-----------------------------------------------+
 265 | https://jira.o-ran-sc.org/browse/ODUHIGH-10   | UE attach procedure with basic scheduling     |
 266 |                                               |                                               |
 267 +-----------------------------------------------+-----------------------------------------------+
 268 | https://jira.o-ran-sc.org/browse/ODUHIGH-188  | Support for all short PRACH formats           |
 269 |                                               |                                               |
 270 +-----------------------------------------------+-----------------------------------------------+
 271 | https://jira.o-ran-sc.org/browse/ODUHIGH-191  | Explore O1 interface                          |
 272 |                                               |                                               |
 273 +-----------------------------------------------+-----------------------------------------------+
 274 | https://jira.o-ran-sc.org/browse/ODUHIGH-189  | Integration with O-DU Low                     |
 275 |                                               |                                               |
 276 +-----------------------------------------------+-----------------------------------------------+
 277 | https://jira.o-ran-sc.org/browse/ODUHIGH-184  | UE UL Data path                               |
 278 |                                               |                                               |
 279 +-----------------------------------------------+-----------------------------------------------+
 280 | https://jira.o-ran-sc.org/browse/ODUHIGH-185  | UE DL Data path                               |
 281 |                                               |                                               |
 282 +-----------------------------------------------+-----------------------------------------------+
 283 | https://jira.o-ran-sc.org/browse/ODUHIGH-186  | Applying 64 QAM Modulation in DL              |
 284 |                                               |                                               |
 285 +-----------------------------------------------+-----------------------------------------------+
 286 | https://jira.o-ran-sc.org/browse/ODUHIGH-187  | Applying 16 QAM Modulation in UL              |
 287 |                                               |                                               |
 288 +-----------------------------------------------+-----------------------------------------------+
 289 | https://jira.o-ran-sc.org/browse/ODUHIGH-190  | Integration with VIAVI Software               |
 290 |                                               |                                               |
 291 +-----------------------------------------------+-----------------------------------------------+
 292 | https://jira.o-ran-sc.org/browse/ODUHIGH-214  | get-AlarmList implementation on O1 interface  |
 293 |                                               |                                               |
 294 +-----------------------------------------------+-----------------------------------------------+
 295 | https://jira.o-ran-sc.org/browse/ODUHIGH-196  | CM Support on O1 interface                    |
 296 |                                               |                                               |
 297 +-----------------------------------------------+-----------------------------------------------+
 298
 299 Previous Releases
 300 ^^^^^^^^^^^^^^^^^^
 301
 302
 303 +---------------------------------------------+-------------------------------------------------+
 304 | **JIRA REFERENCE**                          | **SLOGAN**                                      |
 305 |                                             |                                                 |
 306 +---------------------------------------------+-------------------------------------------------+
 307 | https://jira.o-ran-sc.org/browse/ODUHIGH-1  | F1-C enhancement                                |
 308 |                                             |                                                 |
 309 +---------------------------------------------+-------------------------------------------------+
 310 | https://jira.o-ran-sc.org/browse/ODUHIGH-5  | F1-U implementation                             |
 311 |                                             |                                                 |
 312 +---------------------------------------------+-------------------------------------------------+
 313 | https://jira.o-ran-sc.org/browse/ODUHIGH-11 | E2 implementation                               |
 314 |                                             |                                                 |
 315 +---------------------------------------------+-------------------------------------------------+
 316 | https://jira.o-ran-sc.org/browse/ODUHIGH-9  | Cell broadcast procedure                        |
 317 |                                             |                                                 |
 318 +---------------------------------------------+-------------------------------------------------+
 319 | https://jira.o-ran-sc.org/browse/ODUHIGH-10 | UE attach procedure till msg-4                  |
 320 |                                             |                                                 |
 321 +---------------------------------------------+-------------------------------------------------+
 322 | https://jira.o-ran-sc.org/browse/ODUHIGH-8  | FAPI interface implementation                   |
 323 |                                             |                                                 |
 324 +---------------------------------------------+-------------------------------------------------+
 325 | https://jira.o-ran-sc.org/browse/ODUHIGH-27 | RLC layer interface enhancements                |
 326 |                                             |                                                 |
 327 +---------------------------------------------+-------------------------------------------------+
 328
 329 Bug Corrections
 330 ----------------
 331
 332 **JIRA TICKETS:**
 333
 334 NA
 335
 336
 337 Deliverables
 338 -------------
 339
 340 Software Deliverables
 341 ^^^^^^^^^^^^^^^^^^^^^^
 342
 343 This release contains O-DU High code, along with test code in the form of CU stub, RIC stub and phy stub.
 344 Instructions to build and execute ODU, CU and RIC stub binaries are also present.
 345 All of the above can be found in the o-du/l2 repo.
 346
 347
 348
 349 Documentation Deliverables
 350 ^^^^^^^^^^^^^^^^^^^^^^^^^^^
 351
 352 This release contains
 353
 354 - README with instruction to build and execute binaries.
 355
 356 - overview.rst
 357
 358 - release-notes.rst
 359
 360 - installation-guide.rst
 361
 362 - user-guide.rst
 363
 364 - api-docs.rst
 365
 366 - developer-guide.rst
 367
 368
 369
 370 Known Limitations, Issues and Workarounds
 371 -----------------------------------------
 372
 373 System Limitations
 374 ^^^^^^^^^^^^^^^^^^
 375 - Current code contains support only for below configuration:
 376
 377    [TDD] [Mu1] [100MHz]
 378
 379    [FDD] [Mu0] [ 20MHz]
 380
 381    Freuency Range = FR 1
 382
 383    DL/UL Modulation = QPSK
 384
 385    single UE.
 386
 387 - This release implements a basic scheduler with fixed scheduling for single UE.
 388
 389 - Cell broadcast is for SSB and SIB1 only.
 390
 391 - FAPI files not in-line with SCF FAPI 1.0.5.
 392   O-DU High currently compatible with FAPI files provided by Intel.
 393
 394 - Implementation of F1 reset is limited to intializing UE contexts.
 395
 396 - E2 interface is limited to Traffic Steering Usecase.
 397
 398 - Forming of RIC event trigger definition, RIC indication header and RIC indication message is unclear in the E2AP draft spec versions. Therefore, implementation does not contain accurate values. Contents of RIC indication message are mocked and triggered just once.
 399
 400 - On the F1-U interface, UE, RB and tunnel configurations are static.
 401
 402 - System runs on preconfigured values due to absence of CM support on O1 interface.
 403
 404 - O-DU High has not been integrated with O-CU.(Using Radisys commercial CU as a test fixture)
 405
 406 - Netconf TLS connection is not supported
 407
 408 Known Issues
 409 ^^^^^^^^^^^^^
 410
 411 - PDSCH DMRS must not be interleaved with PDSCH allocations.
 412
 413 - PUSCH DMRS must not be interleaved with PUSCH allocations.
 414
 415 - Frequency domain allocation in DCI is a bit map where:
 416
 417      As per spec : the most significant bit corresponds to the group of lowest frequency.
 418
 419      As per L1 : the least significant bit corresponds to the lowest frequency group.
 420
 421 - Only Resource allocation type 1 (i.e RB allocation using Start RB and Number of RBs) is supported for PDSCH.
 422
 423 - Only mapping type = 1 (i.e. Type A) supported for PDSCH.
 424
 425 - L1 unable to process SIB1 with hardware accelerator enabled.
 426
 427 **JIRA TICKETS:**
 428
 429 NA
 430
 431
 432 Workarounds
 433 ^^^^^^^^^^^
 434
 435 O-DU High uses FAPI interface files provided by Intel and therefore, not completely in-line with SCF FAPI 1.0.5.
 436
 437
 438
 439 References
 440 ----------
 441 1. ORAN-WG8.AAD.0-v02.05.00
 442
 443 2. ORAN WG3.E2AP v01.00
 444
 445 3. ORAN WG3.E2SM v01.00
 446
 447 4. 3GPP 38.473-f60 v15.3
 448
 449 5. 3GPP TS 38.211 v15.3
 450
 451 6. 3GPP TS 38.212 v15.3
 452
 453 7. 3GPP TS 38.213 v15.3
 454
 455 8. 3GPP TS 38.214 v15.3
 456
 457 9. 3GPP TS 38.321 v15.3
 458
 459 10. 3GPP TS 38.331 v15.3
 460
 461 11. 5G PHY FAPI Specification v1.0.5
 462