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
29 **********************************************************************/
31 /** @file sch_common.c
32 @brief This module performs common scheduling
35 #include "envopt.h" /* environment options */
36 #include "envdep.h" /* environment dependent */
37 #include "envind.h" /* environment independent */
38 #include "gen.h" /* general layer */
39 #include "ssi.h" /* system service interface */
40 #include "cm_tkns.h" /* Common Token Defines */
41 #include "cm_llist.h" /* Common Link List Defines */
42 #include "cm_hash.h" /* Common Hash List Defines */
43 #include "cm_mblk.h" /* common memory link list library */
44 #include "cm_lte.h" /* Common LTE Defines */
48 #include "gen.x" /* general layer typedefs */
49 #include "ssi.x" /* system services typedefs */
50 #include "cm5.x" /* system services */
51 #include "cm_tkns.x" /* Common Token Definitions */
52 #include "cm_llist.x" /* Common Link List Definitions */
53 #include "cm_lib.x" /* Common Library Definitions */
54 #include "cm_hash.x" /* Common Hash List Definitions */
55 #include "cm_mblk.x" /* common memory link list library */
56 #include "cm_lte.x" /* Common LTE Defines */
60 #include "du_app_mac_inf.h"
61 #include "mac_sch_interface.h"
63 #include "sch_utils.h"
65 extern SchCb schCb[SCH_MAX_INST];
66 extern uint16_t prachCfgIdxTable[MAX_PRACH_CONFIG_IDX][8];
67 extern uint16_t numRbForPrachTable[MAX_RACH_NUM_RB_IDX][5];
69 SchMacUlSchInfoFunc schMacUlSchInfoOpts[] =
77 * @brief Time domain allocation for SSB
81 * Function : ssbDlTdAlloc
83 * This function handles common scheduling for DL
85 * @param[in] schCellCb *cell, cell cb
86 * @param[in] DlBrdcstAlloc *dlBrdcstAlloc, DL brdcst allocation
89 void ssbDlTdAlloc(uint8_t scs, uint8_t *ssbStartSymb)
92 /* Determine value of "n" based on Section 4.1 of 3GPP TS 38.213 */
98 n = 2;/* n = 0, 1 for SCS = 15KHz */
99 for(uint8_t idx=0; idx<n; idx++)
101 /* start symbol determined using {2, 8} + 14n */
102 ssbStartSymb[symbIdx++] = 2 + SCH_SYMBOL_PER_SLOT*idx;
103 ssbStartSymb[symbIdx++] = 8 + SCH_SYMBOL_PER_SLOT*idx;
108 DU_LOG("\nSCS %d is currently not supported", scs);
113 * @brief common resource allocation for SSB
117 * Function : schCmnDlAlloc
119 * This function handles common scheduling for DL
121 * @param[in] SchCellCb *cell, cell cb
122 * @param[in] DlBrdcstAlloc *dlBrdcstAlloc, DL brdcst allocation
125 uint8_t schCmnDlAlloc(SchCellCb *cell, DlBrdcstAlloc *dlBrdcstAlloc)
128 uint8_t scs, ssbStartPrb, ssbStartSymb, idx;
129 uint8_t ssbStartSymbArr[SCH_MAX_SSB_BEAM];
133 dlAlloc = cell->dlAlloc[cell->slotInfo.slot];
134 if(dlBrdcstAlloc->ssbTrans)
136 scs = cell->cellCfg.ssbSchCfg.scsCommon;
138 (cell->cellCfg.ssbSchCfg.ssbOffsetPointA)/SCH_NUM_SC_PRB;
140 memset(ssbStartSymbArr, 0, SCH_MAX_SSB_BEAM);
141 ssbDlTdAlloc(scs, ssbStartSymbArr);
142 ssbStartSymb = ssbStartSymbArr[dlBrdcstAlloc->ssbIdxSupported-1]; /*since we are supporting only 1 ssb beam */
143 /* Assign interface structure */
144 for(idx=0; idx<dlBrdcstAlloc->ssbIdxSupported; idx++)
146 ssbInfo.ssbIdx = idx;
147 ssbInfo.fdAlloc.ssbStartPrbIdx = ssbStartPrb;
148 ssbInfo.fdAlloc.ssbPrbDuration = SCH_SSB_PRB_DURATION;
149 ssbInfo.tdAlloc.ssbStartSymbIdx = ssbStartSymb;
150 ssbInfo.tdAlloc.ssbSymbolDuration = SCH_SSB_SYMB_DURATION;
151 dlBrdcstAlloc->ssbInfo[idx] = ssbInfo;
152 dlAlloc->ssbInfo[idx] = ssbInfo;
156 dlAlloc->ssbPres = true;
157 dlAlloc->ssbIdxSupported = dlBrdcstAlloc->ssbIdxSupported;
158 for(idx=ssbStartSymb; idx<ssbStartSymb+SCH_SSB_SYMB_DURATION; idx++)
160 dlAlloc->assignedPrb[idx] = SCH_SSB_PRB_DURATION + 1; /* +1 for kSsb */
165 /* SIB1 allocation */
166 if(dlBrdcstAlloc->sib1Trans)
168 memcpy(&dlBrdcstAlloc->sib1Alloc.sib1PdcchCfg, &cell->cellCfg.sib1SchCfg.sib1PdcchCfg, sizeof(Sib1PdcchCfg));
169 memcpy(&dlBrdcstAlloc->sib1Alloc.sib1PdschCfg, &cell->cellCfg.sib1SchCfg.sib1PdschCfg, sizeof(Sib1PdschCfg));
174 /*******************************************************************
176 * @brief Handles sending UL scheduler info to MAC
180 * Function : sendUlSchInfoToMac
183 * Sends UL Sch info to MAC from SCH
186 * @return ROK - success
189 * ****************************************************************/
190 int sendUlSchInfoToMac(UlSchInfo *ulSchInfo, Inst inst)
194 memset(&pst, 0, sizeof(Pst));
195 SCH_FILL_RSP_PST(pst, inst);
196 pst.event = EVENT_UL_SCH_INFO;
198 return(*schMacUlSchInfoOpts[pst.selector])(&pst, ulSchInfo);
202 * @brief resource allocation for PRACH
206 * Function : schPrachResAlloc
208 * This function handles PRACH allocation
210 * @param[in] SchCellCb *cell, cell cb
211 * @param[in] UlSchInfo *ulSchInfo, UL scheduling info
214 int schPrachResAlloc(SchCellCb *cell, UlSchInfo *ulSchInfo)
221 uint8_t prachCfgIdx = 0;
222 uint8_t prachFormat = 0;
225 uint8_t prachSubframe = 0;
226 uint8_t prachStartSymbol = 0;
227 uint8_t prachOcas = 0;
228 uint8_t dataType = 0;
230 SchUlAlloc *ulAlloc = NULLP;
232 sfn = cell->slotInfo.sfn;
233 slot = cell->slotInfo.slot;
234 ulAlloc = cell->ulAlloc[cell->slotInfo.slot];
235 prachCfgIdx = cell->cellCfg.schRachCfg.prachCfgIdx;
237 /* derive the prachCfgIdx table paramters */
238 x = prachCfgIdxTable[prachCfgIdx][1];
239 y = prachCfgIdxTable[prachCfgIdx][2];
240 prachSubframe = prachCfgIdxTable[prachCfgIdx][3];
244 /* prach occasion does not lie in this SFN */
245 DU_LOG("\nPRACH ocassion doesn't lie in this SFN");
248 /* check for subFrame number */
249 if ((1 << slot) & prachSubframe)
251 /* prach ocassion present in this subframe */
253 prachFormat = prachCfgIdxTable[prachCfgIdx][0];
254 prachStartSymbol = prachCfgIdxTable[prachCfgIdx][4];
255 prachOcas = prachCfgIdxTable[prachCfgIdx][6];
257 /* freq domain resource determination for RACH*/
258 freqStart = cell->cellCfg.schRachCfg.msg1FreqStart;
259 /* numRa determined as 𝑛 belonging {0,1,.., M − 1},
260 * where M is given by msg1Fdm */
261 numRa = (cell->cellCfg.schRachCfg.msg1Fdm - 1);
262 for(idx=0; idx<MAX_RACH_NUM_RB_IDX; idx++)
264 if(numRbForPrachTable[idx][0] == cell->cellCfg.schRachCfg.rootSeqIdx)
267 numPrachRb = numRbForPrachTable[idx][3];
268 /* Considering first slot in the frame for PRACH */
270 ulAlloc->assignedPrb[idx] = freqStart+numPrachRb;
273 /* Fill UL SCH Info */
274 ulSchInfo->cellId = cell->cellId;
275 ulSchInfo->slotIndInfo.sfn = sfn;
276 ulSchInfo->slotIndInfo.slot = slot;
277 ulSchInfo->dataType = dataType | SCH_DATATYPE_PRACH;
279 ulSchInfo->prachSchInfo.numPrachOcas = prachOcas;
280 ulSchInfo->prachSchInfo.prachFormat = prachFormat;
281 ulSchInfo->prachSchInfo.numRa = numRa;
282 ulSchInfo->prachSchInfo.prachStartSymb = prachStartSymbol;
288 * @brief resource allocation for UL
292 * Function : schUlResAlloc
294 * This function handles UL Resource allocation
296 * @param[in] SchCellCb *cell, cellCb
299 int schUlResAlloc(SchCellCb *cell, Inst schInst)
303 /* Schedule resources for PRACH */
304 schPrachResAlloc(cell, &ulSchInfo);
306 ret = sendUlSchInfoToMac(&ulSchInfo, schInst);
309 DU_LOG("\nSending UL Sch info from SCH to MAC failed");
314 /**********************************************************************
316 **********************************************************************/