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 /* header include files -- defines (.h) */
20 #include "common_def.h"
23 #include "du_app_mac_inf.h"
24 #include "mac_sch_interface.h"
25 #include "rlc_mac_inf.h"
26 #include "mac_upr_inf_api.h"
29 #include "fapi_interface.h"
31 #include "lwr_mac_fsm.h"
32 #include "lwr_mac_upr_inf.h"
34 #include "mac_utils.h"
36 /* This file contains message handling functionality for MAC */
40 uint16_t buildMacPdu(RlcData *dlData);
42 void macStubBuildUlData(Buffer *mBuf);
45 /* Function pointer for sending crc ind from MAC to SCH */
46 MacSchCrcIndFunc macSchCrcIndOpts[]=
53 /* Function pointer for sending DL RLC BO Info from MAC to SCH */
54 MacSchDlRlcBoInfoFunc macSchDlRlcBoInfoOpts[]=
56 packMacSchDlRlcBoInfo,
61 /* Function pointer for sending short BSR from MAC to SCH */
62 MacSchBsrFunc macSchBsrOpts[]=
69 /* Function pointer for sending SR Uci ind from MAC to SCH */
70 MacSchSrUciIndFunc macSchSrUciIndOpts[]=
77 /*******************************************************************
79 * @brief Sends DL BO Info to SCH
83 * Function : sendDlRlcBoInfoToSch
86 * Sends DL BO Info to SCH
89 * @return ROK - success
92 ****************************************************************/
93 uint8_t sendDlRlcBoInfoToSch(DlRlcBoInfo *dlBoInfo)
97 FILL_PST_MAC_TO_SCH(pst, EVENT_DL_RLC_BO_INFO_TO_SCH);
98 return(*macSchDlRlcBoInfoOpts[pst.selector])(&pst, dlBoInfo);
101 /*******************************************************************
103 * @brief Sends CRC Indication to SCH
107 * Function : sendCrcIndMacToSch
110 * Sends CRC Indication to SCH
113 * @return ROK - success
116 ****************************************************************/
117 uint8_t sendCrcIndMacToSch(CrcIndInfo *crcInd)
121 FILL_PST_MAC_TO_SCH(pst, EVENT_CRC_IND_TO_SCH);
122 return(*macSchCrcIndOpts[pst.selector])(&pst, crcInd);
125 /*******************************************************************
127 * @brief Processes CRC Indication from PHY
131 * Function : fapiMacCrcInd
134 * Processes CRC Indication from PHY
136 * @params[in] Post Structure Pointer
137 * Crc Indication Pointer
138 * @return ROK - success
141 * ****************************************************************/
142 uint8_t fapiMacCrcInd(Pst *pst, CrcInd *crcInd)
145 CrcIndInfo crcIndInfo;
146 DU_LOG("\nDEBUG --> MAC : Received CRC indication");
147 GET_CELL_IDX(crcInd->cellId, cellIdx);
148 /* Considering one pdu and one preamble */
149 crcIndInfo.cellId = macCb.macCell[cellIdx]->cellId;
150 crcIndInfo.crnti = crcInd->crcInfo[0].rnti;
151 crcIndInfo.timingInfo.sfn = crcInd->timingInfo.sfn;
152 crcIndInfo.timingInfo.slot = crcInd->timingInfo.slot;
153 crcIndInfo.numCrcInd = crcInd->crcInfo[0].numCb;
154 crcIndInfo.crcInd[0] = crcInd->crcInfo[0].cbCrcStatus[0];
156 MAC_FREE_SHRABL_BUF(pst->region, pst->pool, crcInd, sizeof(CrcInd));
157 return(sendCrcIndMacToSch(&crcIndInfo));
160 /*******************************************************************
162 * @brief Process Rx Data Ind at MAC
166 * Function : fapiMacRxDataInd
169 * Process Rx Data Ind at MAC
171 * @params[in] Post structure
173 * @return ROK - success
176 * ****************************************************************/
177 uint8_t fapiMacRxDataInd(Pst *pst, RxDataInd *rxDataInd)
180 DU_LOG("\nDEBUG --> MAC : Received Rx Data indication");
181 /* TODO : compare the handle received in RxDataInd with handle send in PUSCH
182 * PDU, which is stored in raCb */
184 for(pduIdx = 0; pduIdx < rxDataInd->numPdus; pduIdx++)
186 unpackRxData(rxDataInd->cellId, rxDataInd->timingInfo, &rxDataInd->pdus[pduIdx]);
187 MAC_FREE_SHRABL_BUF(pst->region, pst->pool, rxDataInd->pdus[pduIdx].pduData,\
188 rxDataInd->pdus[pduIdx].pduLength);
190 MAC_FREE_SHRABL_BUF(pst->region, pst->pool, rxDataInd, sizeof(RxDataInd));
194 /*******************************************************************
196 * @brief Processes DL data from RLC
200 * Function : MacProcRlcDlData
203 * Processes DL data from RLC
205 * @params[in] Post structure
207 * @return ROK - success
210 * ****************************************************************/
211 uint8_t MacProcRlcDlData(Pst* pstInfo, RlcData *dlData)
215 uint8_t *txPdu =NULLP;
218 MacDlSlot *currDlSlot = NULLP;
219 DlRlcBoInfo dlBoInfo;
221 memset(&macDlData , 0, sizeof(MacDlData));
222 DU_LOG("\nDEBUG --> MAC: Received DL data for sfn=%d slot=%d numPdu= %d", \
223 dlData->slotInfo.sfn, dlData->slotInfo.slot, dlData->numPdu);
224 /* Copy the pdus to be muxed into mac Dl data */
225 macDlData.numPdu = dlData->numPdu;
226 for(pduIdx = 0; pduIdx < dlData->numPdu; pduIdx++)
228 macDlData.pduInfo[pduIdx].lcId = dlData->pduInfo[pduIdx].lcId;
229 macDlData.pduInfo[pduIdx].pduLen = dlData->pduInfo[pduIdx].pduLen;
230 macDlData.pduInfo[pduIdx].dlPdu = dlData->pduInfo[pduIdx].pduBuf;
233 /* Store DL data in the scheduled slot */
234 currDlSlot = &macCb.macCell[dlData->cellId -1]->dlSlot[dlData->slotInfo.slot];
237 if(currDlSlot->dlInfo.dlMsgAlloc)
239 tbSize = currDlSlot->dlInfo.dlMsgAlloc->dlMsgPdschCfg.codeword[0].tbSize;
240 MAC_ALLOC(txPdu, tbSize);
243 DU_LOG("\nERROR --> MAC : Memory allocation failed in MacProcRlcDlData");
246 macMuxPdu(&macDlData, NULLP, txPdu, tbSize);
248 currDlSlot->dlInfo.dlMsgAlloc->dlMsgInfo.dlMsgPduLen = tbSize;
249 currDlSlot->dlInfo.dlMsgAlloc->dlMsgInfo.dlMsgPdu = txPdu;
253 for(lcIdx = 0; lcIdx < dlData->numLc; lcIdx++)
255 if(dlData->boStatus[lcIdx].bo)
257 memset(&dlBoInfo, 0, sizeof(DlRlcBoInfo));
258 dlBoInfo.cellId = dlData->boStatus[lcIdx].cellId;
259 GET_CRNTI(dlBoInfo.crnti, dlData->boStatus[lcIdx].ueIdx);
260 dlBoInfo.lcId = dlData->boStatus[lcIdx].lcId;
261 dlBoInfo.dataVolume = dlData->boStatus[lcIdx].bo;
262 sendDlRlcBoInfoToSch(&dlBoInfo);
267 for(pduIdx = 0; pduIdx < dlData->numPdu; pduIdx++)
269 MAC_FREE_SHRABL_BUF(pstInfo->region, pstInfo->pool, dlData->pduInfo[pduIdx].pduBuf,\
270 dlData->pduInfo[pduIdx].pduLen);
272 if(pstInfo->selector == ODU_SELECTOR_LWLC)
274 MAC_FREE_SHRABL_BUF(pstInfo->region, pstInfo->pool, dlData, sizeof(RlcData));
279 /*******************************************************************
281 * @brief Builds and Sends UL Data to RLC
285 * Function : macProcUlData
287 * Functionality: Builds and Sends UL Data to RLC
292 * LC Id on which payload was received
293 * Pointer to the payload
295 * @return ROK - success
298 * ****************************************************************/
299 uint8_t macProcUlData(uint16_t cellId, uint16_t rnti, SlotIndInfo slotInfo, \
300 uint8_t lcId, uint16_t pduLen, uint8_t *pdu)
305 /* Filling RLC Ul Data*/
306 MAC_ALLOC_SHRABL_BUF(ulData, sizeof(RlcData));
309 DU_LOG("\nERROR --> MAC : Memory allocation failed while sending UL data to RLC");
312 memset(ulData, 0, sizeof(RlcData));
313 ulData->cellId = cellId;
315 memcpy(&ulData->slotInfo, &slotInfo, sizeof(SlotIndInfo));
316 ulData->slotInfo.cellId = cellId;
318 /* Filling pdu info */
319 if(lcId == SRB1_LCID || lcId == SRB2_LCID)
321 ulData->pduInfo[ulData->numPdu].commCh = true;
323 ulData->pduInfo[ulData->numPdu].lcId = lcId;
324 ulData->pduInfo[ulData->numPdu].pduBuf = pdu;
325 ulData->pduInfo[ulData->numPdu].pduLen = pduLen;
328 /* Filling Post and send to RLC */
329 memset(&pst, 0, sizeof(Pst));
330 FILL_PST_MAC_TO_RLC(pst, 0, EVENT_UL_DATA_TO_RLC);
331 MacSendUlDataToRlc(&pst, ulData);
337 /*******************************************************************
339 * @brief Processes BO status from RLC
343 * Function : MacProcRlcBOStatus
346 * Processes BO status from RLC
348 * @params[in] Post structure
350 * @return ROK - success
353 * ****************************************************************/
354 uint8_t MacProcRlcBoStatus(Pst* pst, RlcBoStatus* boStatus)
356 DlRlcBoInfo dlBoInfo;
358 dlBoInfo.cellId = boStatus->cellId;
359 GET_CRNTI(dlBoInfo.crnti, boStatus->ueIdx);
360 dlBoInfo.lcId = boStatus->lcId;
361 dlBoInfo.dataVolume = boStatus->bo;
363 sendDlRlcBoInfoToSch(&dlBoInfo);
365 if(pst->selector == ODU_SELECTOR_LWLC)
367 MAC_FREE_SHRABL_BUF(pst->region, pst->pool, boStatus, sizeof(RlcBoStatus));
373 /*******************************************************************
375 * @brief Send LC schedule result report to RLC
379 * Function : sendSchRptToRlc
381 * Functionality: Send LC schedule result report to RLC
384 * @return ROK - success
387 * ****************************************************************/
388 uint8_t sendSchedRptToRlc(DlSchedInfo dlInfo, SlotIndInfo slotInfo)
392 RlcSchedResultRpt *schedRpt = NULLP;
394 MAC_ALLOC_SHRABL_BUF(schedRpt, sizeof(RlcSchedResultRpt));
397 DU_LOG("\nERROR --> MAC: Memory allocation failure in sendSchResultRepToRlc");
401 DU_LOG("\nDEBUG --> MAC: Send scheduled result report for sfn %d slot %d", slotInfo.sfn, slotInfo.slot);
402 schedRpt->cellId = dlInfo.cellId;
403 schedRpt->rnti = dlInfo.dlMsgAlloc->crnti;
404 schedRpt->numLc = dlInfo.dlMsgAlloc->numLc;
405 schedRpt->slotInfo.sfn = slotInfo.sfn;
406 schedRpt->slotInfo.slot = slotInfo.slot;
408 for(lcIdx = 0; lcIdx < schedRpt->numLc; lcIdx++)
410 schedRpt->lcSch[lcIdx].lcId = dlInfo.dlMsgAlloc->lcSchInfo[lcIdx].lcId;
411 schedRpt->lcSch[lcIdx].bufSize = dlInfo.dlMsgAlloc->lcSchInfo[lcIdx].schBytes;
412 schedRpt->lcSch[lcIdx].commCh = false;
416 FILL_PST_MAC_TO_RLC(pst, RLC_DL_INST, EVENT_SCHED_RESULT_TO_RLC);
417 if(MacSendSchedResultRptToRlc(&pst, schedRpt) != ROK)
419 DU_LOG("\nERROR --> MAC: Failed to send Schedule result report to RLC");
420 MAC_FREE_SHRABL_BUF(MAC_MEM_REGION, MAC_POOL, schedRpt, sizeof(RlcSchedResultRpt));
427 /*******************************************************************
429 * @brief Handles cell start reuqest from DU APP
433 * Function : MacProcCellStart
436 * Handles cell start reuqest from DU APP
438 * @params[in] Post structure pointer
440 * @return ROK - success
443 * ****************************************************************/
444 uint8_t MacProcCellStart(Pst *pst, OduCellId *cellId)
446 DU_LOG("\nINFO --> MAC : Handling cell start request");
448 sendToLowerMac(START_REQUEST, 0, cellId);
450 MAC_FREE_SHRABL_BUF(pst->region, pst->pool, cellId, \
456 /*******************************************************************
458 * @brief Handles cell stop from DU APP
462 * Function : MacProcCellStop
465 * Handles cell stop from DU APP
467 * @params[in] Post structure pointer
469 * @return ROK - success
472 * ****************************************************************/
473 uint8_t MacProcCellStop(Pst *pst, OduCellId *cellId)
477 SlotIndInfo slotInfo;
479 DU_LOG("\nINFO --> MAC : Sending cell stop request to Lower Mac");
480 GET_CELL_IDX(cellId->cellId, cellIdx);
481 slotInfo.cellId = cellId->cellId;
482 slotInfo.sfn = macCb.macCell[cellIdx]->currTime.sfn;
483 slotInfo.slot = macCb.macCell[cellIdx]->currTime.slot;
484 sendToLowerMac(FAPI_STOP_REQUEST, 0, &slotInfo);
487 MAC_FREE_SHRABL_BUF(pst->region, pst->pool, cellId, \
493 /*******************************************************************
495 * @brief Handles DL CCCH Ind from DU APP
499 * Function : MacProcDlCcchInd
502 * Handles DL CCCH Ind from DU APP
504 * @params[in] Post structure pointer
505 * DL CCCH Ind pointer
506 * @return ROK - success
509 * ****************************************************************/
510 uint8_t MacProcDlCcchInd(Pst *pst, DlCcchIndInfo *dlCcchIndInfo)
515 DlRlcBoInfo dlBoInfo;
516 memset(&dlBoInfo, 0, sizeof(DlRlcBoInfo));
518 DU_LOG("\nDEBUG --> MAC : Handling DL CCCH IND");
520 GET_CELL_IDX(dlCcchIndInfo->cellId, cellIdx);
522 dlBoInfo.cellId = dlCcchIndInfo->cellId;
523 dlBoInfo.crnti = dlCcchIndInfo->crnti;
525 if(dlCcchIndInfo->msgType == RRC_SETUP)
527 dlBoInfo.lcId = SRB0_LCID; // SRB ID 0 for msg4
528 dlBoInfo.dataVolume = dlCcchIndInfo->dlCcchMsgLen;
530 /* storing Msg4 Pdu in raCb */
531 GET_UE_IDX(dlBoInfo.crnti, ueIdx);
533 if(macCb.macCell[cellIdx]->macRaCb[ueIdx].crnti == dlCcchIndInfo->crnti)
535 macCb.macCell[cellIdx]->macRaCb[ueIdx].msg4PduLen = dlCcchIndInfo->dlCcchMsgLen;
536 MAC_ALLOC(macCb.macCell[cellIdx]->macRaCb[ueIdx].msg4Pdu, \
537 macCb.macCell[cellIdx]->macRaCb[ueIdx].msg4PduLen);
538 if(macCb.macCell[cellIdx]->macRaCb[ueIdx].msg4Pdu)
540 for(idx = 0; idx < dlCcchIndInfo->dlCcchMsgLen; idx++)
542 macCb.macCell[cellIdx]->macRaCb[ueIdx].msg4Pdu[idx] =\
543 dlCcchIndInfo->dlCcchMsg[idx];
548 sendDlRlcBoInfoToSch(&dlBoInfo);
550 MAC_FREE_SHRABL_BUF(pst->region, pst->pool, dlCcchIndInfo->dlCcchMsg, \
551 dlCcchIndInfo->dlCcchMsgLen);
552 MAC_FREE_SHRABL_BUF(pst->region, pst->pool, dlCcchIndInfo, sizeof(DlCcchIndInfo));
557 /*******************************************************************
559 * @brief Sends UL CCCH Ind to DU APP
563 * Function : macProcUlCcchInd
566 * MAC sends UL CCCH Ind to DU APP
568 * @params[in] Post structure pointer
570 * @return ROK - success
573 * ****************************************************************/
574 uint8_t macProcUlCcchInd(uint16_t cellId, uint16_t crnti, uint16_t rrcContSize, uint8_t *rrcContainer)
578 UlCcchIndInfo *ulCcchIndInfo = NULLP;
580 MAC_ALLOC_SHRABL_BUF(ulCcchIndInfo, sizeof(UlCcchIndInfo));
583 DU_LOG("\nERROR --> MAC: Memory failed in macProcUlCcchInd");
587 ulCcchIndInfo->cellId = cellId;
588 ulCcchIndInfo->crnti = crnti;
589 ulCcchIndInfo->ulCcchMsgLen = rrcContSize;
590 ulCcchIndInfo->ulCcchMsg = rrcContainer;
593 FILL_PST_MAC_TO_DUAPP(pst, EVENT_MAC_UL_CCCH_IND);
595 if(MacDuAppUlCcchInd(&pst, ulCcchIndInfo) != ROK)
597 DU_LOG("\nERROR --> MAC: Failed to send UL CCCH Ind to DU APP");
598 MAC_FREE_SHRABL_BUF(MAC_MEM_REGION, MAC_POOL, ulCcchIndInfo->ulCcchMsg, ulCcchIndInfo->ulCcchMsgLen);
599 MAC_FREE_SHRABL_BUF(MAC_MEM_REGION, MAC_POOL, ulCcchIndInfo, sizeof(UlCcchIndInfo));
605 /*******************************************************************
607 * @brief Processes received short BSR
611 * Function : macProcShortBsr
614 * MAC sends Short BSR to SCH
616 * @params[in] cell ID
622 * ****************************************************************/
623 uint8_t macProcShortBsr(uint16_t cellId, uint16_t crnti, uint8_t lcgId, uint32_t bufferSize)
626 UlBufferStatusRptInd bsrInd;
628 memset(&pst, 0, sizeof(Pst));
629 memset(&bsrInd, 0, sizeof(UlBufferStatusRptInd));
631 bsrInd.cellId = cellId;
632 bsrInd.crnti = crnti;
633 bsrInd.bsrType = SHORT_BSR;
634 bsrInd.numLcg = 1; /* short bsr reports one lcg at a time */
635 bsrInd.dataVolInfo[0].lcgId = lcgId;
636 bsrInd.dataVolInfo[0].dataVol = bufferSize;
638 FILL_PST_MAC_TO_SCH(pst, EVENT_SHORT_BSR);
639 return(*macSchBsrOpts[pst.selector])(&pst, &bsrInd);
642 /*******************************************************************
644 * @brief Builds and send SR UCI Indication to SCH
648 * Function : buildAndSendSrInd
651 * Builds and send SR UCI Indication to SCH
653 * @params[in] SrUciIndInfo Pointer
655 * @return ROK - success
658 * ****************************************************************/
659 uint8_t buildAndSendSrInd(UciInd *macUciInd, uint8_t crnti)
663 SrUciIndInfo srUciInd;
664 memset(&pst, 0, sizeof(Pst));
665 memset(&srUciInd, 0, sizeof(SrUciIndInfo));
667 GET_CELL_IDX(macUciInd->cellId, cellIdx);
668 srUciInd.cellId = macCb.macCell[cellIdx]->cellId;
669 srUciInd.crnti = crnti;
670 srUciInd.slotInd.sfn = macUciInd->slotInd.sfn;
671 srUciInd.slotInd.slot = macUciInd->slotInd.slot;
672 srUciInd.numSrBits++;
673 memset(srUciInd.srPayload, 0, MAX_SR_BITS_IN_BYTES);
676 FILL_PST_MAC_TO_SCH(pst, EVENT_UCI_IND_TO_SCH);
678 return(*macSchSrUciIndOpts[pst.selector])(&pst, &srUciInd);
681 /*******************************************************************
683 * @brief Processes UCI Indication from PHY
687 * Function : fapiMacUciInd
690 * Processes UCI Indication from PHY
692 * @params[in] Post Structure Pointer
693 * UCI Indication Pointer
694 * @return ROK - success
697 * ****************************************************************/
698 uint8_t FapiMacUciInd(Pst *pst, UciInd *macUciInd)
707 nPdus = macUciInd->numUcis;
710 switch(macUciInd->pdus[pduIdx].pduType)
714 case UCI_IND_PUCCH_F0F1:
715 if(macUciInd->pdus[pduIdx].uci.uciPucchF0F1.srInfo.srIndPres)
717 DU_LOG("\nDEBUG --> MAC : Received SR UCI indication");
718 crnti = macUciInd->pdus[pduIdx].uci.uciPucchF0F1.crnti;
719 ret = buildAndSendSrInd(macUciInd, crnti);
722 case UCI_IND_PUCCH_F2F3F4:
725 DU_LOG("\nERROR --> MAC: Invalid Pdu Type %d at FapiMacUciInd", macUciInd->pdus[pduIdx].pduType);
735 DU_LOG("\nERROR --> MAC: Received Uci Ind is NULL at FapiMacUciInd()");
738 MAC_FREE_SHRABL_BUF(pst->region, pst->pool, macUciInd, sizeof(UciInd));
743 /**********************************************************************
745 **********************************************************************/