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: Defines required by LTE MAC
29 **********************************************************************/
30 static const char* RLOG_MODULE_NAME="UDX";
31 static int RLOG_MODULE_ID=262144;
32 static int RLOG_FILE_ID=204;
35 @brief UDX Uplink Module
38 /* header include files (.h) */
39 #include "common_def.h"
40 #include "lkw.h" /* LKW defines */
41 #include "ckw.h" /* CKW defines */
42 #include "kwu.h" /* KWU defines */
43 #include "rgu.h" /* RGU defines */
44 #include "kw_err.h" /* Err defines */
45 #include "kw_env.h" /* RLC environment options */
47 #include "kw.h" /* RLC defines */
52 /* extern (.x) include files */
53 #include "lkw.x" /* LKW */
54 #include "ckw.x" /* CKW */
55 #include "kwu.x" /* KWU */
56 #include "rgu.x" /* RGU */
63 #include "du_app_rlc_inf.h"
65 #include "rlc_utils.h"
67 #define RLC_MODULE RLC_DBGMASK_UDX
72 /* forward references */
74 /* public variable declarations */
75 S16 rlcHdlCrlcUlCfgReq ARGS((RlcCb *gCb,RlcUlCfgTmpData *cfgTmpData,
76 RlcCfgCfmInfo *cfmInfo, RlcCfgCfmInfo *cfgCfm));
84 * Handler for bind confirmation from DL.
87 * This function handles the bind confirmation received
90 * @param[in] pst Post structure
91 * @param[in] suId Service User ID
92 * @param[in] status Status of confirmation
108 RlcUdxUlSapCb *udxSap; /* RGU SAP Control Block */
111 #if (ERRCLASS & ERRCLS_INT_PAR)
112 if (pst->dstInst >= MAX_RLC_INSTANCES)
117 tRlcCb = RLC_GET_RLCCB(pst->dstInst);
119 RLCDBGP_BRIEF(tRlcCb, "rlcUlUdxBndCfm(post, suId(%d), status(%d)\n",
122 #if (ERRCLASS & ERRCLS_INT_PAR)
123 if (tRlcCb->init.cfgDone != TRUE)
125 RLOG0(L_FATAL, "General configuration not done");
126 RLC_SEND_SAPID_ALARM(tRlcCb,suId,
127 LKW_EVENT_LI_BND_CFM, LCM_CAUSE_INV_STATE);
134 RLOG0(L_ERROR, "Invalid suId");
135 RLC_SEND_SAPID_ALARM(tRlcCb,suId,
136 LKW_EVENT_LI_BND_CFM, LCM_CAUSE_INV_SUID);
140 #endif /* ERRCLASS & ERRCLS_INT_PAR */
142 udxSap = tRlcCb->u.ulCb->udxUlSap + suId;
144 RLCDBGP_DETAIL(tRlcCb, "RlcLiRguBndCfm: For RGU SAP state=%d\n",
147 /* Check rguSap state */
148 switch (udxSap->state)
150 case RLC_SAP_BINDING:
152 if(TRUE == rlcChkTmr(tRlcCb,(PTR)udxSap,EVENT_RLC_WAIT_BNDCFM))
154 rlcStopTmr (tRlcCb,(PTR)udxSap, EVENT_RLC_WAIT_BNDCFM);
156 udxSap->retryCnt = 0;
158 if (status == CM_BND_OK)
160 udxSap->state = RLC_SAP_BND;
161 event = LCM_EVENT_BND_OK;
162 cause = LKW_CAUSE_SAP_BNDENB;
166 udxSap->state = RLC_SAP_CFG;
167 event = LCM_EVENT_BND_FAIL;
168 cause = LKW_CAUSE_UNKNOWN;
174 event = LKW_EVENT_RGU_BND_CFM;
175 cause = LCM_CAUSE_INV_STATE;
178 /* Send an alarm with proper event and cause */
179 RLC_SEND_SAPID_ALARM(tRlcCb,suId, event, cause);
186 * Handles UDX Configuration Confirm
189 * This function handles the UDX configuration Confirm from DL Instance
191 * @param[in] pst Post structure
192 * @param[in] suId Service User ID
193 * @param[in] cfmInfo Confirm Information
203 RlcCfgCfmInfo *cfmInfo
207 RlcCfgCfmInfo *cfgCfm;
208 RlcUlCfgTmpData *cfgTmpData;
210 memset(&rspPst, 0, sizeof(Pst));
212 #if (ERRCLASS & ERRCLS_INT_PAR)
213 if (pst->dstInst >= MAX_RLC_INSTANCES)
215 RLC_FREE_SHRABL_BUF(pst->region,
218 sizeof(RlcCfgCfmInfo));
222 tRlcCb = RLC_GET_RLCCB(pst->dstInst);
223 RLCDBGP_BRIEF(tRlcCb, " suId(%d)\n", suId);
225 #if (ERRCLASS & ERRCLS_INT_PAR)
228 RLOG0(L_ERROR, "Invalid suId");
229 RLC_SEND_SAPID_ALARM(tRlcCb,suId,
230 LKW_EVENT_LI_BND_CFM, LCM_CAUSE_INV_SUID);
231 RLC_FREE_SHRABL_BUF(pst->region,
234 sizeof(RlcCfgCfmInfo));
237 #endif /* ERRCLASS & ERRCLS_INT_PAR */
239 if(ROK != rlcDbmFindUlTransaction(tRlcCb,cfmInfo->transId, &cfgTmpData))
241 RLOG0(L_ERROR, "Invalid transId");
242 RLC_FREE_SHRABL_BUF(pst->region,
245 sizeof(RlcCfgCfmInfo));
249 if(ROK != rlcDbmDelUlTransaction(tRlcCb, cfgTmpData))
251 RLC_FREE_SHRABL_BUF(pst->region,
254 sizeof(RlcCfgCfmInfo));
257 /* Allocate memory and memset to 0 for cfmInfo */
258 RLC_ALLOC(tRlcCb,cfgCfm, sizeof(RlcCfgCfmInfo));
259 #if (ERRCLASS & ERRCLS_ADD_RES)
262 RLOG0(L_FATAL, "Memory Allocation failed.");
263 RLC_FREE_SHRABL_BUF(pst->region,
266 sizeof(RlcCfgCfmInfo));
269 #endif /* ERRCLASS & ERRCLS_ADD_RES */
270 rlcHdlCrlcUlCfgReq(tRlcCb,cfgTmpData, cfmInfo, cfgCfm);
271 if(tRlcCb->u.ulCb->rlcUlUdxEventType == EVENT_RLC_UE_CREATE_REQ)
273 FILL_PST_RLC_TO_DUAPP(rspPst, RLC_UL_INST, EVENT_RLC_UE_CREATE_RSP);
275 else if(tRlcCb->u.ulCb->rlcUlUdxEventType == EVENT_RLC_UE_RECONFIG_REQ)
277 FILL_PST_RLC_TO_DUAPP(rspPst, RLC_UL_INST, EVENT_RLC_UE_RECONFIG_RSP);
279 SendRlcUeRspToDu(&rspPst, cfgCfm);
281 /* free the memory from DL */
282 RLC_FREE_SHRABL_BUF(pst->region,
285 sizeof(RlcCfgCfmInfo));
287 /* free the cfgInfo that came from LM */
288 RLC_PST_FREE(pst->region, pst->pool, cfgTmpData->cfgInfo, sizeof(RlcCfgInfo));
289 RLC_FREE(tRlcCb,cfgTmpData,sizeof(RlcUlCfgTmpData));
296 * Handler for UeId change confirm
299 * This function handles the UeId Change Confirm from DL Instance
301 * @param[in] pst Post structure
302 * @param[in] suId Service User ID
303 * @param[in] transId Transaction Id
304 * @param[in] status Status of confirmation
310 S16 rlcUlUdxUeIdChgCfm
319 RlcUlCfgTmpData *cfgTmpData;
321 #if (ERRCLASS & ERRCLS_INT_PAR)
322 if (pst->dstInst >= MAX_RLC_INSTANCES)
327 tRlcCb = RLC_GET_RLCCB(pst->dstInst);
329 RLCDBGP_BRIEF(tRlcCb, " suId(%d) \n", suId);
331 #if (ERRCLASS & ERRCLS_INT_PAR)
334 RLOG0(L_ERROR, "Invalid suId");
337 #endif /* ERRCLASS & ERRCLS_INT_PAR */
339 if(ROK != rlcDbmFindUlTransaction(tRlcCb, transId, &cfgTmpData))
341 RLOG0(L_ERROR, "Invalid transId");
345 if(ROK != rlcDbmDelUlTransaction(tRlcCb, cfgTmpData))
350 if(status.status == CKW_CFG_CFM_OK)
352 if(cfgTmpData->ueCb != NULLP)
354 rlcCfgApplyUlUeIdChng(tRlcCb, cfgTmpData->ueInfo, cfgTmpData->newUeInfo, cfgTmpData);
357 RlcUiCkwUeIdChgCfm(&(tRlcCb->u.ulCb->ckwSap.pst),
358 tRlcCb->u.ulCb->ckwSap.suId,
359 transId,cfgTmpData->ueInfo,status);
360 /* only newUeInfo needs to be freed here, ueInfo would be freed at the
361 interface or by he receipient in case of tight coupling */
362 RLC_PST_FREE(pst->region, pst->pool, cfgTmpData->newUeInfo, sizeof(CkwUeInfo));
363 RLC_FREE(tRlcCb, cfgTmpData, sizeof (RlcUlCfgTmpData));
369 * Udx Status Prohibit Timer Start
371 * @param[in] pst Post structure
372 * @param[in] suId Service User ID
373 * @param[in] rlcId rlc Id
378 S16 rlcUlUdxStaProhTmrStart
385 RlcCb *tRlcCb= NULLP;
388 #if (ERRCLASS & ERRCLS_INT_PAR)
389 if (pst->dstInst >= MAX_RLC_INSTANCES)
394 tRlcCb = RLC_GET_RLCCB(pst->dstInst);
396 rlcDbmFetchUlRbCbByRbId(tRlcCb, rlcId, &rbCb);
399 RLOG_ARG2(L_ERROR, DBG_UEID,rlcId->ueId, "CellId [%u]:RbId[%d] not found",
400 rlcId->cellId,rlcId->rbId);
404 /* Start staProhTmr */
405 rlcStartTmr(tRlcCb,(PTR)rbCb, EVENT_RLC_AMUL_STA_PROH_TMR);
412 * Handler for configuration confirm from DL.
414 * @param[in] gCb - RLC Instance Control Block
415 * @param[in] cfgTmpData - Configuration Temporary Data
416 * @param[in] cfmInfo - DL Configuration Confirm Info
417 * @param[out] cfgCfm - Configuration Confirm to be sent to RRC
423 S16 rlcHdlCrlcUlCfgReq
426 RlcUlCfgTmpData *cfgTmpData,
427 RlcCfgCfmInfo *cfmInfo,
428 RlcCfgCfmInfo *cfgCfm
435 cfg = cfgTmpData->cfgInfo;
436 maxEnt = (cfg->numEnt < CKW_MAX_ENT_CFG)? cfg->numEnt:CKW_MAX_ENT_CFG;
438 for (idx = 0; idx < maxEnt; idx++)
440 RlcEntCfgCfmInfo *entCfgCfm;
441 RlcEntCfgCfmInfo *entDlCfgCfm;
442 RlcEntCfgInfo *entCfg;
444 entCfg = &(cfg->entCfg[idx]);
445 entCfgCfm = &(cfgCfm->entCfgCfm[idx]);
446 entDlCfgCfm = &(cfmInfo->entCfgCfm[idx]);
447 switch (entCfg->cfgType)
453 if (entCfg->dir == RLC_DIR_UL)
455 RLC_MEM_CPY(entCfgCfm,
456 &cfgTmpData->cfgEntData[idx].entUlCfgCfm,
457 sizeof(RlcEntCfgCfmInfo));
459 else if (entCfg->dir == RLC_DIR_DL)
461 RLC_MEM_CPY(entCfgCfm, entDlCfgCfm, sizeof(RlcEntCfgCfmInfo));
463 else if(entCfg->dir == RLC_DIR_BOTH)
465 if (entDlCfgCfm->status.status != CKW_CFG_CFM_OK)
467 rlcCfgRollBackUlRb(gCb,
470 &cfgTmpData->cfgEntData[idx]);
476 &cfgTmpData->cfgEntData[idx],
479 RLC_MEM_CPY(entCfgCfm, entDlCfgCfm, sizeof(RlcEntCfgCfmInfo));
483 RLC_CFG_FILL_CFG_CFM(entCfgCfm, entCfg->rbId, entCfg->rbType,
484 CKW_CFG_CFM_NOK, CKW_CFG_REAS_INVALID_DIR);
485 RLOG_ARG2(L_ERROR,DBG_UEID,cfg->ueId,"RBID[%d] direction[%d] is invalid",
486 entCfg->rbId,entCfg->dir);
491 case CKW_CFG_REESTABLISH:
493 if (entCfg->dir == RLC_DIR_UL)
495 RLC_MEM_CPY(entCfgCfm,
496 &cfgTmpData->cfgEntData[idx].entUlCfgCfm,
497 sizeof(RlcEntCfgCfmInfo));
499 else if (entCfg->dir == RLC_DIR_DL)
501 RLC_MEM_CPY(entCfgCfm, entDlCfgCfm, sizeof(RlcEntCfgCfmInfo));
505 if (entCfg->dir & RLC_DIR_UL)
507 /* Reestablish indication is sent from UL Instance only*/
508 if (entDlCfgCfm->status.status == CKW_CFG_CFM_OK)
510 rlcCfgApplyReEstUlRb (gCb, cfg->ueId,
512 &cfgTmpData->cfgEntData[idx]);
514 RLC_MEM_CPY(entCfgCfm, entDlCfgCfm, sizeof(RlcEntCfgCfmInfo));
519 case CKW_CFG_DELETE_UE:
521 if (cfgTmpData->cfgEntData[idx].entUlCfgCfm.status.status == CKW_CFG_CFM_OK)
523 rlcCfgApplyDelUlUe(gCb, cfgTmpData);
524 RLC_MEM_CPY(entCfgCfm,
525 &cfgTmpData->cfgEntData[idx].entUlCfgCfm,
526 sizeof(RlcEntCfgCfmInfo));
530 RLC_MEM_CPY(entCfgCfm, entDlCfgCfm,
531 sizeof(RlcEntCfgCfmInfo));
535 case CKW_CFG_DELETE_CELL:
537 if (cfgTmpData->cfgEntData[idx].entUlCfgCfm.status.status == CKW_CFG_CFM_OK)
539 rlcCfgApplyDelUlCell(gCb, cfgTmpData);
540 RLC_MEM_CPY(entCfgCfm,
541 &cfgTmpData->cfgEntData[idx].entUlCfgCfm,
542 sizeof(RlcEntCfgCfmInfo));
546 RLC_MEM_CPY(entCfgCfm, entDlCfgCfm,
547 sizeof(RlcEntCfgCfmInfo));
553 RLC_CFG_FILL_CFG_CFM(entCfgCfm, entCfg->rbId, entCfg->rbType,
554 CKW_CFG_CFM_NOK, CKW_CFG_REAS_INVALID_CFG);
556 RLOG0(L_ERROR,"Invalid configuration type");
561 /* Assign number of entity configurations and suId */
562 cfgCfm->transId = cfgTmpData->uprLyrTransId;
563 cfgCfm->ueId = cfg->ueId;
564 cfgCfm->cellId = cfg->cellId;
565 cfgCfm->numEnt = cfg->numEnt;
571 #endif /* __cplusplus */
574 /**********************************************************************
576 **********************************************************************/