Commit 42fa1d29 authored by lengyelb's avatar lengyelb
Browse files

S5-221416 CR0022

parent 130b0389
Loading
Loading
Loading
Loading
+125 −0
Original line number Diff line number Diff line
module _3gpp-rancom-antennafunction {
  yang-version 1.1;
  namespace "urn:3gpp:sa5:_3gpp-rancom-antennafunction";
  prefix "ant3gpp";
    
  import _3gpp-common-yang-types { prefix types3gpp; }
  import _3gpp-common-top { prefix top3gpp; }
  import _3gpp-common-managed-element { prefix me3gpp; }
  import _3gpp-common-managed-function { prefix mf3gpp; }

  organization "3GPP SA5";
  contact "https://www.3gpp.org/DynaReport/TSG-WG--S5--officials.htm?Itemid=464";
    
  description "Defines IOC for antenna function.";
  reference "3GPP TS 28.663
      Generic Radio Access Network (RAN)
      Network Resource Model (NRM)
      Integration Reference Point (IRP);
      Solution Set (SS) definitions
      
      3GPP TS 28.662
      Generic Radio Access Network (RAN)
      Network Resource Model (NRM)
      Integration Reference Point (IRP);
      Information Service (IS)";
  
  revision 2021-10-01 { reference CR-0022; }

  grouping AntennaFunctionGrp {
    description "Represents the AntennaFunction IOC.";

    uses mf3gpp:ManagedFunctionGrp;
    
    leaf retTiltValue {
      description "The electrical tilt setting of the antenna. The tilt value 
        is 10 times the antenna electrical tilt angle in degrees.";
      reference "See 'Tilt value' in Ref. 3GPP TS 37.466";
      type types3gpp:TenthOfDegrees;
    }
    leaf bearing {
      description "The bearing in degrees that the antenna is pointing in, 
      expressed as bearing value times 10.";
      reference "See 'Antenna bearing' in 3GPP TS 37.463";
      type types3gpp:TenthOfDegrees;
    }
    leaf retGroupName {
      description "A textual, alpha-numeric string to define a logical 
        grouping of antennas which may be in different cells.
        This attribute permits the definition of a logical grouping of the 
        antennas.  This may be defined either at installation time, or by 
        management activity to provisioning the group name via the Itf-N.";
      type string { length "0..80"; }
    }
    leaf height {
      description "The height of an antenna above sea level. An integral value 
        representing a number of meters in 0.1 meter increments.
        Note: The value of this attribute has no operational impact on the 
        network, e.g. the NE behavior is not affected by the value setting of 
        this attribute.  Note as well that this attribute is not supported 
        over the Iuant interface according to Ref. 3GPP TS 37.466.";
      type uint32;
      units decimeter;
    }
    leaf maxAzimuthValue {
      description "The maximum amount of change of azimuth the RET system can 
        support. This is the change in degrees clockwise from bearing.   
        Note: The value of this attribute has no operational impact on the 
        network, e.g. the NE behavior is not affected by the value setting of 
        this attribute.  Note as well that this attribute is not supported 
        over the Iuant interface according to Ref. 3GPP TS 37.466.";
      type types3gpp:TenthOfDegrees;
    }
    leaf minAzimuthValue {
      description "The minimum amount of change of azimuth the RET system can 
        support. This is the change in degrees counter-clockwise from bearing. 
        Note: The value of this attribute has no operational impact on the 
        network, e.g. the NE behavior is not affected by the value setting of 
        this attribute.  Note as well that this attribute is not supported 
        over the Iuant interface according to Ref. 3GPP TS 37.466.";
      type types3gpp:TenthOfDegrees;
    }
    leaf horizBeamwidth {
      description "The 3 dB power beamwidth of the antenna pattern in the 
        horizontal plane. A single integral value corresponding to an angle 
        in degrees between 0 and 360. A value of 360 indicates an 
        omni-directional antenna.
        Note: The value of this attribute has no operational impact on the 
        network, e.g. the NE behavior is not affected by the value setting of 
        this attribute.  Note as well that this attribute is not supported 
        over the Iuant interface according to Ref. 3GPP TS 37.466.";
      type uint32 { range 0..360; }
    }
    leaf vertBeamwidth {
      description "The 3 dB power beamwidth of the antenna pattern in the 
        vertical plane. A single integral value corresponding to an angle 
        in degrees between 0 and 180.
        Note: The value of this attribute has no operational impact on the 
        network, e.g. the NE behavior is not affected by the value setting of 
        this attribute.  Note as well that this attribute is not supported 
        over the Iuant interface according to Ref. 3GPP TS 37.466.";
      type uint32 { range 0..180; }
    }

    leaf-list theCellList {
      description "Contains the DNs of EUtranGenericCell or UtranGenericCell 
        if associations between them exist.";
      config false;
      type types3gpp:DistinguishedName;
    }

  }
  
