From 1241e65fdf3ebc532d8aa22802d755d8690b7ea5 Mon Sep 17 00:00:00 2001 From: scottma Date: Fri, 9 May 2025 17:43:12 +0000 Subject: [PATCH 01/15] Add new file --- yang-models/_3gpp-common-antennafunction.yang | 210 ++++++++++++++++++ 1 file changed, 210 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..881bca02c --- /dev/null +++ b/yang-models/_3gpp-common-antennafunction.yang @@ -0,0 +1,210 @@ +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-01 { description "Initial revision"; + } + 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 height { + 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 3GPP TS 37.466. + Decprecated: Use 'elevation' attribute"; + reference "3GPP TS 37.466, Iuant interface: Application part"; + status deprecated; + units meters; + type uint64; + } + + 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 457f3d16ed8ade45cfa15adbac99d5f5db9be333 Mon Sep 17 00:00:00 2001 From: scottma Date: Fri, 9 May 2025 17:44:01 +0000 Subject: [PATCH 02/15] Add new file --- .../_3gpp-common-sectorequipmentfunction.yang | 101 ++++++++++++++++++ 1 file changed, 101 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..fc499169b --- /dev/null +++ b/yang-models/_3gpp-common-sectorequipmentfunction.yang @@ -0,0 +1,101 @@ +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-01 { 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 fqBands { + description "The list of frequency bands supported by the hardware + associated with the SectorEquipmentFunction. The earfcnDl and + earfcnUl or earfcn of cells associated with the SectorEquipmentFunction + must be assigned with value within one of the specified frequencyBands values. + + AllowedValues: + A list of frequency bands expressed as strings. + Valid frequency band values may be found in 3GPP TS 25.104 (3G), + 36.104 (LTE) and 38.104 (NR)."; + config false; + type string; + } + + leaf-list theAntennaList { + description "This attribute contains the distinguished names of the + AntennaFunction."; + type types3gpp:DistinguishedName; + } + + 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; + type types3gpp:DistinguishedName; + } + + leaf-list theTMAList { + description "This attribute contains the DNs of one or more TMAFunctions."; + config false; + type types3gpp:DistinguishedName; + } + + 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 34f2e1abfb97d2e99fad2d15cabb9b66c4c5103e Mon Sep 17 00:00:00 2001 From: scottma Date: Fri, 9 May 2025 17:53:32 +0000 Subject: [PATCH 03/15] Edit _3gpp-common-sectorequipmentfunction.yang -- GitLab From 700a13d1f583e7247111b7cd70b8d581977acadb Mon Sep 17 00:00:00 2001 From: scottma Date: Mon, 19 May 2025 08:26:16 +0000 Subject: [PATCH 04/15] Edit _3gpp-common-sectorequipmentfunction.yang --- .../_3gpp-common-sectorequipmentfunction.yang | 21 ------------------- 1 file changed, 21 deletions(-) diff --git a/yang-models/_3gpp-common-sectorequipmentfunction.yang b/yang-models/_3gpp-common-sectorequipmentfunction.yang index fc499169b..2ae4c866a 100644 --- a/yang-models/_3gpp-common-sectorequipmentfunction.yang +++ b/yang-models/_3gpp-common-sectorequipmentfunction.yang @@ -44,27 +44,6 @@ module _3gpp-common-sectorequipmentfunction { type string; } - leaf-list theAntennaList { - description "This attribute contains the distinguished names of the - AntennaFunction."; - type types3gpp:DistinguishedName; - } - - 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; - type types3gpp:DistinguishedName; - } - - leaf-list theTMAList { - description "This attribute contains the DNs of one or more TMAFunctions."; - config false; - type types3gpp:DistinguishedName; - } - leaf-list referencedBy { description "This attribute contains the DNs of one or more objects that refer to this object. -- GitLab From cc5988400f1f00e7650f35e185aca1db405d3e19 Mon Sep 17 00:00:00 2001 From: scottma Date: Mon, 19 May 2025 08:54:47 +0000 Subject: [PATCH 05/15] Edit _3gpp-common-sectorequipmentfunction.yang -- GitLab From 3975842cd4fe0caf6674bafd5c817dc819ec3c65 Mon Sep 17 00:00:00 2001 From: scottma Date: Wed, 21 May 2025 09:35:27 +0000 Subject: [PATCH 06/15] Edit _3gpp-common-sectorequipmentfunction.yang --- .../_3gpp-common-sectorequipmentfunction.yang | 27 ++++++++++++------- 1 file changed, 17 insertions(+), 10 deletions(-) diff --git a/yang-models/_3gpp-common-sectorequipmentfunction.yang b/yang-models/_3gpp-common-sectorequipmentfunction.yang index 2ae4c866a..c22df5227 100644 --- a/yang-models/_3gpp-common-sectorequipmentfunction.yang +++ b/yang-models/_3gpp-common-sectorequipmentfunction.yang @@ -30,16 +30,23 @@ module _3gpp-common-sectorequipmentfunction { type uint32; } - leaf fqBands { - description "The list of frequency bands supported by the hardware - associated with the SectorEquipmentFunction. The earfcnDl and - earfcnUl or earfcn of cells associated with the SectorEquipmentFunction - must be assigned with value within one of the specified frequencyBands values. - - AllowedValues: - A list of frequency bands expressed as strings. - Valid frequency band values may be found in 3GPP TS 25.104 (3G), - 36.104 (LTE) and 38.104 (NR)."; + 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 +
    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; } -- GitLab From 04e8d6b9893ed40f4bcaa4ad7bf3249f5994575c Mon Sep 17 00:00:00 2001 From: scottma Date: Wed, 21 May 2025 09:38:59 +0000 Subject: [PATCH 07/15] Edit _3gpp-common-sectorequipmentfunction.yang -- GitLab From da5ebffcd8959082872f2a8acaad89461717791d Mon Sep 17 00:00:00 2001 From: scottma Date: Thu, 22 May 2025 00:05:15 +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 c22df5227..e2e691bcb 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 dcc83eb71205db23db73492a245dc290b16bba70 Mon Sep 17 00:00:00 2001 From: scottma Date: Thu, 22 May 2025 00:09:09 +0000 Subject: [PATCH 09/15] Edit _3gpp-common-sectorequipmentfunction.yang -- GitLab From 3e1bda3736988c6b46662223d58f44a9d8835a73 Mon Sep 17 00:00:00 2001 From: scottma Date: Thu, 22 May 2025 06:38:26 +0000 Subject: [PATCH 10/15] Edit _3gpp-common-antennafunction.yang --- yang-models/_3gpp-common-antennafunction.yang | 16 +--------------- 1 file changed, 1 insertion(+), 15 deletions(-) diff --git a/yang-models/_3gpp-common-antennafunction.yang b/yang-models/_3gpp-common-antennafunction.yang index 881bca02c..09fc423fa 100644 --- a/yang-models/_3gpp-common-antennafunction.yang +++ b/yang-models/_3gpp-common-antennafunction.yang @@ -48,21 +48,7 @@ module _3gpp-common-antennafunction { below sea level. If empty, value is not defined."; type types3gpp:Altitude; } - - leaf height { - 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 3GPP TS 37.466. - Decprecated: Use 'elevation' attribute"; - reference "3GPP TS 37.466, Iuant interface: Application part"; - status deprecated; - units meters; - type uint64; - } - + leaf horizBeamWidth { description "The 3 dB power beamwidth of the antenna pattern in the horizontal plane. -- GitLab From 10feb2344494c5616df3d95bd5a74252c76fec2b Mon Sep 17 00:00:00 2001 From: scottma Date: Thu, 22 May 2025 07:09:20 +0000 Subject: [PATCH 11/15] Edit _3gpp-common-antennafunction.yang -- GitLab From 52ede66b7f9c106bc5e02fcf9b632349c1cdfb4b Mon Sep 17 00:00:00 2001 From: scottma Date: Thu, 22 May 2025 12:46:41 +0000 Subject: [PATCH 12/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 09fc423fa..330c5c748 100644 --- a/yang-models/_3gpp-common-antennafunction.yang +++ b/yang-models/_3gpp-common-antennafunction.yang @@ -184,7 +184,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 54965b5d1750c8c1cea7774daf0bee26496853e7 Mon Sep 17 00:00:00 2001 From: scottma Date: Thu, 22 May 2025 12:47:37 +0000 Subject: [PATCH 13/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 e2e691bcb..985e77639 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 fc55a8c8cc93ef445c9c6454d853afe26f8fa9bb Mon Sep 17 00:00:00 2001 From: scottma Date: Thu, 22 May 2025 12:57:40 +0000 Subject: [PATCH 14/15] Edit _3gpp-common-antennafunction.yang -- GitLab From 116bada04912fcee311735d325ba8cfda58b67d6 Mon Sep 17 00:00:00 2001 From: scottma Date: Thu, 22 May 2025 12:58:11 +0000 Subject: [PATCH 15/15] Edit _3gpp-common-sectorequipmentfunction.yang -- GitLab