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 Entry point fucntions for slot indications
29 **********************************************************************/
31 /** @file sch_slot_ind.c
32 @brief This module processes slot indications
34 #include "common_def.h"
40 #include "du_app_mac_inf.h"
41 #include "mac_sch_interface.h"
43 #include "sch_utils.h"
45 SchMacDlAllocFunc schMacDlAllocOpts[] =
52 SchCb schCb[SCH_MAX_INST];
54 /*******************************************************************
56 * @brief Handles sending DL broadcast alloc to MAC
60 * Function : sendDlAllocToMac
63 * Sends DL Broadcast Resource Allocation to MAC from SCH
66 * @return ROK - success
69 * ****************************************************************/
70 uint8_t sendDlAllocToMac(DlSchedInfo *dlSchedInfo, Inst inst)
74 memset(&pst, 0, sizeof(Pst));
75 FILL_PST_SCH_TO_MAC(pst, inst);
76 pst.event = EVENT_DL_SCH_INFO;
78 return(*schMacDlAllocOpts[pst.selector])(&pst, dlSchedInfo);
82 /*******************************************************************
84 * @brief Handles slot indication at SCH
88 * Function : schCalcSlotValues
91 * Handles TTI indication received from PHY
94 * @return ROK - success
97 * ****************************************************************/
98 void schCalcSlotValues(SlotTimingInfo slotInd, SchSlotValue *schSlotValue)
100 /****************************************************************
101 * PHY_DELTA - the physical layer delta *
102 * SCHED_DELTA - scheduler schedules one slot ahead *
103 * BO_DELTA - this delay is considered for BO response and *
104 * RLC buffer packet to received at MAC *
105 * lower-mac (FAPI filling) will be working on PHY_DELTA *
106 * brdcast scheduler will working on PHY_DELTA + SCHED_DELTA *
107 * RAR scheduler will working on PHY_DELTA + SCHED_DELTA *
108 * msg4 scheduler will working on PHY_DELTA + SCHED_DELTA *
109 * dedicated DL msg scheduler will working *
110 * on PHY_DELTA + SCHED_DELTA + BO_DELTA *
111 ****************************************************************/
113 ADD_DELTA_TO_TIME(slotInd, schSlotValue->currentTime, PHY_DELTA_DL);
114 ADD_DELTA_TO_TIME(slotInd, schSlotValue->broadcastTime, PHY_DELTA_DL + SCHED_DELTA);
115 ADD_DELTA_TO_TIME(slotInd, schSlotValue->rarTime, PHY_DELTA_DL + SCHED_DELTA);
116 ADD_DELTA_TO_TIME(slotInd, schSlotValue->dlMsgTime, PHY_DELTA_DL + SCHED_DELTA);
119 /*******************************************************************
121 * @brief Checks if a slot is to be scheduled for SSB transmission
125 * Function : schCheckSsbOcc
128 * Checks if a slot is to be scheduled for SSB transmission
130 * @params[in] SlotTimingInfo slotTime
132 * @return Pdu transmission
134 * ****************************************************************/
135 PduTxOccsaion schCheckSsbOcc(SlotTimingInfo slotTime, SchCellCb *cell)
139 ssb_rep = cell->cellCfg.ssbSchCfg.ssbPeriod;
141 /* Identify SSB ocassion*/
142 if ((slotTime.sfn % SCH_MIB_TRANS == 0) && (slotTime.slot ==0))
144 return NEW_TRANSMISSION;
146 else if(cell->firstSsbTransmitted)
148 if((ssb_rep == 5) && ((slotTime.slot == 0 || slotTime.slot == 10)))
150 else if((slotTime.sfn % (ssb_rep/10) == 0) && slotTime.slot == 0)
153 /* not SSB occassion */
154 return NO_TRANSMISSION;
157 /*******************************************************************
159 * @brief Checks if a slot is to be scheduled for SIB1 transmission
163 * Function : schCheckSib1Occ
166 * Checks if a slot is to be scheduled for SIB1 transmission
168 * @params[in] SlotTimingInfo slotTime
170 * @return Pdu transmission
172 * ****************************************************************/
173 PduTxOccsaion schCheckSib1Occ(SlotTimingInfo slotTime, SchCellCb *cell)
175 /* Identify SIB1 occasions */
176 if((slotTime.sfn % SCH_SIB1_TRANS == 0) && (slotTime.slot ==0))
178 return NEW_TRANSMISSION;
180 else if(cell->firstSib1Transmitted)
182 if((slotTime.sfn % (cell->cellCfg.sib1SchCfg.sib1RepetitionPeriod/10) == 0) &&
183 (slotTime.slot == 0))
188 /* not SIB1 occassion */
189 return NO_TRANSMISSION;
192 /*******************************************************************
204 * @return ROK - success
207 * ****************************************************************/
208 uint8_t schFillBoGrantDlSchedInfo(SchCellCb *cell, DlSchedInfo *dlSchedInfo, DlMsgAlloc *dlMsgAlloc)
210 uint8_t ueIdx, lcIdx;
213 uint32_t accumalatedSize = 0;
214 SchUeCb *ueCb = NULLP;
216 while(cell->boIndBitMap)
218 slot = dlSchedInfo->schSlotValue.dlMsgTime.slot;
220 GET_RIGHT_MOST_SET_BIT(cell->boIndBitMap, ueIdx);
221 GET_CRNTI(crnti,ueIdx);
222 ueCb = &cell->ueCb[ueIdx-1];
224 /* allocate PDCCH and PDSCH resources for the ue */
225 SCH_ALLOC(dlMsgAlloc, sizeof(DlMsgAlloc));
228 DU_LOG("\nERROR --> SCH : Memory Allocation failed for ded DL msg alloc");
231 memset(dlMsgAlloc, 0, sizeof(DlMsgAlloc));
232 dlSchedInfo->dlMsgAlloc = dlMsgAlloc;
233 dlMsgAlloc->crnti = crnti;
235 /* Dl ded Msg info is copied, this was earlier filled in macSchDlRlcBoInfo */
236 memcpy(&dlMsgAlloc->dlMsgInfo, cell->schDlSlotInfo[slot]->dlMsgInfo, \
239 /* scheduled LC data fill */
240 dlMsgAlloc->numLc = 0;
241 for(lcIdx = 0; lcIdx < MAX_NUM_LC; lcIdx++)
243 if(ueCb->dlInfo.dlLcCtxt[lcIdx].bo)
245 dlMsgAlloc->lcSchInfo[dlMsgAlloc->numLc].lcId = lcIdx;
247 /* calculation for BO includse RLC and MAC header size */
248 dlMsgAlloc->lcSchInfo[dlMsgAlloc->numLc].schBytes = \
249 ueCb->dlInfo.dlLcCtxt[lcIdx].bo + MAC_HDR_SIZE;
250 accumalatedSize += dlMsgAlloc->lcSchInfo[dlMsgAlloc->numLc].schBytes;
253 ueCb->dlInfo.dlLcCtxt[lcIdx].bo = 0;
256 if (!dlMsgAlloc->numLc)
258 DU_LOG("\nDEBUG --> SCH : No pending BO for any LC id\n");
259 /* Free the dl ded msg info allocated in macSchDlRlcBoInfo */
260 SCH_FREE(cell->schDlSlotInfo[dlSchedInfo->schSlotValue.dlMsgTime.slot]->dlMsgInfo, \
265 /* pdcch and pdsch data is filled */
266 schDlRsrcAllocDlMsg(dlMsgAlloc, cell, crnti, &accumalatedSize, slot);
267 /* Calculated TB size could be less than the total size requested.
268 * Hence, updated the scheduled bytes report. Following is valid only for
270 * TODO : Update the scheduling byte report for multiple LC based on QCI
272 dlMsgAlloc->lcSchInfo[dlMsgAlloc->numLc -1].schBytes = accumalatedSize;
275 schAllocPucchResource(cell, dlMsgAlloc->crnti, slot);
277 /* Free the dl ded msg info allocated in macSchDlRlcBoInfo */
278 SCH_FREE(cell->schDlSlotInfo[dlSchedInfo->schSlotValue.dlMsgTime.slot]->dlMsgInfo, \
280 cell->schDlSlotInfo[dlSchedInfo->schSlotValue.dlMsgTime.slot]->dlMsgInfo = NULL;
282 /* after allocation is done, unset the bo bit for that ue */
283 UNSET_ONE_BIT(ueIdx, cell->boIndBitMap);
289 /*******************************************************************
291 * @brief Handles slot indication at SCH
295 * Function : schProcessSlotInd
298 * Handles TTI indication received from PHY
301 * @return ROK - success
304 * ****************************************************************/
305 uint8_t schProcessSlotInd(SlotTimingInfo *slotInd, Inst schInst)
307 uint8_t ueIdx, lcgIdx, ret = ROK;
309 DlSchedInfo dlSchedInfo;
310 DlBrdcstAlloc *dlBrdcstAlloc = NULLP;
311 DlMsgAlloc *msg4Alloc = NULLP;
312 DlMsgAlloc *dlMsgAlloc = NULLP;
313 SchCellCb *cell = NULLP;
315 memset(&dlSchedInfo,0,sizeof(DlSchedInfo));
316 dlSchedInfo.dlMsgAlloc = NULLP;
317 schCalcSlotValues(*slotInd, &dlSchedInfo.schSlotValue);
318 dlBrdcstAlloc = &dlSchedInfo.brdcstAlloc;
319 dlBrdcstAlloc->ssbTrans = NO_TRANSMISSION;
320 dlBrdcstAlloc->sib1Trans = NO_TRANSMISSION;
322 cell = schCb[schInst].cells[schInst];
325 DU_LOG("\nERROR --> SCH : Cell Does not exist");
328 memcpy(&cell->slotInfo, slotInd, sizeof(SlotTimingInfo));
329 dlBrdcstAlloc->ssbIdxSupported = SSB_IDX_SUPPORTED;
331 slot = dlSchedInfo.schSlotValue.currentTime.slot;
333 dlSchedInfo.cellId = cell->cellId;
335 /* Check if this slot is SSB occassion */
336 dlBrdcstAlloc->ssbTrans = schCheckSsbOcc(dlSchedInfo.schSlotValue.broadcastTime, cell);
337 if((dlBrdcstAlloc->ssbTrans == NEW_TRANSMISSION) && (!cell->firstSsbTransmitted))
338 cell->firstSsbTransmitted = true;
340 /* Check if this slot is SIB1 occassion */
341 dlBrdcstAlloc->sib1Trans = schCheckSib1Occ(dlSchedInfo.schSlotValue.broadcastTime, cell);
342 if((dlBrdcstAlloc->sib1Trans == NEW_TRANSMISSION) && (!cell->firstSib1Transmitted))
343 cell->firstSib1Transmitted = true;
345 if(dlBrdcstAlloc->ssbTrans || dlBrdcstAlloc->sib1Trans)
347 dlSchedInfo.isBroadcastPres = true;
348 slot = dlSchedInfo.schSlotValue.broadcastTime.slot;
349 ret = schBroadcastAlloc(cell,dlBrdcstAlloc,slot);
352 DU_LOG("\nERROR --> SCH : schBroadcastAlloc failed");
357 /* Check for Pending RA Requests */
358 schProcessRaReq(*slotInd, cell);
361 if(cell->schDlSlotInfo[dlSchedInfo.schSlotValue.rarTime.slot]->rarAlloc != NULLP)
363 slot = dlSchedInfo.schSlotValue.rarTime.slot;
364 dlSchedInfo.rarAlloc = cell->schDlSlotInfo[slot]->rarAlloc;
365 cell->schDlSlotInfo[slot]->rarAlloc = NULLP;
369 if((cell->schDlSlotInfo[dlSchedInfo.schSlotValue.dlMsgTime.slot]->dlMsgInfo != NULLP) &&
370 (cell->schDlSlotInfo[dlSchedInfo.schSlotValue.dlMsgTime.slot]->dlMsgInfo->isMsg4Pdu))
372 slot = dlSchedInfo.schSlotValue.dlMsgTime.slot;
374 SCH_ALLOC(msg4Alloc, sizeof(DlMsgAlloc));
377 DU_LOG("\nERROR --> SCH : Memory Allocation failed for msg4 alloc");
381 dlSchedInfo.dlMsgAlloc = msg4Alloc;
383 /* Msg4 info is copied, this was earlier filled in macSchDlRlcBoInfo */
384 memcpy(&msg4Alloc->dlMsgInfo, cell->schDlSlotInfo[slot]->dlMsgInfo, \
387 /* pdcch and pdsch data is filled */
388 schDlRsrcAllocMsg4(msg4Alloc, cell, dlSchedInfo.schSlotValue.dlMsgTime.slot, dlBrdcstAlloc->ssbTrans, dlBrdcstAlloc->sib1Trans);
391 schAllocPucchResource(cell, msg4Alloc->dlMsgInfo.crnti, dlSchedInfo.schSlotValue.dlMsgTime.slot);
393 SCH_FREE(cell->schDlSlotInfo[dlSchedInfo.schSlotValue.dlMsgTime.slot]->dlMsgInfo, sizeof(DlMsgInfo));
394 cell->schDlSlotInfo[dlSchedInfo.schSlotValue.dlMsgTime.slot]->dlMsgInfo = NULL;
397 /* check if UL grant must be sent in this slot for a SR/BSR that had been received */
398 for(ueIdx=0; ueIdx<cell->numActvUe; ueIdx++)
400 uint32_t totDataReq = 0; /* in bytes */
401 DciInfo *dciInfo = NULLP;
402 SchUeCb *ueCb = NULLP;
404 ueCb = &cell->ueCb[ueIdx];
408 totDataReq = UL_GRANT_SIZE; /*fixing so that all control msgs can be handled in SR */
409 ueCb->srRcvd = false;
412 for(lcgIdx=0; lcgIdx<MAX_NUM_LOGICAL_CHANNEL_GROUPS; lcgIdx++)
414 totDataReq+= ueCb->bsrInfo[lcgIdx].dataVol;
415 ueCb->bsrInfo[lcgIdx].dataVol = 0;
417 if(totDataReq > 0) /* UL grant must be provided for this UE in this slot */
419 SchPuschInfo schPuschInfo;
420 memset(&schPuschInfo, 0, sizeof(SchPuschInfo));
422 SCH_ALLOC(dciInfo, sizeof(DciInfo));
425 DU_LOG("\nERROR --> SCH : Memory Allocation failed for dciInfo alloc");
428 memset(dciInfo,0,sizeof(DciInfo));
429 /* update the SFN and SLOT */
430 memcpy(&dlSchedInfo.schSlotValue.ulDciTime, slotInd, sizeof(SlotTimingInfo));
431 slot = dlSchedInfo.schSlotValue.ulDciTime.slot;
432 /* Update PUSCH allocation */
433 schFillPuschAlloc(ueCb, slot, totDataReq, &schPuschInfo);
434 /* Fill DCI for UL grant */
435 schFillUlDci(ueCb, schPuschInfo, dciInfo);
436 memcpy(&dciInfo->slotIndInfo, &dlSchedInfo.schSlotValue.ulDciTime, sizeof(SlotTimingInfo));
437 dlSchedInfo.ulGrant = dciInfo;
441 /* Check for pending BO grant for LC */
442 if((cell->schDlSlotInfo[dlSchedInfo.schSlotValue.dlMsgTime.slot]->dlMsgInfo != NULLP) &&
443 (!cell->schDlSlotInfo[dlSchedInfo.schSlotValue.dlMsgTime.slot]->dlMsgInfo->isMsg4Pdu))
445 schFillBoGrantDlSchedInfo(cell, &dlSchedInfo, dlMsgAlloc);
448 /* send msg to MAC */
449 ret = sendDlAllocToMac(&dlSchedInfo, schInst);
452 DU_LOG("\nERROR --> SCH : Sending DL Broadcast allocation from SCH to MAC failed");
456 schInitDlSlot(cell->schDlSlotInfo[slot]);
457 schUlResAlloc(cell, schInst);
463 /**********************************************************************
465 **********************************************************************/