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 /************************************************************************
25 Desc: C source code for rach handling functions
29 **********************************************************************/
32 @brief This file implements the rach handling.
34 #include "common_def.h"
40 #include "du_app_mac_inf.h"
41 #include "mac_sch_interface.h"
43 #include "sch_utils.h"
45 SchRachRsrcRspFunc SchRachRsrcRspOpts[] =
47 packSchRachRsrcRsp, /* LC */
48 MacProcSchRachRsrcRsp, /* TC */
49 packSchRachRsrcRsp /* LWLC */
53 * @brief Checks if PRACH can be scheduled in current slot
57 * Function : schCheckPrachOcc
59 * This function checks if PRACH can be scheduled in
67 bool schCheckPrachOcc(SchCellCb *cell, SlotTimingInfo prachOccasionTimingInfo)
69 uint8_t prachCfgIdx = 0;
73 uint16_t prachSubframe = 0;
75 prachCfgIdx = cell->cellCfg.schRachCfg.prachCfgIdx;
77 /* derive the prachCfgIdx table paramters */
78 x = prachCfgIdxTable[prachCfgIdx][1];
79 y = prachCfgIdxTable[prachCfgIdx][2];
80 prachSubframe = prachCfgIdxTable[prachCfgIdx][3];
82 if((prachOccasionTimingInfo.sfn%x) == y)
84 subFrame = prachOccasionTimingInfo.slot/pow(2, cell->cellCfg.numerology);
86 /* check for subFrame number */
87 if ((1 << subFrame) & prachSubframe)
89 /* prach ocassion present in this subframe */
91 if(UL_SLOT != schGetSlotSymbFrmt(prachOccasionTimingInfo.slot % cell->numSlotsInPeriodicity,\
92 cell->slotFrmtBitMap))
94 DU_LOG("\nERROR --> SCH : PrachCfgIdx %d doesn't support UL slot", prachCfgIdx);
105 * @brief Calculate number of PRBs to be allocated for PRACH
109 * Function : schCalcPrachNumRb
111 * Calculate number of PRBs to be allocated for PRACH
113 * @param[in] SchCellCb *cell, cell cb
114 * @return Number of PRBs
116 uint8_t schCalcPrachNumRb(SchCellCb *cell)
118 uint8_t tableIdx = 0;
119 uint16_t puschScs = convertScsEnumValToScsVal(cell->cellCfg.schInitialUlBwp.bwp.scs);
121 for(tableIdx=0; tableIdx < MAX_RACH_NUM_RB_IDX; tableIdx++)
123 if((numRbForPrachTable[tableIdx][0] == cell->cellCfg.schRachCfg.rootSeqLen) &&
124 (numRbForPrachTable[tableIdx][1] == cell->cellCfg.schRachCfg.prachSubcSpacing) &&
125 (numRbForPrachTable[tableIdx][2] == puschScs))
127 return numRbForPrachTable[tableIdx][3];
134 * @brief resource allocation for PRACH
138 * Function : schPrachResAlloc
140 * This function handles PRACH allocation
142 * @param[in] SchCellCb *cell, cell cb
143 * @param[in] UlSchedInfo *ulSchedInfo, UL scheduling info
146 void schPrachResAlloc(SchCellCb *cell, UlSchedInfo *ulSchedInfo, SlotTimingInfo prachOccasionTimingInfo)
148 uint8_t numPrachRb = 0;
150 uint8_t prachCfgIdx = 0;
151 uint8_t prachFormat = 0;
152 uint8_t prachStartSymbol = 0;
153 uint8_t prachDuration = 0;
154 uint8_t prachOcas = 0;
155 uint8_t dataType = 0;
156 uint16_t freqStart = 0;
160 DU_LOG("\nERROR --> SCH : schPrachResAlloc(): Received cellCb is null");
164 /* If this slot is not a PRACH occassion, return */
165 if(!schCheckPrachOcc(cell, prachOccasionTimingInfo))
168 prachCfgIdx = cell->cellCfg.schRachCfg.prachCfgIdx;
169 prachFormat = prachCfgIdxTable[prachCfgIdx][0];
170 prachStartSymbol = prachCfgIdxTable[prachCfgIdx][4];
171 prachOcas = prachCfgIdxTable[prachCfgIdx][6];
172 prachDuration = prachCfgIdxTable[prachCfgIdx][7];
174 /* numRa determined as 𝑛 belonging {0,1,.., M − 1},
175 * where M is given by msg1Fdm */
176 numRa = (cell->cellCfg.schRachCfg.msg1Fdm - 1);
178 /* freq domain resource determination for RACH*/
179 freqStart = cell->cellCfg.schRachCfg.msg1FreqStart;
180 numPrachRb = schCalcPrachNumRb(cell);
181 /* Allocate PRACH resources from the UL resource bitmap */
182 allocatePrbUl(cell, prachOccasionTimingInfo, prachStartSymbol, prachDuration, &freqStart, numPrachRb);
185 dataType |= SCH_DATATYPE_PRACH;
186 ulSchedInfo->dataType = dataType;
187 ulSchedInfo->prachSchInfo.numPrachOcas = prachOcas;
188 ulSchedInfo->prachSchInfo.prachFormat = prachFormat;
189 ulSchedInfo->prachSchInfo.numRa = numRa;
190 ulSchedInfo->prachSchInfo.prachStartSymb = prachStartSymbol;
191 DU_LOG("\nINFO --> SCH : RACH occassion set for slot %d", prachOccasionTimingInfo.slot);
195 * @brief Process RACH resource request for CFRA
199 * Function : MacSchRachRsrcReq
201 * This function processes RACH resorce request
202 * from MAC for CFRA. It assigns a dedicated preamble
203 * to the UE and sends the same in RACH resource
206 * @param[in] Post structure
207 * @param[in] RACH resource request
211 uint8_t MacSchRachRsrcReq(Pst *pst, SchRachRsrcReq *schRachRsrcReq)
213 uint8_t ssbIdx = 0, cfraSsbIdx = 0;
214 uint8_t firstCFPreambleIndex = 0, lastCFPreambleIndex = 0;
215 uint16_t cellIdx = 0;
218 Inst inst = pst->dstInst - SCH_INST_START;
219 SchCellCb *cellCb = NULLP;
220 SchUeCb *ueCb = NULLP;
221 SchRachRsrcRsp *rachRsrcRsp = NULLP;
223 DU_LOG("\nINFO --> SCH : Received RACH resource request for Cell ID [%d] CRNTI [%d]", \
224 schRachRsrcReq->cellId, schRachRsrcReq->crnti);
226 /* Fill RACH resource response to MAC */
227 SCH_ALLOC(rachRsrcRsp, sizeof(SchRachRsrcRsp));
230 DU_LOG("\nERROR --> SCH : Memory allocation failed for RACH resource response");
233 rachRsrcRsp->cellId = schRachRsrcReq->cellId;
234 rachRsrcRsp->crnti = schRachRsrcReq->crnti;
235 rachRsrcRsp->result = RSP_OK;
237 /* Fill SCH to MAC Pst structure */
238 memset(&rspPst, 0, sizeof(Pst));
239 FILL_PST_SCH_TO_MAC(rspPst, inst);
240 rspPst.event = EVENT_RACH_RESOURCE_RESPONSE_TO_MAC;
243 for(cellIdx = 0; cellIdx < MAX_NUM_CELL; cellIdx++)
245 if((schCb[inst].cells[cellIdx]) && (schCb[inst].cells[cellIdx]->cellId == schRachRsrcReq->cellId))
247 cellCb = schCb[inst].cells[cellIdx];
255 ueCb = schGetUeCb(cellCb, schRachRsrcReq->crnti);
256 if(ueCb->crnti != schRachRsrcReq->crnti)
258 DU_LOG("\nERROR --> SCH : CRNTI [%d] not found" ,schRachRsrcReq->crnti);
259 rachRsrcRsp->result = RSP_NOK;
264 DU_LOG("\nERROR --> SCH : Cell ID [%d] not found" ,schRachRsrcReq->cellId);
265 rachRsrcRsp->result = RSP_NOK;
268 /* Allocate SSB resource if no failure has occurred until this step */
269 if(rachRsrcRsp->result == RSP_OK)
271 /* Find first free preamble index from the pool CF preambles
272 * Preamble index from 0 to (numCbPreamblePerSsb-1) is used for CBRA
273 * Preamble index from numCbPreamblePerSsb to totalNumOfRAPreamble
274 * is used for CFRA */
275 firstCFPreambleIndex = cellCb->cellCfg.schRachCfg.numCbPreamblePerSsb;
276 lastCFPreambleIndex = cellCb->cellCfg.schRachCfg.totalNumRaPreamble;
278 /* Allocate resource for each SSB index requested */
279 for(ssbIdx = 0; ssbIdx < schRachRsrcReq->numSsb; ssbIdx++)
281 /* Find the first CF Preamble index not dedicated to any UE currently */
282 while(firstCFPreambleIndex <= lastCFPreambleIndex)
284 mask = 1 << firstCFPreambleIndex;
285 if(cellCb->dedPreambleBitMap & mask)
287 firstCFPreambleIndex++;
294 /* If firstCFPreambleIndex > lastCFPreambleIndex, it means all
295 * dedicated preambles are in use currently. In such a case, CBRA
296 * should be initiated.
297 * If a dedicated preamble is found, use this for CFRA and mark it as
298 * IN-USE in the bitmap.
299 * Considering only CFRA scenario for now. */
300 if(firstCFPreambleIndex <= lastCFPreambleIndex)
302 ueCb->cfraResource.ssbResource[cfraSsbIdx].ssbIdx = schRachRsrcReq->ssbIdx[ssbIdx];
303 ueCb->cfraResource.ssbResource[cfraSsbIdx].raPreambleIdx = firstCFPreambleIndex;
304 SET_ONE_BIT(firstCFPreambleIndex, cellCb->dedPreambleBitMap);
306 firstCFPreambleIndex++;
310 DU_LOG("\nINFO : SCH : No dedicated preameble availble to assign to ssbIdx[%d]", schRachRsrcReq->ssbIdx[ssbIdx]);
311 /* Breaking out of for loop since no dedicated preambles are available
312 * for remaining ssbIdx too */
317 ueCb->cfraResource.numSsb = cfraSsbIdx;
319 if(ueCb->cfraResource.numSsb == 0)
321 /* If numSsb is 0, it means no CFRA resource was alloacted for any of the
322 * SSB Idx, hence send a negative response */
323 rachRsrcRsp->result = RSP_NOK;
327 /* Send ssb resource information to MAC in RACH resource response */
328 rachRsrcRsp->cfraResource.numSsb = ueCb->cfraResource.numSsb;
329 memcpy(rachRsrcRsp->cfraResource.ssbResource, ueCb->cfraResource.ssbResource, \
330 ueCb->cfraResource.numSsb * sizeof(SchCfraSsbResource));
334 /* Free RACH resource request memory allocated by MAC */
335 SCH_FREE(schRachRsrcReq, sizeof(SchRachRsrcReq));
337 /* Send RACH resource response to MAC */
338 return (SchRachRsrcRspOpts[rspPst.selector](&rspPst, rachRsrcRsp));
342 * @brief calculate ra-rnti function.
346 * Function : calculateRaRnti
348 * This function calculates ra-rnti
350 * @param[in] symbol index
351 * @param[in] slot index
352 * @param[in] frequency index
355 uint16_t calculateRaRnti(uint8_t symbolIdx, uint8_t slotIdx, uint8_t freqIdx)
358 uint8_t ulCarrierIdx = 0; /* Uplink carrier used for MSG1 transmission. 0:NUL carrier; 1:SUL carrier */
360 /* Refer to spec 38.321, section 5.1.3 */
361 raRnti = (1 + symbolIdx + (14*slotIdx) + (14*80*freqIdx) + (14*80*8*ulCarrierIdx));
366 * @brief create raCb function.
370 * Function : createSchRaCb
372 * This function create raCb
375 * @param[in] shed instance
378 void createSchRaCb(uint8_t ueId, SchRaReq *raReq, Inst schInst)
382 /* If a UE in handover has triggered CFRA, its UE CB context is already present in SCH,
383 * Hence, no need to create raCb */
384 if(raReq->ueCb && (raReq->ueCb->state == SCH_UE_HANDIN_IN_PROGRESS))
386 schCb[schInst].cells[schInst]->numActvUe++;
387 SET_ONE_BIT(raReq->ueCb->ueId, schCb[schInst].cells[schInst]->actvUeBitMap);
388 raReq->ueCb->state = SCH_UE_STATE_ACTIVE;
389 schCb[schInst].cells[schInst]->raCb[ueId -1].raState = SCH_RA_STATE_MSG4_DONE;
394 /* Create RA CB only for CB-RA to use for msg3 and msg4 processing */
395 GET_UE_ID(raReq->rachInd->crnti, ueId);
396 schCb[schInst].cells[schInst]->raCb[ueId -1].tcrnti = raReq->rachInd->crnti;
397 schCb[schInst].cells[schInst]->raCb[ueId -1].msg4recvd = FALSE;
398 schCb[schInst].cells[schInst]->raCb[ueId -1].raState = SCH_RA_STATE_MSG3_PENDING;
400 schCb[schInst].cells[schInst]->raCb[ueId -1].cell = schCb[schInst].cells[schInst];
404 * @brief resource allocation for msg3 PUSCH
408 * Function : schAllocMsg3Pusch
410 * This function handles msg3 PUSCH allocation
412 * @param[in] Inst schInst, SCH instance
413 * @param[in] slot, current slot
414 * @param[out] msg3StartRb
415 * @param[out] msg3NumRb
418 SchPuschInfo* schAllocMsg3Pusch(Inst schInst, uint16_t crnti, uint8_t k2Index, SlotTimingInfo msg3SlotTime, SchUlHqProcCb* msg3HqProc, bool isRetx)
420 SchCellCb *cell = NULLP;
421 SchUlSlotInfo *schUlSlotInfo = NULLP;
422 uint8_t mcs = DEFAULT_MCS;
423 uint8_t startSymb = 0;
425 uint16_t startRb = 0;
429 cell = schCb[schInst].cells[schInst];
432 DU_LOG("\n\nERROR --> SCH : Failed to find cell in schAllocMsg3Pusch");
436 /* Allocate time-domain and frequency-domain resource for MSG3 PUSCH */
437 startSymb = cell->cellCfg.schInitialUlBwp.puschCommon.timeDomRsrcAllocList[k2Index].startSymbol;
438 symbLen = cell->cellCfg.schInitialUlBwp.puschCommon.timeDomRsrcAllocList[k2Index].symbolLength;
440 startRb = MAX_NUM_RB;
441 tbSize = schCalcTbSize(8); /* 6 bytes msg3 and 2 bytes header */
442 numRb = schCalcNumPrb(tbSize, mcs, symbLen);
443 numRb++; /* allocating 1 extra RB for now */
444 allocatePrbUl(cell, msg3SlotTime, startSymb, symbLen, &startRb, numRb);
446 /* Fill PUSCH scheduling details in Slot structure */
447 schUlSlotInfo = cell->schUlSlotInfo[msg3SlotTime.slot];
448 SCH_ALLOC(schUlSlotInfo->schPuschInfo, sizeof(SchPuschInfo));
449 if(!schUlSlotInfo->schPuschInfo)
451 DU_LOG("\nERROR --> SCH : Memory allocation failed in schAllocMsg3Pusch");
455 tbSize = 0; /* since nPrb has been incremented, recalculating tbSize */
456 tbSize = schCalcTbSizeFromNPrb(numRb, mcs, NUM_PDSCH_SYMBOL);
457 tbSize = tbSize / 8 ; /*bits to byte conversion*/
459 schUlSlotInfo->schPuschInfo->harqProcId = msg3HqProc->procId;
460 schUlSlotInfo->schPuschInfo->fdAlloc.resAllocType = SCH_ALLOC_TYPE_1;
461 schUlSlotInfo->schPuschInfo->fdAlloc.resAlloc.type1.startPrb = startRb;
462 schUlSlotInfo->schPuschInfo->fdAlloc.resAlloc.type1.numPrb = numRb;
463 schUlSlotInfo->schPuschInfo->tdAlloc.startSymb = startSymb;
464 schUlSlotInfo->schPuschInfo->tdAlloc.numSymb = symbLen;
465 schUlSlotInfo->schPuschInfo->tbInfo.qamOrder = QPSK_MODULATION; /* QPSK modulation */
466 schUlSlotInfo->schPuschInfo->tbInfo.mcs = mcs;
467 schUlSlotInfo->schPuschInfo->tbInfo.mcsTable = SCH_MCS_TABLE_QAM_64;
468 schUlSlotInfo->schPuschInfo->tbInfo.ndi = NEW_TRANSMISSION; /* new transmission */
469 schUlSlotInfo->schPuschInfo->tbInfo.rv = 0;
470 schUlSlotInfo->schPuschInfo->tbInfo.tbSize = tbSize;
472 schUlSlotInfo->schPuschInfo->dmrsMappingType = DMRS_MAP_TYPE_A; /* Setting Type-A */
473 schUlSlotInfo->schPuschInfo->nrOfDmrsSymbols = NUM_DMRS_SYMBOLS;
474 schUlSlotInfo->schPuschInfo->dmrsAddPos = DMRS_ADDITIONAL_POS;
479 msg3HqProc->strtSymbl = startSymb;
480 msg3HqProc->numSymbl = symbLen;
481 msg3HqProc->puschResType = schUlSlotInfo->schPuschInfo->fdAlloc.resAllocType;
482 msg3HqProc->puschStartPrb = schUlSlotInfo->schPuschInfo->fdAlloc.resAlloc.type1.startPrb;
483 msg3HqProc->puschNumPrb = schUlSlotInfo->schPuschInfo->fdAlloc.resAlloc.type1.numPrb;
484 msg3HqProc->tbInfo.qamOrder = schUlSlotInfo->schPuschInfo->tbInfo.qamOrder;
485 msg3HqProc->tbInfo.iMcs = schUlSlotInfo->schPuschInfo->tbInfo.mcs;
486 msg3HqProc->tbInfo.mcsTable = schUlSlotInfo->schPuschInfo->tbInfo.mcsTable;
487 msg3HqProc->tbInfo.ndi = schUlSlotInfo->schPuschInfo->tbInfo.ndi;
488 msg3HqProc->tbInfo.rv = schUlSlotInfo->schPuschInfo->tbInfo.rv;
489 msg3HqProc->tbInfo.tbSzReq = schUlSlotInfo->schPuschInfo->tbInfo.tbSize;
491 msg3HqProc->dmrsMappingType = schUlSlotInfo->schPuschInfo->dmrsMappingType;
492 msg3HqProc->nrOfDmrsSymbols = schUlSlotInfo->schPuschInfo->nrOfDmrsSymbols;
493 msg3HqProc->dmrsAddPos = schUlSlotInfo->schPuschInfo->dmrsAddPos;
496 return schUlSlotInfo->schPuschInfo;
500 * @brief Check if a time frame is in RA Response window
504 * Function : isInRaRspWindow
506 * Check if a time frame is in RA Response window
508 * @param[in] RA request
509 * @param[in] Time frame to check
510 * @param[in] Total number of slot per radio frame
514 RaRspWindowStatus isInRaRspWindow(SchRaReq *raReq, SlotTimingInfo frameToCheck, uint16_t numSlotsPerSystemFrame)
516 uint32_t winStartTime, winEndTime, timeToCheck;
518 winStartTime = (raReq->winStartTime.sfn * numSlotsPerSystemFrame) + raReq->winStartTime.slot;
519 winEndTime = (raReq->winEndTime.sfn * numSlotsPerSystemFrame) + raReq->winEndTime.slot;
520 timeToCheck = (frameToCheck.sfn * numSlotsPerSystemFrame) + frameToCheck.slot;
522 /* TODO : check how to handle the wrap around scenario of MAX_SFN */
523 if((timeToCheck >= winStartTime) && (timeToCheck <= winEndTime))
524 return WITHIN_WINDOW;
525 else if(timeToCheck < winStartTime)
526 return WINDOW_YET_TO_START;
528 return WINDOW_EXPIRED;
532 * @brief Processes any pending RA request
536 * Function : schProcessRaReq
538 * This function process pending RA request
540 * @param[in] Current timing of the cell
543 bool schProcessRaReq(Inst schInst, SchCellCb *cell, SlotTimingInfo currTime, uint8_t ueId)
545 bool k1Found = false, k2Found = false;
546 uint8_t k0TblIdx = 0, k1TblIdx = 0, k2TblIdx = 0;
547 uint8_t k0Index = 0, k1Index = 0, k2Index = 0;
548 uint8_t k0 = 0, k1 = 0, k2 = 0;
551 uint8_t msg3Delta = 0, msg3MinSchTime = 0;
553 uint8_t totalCfgSlot = 0;
555 uint16_t dciSlot = 0, rarSlot = 0;
556 SlotTimingInfo dciTime, rarTime, msg3Time, pucchTime;
557 RarAlloc *dciSlotAlloc = NULLP; /* Stores info for transmission of PDCCH for RAR */
558 RarAlloc *rarSlotAlloc = NULLP; /* Stores info for transmission of RAR PDSCH */
559 SchPuschInfo *msg3PuschInfo = NULLP; /* Stores MSG3 PUSCH scheduling information */
560 SchK0K1TimingInfoTbl *k0K1InfoTbl=NULLP;
561 SchK2TimingInfoTbl *msg3K2InfoTbl=NULLP;
562 RaRspWindowStatus windowStatus=0;
565 totalCfgSlot = calculateSlotPatternLength(cell->cellCfg.ssbSchCfg.scsCommon, cell->cellCfg.tddCfg.tddPeriod);
567 k0K1InfoTbl = &cell->cellCfg.schInitialDlBwp.k0K1InfoTbl;
568 if(cell->raReq[ueId-1]->isCFRA == false)
570 msg3K2InfoTbl = &cell->cellCfg.schInitialUlBwp.msg3K2InfoTbl;
571 puschMu = cell->cellCfg.numerology;
572 msg3Delta = puschDeltaTable[puschMu];
573 msg3MinSchTime = minMsg3SchTime[cell->cellCfg.numerology];
576 /* Calculating time frame to send DCI for RAR */
577 ADD_DELTA_TO_TIME(currTime, dciTime, PHY_DELTA_DL + SCHED_DELTA, cell->numSlots);
578 dciSlot = dciTime.slot;
580 /* Consider this slot for sending DCI, only if it is a DL slot */
581 if(schGetSlotSymbFrmt(dciSlot, cell->slotFrmtBitMap) == DL_SLOT)
584 /* If PDCCH is already scheduled on this slot, cannot schedule PDSCH for another UE here. */
585 if(cell->schDlSlotInfo[dciSlot]->pdcchUe != 0)
588 /* Check if this slot is within RA response window */
589 windowStatus = isInRaRspWindow(cell->raReq[ueId-1], dciTime, cell->numSlots);
590 if(windowStatus == WITHIN_WINDOW)
592 /* For all k0 values, search for a suitable k2 value to schedule MSG3.
593 * RAR DCI, RAR PDSCH and MSG3 is scheduled only if one such k0-k2 combination
594 * is found. Else no scheduling happens.
596 for(k0TblIdx = 0; k0TblIdx < k0K1InfoTbl->k0k1TimingInfo[dciSlot].numK0; k0TblIdx++)
598 k0Index = k0K1InfoTbl->k0k1TimingInfo[dciSlot].k0Indexes[k0TblIdx].k0Index;
599 k0 = cell->cellCfg.schInitialDlBwp.pdschCommon.timeDomRsrcAllocList[k0Index].k0;
601 /* Calculating time frame to send RAR PDSCH */
602 ADD_DELTA_TO_TIME(dciTime, rarTime, k0, cell->numSlots);
603 rarSlot = rarTime.slot;
605 /* If PDSCH is already scheduled on this slot, cannot schedule PDSCH for another UE here. */
606 if(cell->schDlSlotInfo[rarSlot]->pdschUe != 0)
609 /* If Contention-FREE RA is in progress, allocate resources for
610 * PUCCH for next UL message */
611 if(cell->raReq[ueId-1]->isCFRA)
613 numK1 = k0K1InfoTbl->k0k1TimingInfo[dciTime.slot].k0Indexes[k0TblIdx].k1TimingInfo.numK1;
614 for(k1TblIdx = 0; k1TblIdx < numK1; k1TblIdx++)
616 k1Index = k0K1InfoTbl->k0k1TimingInfo[dciTime.slot].k0Indexes[k0TblIdx].k1TimingInfo.k1Indexes[k1TblIdx];
617 if(cell->raReq[ueId-1]->ueCb->ueCfg.spCellCfg.servCellRecfg.initUlBwp.pucchCfg.dlDataToUlAck)
619 k1 = cell->raReq[ueId-1]->ueCb->ueCfg.spCellCfg.servCellRecfg.initUlBwp.pucchCfg.dlDataToUlAck->\
620 dlDataToUlAckList[k1Index];
624 k1 = defaultUlAckTbl[k1Index];
627 ADD_DELTA_TO_TIME(rarTime, pucchTime, k1, cell->numSlots);
629 if(schGetSlotSymbFrmt(pucchTime.slot, cell->slotFrmtBitMap) == DL_SLOT)
632 if(cell->schUlSlotInfo[pucchTime.slot]->pucchUe != 0)
640 /* Else if contention-based RA is in progress, allocate resources for MSG3 */
641 for(k2TblIdx = 0; k2TblIdx < msg3K2InfoTbl->k2TimingInfo[rarSlot].numK2; k2TblIdx++)
643 k2Index = msg3K2InfoTbl->k2TimingInfo[rarSlot].k2Indexes[k2TblIdx];
644 k2 = cell->cellCfg.schInitialUlBwp.puschCommon.timeDomRsrcAllocList[k2Index].k2;
646 /* Delta is added to the slot allocation for msg3 based on 38.214 section 6.1.2.1 */
648 if(k2 >= msg3MinSchTime)
650 ADD_DELTA_TO_TIME(rarTime, msg3Time, k2, cell->numSlots);
652 if(schGetSlotSymbFrmt(msg3Time.slot % totalCfgSlot, cell->slotFrmtBitMap) == DL_SLOT)
655 /* If PUSCH is already scheduled on this slot, another PUSCH
656 * pdu cannot be scheduled here */
657 if(cell->schUlSlotInfo[msg3Time.slot]->puschUe != 0)
665 if(k1Found || k2Found)
669 else if(windowStatus == WINDOW_EXPIRED)
671 SCH_FREE(cell->raReq[ueId-1]->rachInd, sizeof(RachIndInfo));
672 SCH_FREE(cell->raReq[ueId-1], sizeof(SchRaReq));
676 /* If K0-K2 and K0-K1 combination not found, no scheduling happens */
677 if(!k1Found && !k2Found)
680 /* Allocate memory for RAR PDCCH slot, pointer will be checked at schProcessSlotInd() */
681 SCH_ALLOC(dciSlotAlloc, sizeof(RarAlloc));
682 if(dciSlotAlloc == NULLP)
684 DU_LOG("\nERROR --> SCH : Memory Allocation failed for dciSlotAlloc");
687 cell->schDlSlotInfo[dciSlot]->rarAlloc[ueId-1] = dciSlotAlloc;
689 /* Fill PDCCH and PDSCH scheduling information for RAR */
690 if((schFillRar(cell, rarTime, ueId, dciSlotAlloc, k0Index)) != ROK)
692 DU_LOG("\nERROR --> SCH: Scheduling of RAR failed in slot [%d]", rarSlot);
693 SCH_FREE(dciSlotAlloc, sizeof(RarAlloc));
694 cell->schDlSlotInfo[dciSlot]->rarAlloc[ueId-1] = NULLP;
699 dciSlotAlloc->rarInfo.raRnti = cell->raReq[ueId-1]->raRnti;
700 dciSlotAlloc->rarInfo.tcrnti = cell->raReq[ueId-1]->rachInd->crnti;
701 dciSlotAlloc->rarInfo.RAPID = cell->raReq[ueId-1]->rachInd->preambleIdx;
702 dciSlotAlloc->rarInfo.ta = cell->raReq[ueId-1]->rachInd->timingAdv;
704 if(cell->raReq[ueId-1]->isCFRA)
706 /* Allocate resources for PUCCH */
707 schAllocPucchResource(cell, pucchTime, cell->raReq[ueId-1]->rachInd->crnti,NULLP, FALSE, NULLP);
711 /* Allocate resources for msg3 */
712 msg3PuschInfo = schAllocMsg3Pusch(schInst, cell->raReq[ueId-1]->rachInd->crnti, k2Index, msg3Time, &(cell->raCb[ueId-1].msg3HqProc), FALSE);
715 dciSlotAlloc->rarInfo.ulGrant.bwpSize = cell->cellCfg.schInitialUlBwp.bwp.freqAlloc.numPrb;
716 /* Spec 38.213, section 8.2, 0 : MSG3 PUSCH will be transmitted without frequency hopping */
717 dciSlotAlloc->rarInfo.ulGrant.freqHopFlag = 0;
718 dciSlotAlloc->rarInfo.ulGrant.msg3FreqAlloc.startPrb = msg3PuschInfo->fdAlloc.resAlloc.type1.startPrb;
719 dciSlotAlloc->rarInfo.ulGrant.msg3FreqAlloc.numPrb = msg3PuschInfo->fdAlloc.resAlloc.type1.numPrb;
720 dciSlotAlloc->rarInfo.ulGrant.k2Index = k2Index;
721 dciSlotAlloc->rarInfo.ulGrant.mcs = msg3PuschInfo->tbInfo.mcs;
722 dciSlotAlloc->rarInfo.ulGrant.tpc = 3; /* TODO : Check appropriate value to be filled */
723 /* Spec 38.213, section 8.2 : In a contention based random access
724 * procedure, the CSI request field is reserved. */
725 dciSlotAlloc->rarInfo.ulGrant.csiReq = 0;
729 /* Check if both DCI and RAR are sent in the same slot.
730 * If not, allocate memory RAR PDSCH slot to store RAR info
732 if(dciSlot == rarSlot)
733 dciSlotAlloc->pduPres = BOTH;
736 /* Allocate memory to schedule rarSlot to send RAR, pointer will be checked at schProcessSlotInd() */
737 SCH_ALLOC(rarSlotAlloc, sizeof(RarAlloc));
738 if(rarSlotAlloc == NULLP)
740 DU_LOG("\nERROR --> SCH : Memory Allocation failed for rarSlotAlloc");
741 SCH_FREE(dciSlotAlloc, sizeof(RarAlloc));
742 cell->schDlSlotInfo[dciSlot]->rarAlloc[ueId-1] = NULLP;
745 cell->schDlSlotInfo[rarSlot]->rarAlloc[ueId-1] = rarSlotAlloc;
747 /* Copy all RAR info */
748 memcpy(rarSlotAlloc, dciSlotAlloc, sizeof(RarAlloc));
749 rarSlotAlloc->rarPdcchCfg.dci.pdschCfg = &rarSlotAlloc->rarPdschCfg;
751 /* Assign correct PDU types in corresponding slots */
752 rarSlotAlloc->pduPres = PDSCH_PDU;
753 dciSlotAlloc->pduPres = PDCCH_PDU;
754 dciSlotAlloc->pdschSlot = rarSlot;
757 cell->schDlSlotInfo[dciSlot]->pdcchUe = ueId;
758 cell->schDlSlotInfo[rarSlot]->pdschUe = ueId;
759 if(cell->raReq[ueId-1]->isCFRA)
760 cell->schUlSlotInfo[pucchTime.slot]->pucchUe = ueId;
762 cell->schUlSlotInfo[msg3Time.slot]->puschUe = ueId;
764 /* Create raCb at SCH */
765 createSchRaCb(ueId, cell->raReq[ueId-1], schInst);
767 /* Remove RachInd from pending RA request list */
768 SCH_FREE(cell->raReq[ueId-1]->rachInd, sizeof(RachIndInfo));
769 SCH_FREE(cell->raReq[ueId-1], sizeof(SchRaReq));
777 * @brief process rach indication function.
781 * Function : schProcessRachInd
783 * This function process rach indication
785 * @param[in] rachInd parameters
786 * @param[in] shed instance
789 uint8_t schProcessRachInd(RachIndInfo *rachInd, Inst schInst)
791 SchCellCb *cell = schCb[schInst].cells[schInst];
792 SchRaReq *raReq = NULLP;
799 DU_LOG("\nERROR --> SCH: Failed to find cell in schProcessRachInd");
803 /* Storing RA request in cellCb */
804 GET_UE_ID(rachInd->crnti, ueId);
807 DU_LOG("\nERROR --> SCH: Invalid CRNTI [%d]", rachInd->crnti);
811 SCH_ALLOC(raReq, sizeof(SchRaReq));
814 DU_LOG("\nERROR --> SCH : Memory allocation failure in schProcessRachInd");
815 SCH_FREE(rachInd, sizeof(RachIndInfo));
819 /* calculate the ra-rnti value */
820 raReq->raRnti = calculateRaRnti(rachInd->symbolIdx, rachInd->slotIdx, rachInd->freqIdx);
821 raReq->rachInd = rachInd;
822 if((cell->ueCb[ueId-1].crnti == rachInd->crnti) && (cell->ueCb[ueId-1].state == SCH_UE_HANDIN_IN_PROGRESS))
824 raReq->isCFRA = true;
825 raReq->ueCb = &cell->ueCb[ueId-1];
828 raReq->isCFRA = false;
829 raReq->winStartTime.sfn = rachInd->timingInfo.sfn;
830 raReq->winStartTime.slot = rachInd->timingInfo.slot;
832 /* Converting window size from ms to number of slots */
833 slotDuration = (1 / pow(2, cell->cellCfg.numerology));
834 winNumSlots = (float)cell->cellCfg.schRachCfg.raRspWindow / slotDuration;
836 /* Adding window size to window start time to get window end time */
837 ADD_DELTA_TO_TIME(raReq->winStartTime, raReq->winEndTime, winNumSlots, cell->numSlots);
838 cell->raReq[ueId -1] = raReq;
840 /* Adding UE Id to list of pending UEs to be scheduled */
841 addUeToBeScheduled(cell, ueId);
847 * @brief fill RAR info function.
851 * Function : calculateRaRnti
853 * This function fills pdcch and pdsch info for RAR
855 * @param[in] rar Allocation info
858 * @param[in] offset to pointA to determine freq alloc
861 uint8_t schFillRar(SchCellCb *cell, SlotTimingInfo rarTime, uint16_t ueId, RarAlloc *rarAlloc, uint8_t k0Index)
863 uint8_t coreset0Idx = 0;
864 uint8_t firstSymbol = 0, numSymbols = 0;
865 uint8_t mcs = DEFAULT_MCS; /* MCS fixed to 4 */
866 uint8_t dmrsStartSymbol, startSymbol, numSymbol ;
870 SchBwpDlCfg *initialBwp = &cell->cellCfg.schInitialDlBwp;
871 PdcchCfg *pdcch = &rarAlloc->rarPdcchCfg;
872 PdschCfg *pdsch = &rarAlloc->rarPdschCfg;
873 BwpCfg *bwp = &rarAlloc->bwp;
875 /* derive the sib1 coreset0 params from table 13-1 spec 38.213 */
876 coreset0Idx = initialBwp->pdcchCommon.commonSearchSpace.coresetId;
877 numRbs = coresetIdxTable[coreset0Idx][1];
878 numSymbols = coresetIdxTable[coreset0Idx][2];
880 /* calculate time domain parameters */
881 // note: since slot value is made sl1, RAR can be sent at all slots
882 uint16_t mask = 0x2000;
883 for(firstSymbol=0; firstSymbol<MAX_SYMB_PER_SLOT; firstSymbol++)
885 if(initialBwp->pdcchCommon.commonSearchSpace.monitoringSymbol & mask)
892 bwp->freqAlloc.numPrb = initialBwp->bwp.freqAlloc.numPrb;
893 bwp->freqAlloc.startPrb = initialBwp->bwp.freqAlloc.startPrb;
894 bwp->subcarrierSpacing = initialBwp->bwp.scs;
895 bwp->cyclicPrefix = initialBwp->bwp.cyclicPrefix;
897 /* fill the PDCCH PDU */
898 pdcch->coresetCfg.startSymbolIndex = firstSymbol;
899 pdcch->coresetCfg.durationSymbols = numSymbols;
900 memcpy(pdcch->coresetCfg.freqDomainResource, \
901 cell->cellCfg.schInitialDlBwp.pdcchCommon.commonSearchSpace.freqDomainRsrc, FREQ_DOM_RSRC_SIZE);
903 pdcch->coresetCfg.cceRegMappingType = 1; /* coreset0 is always interleaved */
904 pdcch->coresetCfg.regBundleSize = 6; /* spec-38.211 sec 7.3.2.2 */
905 pdcch->coresetCfg.interleaverSize = 2; /* spec-38.211 sec 7.3.2.2 */
906 pdcch->coresetCfg.coreSetType = 0;
907 pdcch->coresetCfg.coreSetSize = numRbs;
908 pdcch->coresetCfg.shiftIndex = cell->cellCfg.phyCellId;
909 pdcch->coresetCfg.precoderGranularity = 0; /* sameAsRegBundle */
911 pdcch->dci.rnti = cell->raReq[ueId-1]->raRnti; /* RA-RNTI */
912 pdcch->dci.scramblingId = cell->cellCfg.phyCellId;
913 pdcch->dci.scramblingRnti = 0;
914 pdcch->dci.cceIndex = 4; /* considering SIB1 is sent at cce 0-1-2-3 */
915 pdcch->dci.aggregLevel = 4;
916 pdcch->dci.beamPdcchInfo.numPrgs = 1;
917 pdcch->dci.beamPdcchInfo.prgSize = 1;
918 pdcch->dci.beamPdcchInfo.digBfInterfaces = 0;
919 pdcch->dci.beamPdcchInfo.prg[0].pmIdx = 0;
920 pdcch->dci.beamPdcchInfo.prg[0].beamIdx[0] = 0;
921 pdcch->dci.txPdcchPower.powerValue = 0;
922 pdcch->dci.txPdcchPower.powerControlOffsetSS = 0;
923 pdcch->dci.pdschCfg = pdsch;
925 /* fill the PDSCH PDU */
927 pdsch->pduBitmap = 0; /* PTRS and CBG params are excluded */
928 pdsch->rnti = cell->raReq[ueId-1]->raRnti; /* RA-RNTI */
930 pdsch->numCodewords = 1;
931 for(cwCount = 0; cwCount < pdsch->numCodewords; cwCount++)
933 pdsch->codeword[cwCount].targetCodeRate = 308;
934 pdsch->codeword[cwCount].qamModOrder = 2;
935 pdsch->codeword[cwCount].mcsIndex = mcs; /* mcs configured to 4 */
936 pdsch->codeword[cwCount].mcsTable = 0; /* notqam256 */
937 pdsch->codeword[cwCount].rvIndex = 0;
938 /* RAR PDU length and FAPI payload header length */
939 tbSize = schCalcTbSize(RAR_PAYLOAD_SIZE + TX_PAYLOAD_HDR_LEN);
940 pdsch->codeword[cwCount].tbSize = tbSize;
942 pdsch->dataScramblingId = cell->cellCfg.phyCellId;
943 pdsch->numLayers = 1;
944 pdsch->transmissionScheme = 0;
946 pdsch->dmrs.dlDmrsSymbPos = 4; /* Bitmap value 00000000000100 i.e. using 3rd symbol for PDSCH DMRS */
947 pdsch->dmrs.dmrsConfigType = 0; /* type-1 */
948 pdsch->dmrs.dlDmrsScramblingId = cell->cellCfg.phyCellId;
949 pdsch->dmrs.scid = 0;
950 pdsch->dmrs.numDmrsCdmGrpsNoData = 1;
951 pdsch->dmrs.dmrsPorts = 0;
952 pdsch->dmrs.mappingType = DMRS_MAP_TYPE_A; /* Type-A */
953 pdsch->dmrs.nrOfDmrsSymbols = NUM_DMRS_SYMBOLS;
954 pdsch->dmrs.dmrsAddPos = DMRS_ADDITIONAL_POS;
956 pdsch->pdschTimeAlloc.rowIndex = k0Index;
957 pdsch->pdschTimeAlloc.timeAlloc.startSymb = initialBwp->pdschCommon.timeDomRsrcAllocList[k0Index].startSymbol;
958 pdsch->pdschTimeAlloc.timeAlloc.numSymb = initialBwp->pdschCommon.timeDomRsrcAllocList[k0Index].lengthSymbol;
960 pdsch->pdschFreqAlloc.vrbPrbMapping = 0; /* non-interleaved */
961 pdsch->pdschFreqAlloc.resourceAllocType = 1; /* RAT type-1 RIV format */
962 pdsch->pdschFreqAlloc.freqAlloc.startPrb = MAX_NUM_RB;
963 pdsch->pdschFreqAlloc.freqAlloc.numPrb = \
964 schCalcNumPrb(tbSize, mcs, initialBwp->pdschCommon.timeDomRsrcAllocList[k0Index].lengthSymbol);
966 /* Find total symbols occupied including DMRS */
967 dmrsStartSymbol = findDmrsStartSymbol(pdsch->dmrs.dlDmrsSymbPos);
968 /* If there are no DRMS symbols, findDmrsStartSymbol() returns MAX_SYMB_PER_SLOT,
969 * in that case only PDSCH symbols are marked as occupied */
970 if(dmrsStartSymbol == MAX_SYMB_PER_SLOT)
972 startSymbol = pdsch->pdschTimeAlloc.timeAlloc.startSymb;
973 numSymbol = pdsch->pdschTimeAlloc.timeAlloc.numSymb;
975 /* If DMRS symbol is found, mark DMRS and PDSCH symbols as occupied */
978 startSymbol = dmrsStartSymbol;
979 numSymbol = pdsch->dmrs.nrOfDmrsSymbols + pdsch->pdschTimeAlloc.timeAlloc.numSymb;
982 /* Allocate the number of PRBs required for RAR PDSCH */
983 if((allocatePrbDl(cell, rarTime, startSymbol, numSymbol,\
984 &pdsch->pdschFreqAlloc.freqAlloc.startPrb, pdsch->pdschFreqAlloc.freqAlloc.numPrb)) != ROK)
986 DU_LOG("\nERROR --> SCH : allocatePrbDl() failed for RAR");
990 pdsch->beamPdschInfo.numPrgs = 1;
991 pdsch->beamPdschInfo.prgSize = 1;
992 pdsch->beamPdschInfo.digBfInterfaces = 0;
993 pdsch->beamPdschInfo.prg[0].pmIdx = 0;
994 pdsch->beamPdschInfo.prg[0].beamIdx[0] = 0;
995 pdsch->txPdschPower.powerControlOffset = 0;
996 pdsch->txPdschPower.powerControlOffsetSS = 0;
1001 /* @brief Process RACH resource release after CFRA
1005 * Function : MacSchRachRsrcRel
1007 * This function processes RACH resorce release
1008 * from MAC after CFRA. It releases the dedicated
1009 * preamble alloted to the UE
1011 * @param[in] Post structure
1012 * @param[in] RACH resource release
1016 uint8_t MacSchRachRsrcRel(Pst *pst, SchRachRsrcRel *schRachRsrcRel)
1019 uint8_t ssbIdx = 0, cfraSsbIdx = 0;
1020 uint16_t cellIdx = 0;
1021 Inst inst = pst->dstInst - SCH_INST_START;
1022 SchCellCb *cellCb = NULLP;
1023 SchUeCb *ueCb = NULLP;
1025 DU_LOG("\nINFO --> SCH : Received RACH resource release for Cell ID [%d] CRNTI [%d]", \
1026 schRachRsrcRel->cellId, schRachRsrcRel->crnti);
1029 for(cellIdx = 0; cellIdx < MAX_NUM_CELL; cellIdx++)
1031 if((schCb[inst].cells[cellIdx]) && (schCb[inst].cells[cellIdx]->cellId == schRachRsrcRel->cellId))
1033 cellCb = schCb[inst].cells[cellIdx];
1041 ueCb = schGetUeCb(cellCb, schRachRsrcRel->crnti);
1042 if(ueCb->crnti != schRachRsrcRel->crnti)
1044 DU_LOG("\nERROR --> SCH : CRNTI [%d] not found", schRachRsrcRel->crnti);
1050 DU_LOG("\nERROR --> SCH : Cell ID [%d] not found", schRachRsrcRel->cellId);
1054 /* Free SSB resource if no failure has occurred until this step */
1057 for(ssbIdx = 0; ssbIdx < schRachRsrcRel->cfraResource.numSsb; ssbIdx++)
1059 /* Search each ssbIdx entry in UE Cb */
1060 for(cfraSsbIdx = 0; cfraSsbIdx < ueCb->cfraResource.numSsb; cfraSsbIdx++)
1062 if(ueCb->cfraResource.ssbResource[cfraSsbIdx].ssbIdx == schRachRsrcRel->cfraResource.ssbResource[ssbIdx].ssbIdx)
1064 /* If ssbIdx entry is found in UE CB, free dedicated resources
1065 * for this ssbIdx */
1066 UNSET_ONE_BIT(ueCb->cfraResource.ssbResource[cfraSsbIdx].raPreambleIdx, cellCb->dedPreambleBitMap);
1067 memset(&ueCb->cfraResource.ssbResource[cfraSsbIdx], 0, sizeof(SchCfraSsbResource));
1068 ueCb->cfraResource.numSsb--;
1075 /* Free RACH resource release memory allocated by MAC */
1076 SCH_FREE(schRachRsrcRel, sizeof(SchRachRsrcRel));
1079 /* @brief process MSG4 completion
1083 * Function : schMsg4Complete
1085 * This function updates ra state and msg4 Hqrq
1086 * proc upon MSG4 completion
1087 * @param[in] SchUeCb *ueCb, UE cb pointer
1090 void schMsg4Complete(SchUeCb *ueCb)
1092 DU_LOG("\nINFO --> SCH: State change for ueId[%2d] to SCH_RA_STATE_MSG4_DONE\n",ueCb->ueId);
1093 ueCb->cellCb->raCb[ueCb->ueId-1].raState = SCH_RA_STATE_MSG4_DONE;
1094 ueCb->msg4Proc = ueCb->retxMsg4HqProc = NULLP;
1096 /**********************************************************************
1098 **********************************************************************/