1 .. Copyright (c) 2019-2022 Intel
3 .. Licensed under the Apache License, Version 2.0 (the "License");
4 .. you may not use this file except in compliance with the License.
5 .. You may obtain a copy of the License at
7 .. http://www.apache.org/licenses/LICENSE-2.0
9 .. Unless required by applicable law or agreed to in writing, software
10 .. distributed under the License is distributed on an "AS IS" BASIS,
11 .. WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12 .. See the License for the specific language governing permissions and
13 .. limitations under the License.
19 Transport Layer and O-RAN Fronthaul Protocol Implementation
20 ===========================================================
26 This chapter describes how the transport layer and O-RAN Fronthaul
27 protocol are implemented.
34 Figure 8 presents an overview of the O-RAN Fronthaul process.
36 .. image:: images/ORAN-Fronthaul-Process.jpg
38 :alt: Figure 8. O-RAN Fronthaul Process
40 Figure 8. O-RAN Fronthaul Process
42 The O-RAN library provides support for transporting In-band and
43 Quadrature (IQ) samples between the O-DU and O-RU within the O-RAN
44 architecture based on functional split 7.2x. The library defines the
45 O-RAN packet formats to be used to transport radio samples within Front
46 Haul according to the O-RAN Fronthaul specification. It provides
47 functionality for generating O-RAN packets, appending IQ samples in the
48 packet payload, and extracting IQ samples from O-RAN packets.
50 Note: The E Miantenance release version of the library supports U-plane and C-plane only. It is ready to be used in the PTP synchronized environment.
52 Note: Regarding the clock model and synchronization topology, configurations
53 C1 and C3 of the connection between O-DU and O-RU are the only
54 configurations supported in this release of the O-RAN implementation.
56 Note: Quality of PTP synchronization with respect to S-plane of O-RAN
57 Fronthaul requirements as defined for O-RU is out of the scope of this
58 document. PTP primary and PTP secondary configuration are expected to satisfy
59 only the O-DU side of requirements and provide the “best-effort” PTP primary for
60 O-RU. This may or may not be sufficient for achieving the end to end
61 system requirements of S-plane. Specialized dedicated NIC card with
62 additional HW functionality might be required to achieve PTP primary
63 functionality to satisfy O-RU precision requirements for RAN deployments
66 .. image:: images/Configuration-C1.jpg
68 :alt: Figure 9. Configuration C1
70 Figure 9. Configuration C1
73 .. image:: images/Configuration-C3.jpg
75 :alt: Figure 10. Configuration C3
77 Figure 10. Configuration C3
82 The O-RAN Fronthaul specification defines a list of mandatory
83 functionality. Not all features defined as Mandatory for O-DU are
84 currently supported to fully extended. The following tables contain
85 information on what is available and the level of validation performed
88 Note. Cells with a red background are listed as mandatory in the
89 specification but not supported in this implementation of O-RAN.
91 Table 7. ORAN Mandatory and Optional Feature Support
93 +-----------------+-----------------+-----------+----------------+
94 | Category | Feature | O-DU | Support |
96 +=================+=================+===========+================+
97 | RU Category || Support for | Mandatory | Y |
98 | || CAT-A RU (up to| | |
101 | +-----------------+-----------+----------------+
102 | || Support for | | Y |
103 | || CAT-A RU (> 8 | | |
106 | +-----------------+-----------+----------------+
107 | || Support for | Mandatory | Y |
109 | || (precoding in | | |
111 +-----------------+-----------------+-----------+----------------+
112 | Beamforming || Beam Index | Mandatory | Y |
114 | +-----------------+-----------+----------------+
115 | || Real-time BF | Mandatory | Y |
117 | +-----------------+-----------+----------------+
118 | || Real-Time | | N |
119 | || Beamforming | | |
120 | || Attributes | | |
121 | +-----------------+-----------+----------------+
122 | | UE Channel Info | | N |
123 +-----------------+-----------------+-----------+----------------+
124 | Bandwidth || Programmable | Mandatory | Y |
125 | Saving || staticbitwidth | | |
126 | || Fixed Point IQ | | |
127 | +-----------------+-----------+----------------+
128 | || Real-time | | Y |
129 | || variable-bit | | |
131 | +-----------------+-----------+----------------+
132 | | Compressed IQ | | Y |
133 | +-----------------+-----------+----------------+
134 | || Block floating | | Y |
136 | || compression | | |
137 | +-----------------+-----------+----------------+
138 | || Block scaling | | N |
139 | || compression | | |
140 | +-----------------+-----------+----------------+
142 | || compression | | |
143 | +-----------------+-----------+----------------+
144 | || modulation | | Y |
145 | || compression | | |
146 | +-----------------+-----------+----------------+
147 | || beamspace | | Y |
148 | || compression | | |
149 | +-----------------+-----------+----------------+
150 | || Variable Bit | | Y |
152 | || Channel (per | | |
153 | || data section) | | |
154 | +-----------------+-----------+----------------+
156 | || configuration | | |
157 | || of U-Plane IQ | | |
158 | || format and | | |
159 | || compression | | |
161 | +-----------------+-----------+----------------+
162 | || Use of symInc | | N |
163 | || flag to allow | | |
165 | || symbols in a | | |
166 | || C-Plane section| | |
167 +-----------------+-----------------+-----------+----------------+
168 | Energy Saving || Transmission | | N |
170 +-----------------+-----------------+-----------+----------------+
171 | O-DU - RU || Pre-configured | Mandatory | Y |
172 | Timing || Transport Delay| | |
174 | +-----------------+-----------+----------------+
175 | || Measured | | N |
177 | || Method (eCPRI | | |
179 +-----------------+-----------------+-----------+----------------+
180 | Synchronization | G.8275.1 | Mandatory | Y (C3 only)|
182 | +-----------------+-----------+----------------+
184 | +-----------------+-----------+----------------+
185 | | GNSS based sync | | N |
186 | +-----------------+-----------+----------------+
188 +-----------------+-----------------+-----------+----------------+
189 | Transport | L2 : Ethernet | Mandatory | Y |
191 | +-----------------+-----------+----------------+
192 | || L3 : IPv4, IPv6| | N |
193 | || (CUS Plane) | | |
194 | +-----------------+-----------+----------------+
195 | || QoS over | Mandatory | Y |
197 | +-----------------+-----------+----------------+
198 | || Prioritization | | N |
199 | || of different | | |
200 | || U-plane traffic| | |
202 | +-----------------+-----------+----------------+
203 | || Support of | | N |
204 | || Jumbo Ethernet | | |
206 | +-----------------+-----------+----------------+
207 | || eCPRI | Mandatory | Y |
208 | +-----------------+-----------+----------------+
209 | || support of | | N |
211 | || concatenation | | |
212 | +-----------------+-----------+----------------+
213 | | IEEE 1914.3 | | N |
214 | +-----------------+-----------+----------------+
215 | || Application | Mandatory | Y |
216 | || fragmentation | | |
217 | +-----------------+-----------+----------------+
218 | || Transport | | N |
219 | || fragmentation | | |
220 +-----------------+-----------------+-----------+----------------+
221 | Other || LAA LBT O-DU | | N |
222 | || Congestion | | |
223 | || Window mgmt | | |
224 | +-----------------+-----------+----------------+
225 | || LAA LBT RU | | N |
226 | || Congestion | | |
227 | || Window mgm | | |
228 +-----------------+-----------------+-----------+----------------+
230 Details on the subset of O-RAN functionality implemented are shown in
233 Level of Validation Specified as:
236 - C: Completed code implementation for O-RAN Library
238 - I: Integrated into Intel FlexRAN PHY
240 - T: Tested end to end with O-RU
242 Table 8. Levels of support
244 +------------+------------+------------+------------+-----+-----+-----+
245 | Category | Item | Status | C | I | T |
246 +============+============+============+============+=====+=====+=====+
247 | General || Radio | NR | N/A | N/A | N/A |
248 | || access | | | | |
249 | || technology | | | | |
250 | || (LTE / NR) | | | | |
251 | +------------+------------+------------+-----+-----+-----+
252 | || Nominal || 15 | Y | Y | N |
253 | || sub-carrier || /30/120KHz| | | |
254 | || spacing | | | | |
255 | +------------+------------+------------+-----+-----+-----+
256 | | FFT size || 512/1024 | Y | Y | N |
257 | | || /2048/4096| | | |
258 | +------------+------------+------------+-----+-----+-----+
259 | || Channel || 5/10 | Y | Y | N |
260 | || bandwidth || /20/100Mhz| | | |
261 | +------------+------------+------------+-----+-----+-----+
262 | || Number of | 12 | Y | Y | N |
264 | || (Component | | | | |
265 | || Carriers) | | | | |
267 | +------------+------------+------------+-----+-----+-----+
268 | || RU | A | Y | Y | N |
269 | || category | | | | |
270 | +------------+------------+------------+-----+-----+-----+
271 | | TDD Config || Supported | Y | Y | N |
272 | | || Flexible | | | |
273 | +------------+------------+------------+-----+-----+-----+
274 | || FDD | Supported | Y | Y | N |
275 | || Support | | | | |
276 | +------------+------------+------------+-----+-----+-----+
277 | || Tx/Rx | Supported | Y | Y | N |
278 | || switching | | | | |
279 | || based on | | | | |
281 | || Direction' | | | | |
282 | || field of | | | | |
283 | || C-plane | | | | |
284 | || message | | | | |
285 | +------------+------------+------------+-----+-----+-----+
286 | || IP version | N/A | N/A | N/A | N/A |
288 | || Management | | | | |
289 | || traffic at | | | | |
290 | || fronthaul | | | | |
291 | || network | | | | |
293 +------------+-------------------------+------------+-----+-----+-----+
294 | PRACH || One Type 3 | Supported | Y | Y | N |
295 | || message | | | | |
296 | || for all | | | | |
297 | || repeated | | | | |
299 | || preambles | | | | |
300 | +-------------------------+------------+-----+-----+-----+
301 | || Type 3 | 1 | Y | Y | N |
302 | || message | | | | |
304 | || repeated | | | | |
306 | || preambles | | | | |
307 | +-------------------------+------------+-----+-----+-----+
308 | || timeOffset | Supported | Y | Y | N |
309 | || including | | | | |
310 | || cpLength | | | | |
311 | +-------------------------+------------+-----+-----+-----+
312 | | Supported | Supported | Y | Y | N |
313 | +-------------------------+------------+-----+-----+-----+
314 | || PRACH | Supported | Y | Y | N |
315 | || preamble | | | | |
316 | || format | | | | |
318 | || number | | | | |
319 | || (number of | | | | |
320 | || occasions) | | | | |
322 +------------+-------------------------+------------+-----+-----+-----+
323 || Delay || Network | Supported | Y | Y | N |
324 || management|| delay | | | | |
325 | || determination | | | | |
326 | +-------------------------+------------+-----+-----+-----+
327 | || lls-CU | Supported | Y | Y | N |
328 | || timing | | | | |
329 | || advance | | | | |
331 | +-------------------------+------------+-----+-----+-----+
332 | || Non-delay || Not | N | N | N |
333 | || managed || supported | | | |
334 | || U-plane | | | | |
335 | || traffic | | | | |
337 +------------+-------------------------+------------+-----+-----+-----+
338 || C/U-plane || Transport | Ethernet | Y | Y | N |
339 || Transport || encapsulation | | | | |
340 | || (Ethernet IP) | | | | |
341 | +-------------------------+------------+-----+-----+-----+
342 | || Jumbo | Supported | Y | Y | N |
343 | || frames | | | | |
344 | +-------------------------+------------+-----+-----+-----+
345 | || Transport | eCPRI | Y | Y | N |
346 | || header | | | | |
347 | || (eCPRI RoE) | | | | |
348 | +-------------------------+------------+-----+-----+-----+
349 | || IP version | N/A | N/A | N/A | N/A |
351 | || Transport | | | | |
352 | || header is | | | | |
353 | || IP/UDP | | | | |
354 | +-------------------------+------------+-----+-----+-----+
355 | || eCPRI || Not | N | N | N |
356 | || Concatenation || supported | | | |
358 | || Transport | | | | |
359 | || header is | | | | |
361 | +-------------------------+------------+-----+-----+-----+
362 | || eAxC ID | 4 \* | Y | Y | N |
363 | || CU_Port_ID | | | | |
364 | || bitwidth | | | | |
365 | +-------------------------+------------+-----+-----+-----+
366 | || eAxC ID | 4 \* | Y | Y | N |
367 | || BandSector_ID | | | | |
368 | || bitwidth | | | | |
369 | +-------------------------+------------+-----+-----+-----+
370 | || eAxC ID | 4 \* | Y | Y | N |
372 | || bitwidth | | | | |
373 | +-------------------------+------------+-----+-----+-----+
374 | || eAxC ID | 4 \* | Y | Y | N |
375 | || RU_Port_ID | | | | |
376 | || bitwidth | | | | |
377 | +-------------------------+------------+-----+-----+-----+
378 | | Fragmentation | Supported | Y | Y | N |
379 | +-------------------------+------------+-----+-----+-----+
380 | || Transport | N/A | N | N | N |
381 | || prioritization | | | | |
382 | || within | | | | |
383 | || U-plane | | | | |
384 | +-------------------------+------------+-----+-----+-----+
385 | || Separation | Supported | Y | Y | N |
387 | || C/U-plane | | | | |
389 | || M-plane | | | | |
390 | +-------------------------+------------+-----+-----+-----+
391 | || Separation || VLAN ID\ | Y | Y | N |
392 | || of C-plane || and/or | | | |
393 | || and || eCpri | | | |
394 | || U-plane || Messagge | | | |
396 | +-------------------------+------------+-----+-----+-----+
397 | || Max Number | 16 | Y | Y | N |
398 | || of VLAN | | | | |
400 | || physical | | | | |
403 +------------+-------------------------+------------+-----+-----+-----+
404 || Reception | Rx_on_time | Supported | Y | Y | N |
405 || Window | | | | | |
406 || Monitoring| | | | | |
407 || (Counters)| | | | | |
408 | +-------------------------+------------+-----+-----+-----+
409 | | Rx_early | Supported | N | N | N |
410 | +-------------------------+------------+-----+-----+-----+
411 | | Rx_late | Supported | N | N | N |
412 | +-------------------------+------------+-----+-----+-----+
413 | | Rx_corrupt | Supported | N | N | N |
414 | +-------------------------+------------+-----+-----+-----+
415 | || Rx_pkt_dupl | Supported | N | N | N |
416 | +-------------------------+------------+-----+-----+-----+
417 | || Total_msgs_rcvd | Supported | Y | N | N |
419 +------------+-------------------------+------------+-----+-----+-----+
420 || || RU || Index and | Y | Y | N |
421 || Beam-\ || beamforming || weights | | | |
422 || forming || type || | | | |
423 | +-------------------------+------------+-----+-----+-----+
424 | || Beamforming | C-plane | Y | N | N |
425 | || control | | | | |
426 | || method | | | | |
427 | +-------------------------+------------+-----+-----+-----+
428 | || Number of || No res- | Y | Y | N |
429 | || beams || strictions| | | |
431 +------------+-------------------------+------------+-----+-----+-----+
432 || IQ || U-plane | Supported | Y | Y | Y |
433 || compre || data | | | | |
434 | ssion || compression | | | | |
435 | || method | | | | |
436 | +-------------------------+------------+-----+-----+-----+
437 | || U-plane || BFP: | Y | Y | Y |
438 | || data IQ || 8,9,12,14 | | | |
439 | || bitwidth || bits | | | |
440 | || (Before / || | | | |
441 | || After || | | | |
442 | || compression) || | | | |
443 | +-------------------------+------------+-----+-----+-----+
444 | || Static | Supported | N | N | N |
445 | || configuration | | | | |
446 | || of U-plane | | | | |
447 | || IQ format | | | | |
449 | || compression | | | | |
450 | || header | | | | |
452 +------------+-------------------------+------------+-----+-----+-----+
453 || eCPRI || ecpriVersion | 001b | Y | Y | Y |
454 || Header || | | | | |
455 || Format || | | | | |
456 | +-------------------------+------------+-----+-----+-----+
457 | || ecpriReserved | Supported | Y | Y | Y |
458 | +-------------------------+------------+-----+-----+-----+
459 | || ecpriCon || Not | N | N | N |
460 | | catenation || supported | | | |
461 | +------------+------------+------------+-----+-----+-----+
462 | || ecpri\ | U-plane | Supported | Y | Y | Y |
463 | || Message | | | | | |
464 | | +------------+------------+-----+-----+-----+
465 | | | C-plane | Supported | Y | Y | Y |
466 | | +------------+------------+-----+-----+-----+
467 | | || Delay | Supported | Y | Y | Y |
468 | | || measure | | | | |
470 | +------------+------------+------------+-----+-----+-----+
471 | || ecpri\ | Supported | Y | Y | Y |
472 | || Payload | | | | |
473 | || (payload | | | | |
474 | || size in | | | | |
475 | || bytes) | | | | |
476 | +-------------------------+------------+-----+-----+-----+
477 | || ecpriRtcid | Supported | Y | Y | Y |
478 | || /ecpriPcid | | | | |
479 | +-------------------------+------------+-----+-----+-----+
480 | || ecpri | Supported | Y | Y | Y |
481 | || Seqid: | | | | |
482 | || Sequence | | | | |
484 | +-------------------------+------------+-----+-----+-----+
485 | || ecpri\ | Supported | Y | Y | Y |
486 | || Seqid: | | | | |
488 | +-------------------------+------------+-----+-----+-----+
489 | || ecpri\ || Not | N | N | N |
490 | || Seqid: || supported | | | |
492 | || sequence | | | | |
495 +------------+------------+------------+------------+-----+-----+-----+
496 || C-plane || Section || Not | N | N | N |
497 || Type || Type 0 || supported | | | |
498 | +-------------------------+------------+-----+-----+-----+
499 | || Section | Supported | Y | Y | Y |
500 | || Type 1 | | | | |
501 | +-------------------------+------------+-----+-----+-----+
502 | || Section | Supported | Y | Y | Y |
503 | || Type 3 | | | | |
504 | +-------------------------+------------+-----+-----+-----+
505 | || Section || Not | N | N | N |
506 | || Type 5 || supported | | | |
507 | +-------------------------+------------+-----+-----+-----+
508 | || Section || Not | N | N | N |
509 | || Type 6 || supported | | | |
510 | +-------------------------+------------+-----+-----+-----+
511 | || Section || Not | N | N | N |
512 | || Type 7 || supported | | | |
514 +------------+------------+------------+------------+-----+-----+-----+
515 || C-plane || *Coding*\ || data\ | Supported | Y | Y | N |
516 || Packet || *of Infor*|| Direction | | | | |
517 || Format | *mation* || (data | | | | |
518 | || *Elements*|| direction | | | | |
519 | || *Appli* || (gNB | | | | |
520 | | *cation* || Tx/Rx)) | | | | |
521 | || *Layer,*\ || | | | | |
522 | || *Common* || | | | | |
523 | | +------------+------------+-----+-----+-----+
524 | | || payload || 001b | Y | Y | N |
525 | | | Version || | | | |
526 | | || (payload || | | | |
527 | | || version) || | | | |
528 | | +------------+------------+-----+-----+-----+
529 | | || filter | Supported | Y | Y | N |
530 | | | Index | | | | |
531 | | || (filter | | | | |
532 | | || index) | | | | |
533 | | +------------+------------+-----+-----+-----+
534 | | || frameId | Supported | Y | Y | N |
535 | | || (frame | | | | |
536 | | || iden | | | | |
537 | | | tifier) | | | | |
538 | | +------------+------------+-----+-----+-----+
539 | | || subframeId| Supported | Y | Y | N |
540 | | || (subframe | | | | |
541 | | || iden | | | | |
542 | | | tifier) | | | | |
543 | | +------------+------------+-----+-----+-----+
544 | | || slotId | Supported | Y | Y | N |
545 | | || (slot | | | | |
546 | | || iden | | | | |
547 | | | tifier) | | | | |
548 | | +------------+------------+-----+-----+-----+
549 | | || start\ | Supported | Y | Y | N |
550 | | || Symbolid | | | | |
551 | | || (start | | | | |
552 | | || symbol | | | | |
553 | | || iden | | | | |
554 | | | tifier) | | | | |
555 | | +------------+------------+-----+-----+-----+
556 | | || number || up to the | Y | Y | N |
557 | | || Ofsections|| maximum | | | |
558 | | || (number of|| number of | | | |
559 | | || sections) || PRBs | | | |
560 | | +------------+------------+-----+-----+-----+
561 | | || section\ || 1 and 3 | Y | Y | N |
562 | | || Type || | | | |
563 | | || (section || | | | |
564 | | || type) || | | | |
565 | | +------------+------------+-----+-----+-----+
566 | | || udCompHdr | Supported | Y | Y | N |
567 | | || (user data| | | | |
569 | | | pression | | | | |
570 | | || header) | | | | |
571 | | +------------+------------+-----+-----+-----+
572 | | || number\ || Not | N | N | N |
573 | | || OfUEs || supported | | | |
574 | | || (number Of| | | | |
575 | | || UEs) | | | | |
576 | | +------------+------------+-----+-----+-----+
577 | | || timeOffset| Supported | Y | Y | N |
578 | | || (time | | | | |
579 | | || offset) | | | | |
580 | | +------------+------------+-----+-----+-----+
581 | | || frame\ | mu=0,1,3 | Y | Y | N |
582 | | || Structure | | | | |
583 | | || (frame | | | | |
584 | | || structure)| | | | |
585 | | +------------+------------+-----+-----+-----+
586 | | || cpLength | Supported | Y | Y | N |
587 | | || (cyclic | | | | |
588 | | || prefix | | | | |
589 | | || length) | | | | |
590 | +------------+------------+------------+-----+-----+-----+
591 | || *Coding* || sectionId | Supported | Y | Y | N |
592 | || *of Infor*|| (section | | | | |
593 | | *mation* || iden | | | | |
594 | || *Elements*| tifier) | | | | |
595 | || *Ap* | | | | | |
596 | | *plication*| | | | | |
597 | || *Layer,* | | | | | |
598 | || *Sections*| | | | | |
599 | | +------------+------------+-----+-----+-----+
600 | | || rb | 0 | Y | Y | N |
601 | | || (resource | | | | |
602 | | || block | | | | |
603 | | || indicator)| | | | |
604 | | +------------+------------+-----+-----+-----+
605 | | || symInc | 0 or 1 | Y | Y | N |
606 | | || (symbol | | | | |
607 | | || number | | | | |
608 | | || increment | | | | |
609 | | || command) | | | | |
610 | | +------------+------------+-----+-----+-----+
611 | | || startPrbc | Supported | Y | Y | N |
612 | | || (starting | | | | |
613 | | || PRB of | | | | |
614 | | || control | | | | |
615 | | || section) | | | | |
616 | | +------------+------------+-----+-----+-----+
617 | | || reMask | Supported | Y | Y | N |
618 | | || (resource | | | | |
619 | | || element | | | | |
620 | | || mask) | | | | |
621 | | +------------+------------+-----+-----+-----+
622 | | || numPrbc | Supported | Y | Y | N |
623 | | || (number of| | | | |
624 | | || contiguous| | | | |
625 | | || PRBs per | | | | |
626 | | || control | | | | |
627 | | || section) | | | | |
628 | | +------------+------------+-----+-----+-----+
629 | | || numSymbol | Supported | Y | Y | N |
630 | | || (number of| | | | |
631 | | || symbols) | | | | |
632 | | +------------+------------+-----+-----+-----+
633 | | || ef | Supported | Y | Y | N |
634 | | || (extension| | | | |
635 | | || flag) | | | | |
636 | | +------------+------------+-----+-----+-----+
637 | | || beamId | Support | Y | Y | N |
638 | | || (beam | | | | |
639 | | || iden | | | | |
640 | | | tifier) | | | | |
641 | | +------------+------------+-----+-----+-----+
642 | | || ueId (UE || Not | N | N | N |
643 | | || iden || supported | | | |
644 | | | tifier) | | | | |
645 | | +------------+------------+-----+-----+-----+
646 | | || freqOffset| Supported | Y | Y | N |
647 | | || (frequency| | | | |
648 | | || offset) | | | | |
649 | | +------------+------------+-----+-----+-----+
650 | | || regulari || Not | N | N | N |
651 | | | zation\ || supported | | | |
652 | | || Factor || | | | |
653 | | || (regulari | | | | |
654 | | | zation | | | | |
655 | | || Factor) | | | | |
656 | | +------------+------------+-----+-----+-----+
657 | | || ciIsample,|| Not | N | N | N |
658 | | || ciQsample || supported | | | |
659 | | || (channel || | | | |
660 | | || infor | | | | |
661 | | | mation | | | | |
662 | | || I and Q | | | | |
663 | | || values) | | | | |
664 | | +------------+------------+-----+-----+-----+
665 | | || laaMsgType|| Not | N | N | N |
666 | | || (LAA || supported | | | |
667 | | || message || | | | |
668 | | || type) || | | | |
669 | | +------------+------------+-----+-----+-----+
670 | | || laaMsgLen || Not | N | N | N |
671 | | || (LAA || supported | | | |
672 | | || message | | | | |
673 | | || length) | | | | |
674 | | +------------+------------+-----+-----+-----+
675 | | | lbtHandle || Not | N | N | N |
676 | | | || supported | | | |
677 | | +------------+------------+-----+-----+-----+
678 | | || lbtDefer || Not | N | N | N |
679 | | || Factor || supported | | | |
680 | | || (listen || | | | |
681 | | || before || | | | |
682 | | || talk || | | | |
683 | | || defer || | | | |
684 | | || factor) || | | | |
685 | | +------------+------------+-----+-----+-----+
686 | | || lbtBack || Not | N | N | N |
687 | | || offCounter|| supported | | | |
688 | | || (listen || | | | |
689 | | || before || | | | |
690 | | || talk || | | | |
691 | | || backoff || | | | |
692 | | || counter) || | | | |
693 | | +------------+------------+-----+-----+-----+
694 | | || lbtOffset || Not | N | N | N |
695 | | || (listen- || supported | | | |
696 | | || before | | | | |
697 | | || talk || | | | |
698 | | || offset) | | | | |
699 | | +------------+------------+-----+-----+-----+
700 | | || MCOT || Not | N | N | N |
701 | | || (maximum || supported | | | |
702 | | || channel | | | | |
703 | | || occupancy | | | | |
704 | | || time) | | | | |
705 | | +------------+------------+-----+-----+-----+
706 | | || lbtMode || Not | N | N | N |
707 | | || (LBT Mode)|| supported | | | |
708 | | +------------+------------+-----+-----+-----+
709 | | || lbt || Not | N | N | N |
710 | | | PdschRes || supported | | | |
711 | | || (LBT PDSCH|| | | | |
712 | | || Result) | | | | |
713 | | +------------+------------+-----+-----+-----+
714 | | || sfStatus || Not | N | N | N |
715 | | || (subframe || supported | | | |
716 | | || status) || | | | |
717 | | +------------+------------+-----+-----+-----+
718 | | || lbtDrsRes || Not | N | N | N |
719 | | || (LBT DRS || supported | | | |
720 | | || Result) | | | | |
721 | | +------------+------------+-----+-----+-----+
722 | | || initial || Not | N | N | N |
723 | | | PartialSF || supported | | | |
724 | | || (Initial | | | | |
725 | | | partial | | | | |
727 | | +------------+------------+-----+-----+-----+
728 | | || lbtBufErr || Not | N | N | N |
729 | | || (LBT || supported | | | |
730 | | | Buffer | | | | |
731 | | || Error) | | | | |
732 | | +------------+------------+-----+-----+-----+
733 | | || sfnSf || Not | N | N | N |
734 | | || (SFN/SF || supported | | | |
736 | | +------------+------------+-----+-----+-----+
737 | | || lbt || Not | N | N | N |
738 | | || CWConfig_H|| supported | | | |
739 | | || (HARQ | | | | |
740 | | || Parameters| | | | |
742 | | || Congestion| | | | |
743 | | || Window | | | | |
744 | | || mana | | | | |
745 | | | gement) | | | | |
746 | | +------------+------------+-----+-----+-----+
747 | | || lbt || Not | N | N | N |
748 | | || CWConfig_T|| supported | | | |
750 | | | Parameters | | | | |
752 | | || Congestion| | | | |
753 | | || Window | | | | |
754 | | || mana | | | | |
755 | | | gement) | | | | |
756 | | +------------+------------+-----+-----+-----+
757 | | || lbtTr || Not | N | N | N |
758 | | | afficClass || supported | | | |
759 | | || (Traffic | | | | |
760 | | || class | | | | |
761 | | || priority | | | | |
763 | | || Congestion| | | | |
764 | | || Window | | | | |
765 | | || mana | | | | |
766 | | | gement) | | | | |
767 | | +------------+------------+-----+-----+-----+
768 | | || lbtCWR_Rst|| Not | N | N | N |
769 | | || (Noti || supported | | | |
770 | | | cation | | | | |
771 | | || about | | | | |
772 | | || packet | | | | |
773 | | || reception | | | | |
774 | | || successful| | | | |
775 | | || or not) | | | | |
776 | | +------------+------------+-----+-----+-----+
777 | | || reserved | 0 | N | N | N |
778 | | || (reserved | | | | |
779 | | || for future| | | | |
780 | | || use) | | | | |
781 | | +------------+------------+-----+-----+-----+
782 | | || *Section* | | | | |
783 | | || *Exten* | | | | |
784 | | | *sion* | | | | |
785 | | || *Commands*| | | | |
786 | | +------------+------------+-----+-----+-----+
787 | | || extType | Supported | Y | Y | N |
788 | | || (extension| | | | |
789 | | || type) | | | | |
790 | | +------------+------------+-----+-----+-----+
791 | | || ef | Supported | Y | Y | N |
792 | | | (extension | | | | |
793 | | || flag) | | | | |
794 | | +------------+------------+-----+-----+-----+
795 | | || extLen | Supported | Y | Y | N |
796 | | || (extension| | | | |
797 | | || length) | | | | |
798 | +------------+------------+------------+-----+-----+-----+
799 | || Coding of | | | | | |
800 | || Infor | | | | | |
801 | | mation | | | | | |
802 | || Elements –| | | | | |
803 | || Appli | | | | | |
804 | | cation | | | | | |
805 | || Layer, | | | | | |
806 | || Section | | | | | |
807 | || Exten | | | | | |
808 | | sions | | | | | |
809 | +------------+------------+------------+-----+-----+-----+
811 | || *Ext*\ | bfw | Supported | Y | Y | N |
812 | || *Type=1:* | CompHdr | | | | |
814 | || *Beam* || \(bea | | | | |
816 | || *forming* | forming | | | | |
818 | || *Weights* || weight | | | | |
819 | || *Exten* || compre | | | | |
820 | | *sion* || ssion | | | | |
821 | || *Type* | header) | | | | |
822 | || +------------+------------+-----+-----+-----+
824 | || || bf | Supported | Y | Y | N |
825 | || | wCompParam | | | | |
826 | || || (beam | | | | |
827 | || | forming | | | | |
828 | || || weight | | | | |
829 | || || compre | | | | |
830 | || | ssion | | | | |
831 | || || parameter)| | | | |
832 | || +------------+------------+-----+-----+-----+
833 | || || bfwl | Supported | Y | Y | N |
834 | || || (beam | | | | |
835 | || | forming | | | | |
836 | || || weight | | | | |
837 | || || in-phase | | | | |
838 | || || value) | | | | |
839 | || +------------+------------+-----+-----+-----+
840 | || || bfwQ | Supported | Y | Y | N |
841 | || || (beam | | | | |
842 | || | forming | | | | |
843 | || || weight | | | | |
844 | || || quadrature| | | | |
845 | || || value) | | | | |
846 | +------------+------------+------------+-----+-----+-----+
847 | || || bfaCompHdr| Supported | Y | N | N |
848 | || *ExtType*\|| | | | | |
849 | || *=2:* || (beam | | | | |
850 | || *Beam* | forming | | | | |
851 | | *forming* || attributes| | | | |
852 | || *Attribu* || compre | | | | |
853 | | *tes* | ssion | | | | |
854 | || *Exten* || header) | | | | |
855 | || *sion* | | | | | |
856 | || *Type* | | | | | |
857 | || +------------+------------+-----+-----+-----+
858 | || || bfAzPt | Supported | Y | N | N |
859 | || || (beam | | | | |
860 | || | forming | | | | |
861 | || || azimuth | | | | |
862 | || || pointing | | | | |
863 | || || parameter)| | | | |
864 | || +------------+------------+-----+-----+-----+
865 | || || bfZePt | Supported | Y | N | N |
866 | || || (beam | | | | |
867 | || | forming | | | | |
868 | || || zenith | | | | |
869 | || || pointing | | | | |
870 | || || parameter)| | | | |
871 | || +------------+------------+-----+-----+-----+
872 | || || bfAz3dd | Supported | Y | N | N |
873 | || || (beam | | | | |
874 | || | forming | | | | |
875 | || || azimuth | | | | |
876 | || || beamwidth | | | | |
877 | || || parameter)| | | | |
878 | || +------------+------------+-----+-----+-----+
879 | || || bfZe3dd | Supported | Y | N | N |
880 | || || (beam | | | | |
881 | || | forming | | | | |
882 | || || zenith | | | | |
883 | || || beamwidth | | | | |
884 | || || parameter)| | | | |
885 | || +------------+------------+-----+-----+-----+
886 | || || bfAzSl | Supported | Y | N | N |
887 | || || (beam | | | | |
888 | || | forming | | | | |
889 | || || azimuth | | | | |
890 | || || sidelobe | | | | |
891 | || || parameter)| | | | |
892 | || +------------+------------+-----+-----+-----+
893 | || || bfZeSl | Supported | Y | N | N |
894 | || || (beam | | | | |
895 | || | forming | | | | |
896 | || || zenith | | | | |
897 | || || sidelobe | | | | |
898 | || || parameter)| | | | |
899 | || +------------+------------+-----+-----+-----+
900 | || || zero- | Supported | Y | N | N |
901 | || | padding | | | | |
902 | +------------+------------+------------+-----+-----+-----+
903 | || || code\ | Supported | Y | N | N |
904 | || *ExtType* || bookIndex | | | | |
905 | || *=3:* || | | | | |
906 | || *DL* || (precoder | | | | |
907 | || *Preco* || codebook | | | | |
908 | | *ding* || | | | | |
909 | || *Exten* || used for | | | | |
910 | | *sion* || trans | | | | |
911 | || *Type* | mission | | | | |
913 | || +------------+------------+-----+-----+-----+
914 | || || layerID | Supported | Y | N | N |
915 | || || (Layer ID | | | | |
916 | || || for DL | | | | |
917 | || || trans | | | | |
918 | || | mission) | | | | |
919 | || +------------+------------+-----+-----+-----+
920 | || || txScheme | Supported | Y | N | N |
921 | || || (trans | | | | |
922 | || | mission | | | | |
923 | || || scheme) | | | | |
924 | || +------------+------------+-----+-----+-----+
925 | || || numLayers | Supported | Y | N | N |
926 | || || (number of| | | | |
927 | || || layers | | | | |
928 | || || used for | | | | |
930 | || || trans | | | | |
931 | || | mission) | | | | |
932 | || +------------+------------+-----+-----+-----+
933 | || || crsReMask | Supported | Y | N | N |
934 | || || (CRS | | | | |
935 | || || resource | | | | |
936 | || || element | | | | |
937 | || || mask) | | | | |
938 | || +------------+------------+-----+-----+-----+
939 | | || crs\ | Supported | Y | N | N |
940 | | || SyumINum | | | | |
941 | | || (CRS | | | | |
942 | | || symbol | | | | |
943 | | || number | | | | |
944 | | || indi | | | | |
945 | | | cation) | | | | |
946 | | +------------+------------+-----+-----+-----+
947 | | || crsShift | Supported | Y | N | N |
948 | | || (crsShift | | | | |
949 | | || used for | | | | |
951 | | || trans | | | | |
952 | | | mission) | | | | |
953 | | +------------+------------+-----+-----+-----+
954 | | || beamIdAP1 | Supported | Y | N | N |
955 | | || (beam id | | | | |
956 | | || to be used| | | | |
958 | | || antenna | | | | |
959 | | || port 1) | | | | |
960 | | +------------+------------+-----+-----+-----+
961 | | || beamIdAP2 | Supported | Y | N | N |
962 | | || (beam id | | | | |
963 | | || to be used| | | | |
965 | | || antenna | | | | |
966 | | || port 2) | | | | |
967 | | +------------+------------+-----+-----+-----+
968 | | || beamIdAP3 | Supported | Y | N | N |
969 | | || (beam id | | | | |
970 | | || to be used| | | | |
972 | | || antenna | | | | |
973 | | || port 3) | | | | |
975 | +------------+------------+------------+-----+-----+-----+
976 | | || csf || Supported | Y | Y | N |
977 | || *ExtType*\|| (cons || | | | |
978 | || *=4:* | tellation || | | | |
979 | || *Modula* || shift | | | | |
980 | | *tion* || flag) | | | | |
981 | || *Compre* || | | | | |
982 | | *ssion* || | | | | |
983 | || *Parame* || | | | | |
984 | | *ters* || | | | | |
985 | || *Exten* || | | | | |
986 | | *sion* | | | | | |
987 | || *Type* || | | | | |
988 | | +------------+------------+-----+-----+-----+
989 | | || mod || Supported | Y | Y | N |
990 | | || CompScaler|| | | | |
992 | | || modulation|| | | | |
993 | | || compre || | | | |
994 | | | ssion || | | | |
995 | | || scaler || | | | |
996 | | | value) || | | | |
997 | +------------+------------+------------+-----+-----+-----+
998 | || || mcScale\ || Supported | Y | N | N |
999 | || *ExtType*\|| ReMask || | | | |
1000 | || *=5:* || ( || | | | |
1001 | || *Modula* || modulation|| | | | |
1002 | | *tion* || compre || | | | |
1003 | || *Compre* | ssion || | | | |
1004 | | *ssion* || power || | | | |
1005 | || *Additio* || RE || | | | |
1006 | || *Parame* || mask) || | | | |
1007 | || *ters* | || | | | |
1008 | || *Exten* || | | | | |
1009 | | *sion* || | | | | |
1010 | || Type* | || | | | |
1011 | | +------------+------------+-----+-----+-----+
1012 | | || csf || Supported | Y | N | N |
1013 | | || (cons || | | | |
1014 | | | tellation || | | | |
1015 | | || shift || | | | |
1016 | | || flag) || | | | |
1017 | | +------------+------------+-----+-----+-----+
1018 | | || mcScale\ | Supported | Y | N | N |
1019 | | || Offset | | | | |
1020 | | || (scaling | | | | |
1021 | | || value for | | | | |
1022 | | || modulation| | | | |
1023 | | || compre | | | | |
1024 | | | ssion) | | | | |
1025 | +------------+------------+------------+-----+-----+-----+
1026 | || *E* || rbgSize | Supported | Y | N | N |
1027 | | *xtType=6:*|| (resource | | | | |
1028 | || *Non-con* || block | | | | |
1029 | | *tiguous* || group | | | | |
1030 | || *PRB* || size) | | | | |
1031 | || *alloca* | | | | | |
1032 | | *tion in* | | | | | |
1033 | || *time and*| | | | | |
1034 | || *frequen* | | | | | |
1035 | | *cy domain*| | | | | |
1036 | | +------------+------------+-----+-----+-----+
1037 | | || rbgMask | Supported | Y | N | N |
1038 | | || (resource | | | | |
1039 | | || block | | | | |
1040 | | || group bit | | | | |
1041 | | || mask) | | | | |
1042 | | +------------+------------+-----+-----+-----+
1043 | | || symbol\ | Supported | Y | N | N |
1044 | | || Mask | | | | |
1045 | | || (symbol | | | | |
1046 | | || bit mask) | | | | |
1047 | +------------+------------+------------+-----+-----+-----+
1048 | || *Ext* | beam | Supported | Y | N | N |
1049 | | *Type=10:* | GroupType | | | | |
1050 | || *Section* | | | | | |
1051 | || *des* | | | | | |
1052 | | *cription* | | | | | |
1053 | || *for gro* | | | | | |
1054 | | *up* | | | | | |
1055 | || *configu* | | | | | |
1056 | | *ration of*| | | | | |
1057 | || *multiple*| | | | | |
1058 | || *ports* | | | | | |
1060 | | +------------+------------+-----+-----+-----+
1061 | | | numPortc | Supported | Y | N | N |
1063 | +------------+------------+------------+-----+-----+-----+
1064 | || *Ext* || b | Supported | Y | Y | N |
1065 | | *Type=11:* | fwCompHdr | | | | |
1066 | || *Flexible*|| (beam | | | | |
1067 | || *Beam* | forming | | | | |
1068 | | *forming* || weight | | | | |
1069 | || *Weights* || compre | | | | |
1070 | || *Exten* | ssion | | | | |
1071 | | *sion* | | | | | |
1072 | || *Type* || header) | | | | |
1073 | | +------------+------------+-----+-----+-----+
1074 | | || bfw | Supported | Y | Y | N |
1075 | | || CompParam | | | | |
1076 | | || for PRB | | | | |
1077 | | || bundle x | | | | |
1078 | | || (beam | | | | |
1079 | | | forming | | | | |
1080 | | || weight | | | | |
1081 | | || compre | | | | |
1082 | | | ssion | | | | |
1083 | | || parameter)| | | | |
1084 | | +------------+------------+-----+-----+-----+
1085 | | || numBund | Supported | Y | Y | N |
1087 | | || (Number | | | | |
1089 | | || bundled | | | | |
1090 | | || PRBs per | | | | |
1091 | | || beam | | | | |
1092 | | | forming | | | | |
1093 | | || weights) | | | | |
1094 | | +------------+------------+-----+-----+-----+
1095 | | || bfwI | Supported | Y | Y | N |
1096 | | || (beam | | | | |
1097 | | | forming | | | | |
1098 | | || weight | | | | |
1099 | | || in-phase | | | | |
1100 | | || value) | | | | |
1101 | | +------------+------------+-----+-----+-----+
1102 | | || bfwQ | Supported | Y | Y | N |
1103 | | || (beam | | | | |
1104 | | | forming | | | | |
1105 | | || weight | | | | |
1106 | | || quadra | | | | |
1107 | | | ture | | | | |
1108 | | || value) | | | | |
1109 | | +------------+------------+-----+-----+-----+
1110 | | || disable\ | Supported | Y | Y | N |
1111 | | || BFWs | | | | |
1112 | | || (disable | | | | |
1113 | | || beam | | | | |
1114 | | | forming | | | | |
1115 | | || weights) | | | | |
1116 | | +------------+------------+-----+-----+-----+
1117 | | || RAD | Supported | Y | Y | N |
1118 | | || (Reset | | | | |
1119 | | || After PRB | | | | |
1120 | | || Discon | | | | |
1121 | | | tinuity) | | | | |
1123 +------------+------------+------------+------------+-----+-----+-----+
1124 || U-plane || data\ | Supported | Y | Y | Y |
1125 || Packet || Direction | | | | |
1126 || Format || (data | | | | |
1127 | || direction | | | | |
1129 | || Tx/Rx)) | | | | |
1130 | +-------------------------+------------+-----+-----+-----+
1131 | || payload\ | 001b | Y | Y | Y |
1132 | || Version | | | | |
1133 | || (payload | | | | |
1134 | || version) | | | | |
1135 | +-------------------------+------------+-----+-----+-----+
1136 | || filter\ | Supported | Y | Y | Y |
1137 | || Index | | | | |
1138 | || (filter | | | | |
1139 | || index) | | | | |
1140 | +-------------------------+------------+-----+-----+-----+
1141 | || frameId | Supported | Y | Y | Y |
1142 | || (frame | | | | |
1144 | | tifier) | | | | |
1145 | +-------------------------+------------+-----+-----+-----+
1146 | || subframeId | Supported | Y | Y | Y |
1147 | || (subframe | | | | |
1149 | | tifier) | | | | |
1150 | +-------------------------+------------+-----+-----+-----+
1151 | || slotId | Supported | Y | Y | Y |
1152 | || (slot | | | | |
1154 | | tifier) | | | | |
1155 | +-------------------------+------------+-----+-----+-----+
1156 | || symbolId | Supported | Y | Y | Y |
1157 | || (symbol | | | | |
1159 | | tifier) | | | | |
1160 | +-------------------------+------------+-----+-----+-----+
1161 | || sectionId | Supported | Y | Y | Y |
1162 | || (section | | | | |
1164 | | tifier) | | | | |
1165 | +-------------------------+------------+-----+-----+-----+
1166 | || rb | 0 | Y | Y | Y |
1167 | || (resource | | | | |
1168 | || block | | | | |
1169 | || indicator) | | | | |
1170 | +-------------------------+------------+-----+-----+-----+
1171 | || symInc | 0 | Y | Y | Y |
1172 | || (symbol | | | | |
1173 | || number | | | | |
1174 | || increment | | | | |
1175 | || command) | | | | |
1176 | +-------------------------+------------+-----+-----+-----+
1177 | || startPrbu | Supported | Y | Y | Y |
1178 | || (startingPRB | | | | |
1179 | || of user | | | | |
1180 | || plane | | | | |
1181 | || section) | | | | |
1182 | +-------------------------+------------+-----+-----+-----+
1183 | || numPrbu | Supported | Y | Y | Y |
1184 | || (number of | | | | |
1185 | || PRBs per | | | | |
1186 | || user plane | | | | |
1187 | || section) | | | | |
1188 | +-------------------------+------------+-----+-----+-----+
1189 | || udCompHdr | Supported | Y | Y | N |
1190 | || (user data | | | | |
1192 | | pression | | | | |
1193 | || header) | | | | |
1194 | +-------------------------+------------+-----+-----+-----+
1195 | || reserved | 0 | Y | Y | Y |
1196 | || (reserved | | | | |
1197 | || for future | | | | |
1199 | +-------------------------+------------+-----+-----+-----+
1200 | || udCompParam | Supported | Y | Y | N |
1201 | || (user data | | | | |
1202 | || compre | | | | |
1204 | || parameter) | | | | |
1205 | +-------------------------+------------+-----+-----+-----+
1206 | || iSample | 16 | Y | Y | Y |
1207 | || (in-phase | | | | |
1208 | | sample) | | | | |
1209 | +-------------------------+------------+-----+-----+-----+
1210 | || qSample | 16 | Y | Y | Y |
1212 | | quadrature | | | | |
1213 | | sample) | | | | |
1215 +------------+-------------------------+------------+-----+-----+-----+
1216 | S-plane || Topology | Supported | N | N | N |
1217 | || confi | | | | |
1218 | | guration: | | | | |
1220 | +-------------------------+------------+-----+-----+-----+
1221 | || Topology | Supported | N | N | N |
1222 | || confi | | | | |
1223 | | guration: | | | | |
1225 | +-------------------------+------------+-----+-----+-----+
1226 | || Topology | Supported | Y | Y | Y |
1227 | || confi | | | | |
1228 | | guration: | | | | |
1230 | +-------------------------+------------+-----+-----+-----+
1231 | || Topology | Supported | N | N | N |
1232 | || confi | | | | |
1233 | | guration: | | | | |
1236 + +------------+------------+------------+-----+-----+-----+
1237 | | PTP || Full | Supported | Y | Y | N |
1238 | | || Timing | | | | |
1239 | | || Support | | | | |
1240 | | || (G.8275.1)| | | | |
1242 +------------+------------+------------+------------+-----+-----+-----+
1243 | M-plane | | || Not | N | N | N |
1244 | | | || supported | | | |
1246 +------------+------------+------------+------------+-----+-----+-----+
1248 \* The bit width of each component in eAxC ID can be configurable.
1253 O-RAN Fronthaul data can be transported over Ethernet or IPv4/IPv6. In
1254 the current implementation, the O-RAN library supports only Ethernet with
1257 .. image:: images/Native-Ethernet-Frame-with-VLAN.jpg
1259 :alt: Figure 11. Native Ethernet Frame with VLAN
1261 Figure 11. Native Ethernet Frame with VLAN
1264 Standard DPDK routines are used to perform Transport Layer
1267 VLAN tag functionality is offloaded to NIC as per the configuration of
1268 VF (refer to Setup Configuration).
1270 The transport header is defined in the ORAN Fronthaul specification
1271 based on the eCPRI specification.
1273 .. image:: images/eCPRI-Header-Field-Definitions.jpg
1275 :alt: Figure 12. eCPRI Header Field Definitions
1277 Figure 12. eCPRI Header Field Definitions
1279 Only ECPRI_IQ_DATA = 0x00 and ECPRI_RT_CONTROL_DATA= 0x02 message types
1282 For one-way delay measurements the eCPRI Header Field Definitions are
1283 the same as above until the ecpriPayload. The one-delay measurement
1284 message format is shown in the next figure.
1286 .. image:: images/ecpri-one-way-delay-measurement-message.jpg
1288 :alt: Figure 13. ecpri one-way delay measurement message
1290 Figure 13. ecpri one-way delay measurement message
1292 In addition, for the eCPRI one-delay measurement message there is a
1293 requirement of dummy bytes insertion so the overall ethernet frame has
1296 The measurement ID is a one-byte value used by the sender of the request
1297 to distinguish the response received between different measurements.
1299 The action type is a one-byte value defined in Table 8 of the eCPRI
1302 Action Type 0x00 corresponds to a Request
1304 Action Type 0x01 corresponds to a Request with Follow Up
1306 Both values are used by an eCPRI node to initiate a one-way delay
1307 measurement in the direction of its own node to another node.
1309 Action Type 0x02 corresponds to a Response
1311 Action Type 0x03 is a Remote Request
1313 Action Type 0x04 is a Remote Request with Follow Up
1315 Values 0x03 and 0x04 are used when an eCPRI node needs to know the
1316 one-way delay from another node to itself.
1318 Action Type 0x05 is the Follow_Up message.
1320 The timestamp uses the IEEE-1588 Timestamp format with 8 bytes for the
1321 seconds part and 4 bytes for the nanoseconds part. The timestamp is a
1322 positive time with respect to the epoch.
1324 The compensation value is used with Action Types 0x00 (Request), 0x02
1325 (Response) or 0x05 (Follow_up) for all others this field contains zeros.
1326 This value is the compensation time measured in nanoseconds and
1327 multiplied by 2\ :sup:16 and follows the format for the
1328 correctionField in the common message header specified by the IEE
1329 1588-2008 clause 13.3.
1331 Handling of ecpriRtcid/ecpriPcid Bit field size is configurable and can
1332 be defined on the initialization stage of the O-RAN library.
1334 .. image:: images/Bit-Allocations-of-ecpriRtcid-ecpriPcid.jpg
1336 :alt: Figure 14. Bit Allocations of ecpriRtcid/ecpriPcid
1338 Figure 14. Bit Allocations of ecpriRtcid/ecpriPcid
1340 For ecpriSeqid only, the support for a sequence number is implemented.
1341 The subsequent number is not supported.
1346 The following diagrams show O-RAN packet protocols’ headers and data
1347 arrangement with and without compression support.
1349 O-RAN packet meant for traffic with compression enabled has the
1350 Compression Header added after each Application Header. According to
1351 O-RAN Fronthaul's specification, the Compression Header is part of a
1352 repeated Section Application Header. In the O-RAN library implementation,
1353 the header is implemented as a separate structure, following the
1354 Application Section Header. As a result, the Compression Header is not
1355 included in the O-RAN packet, if compression is not used.
1357 Figure 15 shows the components of an ORAN packet.
1359 .. image:: images/xRAN-Packet-Components.jpg
1361 :alt: Figure 15. O-RAN Packet Components
1363 Figure 15. O-RAN Packet Components
1365 Radio Application Header
1366 ~~~~~~~~~~~~~~~~~~~~~~~~
1368 The next header is a common header used for time reference.
1370 .. image:: images/Radio-Application-Header.jpg
1372 :alt: Figure 16. Radio Application Header
1374 Figure 16. Radio Application Header
1376 The radio application header specific field values are implemented as
1383 - subframeId = [0:9]
1389 Data Section Application Data Header
1390 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
1392 The Common Radio Application Header is followed by the Application
1393 Header that is repeated for each Data Section within the eCPRI message.
1394 The relevant section of O-RAN packet is shown in color.
1396 .. image:: images/Data-Section-Application-Data-Header.jpg
1398 :alt: Figure 17. Data Section Application Data Header
1400 Figure 17. Data Section Application Data Header
1403 A single section is used per one Ethernet packet with IQ samples
1404 startPrbu is equal to 0 and numPrbu is wqual to the number of RBs used:
1406 - rb field is not used (value 0).
1408 - symInc is not used (value 0)
1413 An O-RAN packet data payload contains a number of PRBs. Each PRB is built
1414 of 12 IQ samples. Flexible IQ bit width is supported. If compression is enabled udCompParam is included in the data payload. The data section is shown in colour.
1416 .. image:: images/Data-Payload.jpg
1418 :alt: Figure 17. Data Payload
1420 Figure 17. Data Payload
1425 C-Plane messages are encapsulated using a two-layered header approach.
1426 The first layer consists of an eCPRI standard header, including
1427 corresponding fields used to indicate the message type, while the second
1428 layer is an application layer including necessary fields for control and
1429 synchronization. Within the application layer, a “section” defines the characteristics of U-plane data to be transferred or received from a
1430 beam with one pattern id. In general, the transport header,application
1431 header, and sections are all intended to be aligned on 4-byte boundaries
1432 and are transmitted in “network byte order” meaning the most significant
1433 byte of a multi-byte parameter is transmitted first.
1435 Table 9 is a list of sections currently supported.
1437 Table 9. Section Types
1439 +--------------+--------------------------+--------------------------+
1440 | Section Type | Target Scenario | Remarks |
1441 +--------------+--------------------------+--------------------------+
1442 | 0 | Unused Resource Blocks | Not supported |
1443 | | or symbols in Downlink | |
1445 +--------------+--------------------------+--------------------------+
1446 | 1 | Most DL/UL radio | Supported |
1448 +--------------+--------------------------+--------------------------+
1449 | 2 | reserved for future use | N/A |
1450 +--------------+--------------------------+--------------------------+
1451 | 3 | PRACH and | Only PRACH is supported. |
1452 | | mixed-numerology | Mixed numerology is not |
1453 | | channels | supported. |
1454 +--------------+--------------------------+--------------------------+
1455 | 4 | Reserved for future use | Not supported |
1456 +--------------+--------------------------+--------------------------+
1457 | 5 | UE scheduling | Not supported |
1458 | | information (UE-ID | |
1459 | | assignment to section) | |
1460 +--------------+--------------------------+--------------------------+
1461 | 6 | Channel information | Not supported |
1462 +--------------+--------------------------+--------------------------+
1463 | 7 | LAA | Not supported |
1464 +--------------+--------------------------+--------------------------+
1465 | 8-255 | Reserved for future use | N/A |
1466 +--------------+--------------------------+--------------------------+
1468 Section extensions are not supported in this release.
1470 The definition of the C-Plane packet can be found lib/api/xran_pkt_cp.h
1471 and the fields are appropriately re-ordered in order to apply the
1472 conversion of network byte order after setting values.
1473 The comments in source code of O-RAN lib can be used to see more information on
1474 implementation specifics of handling sections as well as particular fields.
1475 Additional changes may be needed on C-plane to perform IOT with O-RU depending on the scenario.
1487 This header is defined as the structure of xran_ecpri_hdr in
1490 Radio Application Common Header
1491 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
1493 The Radio Application Common Header is used for time reference. Its
1494 structure is shown in Figure 18.
1496 .. image:: images/Radio-Application-Common-Header.jpg
1498 :alt: Figure 19. Radio Application Common Header
1500 Figure 19. Radio Application Common Header
1502 This header is defined as the structure of
1503 xran_cp_radioapp_common_header in lib/api/xran_pkt_cp.h.
1505 Please note that the payload version in this header is fixed to
1506 XRAN_PAYLOAD_VER (defined as 1) in this release.
1508 Section Type 0 Structure
1509 ~~~~~~~~~~~~~~~~~~~~~~~~
1511 Figure 20 describes the structure of Section Type 0.
1513 .. image:: images/Section-Type-0-Structure.jpg
1515 :alt: Figure 20. Section Type 0 Structure
1517 Figure 20. Section Type 0 Structure
1519 In Figure 19 through Figure 23, the color yellow means it is a transport
1520 header; the color pink is the radio application header; others are
1523 Section Type 1 Structure
1524 ~~~~~~~~~~~~~~~~~~~~~~~~
1526 Figure 21 describes the structure of Section Type 1.
1528 .. image:: images/Section-Type-1-Structure.jpg
1530 :alt: Figure 21. Section Type 1 Structure
1532 Figure 21. Section Type 1 Structure
1534 Section Type 1 message has two additional parameters in addition to
1535 radio application common header:
1537 - udCompHdr : defined as the structure of xran_radioapp_udComp_header
1539 - reserved : fixed by zero
1541 Section type 1 is defined as the structure of xran_cp_radioapp_section1,
1542 and this part can be repeated to have multiple sections.
1544 Whole section type 1 message can be described in this summary:
1546 +----------------------------------+
1547 | xran_cp_radioapp_common_header |
1548 +==================================+
1549 | xran_cp_radioapp_section1_header |
1550 +----------------------------------+
1551 | xran_cp_radioapp_section1 |
1552 +----------------------------------+
1554 +----------------------------------+
1555 | xran_cp_radioapp_section1 |
1556 +----------------------------------+
1558 Section Type 3 Structure
1559 ~~~~~~~~~~~~~~~~~~~~~~~~
1561 Figure 22 describes the structure of Section Type 3.
1563 .. image:: images/Section-Type-3-Structure.jpg
1565 :alt: Figure 22. Section Type 3 Structure
1567 Figure 22. Section Type 3 Structure
1569 Section Type 3 message has below four additional parameters in addition
1570 to radio application common header.
1574 - frameStructure: defined as the structure of
1575 xran_cp_radioapp_frameStructure
1579 - udCompHdr: defined as the structure of xran_radioapp_udComp_header
1581 Section Type 3 is defined as the structure of xran_cp_radioapp_section3
1582 and this part can be repeated to have multiple sections.
1584 Whole section type 3 message can be described in this summary:
1586 +----------------------------------+
1587 | xran_cp_radioapp_common_header |
1588 +==================================+
1589 | xran_cp_radioapp_section3_header |
1590 +----------------------------------+
1591 | xran_cp_radioapp_section3 |
1592 +----------------------------------+
1594 +----------------------------------+
1595 | xran_cp_radioapp_section3 |
1596 +----------------------------------+
1598 Section Type 5 Structure
1599 ~~~~~~~~~~~~~~~~~~~~~~~~
1601 Figure 23 describes the structure of Section Type 5.
1603 .. image:: images/Section-Type-5-Structure.jpg
1605 :alt: Figure 23. Section Type 5 Structure
1607 Figure 23. Section Type 5 Structure
1610 Section Type 6 Structure
1611 ~~~~~~~~~~~~~~~~~~~~~~~~
1613 Figure 24 describes the structure of Section Type 6.
1615 .. image:: images/Section-Type-6-Structure.jpg
1617 :alt: Figure 24. Section Type 6 Structure
1619 Figure 24. Section Type 6 Structure
Code Review / o-du / phy.git / blob