[Epic-ID: ODUHIGH-462][Task-ID: ODUHIGH-472] Handling of drx timer in SCH [storing...
[o-du/l2.git] / src / 5gnrsch / sch_rach.c
1 /*******************************************************************************
2 ################################################################################
3 #   Copyright (c) [2017-2019] [Radisys]                                        #
4 #                                                                              #
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                                    #
8 #                                                                              #
9 #       http://www.apache.org/licenses/LICENSE-2.0                             #
10 #                                                                              #
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 *******************************************************************************/
18
19 /************************************************************************
20  
21      Name:     sch_rach.c
22   
23      Type:     C source file
24   
25      Desc:     C source code for rach handling functions
26   
27      File:     sch_rach.c
28   
29 **********************************************************************/
30
31 /** @file sch_rach.c
32 @brief This file implements the rach handling.
33 */
34 #include "common_def.h"
35 #include "tfu.h"
36 #include "lrg.h"
37 #include "tfu.x"
38 #include "lrg.x"
39 #include "du_log.h"
40 #include "du_app_mac_inf.h"
41 #include "mac_sch_interface.h"
42 #include "sch.h"
43 #include "sch_utils.h"
44
45 SchRachRsrcRspFunc SchRachRsrcRspOpts[] =
46 {
47    packSchRachRsrcRsp,      /* LC */
48    MacProcSchRachRsrcRsp,   /* TC */
49    packSchRachRsrcRsp       /* LWLC */
50 };
51
52 /**
53  * @brief Checks if PRACH can be scheduled in current slot
54  *
55  * @details
56  *
57  *     Function : schCheckPrachOcc
58  *
59  *     This function checks if PRACH can be scheduled in 
60  *     current slot
61  *
62  *  @param[in]  Cell Cb
63  *              Slot timing
64  *  @return  TRUE
65  *           FALSE
66  **/
67 bool schCheckPrachOcc(SchCellCb *cell, SlotTimingInfo prachOccasionTimingInfo)
68 {
69    uint8_t  prachCfgIdx = 0;
70    uint8_t  x = 0;
71    uint8_t  y = 0;
72    uint8_t  subFrame = 0;
73    uint16_t prachSubframe = 0;
74
75    prachCfgIdx      = cell->cellCfg.schRachCfg.prachCfgIdx;
76
77    /* derive the prachCfgIdx table paramters */
78    x                = prachCfgIdxTable[prachCfgIdx][1];
79    y                = prachCfgIdxTable[prachCfgIdx][2];
80    prachSubframe    = prachCfgIdxTable[prachCfgIdx][3];
81
82    if((prachOccasionTimingInfo.sfn%x) == y)
83    {
84       subFrame = prachOccasionTimingInfo.slot/pow(2, cell->cellCfg.numerology);
85
86       /* check for subFrame number */
87       if ((1 << subFrame) & prachSubframe)
88       {
89          /* prach ocassion present in this subframe */
90 #ifdef NR_TDD
91          if(UL_SLOT != schGetSlotSymbFrmt(prachOccasionTimingInfo.slot % cell->numSlotsInPeriodicity,\
92          cell->slotFrmtBitMap))
93          {
94             DU_LOG("\nERROR  --> SCH : PrachCfgIdx %d doesn't support UL slot", prachCfgIdx);
95             return FALSE;
96          }
97 #endif
98          return TRUE;
99       }
100    }
101    return FALSE;
102 }
103
104 /**
105  * @brief Calculate number of PRBs to be allocated for PRACH 
106  *
107  * @details
108  *
109  *     Function : schCalcPrachNumRb
110  *
111  *     Calculate number of PRBs to be allocated for PRACH
112  *
113  *  @param[in]  SchCellCb *cell, cell cb
114  *  @return  Number of PRBs
115  **/
116 uint8_t schCalcPrachNumRb(SchCellCb *cell)
117 {
118    uint8_t tableIdx = 0;
119    uint16_t puschScs = convertScsEnumValToScsVal(cell->cellCfg.schInitialUlBwp.bwp.scs);
120
121    for(tableIdx=0; tableIdx < MAX_RACH_NUM_RB_IDX; tableIdx++)
122    {
123       if((numRbForPrachTable[tableIdx][0] == cell->cellCfg.schRachCfg.rootSeqLen) &&
124             (numRbForPrachTable[tableIdx][1] == cell->cellCfg.schRachCfg.prachSubcSpacing) &&
125             (numRbForPrachTable[tableIdx][2] == puschScs))
126       {
127          return numRbForPrachTable[tableIdx][3];
128       }
129    }
130    return 0;
131 }
132
133 /**
134  * @brief resource allocation for PRACH
135  *
136  * @details
137  *
138  *     Function : schPrachResAlloc
139  *
140  *     This function handles PRACH allocation
141  *
142  *  @param[in]  SchCellCb *cell, cell cb
143  *  @param[in]  UlSchedInfo *ulSchedInfo, UL scheduling info
144  *  @return  void
145  **/
146 void schPrachResAlloc(SchCellCb *cell, UlSchedInfo *ulSchedInfo, SlotTimingInfo prachOccasionTimingInfo)
147 {
148    uint8_t  numPrachRb = 0;
149    uint8_t  numRa = 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;
157
158    if(cell == NULLP)
159    {
160       DU_LOG("\nERROR  --> SCH : schPrachResAlloc(): Received cellCb is null");
161       return;
162    }
163
164    /* If this slot is not a PRACH occassion, return */
165    if(!schCheckPrachOcc(cell, prachOccasionTimingInfo))
166       return;
167
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];
173
174    /* numRa determined as 𝑛 belonging {0,1,.., M − 1},
175     * where M is given by msg1Fdm */
176    numRa = (cell->cellCfg.schRachCfg.msg1Fdm - 1);
177
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);
183
184    /* prach info */
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);
192 }
193
194 /**
195  * @brief Process RACH resource request for CFRA
196  *
197  * @details
198  *
199  *     Function : MacSchRachRsrcReq
200  *     
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
204  *     response
205  *     
206  *  @param[in]  Post structure
207  *  @param[in]  RACH resource request
208  *  @return     ROK
209  *              RFAILED
210  **/
211 uint8_t MacSchRachRsrcReq(Pst *pst, SchRachRsrcReq *schRachRsrcReq)
212 {
213    uint8_t      ssbIdx = 0, cfraSsbIdx = 0;
214    uint8_t      firstCFPreambleIndex = 0, lastCFPreambleIndex = 0;
215    uint16_t     cellIdx = 0;
216    uint64_t     mask = 0;
217    Pst          rspPst;
218    Inst         inst = pst->dstInst - SCH_INST_START;
219    SchCellCb    *cellCb = NULLP;
220    SchUeCb      *ueCb = NULLP;
221    SchRachRsrcRsp *rachRsrcRsp = NULLP;
222
223    DU_LOG("\nINFO  -->  SCH : Received RACH resource request for Cell ID [%d] CRNTI [%d]", \
224          schRachRsrcReq->cellId, schRachRsrcReq->crnti);
225
226  /* Fill RACH resource response to MAC */
227    SCH_ALLOC(rachRsrcRsp, sizeof(SchRachRsrcRsp));
228    if(!rachRsrcRsp)
229    {   
230       DU_LOG("\nERROR  -->  SCH : Memory allocation failed for RACH resource response");
231       return RFAILED;
232    }   
233    rachRsrcRsp->cellId = schRachRsrcReq->cellId;
234    rachRsrcRsp->crnti = schRachRsrcReq->crnti;
235    rachRsrcRsp->result = RSP_OK;
236
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;
241
242    /* Fetch Cell CB */
243    for(cellIdx = 0; cellIdx < MAX_NUM_CELL; cellIdx++)
244    {
245       if((schCb[inst].cells[cellIdx]) && (schCb[inst].cells[cellIdx]->cellId == schRachRsrcReq->cellId))
246       {
247          cellCb = schCb[inst].cells[cellIdx];
248          break;
249       }
250    }
251    
252    if(cellCb)
253    {
254       /* Fetch UE CB */
255       ueCb = schGetUeCb(cellCb, schRachRsrcReq->crnti);
256       if(ueCb->crnti != schRachRsrcReq->crnti)
257       {
258          DU_LOG("\nERROR  -->  SCH : CRNTI [%d] not found" ,schRachRsrcReq->crnti);
259          rachRsrcRsp->result = RSP_NOK;
260       }
261    }
262    else
263    {
264       DU_LOG("\nERROR  -->  SCH : Cell ID [%d] not found" ,schRachRsrcReq->cellId);
265       rachRsrcRsp->result = RSP_NOK;
266    }
267
268    /* Allocate SSB resource if no failure has occurred until this step */
269    if(rachRsrcRsp->result == RSP_OK)
270    {
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;
277
278       /* Allocate resource for each SSB index requested */
279       for(ssbIdx = 0; ssbIdx < schRachRsrcReq->numSsb; ssbIdx++)
280       {
281          /* Find the first CF Preamble index not dedicated to any UE currently */
282          while(firstCFPreambleIndex <= lastCFPreambleIndex)
283          {
284             mask = 1 << firstCFPreambleIndex;
285             if(cellCb->dedPreambleBitMap & mask)
286             {
287                firstCFPreambleIndex++;
288                continue;
289             }
290             else
291                break;
292          }
293
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)
301          {
302             ueCb->cfraResource.ssbResource[cfraSsbIdx].ssbIdx = schRachRsrcReq->ssbIdx[ssbIdx]; 
303             ueCb->cfraResource.ssbResource[cfraSsbIdx].raPreambleIdx = firstCFPreambleIndex;
304             SET_ONE_BIT(firstCFPreambleIndex, cellCb->dedPreambleBitMap);
305             cfraSsbIdx++;
306             firstCFPreambleIndex++;
307          }
308          else
309          {
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 */
313             break;
314          }
315       } /* End of for */
316
317       ueCb->cfraResource.numSsb = cfraSsbIdx;
318
319       if(ueCb->cfraResource.numSsb == 0)
320       {
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;
324       }
325       else
326       {   
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));
331       }
332    } /* End of if */
333
334    /* Free RACH resource request memory allocated by MAC */
335    SCH_FREE(schRachRsrcReq, sizeof(SchRachRsrcReq));
336
337    /* Send RACH resource response to MAC */
338    return (SchRachRsrcRspOpts[rspPst.selector](&rspPst, rachRsrcRsp));
339 }
340
341 /**
342  * @brief calculate ra-rnti function. 
343  *
344  * @details
345  *
346  *     Function : calculateRaRnti
347  *     
348  *     This function calculates ra-rnti
349  *     
350  *  @param[in]  symbol index
351  *  @param[in]  slot index
352  *  @param[in]  frequency index
353  *  @return  ra-rnti
354  **/
355 uint16_t calculateRaRnti(uint8_t symbolIdx, uint8_t slotIdx, uint8_t freqIdx)
356 {
357    uint16_t raRnti = 0;
358    uint8_t  ulCarrierIdx = 0; /* Uplink carrier used for MSG1 transmission. 0:NUL carrier; 1:SUL carrier */
359    
360    /* Refer to spec 38.321, section 5.1.3 */
361    raRnti = (1 + symbolIdx + (14*slotIdx) + (14*80*freqIdx) + (14*80*8*ulCarrierIdx));
362    return raRnti;
363 }
364
365 /**
366  * @brief create raCb function. 
367  *
368  * @details
369  *
370  *     Function : createSchRaCb
371  *     
372  *     This function create raCb
373  *     
374  *  @param[in]  crnti
375  *  @param[in]  shed instance
376  *  @return  void
377  **/
378 void createSchRaCb(uint8_t ueId, SchRaReq *raReq, Inst schInst)
379 {
380    if(raReq->isCFRA)
381    {
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))
385       {
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;
390       }
391    }
392    else
393    {
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;
399    }
400    schCb[schInst].cells[schInst]->raCb[ueId -1].cell = schCb[schInst].cells[schInst];
401 }
402
403 /**
404  * @brief resource allocation for msg3 PUSCH
405  *
406  * @details
407  *
408  *     Function : schAllocMsg3Pusch 
409  *     
410  *     This function handles msg3 PUSCH allocation
411  *     
412  *  @param[in]  Inst schInst, SCH instance
413  *  @param[in]  slot, current slot
414  *  @param[out]  msg3StartRb
415  *  @param[out]  msg3NumRb
416  *  @return  void
417  **/
418 SchPuschInfo* schAllocMsg3Pusch(Inst schInst, uint16_t crnti, uint8_t k2Index, SlotTimingInfo msg3SlotTime, SchUlHqProcCb* msg3HqProc, bool isRetx)
419 {
420    SchCellCb      *cell          = NULLP;
421    SchUlSlotInfo  *schUlSlotInfo = NULLP;
422    uint8_t    mcs       = DEFAULT_MCS;
423    uint8_t    startSymb = 0;
424    uint8_t    symbLen   = 0; 
425    uint16_t   startRb   = 0;
426    uint16_t   numRb     = 0;
427    uint16_t   tbSize    = 0;
428
429    cell = schCb[schInst].cells[schInst];
430    if(cell == NULL)
431    {
432       DU_LOG("\n\nERROR  -->  SCH :  Failed to find cell in schAllocMsg3Pusch");
433       return NULLP;
434    }
435
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;
439
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);
445
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)
450    {
451       DU_LOG("\nERROR  -->  SCH :  Memory allocation failed in schAllocMsg3Pusch");
452       return NULLP;
453    }
454
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*/
458
459    schUlSlotInfo->schPuschInfo->crnti             = crnti;
460    schUlSlotInfo->schPuschInfo->harqProcId        = msg3HqProc->procId;
461    schUlSlotInfo->schPuschInfo->resAllocType      = SCH_ALLOC_TYPE_1;
462    schUlSlotInfo->schPuschInfo->fdAlloc.startPrb  = startRb;
463    schUlSlotInfo->schPuschInfo->fdAlloc.numPrb    = numRb;
464    schUlSlotInfo->schPuschInfo->tdAlloc.startSymb = startSymb;
465    schUlSlotInfo->schPuschInfo->tdAlloc.numSymb   = symbLen;
466    schUlSlotInfo->schPuschInfo->tbInfo.qamOrder   = QPSK_MODULATION;  /* QPSK modulation */
467    schUlSlotInfo->schPuschInfo->tbInfo.mcs           = mcs;
468    schUlSlotInfo->schPuschInfo->tbInfo.mcsTable   = SCH_MCS_TABLE_QAM_64;
469    schUlSlotInfo->schPuschInfo->tbInfo.ndi        = NEW_TRANSMISSION; /* new transmission */
470    schUlSlotInfo->schPuschInfo->tbInfo.rv               = 0;
471    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;
475    if(!isRetx)
476    {
477       msg3HqProc->strtSymbl = startSymb;
478       msg3HqProc->numSymbl = symbLen;
479       msg3HqProc->puschResType = schUlSlotInfo->schPuschInfo->resAllocType;
480       msg3HqProc->puschStartPrb = schUlSlotInfo->schPuschInfo->fdAlloc.startPrb;
481       msg3HqProc->puschNumPrb = schUlSlotInfo->schPuschInfo->fdAlloc.numPrb;
482       msg3HqProc->tbInfo.qamOrder = schUlSlotInfo->schPuschInfo->tbInfo.qamOrder;
483       msg3HqProc->tbInfo.iMcs = schUlSlotInfo->schPuschInfo->tbInfo.mcs;
484       msg3HqProc->tbInfo.mcsTable = schUlSlotInfo->schPuschInfo->tbInfo.mcsTable;
485       msg3HqProc->tbInfo.ndi = schUlSlotInfo->schPuschInfo->tbInfo.ndi;
486       msg3HqProc->tbInfo.rv = schUlSlotInfo->schPuschInfo->tbInfo.rv;
487       msg3HqProc->tbInfo.tbSzReq = schUlSlotInfo->schPuschInfo->tbInfo.tbSize;
488       msg3HqProc->dmrsMappingType = schUlSlotInfo->schPuschInfo->dmrsMappingType;
489       msg3HqProc->nrOfDmrsSymbols = schUlSlotInfo->schPuschInfo->nrOfDmrsSymbols;
490       msg3HqProc->dmrsAddPos = schUlSlotInfo->schPuschInfo->dmrsAddPos;
491    }
492    return schUlSlotInfo->schPuschInfo;
493 }
494
495 /**
496  * @brief Check if a time frame is in RA Response window
497  *
498  * @details
499  *
500  *     Function : isInRaRspWindow
501  *
502  *     Check if a time frame is in RA Response window
503  *
504  *  @param[in]  RA request
505  *  @param[in]  Time frame to check
506  *  @param[in]  Total number of slot per radio frame
507  *  @return  true 
508  *  @return  false
509  **/
510 RaRspWindowStatus isInRaRspWindow(SchRaReq *raReq, SlotTimingInfo frameToCheck, uint16_t numSlotsPerSystemFrame)
511 {
512    uint32_t winStartTime, winEndTime, timeToCheck;
513    
514    winStartTime = (raReq->winStartTime.sfn * numSlotsPerSystemFrame) + raReq->winStartTime.slot;
515    winEndTime = (raReq->winEndTime.sfn * numSlotsPerSystemFrame) + raReq->winEndTime.slot;
516    timeToCheck = (frameToCheck.sfn * numSlotsPerSystemFrame) + frameToCheck.slot;
517
518    /* TODO : check how to handle the wrap around scenario of MAX_SFN */
519    if((timeToCheck >= winStartTime) && (timeToCheck <= winEndTime))
520       return WITHIN_WINDOW;
521    else if(timeToCheck < winStartTime)
522       return WINDOW_YET_TO_START;
523       
524    return WINDOW_EXPIRED;
525 }
526
527 /**
528  * @brief Processes any pending RA request
529  *
530  * @details
531  *
532  *     Function : schProcessRaReq
533  *
534  *     This function process pending RA request
535  *
536  *  @param[in]  Current timing of the cell
537  *  @return  ROK
538  **/
539 bool schProcessRaReq(Inst schInst, SchCellCb *cell, SlotTimingInfo currTime, uint8_t ueId)
540 {
541    bool      k1Found = false, k2Found = false;
542    uint8_t   k0TblIdx = 0, k1TblIdx = 0, k2TblIdx = 0;
543    uint8_t   k0Index = 0, k1Index = 0, k2Index = 0;
544    uint8_t   k0 = 0, k1 = 0, k2 = 0;
545    uint8_t   numK1 = 0;
546    uint8_t   puschMu = 0;
547    uint8_t   msg3Delta = 0, msg3MinSchTime = 0;
548 #ifdef NR_TDD
549    uint8_t   totalCfgSlot = 0;
550 #endif
551    uint16_t             dciSlot = 0, rarSlot = 0;
552    SlotTimingInfo       dciTime, rarTime, msg3Time, pucchTime;
553    RarAlloc             *dciSlotAlloc = NULLP;    /* Stores info for transmission of PDCCH for RAR */
554    RarAlloc             *rarSlotAlloc = NULLP;    /* Stores info for transmission of RAR PDSCH */
555    SchPuschInfo         *msg3PuschInfo = NULLP;   /* Stores MSG3 PUSCH scheduling information */
556    SchK0K1TimingInfoTbl *k0K1InfoTbl=NULLP;    
557    SchK2TimingInfoTbl   *msg3K2InfoTbl=NULLP;
558    RaRspWindowStatus    windowStatus=0;
559    
560 #ifdef NR_TDD
561    totalCfgSlot = calculateSlotPatternLength(cell->cellCfg.ssbSchCfg.scsCommon, cell->cellCfg.tddCfg.tddPeriod);
562 #endif
563    k0K1InfoTbl    = &cell->cellCfg.schInitialDlBwp.k0K1InfoTbl;
564    if(cell->raReq[ueId-1]->isCFRA == false)
565    {
566       msg3K2InfoTbl  = &cell->cellCfg.schInitialUlBwp.msg3K2InfoTbl;
567       puschMu        = cell->cellCfg.numerology;
568       msg3Delta      = puschDeltaTable[puschMu];
569       msg3MinSchTime = minMsg3SchTime[cell->cellCfg.numerology];
570    }
571
572    /* Calculating time frame to send DCI for RAR */
573    ADD_DELTA_TO_TIME(currTime, dciTime, PHY_DELTA_DL + SCHED_DELTA, cell->numSlots);
574    dciSlot = dciTime.slot;
575 #ifdef NR_TDD
576    /* Consider this slot for sending DCI, only if it is a DL slot */
577    if(schGetSlotSymbFrmt(dciSlot, cell->slotFrmtBitMap) == DL_SLOT)
578 #endif
579    {
580       /* If PDCCH is already scheduled on this slot, cannot schedule PDSCH for another UE here. */
581       if(cell->schDlSlotInfo[dciSlot]->pdcchUe != 0)
582          return false;
583
584       /* Check if this slot is within RA response window */
585       windowStatus = isInRaRspWindow(cell->raReq[ueId-1], dciTime, cell->numSlots);
586       if(windowStatus == WITHIN_WINDOW)
587       {
588          /* For all k0 values, search for a suitable k2 value to schedule MSG3.
589           * RAR DCI, RAR PDSCH and MSG3 is scheduled only if one such k0-k2 combination
590           * is found. Else no scheduling happens. 
591           */
592          for(k0TblIdx = 0; k0TblIdx < k0K1InfoTbl->k0k1TimingInfo[dciSlot].numK0; k0TblIdx++)
593          {
594             k0Index = k0K1InfoTbl->k0k1TimingInfo[dciSlot].k0Indexes[k0TblIdx].k0Index;
595             k0 = cell->cellCfg.schInitialDlBwp.pdschCommon.timeDomRsrcAllocList[k0Index].k0;
596
597             /* Calculating time frame to send RAR PDSCH */
598             ADD_DELTA_TO_TIME(dciTime, rarTime, k0, cell->numSlots);
599             rarSlot = rarTime.slot;
600             
601             /* If PDSCH is already scheduled on this slot, cannot schedule PDSCH for another UE here. */
602             if(cell->schDlSlotInfo[rarSlot]->pdschUe != 0)
603                continue;
604
605             /* If Contention-FREE RA is in progress, allocate resources for
606              * PUCCH for next UL message */
607             if(cell->raReq[ueId-1]->isCFRA)
608             {
609                numK1 = k0K1InfoTbl->k0k1TimingInfo[dciTime.slot].k0Indexes[k0TblIdx].k1TimingInfo.numK1;
610                for(k1TblIdx = 0; k1TblIdx < numK1; k1TblIdx++)
611                {   
612                   k1Index = k0K1InfoTbl->k0k1TimingInfo[dciTime.slot].k0Indexes[k0TblIdx].k1TimingInfo.k1Indexes[k1TblIdx];
613                   if(cell->raReq[ueId-1]->ueCb->ueCfg.spCellCfg.servCellCfg.initUlBwp.pucchCfg.dlDataToUlAck)
614                   {
615                      k1 = cell->raReq[ueId-1]->ueCb->ueCfg.spCellCfg.servCellCfg.initUlBwp.pucchCfg.dlDataToUlAck->\
616                         dlDataToUlAckList[k1Index];
617                   }
618                   else
619                   {
620                      k1 = defaultUlAckTbl[k1Index];
621                   }
622
623                   ADD_DELTA_TO_TIME(rarTime, pucchTime, k1, cell->numSlots);
624 #ifdef NR_TDD
625                   if(schGetSlotSymbFrmt(pucchTime.slot, cell->slotFrmtBitMap) == DL_SLOT)
626                      continue;
627 #endif
628                   if(cell->schUlSlotInfo[pucchTime.slot]->pucchUe != 0)
629                      continue;
630                   k1Found = true;
631                   break;
632                }
633             }
634             else
635             {
636                /* Else if contention-based RA is in progress, allocate resources for MSG3 */
637                for(k2TblIdx = 0; k2TblIdx < msg3K2InfoTbl->k2TimingInfo[rarSlot].numK2; k2TblIdx++)
638                {
639                   k2Index = msg3K2InfoTbl->k2TimingInfo[rarSlot].k2Indexes[k2TblIdx];
640                   k2 = cell->cellCfg.schInitialUlBwp.puschCommon.timeDomRsrcAllocList[k2Index].k2;
641
642                   /* Delta is added to the slot allocation for msg3 based on 38.214 section 6.1.2.1 */
643                   k2 = k2 + msg3Delta;
644                   if(k2 >= msg3MinSchTime)
645                   {
646                      ADD_DELTA_TO_TIME(rarTime, msg3Time, k2, cell->numSlots);
647 #ifdef NR_TDD
648                      if(schGetSlotSymbFrmt(msg3Time.slot % totalCfgSlot, cell->slotFrmtBitMap) == DL_SLOT)
649                         continue;
650 #endif
651                      /* If PUSCH is already scheduled on this slot, another PUSCH
652                       * pdu cannot be scheduled here */
653                      if(cell->schUlSlotInfo[msg3Time.slot]->puschUe != 0)
654                         continue;
655
656                      k2Found = true;
657                      break;
658                   }
659                }
660             }
661             if(k1Found || k2Found)
662                break;
663          }
664       }
665       else if(windowStatus == WINDOW_EXPIRED)
666       {
667          SCH_FREE(cell->raReq[ueId-1]->rachInd, sizeof(RachIndInfo));
668          SCH_FREE(cell->raReq[ueId-1], sizeof(SchRaReq));
669          return false;
670       }
671
672       /* If K0-K2 and K0-K1 combination not found, no scheduling happens */
673       if(!k1Found && !k2Found)
674          return false;
675
676       /* Allocate memory for RAR PDCCH slot, pointer will be checked at schProcessSlotInd() */
677       SCH_ALLOC(dciSlotAlloc, sizeof(RarAlloc));
678       if(dciSlotAlloc == NULLP)
679       {
680          DU_LOG("\nERROR  -->  SCH : Memory Allocation failed for dciSlotAlloc");
681          return false;
682       }
683       cell->schDlSlotInfo[dciSlot]->rarAlloc[ueId-1] = dciSlotAlloc;
684
685       /* Fill PDCCH and PDSCH scheduling information for RAR */
686       if((schFillRar(cell, rarTime, ueId, dciSlotAlloc, k0Index)) != ROK)
687       {
688          DU_LOG("\nERROR  -->  SCH: Scheduling of RAR failed in slot [%d]", rarSlot);
689          SCH_FREE(dciSlotAlloc, sizeof(RarAlloc));
690          cell->schDlSlotInfo[dciSlot]->rarAlloc[ueId-1] = NULLP;
691          return false;
692       }
693
694       /* Fill RAR info */
695       dciSlotAlloc->rarInfo.raRnti = cell->raReq[ueId-1]->raRnti;
696       dciSlotAlloc->rarInfo.tcrnti = cell->raReq[ueId-1]->rachInd->crnti;
697       dciSlotAlloc->rarInfo.RAPID = cell->raReq[ueId-1]->rachInd->preambleIdx;
698       dciSlotAlloc->rarInfo.ta = cell->raReq[ueId-1]->rachInd->timingAdv;
699
700       if(cell->raReq[ueId-1]->isCFRA)
701       {
702          /* Allocate resources for PUCCH */
703          schAllocPucchResource(cell, pucchTime, cell->raReq[ueId-1]->rachInd->crnti,NULLP, FALSE, NULLP);
704       }
705       else
706       {
707          /* Allocate resources for msg3 */
708          msg3PuschInfo = schAllocMsg3Pusch(schInst, cell->raReq[ueId-1]->rachInd->crnti, k2Index, msg3Time, &(cell->raCb[ueId-1].msg3HqProc), FALSE);
709          if(msg3PuschInfo)
710          {
711             dciSlotAlloc->rarInfo.ulGrant.bwpSize = cell->cellCfg.schInitialUlBwp.bwp.freqAlloc.numPrb;
712             /* Spec 38.213, section 8.2, 0 : MSG3 PUSCH will be transmitted without frequency hopping */
713             dciSlotAlloc->rarInfo.ulGrant.freqHopFlag = 0;
714             dciSlotAlloc->rarInfo.ulGrant.msg3FreqAlloc.startPrb = msg3PuschInfo->fdAlloc.startPrb;
715             dciSlotAlloc->rarInfo.ulGrant.msg3FreqAlloc.numPrb = msg3PuschInfo->fdAlloc.numPrb;
716             dciSlotAlloc->rarInfo.ulGrant.k2Index = k2Index;
717             dciSlotAlloc->rarInfo.ulGrant.mcs = msg3PuschInfo->tbInfo.mcs;
718             dciSlotAlloc->rarInfo.ulGrant.tpc = 3;  /* TODO : Check appropriate value to be filled */
719             /* Spec 38.213, section 8.2 : In a contention based random access
720              * procedure, the CSI request field is reserved. */
721             dciSlotAlloc->rarInfo.ulGrant.csiReq = 0;
722          }
723       }
724
725       /* Check if both DCI and RAR are sent in the same slot.
726        * If not, allocate memory RAR PDSCH slot to store RAR info
727        */
728       if(dciSlot == rarSlot)
729          dciSlotAlloc->pduPres = BOTH;
730       else
731       {
732          /* Allocate memory to schedule rarSlot to send RAR, pointer will be checked at schProcessSlotInd() */
733          SCH_ALLOC(rarSlotAlloc, sizeof(RarAlloc));
734          if(rarSlotAlloc == NULLP)
735          {
736             DU_LOG("\nERROR  -->  SCH : Memory Allocation failed for rarSlotAlloc");
737             SCH_FREE(dciSlotAlloc, sizeof(RarAlloc));
738             cell->schDlSlotInfo[dciSlot]->rarAlloc[ueId-1] = NULLP;
739             return false;
740          }
741          cell->schDlSlotInfo[rarSlot]->rarAlloc[ueId-1] = rarSlotAlloc;
742
743          /* Copy all RAR info */
744          memcpy(rarSlotAlloc, dciSlotAlloc, sizeof(RarAlloc));
745          rarSlotAlloc->rarPdcchCfg.dci.pdschCfg = &rarSlotAlloc->rarPdschCfg;
746
747          /* Assign correct PDU types in corresponding slots */
748          rarSlotAlloc->pduPres = PDSCH_PDU;
749          dciSlotAlloc->pduPres = PDCCH_PDU;
750          dciSlotAlloc->pdschSlot = rarSlot;  
751       }
752
753       cell->schDlSlotInfo[dciSlot]->pdcchUe = ueId;
754       cell->schDlSlotInfo[rarSlot]->pdschUe = ueId;
755       if(cell->raReq[ueId-1]->isCFRA)
756          cell->schUlSlotInfo[pucchTime.slot]->pucchUe = ueId;
757       else
758          cell->schUlSlotInfo[msg3Time.slot]->puschUe = ueId;
759
760       /* Create raCb at SCH */
761       createSchRaCb(ueId, cell->raReq[ueId-1], schInst);
762
763       /* Remove RachInd from pending RA request list */
764       SCH_FREE(cell->raReq[ueId-1]->rachInd, sizeof(RachIndInfo));
765       SCH_FREE(cell->raReq[ueId-1], sizeof(SchRaReq));
766       
767       return true;
768    }
769    return false;
770 }
771
772 /**
773  * @brief process rach indication function. 
774  *
775  * @details
776  *
777  *     Function : schProcessRachInd
778  *     
779  *     This function process rach indication
780  *     
781  *  @param[in]  rachInd parameters
782  *  @param[in]  shed instance
783  *  @return  ROK
784  **/
785 uint8_t schProcessRachInd(RachIndInfo *rachInd, Inst schInst)
786 {
787    SchCellCb *cell = schCb[schInst].cells[schInst];
788    SchRaReq  *raReq = NULLP;
789    float    slotDuration;
790    uint8_t  winNumSlots;
791    uint8_t  ueId;
792
793    if(cell == NULLP)
794    {
795       DU_LOG("\nERROR  -->  SCH: Failed to find cell in schProcessRachInd");
796       return RFAILED;
797    }
798
799    /* Storing RA request in cellCb */
800    GET_UE_ID(rachInd->crnti, ueId);
801    if(ueId <= 0)
802    {
803       DU_LOG("\nERROR  -->  SCH: Invalid CRNTI [%d]", rachInd->crnti);
804       return RFAILED;
805    }
806
807    SCH_ALLOC(raReq, sizeof(SchRaReq));
808    if(!raReq)
809    {
810       DU_LOG("\nERROR  -->  SCH : Memory allocation failure in schProcessRachInd");
811       SCH_FREE(rachInd, sizeof(RachIndInfo));
812       return RFAILED;
813    }
814
815    /* calculate the ra-rnti value */
816    raReq->raRnti = calculateRaRnti(rachInd->symbolIdx, rachInd->slotIdx, rachInd->freqIdx);
817    raReq->rachInd = rachInd;
818    if((cell->ueCb[ueId-1].crnti == rachInd->crnti) && (cell->ueCb[ueId-1].state == SCH_UE_HANDIN_IN_PROGRESS))
819    {
820       raReq->isCFRA = true;
821       raReq->ueCb = &cell->ueCb[ueId-1];
822    }
823    else
824       raReq->isCFRA = false;
825    raReq->winStartTime.sfn = rachInd->timingInfo.sfn;
826    raReq->winStartTime.slot = rachInd->timingInfo.slot;
827   
828    /* Converting window size from ms to number of slots */
829    slotDuration = (1 / pow(2, cell->cellCfg.numerology));
830    winNumSlots = (float)cell->cellCfg.schRachCfg.raRspWindow / slotDuration;
831    
832    /* Adding window size to window start time to get window end time */
833    ADD_DELTA_TO_TIME(raReq->winStartTime, raReq->winEndTime, winNumSlots, cell->numSlots);
834    cell->raReq[ueId -1] = raReq;
835
836    /* Adding UE Id to list of pending UEs to be scheduled */
837    addUeToBeScheduled(cell, ueId);
838
839    return ROK;
840 }
841
842 /**
843  * @brief fill RAR info function. 
844  *
845  * @details
846  *
847  *     Function : calculateRaRnti
848  *     
849  *     This function fills pdcch and pdsch info for RAR
850  *     
851  *  @param[in]  rar Allocation info
852  *  @param[in]  ra-rnti
853  *  @param[in]  PCI
854  *  @param[in]  offset to pointA to determine freq alloc
855  *  @return  ROK
856  **/
857 uint8_t schFillRar(SchCellCb *cell, SlotTimingInfo rarTime, uint16_t ueId, RarAlloc *rarAlloc, uint8_t k0Index)
858 {
859    uint8_t  coreset0Idx = 0;
860    uint8_t  firstSymbol = 0, numSymbols = 0;
861    uint8_t  mcs = DEFAULT_MCS;  /* MCS fixed to 4 */
862    uint8_t  dmrsStartSymbol, startSymbol, numSymbol ;
863    uint16_t numRbs = 0;
864    uint16_t tbSize = 0;
865
866    SchBwpDlCfg *initialBwp = &cell->cellCfg.schInitialDlBwp;
867    PdcchCfg *pdcch = &rarAlloc->rarPdcchCfg;
868    PdschCfg *pdsch = &rarAlloc->rarPdschCfg;
869    BwpCfg *bwp = &rarAlloc->bwp;
870
871    /* derive the sib1 coreset0 params from table 13-1 spec 38.213 */
872    coreset0Idx     = initialBwp->pdcchCommon.commonSearchSpace.coresetId;
873    numRbs     = coresetIdxTable[coreset0Idx][1]; 
874    numSymbols = coresetIdxTable[coreset0Idx][2];
875
876    /* calculate time domain parameters */
877    // note: since slot value is made sl1, RAR can be sent at all slots
878    uint16_t mask = 0x2000;
879    for(firstSymbol=0; firstSymbol<MAX_SYMB_PER_SLOT; firstSymbol++)
880    {
881       if(initialBwp->pdcchCommon.commonSearchSpace.monitoringSymbol & mask)
882          break;
883       else
884          mask = mask>>1;
885    }
886
887    /* fill BWP */
888    bwp->freqAlloc.numPrb   = initialBwp->bwp.freqAlloc.numPrb;
889    bwp->freqAlloc.startPrb = initialBwp->bwp.freqAlloc.startPrb;
890    bwp->subcarrierSpacing  = initialBwp->bwp.scs;
891    bwp->cyclicPrefix       = initialBwp->bwp.cyclicPrefix;
892
893    /* fill the PDCCH PDU */
894    pdcch->coresetCfg.startSymbolIndex = firstSymbol;
895    pdcch->coresetCfg.durationSymbols = numSymbols;
896    memcpy(pdcch->coresetCfg.freqDomainResource, \
897       cell->cellCfg.schInitialDlBwp.pdcchCommon.commonSearchSpace.freqDomainRsrc, FREQ_DOM_RSRC_SIZE);
898
899    pdcch->coresetCfg.cceRegMappingType = 1; /* coreset0 is always interleaved */
900    pdcch->coresetCfg.regBundleSize = 6;    /* spec-38.211 sec 7.3.2.2 */
901    pdcch->coresetCfg.interleaverSize = 2;  /* spec-38.211 sec 7.3.2.2 */
902    pdcch->coresetCfg.coreSetType = 0;
903    pdcch->coresetCfg.coreSetSize = numRbs;
904    pdcch->coresetCfg.shiftIndex = cell->cellCfg.phyCellId;
905    pdcch->coresetCfg.precoderGranularity = 0; /* sameAsRegBundle */
906    pdcch->numDlDci = 1;
907    pdcch->dci.rnti = cell->raReq[ueId-1]->raRnti; /* RA-RNTI */
908    pdcch->dci.scramblingId = cell->cellCfg.phyCellId;
909    pdcch->dci.scramblingRnti = 0;
910    pdcch->dci.cceIndex = 4; /* considering SIB1 is sent at cce 0-1-2-3 */
911    pdcch->dci.aggregLevel = 4;
912    pdcch->dci.beamPdcchInfo.numPrgs = 1;
913    pdcch->dci.beamPdcchInfo.prgSize = 1;
914    pdcch->dci.beamPdcchInfo.digBfInterfaces = 0;
915    pdcch->dci.beamPdcchInfo.prg[0].pmIdx = 0;
916    pdcch->dci.beamPdcchInfo.prg[0].beamIdx[0] = 0;
917    pdcch->dci.txPdcchPower.powerValue = 0;
918    pdcch->dci.txPdcchPower.powerControlOffsetSS = 0;
919    pdcch->dci.pdschCfg = pdsch;
920
921    /* fill the PDSCH PDU */
922    uint8_t cwCount = 0;
923    pdsch->pduBitmap = 0; /* PTRS and CBG params are excluded */
924    pdsch->rnti = cell->raReq[ueId-1]->raRnti; /* RA-RNTI */
925    pdsch->pduIndex = 0;
926    pdsch->numCodewords = 1;
927    for(cwCount = 0; cwCount < pdsch->numCodewords; cwCount++)
928    {
929       pdsch->codeword[cwCount].targetCodeRate = 308;
930       pdsch->codeword[cwCount].qamModOrder = 2;
931       pdsch->codeword[cwCount].mcsIndex = mcs; /* mcs configured to 4 */
932       pdsch->codeword[cwCount].mcsTable = 0;   /* notqam256 */
933       pdsch->codeword[cwCount].rvIndex = 0;
934       /* RAR PDU length and FAPI payload header length */
935       tbSize = schCalcTbSize(RAR_PAYLOAD_SIZE + TX_PAYLOAD_HDR_LEN);
936       pdsch->codeword[cwCount].tbSize = tbSize;
937    }
938    pdsch->dataScramblingId = cell->cellCfg.phyCellId;
939    pdsch->numLayers = 1;
940    pdsch->transmissionScheme = 0;
941    pdsch->refPoint = 0;
942    pdsch->dmrs.dlDmrsSymbPos = 4;  /* Bitmap value 00000000000100 i.e. using 3rd symbol for PDSCH DMRS */
943    pdsch->dmrs.dmrsConfigType = 0; /* type-1 */
944    pdsch->dmrs.dlDmrsScramblingId = cell->cellCfg.phyCellId;
945    pdsch->dmrs.scid = 0;
946    pdsch->dmrs.numDmrsCdmGrpsNoData = 1;
947    pdsch->dmrs.dmrsPorts = 0;
948    pdsch->dmrs.mappingType      = DMRS_MAP_TYPE_A;  /* Type-A */
949    pdsch->dmrs.nrOfDmrsSymbols  = NUM_DMRS_SYMBOLS;
950    pdsch->dmrs.dmrsAddPos       = DMRS_ADDITIONAL_POS;
951
952    pdsch->pdschTimeAlloc.rowIndex = k0Index;
953    pdsch->pdschTimeAlloc.timeAlloc.startSymb = initialBwp->pdschCommon.timeDomRsrcAllocList[k0Index].startSymbol;
954    pdsch->pdschTimeAlloc.timeAlloc.numSymb = initialBwp->pdschCommon.timeDomRsrcAllocList[k0Index].lengthSymbol;
955
956    pdsch->pdschFreqAlloc.vrbPrbMapping = 0; /* non-interleaved */
957    pdsch->pdschFreqAlloc.resourceAllocType = 1; /* RAT type-1 RIV format */
958    pdsch->pdschFreqAlloc.freqAlloc.startPrb = MAX_NUM_RB;
959    pdsch->pdschFreqAlloc.freqAlloc.numPrb = \
960       schCalcNumPrb(tbSize, mcs, initialBwp->pdschCommon.timeDomRsrcAllocList[k0Index].lengthSymbol);
961
962    /* Find total symbols occupied including DMRS */
963    dmrsStartSymbol = findDmrsStartSymbol(pdsch->dmrs.dlDmrsSymbPos);
964    /* If there are no DRMS symbols, findDmrsStartSymbol() returns MAX_SYMB_PER_SLOT, 
965     * in that case only PDSCH symbols are marked as occupied */
966    if(dmrsStartSymbol == MAX_SYMB_PER_SLOT)
967    {
968       startSymbol = pdsch->pdschTimeAlloc.timeAlloc.startSymb;
969       numSymbol = pdsch->pdschTimeAlloc.timeAlloc.numSymb;
970    }
971    /* If DMRS symbol is found, mark DMRS and PDSCH symbols as occupied */
972    else
973    {
974       startSymbol = dmrsStartSymbol;
975       numSymbol = pdsch->dmrs.nrOfDmrsSymbols + pdsch->pdschTimeAlloc.timeAlloc.numSymb;
976    }
977
978    /* Allocate the number of PRBs required for RAR PDSCH */
979    if((allocatePrbDl(cell, rarTime, startSymbol, numSymbol,\
980       &pdsch->pdschFreqAlloc.freqAlloc.startPrb, pdsch->pdschFreqAlloc.freqAlloc.numPrb)) != ROK)
981    {
982       DU_LOG("\nERROR  --> SCH : allocatePrbDl() failed for RAR");
983       return RFAILED;
984    }
985
986    pdsch->beamPdschInfo.numPrgs = 1;
987    pdsch->beamPdschInfo.prgSize = 1;
988    pdsch->beamPdschInfo.digBfInterfaces = 0;
989    pdsch->beamPdschInfo.prg[0].pmIdx = 0;
990    pdsch->beamPdschInfo.prg[0].beamIdx[0] = 0;
991    pdsch->txPdschPower.powerControlOffset = 0;
992    pdsch->txPdschPower.powerControlOffsetSS = 0;
993
994    return ROK;
995 }
996
997  /* @brief Process RACH resource release after CFRA
998  *
999  * @details
1000  *
1001  *     Function : MacSchRachRsrcRel
1002  *     
1003  *     This function processes RACH resorce release
1004  *     from MAC after CFRA. It releases the dedicated 
1005  *     preamble alloted to the UE
1006  *     
1007  *  @param[in]  Post structure
1008  *  @param[in]  RACH resource release
1009  *  @return     ROK
1010  *              RFAILED
1011  */
1012 uint8_t MacSchRachRsrcRel(Pst *pst, SchRachRsrcRel *schRachRsrcRel)
1013 {
1014    uint8_t      ret = ROK;
1015    uint8_t      ssbIdx = 0, cfraSsbIdx = 0;
1016    uint16_t     cellIdx = 0;
1017    Inst         inst = pst->dstInst - SCH_INST_START;
1018    SchCellCb    *cellCb = NULLP;
1019    SchUeCb      *ueCb = NULLP;
1020
1021    DU_LOG("\nINFO  -->  SCH : Received RACH resource release for Cell ID [%d] CRNTI [%d]", \
1022          schRachRsrcRel->cellId, schRachRsrcRel->crnti);
1023
1024    /* Fetch Cell CB */
1025    for(cellIdx = 0; cellIdx < MAX_NUM_CELL; cellIdx++)
1026    {
1027       if((schCb[inst].cells[cellIdx]) && (schCb[inst].cells[cellIdx]->cellId == schRachRsrcRel->cellId))
1028       {
1029          cellCb = schCb[inst].cells[cellIdx];
1030          break;
1031       }
1032    }
1033    
1034    if(cellCb)
1035    {
1036       /* Fetch UE CB */
1037       ueCb = schGetUeCb(cellCb, schRachRsrcRel->crnti);
1038       if(ueCb->crnti != schRachRsrcRel->crnti)
1039       {
1040          DU_LOG("\nERROR  -->  SCH : CRNTI [%d] not found", schRachRsrcRel->crnti);
1041          ret = RFAILED;
1042       }
1043    }
1044    else
1045    {
1046       DU_LOG("\nERROR  -->  SCH : Cell ID [%d] not found", schRachRsrcRel->cellId);
1047       ret = RFAILED;
1048    }
1049
1050    /* Free SSB resource if no failure has occurred until this step */
1051    if(ret == ROK)
1052    {
1053       for(ssbIdx = 0; ssbIdx < schRachRsrcRel->cfraResource.numSsb; ssbIdx++)
1054       {
1055          /* Search each ssbIdx entry in UE Cb */
1056          for(cfraSsbIdx = 0; cfraSsbIdx < ueCb->cfraResource.numSsb; cfraSsbIdx++)
1057          {
1058             if(ueCb->cfraResource.ssbResource[cfraSsbIdx].ssbIdx == schRachRsrcRel->cfraResource.ssbResource[ssbIdx].ssbIdx)
1059             {
1060                /* If ssbIdx entry is found in UE CB, free dedicated resources
1061                 * for this ssbIdx */
1062                UNSET_ONE_BIT(ueCb->cfraResource.ssbResource[cfraSsbIdx].raPreambleIdx, cellCb->dedPreambleBitMap);
1063                memset(&ueCb->cfraResource.ssbResource[cfraSsbIdx], 0, sizeof(SchCfraSsbResource));
1064                ueCb->cfraResource.numSsb--;
1065                break;
1066             }
1067          }
1068       } /* End of for */
1069    } /* End of if */
1070
1071    /* Free RACH resource release memory allocated by MAC */
1072    SCH_FREE(schRachRsrcRel, sizeof(SchRachRsrcRel));
1073    return ret;
1074 }
1075  /* @brief process MSG4 completion
1076  *
1077  * @details
1078  *
1079  *     Function : schMsg4Complete
1080  *     
1081  *     This function updates ra state and msg4 Hqrq 
1082  *     proc upon MSG4 completion     
1083  *  @param[in]  SchUeCb *ueCb, UE cb pointer
1084  *  @return     VOID
1085  */
1086 void schMsg4Complete(SchUeCb *ueCb)
1087 {
1088    DU_LOG("\nINFO --> SCH: State change for ueId[%2d] to SCH_RA_STATE_MSG4_DONE\n",ueCb->ueId);
1089    ueCb->cellCb->raCb[ueCb->ueId-1].raState = SCH_RA_STATE_MSG4_DONE;
1090    ueCb->msg4Proc = ueCb->retxMsg4HqProc = NULLP;
1091 }
1092 /**********************************************************************
1093          End of file
1094 **********************************************************************/