  augment "/me3gpp:ManagedElement" {
    list AntennaFunction {
      description "Represents an array of radiating elements that may be 
        tilted to adjust the RF coverage of a cell(s).";
      uses top3gpp:Top_Grp;
      key id;
      container attributes {
        uses AntennaFunctionGrp;
      }
      uses mf3gpp:ManagedFunctionContainedClasses;
    }
  }
}
 No newline at end of file
+68 −0
Original line number Diff line number Diff line
module _3gpp-rancom-commonbsfunction {
  yang-version 1.1;
  namespace "urn:3gpp:sa5:_3gpp-rancom-commonbsfunction";
  prefix "combs3gpp";
    
  import _3gpp-common-yang-types { prefix types3gpp; }
  import _3gpp-common-top { prefix top3gpp; }
  import _3gpp-common-managed-element { prefix me3gpp; }
  import _3gpp-common-managed-function { prefix mf3gpp; }

  organization "3GPP SA5";
  contact "https://www.3gpp.org/DynaReport/TSG-WG--S5--officials.htm?Itemid=464";
    
  description "Defines IOC for common base station functionality.";
  reference "3GPP TS 28.663
      Generic Radio Access Network (RAN)
      Network Resource Model (NRM)
      Integration Reference Point (IRP);
      Solution Set (SS) definitions
      
      3GPP TS 28.662
      Generic Radio Access Network (RAN)
      Network Resource Model (NRM)
      Integration Reference Point (IRP);
      Information Service (IS)";
  
  revision 2021-10-01 { reference CR-0022; }

  grouping CommonBsFunctionGrp {
    description "Represents the CommonBsFunction IOC.";
    uses mf3gpp:ManagedFunctionGrp;
    
    leaf-list sharedTechnologies {
      description "Defines the radio access technologies sharing the common 
        functionalities of a Base Station (BS).";
      type enumeration {
        enum GSM;
        enum UMTS;                           
        enum LTE;                           
        enum NR;                           
      }
    }

    leaf-list theProxyBsList {
      description "A CommonBsFunction instance serves a number of 
        ProxyBsFunction instances. This CommonBsFunction role-attribute 
        contains a list of DNs of ENBFunction (3GPP TS 28.658), NodeBFunction 
        (3GPP TS 28.652) and BssFunction (3GPP TS 28.655) that it serves.";
      reference "3GPP TS 28.652, 3GPP TS 28.655, 3GPP TS 28.658";
      type types3gpp:DistinguishedName;
      config false;
    }

  }
  
  augment "/me3gpp:ManagedElement" {
    list CommonBsFunction {
      description "Represents common aspects of Base Station (BS) functionality
        shared by several radio access technologies.";
      uses top3gpp:Top_Grp;
      key id;
      container attributes {
        uses CommonBsFunctionGrp;
      }
      uses mf3gpp:ManagedFunctionContainedClasses;
    }
  }
}
 No newline at end of file
+116 −0
Original line number Diff line number Diff line
module _3gpp-rancom-repeaterfunction {
  yang-version 1.1;
  namespace "urn:3gpp:sa5:_3gpp-rancom-repeaterfunction";
  prefix "rep3gpp";
    
  import _3gpp-common-yang-types { prefix types3gpp; }
  import _3gpp-common-top { prefix top3gpp; }
  import _3gpp-common-managed-element { prefix me3gpp; }
  import _3gpp-common-managed-function { prefix mf3gpp; }

  organization "3GPP SA5";
  contact "https://www.3gpp.org/DynaReport/TSG-WG--S5--officials.htm?Itemid=464";
    
  description "Defines IOC for Tower Mounted Amplifier (TMA).";
  reference "3GPP TS 28.663
      Generic Radio Access Network (RAN)
      Network Resource Model (NRM)
      Integration Reference Point (IRP);
      Solution Set (SS) definitions
      
