Commit 3de61517 authored by scottma's avatar scottma
Browse files

Update _3gpp-nr-nrm-antennafunction.yang

parent e056154a
Loading
Loading
Loading
Loading
Loading
+140 −0
Original line number Diff line number Diff line
module _3gpp-nr-nrm-antennafunction {
  yang-version 1.1;
  
  namespace urn:3gpp:sa5:_3gpp-nr-nrm-antennafunction;
  prefix antfunc;
  
  import _3gpp-common-managed-function { prefix mf3gpp; }
  import _3gpp-common-managed-element { prefix me3gpp; }
  import ietf-inet-types { prefix inet; }
  import _3gpp-5g-common-yang-types { prefix types5g3gpp; }
  import _3gpp-common-yang-types { prefix types3gpp; }
  import _3gpp-common-yang-extensions { prefix yext3gpp; }
  import _3gpp-common-top { prefix top3gpp; }
  
  organization "3gpp SA5";
  contact "https://www.3gpp.org/DynaReport/TSG-WG--S5--officials.htm?Itemid=464";
  description "This IOC represents the Antenna function in NR. For more 
    information about the AntennaFunction, see 3GPP TS 28.541.
    Copyright 2024, 3GPP Organizational Partners (ARIB, ATIS, CCSA, ETSI, TSDSI, 
    TTA, TTC). All rights reserved.";
  reference "3GPP TS 28.541";
  
  revision 2024-03-27 { reference CR-xxxx ; } 

  grouping AntennaFunctinGrp {
    description "Represents the information of an AntennaFunction Instance;
      
    leaf retTiltValue {
      type integer;
      mandatory false;
      min-elements 1;
      description "The electrical tilt setting of the antenna,
      See "Tilt value" in TS 37.466.";
    }
    
    leaf bearing {
      type integer;
      mandatory false;
      min-elements 1;
      description "The bearing in degrees that the antenna is pointing.
      See "Antenna bearing" in TS 25.463.";
    }
    
    leaf retGroupName {
      type string;
      mandatory false;
      min-elements 1;
      description "The group name is 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.";
    }
    
    leaf height {
      type integer;
      mandatory false;
      min-elements 1;
      description "The height of an antenna above sea level.  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 TS 37.466.  
      An integral value representing a number of meters in 0.1 meter 
      increments.";
    }

    leaf maxAzimuthValue {
      type integer;
      mandatory false;
      min-elements 1;
      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 behaviour 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 TS 37.466.
      A single integral value corresponding to an angle in degrees between
      0 and 360 with a resolution of 0.1 degrees.";
    }

    leaf minAzimuthValue {
      type integer;
      mandatory false;
      min-elements 1;
      description "The minimum 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 behaviour 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 TS 37.466.
      A single integral value corresponding to an angle in degrees between
      0 and 360 with a resolution of 0.1 degrees.";
    }

    leaf horizBeamWidth {
      type integer;
      mandatory false;
      min-elements 1;
      description "The 3 dB power beamwidth of the antenna pattern in the
      horizontal plane. 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 behaviour 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 TS 37.466.
      A single integral value corresponding to an angle in degrees 
      between 0 and 360.";
    }
    
    leaf vertBeamWidth {
      type integer;
      mandatory false;
      min-elements 1;
      description "The 3 dB power beamwidth of the antenna pattern in the
      vertical plane. 
      Note: The value of this attribute has no operational impact on the 
      network, e.g. the NE behaviour 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 TS 37.466.
      A single integral value corresponding to an angle in degrees 
      between 0 and 360.";
    }
  }
  
  grouping AntennaFunctionGrp {
    description "Represents the AntennaFunction IOC";
    uses AntennaFunction;
    
    augment "/me3gpp:ManagedElement" {
    list AntennaFunction {
      description "Antenna Function";
      reference "3GPP TS 28.541";
      key id;
      uses top3gpp:Top_Grp;
      container attributes {
        uses AntennaFunctionGrp;
      }
      uses mf3gpp:ManagedFunctionContainedClasses;
    }
  }
}