Merge branch... (4d55e5ab) · Commits · SA5 – Management & Orchestration and Charging / Management and Orchestration APIs

yang-models/_3gpp-common-antennafunction.yang

0 → 100644

+220 −0

Original line number	Diff line number	Diff line
		module _3gpp-common-antennafunction {
		yang-version 1.1;
		namespace "urn:3gpp:sa5:_3gpp-common-antennafunction";
		prefix "antfunc3gpp";

		import _3gpp-common-yang-types { prefix types3gpp; }
		import _3gpp-common-managed-function { prefix mf3gpp; }
		import _3gpp-common-managed-element { prefix me3gpp; }
		import _3gpp-common-top { prefix top3gpp; }

		organization "3GPP SA5";
		contact "https://www.3gpp.org/DynaReport/TSG-WG--S5--officials.htm?Itemid=464";
		description "Defines the YANG mapping of the Antenna Function Information
		Object Class (IOC) that is part of the Generic Network Resource Model (NRM).
		Copyright 2025, 3GPP Organizational Partners (ARIB, ATIS, CCSA, ETSI, TSDSI,
		TTA, TTC). All rights reserved.";
		reference "3GPP TS 28.662 Generic Network Resource Model (NRM)";

		revision 2025-05-04 { description "Initial revision";
		}

		typedef TenthOfDegrees {
		type uint16 {
		range 0..3600;
		}
		units "0.1 degrees";
		description "A single integral value corresponding to an angle in degrees
		between 0 and 360 with a resolution of 0.1 degrees.";
		}

		typedef Latitude {
		type decimal64 {
		fraction-digits 4;
		range "-90.0000..+90.0000";
		}
		description "Latitude values";
		}

		typedef Longitude {
		type decimal64 {
		fraction-digits 4;
		range "-180.0000..+180.0000";
		}
		description "Longitude values";
		}

		typedef Altitude {
		type decimal64 {
		fraction-digits 6;
		}
		units "meters";
		description
		"Height from a reference 0 value.";
		}

		grouping AntennaFunctionGrp {
		description "Represents the AntennaFunction.";
		uses mf3gpp:ManagedFunctionGrp;

		leaf beamTilt {
		description "The beam tilt of the wanted antenna beam
		in the vertical plane. A positive value on the
		beamtilt indicates an antenna beam direction below the
		vertical plane.";
		units degree;
		type TenthOfDegrees;
		}

		leaf bearing {
		description "The bearing in degrees that the antenna is pointing in.
		AllowedValues: See \"Antenna bearing\" in 3GPP TS 25.463.";
		reference "3GPP TS 25.463, UTRAN Iuant interface:
		Remote Electrical Tilting (RET)
		antennas Application Part (RETAP) signalling";
		type TenthOfDegrees;
		}

		leaf elevation {
		description "The elevation the antenna function should have,
		based on World Geodetic System (1984 version) global
		reference frame (WGS 84). Positive values correspond to
		meters above sea level, negative values correspond to meters
		below sea level. If empty, value is not defined.";
		type Altitude;
		}

		leaf horizBeamWidth {
		description "The 3 dB power beamwidth of the antenna pattern
		in the horizontal plane.
		A value of 360 indicates an omnidirectional 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 3GPP TS37.466.
		A single integral value corresponding to an angle in degrees
		between 0 and 360.";
		reference "3GPP TS 37.466, Iuant interface: Application part";
		type TenthOfDegrees;
		}

		leaf latitude {
		description "Latitude of transmitter antenna position.
		Positive value means north, negative value means south.

		Specification: WGS 84
		Allowed Values: { -90.000000..90.000000 }";
		units degree;
		type Latitude;
		}

		leaf longititude {
		description "Longitude of transmitter antenna position.
		Positive value means east, negative value means west.
		Specification: WGS 84
		Allowed Values: { -180.000000..180.000000 }";
		units degree;
		type Longitude;
		}

		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 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 Ref. 3GPP TS 37.466.
		A single decimal value corresponding to an angle in degrees
		between 0 and 360 with a resolution of 0.1 degrees.";
		reference "3GPP TS 37.466, Iuant interface: Application part";
		units degree;
		type decimal64 {
		range "0..360";
		fraction-digits 1;
		}
		}
		leaf minAzimuthValue {
		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 Ref. 3GPP TS 37.466.
		A single decimal value corresponding to an angle in degrees
		between 0 and 360 with a resolution of 0.1 degrees.";
		reference "3GPP TS 37.466, Iuant interface: Application part";
		units degree;
		type decimal64 {
		range "0..360";
		fraction-digits 1;
		}
		}

		leaf-list referencedBy {
		description "This attribute contains the DNs of one or more objects
		that refer to this object.

		In the case of AntennaFunction, these referring objects may
		include DNs of SectorEquipmentFunction instances if associations
		between them and the AntennaFunction exist.

		Note: referencedBy is a DN datatype and so can reference an MOI
		under a different ME";
		config false;
		type types3gpp:DistinguishedName;
		}


		leaf retGroupName {
		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";
		type string;
		}

		leaf retTiltValue {
		description "The electrical tilt setting of the antenna, \"Tilt value\" in
		3GPP TS 37.466.";
		reference "3GPP TS 37.466, Iuant interface: Application part";
		type TenthOfDegrees;
		}

		leaf vertBeamWidth {
		description "The 3 dB power beamwidth of the antenna pattern in
		the vertical plane.
		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.
		This attribute is not supported over the Iuant interface
		according to Ref. 3GPP TS 37.466.";
		reference "3GPP TS 37.466, Iuant interface: Application part";
		units degree;
		type uint32 {
		range "0..180";
		}
		}
		}

		augment "/me3gpp:ManagedElement" {

		list AntennaFunction {
		key id;
		uses top3gpp:Top_Grp;
		description "This MOI represents an array of radiating elements that
		may be tilted to adjust the RF coverage of a cell(s).";

		container attributes {
		uses AntennaFunctionGrp;
		}
		uses mf3gpp:ManagedFunctionContainedClasses;
		}
		}
		}

