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 (.h) */
20 #include "common_def.h"
24 #include "fapi_vendor_extension.h"
27 /* header/extern include files (.x) */
29 #include "du_app_mac_inf.h"
30 #include "mac_sch_interface.h"
32 #include "lwr_mac_fsm.h"
33 #include "lwr_mac_phy.h"
34 #include "lwr_mac_upr_inf.h"
36 #include "mac_utils.h"
37 #include "lwr_mac_utils.h"
40 /* Function pointer for slot indication from lower mac to mac */
41 SlotIndFunc sendSlotIndOpts[] =
43 packSlotInd, /* packing for loosely coupled */
44 fapiMacSlotInd, /* packing for tightly coupled */
45 packSlotInd /* packing for light weight loosly coupled */
48 /* Function pointer for rach indication from lower mac to mac */
49 RachIndFunc sendRachIndOpts[] =
56 /* Function pointer for crc indication from lower mac to mac */
57 CrcIndFunc sendCrcIndOpts[] =
64 /* Function pointer for Rx Data indication from lower mac to mac */
65 RxDataIndFunc sendRxDataIndOpts[] =
72 /* Function pointer for stop indication from lower mac to mac */
73 StopIndFunc sendStopIndOpts[] =
80 /* Function pointer for Uci indication from lower mac to mac */
81 UciIndFunc sendUciIndOpts[] =
88 /*******************************************************************
90 * @brief Processes Slot Indication from PHY and sends to MAC
94 * Function : procSlotInd
97 * Processes Slot Indication from PHY and sends to MAC
99 * @params[in] fapi_slot_ind_t pointer
100 * @return ROK - success
103 * ****************************************************************/
104 uint8_t procSlotInd(fapi_slot_ind_t *fapiSlotInd)
106 /* fill Pst structure to send to lwr_mac to MAC */
109 SlotTimingInfo *slotInd = {0};
111 MAC_ALLOC_SHRABL_BUF(slotInd, sizeof(SlotTimingInfo));
114 slotInd->cellId = lwrMacCb.cellCb[0].cellId;
115 slotInd->sfn = fapiSlotInd->sfn;
116 slotInd->slot = fapiSlotInd->slot;
118 FILL_PST_LWR_MAC_TO_MAC(pst, EVENT_SLOT_IND_TO_MAC);
119 pst.selector = ODU_SELECTOR_LWLC;
120 ret = (*sendSlotIndOpts[pst.selector])(&pst, slotInd);
124 DU_LOG("\nERROR --> LWR_MAC: Memory allocation failed in procSlotInd");
130 /*******************************************************************
132 * @brief Handles stop indication recived from PHY
136 * Function : procStopInd
139 * Handles Stop Indication received from PHY
141 * @return ROK - success
144 * ****************************************************************/
145 uint8_t procStopInd()
148 uint16_t *cellId = NULLP;
150 MAC_ALLOC_SHRABL_BUF(cellId, sizeof(uint16_t));
153 DU_LOG("\nERROR --> LWR_MAC: Memory Allocation failed in procStopInd");
157 *cellId = lwrMacCb.cellCb[0].cellId;
158 lwrMacCb.phyState = PHY_STATE_CONFIGURED;
159 lwrMacCb.cellCb[0].state = PHY_STATE_CONFIGURED;
160 DU_LOG("\nINFO --> LWR_MAC: PHY has moved to configured state");
162 FILL_PST_LWR_MAC_TO_MAC(pst, EVENT_STOP_IND_TO_MAC);
163 pst.selector = ODU_SELECTOR_LWLC;
164 return (*sendStopIndOpts[pst.selector])(&pst, cellId);
167 /*******************************************************************
169 * @brief Processes Rach Indication from PHY and sends to MAC
173 * Function : procRachInd
176 * Processes Rach Indication from PHY and sends to MAC
178 * @params[in] fapi_rach_indication_t pointer
179 * @return ROK - success
182 * ****************************************************************/
183 uint8_t procRachInd(fapi_rach_indication_t *fapiRachInd)
188 RachPduInfo *rachPdu = NULLP;
189 RachInd *rachInd = NULLP;
191 MAC_ALLOC_SHRABL_BUF(rachInd, sizeof(RachInd));
194 DU_LOG("\nERROR --> LWR_MAC : Memory Allocation failed in procRachInd");
197 if(!fapiRachInd->numPdus)
199 DU_LOG("\nDEBUG --> LWR_MAC : No PDU in RACH.indication at [%d, %d]", fapiRachInd->sfn, fapiRachInd->slot);
203 rachInd->cellId = lwrMacCb.cellCb[0].cellId;
204 rachInd->timingInfo.sfn = fapiRachInd->sfn;
205 rachInd->timingInfo.slot = fapiRachInd->slot;
206 rachInd->numPdu = fapiRachInd->numPdus;
207 for(pduIdx=0; pduIdx < rachInd->numPdu; pduIdx++)
209 rachPdu = &rachInd->rachPdu[pduIdx];
210 rachPdu->pci = fapiRachInd->rachPdu[pduIdx].phyCellId;
211 rachPdu->symbolIdx = fapiRachInd->rachPdu[pduIdx].symbolIndex;
212 rachPdu->slotIdx = fapiRachInd->rachPdu[pduIdx].slotIndex;
213 rachPdu->freqIdx = fapiRachInd->rachPdu[pduIdx].freqIndex;
214 rachPdu->numPream = fapiRachInd->rachPdu[pduIdx].numPreamble;
215 for(prmbleIdx=0; prmbleIdx<rachPdu->numPream; prmbleIdx++)
217 rachPdu->preamInfo[prmbleIdx].preamIdx = \
218 fapiRachInd->rachPdu[pduIdx].preambleInfo[prmbleIdx].preambleIndex;
219 rachPdu->preamInfo[prmbleIdx].timingAdv = \
220 fapiRachInd->rachPdu[pduIdx].preambleInfo[prmbleIdx].timingAdvance;
224 /* Fill post and sent to MAC */
225 FILL_PST_LWR_MAC_TO_MAC(pst, EVENT_RACH_IND_TO_MAC);
226 return (*sendRachIndOpts[pst.selector])(&pst, rachInd);
229 /*******************************************************************
231 * @brief Handles CRC indication from PHY and sends to MAC
235 * Function : procCrcInd
238 * Handles CRC indication from PHY and sends to MAC
240 * @params[in] fapi_crc_ind_t message pointer
241 * @return ROK - success
244 * ****************************************************************/
246 uint8_t procCrcInd(fapi_crc_ind_t *fapiCrcInd)
250 uint8_t crcStatusIdx;
251 CrcInfo *crcIndInfo = NULLP;
252 CrcInd *crcInd = NULLP;
254 MAC_ALLOC_SHRABL_BUF(crcInd, sizeof(CrcInd));
257 DU_LOG("\nERROR --> LWR_MAC : Memory Allocation failed in procCrcInd");
260 if(!fapiCrcInd->numCrcs)
262 DU_LOG("\nDEBUG --> LWR_MAC : No CRC PDUs in CRC.indication at [%d, %d]", fapiCrcInd->sfn, fapiCrcInd->slot);
266 crcInd->cellId = lwrMacCb.cellCb[0].cellId;
267 crcInd->timingInfo.sfn = fapiCrcInd->sfn;
268 crcInd->timingInfo.slot = fapiCrcInd->slot;
269 crcInd->numCrc = fapiCrcInd->numCrcs;
271 for(crcInfoIdx = 0; crcInfoIdx < crcInd->numCrc; crcInfoIdx++)
273 crcIndInfo = &crcInd->crcInfo[crcInfoIdx];
274 crcIndInfo->handle = fapiCrcInd->crc[crcInfoIdx].handle;
275 crcIndInfo->rnti = fapiCrcInd->crc[crcInfoIdx].rnti;
276 crcIndInfo->harqId = fapiCrcInd->crc[crcInfoIdx].harqId;
277 crcIndInfo->tbCrcStatus = fapiCrcInd->crc[crcInfoIdx].tbCrcStatus;
278 crcIndInfo->numCb = fapiCrcInd->crc[crcInfoIdx].numCb;
279 for(crcStatusIdx = 0; crcStatusIdx < crcIndInfo->numCb; crcStatusIdx++)
281 crcIndInfo->cbCrcStatus[crcStatusIdx] = \
282 fapiCrcInd->crc[crcInfoIdx].cbCrcStatus[crcStatusIdx];
284 crcIndInfo->ul_cqi = fapiCrcInd->crc[crcInfoIdx].ul_cqi;
285 crcIndInfo->timingAdvance = fapiCrcInd->crc[crcInfoIdx].timingAdvance;
286 crcIndInfo->rssi = fapiCrcInd->crc[crcInfoIdx].rssi;
289 /* Fill post and sent to MAC */
290 FILL_PST_LWR_MAC_TO_MAC(pst, EVENT_CRC_IND_TO_MAC);
291 return (*sendCrcIndOpts[pst.selector])(&pst, crcInd);
294 /*******************************************************************
296 * @brief Handles Rx Data indication from PHY and sends to MAC
300 * Function : procRxDataInd
303 * Handles Rx Data indication from PHY and sends to MAC
305 * @params[in] fapi_rx_data_indication_t message pointer
306 * @return ROK - success
309 * ****************************************************************/
311 uint8_t procRxDataInd(fapi_rx_data_indication_t *fapiRxDataInd)
315 RxDataInd *rxDataInd = NULLP;
316 RxDataIndPdu *pdu = NULLP;
318 MAC_ALLOC_SHRABL_BUF(rxDataInd, sizeof(RxDataInd));
321 DU_LOG("\nERROR --> LWR_MAC : Memory Allocation failed in procRxDataInd");
324 if(!fapiRxDataInd->numPdus)
326 DU_LOG("\nDEBUG --> LWR_MAC : No PDU in RX_Data.indication at [%d, %d]", fapiRxDataInd->sfn, fapiRxDataInd->slot);
330 rxDataInd->cellId = lwrMacCb.cellCb[0].cellId;
331 rxDataInd->timingInfo.sfn = fapiRxDataInd->sfn;
332 rxDataInd->timingInfo.slot = fapiRxDataInd->slot;
333 rxDataInd->numPdus = fapiRxDataInd->numPdus;
335 for(pduIdx = 0; pduIdx < rxDataInd->numPdus; pduIdx++)
337 pdu = &rxDataInd->pdus[pduIdx];
338 pdu->handle = fapiRxDataInd->pdus[pduIdx].handle;
339 pdu->rnti = fapiRxDataInd->pdus[pduIdx].rnti;
340 pdu->harqId = fapiRxDataInd->pdus[pduIdx].harqId;
341 pdu->pduLength = fapiRxDataInd->pdus[pduIdx].pdu_length;
342 pdu->ul_cqi = fapiRxDataInd->pdus[pduIdx].ul_cqi;
343 pdu->timingAdvance = fapiRxDataInd->pdus[pduIdx].timingAdvance;
344 pdu->rssi = fapiRxDataInd->pdus[pduIdx].rssi;
346 MAC_ALLOC_SHRABL_BUF(pdu->pduData, pdu->pduLength);
347 memcpy(pdu->pduData, fapiRxDataInd->pdus[pduIdx].pduData, pdu->pduLength);
349 /* Free WLS memory allocated for Rx PDU */
350 WLS_MEM_FREE(fapiRxDataInd->pdus[pduIdx].pduData, LWR_MAC_WLS_BUF_SIZE);
354 /* Fill post and sent to MAC */
355 FILL_PST_LWR_MAC_TO_MAC(pst, EVENT_RX_DATA_IND_TO_MAC);
356 return (*sendRxDataIndOpts[pst.selector])(&pst, rxDataInd);
359 /*******************************************************************
361 * @brief Fills Uci Ind Pdu Info carried on Pucch Format 0/Format 1
365 * Function : fillUciIndPucchF0F1
368 * Fills Uci Ind Pdu Info carried on Pucch Format 0/Format 1
370 *@params[in] UciPucchF0F1 *
371 * fapi_uci_o_pucch_f0f1_t *
372 * @return ROK - success
375 * ****************************************************************/
376 uint8_t fillUciIndPucchF0F1(UciPucchF0F1 *pduInfo, fapi_uci_o_pucch_f0f1_t *fapiPduInfo)
382 pduInfo->handle = fapiPduInfo->handle;
383 pduInfo->pduBitmap = fapiPduInfo->pduBitmap;
384 pduInfo->pucchFormat = fapiPduInfo->pucchFormat;
385 pduInfo->ul_cqi = fapiPduInfo->ul_cqi;
386 pduInfo->crnti = fapiPduInfo->rnti;
387 pduInfo->timingAdvance = fapiPduInfo->timingAdvance;
388 pduInfo->rssi = fapiPduInfo->rssi;
389 if(fapiPduInfo->srInfo.srIndication)
391 pduInfo->srInfo.srIndPres = fapiPduInfo->srInfo.srIndication;
392 pduInfo->srInfo.srConfdcLevel = fapiPduInfo->srInfo.srConfidenceLevel;
394 if(fapiPduInfo->harqInfo.numHarq)
396 pduInfo->harqInfo.numHarq = fapiPduInfo->harqInfo.numHarq;
397 pduInfo->harqInfo.harqConfdcLevel = fapiPduInfo->harqInfo.harqConfidenceLevel;
398 for(harqIdx = 0; harqIdx < pduInfo->harqInfo.numHarq; harqIdx++)
400 pduInfo->harqInfo.harqValue[harqIdx] = fapiPduInfo->harqInfo.harqValue[harqIdx];
406 /*******************************************************************
408 * @brief Handles Uci indication from PHY and sends to MAC
412 * Function : procUciInd
415 * Handles Uci indication from PHY and sends to MAC
417 * @params[in] fapi_uci_indication_t message pointer
418 * @return ROK - success
421 * ****************************************************************/
423 uint8_t procUciInd(fapi_uci_indication_t *fapiUciInd)
428 UciInd *macUciInd = NULLP;
430 MAC_ALLOC_SHRABL_BUF(macUciInd, sizeof(UciInd));
433 DU_LOG("\nERROR --> LWR_MAC: Memory Allocation failed in procUciInd");
437 DU_LOG("\nDEBUG --> LWR_MAC: Processing UCI Indication");
438 memset(macUciInd, 0, sizeof(UciInd));
439 macUciInd->cellId = lwrMacCb.cellCb[0].cellId;
440 macUciInd->slotInd.sfn = fapiUciInd->sfn;
441 macUciInd->slotInd.slot = fapiUciInd->slot;
442 macUciInd->numUcis = fapiUciInd->numUcis;
444 for(pduIdx = 0; pduIdx < macUciInd->numUcis; pduIdx++)
446 macUciInd->pdus[pduIdx].pduType = fapiUciInd->uciPdu[pduIdx].pduType;
447 switch(macUciInd->pdus[pduIdx].pduType)
451 case UCI_IND_PUCCH_F0F1:
453 UciPucchF0F1 *pduInfo = NULLP;
454 macUciInd->pdus[pduIdx].pduSize = fapiUciInd->uciPdu[pduIdx].pduSize;
455 pduInfo = &macUciInd->pdus[pduIdx].uci.uciPucchF0F1;
456 ret = fillUciIndPucchF0F1(pduInfo, &fapiUciInd->uciPdu[pduIdx].uci.uciPucchF0F1);
459 case UCI_IND_PUCCH_F2F3F4:
462 DU_LOG("\nERROR --> LWR_MAC: Invalid Pdu Type %d at procmacUciInd()", macUciInd->pdus[pduIdx].pduType);
469 FILL_PST_LWR_MAC_TO_MAC(pst, EVENT_UCI_IND_TO_MAC);
470 ret = (*sendUciIndOpts[pst.selector])(&pst, macUciInd);
474 DU_LOG("\nERROR --> LWR_MAC: Failed sending UCI Ind to MAC");
480 /*******************************************************************
481 * @brief Function prints src, dest, msg infor about all the msgs that
486 * Function :callFlowFromPhyToLwrMac
488 * Function call Flow From Phy To LwrMac
490 * @param[in] Pst *pst, Post structure of the primitive.
493 * ****************************************************************/
494 void callFlowFromPhyToLwrMac(uint16_t msgId)
499 #ifdef INTEL_TIMER_MODE
500 case FAPI_VENDOR_EXT_UL_IQ_SAMPLES:
501 strcpy(message,"FAPI_VENDOR_EXT_UL_IQ_SAMPLES");
504 case FAPI_PARAM_RESPONSE:
505 strcpy(message,"FAPI_PARAM_RESPONSE");
507 case FAPI_CONFIG_RESPONSE:
508 strcpy(message,"FAPI_CONFIG_RESPONSE");
510 case FAPI_SLOT_INDICATION:
511 strcpy(message,"FAPI_SLOT_INDICATION");
513 case FAPI_ERROR_INDICATION:
514 strcpy(message,"FAPI_ERROR_INDICATION");
516 case FAPI_RX_DATA_INDICATION:
517 strcpy(message,"FAPI_RX_DATA_INDICATION");
519 case FAPI_CRC_INDICATION:
520 strcpy(message,"FAPI_CRC_INDICATION");
522 case FAPI_UCI_INDICATION:
523 strcpy(message,"FAPI_UCI_INDICATION");
525 case FAPI_SRS_INDICATION:
526 strcpy(message,"FAPI_SRS_INDICATION");
528 case FAPI_RACH_INDICATION:
529 strcpy(message,"FAPI_RACH_INDICATION");
531 case FAPI_STOP_INDICATION:
532 strcpy(message,"FAPI_STOP_INDICATION");
535 DU_LOG("\nCall Flow: PHY -> ENTLWRMAC : %s\n",message);
537 /*******************************************************************
539 * @brief Processes message from PHY
543 * Function : procPhyMessages
545 * Functionality: Processes message from PHY
548 * @return ROK - success
551 * ****************************************************************/
552 void procPhyMessages(uint16_t msgType, uint32_t msgSize, void *msg)
555 /* extract the header */
556 fapi_msg_t *header = NULLP;
557 header = (fapi_msg_t *)msg;
559 #ifdef CALL_FLOW_DEBUG_LOG
560 callFlowFromPhyToLwrMac(header->msg_id);
562 switch(header->msg_id)
564 #ifdef INTEL_TIMER_MODE
565 case FAPI_VENDOR_EXT_UL_IQ_SAMPLES:
567 DU_LOG("\nDEBUG --> LWR_MAC: Received FAPI_VENDOR_EXT_UL_IQ_SAMPLES");
570 sendToLowerMac(CONFIG_REQUEST, 0, (void *)&cellId);
574 case FAPI_PARAM_RESPONSE:
576 sendToLowerMac(PARAM_RESPONSE, msgSize, msg);
579 case FAPI_CONFIG_RESPONSE:
581 sendToLowerMac(CONFIG_RESPONSE, msgSize, msg);
584 case FAPI_SLOT_INDICATION:
586 if(lwrMacCb.phyState == PHY_STATE_CONFIGURED)
588 DU_LOG("\nINFO --> LWR_MAC: PHY has moved to running state");
589 lwrMacCb.phyState = PHY_STATE_RUNNING;
590 lwrMacCb.cellCb[0].state = PHY_STATE_RUNNING;
593 fapi_slot_ind_t *slotInd = NULLP;
594 slotInd = (fapi_slot_ind_t *)msg;
595 procSlotInd(slotInd);
598 case FAPI_ERROR_INDICATION:
602 case FAPI_RX_DATA_INDICATION:
604 fapi_rx_data_indication_t *rxDataInd;
605 rxDataInd = (fapi_rx_data_indication_t *)msg;
606 procRxDataInd(rxDataInd);
609 case FAPI_CRC_INDICATION:
611 fapi_crc_ind_t *crcInd;
612 crcInd = (fapi_crc_ind_t *)msg;
616 case FAPI_UCI_INDICATION:
618 fapi_uci_indication_t *phyUciInd = NULLP;
619 phyUciInd = (fapi_uci_indication_t*)msg;
620 procUciInd(phyUciInd);
623 case FAPI_SRS_INDICATION:
627 case FAPI_RACH_INDICATION:
629 fapi_rach_indication_t *rachInd;
630 rachInd = (fapi_rach_indication_t *)msg;
631 procRachInd(rachInd);
634 case FAPI_STOP_INDICATION:
636 DU_LOG("\nINFO --> LWR_MAC: Handling Stop Indication");
644 /**********************************************************************
646 **********************************************************************/