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