yang-models/_3gpp-common-sectorequipmentfunction.yang

0 → 100644

+88 −0

Original line number	Diff line number	Diff line
		module _3gpp-common-sectorequipmentfunction {
		yang-version 1.1;
		namespace "urn:3gpp:sa5:_3gpp-common-sectorequipmentfunction";
		prefix "scteqpfun3gpp";

		import _3gpp-common-yang-types { prefix types3gpp; }
		import _3gpp-common-managed-function { prefix mf3gpp; }
		import _3gpp-common-managed-element { prefix me3gpp; }
		import _3gpp-common-top { prefix top3gpp; }

		organization "3GPP SA5";
		contact "https://www.3gpp.org/DynaReport/TSG-WG--S5--officials.htm?Itemid=464";
		description "Defines the YANG mapping of the Sector Equipment Function
		Information Object Class (IOC) that is part of the Generic Network Resource
		Model (NRM).
		Copyright 2025, 3GPP Organizational Partners (ARIB, ATIS, CCSA, ETSI, TSDSI,
		TTA, TTC). All rights reserved.";
		reference "3GPP TS 28.662 Generic Network Resource Model (NRM)";

		revision 2025-05-04 { description "Initial revision"; }

		grouping SectorEquipmentFunctionGrp {
		description "Represents the SectorEquipmentFunction.";
		uses mf3gpp:ManagedFunctionGrp;

		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;
		}

		leaf-list fqBandList {
		description "The list of frequency bands/ranges supported by the
		hardware associated with the SectorEquipmentFunction. The
		earfcnDl and earfcnUl or earfcn of cells associated with the
		SectorEquipmentFunction must be assigned one of the specified
		frequency range values within the supported range.

		Valid frequency bands/ranges may be found in 3GPP TS 25.104 (UTRA),
		36.104 (E-UTRA) and 38.104 (NR).

		AllowedValues:
		Operating band id or supported frequency tuple
		<UL,DL,mode> expressed as a string.

		Examples for NR:
		Bands: {'n1', 'n12'}
		Frequencies: {'1920–1980, 2110–2170, FDD', '699–716, 729–746, FDD'}";
		config false;
		type string;
		}

		leaf-list referencedBy {
		description "This attribute contains the DNs of one or more objects
		that refer to this object.

		In the case of SectorEquipmentFunction , these referring objects
		may include Cells, NRSectorCarriers if associations between them
		and the SectorEquipmentFunction exist.

		Note: referencedBy is a DN datatype and so can reference an MOI
		under a different ME";
		config false;
		type types3gpp:DistinguishedName;
		}
		}

		augment "/me3gpp:ManagedElement" {
		list SectorEquipmentFunction {
		key id;
		uses top3gpp:Top_Grp;
		description "This IOC represents a set of cells within a geographical
		area that has common functions relating to AntennaFunction, TMAFunction
		and supporting equipment, such as power amplifier.";

		must 'id != ""' {
		error-message "Empty id value is not allowed.";
		}

		container attributes {
		uses SectorEquipmentFunctionGrp;
		}
		uses mf3gpp:ManagedFunctionContainedClasses;
		}
		}
		}
		No newline at end of file