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 SlotIndInfo *slotInd = {0};
111 MAC_ALLOC_SHRABL_BUF(slotInd, sizeof(SlotIndInfo));
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 ret = (*sendSlotIndOpts[pst.selector])(&pst, slotInd);
123 DU_LOG("\nERROR --> LWR_MAC: Memory allocation failed in procSlotInd");
129 /*******************************************************************
131 * @brief Handles stop indication recived from PHY
135 * Function : procStopInd
138 * Handles Stop Indication received from PHY
140 * @return ROK - success
143 * ****************************************************************/
144 uint8_t procStopInd()
147 uint16_t *cellId = NULLP;
149 MAC_ALLOC_SHRABL_BUF(cellId, sizeof(uint16_t));
152 DU_LOG("\nERROR --> LWR_MAC: Memory Allocation failed in procStopInd");
156 *cellId = lwrMacCb.cellCb[0].cellId;
157 lwrMacCb.phyState = PHY_STATE_CONFIGURED;
158 lwrMacCb.cellCb[0].state = PHY_STATE_CONFIGURED;
159 DU_LOG("\nINFO --> LWR_MAC: PHY has moved to configured state");
161 FILL_PST_LWR_MAC_TO_MAC(pst, EVENT_STOP_IND_TO_MAC);
162 return (*sendStopIndOpts[pst.selector])(&pst, cellId);
165 /*******************************************************************
167 * @brief Processes Rach Indication from PHY and sends to MAC
171 * Function : procRachInd
174 * Processes Rach Indication from PHY and sends to MAC
176 * @params[in] fapi_rach_indication_t pointer
177 * @return ROK - success
180 * ****************************************************************/
181 uint8_t procRachInd(fapi_rach_indication_t *fapiRachInd)
186 RachPduInfo *rachPdu = NULLP;
187 RachInd *rachInd = NULLP;
189 MAC_ALLOC_SHRABL_BUF(rachInd, sizeof(RachInd));
192 DU_LOG("\nERROR --> LWR_MAC: Memory Allocation failed in procRachInd");
196 rachInd->cellId = lwrMacCb.cellCb[0].cellId;
197 rachInd->timingInfo.sfn = fapiRachInd->sfn;
198 rachInd->timingInfo.slot = fapiRachInd->slot;
199 rachInd->numPdu = fapiRachInd->numPdus;
200 for(pduIdx=0; pduIdx < rachInd->numPdu; pduIdx++)
202 rachPdu = &rachInd->rachPdu[pduIdx];
203 rachPdu->pci = fapiRachInd->rachPdu[pduIdx].phyCellId;
204 rachPdu->symbolIdx = fapiRachInd->rachPdu[pduIdx].symbolIndex;
205 rachPdu->slotIdx = fapiRachInd->rachPdu[pduIdx].slotIndex;
206 rachPdu->freqIdx = fapiRachInd->rachPdu[pduIdx].freqIndex;
207 rachPdu->numPream = fapiRachInd->rachPdu[pduIdx].numPreamble;
208 for(prmbleIdx=0; prmbleIdx<rachPdu->numPream; prmbleIdx++)
210 rachPdu->preamInfo[prmbleIdx].preamIdx = \
211 fapiRachInd->rachPdu[pduIdx].preambleInfo[prmbleIdx].preambleIndex;
212 rachPdu->preamInfo[prmbleIdx].timingAdv = \
213 fapiRachInd->rachPdu[pduIdx].preambleInfo[prmbleIdx].timingAdvance;
217 /* Fill post and sent to MAC */
218 FILL_PST_LWR_MAC_TO_MAC(pst, EVENT_RACH_IND_TO_MAC);
219 return (*sendRachIndOpts[pst.selector])(&pst, rachInd);
223 /*******************************************************************
225 * @brief Handles CRC indication from PHY and sends to MAC
229 * Function : procCrcInd
232 * Handles CRC indication from PHY and sends to MAC
234 * @params[in] fapi_crc_ind_t message pointer
235 * @return ROK - success
238 * ****************************************************************/
240 uint8_t procCrcInd(fapi_crc_ind_t *fapiCrcInd)
244 uint8_t crcStatusIdx;
245 CrcInfo *crcIndInfo = NULLP;
246 CrcInd *crcInd = NULLP;
248 MAC_ALLOC_SHRABL_BUF(crcInd, sizeof(CrcInd));
251 DU_LOG("\nERROR --> LWR_MAC: Memory Allocation failed in procCrcInd");
255 crcInd->cellId = lwrMacCb.cellCb[0].cellId;
256 crcInd->timingInfo.sfn = fapiCrcInd->sfn;
257 crcInd->timingInfo.slot = fapiCrcInd->slot;
258 crcInd->numCrc = fapiCrcInd->numCrcs;
260 for(crcInfoIdx = 0; crcInfoIdx < crcInd->numCrc; crcInfoIdx++)
262 crcIndInfo = &crcInd->crcInfo[crcInfoIdx];
263 crcIndInfo->handle = fapiCrcInd->crc[crcInfoIdx].handle;
264 crcIndInfo->rnti = fapiCrcInd->crc[crcInfoIdx].rnti;
265 crcIndInfo->harqId = fapiCrcInd->crc[crcInfoIdx].harqId;
266 crcIndInfo->tbCrcStatus = fapiCrcInd->crc[crcInfoIdx].tbCrcStatus;
267 crcIndInfo->numCb = fapiCrcInd->crc[crcInfoIdx].numCb;
268 for(crcStatusIdx = 0; crcStatusIdx < crcIndInfo->numCb; crcStatusIdx++)
270 crcIndInfo->cbCrcStatus[crcStatusIdx] = \
271 fapiCrcInd->crc[crcInfoIdx].cbCrcStatus[crcStatusIdx];
273 crcIndInfo->ul_cqi = fapiCrcInd->crc[crcInfoIdx].ul_cqi;
274 crcIndInfo->timingAdvance = fapiCrcInd->crc[crcInfoIdx].timingAdvance;
275 crcIndInfo->rssi = fapiCrcInd->crc[crcInfoIdx].rssi;
278 /* Fill post and sent to MAC */
279 FILL_PST_LWR_MAC_TO_MAC(pst, EVENT_CRC_IND_TO_MAC);
280 return (*sendCrcIndOpts[pst.selector])(&pst, crcInd);
283 /*******************************************************************
285 * @brief Handles Rx Data indication from PHY and sends to MAC
289 * Function : procRxDataInd
292 * Handles Rx Data indication from PHY and sends to MAC
294 * @params[in] fapi_rx_data_indication_t message pointer
295 * @return ROK - success
298 * ****************************************************************/
300 uint8_t procRxDataInd(fapi_rx_data_indication_t *fapiRxDataInd)
304 RxDataInd *rxDataInd = NULLP;
305 RxDataIndPdu *pdu = NULLP;
307 MAC_ALLOC_SHRABL_BUF(rxDataInd, sizeof(RxDataInd));
310 DU_LOG("\nERROR --> LWR_MAC: Memory Allocation failed in procRxDataInd");
314 rxDataInd->cellId = lwrMacCb.cellCb[0].cellId;
315 rxDataInd->timingInfo.sfn = fapiRxDataInd->sfn;
316 rxDataInd->timingInfo.slot = fapiRxDataInd->slot;
317 rxDataInd->numPdus = fapiRxDataInd->numPdus;
319 for(pduIdx = 0; pduIdx < rxDataInd->numPdus; pduIdx++)
321 pdu = &rxDataInd->pdus[pduIdx];
322 pdu->handle = fapiRxDataInd->pdus[pduIdx].handle;
323 pdu->rnti = fapiRxDataInd->pdus[pduIdx].rnti;
324 pdu->harqId = fapiRxDataInd->pdus[pduIdx].harqId;
325 pdu->pduLength = fapiRxDataInd->pdus[pduIdx].pdu_length;
326 pdu->ul_cqi = fapiRxDataInd->pdus[pduIdx].ul_cqi;
327 pdu->timingAdvance = fapiRxDataInd->pdus[pduIdx].timingAdvance;
328 pdu->rssi = fapiRxDataInd->pdus[pduIdx].rssi;
330 MAC_ALLOC_SHRABL_BUF(pdu->pduData, pdu->pduLength);
331 memcpy(pdu->pduData, fapiRxDataInd->pdus[pduIdx].pduData, pdu->pduLength);
333 /* Free WLS memory allocated for Rx PDU */
334 WLS_MEM_FREE(fapiRxDataInd->pdus[pduIdx].pduData, LWR_MAC_WLS_BUF_SIZE);
338 /* Fill post and sent to MAC */
339 FILL_PST_LWR_MAC_TO_MAC(pst, EVENT_RX_DATA_IND_TO_MAC);
340 return (*sendRxDataIndOpts[pst.selector])(&pst, rxDataInd);
343 /*******************************************************************
345 * @brief Fills Uci Ind Pdu Info carried on Pucch Format 0/Format 1
349 * Function : fillUciIndPucchF0F1
352 * Fills Uci Ind Pdu Info carried on Pucch Format 0/Format 1
354 *@params[in] UciPucchF0F1 *
355 * fapi_uci_o_pucch_f0f1_t *
356 * @return ROK - success
359 * ****************************************************************/
360 uint8_t fillUciIndPucchF0F1(UciPucchF0F1 *pduInfo, fapi_uci_o_pucch_f0f1_t *fapiPduInfo)
366 pduInfo->handle = fapiPduInfo->handle;
367 pduInfo->pduBitmap = fapiPduInfo->pduBitmap;
368 pduInfo->pucchFormat = fapiPduInfo->pucchFormat;
369 pduInfo->ul_cqi = fapiPduInfo->ul_cqi;
370 pduInfo->crnti = fapiPduInfo->rnti;
371 pduInfo->timingAdvance = fapiPduInfo->timingAdvance;
372 pduInfo->rssi = fapiPduInfo->rssi;
373 if(fapiPduInfo->srInfo.srIndication)
375 pduInfo->srInfo.srIndPres = fapiPduInfo->srInfo.srIndication;
376 pduInfo->srInfo.srConfdcLevel = fapiPduInfo->srInfo.srConfidenceLevel;
378 if(fapiPduInfo->harqInfo.numHarq)
380 pduInfo->harqInfo.numHarq = fapiPduInfo->harqInfo.numHarq;
381 pduInfo->harqInfo.harqConfdcLevel = fapiPduInfo->harqInfo.harqConfidenceLevel;
382 for(harqIdx = 0; harqIdx < pduInfo->harqInfo.numHarq; harqIdx++)
384 pduInfo->harqInfo.harqValue[harqIdx] = fapiPduInfo->harqInfo.harqValue[harqIdx];
390 /*******************************************************************
392 * @brief Handles Uci indication from PHY and sends to MAC
396 * Function : procUciInd
399 * Handles Uci indication from PHY and sends to MAC
401 * @params[in] fapi_uci_indication_t message pointer
402 * @return ROK - success
405 * ****************************************************************/
407 uint8_t procUciInd(fapi_uci_indication_t *fapiUciInd)
412 UciInd *macUciInd = NULLP;
414 MAC_ALLOC_SHRABL_BUF(macUciInd, sizeof(UciInd));
417 DU_LOG("\nERROR --> LWR_MAC: Memory Allocation failed in procUciInd");
421 DU_LOG("\nDEBUG --> LWR_MAC: Processing UCI Indication");
422 memset(macUciInd, 0, sizeof(UciInd));
423 macUciInd->cellId = lwrMacCb.cellCb[0].cellId;
424 macUciInd->slotInd.sfn = fapiUciInd->sfn;
425 macUciInd->slotInd.slot = fapiUciInd->slot;
426 macUciInd->numUcis = fapiUciInd->numUcis;
428 for(pduIdx = 0; pduIdx < macUciInd->numUcis; pduIdx++)
430 macUciInd->pdus[pduIdx].pduType = fapiUciInd->uciPdu[pduIdx].pduType;
431 switch(macUciInd->pdus[pduIdx].pduType)
435 case UCI_IND_PUCCH_F0F1:
437 UciPucchF0F1 *pduInfo = NULLP;
438 macUciInd->pdus[pduIdx].pduSize = fapiUciInd->uciPdu[pduIdx].pduSize;
439 pduInfo = &macUciInd->pdus[pduIdx].uci.uciPucchF0F1;
440 ret = fillUciIndPucchF0F1(pduInfo, &fapiUciInd->uciPdu[pduIdx].uci.uciPucchF0F1);
443 case UCI_IND_PUCCH_F2F3F4:
446 DU_LOG("\nERROR --> LWR_MAC: Invalid Pdu Type %d at procmacUciInd()", macUciInd->pdus[pduIdx].pduType);
453 FILL_PST_LWR_MAC_TO_MAC(pst, EVENT_UCI_IND_TO_MAC);
454 ret = (*sendUciIndOpts[pst.selector])(&pst, macUciInd);
458 DU_LOG("\nERROR --> LWR_MAC: Failed sending UCI Ind to MAC");
464 /*******************************************************************
466 * @brief Processes message from PHY
470 * Function : procPhyMessages
472 * Functionality: Processes message from PHY
475 * @return ROK - success
478 * ****************************************************************/
479 void procPhyMessages(uint16_t msgType, uint32_t msgSize, void *msg)
482 /* extract the header */
483 fapi_msg_t *header = NULLP;
484 header = (fapi_msg_t *)msg;
486 switch(header->msg_id)
488 #ifdef INTEL_TIMER_MODE
489 case FAPI_VENDOR_EXT_UL_IQ_SAMPLES:
491 DU_LOG("\nDEBUG --> LWR_MAC: Received FAPI_VENDOR_EXT_UL_IQ_SAMPLES");
494 sendToLowerMac(CONFIG_REQUEST, 0, (void *)&cellId);
498 case FAPI_PARAM_RESPONSE:
500 sendToLowerMac(PARAM_RESPONSE, msgSize, msg);
503 case FAPI_CONFIG_RESPONSE:
505 sendToLowerMac(CONFIG_RESPONSE, msgSize, msg);
508 case FAPI_SLOT_INDICATION:
510 if(lwrMacCb.phyState == PHY_STATE_CONFIGURED)
512 DU_LOG("\nINFO --> LWR_MAC: PHY has moved to running state");
513 lwrMacCb.phyState = PHY_STATE_RUNNING;
514 lwrMacCb.cellCb[0].state = PHY_STATE_RUNNING;
517 fapi_slot_ind_t *slotInd = NULLP;
518 slotInd = (fapi_slot_ind_t *)msg;
519 procSlotInd(slotInd);
522 case FAPI_ERROR_INDICATION:
526 case FAPI_RX_DATA_INDICATION:
528 fapi_rx_data_indication_t *rxDataInd;
529 rxDataInd = (fapi_rx_data_indication_t *)msg;
530 procRxDataInd(rxDataInd);
533 case FAPI_CRC_INDICATION:
535 fapi_crc_ind_t *crcInd;
536 crcInd = (fapi_crc_ind_t *)msg;
540 case FAPI_UCI_INDICATION:
542 fapi_uci_indication_t *phyUciInd = NULLP;
543 phyUciInd = (fapi_uci_indication_t*)msg;
544 procUciInd(phyUciInd);
547 case FAPI_SRS_INDICATION:
551 case FAPI_RACH_INDICATION:
553 fapi_rach_indication_t *rachInd;
554 rachInd = (fapi_rach_indication_t *)msg;
555 procRachInd(rachInd);
558 case FAPI_STOP_INDICATION:
560 DU_LOG("\nINFO --> LWR_MAC: Handling Stop Indication");
568 /**********************************************************************
570 **********************************************************************/