      3GPP TS 28.662
      Generic Radio Access Network (RAN)
      Network Resource Model (NRM)
      Integration Reference Point (IRP);
      Information Service (IS)";
  
  revision 2021-10-01 { reference CR-0022; }

  grouping RepeaterFunctionGrp {
    description "Represents the RepeaterFunction IOC.";
    
    uses mf3gpp:ManagedFunctionGrp;
    
    leaf priority {
      description "The priority of a repeater decided by an operator.";
      type uint32;
    }
    leaf latitude {
      description "The latitude of the antenna location based on World 
        Geodetic System (1984 version) global reference frame (WGS 84). 
        Positive values correspond to the northern hemisphere.";
      type types3gpp:Latitude;
      config false;
    }
    leaf longitude {
      description "The longitude of the antenna location based on World 
        Geodetic System (1984 version) global reference frame (WGS 84). 
        Positive values correspond to degrees east of 0 degrees longitude.";
      type types3gpp:Longitude;
      config false;
    }
    leaf ctrlConnMode {
      description "Remote communication mode used by a repeater to send and 
        receive control message, such as GSM SMS, WCDMA SMS, Circle Switch 
        Data-CSD, Package Switch Dat-IP, Serial port.";
      type enumeration {
        enum GSM_SMS;
        enum WCDMA_SMS;                           
        enum CIRCLE_SWITCH_DATA_CSD;                           
        enum PACKAGE_SWITCH_DAT_IP;                           
        enum SERIAL_PORT;                           
      }
    }
    leaf environmentInfo {
      description "The repeater device is located either in the building or 
        out of the building.";
      type string;
      config false;
    }
    leaf powerSwitch {
      description "Power switch of device which has two status: ON/OFF.";
      type types3gpp:OnOff;
    }
    leaf ulAttenuation {
      description "Uplink signal attenuation of the device to change uplink 
        gain.";
      type uint32;
    }
    leaf dlAttenuation {
      description "Downlink signal attenuation of the device to change 
        downlink gain.";
      type uint32;
    }
    leaf firmwareVer {
      description "Version of the device firmware.";
      type string;
      config false;
    }
    leaf repeaterType {
      description "The repeater type defined by operator, such as wide band, 
        frequency selective, indoor and fiber optic.";
      type enumeration {
        enum WIDE_BAND_REPT_FUNCTION;
        enum FREQ_SEL_REPT_FUNCTION;
        enum FIBER_REPT_FUNCTION;
        enum INDOOR_REPT_FUNCTION;
        enum FREQ_SHIFT_REPT_FUNCTION;
      }
      config false;
    }

  }
  
  augment "/me3gpp:ManagedElement" {
    list RepeaterFunction {
      description "Represents the management aspect of a repeater.";
      reference "3GPP TS 28.663, 3GPP TS 25.106";
      key id;
      uses top3gpp:Top_Grp;
      container attributes {
        uses RepeaterFunctionGrp;
      }
      uses mf3gpp:ManagedFunctionContainedClasses;
    }
  }
}
 No newline at end of file
+115 −0
Original line number Diff line number Diff line
module _3gpp-rancom-sectoreqfunction {
  yang-version 1.1;
  namespace "urn:3gpp:sa5:_3gpp-rancom-sectoreqfunction";
  prefix "sef3gpp";
    
  import _3gpp-common-yang-types { prefix types3gpp; }
  import _3gpp-common-top { prefix top3gpp; }
  import _3gpp-common-managed-element { prefix me3gpp; }
  import _3gpp-common-managed-function { prefix mf3gpp; }

  organization "3GPP SA5";
  contact "https://www.3gpp.org/DynaReport/TSG-WG--S5--officials.htm?Itemid=464";
    
  description "Defines IOC for sector equipment function.";
  reference "3GPP TS 28.663
      Generic Radio Access Network (RAN)
      Network Resource Model (NRM)
      Integration Reference Point (IRP);
      Solution Set (SS) definitions
      
      3GPP TS 28.662
      Generic Radio Access Network (RAN)
      Network Resource Model (NRM)
      Integration Reference Point (IRP);
      Information Service (IS)";
  
  revision 2021-10-01 { reference CR-0022; }

