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 extern SchCb schCb[SCH_MAX_INST];
46 extern uint8_t puschDeltaTable[MAX_MU_PUSCH];
49 * @brief calculate ra-rnti function.
53 * Function : calculateRaRnti
55 * This function calculates ra-rnti
57 * @param[in] symbol index
58 * @param[in] slot index
59 * @param[in] frequency index
62 uint16_t calculateRaRnti(uint8_t symbolIdx, uint8_t slotIdx, uint8_t freqIdx)
65 uint8_t ulCarrierIdx = 0; /* configured to 0 */
66 raRnti = (1+symbolIdx+(14*slotIdx)+(14*80*freqIdx)+(14*80*8*ulCarrierIdx));
71 * @brief create raCb function.
75 * Function : createSchRaCb
77 * This function create raCb
80 * @param[in] shed instance
83 void createSchRaCb(uint16_t tcrnti, Inst schInst)
85 schCb[schInst].cells[schInst]->raCb[0].tcrnti = tcrnti;
89 * @brief resource allocation for msg3 PUSCH
93 * Function : schAllocMsg3Pusch
95 * This function handles msg3 PUSCH allocation
97 * @param[in] Inst schInst, SCH instance
98 * @param[in] slot, current slot
99 * @param[out] msg3StartRb
100 * @param[out] msg3NumRb
103 uint8_t schAllocMsg3Pusch(Inst schInst, uint16_t slot, uint16_t *msg3StartRb,
106 SchCellCb *cell = NULLP;
107 SchUlSlotInfo *schUlSlotInfo = NULLP;
109 uint8_t msg3SlotAlloc = 0;
112 uint8_t startSymb = 0;
118 uint8_t numPdschSymbols= 14;
121 cell = schCb[schInst].cells[schInst];
122 // puschMu = cell->cellCfg.puschMu;
123 delta = puschDeltaTable[puschMu];
124 k2 = cell->cellCfg.schInitialUlBwp.puschCommon.k2;
125 startSymb = cell->cellCfg.schInitialUlBwp.puschCommon.startSymbol;
126 symbLen = cell->cellCfg.schInitialUlBwp.puschCommon.lengthSymbol;
128 /* Slot allocation for msg3 based on 38.214 section 6.1.2.1 */
129 msg3SlotAlloc = slot + k2 + delta;
130 msg3SlotAlloc = msg3SlotAlloc % SCH_NUM_SLOTS;
132 startRb = cell->schUlSlotInfo[msg3SlotAlloc]->puschCurrentPrb;
133 tbSize = schCalcTbSize(8); /* 6 bytes msg3 and 2 bytes header */
134 numRb = schCalcNumPrb(tbSize, mcs, numPdschSymbols);
136 /* allocating 1 extra RB for now */
138 /* increment PUSCH PRB */
139 cell->schUlSlotInfo[msg3SlotAlloc]->puschCurrentPrb += numRb;
141 for(idx=startSymb; idx<symbLen; idx++)
143 cell->schUlSlotInfo[msg3SlotAlloc]->assignedPrb[idx] = startRb + numRb;
145 schUlSlotInfo = cell->schUlSlotInfo[msg3SlotAlloc];
147 SCH_ALLOC(schUlSlotInfo->schPuschInfo, sizeof(SchPuschInfo));
148 if(!schUlSlotInfo->schPuschInfo)
150 DU_LOG("SCH: Memory allocation failed in schAllocMsg3Pusch");
153 tbSize = 0; /* since nPrb has been incremented, recalculating tbSize */
154 tbSize = schCalcTbSizeFromNPrb(numRb, mcs, numPdschSymbols);
156 schUlSlotInfo->schPuschInfo->harqProcId = SCH_HARQ_PROC_ID;
157 schUlSlotInfo->schPuschInfo->resAllocType = SCH_ALLOC_TYPE_1;
158 schUlSlotInfo->schPuschInfo->fdAlloc.startPrb = startRb;
159 schUlSlotInfo->schPuschInfo->fdAlloc.numPrb = numRb;
160 schUlSlotInfo->schPuschInfo->tdAlloc.startSymb = startSymb;
161 schUlSlotInfo->schPuschInfo->tdAlloc.numSymb = symbLen;
162 schUlSlotInfo->schPuschInfo->tbInfo.mcs = mcs;
163 schUlSlotInfo->schPuschInfo->tbInfo.ndi = 1; /* new transmission */
164 schUlSlotInfo->schPuschInfo->tbInfo.rv = 0;
165 schUlSlotInfo->schPuschInfo->tbInfo.tbSize = tbSize; /*Considering 2 PRBs */
166 schUlSlotInfo->schPuschInfo->dmrsMappingType = DMRS_MAP_TYPE_A; /* Setting Type-A */
167 schUlSlotInfo->schPuschInfo->nrOfDmrsSymbols = NUM_DMRS_SYMBOLS;
168 schUlSlotInfo->schPuschInfo->dmrsAddPos = DMRS_ADDITIONAL_POS;
170 *msg3StartRb = startRb;
179 * @brief process rach indication function.
183 * Function : schProcessRachInd
185 * This function process rach indication
187 * @param[in] rachInd parameters
188 * @param[in] shed instance
191 uint8_t schProcessRachInd(RachIndInfo *rachInd, Inst schInst)
193 SchCellCb *cell = schCb[schInst].cells[schInst];
194 RarInfo *rarInfo = NULLP;
196 uint16_t rarSlot = 0;
197 uint16_t msg3StartRb;
201 /* RAR will sent with a delay of RAR_DELAY */
202 rarSlot = (rachInd->timingInfo.slot+RAR_DELAY+PHY_DELTA)%SCH_NUM_SLOTS;
204 SchDlSlotInfo *schDlSlotInfo = cell->schDlSlotInfo[rarSlot]; /* RAR will sent in the next slot */
206 /* Allocate the rarInfo, this pointer will be checked at schProcessSlotInd function */
207 SCH_ALLOC(rarInfo, sizeof(RarInfo));
210 DU_LOG("\nMAC: Memory Allocation failed for rarInfo");
214 schDlSlotInfo->rarInfo = rarInfo;
216 /* calculate the ra-rnti value */
217 raRnti = calculateRaRnti(rachInd->symbolIdx,rachInd->slotIdx,rachInd->freqIdx);
219 /* create raCb at SCH */
220 createSchRaCb(rachInd->crnti,schInst);
222 /* allocate resources for msg3 */
223 ret = schAllocMsg3Pusch(schInst, rarSlot, &msg3StartRb, &msg3NumRb);
227 rarInfo->raRnti = raRnti;
228 rarInfo->tcrnti = rachInd->crnti;
229 rarInfo->RAPID = rachInd->preambleIdx;
230 rarInfo->ta = rachInd->timingAdv;
231 rarInfo->msg3FreqAlloc.startPrb = msg3StartRb;
232 rarInfo->msg3FreqAlloc.numPrb = msg3NumRb;
238 * @brief fill RAR info function.
242 * Function : calculateRaRnti
244 * This function fills pdcch and pdsch info for RAR
246 * @param[in] rar Allocation info
249 * @param[in] offset to pointA to determine freq alloc
252 uint8_t schFillRar(RarAlloc *rarAlloc, uint16_t raRnti, uint16_t pci, uint8_t offsetPointA)
255 uint8_t coreset0Idx = 0;
257 uint8_t firstSymbol = 0;
258 uint8_t numSymbols = 0;
260 uint8_t FreqDomainResource[6] = {0};
262 uint8_t numPdschSymbols = 12; /* considering pdsch region from 2 to 13 */
263 uint8_t mcs = 4; /* MCS fixed to 4 */
265 SchBwpDlCfg *initialBwp = &schCb[inst].cells[inst]->cellCfg.schInitialDlBwp;
267 PdcchCfg *pdcch = &rarAlloc->rarPdcchCfg;
268 PdschCfg *pdsch = &rarAlloc->rarPdschCfg;
269 BwpCfg *bwp = &rarAlloc->bwp;
271 coreset0Idx = initialBwp->pdcchCommon.commonSearchSpace.coresetId;
273 /* derive the sib1 coreset0 params from table 13-1 spec 38.213 */
274 numRbs = coresetIdxTable[coreset0Idx][1];
275 numSymbols = coresetIdxTable[coreset0Idx][2];
276 offset = coresetIdxTable[coreset0Idx][3];
278 /* calculate time domain parameters */
279 // note: since slot value is made sl1, RAR can be sent at all slots
280 uint16_t mask = 0x2000;
281 for(firstSymbol=0; firstSymbol<14;firstSymbol++)
283 if(initialBwp->pdcchCommon.commonSearchSpace.monitoringSymbol & mask)
289 /* calculate the PRBs */
290 schAllocFreqDomRscType0(((offsetPointA-offset)/6), (numRbs/6), FreqDomainResource);
293 bwp->freqAlloc.numPrb = initialBwp->bwp.freqAlloc.numPrb;
294 bwp->freqAlloc.startPrb = initialBwp->bwp.freqAlloc.startPrb;
295 bwp->subcarrierSpacing = initialBwp->bwp.scs;
296 bwp->cyclicPrefix = initialBwp->bwp.cyclicPrefix;
298 /* fill the PDCCH PDU */
299 pdcch->coreset0Cfg.startSymbolIndex = firstSymbol;
300 pdcch->coreset0Cfg.durationSymbols = numSymbols;
301 memcpy(pdcch->coreset0Cfg.freqDomainResource,FreqDomainResource,6);
302 pdcch->coreset0Cfg.cceRegMappingType = 1; /* coreset0 is always interleaved */
303 pdcch->coreset0Cfg.regBundleSize = 6; /* spec-38.211 sec 7.3.2.2 */
304 pdcch->coreset0Cfg.interleaverSize = 2; /* spec-38.211 sec 7.3.2.2 */
305 pdcch->coreset0Cfg.coreSetType = 0;
306 pdcch->coreset0Cfg.shiftIndex = pci;
307 pdcch->coreset0Cfg.precoderGranularity = 0; /* sameAsRegBundle */
309 pdcch->dci.rnti = raRnti; /* RA-RNTI */
310 pdcch->dci.scramblingId = pci;
311 pdcch->dci.scramblingRnti = 0;
312 pdcch->dci.cceIndex = 4; /* considering SIB1 is sent at cce 0-1-2-3 */
313 pdcch->dci.aggregLevel = 4;
314 pdcch->dci.beamPdcchInfo.numPrgs = 1;
315 pdcch->dci.beamPdcchInfo.prgSize = 1;
316 pdcch->dci.beamPdcchInfo.digBfInterfaces = 0;
317 pdcch->dci.beamPdcchInfo.prg[0].pmIdx = 0;
318 pdcch->dci.beamPdcchInfo.prg[0].beamIdx[0] = 0;
319 pdcch->dci.txPdcchPower.powerValue = 0;
320 pdcch->dci.txPdcchPower.powerControlOffsetSS = 0;
321 pdcch->dci.pdschCfg = pdsch;
323 /* fill the PDSCH PDU */
325 pdsch->pduBitmap = 0; /* PTRS and CBG params are excluded */
326 pdsch->rnti = raRnti; /* RA-RNTI */
328 pdsch->numCodewords = 1;
329 for(cwCount = 0; cwCount < pdsch->numCodewords; cwCount++)
331 pdsch->codeword[cwCount].targetCodeRate = 308;
332 pdsch->codeword[cwCount].qamModOrder = 2;
333 pdsch->codeword[cwCount].mcsIndex = mcs; /* mcs configured to 4 */
334 pdsch->codeword[cwCount].mcsTable = 0; /* notqam256 */
335 pdsch->codeword[cwCount].rvIndex = 0;
336 tbSize = schCalcTbSize(10); /* 8 bytes RAR and 2 bytes padding */
337 pdsch->codeword[cwCount].tbSize = tbSize;
339 pdsch->dataScramblingId = pci;
340 pdsch->numLayers = 1;
341 pdsch->transmissionScheme = 0;
343 pdsch->dmrs.dlDmrsSymbPos = 2;
344 pdsch->dmrs.dmrsConfigType = 0; /* type-1 */
345 pdsch->dmrs.dlDmrsScramblingId = pci;
346 pdsch->dmrs.scid = 0;
347 pdsch->dmrs.numDmrsCdmGrpsNoData = 1;
348 pdsch->dmrs.dmrsPorts = 0;
349 pdsch->dmrs.mappingType = DMRS_MAP_TYPE_A; /* Type-A */
350 pdsch->dmrs.nrOfDmrsSymbols = NUM_DMRS_SYMBOLS;
351 pdsch->dmrs.dmrsAddPos = DMRS_ADDITIONAL_POS;
352 pdsch->pdschFreqAlloc.resourceAllocType = 1; /* RAT type-1 RIV format */
353 pdsch->pdschFreqAlloc.freqAlloc.startPrb = offset + SCH_SSB_NUM_PRB; /* the RB numbering starts from coreset0, and PDSCH is always above SSB */
354 pdsch->pdschFreqAlloc.freqAlloc.numPrb = schCalcNumPrb(tbSize,mcs,numPdschSymbols);
355 pdsch->pdschFreqAlloc.vrbPrbMapping = 0; /* non-interleaved */
356 pdsch->pdschTimeAlloc.timeAlloc.startSymb = initialBwp->pdschCommon.startSymbol;
357 pdsch->pdschTimeAlloc.timeAlloc.numSymb = initialBwp->pdschCommon.lengthSymbol;
358 pdsch->beamPdschInfo.numPrgs = 1;
359 pdsch->beamPdschInfo.prgSize = 1;
360 pdsch->beamPdschInfo.digBfInterfaces = 0;
361 pdsch->beamPdschInfo.prg[0].pmIdx = 0;
362 pdsch->beamPdschInfo.prg[0].beamIdx[0] = 0;
363 pdsch->txPdschPower.powerControlOffset = 0;
364 pdsch->txPdschPower.powerControlOffsetSS = 0;
369 /**********************************************************************
371 **********************************************************************/