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 *******************************************************************************/
23 #define MAX_CRI_SIZE 6
24 #define MAX_MAC_DL_PDU 16
25 #define MAX_NUM_HARQ_PROC 16
26 #define MAX_ZERO_CORR_CFG_IDX 16 /* max zero correlation config index */
27 #define MAC_TQ_SIZE 10 /* Timing Queue Size */
28 #define MAX_NUM_TIMER 1 /* MAX number of MAC timers */
30 #define DEFAULT_CELLS 1
31 #define SI_RNTI 0xFFFF
34 #define MAC_LCID_CCCH 0
35 #define MAC_LCID_MIN 1
36 #define MAC_LCID_MAX 32
37 #define MAC_LCID_RESERVED_MIN 33
38 #define MAC_LCID_RESERVED_MAX 51
39 #define MAC_LCID_CCCH_48BIT 52
40 #define MAC_LCID_BIT_RATE_QUERY 53
41 #define MAC_LCID_MULT_PHR_FOUR_OCT 54
42 #define MAC_LCID_CFG_GRANT_CFM 55
43 #define MAC_LCID_MULT_PHR_ONE_OCT 56
44 #define MAC_LCID_SINGLE_PHR 57
45 #define MAC_LCID_CRNTI 58
46 #define MAC_LCID_SHORT_TRUNC_BSR 59
47 #define MAC_LCID_LONG_TRUNC_BSR 60
48 #define MAC_LCID_SHORT_BSR 61
49 #define MAC_LCID_LONG_BSR 62
50 #define MAC_LCID_CRI 62
51 #define MAC_LCID_PADDING 63
53 /* Definitions for size of RAR PDU contents (in bits).
54 * Refer spec 38.321, sections 6.1.4, 6.2.2 and 6.2.3*/
60 #define TIMING_ADVANCE_SIZE 12
61 #define T_CRNTI_SIZE 16
62 /* UL Grant is of size = 27 bits. Refer to Spec 38.213, Table 8.2-1 for
63 * contents of UL grant in RAR */
64 #define FREQ_HOP_FLAG_SIZE 1
65 #define FREQ_RSRC_ALLOC_SIZE 14
66 #define TIME_RSRC_ALLOC_SIZE 4
68 #define TPC_COMMAND_SIZE 3
69 #define CSI_REQUEST_SIZE 1
71 typedef struct macCellCb MacCellCb;
77 CELL_STOP_IN_PROGRESS,
89 MAC_LC_STATE_INACTIVE,
93 typedef struct dlTbInfo
95 SlotTimingInfo txTime;
100 /* DL HARQ Process Info */
101 typedef struct dlHarqProcCb
103 uint8_t procId; /* HARQ Process Id */
104 uint8_t numTb; /* Number of TB */
105 DlTbInfo tbInfo[MAX_NUM_TB_PER_UE]; /* TB information */
108 typedef struct macDlSlot
111 DlPageAlloc *pageAllocInfo;
114 typedef struct macUlSlot
119 typedef struct macCbInfo
123 uint8_t msg3Pdu[6]; /* used as CRI value during muxing */
124 uint8_t *msg4Pdu; /* storing DL-CCCH Ind Pdu */
125 uint16_t msg4PduLen; /* storing DL-CCCH Ind Pdu Len */
126 DlHarqProcCb msg4HqInfo; /* HARQ process info for msg 4 */
133 uint8_t macCeValue[6];
136 typedef struct macCeInfo
139 MacCe macCe[MAX_MAC_CE];
142 typedef struct macDlInfo
149 typedef struct macDlData
153 MacDlInfo pduInfo[MAX_MAC_DL_PDU];
157 typedef struct dlHarqEnt
159 uint8_t maxReTx; /* MAX HARQ retransmission */
160 uint8_t numHarqProcs; /* Number of HARQ procs */
161 DlHarqProcCb harqProcCb[MAX_NUM_HARQ_PROC];
164 /* Uplink deidcated logical channel info */
165 typedef struct ulLcCb
167 uint8_t lcId; /* Logical Channel Id */
168 uint8_t lcGrpId; /* Logical Channel group */
169 MacLcState lcActive; /* Is LC active ? */
170 /*Commenting as S-NSSAI and PDU session will be used in future scope*/
171 /*For eg: When we have to send these for AMBR cases*/
173 uint16_t pduSessionId; /*Pdu Session Id*/
174 Snssai *snssai; /*S-NSSAI assoc with LCID*/
178 /* Downlink dedicated logical channel info */
179 typedef struct dlLcCb
181 uint8_t lcId; /* Logical channel Id */
182 MacLcState lcState; /* Is LC active ? */
183 /*Commenting as S-NSSAI and PDU session will be used in future scope*/
184 /*For eg: When we have to send these info via FAPI to phy layer*/
186 uint16_t pduSessionId;/*Pdu Session Id*/
187 Snssai *snssai; /*S-NSSAI assoc with LCID*/
191 /* BSR Information */
192 typedef struct macBsrTmrCfg
194 uint16_t periodicTimer;
196 uint16_t srDelayTimer;
199 /* UE specific UL info */
200 typedef struct ueUlCb
202 uint8_t maxReTx; /* MAX HARQ retransmission */
203 uint8_t numUlLc; /* Number of uplink logical channels */
204 UlLcCb lcCb[MAX_NUM_LC]; /* Uplink dedicated logocal channels */
207 /* UE specific DL Info */
208 typedef struct ueDlCb
210 DlHarqEnt dlHarqEnt; /* DL HARQ entity */
211 uint8_t numDlLc; /* Number of downlink logical channels */
212 DlLcCb lcCb[MAX_NUM_LC]; /* Downlink dedicated logical channels */
216 typedef struct macUeCb
218 uint16_t ueId; /* UE Id from DU APP */
219 uint16_t crnti; /* UE CRNTI */
220 MacCellCb *cellCb; /* Pointer to cellCb to whihc this UE belongs */
221 UeState state; /* Is UE active ? */
222 MacCfraResource cfraResource; /* CF-RA resource */
223 MacRaCbInfo *raCb; /* RA info */
224 MacBsrTmrCfg bsrTmrCfg; /* BSR Timer Info */
225 UeUlCb ulInfo; /* UE specific UL info */
226 UeDlCb dlInfo; /* UE specific DL info */
227 DataTransmissionAction transmissionAction;
236 MacRaCbInfo macRaCb[MAX_NUM_UE];
237 MacDlSlot dlSlot[MAX_SLOTS];
238 MacUlSlot ulSlot[MAX_SLOTS];
240 MacUeCreateReq *ueCfgTmpData[MAX_NUM_UE];
241 MacUeRecfg *ueRecfgTmpData[MAX_NUM_UE];
242 MacUeCb ueCb[MAX_NUM_UE];
243 MacCellCfg macCellCfg;
245 SlotTimingInfo currTime;
252 uint8_t tmrRes; /*!< Timer resolution */
253 CmTqCp tmrTqCp; /*!< Timer Task Queue Cntrl Point */
254 CmTqType tmrTq[MAC_TQ_SIZE]; /*!< Timer Task Queue */
255 CmTimer tmrBlk[MAX_NUM_TIMER]; /*!< Timer Block */
256 MacCellCb *macCell[MAX_NUM_CELL];
259 /* global variable */
262 /* Function declarations */
263 uint8_t macActvInit ARGS((Ent entity, Inst inst, Region region, Reason reason));
264 uint8_t macActvTsk(Pst *pst, Buffer *mBuf);
265 short int macActvTmr(Ent ent,Inst inst);
267 void fillRarPdu(RarInfo *rarInfo);
268 void fillMsg4DlData(MacDlData *dlData, uint16_t msg4PduLen, uint8_t *msg4Pdu);
269 void fillMacCe(MacCeInfo *macCeData, uint8_t *msg3Pdu);
270 void macMuxPdu(MacDlData *dlData, MacCeInfo *macCeData, uint8_t *msg4TxPdu, uint16_t tbSize);
271 uint8_t unpackRxData(uint16_t cellId, SlotTimingInfo slotInfo, RxDataIndPdu *rxDataIndPdu);
272 void fillMg4Pdu(DlMsgSchInfo *msg4Alloc);
273 void buildAndSendMuxPdu(SlotTimingInfo currTimingInfo);
274 uint8_t macProcUlCcchInd(uint16_t cellId, uint16_t crnti, uint16_t rrcContSize, uint8_t *rrcContainer);
275 uint8_t macProcShortBsr(uint16_t cellId, uint16_t crnti, uint8_t lcgId, uint32_t bufferSize);
276 uint8_t macProcUlData(uint16_t cellId, uint16_t rnti, SlotTimingInfo slotInfo, uint8_t lcId, uint16_t pduLen, uint8_t *pdu);
277 uint8_t sendSchedRptToRlc(DlSchedInfo dlInfo, SlotTimingInfo slotInfo, uint8_t ueIdx, uint8_t schInfoIdx);
278 uint8_t macProcLongBsr(uint16_t cellId, uint16_t crnti,uint8_t numLcg, DataVolInfo dataVolInfo[MAX_NUM_LOGICAL_CHANNEL_GROUPS]);
279 void freeMacSliceCfgReq(MacSliceCfgReq *cfgReq,Pst *pst);
280 void deleteMacRaCb(uint16_t cellIdx, MacUeCb *ueCb);
282 uint8_t MacProcSchSliceCfgRsp(Pst *pst, SchSliceCfgRsp *schSliceCfgRsp);
283 uint8_t MacProcSchSliceRecfgRsp(Pst *pst, SchSliceRecfgRsp *sliceRecfgrsp);
284 uint8_t MacProcSchCellCfgCfm(Pst *pst, SchCellCfgCfm *schCellCfgCfm);
285 uint8_t MacProcDlAlloc(Pst *pst, DlSchedInfo *dlSchedInfo);
286 uint8_t MacProcUlSchInfo(Pst *pst, UlSchedInfo *ulSchedInfo);
287 uint8_t MacProcSchRachRsrcRsp(Pst *pst, SchRachRsrcRsp *schRachRsrcRsp);
288 uint8_t MacProcDlPageAlloc(Pst *pst, DlPageAlloc *dlPageAlloc);
289 uint8_t MacProcSchCellDeleteRsp(Pst *pst, SchCellDeleteRsp *schCellDeleteRsp);
291 uint8_t MacProcSchStatsRsp(Pst *pst, SchStatsRsp *schStatsRsp);
292 uint8_t MacProcSchStatsInd(Pst *pst, SchStatsInd *schStatsInd);
294 /**********************************************************************
296 **********************************************************************/