1 /*******************************************************************************
2 ################################################################################
3 # Copyright (c) [2017-2019] [Radisys] #
5 # Licensed under the Apache License, Version 2.0 (the "License"); #
6 # you may not use this file except in compliance with the License. #
7 # You may obtain a copy of the License at #
9 # http://www.apache.org/licenses/LICENSE-2.0 #
11 # Unless required by applicable law or agreed to in writing, software #
12 # distributed under the License is distributed on an "AS IS" BASIS, #
13 # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. #
14 # See the License for the specific language governing permissions and #
15 # limitations under the License. #
16 ################################################################################
17 *******************************************************************************/
19 /* This file contains message handling functionality for DU cell management */
20 #include "common_def.h"
28 #include "du_app_mac_inf.h"
29 #include "du_app_rlc_inf.h"
30 #include "du_e2ap_mgr.h"
34 #include "du_cell_mgr.h"
35 #include "PCCH-Config.h"
36 #include "PagingUE-Identity.h"
37 #include "PagingRecord.h"
38 #include "PagingRecordList.h"
39 #include "PagingRrc.h"
40 #include "PCCH-MessageType.h"
41 #include "PCCH-Message.h"
42 #include "odu_common_codec.h"
46 #include "AlarmInterface.h"
47 #include "CmInterface.h"
51 GConfiguration gConfigInfo;
52 DuMacCellDeleteReq packMacCellDeleteReqOpts[] =
54 packDuMacCellDeleteReq, /* Loose coupling */
55 MacProcCellDeleteReq, /* TIght coupling */
56 packDuMacCellDeleteReq /* Light weight-loose coupling */
59 DuMacDlPcchInd packMacDlPcchIndOpts[] =
61 packDuMacDlPcchInd, /* Loose coupling */
62 MacProcDlPcchInd, /* TIght coupling */
63 packDuMacDlPcchInd /* Light weight-loose coupling */
66 DuMacDlBroadcastReq packMacDlBroadcastReqOpts[] =
68 packDuMacDlBroadcastReq, /* Loose coupling */
69 MacProcDlBroadcastReq, /* TIght coupling */
70 packDuMacDlBroadcastReq /* Light weight-loose coupling */
72 /*******************************************************************
74 * @brief Processes cells to be activated
78 * Function : duProcCellsToBeActivated
81 * - Processes cells to be activated list received in F1SetupRsp
84 * @return ROK - success
87 * ****************************************************************/
88 uint8_t duProcCellsToBeActivated(uint8_t *plmnStr, uint16_t nci, uint16_t nRPci)
91 DuCellCb *cellCb = NULLP;
92 uint8_t cfgIdx, tmpPlmn[4];
94 for(cfgIdx=0; cfgIdx<duCb.numCfgCells; cfgIdx++)
96 memset(tmpPlmn, 0, 4);
97 buildPlmnId(duCb.cfgCellLst[cfgIdx]->cellInfo.nrEcgi.plmn, tmpPlmn);
98 if(duCb.cfgCellLst[cfgIdx]->cellInfo.nrEcgi.cellId == nci &&
99 (strcmp((const char*)tmpPlmn, (const char*)plmnStr) == 0))
101 cellCb = duCb.cfgCellLst[cfgIdx];
106 DU_LOG("\nERROR --> DU APP : No Cell found for NCI %d", nci);
111 cellCb->cellStatus = ACTIVATION_IN_PROGRESS;
112 cellCb->cellInfo.nrPci = nRPci;
114 if((cmHashListInit(&(cellCb->pagingInfoMap), MAX_SFN, sizeof(DuPagInfoList),\
115 FALSE, CM_HASH_KEYTYPE_CONID, DU_APP_MEM_REGION, DU_POOL)) != ROK)
117 DU_LOG("ERROR --> DU APP: Failed to Initialize the Paging Hash Map");
120 duCb.actvCellLst[cellCb->cellId -1] = cellCb;
123 if(duBuildAndSendMacCellCfg(cellCb->cellId) != ROK)
125 DU_LOG("\nERROR --> DU APP : macCellCfg build and send failed");
126 /* Delete cell from actvCellList */
127 duCb.actvCellLst[cellCb->cellId -1] = NULLP;
128 --(duCb.numActvCells);
134 /*******************************************************************
136 * @brief Handles DU F1Setup Rsp received in F1AP
140 * Function : duProcF1SetupRsp
143 * - Handles DU F1Setup Rsp received in F1AP
145 * @params[in] Pointer to F1SetupRsp
148 ******************************************************************/
149 void duProcF1SetupRsp()
151 DU_LOG("\nINFO --> DU_APP : F1 Setup Response received");
152 duCb.f1Status = TRUE; //Set F1 status as true
155 /*******************************************************************
157 * @brief Returns cellCb based on cell ID
161 * Function : duGetCellCb
163 * Functionality: Returns DU APP CellCb based on cell ID
165 * @params[in] F1AP_PDU_t ASN decoded F1AP message
166 * @return ROK - success
169 * ****************************************************************/
170 uint8_t duGetCellCb(uint16_t cellId, DuCellCb **cellCb)
174 for(cellIdx=0; cellIdx < MAX_NUM_CELL; cellIdx++)
176 if(duCb.actvCellLst[cellIdx] && (duCb.actvCellLst[cellIdx]->cellId == cellId))
178 *cellCb = duCb.actvCellLst[cellIdx];
185 DU_LOG("\nERROR --> DU APP : Cell Id %d not found in DU APP", cellId);
192 /******************************************************************************
193 * @brief Check Paging Record for a Particular Paging Frame
197 * Function : checkPagingRecord
200 * Check Paging Record for a Particular Paging Frame
202 * @params[in] DuCellCb *cellCb
204 * @return ROK/RFAILURE (uint8_t return)
207 ******************************************************************************/
208 uint8_t checkPagingRecord(DuCellCb *cellCb)
211 DuPagInfoList *pagInfoLLFromPF = NULLP;
212 DuPagUeList *pagInfo = NULLP;
214 /*DUAPP may send PagingReq to MAC for future SFN so that Schedular can
215 * schedule Paging on the exact occurence of the Slot.*/
216 pf = (cellCb->currSlotInfo.sfn + PAGING_SCHED_DELTA) % MAX_SFN;
218 pagInfoLLFromPF = findPagingInfoFromMap(pf, &(cellCb->pagingInfoMap));
219 if(pagInfoLLFromPF == NULLP)
221 /*No Page is present for pf thus exiting*/
227 pagInfo = handlePageInfoLL(pf, NULLD, &(pagInfoLLFromPF->pagInfoList), TRAVERSE_ALL);
230 if(BuildAndSendDlPcchIndToMac(cellCb->cellId, pf, pagInfo->i_s, &(pagInfo->pagUeList)) != ROK)
232 DU_LOG("\nERROR --> DU APP: Issue in Building Page RRC PDU i_s:%d",pagInfo->i_s);
235 handlePageInfoLL(pf, pagInfo->i_s, &(pagInfoLLFromPF->pagInfoList), DELETE);
237 if(pagInfoLLFromPF->pagInfoList.first == NULLP)
241 }while(pagInfo != NULLP);
243 cmHashListDelete(&(cellCb->pagingInfoMap), (PTR)pagInfoLLFromPF);
244 DU_FREE(pagInfoLLFromPF, sizeof(DuPagInfoList));
248 /******************************************************************
250 * @brief Send pcch indication to MAC
254 * Function : sendDlPcchIndToMac
256 * Functionality: Send pcch indication to MAC
258 * @Params[in] DlPcchInd *pcchInd
259 * @return ROK - success
262 * ****************************************************************/
264 uint8_t sendDlPcchIndToMac(DlPcchInd *pcchInd)
272 FILL_PST_DUAPP_TO_MAC(pst, EVENT_MAC_DL_PCCH_IND);
274 ret = (*packMacDlPcchIndOpts[pst.selector])(&pst, pcchInd);
277 DU_LOG("\nERROR --> DU APP : sendDlPcchIndToMac(): Failed to DL PCCH indication to MAC");
282 DU_LOG("\nERROR --> DU APP: sendDlPcchIndToMac(): Received pcchInd is NULLP");
289 /*****************************************************************
290 * @brief Handles slot indication from MAC
294 * Function : duHandleSlotInd
297 * Handles slot indication from MAC
299 * @params[in] Post structure pointer
300 * SlotTimingInfo *slotIndInfo
301 * @return ROK - success
305 *****************************************************************/
306 uint8_t duHandleSlotInd(Pst *pst, SlotTimingInfo *slotIndInfo)
308 uint8_t cellIdx = 0, ret = ROK;
309 DuCellCb *duCellCb = NULLP;
313 GET_CELL_IDX(slotIndInfo->cellId, cellIdx);
314 duCellCb = duCb.actvCellLst[cellIdx];
318 duCellCb->currSlotInfo.sfn = slotIndInfo->sfn;
319 duCellCb->currSlotInfo.slot = slotIndInfo->slot;
320 checkPagingRecord(duCellCb);
324 DU_LOG("\nERROR --> DU APP : CellId[%d] doesnot exist", slotIndInfo->cellId);
327 DU_FREE_SHRABL_BUF(pst->region, pst->pool, slotIndInfo, sizeof(SlotTimingInfo));
331 DU_LOG("\nERROR --> DU APP : Recevied null pointer from MAC");
336 /*******************************************************************
338 * @brief Handles cell up indication from MAC
342 * Function : duHandleCellUpInd
345 * Handles cell up indication from MAC
347 * @params[in] Post structure pointer
349 * @return ROK - success
352 * ****************************************************************/
353 uint8_t duHandleCellUpInd(Pst *pst, OduCellId *cellId)
355 DuCellCb *cellCb = NULLP;
357 if(cellId->cellId <=0 || cellId->cellId > MAX_NUM_CELL)
359 DU_LOG("\nERROR --> DU APP : Invalid Cell Id %d in duHandleCellUpInd()", cellId->cellId);
363 if(duGetCellCb(cellId->cellId, &cellCb) != ROK)
366 if((cellCb != NULL) && (cellCb->cellStatus == ACTIVATION_IN_PROGRESS))
368 DU_LOG("\nINFO --> DU APP : 5G-NR Cell %d is UP", cellId->cellId);
369 cellCb->cellStatus = ACTIVATED;
370 gConfigInfo.gCellStatus = CELL_UP;
372 if(duCfgParam.tempSliceCfg.numOfRrmPolicy)
373 BuildAndSendSliceConfigReq();
375 DU_LOG("\nINFO --> DU APP : Raise cell UP alarm for cell id=%d", cellId->cellId);
376 raiseCellAlrm(CELL_UP_ALARM_ID, cellId->cellId);
377 setCellOpState(cellId->cellId, ENABLED, ACTIVE);
379 duCfgParam.macCellCfg.cellCfg.opState = OP_ENABLED;
380 duCfgParam.macCellCfg.cellCfg.cellState = CELL_ACTIVE;
383 if((pst->selector == ODU_SELECTOR_LWLC) || (pst->selector == ODU_SELECTOR_TC))
384 DU_FREE_SHRABL_BUF(pst->region, pst->pool, cellId, sizeof(OduCellId));
388 /*******************************************************************
390 * @brief Handle Cell delete response from MAC
394 * Function : DuProcMacCellDeleteRsp
396 * Functionality: Handle Cell delete response from MAC
398 * @params[in] Pointer to MacCellDeleteRsp and Pst
399 * @return ROK - success
402 * ****************************************************************/
404 uint8_t DuProcMacCellDeleteRsp(Pst *pst, MacCellDeleteRsp *deleteRsp)
407 uint16_t cellIdx=0, pfIdx=0;
408 DuPagInfoList *pagInfoLLFromPF=NULLP;
412 if(deleteRsp->status == SUCCESSFUL)
414 GET_CELL_IDX(deleteRsp->cellId, cellIdx);
415 DU_LOG("\nINFO --> DU APP : MAC CELL Delete Response : SUCCESS [CELL IDX : %d]", deleteRsp->cellId);
416 if(duCb.actvCellLst[cellIdx] && (duCb.actvCellLst[cellIdx]->cellId == deleteRsp->cellId))
418 for(pfIdx =0; pfIdx < MAX_SFN; pfIdx++)
420 pagInfoLLFromPF = findPagingInfoFromMap(pfIdx, &(duCb.actvCellLst[cellIdx]->pagingInfoMap));
423 cmHashListDelete(&(duCb.actvCellLst[cellIdx]->pagingInfoMap), (PTR)pagInfoLLFromPF);
424 DU_FREE(pagInfoLLFromPF, sizeof(DuPagInfoList));
428 memset(duCb.actvCellLst[cellIdx], 0, sizeof(DuCellCb));
429 gConfigInfo.gCellStatus = CELL_DOWN;
432 DU_LOG("\nINFO --> DU APP : Raise cell down alarm for cell id=%d", deleteRsp->cellId);
433 raiseCellAlrm(CELL_DOWN_ALARM_ID, deleteRsp->cellId);
434 setCellOpState(deleteRsp->cellId, DISABLED, INACTIVE);
439 DU_FREE(duCb.actvCellLst[cellIdx], sizeof(DuCellCb));
444 DU_LOG("\nERROR --> DU APP : DuProcMacCellDeleteRsp(): CellId [%d] doesnot exist", deleteRsp->cellId);
450 DU_LOG("\nERROR --> DU APP : DuProcMacCellDeleteRsp(): MAC CELL Delete Response : FAILED\
451 [CELL IDX : %d]", deleteRsp->cellId);
454 DU_FREE_SHRABL_BUF(pst->region, pst->pool, deleteRsp, sizeof(MacCellDeleteRsp));
458 DU_LOG("\nERROR --> DU APP : DuProcMacCellDeleteRsp(): Received MAC cell delete response is NULL");
464 /*******************************************************************
466 * @brief Sending Cell Delete Req To Mac
470 * Function : sendCellDeleteReqToMac
473 * sending Cell Delete Req To Mac
475 * @params[in] uint16_t cellId
476 * @return ROK - success
480 *****************************************************************/
482 uint8_t sendCellDeleteReqToMac(uint16_t cellId)
486 MacCellDeleteReq *cellDelete = NULLP;
488 DU_ALLOC_SHRABL_BUF(cellDelete, sizeof(MacCellDeleteReq));
491 cellDelete->cellId = cellId;
492 FILL_PST_DUAPP_TO_MAC(pst, EVENT_MAC_CELL_DELETE_REQ);
494 DU_LOG("\nINFO --> DU APP : Sending Cell Delete Request to MAC");
495 /* Processing one Cell at a time to MAC */
496 ret = (*packMacCellDeleteReqOpts[pst.selector])(&pst, cellDelete);
499 DU_LOG("\nERROR --> DU APP : sendCellDeleteReqToMac(): Failed to send Cell delete Req to MAC");
500 DU_FREE_SHRABL_BUF(DU_APP_MEM_REGION, DU_POOL, cellDelete, sizeof(MacCellDeleteReq));
505 DU_LOG("\nERROR --> DU APP : sendCellDeleteReqToMac(): Failed to allocate memory");
511 /*******************************************************************
513 * @brief DU preocess Cell Delete Req to MAC
517 * Function : duSendCellDeletReq
519 * Functionality: DU process Cell Delete Req to MAC
521 * @params[in] uint16_t cellId
522 * @return ROK - success
525 * ****************************************************************/
527 uint8_t duSendCellDeletReq(uint16_t cellId)
529 uint16_t cellIdx = 0;
530 DU_LOG("\nINFO --> DU APP : Processing Cell Delete Request ");
531 GET_CELL_IDX(cellId, cellIdx);
533 if(duCb.actvCellLst[cellIdx] == NULLP)
535 DU_LOG("\nERROR --> DU APP : duSendCellDeletReq(): CellId[%d] is not found", cellId);
539 if(duCb.actvCellLst[cellIdx]->cellId != cellId)
541 DU_LOG("\nERROR --> DU APP : duSendCellDeletReq(): CellId[%d] is not found", cellId);
546 if(duCb.actvCellLst[cellIdx]->cellStatus != DELETION_IN_PROGRESS)
548 DU_LOG("\nERROR --> DU APP : duSendCellDeletReq(): CellStatus[%d] of cellId[%d] is not correct.\
549 Expected CellStatus is DELETION_IN_PROGRESS",duCb.actvCellLst[cellIdx]->cellStatus, cellId);
553 if(duBuildAndSendMacCellStop(cellId) == RFAILED)
555 DU_LOG("\nERROR --> DU APP : duSendCellDeletReq(): Failed to build and send cell stop request to MAC for\
563 /*******************************************************************
564 * @brief Free PCCH PDU structure
568 * Function : freePcchPdu
570 * Functionality: Free PCCH PDU structure
572 * @params[in] PCCH_Message_t *pcchMsg
576 * ****************************************************************/
577 void freePcchPdu(PCCH_Message_t *pcchMsg)
579 PagingRrc_t *pagingMsg = NULLP;
580 uint8_t recordIdx = 0;
584 if(pcchMsg->message.choice.c1 != NULLP)
586 pagingMsg = pcchMsg->message.choice.c1->choice.paging;
587 if(pagingMsg != NULLP)
589 if(pagingMsg->pagingRecordList)
591 if(pagingMsg->pagingRecordList->list.array != NULLP)
593 for(recordIdx = 0; recordIdx < pagingMsg->pagingRecordList->list.count; recordIdx++)
595 if(pagingMsg->pagingRecordList->list.array[recordIdx] != NULLP)
597 DU_FREE(pagingMsg->pagingRecordList->list.array[recordIdx]->ue_Identity.choice.ng_5G_S_TMSI.buf,\
598 pagingMsg->pagingRecordList->list.array[recordIdx]->ue_Identity.choice.ng_5G_S_TMSI.size);
599 DU_FREE(pagingMsg->pagingRecordList->list.array[recordIdx], sizeof(PagingRecord_t));
602 DU_FREE(pagingMsg->pagingRecordList->list.array, pagingMsg->pagingRecordList->list.size);
604 DU_FREE(pagingMsg->pagingRecordList, sizeof(PagingRecordList_t));
606 DU_FREE(pcchMsg->message.choice.c1->choice.paging, sizeof(PagingRrc_t));
608 DU_FREE(pcchMsg->message.choice.c1 , sizeof(PCCH_MessageType_t));
610 DU_FREE(pcchMsg , sizeof(PCCH_Message_t));
614 /*******************************************************************
615 * @brief Builds the Pcch RRC PDU and forwards it to MAC
619 * Function : BuildAndSendDlPcchIndToMac
621 * Functionality: Builds the Pcch RRC PDU[As per Spec 38.331, Annexure A]
622 * and forwards it to MAC as Buffer along with PF and i_s
624 * @params[in] uint16_t cellId, uint16_t pf, uint8_t i_s,CmLListCp *pageUeLL
626 * @return ROK - success
629 * ****************************************************************/
630 uint8_t BuildAndSendDlPcchIndToMac(uint16_t cellId, uint16_t pf, uint8_t i_s, CmLListCp *pageUeLL)
632 CmLList *node = NULLP, *next = NULLP;
633 DuPagUeRecord *ueRecord = NULLP;
634 PCCH_Message_t *pcchMsg = NULLP;
635 asn_enc_rval_t encRetVal;
636 PagingRrc_t *pagingMsg = NULLP;
637 DlPcchInd *macPcchInd = NULLP;
638 uint8_t recordIdx = 0, ret = RFAILED;
640 /*As per 38.473 Sec 9.3.1.39,5G-S-TMSI :48 Bits >> Bytes and 0 UnusedBits */
641 uint8_t totalByteInTmsi = 6, unusedBitsInTmsi = 0;
643 if(pageUeLL == NULLP || pageUeLL->count == 0)
645 DU_LOG("\nERROR --> DU APP: UE Page Record LL is empty");
651 memset(&encRetVal, 0, sizeof(asn_enc_rval_t));
652 DU_ALLOC(pcchMsg , sizeof(PCCH_Message_t));
655 DU_LOG("\nERROR --> DU APP: BuildAndSendDlPcchIndToMac(): (pccchMsg) Memory Alloction failed!");
658 pcchMsg->message.present = PCCH_MessageType_PR_c1;
659 DU_ALLOC(pcchMsg->message.choice.c1 , sizeof(PCCH_MessageType_t));
660 if(pcchMsg->message.choice.c1 == NULLP)
662 DU_LOG("\nERROR --> DU APP: BuildAndSendDlPcchIndToMac(); (C1) Memory Alloction failed!");
665 pcchMsg->message.choice.c1->present = PCCH_MessageType__c1_PR_paging;
666 DU_ALLOC(pcchMsg->message.choice.c1->choice.paging, sizeof(PagingRrc_t));
668 pagingMsg = pcchMsg->message.choice.c1->choice.paging;
669 if(pagingMsg == NULLP)
671 DU_LOG("\nERROR --> DU APP: BuildAndSendDlPcchIndToMac(); (Paging) Memory Alloction failed!");
674 DU_ALLOC(pagingMsg->pagingRecordList, sizeof(PagingRecordList_t));
675 if(pagingMsg->pagingRecordList == NULLP)
677 DU_LOG("\nERROR --> DU APP: BuildAndSendDlPcchIndToMac(); (Paging Record List) Memory Alloction failed!");
681 pagingMsg->pagingRecordList->list.count = pageUeLL->count;
683 /*As per Spec 38.331, maxNrofPageRec : 32 [Maximum number of page records]*/
684 if(pageUeLL->count > MAX_PAGING_UE_RECORDS)
686 pagingMsg->pagingRecordList->list.count = MAX_PAGING_UE_RECORDS;
689 pagingMsg->pagingRecordList->list.size = pageUeLL->count * (sizeof(PagingRecord_t *));
690 DU_ALLOC(pagingMsg->pagingRecordList->list.array, pagingMsg->pagingRecordList->list.size);
691 if(pagingMsg->pagingRecordList->list.array == NULLP)
693 DU_LOG("\nERROR --> DU APP: BuildAndSendDlPcchIndToMac(); (Array) Memory Alloction failed!");
696 for(recordIdx = 0; recordIdx < pageUeLL->count; recordIdx++)
698 DU_ALLOC(pagingMsg->pagingRecordList->list.array[recordIdx], sizeof(PagingRecord_t));
699 if(pagingMsg->pagingRecordList->list.array[recordIdx] == NULLP)
701 DU_LOG("\nERROR --> DU APP: BuildAndSendDlPcchIndToMac(); (Record) Memory Alloction failed!");
706 node = pageUeLL->first;
707 while(node && (recordIdx < MAX_PAGING_UE_RECORDS))
710 ueRecord = (DuPagUeRecord *)node->node;
713 /*TODO : When Connected Mode Paging will be supported then I_RNTI will be introduced*/
714 pagingMsg->pagingRecordList->list.array[recordIdx]->ue_Identity.present = PagingUE_Identity_PR_ng_5G_S_TMSI;
715 pagingMsg->pagingRecordList->list.array[recordIdx]->ue_Identity.choice.ng_5G_S_TMSI.size = totalByteInTmsi*sizeof(uint8_t);
716 DU_ALLOC(pagingMsg->pagingRecordList->list.array[recordIdx]->ue_Identity.choice.ng_5G_S_TMSI.buf,\
717 pagingMsg->pagingRecordList->list.array[recordIdx]->ue_Identity.choice.ng_5G_S_TMSI.size);
718 if(pagingMsg->pagingRecordList->list.array[recordIdx]->ue_Identity.choice.ng_5G_S_TMSI.buf == NULLP)
720 DU_LOG("\nERROR --> DU APP: BuildAndSendDlPcchIndToMac(); (5gsTmsi buffer) Memory Allocation failed!");
723 fillBitString(&pagingMsg->pagingRecordList->list.array[recordIdx]->ue_Identity.choice.ng_5G_S_TMSI,\
724 unusedBitsInTmsi, totalByteInTmsi, ueRecord->sTmsi);
728 if(duDelNodeFromLList(pageUeLL, node) == ROK)
729 DU_FREE(ueRecord, sizeof(DuPagUeRecord));
732 if(node != NULLP && (recordIdx < MAX_PAGING_UE_RECORDS))
734 /*This leg is hit because Whole UE REcord List was not traversed as
735 * some issue happened thus exiting the main while*/
738 xer_fprint(stdout, &asn_DEF_PCCH_Message, pcchMsg);
739 memset(encBuf, 0, ENC_BUF_MAX_LEN);
741 /* Encode the PCCH RRC PDU as APER */
742 encRetVal = uper_encode(&asn_DEF_PCCH_Message, 0, pcchMsg, PrepFinalEncBuf,\
745 if(encRetVal.encoded == ENCODE_FAIL)
747 DU_LOG("\nERROR --> F1AP : Could not encode Paging structure (at %s)\n",\
748 encRetVal.failed_type ? encRetVal.failed_type->name : "unknown");
753 DU_LOG("\nDEBUG --> F1AP : Created APER encoded buffer for RRC PDU for Pcch indication \n");
755 DU_ALLOC_SHRABL_BUF(macPcchInd, sizeof(DlPcchInd));
756 if(macPcchInd == NULLP)
758 DU_LOG("\nERROR --> DU APP: BuildAndSendDlPcchIndToMac(); (macPcchInd) Memory Alloction failed!");
762 macPcchInd->cellId = cellId;
764 macPcchInd->i_s = i_s;
765 macPcchInd->pduLen = encBufSize;
766 DU_ALLOC_SHRABL_BUF(macPcchInd->pcchPdu, macPcchInd->pduLen);
767 if(macPcchInd->pcchPdu == NULLP)
769 DU_LOG("\nERROR --> DU APP: BuildAndSendDlPcchIndToMac(); (PcchPDU) Memory Alloction failed!");
772 memcpy(macPcchInd->pcchPdu, encBuf, macPcchInd->pduLen);
773 ret = sendDlPcchIndToMac(macPcchInd);
776 DU_FREE_SHRABL_BUF(DU_APP_MEM_REGION, DU_POOL, macPcchInd->pcchPdu, macPcchInd->pduLen);
777 DU_FREE_SHRABL_BUF(DU_APP_MEM_REGION, DU_POOL, macPcchInd, sizeof(DlPcchInd));
784 freePcchPdu(pcchMsg);
788 /*******************************************************************
789 * @brief Keeping the record of Paging having a particular SFN and index associated
793 * Function : insertPagingRecord
795 * Functionality: Insert record of Paging assoc with particular SFN and index associated
797 * @params[in] DuCellCb* cellCb, uint16_t iterations
798 * DuPagingMsg rcvdF1apPagingParam
800 * @return ROK - success
803 * ****************************************************************/
804 uint8_t insertPagingRecord(DuCellCb* cellCb, DuPagingMsg *rcvdF1apPagingParam, uint16_t iterations)
806 uint16_t maxIterations = 0;
807 DuPagInfoList *pagInfoLLFromPF = NULLP;
808 DuPagUeList *pageUeLL = NULLP;
809 DuPagUeRecord *ueRecord = NULLP;
812 printPageList(&(cellCb->pagingInfoMap));
815 /*MAX Iteration : A UE can be paged at every T frames thus MAX determines
816 *how many Paging Frame(s) can be considered for Paging this UE*/
817 maxIterations = MAX_SFN/rcvdF1apPagingParam->T;
818 if(iterations >= maxIterations)
820 DU_LOG("\nERROR --> DU APP: MAX Iterations reached for UEID:%d, thus Paging is dropped!", rcvdF1apPagingParam->pagUeId);
824 /*[Step1]: Extracting the PF from the HasMap between PF and PagingInfoList*/
825 pagInfoLLFromPF = findPagingInfoFromMap(rcvdF1apPagingParam->pagingFrame, &(cellCb->pagingInfoMap));
826 if(pagInfoLLFromPF != NULLP)
828 /*[Step2]: Extracting the PageInfo List for the Paging Indices(i_s)*/
829 pageUeLL = handlePageInfoLL(rcvdF1apPagingParam->pagingFrame, rcvdF1apPagingParam->i_s, \
830 &(pagInfoLLFromPF->pagInfoList), CREATE);
832 if(pageUeLL != NULLP)
834 /*[Step3]: Check whether MAX UE Record against this PF and i_s has reached(Spec 38.331, Annexure A)*/
835 if(pageUeLL->pagUeList.count < MAX_PAGING_UE_RECORDS)
837 /*[Step4]: Insert the Paging Record to the end of the UE record List*/
838 ueRecord = handlePageUeLL(rcvdF1apPagingParam->pagUeId, rcvdF1apPagingParam->sTmsi,\
839 &(pageUeLL->pagUeList), CREATE);
841 if(ueRecord == NULLP)
843 DU_LOG("\nERROR --> DU APP: Unable to create UE Record in PagingList");
846 DU_LOG("\nDEBUG --> DU APP: UE Record created successfully in PagingList");
851 /*Since MAX Page record has reached for this PF thus calculating and
852 *moving this UE to next Paging Cycle*/
853 DU_LOG("\nINFO --> DU APP: Max Page Record reached for PagingFrame:%d",rcvdF1apPagingParam->pagingFrame);
854 rcvdF1apPagingParam->pagingFrame = ((rcvdF1apPagingParam->pagingFrame + rcvdF1apPagingParam->T) % MAX_SFN);
857 return insertPagingRecord(cellCb, rcvdF1apPagingParam, iterations);
861 /*Reaching here means that PF has no entry in the PageLists,
862 *Thus creating, Updating and inseritng the Paging Map, List and UE record.*/
864 DU_ALLOC(pagInfoLLFromPF, sizeof(DuPagInfoList));
866 if(pagInfoLLFromPF == NULLP)
868 DU_LOG("\nERROR --> DU APP: PageInfo Map allocation failed.");
871 pagInfoLLFromPF->pf = rcvdF1apPagingParam->pagingFrame;
872 pageUeLL = handlePageInfoLL(rcvdF1apPagingParam->pagingFrame, rcvdF1apPagingParam->i_s, &(pagInfoLLFromPF->pagInfoList), CREATE);
873 ueRecord = handlePageUeLL(rcvdF1apPagingParam->pagUeId, rcvdF1apPagingParam->sTmsi, &(pageUeLL->pagUeList), CREATE);
874 if(cmHashListInsert(&(cellCb->pagingInfoMap), (PTR)pagInfoLLFromPF, (uint8_t *)&(pagInfoLLFromPF->pf), sizeof(uint16_t)) == RFAILED)
876 DU_LOG("\nERROR --> DU APP: Hash Map Insertion Failed for PF:%d.",rcvdF1apPagingParam->pagingFrame);
880 printPageList(&(cellCb->pagingInfoMap));
888 /*******************************************************************
889 * @brief Calculate and fill paging information of a UE belongs to a particular cell
893 * Function : calcAndFillPagingInfoInCellCb
895 * Functionality: Calculate PO and i_s and
896 * fill paging information of a UE in DuCellCb
898 * @params[in] DuCellCb* cellCb, uint8_t pagUeId,
899 * DuPagingMsg rcvdF1apPagingParam
901 * @return ROK - success
904 * ****************************************************************/
905 uint8_t calcAndFillPagingInfoInCellCb(DuCellCb* cellCb, DuPagingMsg *rcvdF1apPagingParam)
908 uint16_t T=0, N=0, pagingFrame = 0, n = 0;
909 uint16_t currentSfn = 0, sfn = 0, newSfn = 0;
914 /* calculate paging frame and paging offset */
915 duPcchCfg = duCfgParam.sib1Params.srvCellCfgCommSib.dlCfg.pcchCfg;
916 rcvdF1apPagingParam->pagingFrameOffset = duPcchCfg.pageFrameOffset;
920 * Fill the Value of T (DRX cycle of the UE)
921 * T = min(UE Specific DRX value allocated by upper layers, default DRX
922 * broadcast in System Information) */
923 if((rcvdF1apPagingParam->pagingDrxPres) && (duPcchCfg.dfltPagingCycle > rcvdF1apPagingParam->pagingDrx))
925 T = rcvdF1apPagingParam->pagingDrx;
929 T = duPcchCfg.dfltPagingCycle;
931 rcvdF1apPagingParam->T = T;
933 /* N= number of total paging frames in T */
935 switch(duPcchCfg.nAndPagingFrmOffsetType)
937 case PCCH_Config__nAndPagingFrameOffset_PR_oneT:
940 case PCCH_Config__nAndPagingFrameOffset_PR_halfT:
943 case PCCH_Config__nAndPagingFrameOffset_PR_quarterT:
946 case PCCH_Config__nAndPagingFrameOffset_PR_oneEighthT:
949 case PCCH_Config__nAndPagingFrameOffset_PR_oneSixteenthT:
957 /* calculate the Value of pagingFrame */
958 /*Refer: 38.304 Sec 7.1: (SFN + PF_offset) mod T = (T div N)*(UE_ID mod N)*/
959 //RHS of above formula
960 pagingFrame = (T / N) * ((rcvdF1apPagingParam->pagUeId) % N);
962 //LHS of above formula
965 pagingFrame = (pagingFrame - rcvdF1apPagingParam->pagingFrameOffset)%T;
967 else /*Paging Frame = 0 so thus PF will be calculated on Paging Cycle*/
969 pagingFrame = (T - rcvdF1apPagingParam->pagingFrameOffset)%T;
972 /*Paging Frame(SFN for Paging) has to be determined from current SFN. */
973 /*For eg: If T =128, PF(Calculated above) = 20; SFN can be 20,148,276,...
974 * If currSFN is running as 200 then (newSFN % T) == (T/N)*(UE_ID%N)
975 *Thus SFN at which paging has to be sent needs to be delayed and newSFN = 276*/
977 currentSfn = cellCb->currSlotInfo.sfn;
979 /*Multiplication Factor(x) to find the next best SFN to process paging*/
981 /*Below calculation will determine in which nth cycle of T (DRX cycle),new PF
982 * may fall(Delayed one)*/
983 if(currentSfn > pagingFrame)
985 n = ((currentSfn - pagingFrame) / T) + 1;
989 n = ((pagingFrame - currentSfn) / T) + 1;
992 newSfn = pagingFrame + T * n;
994 /*When pagingFrame is future from currSFN then pagingFrame will be used
995 * else pagingFrame is delayed thus newSFN will be used.*/
996 if(currentSfn <= pagingFrame)
998 if(pagingFrame > currentSfn + PAGING_SCHED_DELTA)
1010 if(newSfn > currentSfn + PAGING_SCHED_DELTA)
1014 else /*If newSFN is near to currSFN then delay it more by T*/
1016 newSfn = newSfn + T;
1020 rcvdF1apPagingParam->pagingFrame = (sfn % MAX_SFN);
1021 rcvdF1apPagingParam->i_s = ((uint32_t)(floor(rcvdF1apPagingParam->pagUeId / N)) % ns);
1023 memcpy(&cellCb->tmpPagingInfoOfUe, rcvdF1apPagingParam, sizeof(DuPagingMsg));
1027 DU_LOG("\nINFO --> DU APP : calcAndFillPagingInfoInCellCb(): Received null pointer");
1033 /*******************************************************************
1034 * @brief Paging Processing on a particular cell
1038 * Function : processPagingMsg
1040 * Functionality: Process Paging on a particular cell
1042 * @params[in] uint16_t cellId
1043 * DuPagingMsg rcvdF1apPagingParam
1045 * @return ROK - success
1048 * ****************************************************************/
1049 uint8_t processPagingMsg(uint16_t cellId, DuPagingMsg *rcvdF1apPagingParam)
1051 uint16_t cellIdx = 0, iteration = 0;
1053 GET_CELL_IDX(cellId, cellIdx);
1055 if(duCb.actvCellLst[cellIdx] == NULLP || duCb.actvCellLst[cellIdx]->cellId != cellId)
1057 DU_LOG("\nERROR --> DU APP : processPagingMsg(): CellId[%d] is not found", cellId);
1061 if(calcAndFillPagingInfoInCellCb(duCb.actvCellLst[cellIdx], rcvdF1apPagingParam) != ROK)
1063 DU_LOG("\nERROR --> DU APP : CellCb:%d not present to fill UE Paging Information",cellId);
1066 if(insertPagingRecord(duCb.actvCellLst[cellIdx], rcvdF1apPagingParam, iteration) != ROK)
1068 DU_LOG("\nERROR --> DU APP : Insertion Failed ofUE Paging Information");
1075 /*******************************************************************
1077 * @brief DU build and send dl broacast req and send it to MAC
1081 * Function : duBuildAndSendDlBroadcastReq
1083 * Functionality: DU build and send dl broacast req and send to MAC
1086 * @params[in] cellId, crnti
1087 * @return ROK - success
1090 * ****************************************************************/
1092 uint8_t duBuildAndSendDlBroadcastReq()
1096 MacDlBroadcastReq *dlBroadcast=NULLP;
1098 DU_LOG("\nDEBUG --> DU_APP : Building Dl broadcast request");
1100 DU_ALLOC_SHRABL_BUF(dlBroadcast, sizeof(MacDlBroadcastReq));
1103 /*TODO - fill MAC DL Broadcast Request*/
1105 FILL_PST_DUAPP_TO_MAC(pst, EVENT_MAC_DL_BROADCAST_REQ);
1107 DU_LOG("\nDEBUG --> DU_APP: Sending Dl broadcast Request to MAC ");
1108 ret = (*packMacDlBroadcastReqOpts[pst.selector])(&pst, dlBroadcast);
1111 DU_LOG("\nERROR --> DU_APP: sendDlBroadcastReqToMac(): Failed to send Dl broadcast Req to MAC");
1112 DU_FREE_SHRABL_BUF(DU_APP_MEM_REGION, DU_POOL, dlBroadcast, sizeof(MacDlBroadcastReq));
1117 DU_LOG("\nERROR --> DU_APP: sendDlBroadcastReqToMac(): Failed to allocate memory");
1124 /**********************************************************************
1126 **********************************************************************/