E2AP review changes part1
[o-du/l2.git] / src / 5gnrrlc / kw_uim.c
1 /*******************************************************************************
2 ################################################################################
3 #   Copyright (c) [2017-2019] [Radisys]                                        #
4 #                                                                              #
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                                    #
8 #                                                                              #
9 #       http://www.apache.org/licenses/LICENSE-2.0                             #
10 #                                                                              #
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 *******************************************************************************/
18
19 /********************************************************************20**
20   
21      Name:    LTE-RLC Layer - Upper Interface Functions
22     
23      Type:    C file
24   
25      Desc:     Source code for RLC Upper Interface Module
26                This file contains following functions
27       
28         --KwUiCkwBndReq
29         --KwUiCkwUbndReq
30         --KwUiCkwCfgReq
31
32         --KwUiKwuBndReq
33         --KwUiKwuUbndReq
34         --KwUiKwuDatReq
35         --KwUiKwuDiscSduReq 
36
37      File:     kw_uim.c
38
39 **********************************************************************/
40 static const char* RLOG_MODULE_NAME="UIM";
41 static int RLOG_MODULE_ID=2048;
42 static int RLOG_FILE_ID=205;
43
44 /** 
45  * @file kw_uim.c
46  * @brief RLC Upper Interface Module
47 */
48
49 #define KW_MODULE KW_DBGMASK_INF
50
51 \f
52 /* header (.h) include files */
53 #include "envopt.h"        /* environment options */
54 #include "envdep.h"        /* environment dependent */
55 #include "envind.h"        /* environment independent */
56
57 #include "gen.h"           /* general */
58 #include "ssi.h"           /* system services */
59 #include "cm5.h"           /* common timer defines */
60 #include "cm_tkns.h"       /* common tokens defines */
61 #include "cm_mblk.h"       /* common memory allocation library defines */
62 #include "cm_llist.h"      /* common link list  defines  */
63 #include "cm_hash.h"       /* common hash list  defines */
64 #include "cm_lte.h"        /* common LTE defines */
65 #include "lkw.h"           /* LKW defines */
66 #include "ckw.h"           /* CKW defines */
67 #include "kwu.h"           /* KWU defines */
68 #include "rgu.h"           /* RGU defines */
69 #include "kw_env.h"        /* RLC environment options */
70 #include "kw.h"            /* RLC defines */
71 #include "kw_dl.h"
72 #include "kw_ul.h"
73 #include "kw_udx.h"
74
75 /* extern (.x) include files */
76 #include "gen.x"           /* general */
77 #include "ssi.x"           /* system services */
78
79 #include "cm5.x"           /* common timer library */
80 #include "cm_tkns.x"       /* common tokens */
81 #include "cm_mblk.x"       /* common memory allocation */
82 #include "cm_llist.x"      /* common link list */
83 #include "cm_hash.x"       /* common hash list */
84 #include "cm_lte.x"        /* common LTE includes */
85 #include "cm_lib.x"        /* common memory allocation library */
86 #include "lkw.x"           /* LKW */
87 #include "ckw.x"           /* CKW */
88 #include "kwu.x"           /* KWU */
89 #include "rgu.x"           /* RGU */
90 #include "kw_err.h"
91 #include "kw.x"
92 #include "kw_udx.x"
93 #include "kw_dl.x"
94 #include "kw_ul.x"
95
96
97 /*****************************************************************************
98  *                          CKW INTERFACE
99  ****************************************************************************/
100
101 /**
102  * @brief 
103  *    Handler for binding the RLC upper layer service user with 
104  *    the RLC layer.
105  *
106  * @details
107  *    This function is used by RLC user to request for binding to 
108  *    RLC. This function is called by the CKW interface to bind 
109  *    RLC's SAP (identified by spId) with the service user's
110  *    SAP (identified by suId). 
111  *
112  * @param[in] pst     Post structure
113  * @param[in] suId    Service User ID
114  * @param[in] spId    Service provider ID
115  *
116  * @return  S16
117  *    -# ROK 
118  *    -# RFAILED
119  *
120 */
121 #ifdef ANSI
122 PUBLIC S16 KwUiCkwBndReq 
123 (
124 Pst    *pst,
125 SuId   suId,
126 SpId   spId 
127 )
128 #else
129 PUBLIC S16 KwUiCkwBndReq (pst, suId, spId)
130 Pst    *pst; 
131 SuId   suId;
132 SpId   spId;
133 #endif
134 {
135    KwCkwSapCb   *ckwSap;  
136    KwCb         *tKwCb;
137
138    TRC3(KwUiCkwBndReq);
139
140 #if (ERRCLASS & ERRCLS_INT_PAR)
141    if (pst->dstInst >= KW_MAX_RLC_INSTANCES)
142    {
143       RETVALUE(RFAILED);
144    }
145 #endif
146
147    tKwCb = KW_GET_KWCB(pst->dstInst);
148
149    RLOG2(L_DEBUG, "spId(%d), suId(%d)", spId, suId);
150    ckwSap = &(tKwCb->u.ulCb->ckwSap);
151    /* Take action based on the current state of the SAP */
152    switch(ckwSap->state)
153    {
154       /* SAP is configured but not bound */
155       case KW_SAP_CFG:
156       case KW_SAP_UBND:
157       {
158          /* copy bind configuration parameters in SSAP sap */
159          ckwSap->suId = suId;
160          ckwSap->pst.dstProcId = pst->srcProcId;
161          ckwSap->pst.dstEnt = pst->srcEnt;
162          ckwSap->pst.dstInst = pst->srcInst;
163
164          /* Update the State */
165          ckwSap->state = KW_SAP_BND;
166
167          RLOG1(L_DEBUG, "KwUiCkwBndReq: state (%d)", ckwSap->state);
168          break;
169       }
170       case KW_SAP_BND:
171       {
172          /* Sap is already bound check source, destination Entity and  
173           * Proc Id  */
174          if (ckwSap->pst.dstProcId != pst->srcProcId ||
175              ckwSap->pst.dstEnt != pst->srcEnt ||
176              ckwSap->pst.dstInst != pst->srcInst ||
177              ckwSap->suId != suId)
178          {
179             KW_SEND_SAPID_ALARM(tKwCb,
180                                 spId, 
181                                 LKW_EVENT_CKW_BND_REQ, 
182                                 LCM_CAUSE_INV_PAR_VAL);
183
184             RLOG0(L_ERROR, "CKW SAP already Bound");
185             KwUiCkwBndCfm(&(ckwSap->pst), ckwSap->suId, CM_BND_NOK);
186             RETVALUE(RFAILED);
187          }
188          break;
189       }
190       default:
191       {
192 #if (ERRCLASS & ERRCLS_INT_PAR)
193          RLOG0(L_ERROR, "Invalid CKW SAP State in Bind Req");
194          KW_SEND_SAPID_ALARM(tKwCb,
195                              spId, 
196                              LKW_EVENT_CKW_BND_REQ, 
197                              LCM_CAUSE_INV_STATE);
198 #endif /* ERRCLASS & ERRCLS_INT_PAR */
199          KwUiCkwBndCfm(&(ckwSap->pst), ckwSap->suId, CM_BND_NOK);
200          RETVALUE(RFAILED);
201          break;
202       }
203    }
204
205    KwUiCkwBndCfm(&(ckwSap->pst), ckwSap->suId, CM_BND_OK);
206    RETVALUE(ROK);
207
208
209 \f
210 /**
211  * @brief 
212  *    Handler for unbinding the RLC upper layer service user CKW with 
213  *    the RLC layer.
214  *
215  * @details
216  *    This function is used by RLC user to request for unbinding  
217  *    with RLC.This function is called by the CKW interface to 
218  *    unbind with RLC.  
219  *
220  * @param[in] pst     Post structure
221  * @param[in] spId    Service provider SAP ID
222  * @param[in] reason  Reason for Unbinding 
223  *
224  * @return  S16
225  *    -# ROK 
226  *    -# RFAILED
227 */ 
228 #ifdef ANSI
229 PUBLIC S16 KwUiCkwUbndReq
230 (
231 Pst      *pst,   
232 SpId     spId,  
233 Reason   reason 
234 )
235 #else
236 PUBLIC S16 KwUiCkwUbndReq(pst, spId, reason)
237 Pst      *pst; 
238 SpId     spId; 
239 Reason   reason;
240 #endif
241 {
242    KwCb *tKwCb;
243
244    TRC3(KwUiCkwUbndReq)
245
246 #if (ERRCLASS & ERRCLS_INT_PAR)
247    if (pst->dstInst >= KW_MAX_RLC_INSTANCES)
248    {
249       RETVALUE(RFAILED);
250    }
251 #endif /* ERRCLASS & ERRCLS_INT_PAR */
252    tKwCb = KW_GET_KWCB(pst->dstInst);
253
254    RLOG2(L_DEBUG,"spId(%d), reason(%d)", 
255                 spId, 
256                 reason);
257
258    UNUSED(reason);
259
260 #if (ERRCLASS & ERRCLS_INT_PAR)
261    KW_GET_AND_VALIDATE_CKWSAP(tKwCb, 
262                               (&(tKwCb->u.ulCb->ckwSap)), 
263                               EKW208, 
264                               "KwUiCkwUbndReq");
265 #endif /* ERRCLASS & ERRCLS_INT_PAR */
266
267    /* disable upper sap (CKW) */
268    tKwCb->u.ulCb->ckwSap.state = KW_SAP_CFG;
269    RETVALUE(ROK);
270
271
272 /*******************************************************************
273  *
274  * @brief Handler for UE create request
275  *
276  * @details
277  *
278  *    Function : RlcDuappProcUeCreateReq 
279  *
280  *    Functionality:
281  *       Handler for UE create request
282  *
283  * @params[in] pst - Post Structure
284  *             cfg - Configuration information for one or more RLC entities
285  * @return ROK     - success
286  *         RFAILED - failure
287  *
288  * ****************************************************************/
289 PUBLIC S16 RlcDuappProcUeCreateReq(Pst *pst, CkwCfgInfo *ueCfg)
290 {
291    U8 idx;
292    S16 ret=ROK;
293
294    ueCfg->transId = 1;
295
296    for(idx = 0; idx < ueCfg->numEnt; idx++)
297    {
298       ueCfg->entCfg[idx].cfgType = CKW_CFG_ADD; 
299    }
300    
301    ret = KwUiCkwCfgReq(pst, ueCfg);
302    return ret;
303
304 } /* RlcDuappUeCreateReq */ 
305
306 \f
307 /**
308  * @brief  
309  *    Handler for configuring RLC entities.
310  *
311  * @details
312  *    This function is used by RRC to configure(add/delete/modify)
313  *    one or more RLC entities. 
314  *
315  * @param[in] pst   -  Post structure  
316  * @param[in] spId  -  Serive Provider ID 
317  * @param[in] cfg   -  Configuration information for one or more RLC entities. 
318  *
319  * @return  S16
320  *      -# ROK 
321  *      -# RFAILED
322  */
323 #ifdef ANSI
324 PUBLIC S16 KwUiCkwCfgReq
325 (
326 Pst          *pst,
327 //SpId         spId,
328 CkwCfgInfo   *cfg
329 )
330 #else
331 //PUBLIC S16 KwUiCkwCfgReq(pst, spId, cfg)
332 PUBLIC S16 KwUiCkwCfgReq(pst, cfg)
333 Pst          *pst;
334 //SpId         spId;
335 CkwCfgInfo   *cfg;
336 #endif
337 {
338    KwCb        *tKwCb;
339    KwUlCfgTmpData   *cfgTmpData;
340
341    static U32  transCount;
342
343
344    TRC3(KwUiCkwCfgReq)
345       
346 #if (ERRCLASS & ERRCLS_INT_PAR)
347    if (pst->dstInst >= KW_MAX_RLC_INSTANCES)
348    {
349       KW_PST_FREE(pst->region, pst->pool, cfg, sizeof(CkwCfgInfo));
350       RETVALUE(RFAILED);
351    }
352 #endif
353    tKwCb = KW_GET_KWCB(pst->dstInst);
354
355    KW_ALLOC(tKwCb, cfgTmpData, sizeof (KwUlCfgTmpData));
356
357    if (cfgTmpData == NULLP)
358    {
359       KW_PST_FREE(pst->region, pst->pool, cfg, sizeof(CkwCfgInfo));
360       RETVALUE(RFAILED);
361    }
362
363
364    cfgTmpData->uprLyrTransId = cfg->transId; /*Save User TransId*/
365    cfgTmpData->transId = ++transCount;       /*Generate new TransId*/
366    cfg->transId = cfgTmpData->transId;
367    cfgTmpData->cfgInfo  = cfg;
368  
369    if (kwDbmAddUlTransaction(tKwCb, cfgTmpData) != ROK)
370    {
371       RLOG0(L_ERROR, "Addition to UL transId Lst Failed");
372       KW_PST_FREE(pst->region, pst->pool, cfg, sizeof(CkwCfgInfo));
373       
374       RETVALUE(RFAILED);
375    }
376    
377    kwHdlUiCkwUlCfgReq(tKwCb, cfgTmpData, cfg);
378    
379    KwUlUdxCfgReq(&(KW_GET_UDX_SAP(tKwCb)->pst),KW_GET_UDX_SAP(tKwCb)->spId,cfg); 
380
381    RETVALUE(ROK);
382
383
384 /**
385  * @brief 
386  *    Handler to change the UeId
387  *
388  * @details 
389  *    This primitive is used by RRC to change the UeId for the existing UE
390  *    context.
391  *     
392  * @param[in] pst     -  Point to the pst structure
393  * @param[in] spId    -  The ID of the service provider SAP in the RLC layer 
394  * @param[in] transId -  Transaction ID. This field uniquily identifies
395  *                       transaction between RRC and RLC
396  * @param[in] ueInfo    -  Old UE Id Info for which the change request has come 
397  * @param[in] newUeInfo -  New UE Id Info for existing UE context 
398  * 
399  * @return S16
400  *    -# ROK
401  *    -# RFAILED
402  */
403 #ifdef ANSI
404 PUBLIC S16 KwUiCkwUeIdChgReq
405 (
406 Pst         *pst, 
407 SpId        spId, 
408 U32         transId, 
409 CkwUeInfo   *ueInfo,
410 CkwUeInfo   *newUeInfo
411 )
412 #else
413 PUBLIC S16 KwUiCkwUeIdChgReq(pst, spId, transId, ueInfo, newUeInfo)
414 Pst         *pst;
415 SpId        spId;
416 U32         transId;
417 CkwUeInfo   *ueInfo;
418 CkwUeInfo   *newUeInfo;
419 #endif
420 {
421    S16              ret = ROK;
422    KwCb             *tKwCb;
423    KwUlCfgTmpData   *cfgTmpData = NULLP;
424
425    TRC3(KwUiCkwUeIdChgReq)
426
427    do
428    {
429 #if (ERRCLASS & ERRCLS_INT_PAR)
430       if (pst->dstInst >= KW_MAX_RLC_INSTANCES)
431       {
432          ret = RFAILED;
433          break;
434       }
435 #endif
436
437       tKwCb = KW_GET_KWCB(pst->dstInst);
438 #ifndef ALIGN_64BIT
439       RLOG_ARG2(L_DEBUG,DBG_CELLID,newUeInfo->cellId,
440                    "KwUiCkwUeIdChgReq(pst, spId(%d), transId(%ld))", 
441                    spId, 
442                    transId);
443 #else
444       RLOG_ARG2(L_DEBUG,DBG_CELLID,newUeInfo->cellId, 
445                    "KwUiCkwUeIdChgReq(pst, spId(%d), transId(%d))\n", 
446                    spId, 
447                    transId);
448 #endif
449
450       KW_ALLOC(tKwCb, cfgTmpData, sizeof (KwUlCfgTmpData));
451       if (!cfgTmpData)
452       {
453          ret = RFAILED;
454          break;
455       }
456
457       cfgTmpData->transId = transId;
458       cfgTmpData->ueInfo  = ueInfo;
459       cfgTmpData->newUeInfo  = newUeInfo; 
460
461       if (kwDbmAddUlTransaction(tKwCb, cfgTmpData))
462       {
463          RLOG0(L_ERROR, "Addition to UL transId Lst Failed");
464          ret = RFAILED;
465          break;
466       }
467    }while(0);
468
469    if(ret)
470    {
471       /* there was an error in the processing, free up all the memory
472        * that was passed and could have been allocated in this function
473        */
474       /* Freeing from proper region */
475       KW_PST_FREE(pst->region, pst->pool, newUeInfo, sizeof(CkwUeInfo));
476       KW_PST_FREE(pst->region, pst->pool, ueInfo, sizeof(CkwUeInfo));
477
478       if(cfgTmpData)
479       {
480          KW_FREE(tKwCb, cfgTmpData, sizeof (KwUlCfgTmpData));
481       }
482       RETVALUE(RFAILED);
483    }
484
485    if(ROK != kwCfgValidateUeIdChng(tKwCb,ueInfo,newUeInfo,cfgTmpData))
486    {
487       RLOG_ARG0(L_ERROR,DBG_CELLID,cfgTmpData->ueInfo->cellId, 
488             "Validation Failure for UeId change");
489    }
490
491    KwUlUdxUeIdChgReq(&(KW_GET_UDX_SAP(tKwCb)->pst),
492                      KW_GET_UDX_SAP(tKwCb)->spId,
493                      transId, 
494                      ueInfo,
495                      newUeInfo);
496
497    RETVALUE(ROK);
498
499
500 \f
501 /**
502  * @brief 
503  *    Handler for Configuration Request 
504  *
505  * @param[in] gCb      RLC Instance Control Block  
506  * @param[in] cfgTmpData  Configuration stored in Transaction Block  
507  * @param[in] cfg      Configuration block
508  *
509  * @return  S16
510  *    -# ROK 
511  *    -# RFAILED
512  */
513 #ifdef ANSI
514 PUBLIC Void kwHdlUiCkwUlCfgReq
515 (
516 KwCb             *gCb,
517 KwUlCfgTmpData   *cfgTmpData,
518 CkwCfgInfo       *cfg
519 )
520 #else
521 PUBLIC Void kwHdlUiCkwUlCfgReq(gCb, cfgTmpData, cfg)
522 KwCb             *gCb;
523 KwUlCfgTmpData   *cfgTmpData;
524 CkwCfgInfo       *cfg;
525 #endif
526 {
527    U8   idx;  
528
529    TRC3(kwHdlUiCkwUlCfgReq)
530
531    cfgTmpData->ueId = cfg->ueId;
532    cfgTmpData->cellId = cfg->cellId;
533    for (idx = 0; idx < cfg->numEnt; idx++)
534    {
535       cfgTmpData->cfgEntData[idx].entUlCfgCfm.status.status = CKW_CFG_CFM_OK;
536       cfgTmpData->cfgEntData[idx].entUlCfgCfm.rbId = cfg->entCfg[idx].rbId; 
537       cfgTmpData->cfgEntData[idx].entUlCfgCfm.rbType = cfg->entCfg[idx].rbType;
538       switch(cfg->entCfg[idx].cfgType)
539       {
540          case CKW_CFG_ADD:
541          case CKW_CFG_MODIFY:
542          case CKW_CFG_DELETE:
543          {
544          
545             if(cfg->entCfg[idx].dir & KW_DIR_UL)
546             {
547                /* Configuration is for UL , thus validating */
548                if(ROK != kwCfgValidateUlRb(gCb,
549                                            &cfg->entCfg[idx], 
550                                            &cfgTmpData->cfgEntData[idx],
551                                            cfgTmpData))
552                {
553                   RLOG_ARG2(L_ERROR,DBG_UEID, cfgTmpData->ueId,
554                         "CELLID [%u]:Validation Failure for UL RB [%d]",
555                          cfg->cellId,cfg->entCfg[idx].rbId);
556                   cfgTmpData->cfgEntData[idx].entUlCfgCfm.status.status = CKW_CFG_CFM_NOK;
557                   /*Validation is getting failed so no need to do configuration at DL.
558                    *Set dir as UL, so that no configuration is done at DL */
559                   cfg->entCfg[idx].dir = KW_DIR_UL;
560                }
561             }
562             if(cfg->entCfg[idx].dir == KW_DIR_UL)
563             {
564                /*If the configuration is for UL only then apply it */   
565                if (cfgTmpData->cfgEntData[idx].entUlCfgCfm.status.status == CKW_CFG_CFM_OK)
566                {
567                   kwCfgApplyUlRb(gCb, 
568                                  &cfg->entCfg[idx], 
569                                  &cfgTmpData->cfgEntData[idx],
570                                  cfgTmpData);
571                }
572             }
573             break;
574          }
575          case CKW_CFG_REESTABLISH:   
576          {
577             if(cfg->entCfg[idx].dir & KW_DIR_UL)
578             {
579                if(ROK != kwCfgValidateReEstRb(gCb,
580                                               cfg->ueId, 
581                                               cfg->cellId, 
582                                               &cfg->entCfg[idx], 
583                                               &cfgTmpData->cfgEntData[idx]))
584                {
585                   RLOG_ARG2(L_ERROR,DBG_UEID,cfg->ueId,
586                         "CellID [%u]:Validation Failure for Reest UL RB [%d]",
587                         cfg->cellId,cfg->entCfg[idx].rbId);
588                   cfgTmpData->cfgEntData[idx].entUlCfgCfm.status.status = CKW_CFG_CFM_NOK;
589                   /* Setting dir as UL, so that no configuration is done at DL */
590                   cfg->entCfg[idx].dir = KW_DIR_UL;
591                   break;
592                }
593             }
594             if(cfg->entCfg[idx].dir == KW_DIR_UL)
595             {
596                /*If the configuration is for UL only then apply it */   
597                if (cfgTmpData->cfgEntData[idx].entUlCfgCfm.status.status == CKW_CFG_CFM_OK)
598                {
599                   kwCfgApplyReEstUlRb(gCb,  
600                                       cfg->ueId, 
601                                       cfg->cellId,
602                                       TRUE,
603                                       &cfgTmpData->cfgEntData[idx]);
604                }
605             }
606             break;
607          }
608          case CKW_CFG_DELETE_UE :   
609          {
610             if(ROK != kwCfgValidateDelUlUe(gCb,  
611                                            &cfg->entCfg[idx], 
612                                            &cfgTmpData->cfgEntData[idx],
613                                            cfgTmpData))
614             {
615                RLOG_ARG1(L_ERROR,DBG_CELLID,cfg->cellId,
616                      "UL UEID [%d]:Validation Failure",
617                      cfgTmpData->ueId);
618                cfgTmpData->cfgEntData[idx].entUlCfgCfm.status.status = CKW_CFG_CFM_NOK;
619                /* Setting dir as UL, so that no configuration is done at DL */
620                cfg->entCfg[idx].dir = KW_DIR_UL;
621             }
622             break;
623          }
624          case CKW_CFG_DELETE_CELL :   
625          {
626             if(ROK != kwCfgValidateDelUlCell(gCb,
627                                              cfg->cellId, 
628                                              &cfg->entCfg[idx], 
629                                              &cfgTmpData->cfgEntData[idx],
630                                              cfgTmpData))
631             {
632                RLOG_ARG0(L_ERROR,DBG_CELLID,cfg->cellId,
633                      "Del UL Cell Validation Failure");
634                cfgTmpData->cfgEntData[idx].entUlCfgCfm.status.status = CKW_CFG_CFM_NOK;
635                /* Setting dir as UL, so that no configuration is done at DL */
636                cfg->entCfg[idx].dir = KW_DIR_UL;
637             }
638             break;
639          }
640       }/* switch end */
641    }/* for end */
642    RETVOID;
643 }
644
645 \f
646 /*****************************************************************************
647  *                          KWU INTERFACE
648  ****************************************************************************/
649 /**
650  * @brief  
651  *    Handler for binding the RLC upper layer service user with 
652  *    the RLC layer.
653  *
654  * @details
655  *    This function is used by RLC user to request for binding to 
656  *    RLC.This function is called by the KWU interface to bind 
657  *    RLC's SAP (identified by spId) with the service user's
658  *    SAP (identified by suId). 
659  *
660  * @param[in] pst   Post structure  
661  * @param[in] suId  Service user SAP ID 
662  * @param[in] spId  Service provider ID
663  *
664  * @return  S16
665  *    -# ROK
666  *    -# RFAILED
667  *
668  */
669 #ifdef ANSI
670 PUBLIC S16 KwUiKwuBndReq 
671 (
672 Pst    *pst,  
673 SuId   suId, 
674 SpId   spId 
675 )
676 #else
677 PUBLIC S16 KwUiKwuBndReq (pst, suId, spId)
678 Pst    *pst;  
679 SuId   suId; 
680 SpId   spId; 
681 #endif
682 {
683    KwKwuSapCb   *kwuSap;     /* SAP Config Block */
684    KwCb         *tKwCb;
685    
686    TRC3(KwUiKwuBndReq)
687
688 #if (ERRCLASS & ERRCLS_INT_PAR)
689    if (pst->dstInst >= KW_MAX_RLC_INSTANCES)
690    {
691       RETVALUE(RFAILED);
692    }
693 #endif
694    tKwCb = KW_GET_KWCB(pst->dstInst);
695    RLOG2(L_DEBUG, "KwUiKwuBndReq(pst, spId(%d), suId(%d))", spId, suId);
696
697     /* Validation of input parameters */
698 #if (ERRCLASS & ERRCLS_INT_PAR)
699    if(!((spId < (S16) tKwCb->genCfg.maxKwuSaps) && (spId >=0))) 
700    {
701       RLOG0(L_ERROR,"Invalid spId");
702       KW_SEND_SAPID_ALARM(tKwCb,spId, LKW_EVENT_KWU_BND_REQ, LCM_CAUSE_INV_SAP);
703       RETVALUE(RFAILED); 
704    }
705 #endif
706
707    /* Get Sap control block */
708    kwuSap = (tKwCb->genCfg.rlcMode == LKW_RLC_MODE_DL) ?
709             (tKwCb->u.dlCb->kwuDlSap + spId):
710             (tKwCb->u.ulCb->kwuUlSap + spId);
711
712    /* Take action based on the current state of the SAP */
713    switch(kwuSap->state)
714    {
715       /* SAP is configured but not bound */
716       case KW_SAP_CFG:
717       case KW_SAP_UBND:
718       {
719          /* copy bind configuration parameters in sap */
720          kwuSap->suId          = suId;
721          kwuSap->pst.dstProcId = pst->srcProcId;
722          kwuSap->pst.dstEnt    = pst->srcEnt;
723          kwuSap->pst.dstInst   = pst->srcInst;
724
725          /* Update the State */
726          kwuSap->state = KW_SAP_BND;
727
728          RLOG1(L_DEBUG, "KwUiKwuBndReq: state (%d)", kwuSap->state);
729          break;
730       }
731       case KW_SAP_BND:
732       {
733          /* Sap is already bound check source, destination Entity and Proc Id */
734          if (kwuSap->pst.dstProcId != pst->srcProcId ||
735              kwuSap->pst.dstEnt != pst->srcEnt ||
736              kwuSap->pst.dstInst != pst->srcInst ||
737              kwuSap->suId != suId)
738          {
739             KW_SEND_SAPID_ALARM(tKwCb,
740                                 spId, 
741                                 LKW_EVENT_KWU_BND_REQ, 
742                                 LCM_CAUSE_INV_PAR_VAL);
743             RLOG1(L_ERROR,"RLC Mode [%d] : KWU SAP already Bound",
744                   tKwCb->genCfg.rlcMode);
745             KwUiKwuBndCfm(&(kwuSap->pst), kwuSap->suId, CM_BND_NOK);
746             RETVALUE(RFAILED);
747          }
748          break;
749       }
750
751      default:
752       {
753 #if (ERRCLASS & ERRCLS_INT_PAR)
754          RLOG1(L_ERROR,"RLC Mode [%d]:Invalid KWU SAP State in Bind Req",
755                tKwCb->genCfg.rlcMode);
756          KW_SEND_SAPID_ALARM(tKwCb,
757                              spId,
758                              LKW_EVENT_KWU_BND_REQ, 
759                              LCM_CAUSE_INV_STATE);
760 #endif /* ERRCLASS & ERRCLS_INT_PAR */
761          KwUiKwuBndCfm(&(kwuSap->pst), kwuSap->suId, CM_BND_NOK);
762          RETVALUE(RFAILED);
763       }
764    }
765    KwUiKwuBndCfm(&(kwuSap->pst), kwuSap->suId, CM_BND_OK);
766    RETVALUE(ROK);
767
768
769 \f
770 /**
771  * @brief 
772  *    Handler for unbinding the RLC upper layer service user with 
773  *    the RLC layer.
774  *
775  * @details
776  *    This function is used by RLC user to request for unbinding  
777  *    with RLC.This function is called by the KWU interface to 
778  *    unbind with RLC. 
779  *
780  * @param[in] pst     Post structure  
781  * @param[in] spId    Service provider SAP ID 
782  * @param[in] reason  Reason for Unbinding 
783  *
784  * @return  S16
785  *     -# ROK 
786  *     -# RFAILED
787  */
788 #ifdef ANSI
789 PUBLIC S16 KwUiKwuUbndReq
790 (
791 Pst      *pst,  
792 SpId     spId, 
793 Reason   reason 
794 )
795 #else
796 PUBLIC S16 KwUiKwuUbndReq(pst, spId, reason)
797 Pst      *pst; 
798 SpId     spId; 
799 Reason   reason; 
800 #endif
801 {
802    KwKwuSapCb   *kwuSap;   /* KWU SAP control block */
803    KwCb         *tKwCb;
804
805    TRC3(KwUiKwuUbndReq)
806
807 #if (ERRCLASS & ERRCLS_INT_PAR)
808    if ((pst->dstInst >= KW_MAX_RLC_INSTANCES) ||
809        (spId >= (S16) kwCb[pst->dstInst]->genCfg.maxKwuSaps) ||
810        (spId < 0))
811    {
812       RETVALUE (RFAILED);
813    }
814 #endif
815
816    tKwCb = KW_GET_KWCB(pst->dstInst);
817
818    RLOG2(L_DEBUG, "spId(%d), reason(%d)", 
819                 spId, 
820                 reason);
821
822    /* Get Sap control block */
823    kwuSap = (tKwCb->genCfg.rlcMode == LKW_RLC_MODE_DL) ?
824             (tKwCb->u.dlCb->kwuDlSap + spId):
825             (tKwCb->u.ulCb->kwuUlSap + spId);
826
827    kwuSap->state = KW_SAP_CFG;
828
829    RETVALUE(ROK);
830
831
832 /**
833  * @brief Handler for receiving the data(SDU) from upper layer. 
834  *
835  * @details
836  *    This function is used by RLC service user (PDCP) to 
837  *    transfer data (SDU) to RLC.
838  *
839  * @param[in] pst         Post structure  
840  * @param[in] spId        Service Provider SAP ID 
841  * @param[in] datreq  Data Request Information
842  * @param[in] mBuf        Data Buffer (SDU) 
843  *
844  * @return  S16
845  *    -# ROK 
846  *    -# RFAILED
847  */
848 #ifdef ANSI
849 PUBLIC S16 KwUiKwuDatReq
850 (
851 Pst             *pst,   
852 SpId            spId,  
853 KwuDatReqInfo   *datReq, 
854 Buffer          *mBuf   
855 )
856 #else
857 PUBLIC S16 KwUiKwuDatReq(pst, spId, datReq, mBuf)
858 Pst             *pst;  
859 SpId            spId; 
860 KwuDatReqInfo   *datReq; 
861 Buffer          *mBuf;  
862 #endif
863 {
864    S16          ret = ROK;   /* Return Value */
865    KwDlRbCb     *rbCb;       /* RB Control Block */
866    KwKwuSapCb   *kwuSap;     /* SAP Config Block */
867    KwCb         *tKwCb;
868
869    TRC3(KwUiKwuDatReq)
870
871 #if (ERRCLASS & ERRCLS_INT_PAR)
872    if ((pst->dstInst >= KW_MAX_RLC_INSTANCES) ||
873        (spId >= (S16) kwCb[pst->dstInst]->genCfg.maxKwuSaps) ||
874        (spId < 0))
875    {
876       SPutMsg(mBuf);
877       RETVALUE(RFAILED);
878    }
879 #endif
880
881    tKwCb = KW_GET_KWCB(pst->dstInst);
882
883    /* Get Sap control block */
884    kwuSap = tKwCb->u.dlCb->kwuDlSap + spId;
885
886    /* Validate SAP ID under ERRORCLS */
887    KW_VALDATE_SAP(tKwCb,spId, kwuSap, ret);
888    if (ret != ROK)
889    {
890       KW_FREE_BUF(mBuf);
891       RETVALUE(RFAILED);
892    }
893
894    /* Fetch the RbCb */
895    kwDbmFetchDlRbCbByRbId(tKwCb, &datReq->rlcId, &rbCb);
896    if(!rbCb)
897    {
898       RLOG_ARG2(L_WARNING, DBG_UEID,datReq->rlcId.ueId, "CellId[%u]:DL RbId [%d] not found",
899             datReq->rlcId.cellId,datReq->rlcId.rbId);
900       KW_FREE_BUF(mBuf);
901
902       RETVALUE(RFAILED);
903    }
904
905    /* kw005.201 update the spId received in datReq to update statistics */
906    rbCb->kwuSapId = spId;
907    /* Dispatch according to mode of the rbCb */
908    switch (rbCb->mode)
909    {
910       case CM_LTE_MODE_TM:
911       {
912          /* Verify the user */
913          if (pst->srcEnt != ENTNH)
914          {
915             /* kw002.201 Freeing from proper region */
916             KW_SHRABL_STATIC_BUF_FREE(pst->region, pst->pool, datReq, 
917                         sizeof(KwuDatReqInfo));
918             KW_FREE_BUF(mBuf);
919              
920             RETVALUE(RFAILED);
921          }
922
923          kwTmmQSdu(tKwCb,rbCb, datReq, mBuf);
924          /* kw005.201 ccpu00117318, updated statistics */
925          kwuSap->sts.sduRx++;
926          break;
927       }
928       case CM_LTE_MODE_UM:
929       {
930          kwUmmQSdu(tKwCb,rbCb, datReq, mBuf);
931
932          /* kw005.201 ccpu00117318, updated statistics */
933          kwuSap->sts.sduRx++;
934          break;
935       }
936       case CM_LTE_MODE_AM:
937       {
938          kwAmmQSdu(tKwCb,rbCb, mBuf, datReq);
939          /* kw005.201 ccpu00117318, updated statistics */
940          kwuSap->sts.sduRx++;
941          break;
942       }
943       default:
944       {
945          RLOG0(L_ERROR, "Invalid RB Mode");
946          break;
947       }
948    }
949    RETVALUE(ret);
950
951
952 \f
953 /**
954  * @brief 
955  *    Handler for discarding a SDU. 
956  *
957  * @details
958  *    This function is used by RLC AM  and RLC UM entities. 
959  *    This function is called by the service user to discard a particular
960  *    RLC SDU if it is present in the SDU queue of the RB control block 
961  *    and if it is not mapped to any PDU. 
962  *
963  * @param[in] pst            Post structure  
964  * @param[in] spId           Service Provider SAP ID 
965  * @param[in] discSdu        SDU discard Information 
966  *
967  * @return  S16
968  *    -# ROK 
969  *    -# RFAILED
970  */
971 #ifdef ANSI
972 PUBLIC S16 KwUiKwuDiscSduReq 
973 (
974 Pst              *pst,   
975 SpId             spId,  
976 KwuDiscSduInfo   *discSdu 
977 )
978 #else
979 PUBLIC S16 KwUiKwuDiscSduReq(pst, spId, discSdu)
980 Pst              *pst;   
981 SpId             spId;  
982 KwuDiscSduInfo   *discSdu; 
983 #endif
984 {
985    KW_SHRABL_STATIC_BUF_FREE(pst->region, pst->pool, discSdu, sizeof(KwuDiscSduInfo));
986    RETVALUE(ROK);
987
988
989 /********************************************************************30**
990          End of file
991 **********************************************************************/