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 "envopt.h" /* environment options */
21 #include "envdep.h" /* environment dependent */
22 #include "envind.h" /* environment independent */
23 #include "gen.h" /* general layer */
24 #include "ssi.h" /* system services */
25 #include "cm5.h" /* common timers defines */
26 #include "cm_hash.h" /* common hash list defines */
27 #include "cm_llist.h" /* common linked list defines */
28 #include "cm_mblk.h" /* memory management */
29 #include "cm_tkns.h" /* common tokens */
30 #include "cm_lte.h" /* common tokens */
33 #include "rg_sch_inf.h"
41 /* header/extern include files (.x) */
42 #include "gen.x" /* general layer typedefs */
43 #include "ssi.x" /* system services typedefs */
44 #include "cm5.x" /* common timers */
45 #include "cm_hash.x" /* common hash list */
46 #include "cm_lib.x" /* common library */
47 #include "cm_llist.x" /* common linked list */
48 #include "cm_mblk.x" /* memory management */
49 #include "cm_tkns.x" /* common tokens */
50 #include "cm_lte.x" /* common tokens */
53 #include "rg_sch_inf.x"
57 #include "du_app_mac_inf.h"
58 #include "mac_upr_inf_api.h"
60 #include "lwr_mac_fsm.h"
63 /* This file contains message handling functionality for MAC */
67 extern void sendToLowerMac(uint16_t msgType, uint32_t msgLen, void *msg);
68 uint16_t buildMacPdu(RlcMacData *dlData);
70 /* Function pointer for sending crc ind from MAC to SCH */
71 MacSchCrcIndFunc macSchCrcIndOpts[]=
78 /* Function pointer for sending DL RLC BO Info from MAC to SCH */
79 MacSchDlRlcBoInfoFunc macSchDlRlcBoInfoOpts[]=
81 packMacSchDlRlcBoInfo,
86 /*******************************************************************
88 * @brief Sends DL BO Info to SCH
92 * Function : sendDlRlcBoInfoMacToSch
95 * Sends DL BO Info to SCH
98 * @return ROK - success
101 ****************************************************************/
102 int sendDlRlcBoInfoMacToSch(DlRlcBOInfo *dlBoInfo)
106 fillMacToSchPst(&pst);
107 pst.event = EVENT_DL_RLC_BO_INFO_TO_SCH;
109 return(*macSchDlRlcBoInfoOpts[pst.selector])(&pst, dlBoInfo);
112 /*******************************************************************
114 * @brief Sends CRC Indication to SCH
118 * Function : sendCrcIndMacToSch
121 * Sends CRC Indication to SCH
124 * @return ROK - success
127 ****************************************************************/
128 int sendCrcIndMacToSch(CrcIndInfo *crcInd)
132 fillMacToSchPst(&pst);
133 pst.event = EVENT_CRC_IND_TO_SCH;
135 return(*macSchCrcIndOpts[pst.selector])(&pst, crcInd);
138 /*******************************************************************
140 * @brief Processes CRC Indication from PHY
144 * Function : fapiMacCrcInd
147 * Processes CRC Indication from PHY
149 * @params[in] Post Structure Pointer
150 * Crc Indication Pointer
151 * @return ROK - success
154 * ****************************************************************/
155 uint16_t fapiMacCrcInd(Pst *pst, CrcInd *crcInd)
157 CrcIndInfo crcIndInfo;
159 DU_LOG("\nMAC : Received CRC indication");
161 /* Considering one pdu and one preamble */
162 crcIndInfo.cellId = macCb.macCell->cellId;;
163 crcIndInfo.crnti = crcInd->crcInfo[0].rnti;
164 crcIndInfo.timingInfo.sfn = crcInd->timingInfo.sfn;
165 crcIndInfo.timingInfo.slot = crcInd->timingInfo.slot;
166 crcIndInfo.numCrcInd = crcInd->crcInfo[0].numCb;
167 crcIndInfo.crcInd[0] = crcInd->crcInfo[0].cbCrcStatus[0];
169 return(sendCrcIndMacToSch(&crcIndInfo));
172 /*******************************************************************
174 * @brief Process Rx Data Ind at MAC
178 * Function : fapiMacRxDataInd
181 * Process Rx Data Ind at MAC
183 * @params[in] Post structure
185 * @return ROK - success
188 * ****************************************************************/
189 uint16_t fapiMacRxDataInd(Pst *pst, RxDataInd *rxDataInd)
193 DU_LOG("\nMAC : Received Rx Data indication");
194 for(pduIdx = 0; pduIdx < rxDataInd->numPdus; pduIdx++)
196 unpackRxData(rxDataInd->timingInfo, &rxDataInd->pdus[pduIdx]);
201 /*******************************************************************
203 * @brief Processes DL data from RLC
207 * Function : MacRlcProcDlData
210 * Processes DL data from RLC
212 * @params[in] Post structure
214 * @return ROK - success
217 * ****************************************************************/
218 uint16_t MacRlcProcDlData(Pst* pst, SpId spId, RlcMacData *dlData)
223 /*******************************************************************
225 * @brief Processes BO status from RLC
229 * Function : MacRlcProcBOStatus
232 * Processes BO status from RLC
234 * @params[in] Post structure
236 * @return ROK - success
239 * ****************************************************************/
240 uint16_t MacRlcProcBOStatus(Pst* pst, SpId spId, RlcMacBOStatus* boStatus)
246 /*******************************************************************
248 * @brief Handles cell start reuqest from DU APP
252 * Function : MacHdlCellStartReq
255 * Handles cell start reuqest from DU APP
257 * @params[in] Post structure pointer
258 * Cell Start Request info pointer
259 * @return ROK - success
262 * ****************************************************************/
263 uint16_t MacHdlCellStartReq(Pst *pst, MacCellStartInfo *cellStartInfo)
265 DU_LOG("\nMAC : Handling cell start request");
266 sendToLowerMac(START_REQUEST, 0, cellStartInfo);
268 MAC_FREE_SHRABL_BUF(pst->region, pst->pool, cellStartInfo, \
269 sizeof(MacCellStartInfo));
274 /*******************************************************************
276 * @brief Handles cell stop request from DU APP
280 * Function : MacHdlCellStartReq
283 * Handles cell stop request from DU APP
285 * @params[in] Post structure pointer
286 * Mac Cell stop information
287 * @return ROK - success
290 * ****************************************************************/
291 uint16_t MacHdlCellStopReq(Pst *pst, MacCellStopInfo *cellStopInfo)
294 DU_LOG("\nMAC : Sending cell stop request to Lower Mac");
295 sendToLowerMac(FAPI_STOP_REQUEST, 0, cellStopInfo);
298 MAC_FREE_SHRABL_BUF(pst->region, pst->pool, cellStopInfo, \
299 sizeof(MacCellStopInfo));
304 /*******************************************************************
306 * @brief Handles DL CCCH Ind from DU APP
310 * Function : MacHdlDlCcchInd
313 * Handles DL CCCH Ind from DU APP
315 * @params[in] Post structure pointer
316 * DL CCCH Ind pointer
317 * @return ROK - success
320 * ****************************************************************/
321 uint16_t MacHdlDlCcchInd(Pst *pst, DlCcchIndInfo *dlCcchIndInfo)
323 DlRlcBOInfo dlBoInfo;
325 DU_LOG("\nMAC : Handling DL CCCH IND");
327 /* TODO : Fill DL RLC Buffer status info */
328 dlBoInfo.cellId = dlCcchIndInfo->cellId;
329 dlBoInfo.crnti = dlCcchIndInfo->crnti;
332 if(dlCcchIndInfo->msgType == RRC_SETUP)
335 dlBoInfo.boInfo[dlBoInfo.numLc].lcId = 0; // SRB 0 for msg4
336 dlBoInfo.boInfo[dlBoInfo.numLc].dataVolume = \
337 strlen((const char*)dlCcchIndInfo->dlCcchMsg);
339 /* storing Msg4 Pdu in raCb */
340 if(macCb.macCell->macRaCb[0].crnti == dlCcchIndInfo->crnti)
342 macCb.macCell->macRaCb[0].msg4PduLen = strlen((const char*)dlCcchIndInfo\
344 MAC_ALLOC(macCb.macCell->macRaCb[0].msg4Pdu, macCb.macCell->macRaCb[0]\
346 if(macCb.macCell->macRaCb[0].msg4Pdu)
348 memcpy(macCb.macCell->macRaCb[0].msg4Pdu, dlCcchIndInfo->dlCcchMsg,\
349 macCb.macCell->macRaCb[0].msg4PduLen);
353 sendDlRlcBoInfoMacToSch(&dlBoInfo);
355 MAC_FREE_SHRABL_BUF(pst->region, pst->pool, dlCcchIndInfo->dlCcchMsg, \
356 strlen((const char*)dlCcchIndInfo->dlCcchMsg));
357 MAC_FREE_SHRABL_BUF(pst->region, pst->pool, dlCcchIndInfo, sizeof(DlCcchIndInfo));
362 /*******************************************************************
364 * @brief Sends UL CCCH Ind to DU APP
368 * Function : macSendUlCcchInd
371 * MAC sends UL CCCH Ind to DU APP
373 * @params[in] Post structure pointer
375 * @return ROK - success
378 * ****************************************************************/
379 uint16_t macSendUlCcchInd(uint8_t *rrcContainer, uint16_t cellId, uint16_t crnti)
383 UlCcchIndInfo *ulCcchIndInfo = NULLP;
385 MAC_ALLOC_SHRABL_BUF(ulCcchIndInfo, sizeof(UlCcchIndInfo));
388 DU_LOG("\nMAC: Memory failed in macSendUlCcchInd");
392 ulCcchIndInfo->cellId = cellId;
393 ulCcchIndInfo->crnti = crnti;
394 ulCcchIndInfo->ulCcchMsg = rrcContainer;
397 pst.selector = DU_MAC_LWLC;
399 pst.dstEnt = ENTDUAPP;
401 pst.srcInst = macCb.macInst;
402 pst.dstProcId = rgCb[pst.srcInst].rgInit.procId;
403 pst.srcProcId = rgCb[pst.srcInst].rgInit.procId;
404 pst.region = MAC_MEM_REGION;
406 pst.event = EVENT_MAC_UL_CCCH_IND;
411 if(MacDuAppUlCcchInd(&pst, ulCcchIndInfo) != ROK)
413 DU_LOG("\nMAC: Failed to send UL CCCH Ind to DU APP");
414 MAC_FREE_SHRABL_BUF(MAC_MEM_REGION, MAC_POOL, ulCcchIndInfo->ulCcchMsg,
415 strlen((const char*)ulCcchIndInfo->ulCcchMsg));
416 MAC_FREE_SHRABL_BUF(MAC_MEM_REGION, MAC_POOL, ulCcchIndInfo, sizeof(UlCcchIndInfo));
422 /**********************************************************************
424 **********************************************************************/