fb78f8073f482a65ceb426e0b6535cf559ea817c
[o-du/l2.git] / src / 5gnrmac / mac.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 #ifndef _MAC_H_
19 #define _MAC_H_
20
21 /* MAX values */
22 #define MAX_MAC_CE 6
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 */
29
30 #define DEFAULT_CELLS 1
31 #define SI_RNTI 0xFFFF
32 #define P_RNTI 0xFFFE
33
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
52
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*/
55 #define E_BIT_SIZE 1
56 #define T_BIT_SIZE 1
57 #define R_BIT_SIZE 1
58 #define RAPID_SIZE 6
59 #define LC_ID_SIZE 6
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
67 #define MCS_SIZE 4
68 #define TPC_COMMAND_SIZE 3
69 #define CSI_REQUEST_SIZE 1
70
71 typedef struct macCellCb MacCellCb;
72
73 typedef enum
74 {
75    CELL_STATE_UP,
76    CELL_TO_BE_STOPPED,
77    CELL_STOP_IN_PROGRESS,
78 }CellState;        
79
80 typedef enum
81 {
82    UE_STATE_INACTIVE,
83    UE_STATE_ACTIVE,
84    UE_HANDIN_IN_PROGRESS
85 }UeState;
86
87 typedef enum
88 {
89    MAC_LC_STATE_INACTIVE,
90    MAC_LC_STATE_ACTIVE
91 }MacLcState;
92
93 typedef struct macDlSlot
94 {
95    DlSchedInfo dlInfo;
96    DlPageAlloc *pageAllocInfo;
97 }MacDlSlot;
98
99 typedef struct macUlSlot
100 {
101    UlSchedInfo  ulInfo;
102 }MacUlSlot;
103
104 typedef struct macCbInfo
105 {
106    uint16_t    cellId;
107    uint16_t    crnti;
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 */
113 }MacRaCbInfo;
114
115 typedef struct macCe
116 {
117    uint16_t macCeLcid;
118    uint8_t  macCeValue[6];
119 }MacCe;
120
121 typedef struct macCeInfo
122 {
123    uint16_t numCes;
124    MacCe macCe[MAX_MAC_CE];
125 }MacCeInfo;
126
127 typedef struct macDlInfo
128 {
129    uint16_t  lcId;
130    uint16_t  pduLen;
131    uint8_t  *dlPdu;
132 }MacDlInfo;
133
134 typedef struct macDlData
135 {
136    uint8_t  ueId;
137    uint16_t numPdu;
138    MacDlInfo  pduInfo[MAX_MAC_DL_PDU];
139 }MacDlData;
140
141 /* HARQ Process Info */
142 typedef struct dlHarqProcCb
143 {
144    uint8_t   procId;    /* HARQ Process Id */
145 }DlHarqProcCb;
146
147 /* DL HARQ entity */
148 typedef struct dlHarqEnt
149 {
150    uint8_t        maxReTx;            /* MAX HARQ retransmission */
151    uint8_t        numHarqProcs;       /* Number of HARQ procs */
152    DlHarqProcCb   harqProcCb[MAX_NUM_HARQ_PROC];
153 }DlHarqEnt;
154
155 /* Uplink deidcated logical channel info */
156 typedef struct ulLcCb
157 {
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*/
163    #if 0
164    uint16_t   pduSessionId; /*Pdu Session Id*/
165    Snssai     *snssai;      /*S-NSSAI assoc with LCID*/
166    #endif
167 }UlLcCb;
168
169 /* Downlink dedicated logical channel info */
170 typedef struct dlLcCb
171 {
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*/
176    #if 0
177    uint16_t   pduSessionId;/*Pdu Session Id*/
178    Snssai     *snssai;    /*S-NSSAI assoc with LCID*/
179    #endif
180 }DlLcCb;
181
182 /* BSR Information */
183 typedef struct macBsrTmrCfg
184 {
185    uint16_t   periodicTimer;
186    uint16_t   retxTimer;
187    uint16_t   srDelayTimer;
188 }MacBsrTmrCfg;
189
190 /* UE specific UL info */
191 typedef struct ueUlCb
192 {
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 */
196 }UeUlCb;
197
198 /* UE specific DL Info */
199 typedef struct ueDlCb
200 {
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 */
204 }UeDlCb;
205
206 /* UE Cb */
207 typedef struct macUeCb
208 {
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;
219 }MacUeCb;
220
221 struct macCellCb
222 {
223    uint16_t    cellId;
224    CellState   state;
225    uint16_t    crntiMap;
226    MacRaCbInfo macRaCb[MAX_NUM_UE];
227    MacDlSlot   dlSlot[MAX_SLOTS];
228    MacUlSlot   ulSlot[MAX_SLOTS];
229    uint16_t    numActvUe;
230    MacUeCfg    *ueCfgTmpData[MAX_NUM_UE];
231    MacUeCb     ueCb[MAX_NUM_UE];
232    MacCellCfg  macCellCfg;
233    SlotTimingInfo currTime;
234 };
235
236 typedef struct macCb
237 {
238    Inst        macInst;
239    ProcId      procId;
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];
245 }MacCb;
246
247 /* global variable */
248 MacCb macCb;
249
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);
267 #endif
268 /**********************************************************************
269   End of file
270  **********************************************************************/