From 0fccf9f1bed48022d782c8a88aa340b5dc9c9940 Mon Sep 17 00:00:00 2001 From: scottma Date: Tue, 20 May 2025 05:12:48 +0000 Subject: [PATCH 01/15] Add antenna function definition. --- yang-models/_3gpp-common-antennafunction.yang | 231 ++++++++++++++++++ 1 file changed, 231 insertions(+) create mode 100644 yang-models/_3gpp-common-antennafunction.yang diff --git a/yang-models/_3gpp-common-antennafunction.yang b/yang-models/_3gpp-common-antennafunction.yang new file mode 100644 index 000000000..917a99628 --- /dev/null +++ b/yang-models/_3gpp-common-antennafunction.yang @@ -0,0 +1,231 @@ +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 types3gpp: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 types3gpp: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 types3gpp: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 types3gpp: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 types3gpp: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 types3gpp: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 types3gpp: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"; + } + } + + leaf-list theCellList { + description "This attribute contains the DNs of EUtranGenericCell + or UtranGenericCell if associations between them exist. + This attribute contains the DNs of GSMCellPart if association + between them exist. "; + config false; + status deprecated; + type types3gpp:DistinguishedName; + } + + } + + augment "/me3gpp:ManagedElement" { + + list AntennaFunction { + key id; + uses top3gpp:Top_Grp; + description "This MO 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; + } + } +} -- GitLab From c4c376e07ebdc3d4b5fc8d4d86c46f18861907e2 Mon Sep 17 00:00:00 2001 From: scottma Date: Tue, 20 May 2025 05:13:58 +0000 Subject: [PATCH 02/15] Add new file sector equipment function definition. --- .../_3gpp-common-sectorequipmentfunction.yang | 86 +++++++++++++++++++ 1 file changed, 86 insertions(+) create mode 100644 yang-models/_3gpp-common-sectorequipmentfunction.yang diff --git a/yang-models/_3gpp-common-sectorequipmentfunction.yang b/yang-models/_3gpp-common-sectorequipmentfunction.yang new file mode 100644 index 000000000..ec602b5d3 --- /dev/null +++ b/yang-models/_3gpp-common-sectorequipmentfunction.yang @@ -0,0 +1,86 @@ +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 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"; } + + 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 fqBands { + 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 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 -- GitLab From b55ee102aa31b4a7fc517f27f333e65f6a04a340 Mon Sep 17 00:00:00 2001 From: scottma Date: Tue, 20 May 2025 05:19:59 +0000 Subject: [PATCH 03/15] Edit _3gpp-common-antennafunction.yang --- yang-models/_3gpp-common-antennafunction.yang | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/yang-models/_3gpp-common-antennafunction.yang b/yang-models/_3gpp-common-antennafunction.yang index 917a99628..10caceaf7 100644 --- a/yang-models/_3gpp-common-antennafunction.yang +++ b/yang-models/_3gpp-common-antennafunction.yang @@ -63,7 +63,7 @@ module _3gpp-common-antennafunction { beamtilt indicates an antenna beam direction below the vertical plane."; units degree; - type types3gpp:TenthOfDegrees; + type TenthOfDegrees; } leaf bearing { @@ -72,7 +72,7 @@ module _3gpp-common-antennafunction { reference "3GPP TS 25.463, UTRAN Iuant interface: Remote Electrical Tilting (RET) antennas Application Part (RETAP) signalling"; - type types3gpp:TenthOfDegrees; + type TenthOfDegrees; } leaf elevation { @@ -81,7 +81,7 @@ module _3gpp-common-antennafunction { 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 types3gpp:Altitude; + type Altitude; } leaf horizBeamWidth { @@ -96,7 +96,7 @@ module _3gpp-common-antennafunction { A single integral value corresponding to an angle in degrees between 0 and 360."; reference "3GPP TS 37.466, Iuant interface: Application part"; - type types3gpp:TenthOfDegrees; + type TenthOfDegrees; } leaf latitude { @@ -106,7 +106,7 @@ module _3gpp-common-antennafunction { Specification: WGS 84 Allowed Values: { -90.000000..90.000000 }"; units degree; - type types3gpp:Latitude; + type Latitude; } leaf longititude { @@ -115,7 +115,7 @@ module _3gpp-common-antennafunction { Specification: WGS 84 Allowed Values: { -180.000000..180.000000 }"; units degree; - type types3gpp:Longitude; + type Longitude; } leaf maxAzimuthValue { -- GitLab From 36c14fdb9b7d39dd21ee07b379f3d475f6bbd94c Mon Sep 17 00:00:00 2001 From: scottma Date: Tue, 20 May 2025 05:21:57 +0000 Subject: [PATCH 04/15] Edit _3gpp-common-antennafunction.yang --- yang-models/_3gpp-common-antennafunction.yang | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/yang-models/_3gpp-common-antennafunction.yang b/yang-models/_3gpp-common-antennafunction.yang index 10caceaf7..887b9b550 100644 --- a/yang-models/_3gpp-common-antennafunction.yang +++ b/yang-models/_3gpp-common-antennafunction.yang @@ -184,7 +184,7 @@ module _3gpp-common-antennafunction { 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 types3gpp:TenthOfDegrees; + type TenthOfDegrees; } leaf vertBeamWidth { -- GitLab From d522a6ca6d386da0c76456f8aa689382d09a5170 Mon Sep 17 00:00:00 2001 From: scottma Date: Tue, 20 May 2025 05:23:58 +0000 Subject: [PATCH 05/15] Edit _3gpp-common-sectorequipmentfunction.yang -- GitLab From 8ba53d9cb28463a7a8b37c18d0d10d21b1529d13 Mon Sep 17 00:00:00 2001 From: scottma Date: Tue, 20 May 2025 07:08:01 +0000 Subject: [PATCH 06/15] Edit _3gpp-common-sectorequipmentfunction.yang --- yang-models/_3gpp-common-sectorequipmentfunction.yang | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/yang-models/_3gpp-common-sectorequipmentfunction.yang b/yang-models/_3gpp-common-sectorequipmentfunction.yang index ec602b5d3..1f5829757 100644 --- a/yang-models/_3gpp-common-sectorequipmentfunction.yang +++ b/yang-models/_3gpp-common-sectorequipmentfunction.yang @@ -30,7 +30,7 @@ module _3gpp-common-sectorequipmentfunction { type uint32; } - leaf-list fqBands { + 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 @@ -41,7 +41,8 @@ module _3gpp-common-sectorequipmentfunction { 36.104 (E-UTRA) and 38.104 (NR). AllowedValues: - Operating band id or supported UL/DL/mode expressed as a string. + Operating band id or supported frequency tuple +
    expressed as a string. Examples for NR: Bands: {'n1', 'n12'} -- GitLab From f6094219fbdedcd6db21b719d084394eedc39c62 Mon Sep 17 00:00:00 2001 From: scottma Date: Tue, 20 May 2025 07:10:23 +0000 Subject: [PATCH 07/15] Edit _3gpp-common-sectorequipmentfunction.yang -- GitLab From 1b3fe0cb7b55a00b52bb49b2fe20b0a995070d9d Mon Sep 17 00:00:00 2001 From: scottma Date: Thu, 22 May 2025 00:01:45 +0000 Subject: [PATCH 08/15] Edit _3gpp-common-sectorequipmentfunction.yang --- yang-models/_3gpp-common-sectorequipmentfunction.yang | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/yang-models/_3gpp-common-sectorequipmentfunction.yang b/yang-models/_3gpp-common-sectorequipmentfunction.yang index 1f5829757..c65f168af 100644 --- a/yang-models/_3gpp-common-sectorequipmentfunction.yang +++ b/yang-models/_3gpp-common-sectorequipmentfunction.yang @@ -42,7 +42,7 @@ module _3gpp-common-sectorequipmentfunction { AllowedValues: Operating band id or supported frequency tuple -
      expressed as a string. + expressed as a string. Examples for NR: Bands: {'n1', 'n12'} -- GitLab From 937ce37eb50463dbb52dcae37ed5eeda93f59d41 Mon Sep 17 00:00:00 2001 From: scottma Date: Thu, 22 May 2025 00:06:59 +0000 Subject: [PATCH 09/15] Edit _3gpp-common-sectorequipmentfunction.yang -- GitLab From f7271fc1fe45d3725206c7652fabbaebe97e2190 Mon Sep 17 00:00:00 2001 From: scottma Date: Thu, 22 May 2025 06:42:15 +0000 Subject: [PATCH 10/15] Edit _3gpp-common-antennafunction.yang --- yang-models/_3gpp-common-antennafunction.yang | 11 ----------- 1 file changed, 11 deletions(-) diff --git a/yang-models/_3gpp-common-antennafunction.yang b/yang-models/_3gpp-common-antennafunction.yang index 887b9b550..302178a8c 100644 --- a/yang-models/_3gpp-common-antennafunction.yang +++ b/yang-models/_3gpp-common-antennafunction.yang @@ -201,17 +201,6 @@ module _3gpp-common-antennafunction { range "0..180"; } } - - leaf-list theCellList { - description "This attribute contains the DNs of EUtranGenericCell - or UtranGenericCell if associations between them exist. - This attribute contains the DNs of GSMCellPart if association - between them exist. "; - config false; - status deprecated; - type types3gpp:DistinguishedName; - } - } augment "/me3gpp:ManagedElement" { -- GitLab From 1c0cb60fe835ba52a4ac9dc09e4e8ea9b61afbb8 Mon Sep 17 00:00:00 2001 From: scottma Date: Thu, 22 May 2025 07:07:38 +0000 Subject: [PATCH 11/15] Edit _3gpp-common-antennafunction.yang -- GitLab From f4ffe0f7af2221228b003e86320aad17c6c36991 Mon Sep 17 00:00:00 2001 From: scottma Date: Thu, 22 May 2025 12:34:20 +0000 Subject: [PATCH 12/15] Edit _3gpp-common-sectorequipmentfunction.yang --- yang-models/_3gpp-common-sectorequipmentfunction.yang | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/yang-models/_3gpp-common-sectorequipmentfunction.yang b/yang-models/_3gpp-common-sectorequipmentfunction.yang index c65f168af..6839769ef 100644 --- a/yang-models/_3gpp-common-sectorequipmentfunction.yang +++ b/yang-models/_3gpp-common-sectorequipmentfunction.yang @@ -10,8 +10,9 @@ module _3gpp-common-sectorequipmentfunction { 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). + 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)"; -- GitLab From 7b018527ea49221c0a6f2361115cbb0315b81603 Mon Sep 17 00:00:00 2001 From: scottma Date: Thu, 22 May 2025 12:40:11 +0000 Subject: [PATCH 13/15] Edit _3gpp-common-antennafunction.yang --- yang-models/_3gpp-common-antennafunction.yang | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/yang-models/_3gpp-common-antennafunction.yang b/yang-models/_3gpp-common-antennafunction.yang index 302178a8c..feaa0ed2d 100644 --- a/yang-models/_3gpp-common-antennafunction.yang +++ b/yang-models/_3gpp-common-antennafunction.yang @@ -208,7 +208,7 @@ module _3gpp-common-antennafunction { list AntennaFunction { key id; uses top3gpp:Top_Grp; - description "This MO represents an array of radiating elements that + description "This MOI represents an array of radiating elements that may be tilted to adjust the RF coverage of a cell(s)."; container attributes { -- GitLab From 5821ce81a38f509afbc598bcc9ce66d55a3b4619 Mon Sep 17 00:00:00 2001 From: scottma Date: Thu, 22 May 2025 12:50:40 +0000 Subject: [PATCH 14/15] Edit _3gpp-common-antennafunction.yang -- GitLab From 02bd2aebf5ab4d2572f158a8b626cb94413e1a0c Mon Sep 17 00:00:00 2001 From: scottma Date: Thu, 22 May 2025 12:51:39 +0000 Subject: [PATCH 15/15] Edit _3gpp-common-sectorequipmentfunction.yang -- GitLab