src/du_app/du_mgr.h

   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 /* This file contains message handling functionality for DU cell management */
  20 #ifndef __DU_MGR_H__
  21 #define __DU_MGR_H__
  22 #define DU_PROC  0
  23
  24 /* SAP IDs */
  25 #define DU_MAC_SUID 0
  26 #define DU_MAC_SPID 0
  27
  28 /* Instance */
  29 #define RLC_UL_INST 0
  30 #define RLC_DL_INST 1
  31
  32 /* SAP state */
  33 #define DU_SAP_UNBOUND 1
  34 #define DU_SAP_BINDING 2
  35 #define DU_SAP_BOUND   3
  36
  37 #define DU_ZERO_VAL 0
  38
  39 /* Macros */
  40 #define ADD 0
  41 #define DEL 1
  42
  43 #define RLC_GEN_CFG      1
  44 #define RLC_MAC_SAP_CFG  2
  45 #define RLC_UDX_SAP_CFG  4
  46
  47 #define MAC_GEN_CFG   1
  48 #define MAC_SAP_CFG   2
  49 #define MAX_MAC_SAP   2
  50
  51 #define DU_RLC_UL_CONFIGURED  (RLC_GEN_CFG |  \
  52       RLC_MAC_SAP_CFG | RLC_UDX_SAP_CFG)
  53 #define DU_RLC_DL_CONFIGURED DU_RLC_UL_CONFIGURED
  54
  55 #define MAC_CONFIGURED (MAC_GEN_CFG | MAC_SAP_CFG)
  56
  57 #define DU_SET_ZERO(_buf, _size)   \
  58    memset((_buf), 0, _size);
  59
  60 typedef enum
  61 {
  62    SLICE_INFO_NOT_AVAILABLE,
  63    SLICE_CONFIGURED,
  64    SLICE_RECONFIGURED
  65 }SliceCfgState;
  66
  67 typedef enum
  68 {
  69    CELL_OUT_OF_SERVICE,
  70    ACTIVATION_IN_PROGRESS,
  71    ACTIVATED,
  72    DELETION_IN_PROGRESS
  73 }CellStatus;
  74
  75 typedef enum
  76 {
  77    UE_INACTIVE,
  78    UE_ACTIVE,
  79    UE_HANDIN_IN_PROGRESS,
  80    UE_DELETION_IN_PROGRESS
  81 }UeState;
  82
  83 typedef enum
  84 {
  85    UE_CTXT_UNKNOWN,
  86    UE_CTXT_SETUP,
  87    UE_CTXT_MOD,
  88    UE_CTXT_RRC_RECFG_COMPLETE,
  89    UE_CTXT_CFG_QUERY,
  90    UE_CTXT_RELEASE
  91 }UeCtxtActionType;
  92
  93 /** F1AP Msg IE **/
  94 typedef struct f1setupRsp
  95 {
  96    uint32_t transId; /* Uniquely identify transaction */
  97    char     cuName[CU_DU_NAME_LEN_MAX];   /* CU Name */
  98    F1RrcVersion    rrcVersion;  /* RRC version */
  99 }F1SetupRsp;
 100
 101 typedef struct f1DlRrcMsg
 102 {
 103    uint32_t gnbDuUeF1apId;
 104    uint32_t gnbCuUeF1apId;
 105    uint8_t  srbId;
 106    bool     execDup;
 107    bool     deliveryStatRpt;
 108    uint16_t rrcMsgSize;
 109    uint8_t  *rrcMsgPdu;
 110 }F1DlRrcMsg;
 111
 112 typedef struct gtpTnlCfg
 113 {
 114    uint32_t ulTnlAddress;  /* remote Address */
 115    uint32_t dlTnlAddress;  /* local Address */
 116    uint32_t teId;
 117 }GtpTnlCfg;
 118
 119 typedef struct upTnlCfg
 120 {
 121    ConfigType configType;
 122    uint8_t cellId;
 123    uint8_t ueId;
 124    uint8_t drbId;
 125    GtpTnlCfg *tnlCfg1; /* Tunnel 1 */
 126    GtpTnlCfg *tnlCfg2; /* Tunnel 2 */
 127 }UpTnlCfg;
 128
 129 typedef struct duUeCfg
 130 {
 131    void *cellGrpCfg;
 132    void *ueNrCapability;
 133    uint8_t numRlcLcs;        /* Rlc Ue Cfg */
 134    RlcBearerCfg rlcLcCfg[MAX_NUM_LC];
 135    uint8_t numMacLcs;        /* Mac Ue Cfg */
 136    LcCfg   macLcCfg[MAX_NUM_LC];
 137    AmbrCfg *ambrCfg;
 138    uint8_t numDrb;
 139    UpTnlCfg upTnlInfo[MAX_NUM_DRB];  /* User plane TNL Info*/
 140    uint8_t numDrbSetupMod;        /*No. of DRB Added during Modification*/
 141    MacUeCfg copyOfmacUeCfg;
 142 }DuUeCfg;
 143
 144 typedef struct f1UeContextSetup
 145 {
 146    UeCtxtActionType actionType;
 147    uint8_t cellIdx;
 148    DuUeCfg  duUeCfg;
 149    bool     dlRrcMsgPres;
 150    F1DlRrcMsg  *dlRrcMsg;
 151 }F1UeContextSetupDb;
 152
 153 typedef struct cellCfgParams
 154 {
 155    NrEcgi      nrEcgi;         /* ECGI */
 156    uint16_t    nrPci;          /* PCI */
 157    uint16_t    fiveGsTac;         /* 5gSTac */
 158    Plmn        plmn[MAX_PLMN]; /* List of serving PLMN IDs */
 159    uint32_t    maxUe;          /* max UE per slot */
 160 }CellCfgParams;
 161
 162 typedef struct duUeCb
 163 {
 164    F1UeContextSetupDb *f1UeDb;
 165    uint16_t crnti;
 166    uint32_t gnbDuUeF1apId;   /* GNB DU UE F1AP ID */
 167    uint32_t gnbCuUeF1apId;   /* GNB CU UE F1AP ID */
 168    uint32_t drbBitMap;       /* Drb Bit Map */
 169    UeState  ueState;         /* UE Active/ Ue Inactive state */
 170    MacUeCfg macUeCfg;        /* Mac Ue Cfg */
 171    RlcUeCfg rlcUeCfg;        /* Rlc Ue Cfg */
 172 }DuUeCb;
 173
 174 typedef struct  slotInfo
 175 {
 176    uint16_t sfn;
 177    uint16_t slot;
 178 }SlotInfo;
 179
 180 typedef struct duCellCb
 181 {
 182    uint16_t       cellId;                 /* Internal cell Id */
 183    CellCfgParams  cellInfo;               /* Cell info */
 184    /* pointer to store the address of macCellCfg params used to send du-app to MAC */
 185    MacCellCfg     *duMacCellCfg;
 186    CellStatus     cellStatus;             /* Cell status */
 187    uint32_t       numActvUes;             /* Total Active UEs */
 188    DuUeCb         ueCb[MAX_NUM_UE];       /* UE context created after RRC setup */
 189    uint32_t       numHoUes;               /* Number of UE handover in progress */
 190    DuUeCb         hoUeCb[MAX_NUM_UE];     /* UE context created before RACH for UE being handover to this DU */
 191    SlotInfo       currSlotInfo;
 192 }DuCellCb;
 193
 194 typedef struct duLSapCb
 195 {
 196    Pst pst;
 197    SuId        suId;
 198    SpId        spId;
 199    State       sapState;
 200    Mem         mem;
 201    CmTimer     timer;
 202    uint8_t     bndRetryCnt;
 203    uint8_t     maxBndRetry;
 204    TmrCfg      bndTmr;
 205 }DuLSapCb;
 206
 207 typedef struct ueCcchCtxt
 208 {
 209    uint32_t gnbDuUeF1apId; /* GNB DU UE F1AP ID */
 210    uint16_t crnti;         /* CRNTI */
 211    uint16_t cellId;        /* Cell Id */
 212 }UeCcchCtxt;
 213
 214 /* This structure is added to store the information about the F1AP pdu and
 215  * transId so that It can be used in future */
 216 typedef struct reservedF1apPduInfo
 217 {
 218    uint8_t transId;               /* trans Id */
 219    void *f1apMsg;              /* msg structure */
 220 }ReservedF1apPduInfo;
 221
 222 /* DU APP DB */
 223 typedef struct duCb
 224 {
 225    Mem           mem;                       /* Memory configs */
 226    TskInit       init;                      /* DU Init */
 227    bool          f1Status;                  /* Status of F1 connection */
 228    bool          e2Status;                  /* Status of E2 connection */
 229    uint8_t       numCfgCells;               /* number of configured cells */
 230    DuCellCb*     cfgCellLst[MAX_NUM_CELL];  /* List of cells at DU APP of type DuCellCb */
 231    uint8_t       numActvCells;              /* Number of active cells */
 232    DuCellCb*     actvCellLst[MAX_NUM_CELL]; /* List of cells activated/to be activated of type DuCellCb */
 233    uint32_t      gnbDuUeF1apIdGenerator;    /* Generating Du Ue F1ap Id */
 234    uint32_t      numUe;                     /* current number of UEs */
 235    UeCcchCtxt    ueCcchCtxt[MAX_NUM_UE];    /* mapping of gnbDuUeF1apId to CRNTI required for CCCH processing*/
 236    uint8_t       numTeId;                   /* current number of TEIDs configured in the system*/
 237    UpTnlCfg*     upTnlCfg[MAX_TEID];        /* tunnel info for every Drb */
 238    CmLListCp     reservedF1apPduList;       /*storing F1AP pdu infomation and transId */
 239    SliceCfgState sliceState;
 240    F1SetupMsg    f1SetupReqAndRspMsg;
 241 }DuCb;
 242
 243
 244 typedef struct duLSapCfg
 245 {
 246    SuId        suId;
 247    SpId        spId;
 248    Ent         srcEnt;
 249    Inst        srcInst;
 250    ProcId      dstProcId;
 251    Ent         dstEnt;
 252    Inst        dstInst;
 253    Priority    dstPrior;
 254    Route       dstRoute;
 255    Selector    dstSel;
 256    Mem         mem;
 257    uint8_t          maxBndRetry;
 258    TmrCfg      bndTmr;
 259    TmrCfg      connTmr;
 260 }DuLSapCfg;
 261
 262 /* global variables */
 263 DuCb duCb;
 264 //DuCfgParams duCfgParam;
 265
 266 /* DU Cell Functions */
 267 uint8_t duActvInit(Ent entity, Inst inst, Region region, Reason reason);
 268 uint8_t duActvTsk(Pst *pst, Buffer *mBuf);
 269 uint8_t duSendRlcUlCfg();
 270 uint8_t duSendRlcDlCfg();
 271 uint8_t duBuildRlcCfg(Inst inst);
 272 uint8_t duBuildRlcLsapCfg(Ent ent, Inst inst, uint8_t lsapInst);
 273 uint8_t duBuildRlcUsapCfg(uint8_t elemId, Ent ent, Inst inst);
 274 uint8_t DuHdlRlcCfgComplete(Pst *pst, RlcMngmt *cfm);
 275 uint8_t duHdlRlcCntrlCfgComplete(Pst *pst, RlcMngmt *cfm);
 276 uint8_t duProcRlcUlCfgComplete(Pst *pst, RlcMngmt *cfm);
 277 uint8_t duProcRlcDlCfgComplete(Pst *pst, RlcMngmt *cfm);
 278 uint8_t duSendMacCfg();
 279 uint8_t duBuildMacGenCfg();
 280 uint8_t duBuildMacUsapCfg(SpId sapId);
 281 uint8_t duHdlMacCfgComplete(Pst *pst, RgMngmt *cfm);
 282 uint8_t duBindUnbindRlcToMacSap(uint8_t inst, uint8_t action);
 283 uint8_t duProcCfgComplete();
 284 uint8_t duSendSchCfg();
 285 uint8_t duSctpStartReq();
 286 uint8_t duSctpNtfyHdl(Buffer *mBuf, CmInetSctpNotification *ntfy);
 287
 288 uint8_t duBuildEgtpCfgReq();
 289 uint8_t duHdlEgtpCfgComplete(CmStatus cfm);
 290 uint8_t duSendEgtpSrvOpenReq();
 291 uint8_t duHdlEgtpSrvOpenComplete(CmStatus cfm);
 292 uint8_t duSendEgtpTnlMgmtReq(uint8_t action, uint32_t teIdMod, GtpTnlCfg *tnlInfo);
 293 uint8_t duSendEgtpDatInd(Buffer *mBuf);
 294 uint8_t duHdlSchCfgComplete(Pst *pst, RgMngmt *cfm);
 295 uint8_t duBuildAndSendMacCellStart();
 296 uint8_t duBuildAndSendMacCellStop(uint16_t cellId);
 297 #endif
 298
 299 /**********************************************************************
 300   End of file
 301  **********************************************************************/