X-Git-Url: https://gerrit.o-ran-sc.org/r/gitweb?a=blobdiff_plain;f=src%2F5gnrsch%2Fsch.h;h=043ca95468c2658b0f76e645b4418ae245c488dc;hb=38ebc92a011353b8b2d9401efa4173c79114fa1c;hp=906e436b6ef67f8c1388b0464025d7fc8449354e;hpb=694d8fa8539d4b69710b61d01d5a0535bb98716e;p=o-du%2Fl2.git diff --git a/src/5gnrsch/sch.h b/src/5gnrsch/sch.h index 906e436b6..043ca9546 100644 --- a/src/5gnrsch/sch.h +++ b/src/5gnrsch/sch.h @@ -14,119 +14,433 @@ # See the License for the specific language governing permissions and # # limitations under the License. # ################################################################################ -*******************************************************************************/ + *******************************************************************************/ /* macros */ #define SCH_INST_START 1 -#define SCH_MAX_CELLS 1 #define SCH_MAX_INST 1 -#define SCH_NUM_SLOTS 10 /*forcing this to 10 */ -#define MAX_NUM_RB 106 /* value for numerology 0 15Khz */ -#define SCH_MIB_TRANS 80 +#define SCH_MU0_NUM_SLOTS 10 +#define SCH_MU1_NUM_SLOTS 20 +#define SCH_MU2_NUM_SLOTS 30 +#define SCH_MU3_NUM_SLOTS 40 +#define SCH_MU4_NUM_SLOTS 50 +#define SCH_MAX_SFN 1024 +#define SCH_MIB_TRANS 8 /* MIB transmission as per 38.331 is every 80 ms */ +#define SCH_SIB1_TRANS 16 /* SIB1 transmission as per 38.331 is every 160 ms */ #define SCH_NUM_SC_PRB 12 /* number of SCs in a PRB */ -#define SCH_MAX_SSB_BEAM 4 /* since we are supporting only SCS=15KHz */ -#define SCH_SCS_15KHZ 0 /* numerology 0 and 15Khz */ -#define SCH_SYMBOL_PER_SLOT 14 -#define SCH_SSB_SYMB_DURATION 4 -#define SCH_SSB_PRB_DURATION 20 -#define SCH_MEM_REGION 4 -#define SCH_POOL 1 +#define SCH_MAX_SSB_BEAM 8 /* since we are supporting only SCS=15KHz and 30KHz */ +#define SCH_SSB_NUM_SYMB 4 +#define SCH_SSB_NUM_PRB 21 /* One extra PRB as buffer */ #define SCHED_DELTA 1 +#define BO_DELTA 1 +#define RAR_DELAY 2 +#define MSG4_DELAY 1 +#define PDSCH_START_RB 10 +/* Considering pdsch region from 3 to 13, DMRS exclued. + * Overlapping of PDSCH DRMS and PDSCH not supported by Intel L1 */ +#define NUM_PDSCH_SYMBOL 11 +#define PUSCH_START_RB 15 +#define PUCCH_NUM_PRB_FORMAT_0_1_4 1 /* number of PRBs in freq domain, spec 38.213 - 9.2.1 */ +#define SI_RNTI 0xFFFF +#define P_RNTI 0xFFFE +#define DMRS_MAP_TYPE_A 1 +#define NUM_DMRS_SYMBOLS 1 +#define DMRS_ADDITIONAL_POS 0 +#define SCH_DEFAULT_K1 1 +#define SCH_TQ_SIZE 10 +#define SSB_IDX_SUPPORTED 1 -/* allocate and zero out a static buffer */ -#define SCH_ALLOC(_datPtr, _size) \ -{ \ - S16 _ret; \ - _ret = SGetSBuf(SCH_MEM_REGION, SCH_POOL, \ - (Data **)&_datPtr, _size); \ - if(_ret == ROK) \ - cmMemset((U8*)_datPtr, 0, _size); \ - else \ - _datPtr = NULLP; \ -} - -/* free a static buffer */ -#define SCH_FREE(_datPtr, _size) \ - if(_datPtr) \ - SPutSBuf(SCH_MEM_REGION, SCH_POOL, \ - (Data *)_datPtr, _size); - - -#define SCH_FILL_RSP_PST(_rspPst, _inst)\ -{ \ - _rspPst.srcProcId = SFndProcId(); \ - _rspPst.dstProcId = SFndProcId();\ - _rspPst.srcEnt = ENTRG;\ - _rspPst.dstEnt = ENTRG;\ - _rspPst.srcInst = 1;\ - _rspPst.dstInst = 0;\ - _rspPst.selector = MAC_SELECTOR_TC;\ -} +#define CRC_FAILED 0 +#define CRC_PASSED 1 + +#define MAC_HDR_SIZE 3 /* 3 bytes of MAC Header */ +#define UL_GRANT_SIZE 224 + +#define PRB_BITMAP_IDX_LEN 64 +#define PRB_BITMAP_MAX_IDX ((MAX_NUM_RB + PRB_BITMAP_IDX_LEN-1) / PRB_BITMAP_IDX_LEN) + +typedef struct schCellCb SchCellCb; +typedef struct schUeCb SchUeCb; + +typedef enum +{ + SCH_NUMEROLOGY_0, + SCH_NUMEROLOGY_1, + SCH_NUMEROLOGY_2, + SCH_NUMEROLOGY_3, + SCH_NUMEROLOGY_4 +}SchNumerology; + +typedef enum +{ + SCH_UE_STATE_INACTIVE, + SCH_UE_STATE_ACTIVE, + SCH_UE_HANDIN_IN_PROGRESS +}SchUeState; + +typedef enum +{ + SCH_LC_STATE_INACTIVE, + SCH_LC_STATE_ACTIVE +}SchLcState; + +typedef enum +{ + WINDOW_YET_TO_START, + WITHIN_WINDOW, + WINDOW_EXPIRED +}RaRspWindowStatus; + +typedef enum +{ + SEARCH, + CREATE, + DELETE +}ActionTypeLcLL; /** - * @brief - * Structure holding LTE MAC's General Configuration information. - */ + * @brief + * Structure holding LTE MAC's General Configuration information. + */ typedef struct schGenCb { uint8_t tmrRes; /*!< Timer resolution */ uint8_t startCellId; /*!< Starting Cell Id */ #ifdef LTE_ADV bool forceCntrlSrbBoOnPCel; /*!< value 1 means force scheduling - of RLC control BO and SRB BO on - PCell. val 0 means don't force*/ + of RLC control BO and SRB BO on + PCell. val 0 means don't force*/ bool isSCellActDeactAlgoEnable; /*!< TRUE will enable activation/deactivation algo at Schd */ #endif }SchGenCb; +typedef struct freePrbBlock +{ + uint16_t numFreePrb; + uint16_t startPrb; + uint16_t endPrb; +}FreePrbBlock; + /** - * @brief - * scheduler allocationsfor DL per cell. - */ -typedef struct schDlAlloc -{ - uint16_t totalPrb; /*!< Number of RBs in the cell */ - uint16_t assignedPrb[SCH_SYMBOL_PER_SLOT]; /*!< Num RBs and corresponding symbols allocated */ - bool ssbPres; /*!< Flag to determine if SSB is present in this slot */ - uint8_t ssbIdxSupported; /*!< Max SSB index */ - SsbInfo ssbInfo[MAX_SSB_IDX]; /*!< SSB info */ -}SchDlAlloc; + * @brief + * PRB allocations for a symbol within a slot + */ +typedef struct schPrbAlloc +{ + CmLListCp freePrbBlockList; /*!< List of continuous blocks for available PRB */ + uint64_t prbBitMap[ MAX_SYMB_PER_SLOT][PRB_BITMAP_MAX_IDX]; /*!< BitMap to store the allocated PRBs */ +}SchPrbAlloc; /** - * @brief - * Cell Control block per cell. - */ + * @brief + * scheduler allocationsfor DL per cell. + */ +typedef struct schDlSlotInfo +{ + SchPrbAlloc prbAlloc; /*!< PRB allocated/available in this slot */ + bool ssbPres; /*!< Flag to determine if SSB is present in this slot */ + uint8_t ssbIdxSupported; /*!< Max SSB index */ + SsbInfo ssbInfo[MAX_SSB_IDX]; /*!< SSB info */ + bool sib1Pres; /*!< Flag to determine if SIB1 is present in this slot */ + uint8_t pdcchUe; /*!< UE for which PDCCH is scheduled in this slot */ + uint8_t pdschUe; /*!< UE for which PDSCH is scheduled in this slot */ + RarAlloc *rarAlloc[MAX_NUM_UE]; /*!< RAR allocation per UE*/ + DciInfo *ulGrant; + DlMsgAlloc *dlMsgAlloc[MAX_NUM_UE]; /*!< Dl msg allocation per UE*/ +}SchDlSlotInfo; + +typedef struct schRaCb +{ + bool msg4recvd; + uint16_t tcrnti; + uint16_t dlMsgPduLen; +}SchRaCb; + +/** + * @brief + * scheduler allocationsfor UL per cell. + */ +typedef struct schUlSlotInfo +{ + SchPrbAlloc prbAlloc; /*!< PRB allocated/available per symbol */ + uint8_t puschCurrentPrb; /*!< Current PRB for PUSCH allocation */ + bool puschPres; /*!< PUSCH presence field */ + SchPuschInfo *schPuschInfo; /*!< PUSCH info */ + bool pucchPres; /*!< PUCCH presence field */ + SchPucchInfo schPucchInfo; /*!< PUCCH info */ + uint8_t pucchUe; /*!< Store UE id for which PUCCH is scheduled */ + uint8_t puschUe; /*!< Store UE id for which PUSCH is scheduled */ +}SchUlSlotInfo; + +/** +@brief +* BSR info per slot per UE. +*/ +typedef struct bsrInfo +{ + uint8_t priority; /* CG priority */ + uint32_t dataVol; /* Data volume requested in bytes */ +}BsrInfo; + +typedef struct schLcCtxt +{ + uint8_t lcId; // logical Channel ID + uint8_t lcp; // logical Channel Prioritization + SchLcState lcState; + uint32_t bo; + uint16_t pduSessionId; /*Pdu Session Id*/ + Snssai *snssai; /*S-NSSAI assoc with LCID*/ + bool isDedicated; /*Flag containing Dedicated S-NSSAI or not*/ +}SchDlLcCtxt; + +typedef struct schDlCb +{ + SchDlLcCtxt dlLcCtxt[MAX_NUM_LC]; +}SchDlCb; + +typedef struct schUlLcCtxt +{ + SchLcState lcState; + uint8_t lcId; + uint8_t priority; + uint8_t lcGroup; + uint8_t schReqId; + uint8_t pbr; // prioritisedBitRate + uint8_t bsd; // bucketSizeDuration + uint16_t pduSessionId; /*Pdu Session Id*/ + Snssai *snssai; /*S-NSSAI assoc with LCID*/ + bool isDedicated; /*Flag containing Dedicated S-NSSAI or not*/ +}SchUlLcCtxt; + +typedef struct schUlCb +{ + SchUlLcCtxt ulLcCtxt[MAX_NUM_LC]; +}SchUlCb; + +typedef struct schUeCfgCb +{ + uint16_t cellId; + uint8_t ueId; + uint16_t crnti; + bool macCellGrpCfgPres; + SchMacCellGrpCfg macCellGrpCfg; + bool phyCellGrpCfgPres; + SchPhyCellGrpCfg phyCellGrpCfg; + bool spCellCfgPres; + SchSpCellCfg spCellCfg; + SchAmbrCfg *ambrCfg; + SchModulationInfo dlModInfo; + SchModulationInfo ulModInfo; + SchDataTransmission dataTransmissionAction; +}SchUeCfgCb; + +/*Following structures to keep record and estimations of PRB allocated for each + * LC taking into consideration the RRM policies*/ +typedef struct lcInfo +{ + uint8_t lcId; /*LCID for which BO are getting recorded*/ + uint32_t reqBO; /*Size of the BO requested/to be allocated for this LC*/ + uint32_t allocBO; /*TBS/BO Size which is actually allocated*/ + uint8_t allocPRB; /*PRB count which is allocated based on RRM policy/FreePRB*/ +}LcInfo; + +typedef struct dedicatedLCInfo +{ + CmLListCp dedLcList; /*Linklist of LC assoc with RRMPolicyMemberList*/ + uint16_t rsvdDedicatedPRB; /*Number of PRB reserved for this Dedicated S-NSSAI*/ +}DedicatedLCInfo; + +typedef struct schLcPrbEstimate +{ + /* TODO: For Multiple RRMPolicies, Make DedicatedLcInfo as array/Double Pointer + * and have separate DedLCInfo for each RRMPolcyMemberList*/ + /* Dedicated LC List will be allocated, if any available*/ + DedicatedLCInfo *dedLcInfo; /*Contain LCInfo per RRMPolicy*/ + + CmLListCp defLcList; /*Linklist of LC assoc with Default S-NSSAI(s)*/ + + /* SharedPRB number can be used by any LC. + * Need to calculate in every Slot based on PRB availability*/ + uint16_t sharedNumPrb; +}SchLcPrbEstimate; + +/** + * @brief + * UE control block + */ +typedef struct schUeCb +{ + uint16_t ueId; + uint16_t crnti; + SchUeCfgCb ueCfg; + SchUeState state; + SchCellCb *cellCb; + bool srRcvd; + bool bsrRcvd; + BsrInfo bsrInfo[MAX_NUM_LOGICAL_CHANNEL_GROUPS]; + SchUlCb ulInfo; + SchDlCb dlInfo; + SchLcPrbEstimate dlLcPrbEst; /*DL PRB Alloc Estimate among different LC*/ + SchLcPrbEstimate ulLcPrbEst; /*UL PRB Alloc Estimate among different LC*/ +}SchUeCb; + +/** + * @brief + * RA Request Info + */ +typedef struct schRaReq +{ + uint32_t raRnti; + RachIndInfo *rachInd; + SlotTimingInfo winStartTime; + SlotTimingInfo winEndTime; +}SchRaReq; + +typedef struct schPageInfo +{ + uint8_t pf; /*Value of Paging Frame received from DUAPP*/ + uint8_t i_s; /*Value of Paging Occ Index received from DUAPP*/ + SlotTimingInfo TxTime; /*Start Paging window*/ + uint8_t crntSsbIdx; /*Counts the slot till totalSSB is receached*/ + uint8_t mcs; + uint8_t nPRB; + uint16_t msgLen; + uint8_t *pagePdu; +}SchPageInfo; + +typedef struct schPagingOcc +{ + uint8_t frameOffset; + uint8_t pagingOccSlot; +}SchPagingOcc; + +typedef struct schPageCb +{ + CmLListCp pageReqInfoRecord[MAX_SFN]; /*List of Page Records received which are stored per sfn*/ + SchPagingOcc pagMonOcc[MAX_PO_PER_PF]; /*Paging Occasion Slot/FrameOffset are stored*/ + SchPageInfo currPageInfo; /*Page Req which is being currently processed */ +}SchPageCb; + +/** + * @brief + * Cell Control block per cell. + */ typedef struct schCellCb { - uint16_t cellId; /*!< Cell ID */ - Inst instIdx; /*!< Index of the scheduler instance */ - Inst macInst; /*!< Index of the MAC instance */ - uint8_t numSlots; /*!< Number of slots in current frame */ - SlotIndInfo slotInfo; /*!< SFN, Slot info being processed*/ - SchDlAlloc *dlAlloc[SCH_NUM_SLOTS]; /*!< SCH resource allocations in DL */ - SchCellCfg cellCfg; /*!< Cell ocnfiguration */ + uint16_t cellId; /*!< Cell ID */ + Inst instIdx; /*!< Index of the scheduler instance */ + Inst macInst; /*!< Index of the MAC instance */ + uint8_t numSlots; /*!< Number of slots in current frame */ + SlotTimingInfo slotInfo; /*!< SFN, Slot info being processed*/ + SchDlSlotInfo **schDlSlotInfo; /*!< SCH resource allocations in DL */ + SchUlSlotInfo **schUlSlotInfo; /*!< SCH resource allocations in UL */ + SchCellCfg cellCfg; /*!< Cell ocnfiguration */ + bool firstSsbTransmitted; + bool firstSib1Transmitted; + uint8_t ssbStartSymbArr[SCH_MAX_SSB_BEAM]; /*!