GlobalEdge: CSI and TCI related MAC CE intial commit

cmake_targets/CMakeLists.txt

@@ -249,6 +249,7 @@ add_boolean_option(UE_AUTOTEST_TRACE   False "Activate UE autotest specific logs
 add_boolean_option(UE_DEBUG_TRACE      False "Activate UE debug trace")
 add_boolean_option(UE_TIMING_TRACE     False "Activate UE timing trace")
 add_boolean_option(DEBUG_CONSOLE       False "makes debugging easier, disables stdout/stderr buffering")
+add_boolean_option(GES_SUPPORT       True "To enable the GES Code")
 
 set (OCP_ITTI ${OPENAIR_DIR}/common/utils/ocp_itti)
 add_library(ITTI

openair2/LAYER2/NR_MAC_COMMON/nr_mac.h

@@ -71,72 +71,132 @@
 //  R: Reserved bit, set to zero.
 
 typedef struct {
-    uint8_t LCID:6;     // octet 1 [5:0]
-    uint8_t F:1;        // octet 1 [6]
-    uint8_t R:1;        // octet 1 [7]
-    uint8_t L:8;        // octet 2 [7:0]
+    uint8_t LCID: 6;    // octet 1 [5:0]
+    uint8_t F: 1;       // octet 1 [6]
+    uint8_t R: 1;       // octet 1 [7]
+    uint8_t L: 8;       // octet 2 [7:0]
 } __attribute__ ((__packed__)) NR_MAC_SUBHEADER_SHORT;
 
 typedef struct {
-    uint8_t LCID:6;     // octet 1 [5:0]
-    uint8_t F:1;        // octet 1 [6]
-    uint8_t R:1;        // octet 1 [7]
-    uint8_t L1:8;       // octet 2 [7:0]
-    uint8_t L2:8;       // octet 3 [7:0]
+    uint8_t LCID: 6;    // octet 1 [5:0]
+    uint8_t F: 1;       // octet 1 [6]
+    uint8_t R: 1;       // octet 1 [7]
+    uint8_t L1: 8;      // octet 2 [7:0]
+    uint8_t L2: 8;      // octet 3 [7:0]
 } __attribute__ ((__packed__)) NR_MAC_SUBHEADER_LONG;
 
 typedef struct {
-    uint8_t LCID:6;     // octet 1 [5:0]
-    uint8_t R:2;        // octet 1 [7:6]
+    uint8_t LCID: 6;    // octet 1 [5:0]
+    uint8_t R: 2;       // octet 1 [7:6]
 } __attribute__ ((__packed__)) NR_MAC_SUBHEADER_FIXED;
 
 // BSR MAC CEs
 // TS 38.321 ch. 6.1.3.1
 // Short BSR for a specific logical channel group ID
 typedef struct {
-  uint8_t Buffer_size:5;   // octet 1 LSB
-  uint8_t LcgID:3;         // octet 1 MSB
+    uint8_t Buffer_size: 5;  // octet 1 LSB
+    uint8_t LcgID: 3;        // octet 1 MSB
 } __attribute__ ((__packed__)) NR_BSR_SHORT;
 
 typedef NR_BSR_SHORT NR_BSR_SHORT_TRUNCATED;
 
 // Long BSR for all logical channel group ID
 typedef struct {
-  uint8_t Buffer_size7:8;
-  uint8_t Buffer_size6:8;
-  uint8_t Buffer_size5:8;
-  uint8_t Buffer_size4:8;
-  uint8_t Buffer_size3:8;
-  uint8_t Buffer_size2:8;
-  uint8_t Buffer_size1:8;
-  uint8_t Buffer_size0:8;
-  uint8_t LcgID0:1;
-  uint8_t LcgID1:1;
-  uint8_t LcgID2:1;
-  uint8_t LcgID3:1;
-  uint8_t LcgID4:1;
-  uint8_t LcgID5:1;
-  uint8_t LcgID6:1;
-  uint8_t LcgID7:1;
+    uint8_t Buffer_size7: 8;
+    uint8_t Buffer_size6: 8;
+    uint8_t Buffer_size5: 8;
+    uint8_t Buffer_size4: 8;
+    uint8_t Buffer_size3: 8;
+    uint8_t Buffer_size2: 8;
+    uint8_t Buffer_size1: 8;
+    uint8_t Buffer_size0: 8;
+    uint8_t LcgID0: 1;
+    uint8_t LcgID1: 1;
+    uint8_t LcgID2: 1;
+    uint8_t LcgID3: 1;
+    uint8_t LcgID4: 1;
+    uint8_t LcgID5: 1;
+    uint8_t LcgID6: 1;
+    uint8_t LcgID7: 1;
 } __attribute__ ((__packed__)) NR_BSR_LONG;
 
 typedef NR_BSR_LONG NR_BSR_LONG_TRUNCATED;
 
 // 38.321 ch. 6.1.3.4
 typedef struct {
-    uint8_t TA_COMMAND:6;   // octet 1 [5:0]
-    uint8_t TAGID:2;        // octet 1 [7:6]
+    uint8_t TA_COMMAND: 6;  // octet 1 [5:0]
+    uint8_t TAGID: 2;       // octet 1 [7:6]
 } __attribute__ ((__packed__)) NR_MAC_CE_TA;
 
 // single Entry PHR MAC CE
 // TS 38.321 ch. 6.1.3.8
 typedef struct {
-  uint8_t PH:6;
-  uint8_t R1:2;
-  uint8_t PCMAX:6;
-  uint8_t R2:6;
+    uint8_t PH: 6;
+    uint8_t R1: 2;
+    uint8_t PCMAX: 6;
+    uint8_t R2: 6;
 } __attribute__ ((__packed__)) NR_SINGLE_ENTRY_PHR_MAC_CE;
 
+#ifdef GES_SUPPORT
+
+// SP ZP CSI-RS Resource Set Activation/Deactivation MAC CE
+// 38.321 ch. 6.1.3.19
+typedef struct {
+    uint8_t BWPID: 2;       // octet 1 [1:0]
+    uint8_t CELLID: 5;      // octet 1 [6:2]
+    uint8_t A_D: 1;         // octet 1 [7]
+    uint8_t CSIRS_RSC_ID: 4; // octet 2 [3:0]
+    uint8_t R: 4            // octet 2 [7:4]
+} __attribute__ ((__packed__)) NR_MAC_CE_SP_ZP_CSI_RS_RES_SET;
+
+//TS 38.321 Sec 6.1.3.15, TCI State indicaton for UE-Specific PDCCH MAC CE
+typedef struct {
+    uint8_t CoresetId1: 3;   //Octect 1 [2:0]
+    uint8_t ServingCellId: 5; //Octect 1 [7:3]
+    uint8_t TciStateId: 7;   //Octect 2 [6:0]
+    uint8_t CoresetId2: 1;   //Octect 2 [7]
+} __attribute__ ((__packed__)) NR_TCI_PDCCH;
+
+//TS 38.321 Sec 6.1.3.14, TCI State activation/deactivation for UE Specific PDSCH MAC CE
+typedef struct {
+    uint8_t BWP_Id: 2;       //Octect 1 [1:0]
+    uint8_t ServingCellId: 5; //Octect 1 [6:2]
+    uint8_t R: 1;            //Octect 1 [7]
+    uint8_t T[];             //Octects 2 to MAX TCI States/8
+} __attribute__ ((__packed__)) NR_TCI_PDSCH_APERIODIC_CSI;
+
+//TS 6.1.3.16, SP CSI reporting on PUCCH Activation/Deactivation MAC CE
+typedef struct {
+    uint8_t BWP_Id: 2;			//Octect 1 [1:0]
+    uint8_t ServingCellId: 5; //Octect 1 [6:2]
+    uint8_t R1: 1;				//Octect 1 [7]
+    uint8_t S0: 1;				//Octect 2 [0]
+    uint8_t S1: 1;				//Octect 2 [1]
+    uint8_t S2: 1;				//Octect 2 [2]
+    uint8_t S3: 1;				//Octect 2 [3]
+    uint8_t R2: 4;				//Octect 2 [7:4]
+} __attribute__ ((__packed__)) NR_PUCCH_CSI_REPORTING;
+
+
+//TS 38.321 sec 6.1.3.12
+//SP CSI-RS / CSI-IM Resource Set Activation/Deactivation MAC CE
+typedef struct {
+    uint8_t BWP_ID: 2;
+    uint8_t SCID: 5;
+    uint8_t A_D: 1;
+    uint8_t SP_CSI_RSID: 6;
+    uint8_t IM: 1;
+    uint8_t R1: 1;
+    uint8_t SP_CSI_IMID: 6;
+    uint8_t R2: 2;
+    struct TCI_S {
+        uint8_t TCI_STATE_ID: 6;
+        uint8_t R: 2;
+    } __attribute__ ((__packed__)) TCI_STATE;
+} __attribute__ ((__packed__)) CSI_RS_CSI_IM_ACT_DEACT_MAC_CE;
+
+#endif
+
 //* RAR MAC subheader // TS 38.321 ch. 6.1.5, 6.2.2 *//
 // - E: The Extension field is a flag indicating if the MAC subPDU including this MAC subheader is the last MAC subPDU or not in the MAC PDU
 // - T: The Type field is a flag indicating whether the MAC subheader contains a Random Access Preamble ID or a Backoff Indicator (0, BI) (1, RAPID)
@@ -146,30 +206,30 @@ typedef struct {
 
 /*!\brief RAR MAC subheader with RAPID */
 typedef struct {
-    uint8_t RAPID:6;
-    uint8_t T:1;
-    uint8_t E:1;
+    uint8_t RAPID: 6;
+    uint8_t T: 1;
+    uint8_t E: 1;
 } __attribute__ ((__packed__)) NR_RA_HEADER_RAPID;
 
 /*!\brief RAR MAC subheader with Backoff Indicator */
 typedef struct {
-    uint8_t BI:4;
-    uint8_t R:2;
-    uint8_t T:1;
-    uint8_t E:1;
+    uint8_t BI: 4;
+    uint8_t R: 2;
+    uint8_t T: 1;
+    uint8_t E: 1;
 } __attribute__ ((__packed__)) NR_RA_HEADER_BI;
 
 // TS 38.321 ch. 6.2.3
 typedef struct {
-    uint8_t TA1:7;          // octet 1 [6:0]
-    uint8_t R:1;            // octet 1 [7]
-    uint8_t UL_GRANT_1:3;   // octet 2 [2:0]
-    uint8_t TA2:5;          // octet 2 [7:3]
-    uint8_t UL_GRANT_2:8;   // octet 3 [7:0]
-    uint8_t UL_GRANT_3:8;   // octet 4 [7:0]
-    uint8_t UL_GRANT_4:8;   // octet 5 [7:0]
-    uint8_t TCRNTI_1:8;     // octet 6 [7:0]
-    uint8_t TCRNTI_2:8;     // octet 7 [7:0]
+    uint8_t TA1: 7;         // octet 1 [6:0]
+    uint8_t R: 1;           // octet 1 [7]
+    uint8_t UL_GRANT_1: 3;  // octet 2 [2:0]
+    uint8_t TA2: 5;         // octet 2 [7:3]
+    uint8_t UL_GRANT_2: 8;  // octet 3 [7:0]
+    uint8_t UL_GRANT_3: 8;  // octet 4 [7:0]
+    uint8_t UL_GRANT_4: 8;  // octet 5 [7:0]
+    uint8_t TCRNTI_1: 8;    // octet 6 [7:0]
+    uint8_t TCRNTI_2: 8;    // octet 7 [7:0]
 } __attribute__ ((__packed__)) NR_MAC_RAR;
 
 //  38.321 ch6.2.1, 38.331

openair2/LAYER2/NR_MAC_gNB/nr_mac_gNB.h

@@ -179,9 +179,80 @@ typedef struct {
     uint8_t num_sf_allocation_pattern;
 } NR_COMMON_channels_t;
 
+#ifdef GES_SUPPORT
+
+// SP ZP CSI-RS Resource Set Activation/Deactivation MAC CE
+typedef struct sp_zp_csirs {
+    bool is_scheduled;     //ZP CSI-RS ACT/Deact MAC CE is scheduled
+    bool act_deact;        //Activation/Deactivation indication
+    uint8_t serv_cell_id;  //Identity of Serving cell for which MAC CE applies
+    uint8_t bwpid;         //Downlink BWP id
+    uint8_t rsc_id;        //SP ZP CSI-RS resource set
+} sp_zp_csirs_t;
+
+//SP CSI-RS / CSI-IM Resource Set Activation/Deactivation MAC CE
+#define MAX_CSI_RESOURCE_SET 64
+typedef struct csi_rs_im {
+    bool is_scheduled;
+    bool act_deact;
+    uint8_t serv_cellid;
+    uint8_t bwp_id;
+    bool im;
+    uint8_t csi_im_rsc_id;
+    uint8_t nzp_csi_rsc_id;
+    uint8_t nb_tci_resource_set_id;
+    uint8_t tci_state_id [ MAX_CSI_RESOURCE_SET ];
+} csi_rs_im_t;
+
+typedef struct pdcchStateInd {
+    bool is_scheduled;
+    uint8_t servingCellId;
+    uint8_t coresetId;
+    uint8_t tciStateId;
+} pdcchStateInd_t;
+
+typedef struct SPCSIReportingpucch {
+    bool is_scheduled;
+    uint8_t servingCellId;
+    uint8_t bwpId;
+    bool s0tos3_actDeact[4];
+} SPCSIReportingpucch_t;
+
+#define MAX_APERIODIC_TRIGGER_STATES 128 //38.331                               
+typedef struct aperiodicCSI_triggerStateSelection {
+    bool is_scheduled;
+    uint8_t servingCellId;
+    uint8_t bwpId;
+    uint8_t highestTriggerStateSelected;
+    bool triggerStateSelection[MAX_APERIODIC_TRIGGER_STATES];
+} aperiodicCSI_triggerStateSelection_t;
+
+#define MAX_TCI_STATES 128 //38.331                                             
+typedef struct pdschTciStatesActDeact {
+    bool is_scheduled;
+    uint8_t servingCellId;
+    uint8_t bwpId;
+    uint8_t highestTciStateActivated;
+    bool tciStateActDeact[MAX_TCI_STATES];
+} pdschTciStatesActDeact_t;
+
+typedef struct UE_info {
+    sp_zp_csirs_t sp_zp_csi_rs;
+    csi_rs_im_t csi_im;
+    pdcchStateInd_t pdcch_state_ind;
+    SPCSIReportingpucch_t SP_CSI_reporting_pucch;
+    aperiodicCSI_triggerStateSelection_t aperi_CSI_trigger;
+    pdschTciStatesActDeact_t pdsch_TCI_States_ActDeact;
+} NR_UE_mac_ce_ctrl_t;
+
+#endif
+
 /*! \brief scheduling control information set through an API (not used)*/
 typedef struct {
     int dummy;
+#ifdef GES_SUPPORT
+    NR_UE_mac_ce_ctrl_t UE_mac_ce_ctrl;// MAC CE related information
+#endif
 } NR_UE_sched_ctrl_t;
 
 /*! \brief UE list used by gNB to order UEs/CC for scheduling*/