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 "envopt.h" /* environment options */
21 #include "envdep.h" /* environment dependent */
22 #include "envind.h" /* environment independent */
23 #include "gen.h" /* general */
24 #include "ssi.h" /* system services */
25 #include "cm_tkns.h" /* Common Token Defines */
26 #include "cm_llist.h" /* Common Link List Defines */
27 #include "cm_hash.h" /* Common Hash List Defines */
28 #include "cm_lte.h" /* Common LTE Defines */
29 #include "cm_mblk.h" /* Common LTE Defines */
30 #include "tfu.h" /* RGU Interface defines */
35 /* header/extern include files (.x) */
36 #include "gen.x" /* general */
37 #include "ssi.x" /* system services */
38 #include "cm_tkns.x" /* Common Token Definitions */
39 #include "cm_llist.x" /* Common Link List Definitions */
40 #include "cm_lib.x" /* Common Library Definitions */
41 #include "cm_hash.x" /* Common Hash List Definitions */
42 #include "cm_lte.x" /* Common LTE Defines */
43 #include "cm_mblk.x" /* Common LTE Defines */
44 #include "tfu.x" /* RGU Interface includes */
46 #include "lwr_mac_fsm.h"
47 #include "lwr_mac_phy.h"
48 #include "lwr_mac_upr_inf.h"
52 /* Function pointer for slot indication from lower mac to mac */
53 packSlotIndMsg packSlotIndOpts[] =
55 packLcSlotInd, /* packing for loosely coupled */
56 fapiMacSlotInd, /* packing for tightly coupled */
57 packLwlcSlotInd /* packing for light weight loosly coupled */
60 /* Function pointer for rach indication from lower mac to mac */
61 packRachIndMsg sendRachIndOpts[] =
68 /* Function pointer for crc indication from lower mac to mac */
69 packCrcIndMsg sendCrcIndOpts[] =
76 /* Function pointer for Rx Data indication from lower mac to mac */
77 packRxDataIndMsg sendRxDataIndOpts[] =
84 /* Function pointer for stop indication from lower mac to mac */
85 packStopIndMsg sendStopIndOpts[] =
91 /*******************************************************************
93 * @brief Fills post structure
97 * Function : fillLwrMacToMacPst
100 * Fills post structure used to send message from lower MAC
103 * @params[in] Pst pointer
104 * @return ROK - success
107 * ****************************************************************/
108 void fillLwrMacToMacPst(Pst *pst)
118 pst->selector = MAC_SELECTOR_TC;
121 /*******************************************************************
123 * @brief Processes Slot Indication from PHY and sends to MAC
127 * Function : handleSlotInd
130 * Processes Slot Indication from PHY and sends to MAC
132 * @params[in] fapi_slot_ind_t pointer
133 * @return ROK - success
136 * ****************************************************************/
137 U16 handleSlotInd(fapi_slot_ind_t *fapiSlotInd)
139 /* fill Pst structure to send to lwr_mac to MAC */
144 fillLwrMacToMacPst(&pst);
145 pst.event = EVENT_SLOT_IND_TO_MAC;
147 slotInd.sfn = fapiSlotInd->sfn;
148 slotInd.slot = fapiSlotInd->slot;
150 ret = (*packSlotIndOpts[pst.selector])(&pst, &slotInd);
154 if(slotIndIdx > WLS_MEM_FREE_PRD)
158 freeWlsBlockList(slotIndIdx - 1);
164 /*******************************************************************
166 * @brief Handles stop indication recived from PHY
170 * Function : handleStopInd
173 * Handles Stop Indication received from PHY
175 * @return ROK - success
178 * ****************************************************************/
179 uint8_t handleStopInd()
184 clGlobalCp.phyState = PHY_STATE_CONFIGURED;
185 DU_LOG("\nLWR_MAC: PHY has moved to configured state");
187 fillLwrMacToMacPst(&pst);
188 pst.event = EVENT_STOP_IND_TO_MAC;
190 ret = (*sendStopIndOpts[pst.selector])(&pst);
193 /*******************************************************************
195 * @brief Processes Rach Indication from PHY and sends to MAC
199 * Function : handleRachInd
202 * Processes Rach Indication from PHY and sends to MAC
204 * @params[in] fapi_rach_indication_t pointer
205 * @return ROK - success
208 * ****************************************************************/
209 uint8_t handleRachInd(fapi_rach_indication_t *fapiRachInd)
214 RachPduInfo *rachPdu;
217 rachInd.timingInfo.sfn = fapiRachInd->sfn;
218 rachInd.timingInfo.slot = fapiRachInd->slot;
219 rachInd.numPdu = fapiRachInd->numPdus;
220 for(pduIdx=0; pduIdx < rachInd.numPdu; pduIdx++)
222 rachPdu = &rachInd.rachPdu[pduIdx];
223 rachPdu->pci = fapiRachInd->rachPdu[pduIdx].physCellId;
224 rachPdu->symbolIdx = fapiRachInd->rachPdu[pduIdx].symbolIndex;
225 rachPdu->slotIdx = fapiRachInd->rachPdu[pduIdx].slotIndex;
226 rachPdu->freqIdx = fapiRachInd->rachPdu[pduIdx].freqIndex;
227 rachPdu->numPream = fapiRachInd->rachPdu[pduIdx].numPreamble;
228 for(prmbleIdx=0; prmbleIdx<rachPdu->numPream; prmbleIdx++)
230 rachPdu->preamInfo[prmbleIdx].preamIdx = \
231 fapiRachInd->rachPdu[pduIdx].preambleInfo[prmbleIdx].preambleIndex;
232 rachPdu->preamInfo[prmbleIdx].timingAdv = \
233 fapiRachInd->rachPdu[pduIdx].preambleInfo[prmbleIdx].timingAdvance;
236 fillLwrMacToMacPst(&pst);
237 pst.event = EVENT_RACH_IND_TO_MAC;
239 (*sendRachIndOpts[pst.selector])(&pst, &rachInd);
244 /*******************************************************************
246 * @brief Handles CRC indication from PHY and sends to MAC
250 * Function : handleCrcInd
253 * Handles CRC indication from PHY and sends to MAC
255 * @params[in] fapi_crc_ind_t message pointer
256 * @return ROK - success
259 * ****************************************************************/
261 uint8_t handleCrcInd(fapi_crc_ind_t *fapiCrcInd)
265 uint8_t crcStatusIdx;
269 crcInd.timingInfo.sfn = fapiCrcInd->sfn;
270 crcInd.timingInfo.slot = fapiCrcInd->slot;
271 crcInd.numCrc = fapiCrcInd->numCrcs;
273 for(crcInfoIdx = 0; crcInfoIdx < crcInd.numCrc; crcInfoIdx++)
275 crcIndInfo = &crcInd.crcInfo[crcInfoIdx];
276 crcIndInfo->handle = fapiCrcInd->crc[crcInfoIdx].handle;
277 crcIndInfo->rnti = fapiCrcInd->crc[crcInfoIdx].rnti;
278 crcIndInfo->harqId = fapiCrcInd->crc[crcInfoIdx].harqId;
279 crcIndInfo->tbCrcStatus = fapiCrcInd->crc[crcInfoIdx].tbCrcStatus;
280 crcIndInfo->numCb = fapiCrcInd->crc[crcInfoIdx].numCb;
281 for(crcStatusIdx = 0; crcStatusIdx < crcIndInfo->numCb; crcStatusIdx++)
283 crcIndInfo->cbCrcStatus[crcStatusIdx] = \
284 fapiCrcInd->crc[crcInfoIdx].cbCrcStatus[crcStatusIdx];
286 crcIndInfo->ul_cqi = fapiCrcInd->crc[crcInfoIdx].ul_cqi;
287 crcIndInfo->timingAdvance = fapiCrcInd->crc[crcInfoIdx].timingAdvance;
288 crcIndInfo->rssi = fapiCrcInd->crc[crcInfoIdx].rssi;
291 fillLwrMacToMacPst(&pst);
292 pst.event = EVENT_CRC_IND_TO_MAC;
294 (*sendCrcIndOpts[pst.selector])(&pst, &crcInd);
299 /*******************************************************************
301 * @brief Handles Rx Data indication from PHY and sends to MAC
305 * Function : handleRxDataInd
308 * Handles Rx Data indication from PHY and sends to MAC
310 * @params[in] fapi_rx_data_indication_t message pointer
311 * @return ROK - success
314 * ****************************************************************/
316 uint8_t handleRxDataInd(fapi_rx_data_indication_t *fapiRxDataInd)
323 rxDataInd.timingInfo.sfn = fapiRxDataInd->sfn;
324 rxDataInd.timingInfo.slot = fapiRxDataInd->slot;
325 rxDataInd.numPdus = fapiRxDataInd->numPdus;
327 for(pduIdx = 0; pduIdx < rxDataInd.numPdus; pduIdx++)
329 pdu = &rxDataInd.pdus[pduIdx];
330 pdu->handle = fapiRxDataInd->pdus[pduIdx].handle;
331 pdu->rnti = fapiRxDataInd->pdus[pduIdx].rnti;
332 pdu->harqId = fapiRxDataInd->pdus[pduIdx].harqId;
333 pdu->pduLength = fapiRxDataInd->pdus[pduIdx].pduLength;
334 pdu->ul_cqi = fapiRxDataInd->pdus[pduIdx].ul_cqi;
335 pdu->timingAdvance = fapiRxDataInd->pdus[pduIdx].timingAdvance;
336 pdu->rssi = fapiRxDataInd->pdus[pduIdx].rssi;
338 MAC_ALLOC(pdu->pduData, pdu->pduLength);
339 memcpy(pdu->pduData, fapiRxDataInd->pdus[pduIdx].pduData, pdu->pduLength);
342 fillLwrMacToMacPst(&pst);
343 pst.event = EVENT_RX_DATA_IND_TO_MAC;
345 (*sendRxDataIndOpts[pst.selector])(&pst, &rxDataInd);
351 void handlePhyMessages(uint16_t msgType, uint32_t msgSize, void *msg)
354 /* extract the header */
356 header = (fapi_msg_t *)msg;
358 switch(header->message_type_id)
360 case FAPI_PARAM_RESPONSE:
361 case FAPI_CONFIG_RESPONSE:
363 sendToLowerMac(msgType, msgSize, msg);
366 case FAPI_SLOT_INDICATION:
368 if(clGlobalCp.phyState == PHY_STATE_CONFIGURED)
370 DU_LOG("\nLWR_MAC: PHY has moved to running state");
371 clGlobalCp.phyState = PHY_STATE_RUNNING;
374 fapi_slot_ind_t *slotInd;
375 slotInd = (fapi_slot_ind_t *)msg;
376 handleSlotInd(slotInd);
379 case FAPI_ERROR_INDICATION:
383 case FAPI_RX_DATA_INDICATION:
385 fapi_rx_data_indication_t *rxDataInd;
386 rxDataInd = (fapi_rx_data_indication_t *)msg;
387 handleRxDataInd(rxDataInd);
390 case FAPI_CRC_INDICATION:
392 fapi_crc_ind_t *crcInd;
393 crcInd = (fapi_crc_ind_t *)msg;
394 handleCrcInd(crcInd);
397 case FAPI_UCI_INDICATION:
401 case FAPI_SRS_INDICATION:
405 case FAPI_RACH_INDICATION:
407 fapi_rach_indication_t *rachInd;
408 rachInd = (fapi_rach_indication_t *)msg;
409 handleRachInd(rachInd);
412 case FAPI_STOP_INDICATION:
414 DU_LOG("\nLWR_MAC: Handling Stop Indication");
420 WLS_MEM_FREE(msg, LWR_MAC_WLS_BUF_SIZE);
425 /**********************************************************************
427 **********************************************************************/