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 **********************************************************************/
32 @brief This file has APIs to handle the random access procedure functionality.
35 static const char* RLOG_MODULE_NAME="MAC";
36 static int RLOG_FILE_ID=132;
37 static int RLOG_MODULE_ID=4096;
39 /* header include files (.h) */
40 #include "common_def.h"
41 #include "rg_env.h" /* MAC Environment Defines */
42 #include "crg.h" /* CRG Interface defines */
43 #include "rgu.h" /* RGU Interface defines */
44 #include "tfu.h" /* TFU Interface defines */
45 #include "rg_sch_inf.h" /* RGR Interface defines */
46 #include "lrg.h" /* LRG Interface defines */
48 #include "rg.h" /* MAC defines */
49 #include "rg_err.h" /* MAC error defines */
51 /* header/extern include files (.x) */
53 #include "crg.x" /* CRG Interface includes */
54 #include "rgu.x" /* RGU Interface includes */
55 #include "tfu.x" /* TFU Interface includes */
56 #include "rg_sch_inf.x" /* SCH Interface includes */
57 #include "rg_prg.x" /* PRG Interface includes */
58 #include "lrg.x" /* LRG Interface includes */
60 #include "du_app_mac_inf.h"
61 #include "rg.x" /* MAC includes */
67 /* forward references */
69 /***********************************************************
71 * Func : rgRAMFreeUeCb
76 * - Frees UE control block.
84 **********************************************************/
92 Void rgRAMFreeUeCb(inst,ue)
97 rgDHMFreeUe(inst,&ue->dl.hqEnt);
99 /*ccpu00117052 - MOD - Passing double pointer for proper NULLP
101 /* De-allocate the Ue */
102 rgFreeSBuf(inst,(Data **)&ue, sizeof(*ue));
104 /* Stack Crash problem for TRACE5 changes. Added the return below */
107 } /* rgRAMFreeUeCb */
110 * @brief Handler for Random Access control block creation.
114 * Function : rgRAMCreateUeCb
115 * Creates a raCb and gives the same to scheduler for its updation.
118 * @param[in] RgCellCb *cell
119 * @param[in] CmLteRnti tmpCrnti
120 * @param[out] RgErrInfo *err
124 RgUeCb* rgRAMCreateUeCb
132 RgUeCb* rgRAMCreateUeCb(cell, tmpCrnti, insert, err)
139 Inst inst = cell->macInst - RG_INST_START;
140 RgUeCb *ueCb = NULLP;
142 RLOG_ARG1(L_INFO,DBG_CELLID,cell->cellId,"CREATE UECB FOR CRNTI:%d",
144 /* Allocate the Ue control block */
145 if (rgAllocSBuf(inst,(Data **)&ueCb, sizeof(*ueCb)) != ROK)
147 RLOG_ARG1(L_ERROR,DBG_CELLID,cell->cellId,
148 "Memory allocation FAILED for CRNTI:%d",tmpCrnti);
149 err->errCause = RGERR_RAM_MEM_EXHAUST;
153 /* Inititialize Ue control block */
154 ueCb->ueId = tmpCrnti;
156 /* Initialize the lists of the UE */
161 /* MS_FIX : Remove stale UEs if present */
162 RgUeCb *staleUe = NULLP;
163 /* Insert the created raCb into raCb list of cell */
164 ueCb->rachLstEnt.next = NULLP;
165 ueCb->rachLstEnt.prev = NULLP;
166 ueCb->rachLstEnt.node = (PTR)(ueCb);
167 /* MS_FIX : Remove stale UEs if present */
168 staleUe = rgDBMGetUeCbFromRachLst (cell, tmpCrnti);
171 rgDBMDelUeCbFromRachLst(cell, staleUe);
172 rgRAMFreeUeCb(inst,staleUe);
174 rgDBMInsUeCbInRachLst(cell, ueCb);
178 } /* rgRAMCreateUeCb */
181 * @brief Function for handling cell delete.
185 * Function : rgRAMFreeCell
187 * This function shall be invoked whenever a cell needs to be deleted.
188 * This shall remove raCbs and raReqs stored in cell.
191 * @param[in,out] RgCellCb *cell
201 S16 rgRAMFreeCell(cell)
205 Inst inst = cell->macInst - RG_INST_START;
208 /* Free CURRENT CRG cfg list */
209 while ((ueCb = rgDBMGetNextUeCbFromRachLst(cell, NULLP)) != NULLP)
211 rgDBMDelUeCbFromRachLst(cell, ueCb);
212 rgRAMFreeUeCb(inst,ueCb);
216 } /* rgRAMFreeCell */
218 * @brief Function for handling RA response scheduled for a subframe.
222 * Function : rgHndlRaResp
224 * This function shall be invoked whenever scheduler is done with the
225 * allocations of random access responses for a subframe RgSchMacSfAllocReq.
229 * This shall invoke RAM to create ueCbs for all the rapIds allocated and
230 * shall invoke MUX to create RAR PDUs for raRntis allocated.
233 * @param[in] RgCellCb *cell,
234 * @param[in] CmLteTimingInfo timingInfo,
235 * @param[in] RgInfRarInfo *rarInfo
236 * @param[in/out] RgErrInfo *err
244 CmLteTimingInfo timingInfo,
245 RgInfRarInfo *rarInfo,
249 S16 rgHndlRaResp(cell, timingInfo, rarInfo, err)
251 CmLteTimingInfo timingInfo;
252 RgInfRarInfo *rarInfo;
261 if(NULLP == rarInfo->raRntiInfo)
266 idx = (timingInfo.slot % RG_NUM_SUB_FRAMES);
267 dlSf = &cell->subFrms[idx];
269 /* Create RAR PDUs for all the allocated RA-RNTIs */
270 for(idx1 = 0; idx1 < rarInfo->numRaRntis; idx1++)
272 if(ROK == (rgMUXBldRarPdu(cell,
273 &rarInfo->raRntiInfo[idx1], &rarPdu, err)))
275 /* Create RaCbs for all the rapIds allocated */
276 for(idx2 = 0; idx2 < rarInfo->raRntiInfo[idx1].numCrnti; idx2++)
278 if(FALSE == rarInfo->raRntiInfo[idx1].crntiInfo[idx2].isContFree)
280 if(rgRAMCreateUeCb(cell,
281 rarInfo->raRntiInfo[idx1].crntiInfo[idx2].tmpCrnti,
288 /* Store the created RAR PDU */
289 dlSf->raRsp[dlSf->numRaRsp].pdcch.rnti =
290 rarInfo->raRntiInfo[idx1].raRnti;
292 dlSf->raRsp[dlSf->numRaRsp].pdcch.dci =
293 rarInfo->raRntiInfo[idx1].dciInfo;
295 dlSf->raRsp[dlSf->numRaRsp].rar = rarPdu;
296 /* ccpu00132314-ADD-Adding txPower offset for the PDSCH transmission */
297 dlSf->raRsp[dlSf->numRaRsp].txPwrOffset =
298 rarInfo->txPwrOffset;
304 RLOG_ARG1(L_ERROR,DBG_CELLID,cell->cellId,"RARNTI:%d Creation of RAR"
305 "PDU for failed", rarInfo->raRntiInfo[idx1].raRnti);
308 } /* end of raRntis loop */
310 } /* end of rgHndlRaResp */
312 /**********************************************************************
315 **********************************************************************/