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 macDlSlot
98 typedef struct macUlSlot
103 typedef struct macCbInfo
107 uint8_t msg3Pdu[6]; /* used as CRI value during muxing */
108 uint8_t *msg4Pdu; /* storing DL-CCCH Ind Pdu */
109 uint16_t msg4PduLen; /* storing DL-CCCH Ind Pdu Len */
110 uint8_t *msg4TxPdu; /* muxed Pdu used for re-transmission */
111 uint16_t msg4TbSize; /* size required for msg4TxPdu */
117 uint8_t macCeValue[6];
120 typedef struct macCeInfo
123 MacCe macCe[MAX_MAC_CE];
126 typedef struct macDlInfo
133 typedef struct macDlData
137 MacDlInfo pduInfo[MAX_MAC_DL_PDU];
140 /* HARQ Process Info */
141 typedef struct dlHarqProcCb
143 uint8_t procId; /* HARQ Process Id */
147 typedef struct dlHarqEnt
149 uint8_t maxReTx; /* MAX HARQ retransmission */
150 uint8_t numHarqProcs; /* Number of HARQ procs */
151 DlHarqProcCb harqProcCb[MAX_NUM_HARQ_PROC];
154 /* Uplink deidcated logical channel info */
155 typedef struct ulLcCb
157 uint8_t lcId; /* Logical Channel Id */
158 uint8_t lcGrpId; /* Logical Channel group */
159 MacLcState lcActive; /* Is LC active ? */
160 /*Commenting as S-NSSAI and PDU session will be used in future scope*/
161 /*For eg: When we have to send these for AMBR cases*/
163 uint16_t pduSessionId; /*Pdu Session Id*/
164 Snssai *snssai; /*S-NSSAI assoc with LCID*/
168 /* Downlink dedicated logical channel info */
169 typedef struct dlLcCb
171 uint8_t lcId; /* Logical channel Id */
172 MacLcState lcState; /* Is LC active ? */
173 /*Commenting as S-NSSAI and PDU session will be used in future scope*/
174 /*For eg: When we have to send these info via FAPI to phy layer*/
176 uint16_t pduSessionId;/*Pdu Session Id*/
177 Snssai *snssai; /*S-NSSAI assoc with LCID*/
181 /* BSR Information */
182 typedef struct macBsrTmrCfg
184 uint16_t periodicTimer;
186 uint16_t srDelayTimer;
189 /* UE specific UL info */
190 typedef struct ueUlCb
192 uint8_t maxReTx; /* MAX HARQ retransmission */
193 uint8_t numUlLc; /* Number of uplink logical channels */
194 UlLcCb lcCb[MAX_NUM_LC]; /* Uplink dedicated logocal channels */
197 /* UE specific DL Info */
198 typedef struct ueDlCb
200 DlHarqEnt dlHarqEnt; /* DL HARQ entity */
201 uint8_t numDlLc; /* Number of downlink logical channels */
202 DlLcCb lcCb[MAX_NUM_LC]; /* Downlink dedicated logical channels */
206 typedef struct macUeCb
208 uint16_t ueId; /* UE Id from DU APP */
209 uint16_t crnti; /* UE CRNTI */
210 MacCellCb *cellCb; /* Pointer to cellCb to whihc this UE belongs */
211 UeState state; /* Is UE active ? */
212 MacCfraResource cfraResource; /* CF-RA resource */
213 MacRaCbInfo *raCb; /* RA info */
214 MacBsrTmrCfg bsrTmrCfg; /* BSR Timer Info */
215 UeUlCb ulInfo; /* UE specific UL info */
216 UeDlCb dlInfo; /* UE specific DL info */
217 DataTransmissionAction transmissionAction;
225 MacRaCbInfo macRaCb[MAX_NUM_UE];
226 MacDlSlot dlSlot[MAX_SLOTS];
227 MacUlSlot ulSlot[MAX_SLOTS];
229 MacUeCfg *ueCfgTmpData[MAX_NUM_UE];
230 MacUeCb ueCb[MAX_NUM_UE];
231 MacCellCfg macCellCfg;
232 SlotTimingInfo currTime;
239 uint8_t tmrRes; /*!< Timer resolution */
240 CmTqCp tmrTqCp; /*!< Timer Task Queue Cntrl Point */
241 CmTqType tmrTq[MAC_TQ_SIZE]; /*!< Timer Task Queue */
242 CmTimer tmrBlk[MAX_NUM_TIMER]; /*!< Timer Block */
243 MacCellCb *macCell[MAX_NUM_CELL];
246 /* global variable */
249 /* Function declarations */
250 short int macActvTmr(Ent ent,Inst inst);
251 void fillRarPdu(RarInfo *rarInfo);
252 void fillMsg4DlData(MacDlData *dlData, uint16_t msg4PduLen, uint8_t *msg4Pdu);
253 void fillMacCe(MacCeInfo *macCeData, uint8_t *msg3Pdu);
254 void macMuxPdu(MacDlData *dlData, MacCeInfo *macCeData, uint8_t *msg4TxPdu, uint16_t tbSize);
255 uint8_t unpackRxData(uint16_t cellId, SlotTimingInfo slotInfo, RxDataIndPdu *rxDataIndPdu);
256 void fillMg4Pdu(DlMsgAlloc *msg4Alloc);
257 void buildAndSendMuxPdu(SlotTimingInfo currTimingInfo);
258 uint8_t macProcUlCcchInd(uint16_t cellId, uint16_t crnti, uint16_t rrcContSize, uint8_t *rrcContainer);
259 uint8_t macProcShortBsr(uint16_t cellId, uint16_t crnti, uint8_t lcgId, uint32_t bufferSize);
260 uint8_t macProcUlData(uint16_t cellId, uint16_t rnti, SlotTimingInfo slotInfo, \
261 uint8_t lcId, uint16_t pduLen, uint8_t *pdu);
262 uint8_t sendSchedRptToRlc(DlSchedInfo dlInfo, SlotTimingInfo slotInfo, uint8_t ueIdx, uint8_t schInfoIdx);
263 uint8_t macProcLongBsr(uint16_t cellId, uint16_t crnti,uint8_t numLcg,\
264 DataVolInfo dataVolInfo[MAX_NUM_LOGICAL_CHANNEL_GROUPS]);
265 void freeMacSliceCfgReq(MacSliceCfgReq *cfgReq,Pst *pst);
267 /**********************************************************************
269 **********************************************************************/