  grouping SectorEquipmentFunctionGrp {
    description "Represents the SectorEquipmentFunction IOC.";

    uses mf3gpp:ManagedFunctionGrp;
    
    leaf fqBand {
      description "This is the LTE frequency band supported by the hardware 
        associated with the SectorEquipmentFunction. The earfcnDl and earfcnUl 
        of cells associated with the SectorEquipmentFunction must be assigned 
        with value within this fqBand value.";
      reference "Valid frequency band values are specified in clause 5 Table 
        5.2-1 'E-UTRA frequency band' of 3GPP TS 36.104";
      type uint32;
      config false;
    }
    leaf-list eUTRANFqBands {
      description "This is the list of LTE frequency bands supported by the 
        hardware associated with the SectorEquipmentFunction. The earfcnDl and 
        earfcnUl or earfcn of LTE cells associated with the 
        SectorEquipmentFunction must be assigned with value within one of the 
        specified eUTRANFqBands values.";
      reference "Valid frequency band values are specified in sub-clause 5.7.3 
        in 3GPP TS 36.104";
      type string;
      config false;
    }
    leaf-list nRFqBands {
      description "This is the list of NR frequency bands supported by the 
        hardware associated with the SectorEquipmentFunction. 
        The arfcnDl and arfcnUl of the NRSectorCarrier must be assigned with 
        value within one of the specified nRFqBands values - if the attributes 
        on NRSectorCarriers are set.
        The arfcnDl and arfcnUl of the NRCellDU associated with the 
        NRSectorCarrier must be assigned with value within one of the specified 
        nRFqBands values - if there is a NRCellDU associated with the 
        NRSectorCarrier.";
      reference "Valid frequency band values are specified in sub-clause 5.4.2 
        in 3GPP TS 38.104";
      type string;
      config false;
    }
    leaf confOutputPower {
      description "It defines the allowed total power to use for all cells 
        together in this sector. It may be set by the operator and/or limited 
        by HW limitation or licensed power, e.g.: 20, 40, 60, 80, 120 watts.";
      type uint32;
      units watt ;
    }

    leaf-list theTMAList {
      description "Contains the DNs of one or more TMAFunction.";
      type types3gpp:DistinguishedName;
      config false;
    }
    leaf-list theAntennaList {
      description "Contains the DNs of one or more AntennaFunction.";
      type types3gpp:DistinguishedName;
      config false;
    }
    leaf-list theCellList {
      description "Contains the DNs of EUtranGenericCell or UtranGenericCell 
        if associations between them exist.";
      type types3gpp:DistinguishedName;
      config false;
    }
    leaf-list theNRSectorCarrierList {
      description "Contains the DNs of one or more NRSectorCarrier.";
      type types3gpp:DistinguishedName;
      config false;
    }

  }
  
  augment "/me3gpp:ManagedElement" {
    list SectorEquipmentFunction {
      description "Represents a set of cells within a geographical area that 
        has common functions relating to AntennaFunction, TMAFunction and 
        supporting equipment, such as power amplifier.";
      uses top3gpp:Top_Grp;
      key id;
      container attributes {
        uses SectorEquipmentFunctionGrp;
      }
      uses mf3gpp:ManagedFunctionContainedClasses;
    }
  }
}
 No newline at end of file
+156 −0
Original line number Diff line number Diff line
module _3gpp-rancom-tmafunction {
  yang-version 1.1;
  namespace "urn:3gpp:sa5:_3gpp-rancom-tmafunction";
  prefix "tma3gpp";
    
  import _3gpp-common-yang-types { prefix types3gpp; }
  import _3gpp-common-top { prefix top3gpp; }
  import _3gpp-common-managed-element { prefix me3gpp; }
  import _3gpp-common-managed-function { prefix mf3gpp; }

  organization "3GPP SA5";
  contact "https://www.3gpp.org/DynaReport/TSG-WG--S5--officials.htm?Itemid=464";
    
  description "Defines IOC for Tower Mounted Amplifier (TMA).";
  reference "3GPP TS 28.663
      Generic Radio Access Network (RAN)
      Network Resource Model (NRM)
      Integration Reference Point (IRP);
      Solution Set (SS) definitions
      
      3GPP TS 28.662
      Generic Radio Access Network (RAN)
      Network Resource Model (NRM)
      Integration Reference Point (IRP);
      Information Service (IS)";
  
  revision 2021-10-01 { reference CR-0022; }

