Commit 21691d3b authored by lengyelb's avatar lengyelb
Browse files

S5-216039 CR-0607

parent b8e31358
Loading
Loading
Loading
Loading
+8 −0
Original line number Diff line number Diff line
@@ -13,6 +13,7 @@ module _3gpp-common-yang-types {
    network slicing.";
  reference "3GPP TS 28.541";

  revision 2021-11-01 { reference "CR-0141"; }
  revision 2021-09-30 {
    description "Added Longitude, Latitude, TenthOfDegrees, OnOff.";
    reference "CR-0138";
@@ -42,6 +43,13 @@ module _3gpp-common-yang-types {
    reference  "Initial version.";
  }

  typedef EnabledDisabled {
    type enumeration {
      enum DISABLED ;
      enum ENABLED ;
    }
  }
  
  typedef TenthOfDegrees { 
    type uint16 { 
      range 0..3600; 
+116 −20
Original line number Diff line number Diff line
@@ -7,26 +7,127 @@ module _3gpp-nr-nrm-gnbdufunction {
  import _3gpp-common-managed-element { prefix me3gpp; }
  import _3gpp-common-top { prefix top3gpp; }
  import _3gpp-nr-nrm-rrmpolicy { prefix nrrrmpolicy3gpp; }
  import _3gpp-common-yang-types { prefix types3gpp; }

  organization "3GPP SA5";
  contact "https://www.3gpp.org/DynaReport/TSG-WG--S5--officials.htm?Itemid=464";
  description "Defines the YANG mapping of the GNBDUFunction Information
    Object Class (IOC) that is part of the NR Network Resource Model (NRM).";
  reference "3GPP TS 28.541 5G Network Resource Model (NRM)";

  revision 2021-10-28 { reference CR-0607 ; }
  revision 2021-04-30 { reference CR-0490 ; }
  revision 2020-10-02 { reference CR-0384 ; }
  revision 2020-03-12 { reference "SP-200233 S5-201547" ; }
  revision 2020-02-14 { reference S5-20XXXX ; }
  revision 2019-10-28 { reference S5-193518 ; }
  revision 2019-08-21 {
    description "Initial revision.";
  }
  revision 2019-08-21 {reference "Initial revision."; }

  feature DRACHOptimizationFunction {
    description "Classs representing D-SON function of RACH optimization 
    description "Class representing D-SON function of RACH optimization
      feature";
  }

  grouping RimRSReportInfoGrp {
    description "This  data type defines necessary reporting information
      derived from the detected RIM-RS, including
      1)  The detected set ID;
      2)  Propagation delay in number of OFDM symbols
      3)  Functionality of the RS (RS-1 or RS-2, Enough or Not enough
        mitigation for RS-1).

      RS-1 is equivalent to RIM-RS type 1 (see 38.211, subclause 7.4.1.6).
      RS-2 is equivalent to RIM-RS type 2 (see 38.211, subclause 7.4.1.6).
        Enough mitigation for RS-1 means 'Enough' / 'Not enough' indication
          functionality is enabled for RIM RS-1 and RIM-RS type 1 is used to
          indicate 'enough mitigation' functionality.
        Not enough mitigation for RS-1 means 'Enough' / 'Not enough' indication
          functionality is enabled for RIM RS-1 and RIM-RS type 1 is used to
          indicate 'Not enough mitigation' functionality.";

    leaf detectedSetID {
      type uint32 ;
      description "Set ID of the detected RIM-RS
        allowedValues: 0,1...max{totalnrofSetIdofRS1, totalnrofSetIdofRS2}";
    }

    leaf propagationDelay {
      type uint32 ;
      must '. <= ../../maxPropagationDelay' {
        error-message "allowedValues: 0, 1.. maxPropagationDelay";
      }
      description "This attribute indicates the propagation delay of the
        detected RIM-RS, in number of OFDM symbol.";
    }

    leaf functionalityOfRIMRS {
      type enumeration {
        enum RS1;
        enum RS2;
        enum RS1_FOR_ENOUGH_MITIGATION;
        enum RS1_FOR_NOT_ENOUGH_MITIGATION;
      }
      mandatory true;
      description "Indicates the functionality of the detected RIM-RS.
        If the indication of enableEnoughNotEnoughIndication is 'enabled',
          valid values are {RS2, RS1forEnoughMitigation,
          RS1forNotEnoughMitigation};
        If the indication of enableEnoughNotEnoughIndication is 'disabled',
          valid values are {RS1, RS2}.

        RS1forEnoughMitigation means RIM-RS type 1 is used to indicate
         'enough mitigation' functionality.
        RS1forNotEnoughMitigation means RIM-RS type 1 is used to indicate
          'Not enough mitigation' functionality.";
    }
  }

  grouping RimRSReportConfGrp {
    description "Defines RIM-RS reporting configuration";

    leaf reportIndicator {
      type types3gpp:EnabledDisabled;
      default DISABLED;
      description "Used to enable or disable the RS report on a gNB.
        If the indication is 'enable', the gNB starts to periodically report
        necessary information derived from the detected RIM-RS to OAM.
        If the indication is 'disable', the gNB stops reporting.";
    }

    leaf reportInterval {
      type uint32;
      mandatory true;
      units ms;
      description "Used to define reporting interval of a gNB in ms.";
    }

    leaf nrofRIMRSReportInfo {
      type uint32;
      mandatory true;
      description "Used to define the maximum number of RIMRSReportInfo in
        a single report.";
    }

    leaf maxPropagationDelay {
      type uint32 {
        range "0..327679";
      }
      mandatory true;
      description "Used to define the maximum reported OFDM symbol number for
        the propagation delay of the detected RIM-RS in each RIMRSReportInfo.

        allowedValues: 0, 1..20**2*maxNrofSymbols-1, where maxNrofSymbols=14.";
    }

    list RimRSReportInfoList {
      key detectedSetID;
      description "Represents a list (the length of the list is
        nrofRIMRSReportInfo) of necessary information derived from the
        detected RIM-RS.";
      uses RimRSReportInfoGrp;
    }
  }

  grouping GNBDUFunctionGrp {
    description "Represents the GNBDUFunction IOC.";
    reference "3GPP TS 28.541";
@@ -61,19 +162,14 @@ feature";
      reference "3GPP TS 38.473";
    }

    leaf aggressorSetID {
      type uint32 { range "0..4194304"; }
      config false;
      description "Indicates the associated aggressor gNB Set ID of the cell
        Valid when Remote Interference Management function is supported.";
      reference "3GPP TS 38.211 subclause 7.4.1.6";
    }
    leaf victimSetID {
      type uint32 { range "0..4194304"; }
    list rimRSReportConf {
      key reportInterval;
      config false;
      description "Indicates the associated victim gNB Set ID of the cell
        Valid when Remote Interference Management function is supported.";
      reference "3GPP TS 38.211 subclause 7.4.1.6";
      min-elements 1;
      max-elements 1;
      description "Used to configure gNBs to report the all necessary
        information derived from the detected RIM-RS to OAM.";
      uses RimRSReportConfGrp;
    }
  }

+225 −14
Original line number Diff line number Diff line
@@ -10,6 +10,7 @@ module _3gpp-nr-nrm-nrcelldu {
  import _3gpp-nr-nrm-gnbdufunction { prefix gnbdu3gpp; }
  import _3gpp-nr-nrm-rrmpolicy { prefix nrrrmpolicy3gpp; }
  import _3gpp-5g-common-yang-types { prefix types5g3gpp; }
  import ietf-yang-types { prefix yang; }


  organization "3GPP SA5";
@@ -18,6 +19,7 @@ module _3gpp-nr-nrm-nrcelldu {
    Class (IOC) that is part of the NR Network Resource Model (NRM).";
  reference "3GPP TS 28.541 5G Network Resource Model (NRM)";

  revision 2021-10-28 { reference CR-0607 ; }
  revision 2021-01-25 { reference CR-0454 ; }
  revision 2020-11-25 { reference CR-0386 ; }
  revision 2020-11-05 { reference CR-0412 ; }
@@ -37,6 +39,45 @@ module _3gpp-nr-nrm-nrcelldu {
      PCI configuration feature";
  }

  grouping NPNIdentityGrp {
    description "Represents the NPN supported by the <<IOC>> using this 
      <<dataType>> as one of its attributes in case of the cell is a 
      NPN-only cell.";
      
    list plmnid {
      key "mcc mnc";
      min-elements 1;
      description "PLMNId";
      uses types3gpp:PLMNId;
    }
   
    leaf cAGIdList {
      type string;
      mandatory true;
      description "It identifies a CAG list containing up to 12 CAG-identifiers 
        per PLMN Identity, see TS 38.331.
        
        CAG is used for the PNI-NPNs to prevent UE(s), which are not allowed 
        to access the NPN via the associated cell(s), from automatically 
        selecting and accessing the associated CAG cell(s).
        
        CAG ID is used to combine with PLMN ID to identify a PNI-NPN.

        Exist if the cell is a NPN-only cell see TS 38.331";
    }
   
    leaf nIDList {
      type string;
      mandatory true;
      description "It identifies a list of NIDs containing up to 12 NIDs per 
        PLMN Identity, see TS 38.331.

        NID is used to combine with PLMN ID to identify an SNPN.
        
        Exist if the cell is a NPN-only cell see TS 38.331";
    }
  }
  
  grouping NRCellDUGrp {
    description "Represents the NRCellDU IOC.";
    reference "3GPP TS 28.541";
@@ -90,6 +131,18 @@ module _3gpp-nr-nrm-nrcelldu {
      uses types5g3gpp:PLMNInfo;
    }

    list nPNIdentityList {
      key idx ;
      min-elements 1;
      ordered-by user;
      description "It defines which NPNs that can be served by the NR cell, 
        and which CAG IDs or NIDs can be supported by the NR cell for 
        corresponding PNI-NPN or SNPN in case of the cell is NPN-only cell.";
      reference "3GPP TS 38.331";
      leaf idx { type uint32 ; }
      uses NPNIdentityGrp;
    }
    
    leaf nRPCI {
      description "The Physical Cell Identity (PCI) of the NR cell.";
      reference "3GPP TS 36.211";
@@ -132,18 +185,121 @@ module _3gpp-nr-nrm-nrcelldu {
      units MHz;
    }

    leaf bSChannelBwUL {
      description "Base station channel bandwidth for uplink.";
      reference "3GPP TS 38.104";
      type int32;
      units MHz;
    leaf rimRSMonitoringStartTime {
      type yang:date-and-time ;
      mandatory true;
      description "Configures the UTC time when the gNB attempts to start 
        RIM-RS monitoring.";
     }
    
    leaf bSChannelBwSUL {
      description "Base station channel bandwidth for supplementary uplink.";
      reference "3GPP TS 38.104";
      type int32;
      units MHz;
    leaf rimRSMonitoringStopTime {
      type yang:date-and-time ;
      mandatory true;
      description "Configures the UTC time when the gNB stops RIM-RS 
        monitoring.";
     }
    
    leaf rimRSMonitoringWindowDuration {
      type uint32 {
        range 1..16384 ;
      }
      mandatory true;
      description "Configures a duration of the monitoring window  in which 
        gNB monitors the RIM-RS, in unit of P_t, where P_t is the RIM-RS 
        transmission periodicity in units of uplink-downlink switching period (
        see 38.211 subclause 7.4.1.6).

          This field is configured together with rimRSMonitoringInterval, 
          rimRSMonitoringWindowStartingOffset, rimRSMonitoringOccasionInterval 
          and rimRSMonitoringOccasionStartingOffset.
          The duration of the monitoring window is expected to be larger than 
          or equal to M*P_t, where M is the interval between adjacent monitoring 
          occasions within the monitoring window 
          (configured by rimRSMonitoringInterval).
          The absolute duration of the monitoring window is not expected to be 
          larger than the periodicity of the monitoring window (configured by 
          rimRSMonitoringWindowPeriodicity).
          
          See 3GPP TS 28.541 attribute descrition rimRSMonitoringWindowDuration
          for the exact math formulas.
          
          Only the earliest N_T consecutive detection durations in each RIM-RS 
          transmission periodicity (P_t) in the monitoring window are taken as 
          valid time for monitoring potential interference, and they are 
          consecutively monitored in the monitoring window, while the residual 
          part of each RIM-RS transmission periodicity is not used for 
          discovering potential interference, where, a consecutive detection 
          duration spans P1*R1 (if only P1 is configured) or ((P1+P2))/2*R1 (
          if both P1 and P2 are configured), where,
            R1 is the number of consecutive uplink-downlinkswitching periods 
              for RS-1 (configured by nrofConsecutiveRIMRS1),
            P1 is the first uplink-downlinkswitching period (configured by 
              dlULSwitchingPeriod1), 
            P2 is the second uplink-downlink switching period (configured by 
              dlULSwitchingPeriod2), and
            N_T=
            ((N_setID # RIM,1)/(N_f # RI N_s # RIM,1)   
                if enableEnoughNotEnoughIndication is 'disable'
            
            (2N_setID # RIM,1)/(N_f # RIM N_s # RIM,1)
                if enableEnoughNotEnoughIndication is 'enable'
            
          N_setID # 'RIM,1'  is the total number of set IDs for RIM RS-1
            (configured by totalnrofSetIdofRS1),
          N_f # RIM  is the number of candidate frequency resources in the whole 
            network (configured by nrofGlobalRIMRSFrequencyCandidates), and 
          N_s # 'RIM,1'  is the number of candidate sequences assigned for 
            RIM RS-1 (configured by nrofRIMRSSequenceCandidatesofRS1).";
     }
    
    leaf rimRSMonitoringWindowStartingOffset {
      type uint8 {
        range 0..23 ;
      }
      mandatory true;
      units hours;
      description "Configures the start offset of the first monitoring window 
        within one day, in unit of hours.";
     }
    
    leaf rimRSMonitoringWindowPeriodicity {
      type uint8 {
        range 1|2|3|4|6|8|12|24 ;
      }
      units hours;
      mandatory true;
      description "Configures the periodicity of the monitoring window, in 
        unit of hours";
     }
    
    leaf rimRSMonitoringOccasionInterval {
      type uint32 {
        range 1..max ;
      }
      mandatory true;
      description "Configures the interval between adjacent monitoring 
        occasions (M) within the monitoring window, in unit of consecutive 
        detection duration.
        M is expected to be prime to N_T, where N_T is given in above 
        attribute rimRSMonitoringWindowDuration.
        allowedValues: 1,2..N_T-1";
     }
    
    leaf rimRSMonitoringOccasionStartingOffset {
      type  uint32 ;
      mandatory true;
      description "Configures the start offset of the first monitoring occasions 
        within the monitoring window (S_M), in unit of consecutive detection 
        duration.
        gNB starts monitoring potential interference from the S_M-th consecutive 
        detection duration in the first complete RIM-RS transmission 
        periodicity (P_t) within the monitoring window.

        allowedValues: 0,1,2..M-1

        where M is the the interval between adjacent monitoring occasions 
        within the monitoring window 
        (configured by rimRSMonitoringOccasionInterval)";
     }

    leaf ssbFrequency {
@@ -193,6 +349,20 @@ module _3gpp-nr-nrm-nrcelldu {
      units "subframes (ms)";
    }

    leaf bSChannelBwUL {
      description "Base station channel bandwidth for uplink.";
      reference "3GPP TS 38.104";
      type int32;
      units MHz;
    }

    leaf bSChannelBwSUL {
      description "Base station channel bandwidth for supplementary uplink.";
      reference "3GPP TS 38.104";
      type int32;
      units MHz;
    }

    leaf-list nRSectorCarrierRef {
      description "Reference to corresponding NRSectorCarrier instance.";
      min-elements 1;
@@ -208,13 +378,54 @@ module _3gpp-nr-nrm-nrcelldu {
      description "Reference to corresponding NRFrequency instance.";
      type types3gpp:DistinguishedName;
    }
    
    leaf victimSetRef {
      type types3gpp:DistinguishedName;
      mandatory true;
      description "DN of a victim Set (RimRSSet) 
        Implemented if RIM feature is supported";
    }

    leaf aggressorSetRef {
      type types3gpp:DistinguishedName;
      mandatory true;
      description "DN of an aggressor Set (RimRSSet)";
    }
  }

  augment "/me3gpp:ManagedElement/gnbdu3gpp:GNBDUFunction" {

    list NRCellDU {
      description "Represents the information of a cell known by DU.";
      reference "3GPP TS 28.541";
      description "This IOC represents the part of NR cell information that 
        describes s the specific resources instances. 
        
        An NR cell transmits SS/PBCH block and always requires downlink 
        transmission at a certain carrier frequency with a certain channel 
        bandwidth. Transmission may be performed from multiple sector-carriers 
        using different transmission points, and these may be configured with 
        different carrier frequencies and channel bandwidths, as long as they 
        are aligned to the cell's downlink resource grids as defined in 
        subclause 4.4 in TS 38.211. The values of arfcnDL and bSChannelBwDL 
        attributes define the resource grids which each sector-carrier needs to 
        be aligned to. See subclauses 5.3 and 5.4.2 of TS 38.104 for definitions 
        of BS channel bandwidth and NR-ARFCN, respectively.
        
        An NR cell requires an uplink in order to provide initial access. In 
        case of TDD, the values of arfcnUL and bSChannelBwUL have to always be 
        set to the same values as for the corresponding DL attributes. For both 
        FDD and TDD, the arfcnUL and bSChannelBwUL define uplink resource grids 
        to which each sector-carrier needs to align to.
        
        An NR cell can in addition be configured with a supplementary uplink, 
        which has its own arfcnSUL and bSChannelBwSUL, which define resource 
        grids for supplementary uplink sector-carriers.
        
        Each of downlink, uplink and supplementary uplink (if configured) need 
        an initial bandwidth part (BWP), which defines resources to be used by 
        UEs during and immediately after initial access. Additional BWPs can be 
        either configured or calculated by gNB internally and be applied to UEs 
        dynamically by gNB based on e.g. UE capability and bandwidth need of 
        each UE.";
      key id;
      uses top3gpp:Top_Grp;
      container attributes {
+497 −0

File added.

Preview size limit exceeded, changes collapsed.