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 **********************************************************/
86 PUBLIC Void rgRAMFreeUeCb
92 PUBLIC Void rgRAMFreeUeCb(inst,ue)
99 rgDHMFreeUe(inst,&ue->dl.hqEnt);
101 /*ccpu00117052 - MOD - Passing double pointer for proper NULLP
103 /* De-allocate the Ue */
104 rgFreeSBuf(inst,(Data **)&ue, sizeof(*ue));
106 /* Stack Crash problem for TRACE5 changes. Added the return below */
109 } /* rgRAMFreeUeCb */
112 * @brief Handler for Random Access control block creation.
116 * Function : rgRAMCreateUeCb
117 * Creates a raCb and gives the same to scheduler for its updation.
120 * @param[in] RgCellCb *cell
121 * @param[in] CmLteRnti tmpCrnti
122 * @param[out] RgErrInfo *err
126 PUBLIC RgUeCb* rgRAMCreateUeCb
134 PUBLIC RgUeCb* rgRAMCreateUeCb(cell, tmpCrnti, insert, err)
141 Inst inst = cell->macInst - RG_INST_START;
142 RgUeCb *ueCb = NULLP;
144 TRC2(rgRAMCreateUeCb)
146 RLOG_ARG1(L_INFO,DBG_CELLID,cell->cellId,"CREATE UECB FOR CRNTI:%d",
148 /* Allocate the Ue control block */
149 if (rgAllocSBuf(inst,(Data **)&ueCb, sizeof(*ueCb)) != ROK)
151 RLOG_ARG1(L_ERROR,DBG_CELLID,cell->cellId,
152 "Memory allocation FAILED for CRNTI:%d",tmpCrnti);
153 err->errCause = RGERR_RAM_MEM_EXHAUST;
157 /* Inititialize Ue control block */
158 ueCb->ueId = tmpCrnti;
160 /* Initialize the lists of the UE */
165 /* MS_FIX : Remove stale UEs if present */
166 RgUeCb *staleUe = NULLP;
167 /* Insert the created raCb into raCb list of cell */
168 ueCb->rachLstEnt.next = NULLP;
169 ueCb->rachLstEnt.prev = NULLP;
170 ueCb->rachLstEnt.node = (PTR)(ueCb);
171 /* MS_FIX : Remove stale UEs if present */
172 staleUe = rgDBMGetUeCbFromRachLst (cell, tmpCrnti);
175 rgDBMDelUeCbFromRachLst(cell, staleUe);
176 rgRAMFreeUeCb(inst,staleUe);
178 rgDBMInsUeCbInRachLst(cell, ueCb);
182 } /* rgRAMCreateUeCb */
185 * @brief Function for handling cell delete.
189 * Function : rgRAMFreeCell
191 * This function shall be invoked whenever a cell needs to be deleted.
192 * This shall remove raCbs and raReqs stored in cell.
195 * @param[in,out] RgCellCb *cell
200 PUBLIC S16 rgRAMFreeCell
205 PUBLIC S16 rgRAMFreeCell(cell)
209 Inst inst = cell->macInst - RG_INST_START;
214 /* Free CURRENT CRG cfg list */
215 while ((ueCb = rgDBMGetNextUeCbFromRachLst(cell, NULLP)) != NULLP)
217 rgDBMDelUeCbFromRachLst(cell, ueCb);
218 rgRAMFreeUeCb(inst,ueCb);
222 } /* rgRAMFreeCell */
224 * @brief Function for handling RA response scheduled for a subframe.
228 * Function : rgHndlRaResp
230 * This function shall be invoked whenever scheduler is done with the
231 * allocations of random access responses for a subframe RgSchMacSfAllocReq.
235 * This shall invoke RAM to create ueCbs for all the rapIds allocated and
236 * shall invoke MUX to create RAR PDUs for raRntis allocated.
239 * @param[in] RgCellCb *cell,
240 * @param[in] CmLteTimingInfo timingInfo,
241 * @param[in] RgInfRarInfo *rarInfo
242 * @param[in/out] RgErrInfo *err
247 PUBLIC S16 rgHndlRaResp
250 CmLteTimingInfo timingInfo,
251 RgInfRarInfo *rarInfo,
255 PUBLIC S16 rgHndlRaResp(cell, timingInfo, rarInfo, err)
257 CmLteTimingInfo timingInfo;
258 RgInfRarInfo *rarInfo;
269 if(NULLP == rarInfo->raRntiInfo)
274 idx = (timingInfo.slot % RG_NUM_SUB_FRAMES);
275 dlSf = &cell->subFrms[idx];
277 /* Create RAR PDUs for all the allocated RA-RNTIs */
278 for(idx1 = 0; idx1 < rarInfo->numRaRntis; idx1++)
280 if(ROK == (rgMUXBldRarPdu(cell,
281 &rarInfo->raRntiInfo[idx1], &rarPdu, err)))
283 /* Create RaCbs for all the rapIds allocated */
284 for(idx2 = 0; idx2 < rarInfo->raRntiInfo[idx1].numCrnti; idx2++)
286 if(FALSE == rarInfo->raRntiInfo[idx1].crntiInfo[idx2].isContFree)
288 if(rgRAMCreateUeCb(cell,
289 rarInfo->raRntiInfo[idx1].crntiInfo[idx2].tmpCrnti,
296 /* Store the created RAR PDU */
297 dlSf->raRsp[dlSf->numRaRsp].pdcch.rnti =
298 rarInfo->raRntiInfo[idx1].raRnti;
300 dlSf->raRsp[dlSf->numRaRsp].pdcch.dci =
301 rarInfo->raRntiInfo[idx1].dciInfo;
303 dlSf->raRsp[dlSf->numRaRsp].rar = rarPdu;
304 /* ccpu00132314-ADD-Adding txPower offset for the PDSCH transmission */
305 dlSf->raRsp[dlSf->numRaRsp].txPwrOffset =
306 rarInfo->txPwrOffset;
312 RLOG_ARG1(L_ERROR,DBG_CELLID,cell->cellId,"RARNTI:%d Creation of RAR"
313 "PDU for failed", rarInfo->raRntiInfo[idx1].raRnti);
316 } /* end of raRntis loop */
318 } /* end of rgHndlRaResp */
320 /**********************************************************************
323 **********************************************************************/