API-Docs
This is the API-docs for I release o-du/l2.
Introduction
This section tabulates the APIs Aligned(Implemented)/Not Implemented/Additional APIs between various modules of ODU-High and also with external modules of ORAN.
F1 Interface APIs
Below table lists APIs Aligned(Implemented)/Not Implemented at F1 interface of ODU-High i.e. between O-DU and O-CU. These are in line with 3GPP 38.473 V15.3.0.
Interface |
API |
Status |
Section |
Remark |
|---|---|---|---|---|
CU & DU |
Reset |
Aligned |
9.2.1.1 |
|
Reset Acknowledge |
Aligned |
9.2.1.2 |
||
Error Indication |
Not Implemented |
9.2.1.3 |
||
F1 Setup Request |
Aligned |
9.2.1.4 |
||
F1 Setup Response |
Aligned |
9.2.1.5 |
||
F1 Setup Failure |
Not Implemented |
9.2.1.6 |
||
GNB-DU Configuration Update |
Aligned |
9.2.1.7 |
||
GNB-DU Configuration Update Acknowledge |
Aligned |
9.2.1.8 |
||
GNB-DU Configuration Update Failure |
Not Implemented |
9.2.1.9 |
||
GNB-CU Configuration Update |
Not Implemented |
9.2.1.10 |
||
GNB-CU Configuration Update Acknowledge |
Not Implemented |
9.2.1.11 |
||
GNB-CU Configuration Update Failure |
Not Implemented |
9.2.1.12 |
||
GNB-DU Resource Coordination Request |
Not Implemented |
9.2.1.13 |
||
GNB-DU Resource Coordination Response |
Not Implemented |
9.2.1.14 |
||
GNB-DU Status Indication |
Not Implemented |
9.2.1.15 |
||
UE Context Setup Request |
Aligned |
9.2.2.1 |
||
UE Context Setup Response |
Aligned |
9.2.2.2 |
||
UE Context Setup Faliure |
Not Implemented |
9.2.2.3 |
||
UE Context Release Request |
Aligned |
9.2.2.4 |
||
UE Context Release Command |
Aligned |
9.2.2.5 |
||
UE Context Release Complete |
Aligned |
9.2.2.6 |
||
UE Context Modification Request |
Aligned |
9.2.2.7 |
||
UE Context Modification Response |
Aligned |
9.2.2.8 |
||
UE Context Modification Failure |
Not Implemented |
9.2.2.9 |
||
UE Context Modification Required |
Not Implemented |
9.2.2.10 |
||
UE Context Modification Confirm |
Not Implemented |
9.2.2.11 |
||
UE Inactivity Notification |
Not Implemented |
9.2.2.12 |
||
Notify |
Not Implemented |
9.2.2.13 |
||
Initial UL RRC Message Transfer |
Aligned |
9.2.3.1 |
||
DL RRC Message Transfer |
Aligned |
9.2.3.2 |
||
UL RRC Message Transfer |
Aligned |
9.2.3.3 |
||
Write-Replace Warning Request |
Not Implemented |
9.2.4.1 |
||
Write-Replace Warning Response |
Not Implemented |
9.2.4.2 |
||
PWS Cancel Request |
Not Implemented |
9.2.4.3 |
||
PWS Cancel Response |
Not Implemented |
9.2.4.4 |
||
PWS Restart Indication |
Not Implemented |
9.2.4.5 |
||
PWS failure Indication |
Not Implemented |
9.2.4.6 |
||
System Information Delivery Command |
Not Implemented |
9.2.5.1 |
||
Paging |
Aligned |
9.2.6.1 |
E2 Interface APIs
This section tabulates the APIs Aligned(Implemented)/Not Implemented between ODU-High and Near-RT RIC. These are in line with O-RAN.WG3.E2GAP-R003-v03.00 and O-RAN.WG3.E2AP-R003-v03.00. Below mentioned section number are taken reference from sections of O-RAN.WG3.E2AP-R003-v03.00.
Interface |
API |
Status |
Section |
Remark |
|---|---|---|---|---|
DU &**RIC** |
RIC Subscription procedure |
Aligned |
8.2.1 |
|
RIC Subscription Delete procedure |
Aligned |
8.2.2 |
||
RIC Subscription Delete Required procedure |
Aligned |
8.2.2A |
||
RIC Indication procedure |
Aligned |
8.2.3 |
||
RIC Control procedure |
Not Implemented |
8.2.4 |
||
RIC Subscription Modification procedure |
Aligned |
8.2.5 |
||
RIC Subscription Modification Required procedure |
Aligned |
8.2.6 |
||
RIC query procedure |
Not Implemented |
8.2.7 |
||
E2 Setup procedure |
Aligned |
8.3.1 |
||
Reset procedure |
Aligned |
8.3.2 |
||
Error Indication |
Aligned |
8.3.3 |
||
RIC Service Update procedure |
Aligned |
8.3.4 |
||
E2 Node Configuration Update procedure |
Aligned |
8.3.5 |
||
E2 Connection Update procedure |
Aligned |
8.3.6 |
||
E2 Removal procedure |
Aligned |
8.3.7 |
ODU-High Internal Interface APIs
Below table lists APIs Aligned(Implemented)/Not Implemented/Additional APIs between various modules of ODU-High. These are in line with ORAN-WG8.AAD-v9.00.00, hereafter referred to as AAD Spec.
Note: DU APP module consist functionality related to F1 Handler, E2 Handler and O1 Handler.
Interface |
API |
Status |
Section |
Remark |
|---|---|---|---|---|
SMO-OAM & DU APP |
Cell Configuration |
Aligned |
11.2.1.1 |
|
Slice Configuration |
Aligned |
11.2.1.2 |
||
Bring Cell Up |
Additional API |
Notify DU to bring specific cell up |
||
Bring Cell Down |
Additional API |
Notify DU to bring specific cell down |
||
Slice PM |
Additional API |
DU APP sends PM for all Slices every 60s |
||
Raise Cell Alarm |
Additional API |
DU APP alarms during cell state change |
||
Set the cell operational state |
Additional API |
DU APP inform cell state[ACTIVE/INACTIVE] |
||
RLC & MAC |
DL Transfer |
Aligned |
11.2.3.1 |
|
UL Transfer |
Aligned |
11.2.3.2 |
||
Schedule Result Reporting(DL) |
Aligned |
11.2.3.3 |
||
Buffer Status Report(UL) |
Aligned |
11.2.3.4 |
||
|
Air Interface Time |
Aligned |
11.2.4.1.1 |
|
Cell Configuration Request |
Aligned |
11.2.4.2.1 |
||
Cell Delete Request |
Aligned |
11.2.4.2.2 |
||
Slice Configuration Request |
Aligned |
11.2.4.2.3 |
||
Slice Reconfiguration Request |
Aligned |
11.2.4.2.4 |
||
Add UE Configuration Request |
Aligned |
11.2.4.2.5 |
||
UE Reconfiguration Request |
Aligned |
11.2.4.2.6 |
||
Delete UE Request |
Aligned |
11.2.4.2.7 |
||
DL HARQ Indication |
Aligned |
11.2.4.2.8 |
||
UL Harq Indication(CRC) |
Aligned |
11.2.4.2.9 |
||
UL Channel Quality Information |
Not Implemented |
11.2.4.2.10 |
||
DL Channel Quality Information |
Not Impelemented |
11.2.4.2.11 |
||
RACH Indication Contents |
Aligned |
11.2.4.2.12 |
||
Paging Indication Contents |
Aligned |
11.2.4.2.13 |
||
RACH Resource Request |
Aligned |
11.2.4.2.14 |
||
RACH Resource Release |
Aligned |
11.2.4.2.15 |
||
DL RLC Buffer Status Info |
Aligned |
11.2.4.2.16 |
||
Scheduling Request Indication |
Aligned |
11.2.4.2.17 |
||
UL Buffer Status Report Ind |
Aligned |
11.2.4.2.18 |
||
Power Headroom Indication |
Aligned |
11.2.4.2.19 |
||
Statistics Request |
Additional API |
Adding new statistics group |
||
Statistics Modification Request |
Additional API |
Modification of statistics group |
||
Statistics Delete Request |
Additional API |
Deletion of statistics group |
||
|
Cell Configuration Response |
Aligned |
11.2.4.3.1 |
|
Cell Delete Response |
Aligned |
11.2.4.3.2 |
||
Slice Configuration Response |
Aligned |
11.2.4.3.3 |
||
Slice ReConfiguration Response |
Aligned |
11.2.4.3.4 |
||
UE Configuration Response |
Aligned |
11.2.4.3.5 |
||
UE ReConfiguration Response |
Aligned |
11.2.4.3.6 |
||
UE Delete Response |
Aligned |
11.2.4.3.7 |
||
DL Scheduling Information |
Aligned |
11.2.4.3.8 |
||
UL Scheduling Information |
Aligned |
11.2.4.3.9 |
||
RAR Information |
Not Required |
11.2.4.3.10 |
Included in DL Scheduling Info |
|
Downlink Control Channel Info |
Not Required |
11.2.4.3.11 |
Included in DL Scheduling Info |
|
Downlink Broadcast Allocation |
Not Required |
11.2.4.3.12 |
Included in DL Scheduling Info |
|
Downlink Paging Allocation |
Aligned |
11.2.4.3.13 |
||
HARQ Process Release |
Additional API |
SCH indicates MAC to release a HARQ process in case a positive acknowledement is received or achieved maximum retrans. |
||
RACH Resource Response |
Additional API |
Response to RACH Resource Request for dedicated resource for CF-RA |
||
Statistics Response |
Additional API |
Response to statistics request |
||
Statistics Modification Resonse |
Additional API |
Response to statistics modification request |
||
Statistics Delete Response |
Additional API |
Response to statistics delete request |
||
Statistics Indication |
Additional API |
Calculate the KPI related to a specific statistics group |
||
|
Cell Start |
Aligned |
1.1.1.1 |
|
Cell Stop |
Aligned |
1.1.1.2 |
||
Cell Configuration Request |
Additional API |
Configures cell information at MAC. |
||
Cell Configuration Response |
Additional API |
Response to cell Cfg Req from DUAPP |
||
Cell Delete Request |
Additional API |
Deletes cell information at MAC. |
||
Cell Delete Response |
Additional API |
Response to Cell Del request from DU APP |
||
Slice Configuration Request |
Additional API |
Configures Slice at MAC |
||
Slice ReConfiguration Request |
Additional API |
ReConfigures Slice at MAC |
||
Slice Configuration Response |
Additional API |
Response to Slice Cfg req from DU APP |
||
Slice ReConfiguration Response |
Additional API |
Response to Slice ReCfg req from DU APP |
||
UE Create Request |
Aligned |
1.1.1.3 |
||
UE Create Response |
Aligned |
1.1.1.4 |
||
UE Reconfiguration Request |
Aligned |
1.1.1.5 |
||
UE Reconfiguration Response |
Aligned |
1.1.1.6 |
||
UE Delete Request |
Aligned |
1.1.1.7 |
||
UE Delete Response |
Aligned |
1.1.1.8 |
||
RACH Resource Request |
Aligned |
1.1.1.9 |
||
RACH Resource Response |
Aligned |
1.1.1.10 |
||
RACH Resource Release |
Aligned |
1.1.1.11 |
||
UE Reset Request |
Not Implemented |
1.1.1.12 |
||
UE Reset Response |
Not Implemented |
1.1.1.13 |
||
UE Sync Status Indication |
Not Implemented |
1.1.1.14 |
||
UL CCCH Indication |
Aligned |
1.1.1.15 |
||
DL CCCH Indication |
Aligned |
1.1.1.16 |
||
DL PCCH Indication |
Aligned |
1.1.1.17 |
||
DL Broadcast Request |
Not Implemented |
1.1.1.18 |
||
Slot Indication |
Additional API |
|
||
Statistics Request |
Additional API |
Adding new statistics at DU layer |
||
Statistics Response |
Additional API |
Response to statistics request from MAC |
||
Statistics Modification Request |
Additional API |
Modification of statistics at DU layer |
||
Statistics Modification Response |
Additional API |
Response to statistics modification request from MAC |
||
Statistics Delete Request |
Additional API |
Deletion of statistics at DU layer |
||
Statistics Delete Response |
Additional API |
Response to statistics delete request from MAC |
||
Statistics Indication |
Additional API |
Sending the calculated KPI value to DU from MAC |
||
|
UE Create |
Aligned |
11.2.5.1 |
|
UE Create Response |
Aligned |
11.2.5.2 |
||
UE Reconfiguration |
Aligned |
11.2.5.3 |
||
UE Reconfiguration Response |
Aligned |
11.2.5.4 |
||
UE Delete |
Aligned |
11.2.5.5 |
||
UE Delete Response |
Aligned |
11.2.5.6 |
||
DL-RRC Message Transfer |
Aligned |
11.2.5.7 |
||
UL-RRC Message Transfer |
Aligned |
11.2.5.8 |
||
UL-RRC Message Delivery Report |
Aligned |
11.2.5.9 |
||
RLC Max Retransmission Reached |
Not Implemented |
11.2.5.10 |
||
UL-RLC Re-establishment Request |
Not Implemented |
11.2.5.11 |
||
UL-RLC Re-establshment Response |
Not Implemented |
11.2.5.12 |
||
DL RRC Message Response |
Additional API |
Informs DU APP if a DL RRC Message was successfuly procesed at RLC & sent to MAC |
||
DL User Data |
Additional API |
DL user data exchanged from DUAPP to RLC |
||
UL User Data |
Additional API |
UL user data exchanged from RLC to DUAPP |
||
Slice Performance Metrics |
Additional API |
Performance Metrics informed to DUAPP every 60sec for every slice configured |