  grouping TmaFunctionGrp {
    description "Represents the TMAFunction IOC.";
    reference "3GPP TS 28.663";
    uses mf3gpp:ManagedFunctionGrp;
    
    leaf tmaSubunitNumber {
      description "TMA subunit number. TMA subunits shall be numbered starting 
        with 1 and proceeding upwards.";
      reference "Defined in 3GPP TS 37.466";
      type uint32 { range "1..max"; }   
    }
    leaf tmaStateFlag {
      description "The mode state flag indicating whether the TMA subunit is 
        in normal mode or in bypass mode. TMA subunits which do not support 
        bypass mode shall return Normal mode.
        Mode state flag = 0 represents Normal mode. 
        Mode state flag = 1 represents Bypass mode.";
      reference "Defined in 3GPP TS 37.466";
      type uint32 { range "0..1"; }   
    }
    leaf tmaFunctionFlag {
      description "The function flags and parameters indicating the supported 
        functionality of the addressed TMA subunit";
      reference "Defined in 3GPP TS 37.466";
      type uint32 { range "0..1"; }   
    }
    leaf tmaMinGain {
      description "Minimum supported gain given as gain figure expressed in 
        dB/4.";
      reference "Defined in 3GPP TS 37.466";
      type uint32;
      config false;
    }
    leaf tmaMaxGain {
      description "Maximum supported gain given as gain figure expressed in 
        dB/4.";
      reference "Defined in 3GPP TS 37.466";
      type uint32;
      config false;
    }
    leaf tmaResolution {
      description "Gain resolution given as the gain resolution figure 
        expressed in dB/4.";
      reference "Defined in 3GPP TS 37.466";
      type uint32;
      config false;
    }
    leaf tmaGainFigure {
      description "TMA gain figure, calculated as 4 times the required gain 
        expressed in dB.";
      reference "Defined in 3GPP TS 37.466";
      type uint32;
    }
    leaf tmaNumberOfSubunits {
      description "The number of subunits controlled by the secondary device.";
      reference "Defined in 3GPP TS 37.466";
      type uint32;
      config false;
    }
    leaf tmaBaseStationId {
      description "Base station ID.";
      reference "Data field defined in Table B.3 of 3GPP TS 37.466";
      type string;
    }
    leaf tmaSectorId {
      description "Sector ID.";
      reference "Data field defined in Table B.3 of 3GPP TS 37.466";
      type string;
    }
    leaf tmaAntennaBearing {
      description "Antenna bearing.";
      reference "Data field defined in Table B.3 of 3GPP TS 37.466";
      type uint16;
    }
    leaf tmaInstalledMechanicalTilt {
      description "Installed mechanical tilt (degrees * 10).";
      reference "Data field defined in Table B.3 of 3GPP TS 37.466";
      type types3gpp:TenthOfDegrees;
    }
    leaf tmaSubunitType {
      description "TMA subunit type.";
      reference "Data field defined in Table B.3 of 3GPP TS 37.466";
      type uint32;
    }
    leaf-list tmaSubunitRxFrequencyBand {
      description "TMA subunit receive frequency band.";
      reference "Data field defined in Table B.3 of 3GPP TS 37.466";
      type uint16;
      min-elements 2;
      max-elements 2;
    }
    leaf-list tmaSubunitTxFrequencyBand {
      description "TMA subunit transmit frequency band.";
      reference "Data field defined in Table B.3 of 3GPP TS 37.466";
      type uint16;
      min-elements 2;
      max-elements 2;
    }
    leaf tmaGainResolution {
      description "Gain resolution given as the gain resolution figure 
        expressed in dB/4.";
      reference "Data field defined in Table B.3 of 3GPP TS 37.466";
      type uint32;
    }

    leaf-list theCellList {
      description "Contains the DNs of EUtranGenericCell or UtranGenericCell 
        if associations between them exist.";
      config false;
      type types3gpp:DistinguishedName;
    }

  }
  
  augment "/me3gpp:ManagedElement" {
    list TmaFunction {
      description "Represents a Tower Mounted Amplifier (TMA) or a number of 
        TMA subunits within one TMA, each separately addressable by a specific 
        index at the application layer.";
      uses top3gpp:Top_Grp;
      key id;
      container attributes {
        uses TmaFunctionGrp;
      }
      uses mf3gpp:ManagedFunctionContainedClasses;
    }
  }
}
 No newline at end of file