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,
88 MAC_LC_STATE_INACTIVE,
92 typedef struct macDlSlot
97 typedef struct macUlSlot
102 typedef struct macCbInfo
106 uint8_t msg3Pdu[6]; /* used as CRI value during muxing */
107 uint8_t *msg4Pdu; /* storing DL-CCCH Ind Pdu */
108 uint16_t msg4PduLen; /* storing DL-CCCH Ind Pdu Len */
109 uint8_t *msg4TxPdu; /* muxed Pdu used for re-transmission */
110 uint16_t msg4TbSize; /* size required for msg4TxPdu */
116 uint8_t macCeValue[6];
119 typedef struct macCeInfo
122 MacCe macCe[MAX_MAC_CE];
125 typedef struct macDlInfo
132 typedef struct macDlData
135 MacDlInfo pduInfo[MAX_MAC_DL_PDU];
138 /* HARQ Process Info */
139 typedef struct dlHarqProcCb
141 uint8_t procId; /* HARQ Process Id */
145 typedef struct dlHarqEnt
147 uint8_t maxReTx; /* MAX HARQ retransmission */
148 uint8_t numHarqProcs; /* Number of HARQ procs */
149 DlHarqProcCb harqProcCb[MAX_NUM_HARQ_PROC];
152 /* Uplink deidcated logical channel info */
153 typedef struct ulLcCb
155 uint8_t lcId; /* Logical Channel Id */
156 uint8_t lcGrpId; /* Logical Channel group */
157 MacLcState lcActive; /* Is LC active ? */
160 /* Downlink dedicated logical channel info */
161 typedef struct dlLcCb
163 uint8_t lcId; /* Logical channel Id */
164 MacLcState lcState; /* Is LC active ? */
167 /* BSR Information */
168 typedef struct macBsrTmrCfg
170 uint16_t periodicTimer;
172 uint16_t srDelayTimer;
175 /* UE specific UL info */
176 typedef struct ueUlCb
178 uint8_t maxReTx; /* MAX HARQ retransmission */
179 uint8_t numUlLc; /* Number of uplink logical channels */
180 UlLcCb lcCb[MAX_NUM_LC]; /* Uplink dedicated logocal channels */
183 /* UE specific DL Info */
184 typedef struct ueDlCb
186 DlHarqEnt dlHarqEnt; /* DL HARQ entity */
187 uint8_t numDlLc; /* Number of downlink logical channels */
188 DlLcCb lcCb[MAX_NUM_LC]; /* Downlink dedicated logical channels */
192 typedef struct macUeCb
194 uint16_t ueIdx; /* UE Idx assigned by DU APP */
195 uint16_t crnti; /* UE CRNTI */
196 MacCellCb *cellCb; /* Pointer to cellCb to whihc this UE belongs */
197 UeState state; /* Is UE active ? */
198 MacRaCbInfo *raCb; /* RA info */
199 MacBsrTmrCfg bsrTmrCfg; /* BSR Timer Info */
200 UeUlCb ulInfo; /* UE specific UL info */
201 UeDlCb dlInfo; /* UE specific DL info */
209 MacRaCbInfo macRaCb[MAX_NUM_UE];
210 MacDlSlot dlSlot[MAX_SLOTS];
211 MacUlSlot ulSlot[MAX_SLOTS];
213 MacUeCfg *ueCfgTmpData[MAX_NUM_UE];
214 MacUeCb ueCb[MAX_NUM_UE];
215 MacCellCfg macCellCfg;
216 SlotTimingInfo currTime;
223 uint8_t tmrRes; /*!< Timer resolution */
224 CmTqCp tmrTqCp; /*!< Timer Task Queue Cntrl Point */
225 CmTqType tmrTq[MAC_TQ_SIZE]; /*!< Timer Task Queue */
226 CmTimer tmrBlk[MAX_NUM_TIMER]; /*!< Timer Block */
227 MacCellCb *macCell[MAX_NUM_CELL];
230 /* global variable */
233 /* Function declarations */
234 short int macActvTmr(Ent ent,Inst inst);
235 void fillRarPdu(RarInfo *rarInfo);
236 void createMacRaCb(RachIndInfo *rachIndInfo);
237 void fillMsg4DlData(MacDlData *dlData, uint16_t msg4PduLen, uint8_t *msg4Pdu);
238 void fillMacCe(MacCeInfo *macCeData, uint8_t *msg3Pdu);
239 void macMuxPdu(MacDlData *dlData, MacCeInfo *macCeData, uint8_t *msg4TxPdu, uint16_t tbSize);
240 uint8_t unpackRxData(uint16_t cellId, SlotTimingInfo slotInfo, RxDataIndPdu *rxDataIndPdu);
241 void fillMg4Pdu(DlMsgAlloc *msg4Alloc);
242 void buildAndSendMuxPdu(SlotTimingInfo currTimingInfo);
243 uint8_t macProcUlCcchInd(uint16_t cellId, uint16_t crnti, uint16_t rrcContSize, uint8_t *rrcContainer);
244 uint8_t macProcShortBsr(uint16_t cellId, uint16_t crnti, uint8_t lcgId, uint32_t bufferSize);
245 uint8_t macProcUlData(uint16_t cellId, uint16_t rnti, SlotTimingInfo slotInfo, \
246 uint8_t lcId, uint16_t pduLen, uint8_t *pdu);
247 uint8_t sendSchedRptToRlc(DlSchedInfo dlInfo, SlotTimingInfo slotInfo);
249 /**********************************************************************
251 **********************************************************************/