E.5 Modules
28.5413GPP5G Network Resource Model (NRM)Management and orchestrationStage 2 and stage 3TS
E.5.1 module _3gpp-nr-nrm-beam.yang
<CODE BEGINS>
module _3gpp-nr-nrm-beam {
yang-version 1.1;
namespace "urn:3gpp:sa5:_3gpp-nr-nrm-beam";
prefix "beam3gpp";
import _3gpp-nr-nrm-commonbeamformingfunction { prefix cbeamff3gpp; }
import _3gpp-common-top { prefix top3gpp; }
import _3gpp-common-managed-function { prefix mf3gpp; }
import _3gpp-common-managed-element { prefix me3gpp; }
import _3gpp-nr-nrm-gnbdufunction { prefix gnbdu3gpp; }
import _3gpp-nr-nrm-nrsectorcarrier { prefix nrsectcarr3gpp; }
organization "3GPP SA5";
contact "https://www.3gpp.org/DynaReport/TSG-WG–S5–officials.htm?Itemid=464";
description "Defines the YANG mapping of the Beam Information
Object Class (IOC) that is part of the NR Network Resource Model (NRM).";
reference "3GPP TS 28.541 5G Network Resource Model (NRM)";
revision 2019-11-22 {
description "Initial revision";
reference "S5-197643";
}
typedef BeamType {
type enumeration {
enum SSB-BEAM;
}
}
grouping BeamGrp {
description "Represents the Beam IOC.";
reference "3GPP TS 28.541";
uses mf3gpp:ManagedFunctionGrp;
leaf beamIndex {
description "Index of the beam. ";
mandatory true;
type int32;
}
leaf beamType {
description "The type of the beam. ";
type BeamType;
}
leaf beamAzimuth {
description "The azimuth of a beam transmission, which means the
horizontal beamforming pointing angle (beam peak direction) in the
Phi-axis in 1/10th degree resolution. The pointing angle is the
direction equal to the geometric centre of the half-power contour
of the beam relative to the reference plane. Zero degree implies
explicit antenna bearing (boresight). Positive angle implies clockwise
from the antenna bearing.";
reference "3GPP TS 38.104, TS 38.901, TS 28.662";
type int32 { range "-1800..1800"; }
units "0.1";
}
leaf beamTilt {
description "The tilt of a beam transmission, which means the vertical
beamforming pointing angle (beam peak direction) in the Theta-axis in
1/10th degree resolution.
The pointing angle is the direction equal to the geometric centre of
the half-power contour of the beam relative to the reference plane.
Positive value implies downtilt.";
reference "3GPP TS 38.104, TS 38.901, TS 28.662";
type int32 { range "-900..900"; }
units "0.1";
}
leaf beamHorizWidth {
description " The Horizontal beamWidth of a beam transmission, which
means the horizontal beamforming half-power (3dB down) beamwidth in the
Phi-axis in 1/10th degree resolution.";
reference "3GPP TS 38.104, TS 38.901";
type int32 { range "0..3599"; }
units "0.1";
}
leaf beamVertWidth {
description " The Vertical beamWidth of a beam transmission, which means
the vertical beamforming half-power (3dB down) beamwidth in the
Theta-axis in 1/10th degree resolution.";
reference "3GPP TS 38.104, TS 38.901";
type int32 { range "0..1800"; }
units "0.1";
}
}
augment "/me3gpp:ManagedElement/gnbdu3gpp:GNBDUFunction/"
+ "nrsectcarr3gpp:NRSectorCarrier/cbeamff3gpp:CommonBeamformingFunction" {
list Beam {
description "Represents the per-Beam information required for,
e.g. beam performance management utilizing measurements generated in
the RAN. Can have spatial attributes of horizontal/azimuth
(ie: Phi-axis) and vertical/tilt (ie: Theta-axis) beam pointing
direction and beam width attributes.";
reference "3GPP TS 28.541";
key id;
uses top3gpp:Top_Grp;
container attributes {
uses BeamGrp;
}
}
}
}
<CODE ENDS>
E.5.1a module _3gpp-nr-nrm-bwp.yang
<CODE BEGINS>
module _3gpp-nr-nrm-bwp {
yang-version 1.1;
namespace "urn:3gpp:sa5:_3gpp-nr-nrm-bwp";
prefix "bwp3gpp";
import _3gpp-common-managed-element { prefix me3gpp; }
import _3gpp-common-managed-function { prefix mf3gpp; }
import _3gpp-common-top { prefix top3gpp; }
import _3gpp-nr-nrm-gnbdufunction { prefix gnbdu3gpp; }
organization "3GPP SA5";
contact "https://www.3gpp.org/DynaReport/TSG-WG–S5–officials.htm?Itemid=464";
description "Defines the YANG mapping of the BWP Information Object Class
(IOC) that is part of the NR Network Resource Model (NRM).";
reference "3GPP TS 28.541 5G Network Resource Model (NRM)";
revision 2020-11-17 { reference CR-0410 ; }
revision 2019-10-28 { reference S5-193518 ; }
revision 2019-06-17 { reference "Initial revision"; }
typedef CyclicPrefix {
type enumeration {
enum NORMAL;
enum EXTENDED;
}
}
typedef BwpContext {
type enumeration {
enum DL;
enum UL;
enum SUL;
}
}
typedef IsInitialBwp {
type enumeration {
enum INITIAL;
enum OTHER;
}
}
grouping BWPGrp {
description "Represents the BWP IOC.";
reference "3GPP TS 28.541";
uses mf3gpp:ManagedFunctionGrp;
leaf bwpContext {
description "Identifies whether the object is used for downlink, uplink
or supplementary uplink.";
mandatory true;
type BwpContext;
}
leaf isInitialBwp {
description "Identifies whether the object is used for initial or other
BWP.";
mandatory true;
type IsInitialBwp;
}
leaf subCarrierSpacing {
description "Subcarrier spacing configuration for a BWP.";
reference "3GPP TS 38.104";
mandatory true;
type uint32 { range "15 | 30 | 60 | 120"; }
units kHz;
}
leaf cyclicPrefix {
description "Cyclic prefix, which may be normal or extended.";
reference "3GPP TS 38.211";
mandatory true;
type CyclicPrefix;
}
leaf startRB {
description "Offset in common resource blocks to common resource block 0
for the applicable subcarrier spacing for a BWP.";
reference "N_BWP_start in 3GPP TS 38.211";
mandatory true;
type uint32;
}
leaf numberOfRBs {
description "Number of physical resource blocks for a BWP.";
reference "N_BWP_size in 3GPP TS 38.211";
mandatory true;
type uint32;
}
}
augment "/me3gpp:ManagedElement/gnbdu3gpp:GNBDUFunction" {
list BWP {
description "Represents a bandwidth part (BWP).";
key id;
uses top3gpp:Top_Grp;
container attributes {
uses BWPGrp;
}
uses mf3gpp:ManagedFunctionContainedClasses;
}
}
}
<CODE ENDS>
E.5.1b module _3gpp-nr-nrm-commonbeamformingfunction.yang
<CODE BEGINS>
module _3gpp-nr-nrm-commonbeamformingfunction {
yang-version 1.1;
namespace "urn:3gpp:sa5:_3gpp-nr-nrm-nrnetwork-commonbeamformingfunction";
prefix "combeamformfunc3gpp";
import _3gpp-nr-nrm-nrsectorcarrier { prefix nrsectcarr3gpp; }
import _3gpp-common-top { prefix top3gpp; }
import _3gpp-common-managed-function { prefix mf3gpp; }
import _3gpp-common-managed-element { prefix me3gpp; }
import _3gpp-nr-nrm-gnbdufunction { prefix gnbdu3gpp; }
organization "3GPP SA5";
description "Defines the YANG mapping of the CommonBeamformingFuntion Information
Object Class (IOC) that is part of the NR Network Resource Model (NRM).";
reference "3GPP TS 28.541 5G Network Resource Model (NRM)";
revision 2019-11-22 {
description "Initial revision";
reference "S5-197643";
}
grouping CommonBeamformingFunctionGrp {
description "Represents the CommonBeamformingFunction IOC.";
reference "3GPP TS 28.541";
uses mf3gpp:ManagedFunctionGrp;
leaf coverageShape {
description "Identifies the sector carrier coverage shape described by the envelope of the contained SSB beams. The coverage shape is implementation dependent.";
mandatory true;
type int32 { range "0..65535"; }
}
leaf digitalAzimuth {
description "Digitally-controlled azimuth through beamforming. It represents the horizontal pointing direction of the antenna relative to the antenna bore sight, representing the total non-mechanical horizontal pan of the selected coverageShape. Positive value gives azimuth to the right and negative value gives an azimuth to the left.";
reference "3GPP TS 38.104, TS 38.901, TS 28.662";
type int32 { range "-1800..1800"; }
units "0.1";
}
leaf digitalTilt {
description "Digitally-controlled tilt through beamforming. It represents the vertical pointing direction of the antenna relative to the antenna bore sight, representing the total non-mechanical vertical tilt of the selected coverageShape. Positive value gives downwards tilt and negative value gives upwards tilt.";
reference "3GPP TS 38.104, TS 38.901, TS 28.662";
type int32 { range "-900..900"; }
units "0.1";
}
}
augment "/me3gpp:ManagedElement/gnbdu3gpp:GNBDUFunction/nrsectcarr3gpp:NRSectorCarrier" {
list CommonBeamformingFunction {
description "Represents common beamforming functionality (eg: SSB beams) for the NRSectorCarrier.";
reference "3GPP TS 28.541";
key id;
uses top3gpp:Top_Grp;
container attributes {
uses CommonBeamformingFunctionGrp;
}
}
}
}
<CODE ENDS>
E.5.2 module _3gpp-nr-nrm-ep.yang
<CODE BEGINS>
module _3gpp-nr-nrm-ep {
yang-version 1.1;
namespace "urn:3gpp:sa5:_3gpp-nr-nrm-ep";
prefix "ep3gpp";
import _3gpp-common-ep-rp { prefix eprp3gpp; }
import _3gpp-common-managed-element { prefix me3gpp; }
import _3gpp-common-top { prefix top3gpp; }
import _3gpp-nr-nrm-gnbcucpfunction { prefix gnbcucp3gpp; }
import _3gpp-nr-nrm-gnbcuupfunction { prefix gnbcuup3gpp; }
import _3gpp-nr-nrm-gnbdufunction { prefix gnbdu3gpp; }
organization "3GPP SA5";
contact "https://www.3gpp.org/DynaReport/TSG-WG–S5–officials.htm?Itemid=464";
description "Defines the YANG mapping of the NR related endpoint
Information Object Classes (IOCs) that are part of the NR Network
Resource Model (NRM).";
reference "3GPP TS 28.541 5G Network Resource Model (NRM)";
revision 2022-01-07 { reference CR-0643; }
revision 2021-05-01 { reference CR-0490; }
revision 2021-03-03 { reference CR-0435 ; }
revision 2021-02-17 { reference CR-0470; }
revision 2020-11-17 { reference CR-0410; }
revision 2020-03-02 { reference S5-201191; }
revision 2019-06-17 { reference "Initial revision"; }
feature EPClassesUnderGNBCUCPFunction {
description "Endpoint classes shall be contained under GNBCUCPFunction";
}
feature EPClassesUnderGNBCUUPFunction {
description "Endpoint classes shall be contained under GNBCUUPFunction";
}
feature EPClassesUnderGNBDUFunction {
description "Endpoint classes shall be contained under GNBDUFunction";
}
grouping EP_E1Grp {
description "Represents the EP_E1 IOC.";
reference "3GPP TS 28.541, 3GPP TS 38.401";
uses eprp3gpp:EP_Common;
}
grouping EP_F1CGrp {
description "Represents the EP_F1C IOC.";
reference "3GPP TS 28.541, 3GPP TS 38.470";
uses eprp3gpp:EP_Common;
}
grouping EP_F1UGrp {
description "Represents the EP_F1U IOC.";
reference "3GPP TS 28.541, 3GPP TS 38.470";
uses eprp3gpp:EP_Common;
}
grouping EP_XnCGrp {
description "Represents the EP_XnC IOC.";
reference "3GPP TS 28.541, 3GPP TS 38.420";
uses eprp3gpp:EP_Common;
}
grouping EP_XnUGrp {
description "Represents the EP_XnU IOC.";
reference "3GPP TS 28.541, 3GPP TS 38.420";
uses eprp3gpp:EP_Common;
}
grouping EP_NgCGrp {
description "Represents the EP_NgC IOC.";
reference "3GPP TS 28.541, 3GPP TS 38.470";
uses eprp3gpp:EP_Common;
}
grouping EP_NgUGrp {
description "Represents the EP_NgU IOC.";
reference "3GPP TS 28.541, 3GPP TS 38.470";
uses eprp3gpp:EP_Common;
}
grouping EP_X2CGrp {
description "Represents the EP_X2C IOC.";
reference "3GPP TS 28.541, 3GPP TS 36.423";
uses eprp3gpp:EP_Common;
}
grouping EP_X2UGrp {
description "Represents the EP_X2U IOC.";
reference "3GPP TS 28.541, 3GPP TS 36.425";
uses eprp3gpp:EP_Common;
}
grouping EP_S1UGrp {
description "Represents the EP_S1U IOC.";
reference "3GPP TS 28.541, 3GPP TS 36.410";
uses eprp3gpp:EP_Common;
}
augment "/me3gpp:ManagedElement/gnbcucp3gpp:GNBCUCPFunction" {
if-feature EPClassesUnderGNBCUCPFunction;
list EP_E1 {
description "Represents the local end point of the logical link,
supporting E1 interface between gNB-CU-CP and gNB-CU-UP.";
reference "3GPP TS 28.541, 3GPP TS 38.401";
key id;
uses top3gpp:Top_Grp;
container attributes {
uses EP_E1Grp;
}
}
list EP_F1C {
description "Represents the local end point of the control plane
interface (F1-C) between the gNB-DU and gNB-CU or gNB-CU-CP.";
reference "3GPP TS 28.541, 3GPP TS 38.470";
key id;
uses top3gpp:Top_Grp;
container attributes {
uses EP_F1CGrp;
}
}
list EP_NgC {
description "Represents the local end point of the control plane
interface (NG-C) between the gNB and AMF.";
reference "3GPP TS 28.541, 3GPP TS 38.470";
key id;
uses top3gpp:Top_Grp;
container attributes {
uses EP_NgCGrp;
}
}
list EP_XnC {
description "Represents the local gNB node end point of the logical
link, supporting Xn application protocols, to a neighbour NG-RAN node
(including gNB and ng-eNB). The Xn Application PDUs are carried over
SCTP/IP/Data link layer/Physical layer stack.";
reference "3GPP TS 28.541, 3GPP TS 38.420 subclause 7";
key id;
uses top3gpp:Top_Grp;
container attributes {
uses EP_XnCGrp;
}
}
list EP_X2C {
description "Represents the local end point of the logical link,
supporting X2-C application protocols used in EN-DC, to a neighbour
eNB or en-gNB node.";
reference "3GPP TS 28.541, 3GPP TS 36.423";
key id;
uses top3gpp:Top_Grp;
container attributes {
uses EP_X2CGrp;
}
}
}
augment "/me3gpp:ManagedElement/gnbcuup3gpp:GNBCUUPFunction" {
if-feature EPClassesUnderGNBCUUPFunction;
list EP_E1 {
description "Represents the local end point of the logical link,
supporting E1 interface between gNB-CU-CP and gNB-CU-UP.";
reference "3GPP TS 28.541, 3GPP TS 38.401";
key id;
uses top3gpp:Top_Grp;
container attributes {
uses EP_E1Grp;
}
}
list EP_F1U {
description "Represents the local end point of the user plane
interface (F1-U) between the gNB-DU and gNB-CU or gNB-CU-UP.";
reference "3GPP TS 28.541, 3GPP TS 38.470";
key id;
uses top3gpp:Top_Grp;
container attributes {
uses EP_F1UGrp;
}
}
list EP_NgU {
description "Represents the local end point of the NG user plane
(NG-U) interface between the gNB and UPF.";
reference "3GPP TS 28.541, 3GPP TS 38.470";
key id;
uses top3gpp:Top_Grp;
container attributes {
uses EP_NgUGrp;
}
}
list EP_XnU {
description "Represents the one end-point of a logical link supporting
the Xn user plane (Xn-U) interface. The Xn-U interface provides
non-guaranteed delivery of user plane PDUs between two NG-RAN nodes.";
reference "3GPP TS 28.541, 3GPP TS 38.420";
key id;
uses top3gpp:Top_Grp;
container attributes {
uses EP_XnUGrp;
}
}
list EP_X2U {
description "Represents the local end-point of a logical link supporting
the X2 user plane (X2-U) interface used in EN-DC.";
reference "3GPP TS 28.541, 3GPP TS 36.425";
key id;
uses top3gpp:Top_Grp;
container attributes {
uses EP_X2UGrp;
}
}
list EP_S1U {
description "Represents the local end point of the logical link,
supporting S1-U interface towards a S-GW node.";
reference "3GPP TS 28.541, 3GPP TS 36.410";
key id;
uses top3gpp:Top_Grp;
container attributes {
uses EP_S1UGrp;
}
}
}
augment "/me3gpp:ManagedElement/gnbdu3gpp:GNBDUFunction" {
if-feature EPClassesUnderGNBDUFunction;
list EP_F1C {
description "Represents the local end point of the control plane
interface (F1-C) between the DU and CU or CU-CP.";
reference "3GPP TS 28.541, 3GPP TS 38.470";
key id;
uses top3gpp:Top_Grp;
container attributes {
uses EP_F1CGrp;
}
}
list EP_F1U {
description "Represents the local end point of the user plane
interface (F1-U) between the DU and CU or CU-UP.";
reference "3GPP TS 28.541, 3GPP TS 38.470";
key id;
uses top3gpp:Top_Grp;
container attributes {
uses EP_F1UGrp;
}
}
}
}
<CODE ENDS>
E.5.3 module _3gpp-nr-nrm-eutrancellrelation.yang
<CODE BEGINS>
module _3gpp-nr-nrm-eutrancellrelation {
yang-version 1.1;
namespace "urn:3gpp:sa5:_3gpp-nr-nrm-eutrancellrelation";
prefix "eutrancellrel3gpp";
import _3gpp-common-yang-types { prefix types3gpp; }
import _3gpp-common-managed-function { prefix mf3gpp; }
import _3gpp-common-managed-element { prefix me3gpp; }
import _3gpp-nr-nrm-gnbcucpfunction { prefix gnbcucp3gpp; }
import _3gpp-nr-nrm-nrcellcu { prefix nrcellcu3gpp; }
import _3gpp-common-top { prefix top3gpp; }
organization "3GPP SA5";
description "Defines the YANG mapping of the EUtranCellRelation Information
Object Class (IOC) that is part of the NR Network Resource Model (NRM).";
reference "3GPP TS 28.541 5G Network Resource Model (NRM)";
revision 2019-10-28 { reference S5-193518 ; }
revision 2019-06-17 {
description "Initial revision";
}
typedef ActionAllowed {
type enumeration {
enum YES;
enum NO;
}
}
typedef EnergySavingCoverage {
type enumeration {
enum YES;
enum NO;
enum PARTIAL;
}
}
grouping EUtranCellRelationGrp {
description "Represents the EUtranCellRelation IOC.";
reference "3GPP TS 28.541, EUtranRelation in 3GPP TS 28.658";
uses mf3gpp:ManagedFunctionGrp;
leaf tCI {
description "Target Cell Identifier. Consists of E-UTRAN Cell Global
Identifier (ECGI) and Physical Cell Identifier (PCI) of the target
cell. Identifies the target cell from the perspective of the parent
cell instance.";
mandatory true;
type uint64;
}
leaf isRemoveAllowed {
description "Indicates if the subject EUtranCellRelation can be removed
(deleted) or not. If YES, the subject EUtranCellRelation instance can
be removed (deleted). If NO, the subject EUtranCellRelation instance
shall not be removed (deleted) by any entity but an IRPManager.";
mandatory true;
type ActionAllowed;
}
leaf isHOAllowed {
description "Indicates if handover is allowed or prohibited. If YES,
handover is allowed from source cell to target cell. Source cell is
represented by the parent cell instance. Target cell is the adjacent
cell referenced by this EUtranCellRelation instance. If NO, handover
shall not be allowed.";
mandatory true;
type ActionAllowed;
}
leaf isENDCAllowed {
description "Indicates if EN-DC is allowed or prohibited. If TRUE,
the target cell is allowed to be used for EN-DC. The target cell is
referenced by the NRCellRelation that contains this isENDCAllowed.
If FALSE, EN-DC shall not be allowed.";
mandatory true;
type ActionAllowed;
}
leaf isICICInformationSendAllowed {
description "Indicates if ICIC (Inter Cell Interference Coordination)
load information message sending is allowed or prohibited. If YES,
ICIC load information message sending is allowed from source cell to
target cell. Source cell is represented by the parent cell instance.
Target cell is the adjacent cell referenced by this EUtranCellRelation
instance. If NO, ICIC load information message sending shall not be
allowed.";
reference "3GPP TS 36.423";
mandatory true;
type ActionAllowed;
}
leaf isLBAllowed {
description "Indicates if load balancing is allowed or prohibited from
source cell to target cell. If YES, load balancing is allowed from
source cell to target cell. Source cell is represented by the parent
cell instance. Target cell is the adjacent cell referenced by this
EUtranCellRelation instance. If NO, load balancing shall be prohibited
from source cell to target cell.";
mandatory true;
type ActionAllowed;
}
leaf isESCoveredBy {
description "Indicates whether the adjacent cell according to this
planning provides no, partial or full coverage for the parent cell
instance. Adjacent cells with this attribute equal to YES are
recommended to be considered as candidate cells to take over the
coverage when the original cell is about to be transferred to energy
saving state. The entirety of adjacent cells with this property equal
to PARTIAL are recommended to be considered as entirety of candidate
cells to take over the coverage when the original cell is about to be
transferred to energy saving state.";
mandatory true;
type EnergySavingCoverage;
}
leaf qOffset {
description "Offset applicable to a specific neighbouring cell used for
evaluating the cell as a candidate for cell re-selection. Corresponds
to parameter q-OffsetCell broadcast in SIB4 for intra-frequency cells
and in SIB5 for inter-frequency cells. Used for Mobility Robustness
Optimization.";
reference "3GPP TS 36.331";
mandatory true;
type types3gpp:QOffsetRange;
}
leaf cellIndividualOffset {
description "Offset applicable to a neighbouring cell. It is used for
evaluating the neighbouring cell for handover in connected mode. Used
by the HandOver parameter Optimization (HOO) function or Load
Balancing Optimization (LBO) function.";
reference "3GPP TS 36.331";
config false;
type types3gpp:QOffsetRange;
}
leaf adjacentCell {
description "Reference to an EUtranCellFDD/TDD or
ExternalEUtranCellFDD/TDD instance.";
mandatory true;
type types3gpp:DistinguishedName;
}
}
augment /me3gpp:ManagedElement/gnbcucp3gpp:GNBCUCPFunction/nrcellcu3gpp:NRCellCU {
list EUtranCellRelation {
description "Represents a relation between an NR cell and an E-UTRAN cell.";
reference "3GPP TS 28.541";
key id;
uses top3gpp:Top_Grp;
container attributes {
uses EUtranCellRelationGrp;
}
uses mf3gpp:ManagedFunctionContainedClasses;
}
}
}
<CODE ENDS>
E.5.4 module _3gpp-nr-nrm-eutranetwork.yang
<CODE BEGINS>
module _3gpp-nr-nrm-eutranetwork {
yang-version 1.1;
namespace "urn:3gpp:sa5:_3gpp-nr-nrm-eutranetwork";
prefix "eutranet3gpp";
import _3gpp-common-subnetwork { prefix subnet3gpp; }
import _3gpp-common-top { prefix top3gpp; }
organization "3GPP SA5";
description "Defines the YANG mapping of the EUtraNetwork Information Object
Class (IOC) that is part of the NR Network Resource Model (NRM).";
reference "3GPP TS 28.541 5G Network Resource Model (NRM)";
revision 2019-06-17 {
description "Initial revision";
}
feature ExternalsUnderEUtraNetwork {
description "Classes representing external entities like EUtranFrequency,
ExternalENBFunction are contained under a EUtraNetwork list/class.";
}
grouping EUtraNetworkGrp {
description "Represents the EUtraNetwork IOC.";
reference "3GPP TS 28.541";
uses subnet3gpp:SubNetworkGrp;
}
list EUtraNetwork {
description "A subnetwork containing gNB external E-UTRAN entities.";
reference "3GPP TS 28.541";
key id;
uses top3gpp:Top_Grp;
container attributes {
uses EUtraNetworkGrp;
leaf-list parents {
description "Reference to all containg EUtraNetwork instances
in strict order from the root EUtraNetwork down to the immediate
parent EUtraNetwork.
If EUtraNetworks form a containment hierarchy this is
modeled using references between the child EUtraNetwork and the parent
EUtraNetworks.
This reference MUST NOT be present for the top level EUtraNetwork and
MUST be present for other EUtraNetworks.";
type leafref {
path "../../../EUtraNetwork/id";
}
}
leaf-list containedChildren{
description "Reference to all directly contained EUtraNetwork instances.
If EUtraNetworks form a containment hierarchy this is
modeled using references between the child EUtraNetwork and the parent
EUtraNetwork.";
type leafref {
path "../../../EUtraNetwork/id";
}
}
}
}
}
<CODE ENDS>
E.5.5 module _3gpp-nr-nrm-eutranfreqrelation.yang
<CODE BEGINS>
module _3gpp-nr-nrm-eutranfreqrelation {
yang-version 1.1;
namespace "urn:3gpp:sa5:_3gpp-nr-nrm-eutranfreqrelation";
prefix "eutranfreqrel3gpp";
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; }
import _3gpp-nr-nrm-gnbcucpfunction { prefix gnbcucp3gpp; }
import _3gpp-nr-nrm-nrcellcu { prefix nrcellcu3gpp; }
organization "3GPP SA5";
description "Defines the YANG mapping of the EUtranFreqRelation Information
Object Class (IOC) that is part of the NR Network Resource Model (NRM).";
reference "3GPP TS 28.541 5G Network Resource Model (NRM)";
revision 2019-10-28 { reference S5-193518 ; }
revision 2019-06-17 {
description "Initial revision";
}
grouping EUtranFreqRelationGrp {
description "Represents the EUtranFreqRelation IOC.";
reference "3GPP TS 28.541";
uses mf3gpp:ManagedFunctionGrp;
leaf cellIndividualOffset {
description "Offset applicable to a neighbouring cell. Used for
evaluating the neighbouring cell for handover in connected mode.
Used by the HandOver parameter Optimization (HOO) function or
Load Balancing Optimization (LBO) function.";
reference "cellIndividualOffset in MeasObjectEUTRA in 3GPP TS 38.331";
default 0;
type types3gpp:QOffsetRange;
}
leaf-list blackListEntry {
description "A list of Physical Cell Identities (PCIs) that are
blacklisted in E-UTRAN measurements.";
reference "3GPP TS 38.331";
min-elements 0;
type uint16 { range "0..1007"; }
}
leaf-list blackListEntryIdleMode {
description "A list of Physical Cell Identities (PCIs) that are
blacklisted in SIB4 and SIB5.";
min-elements 0;
type uint16 { range "0..1007"; }
}
leaf cellReselectionPriority {
description "The absolute priority of the carrier frequency used by the
cell reselection procedure. Value 0 means lowest priority. The value
must not already used by other RAT, i.e. equal priorities between RATs
are not supported. The UE behaviour when no value is entered is
specified in subclause 5.2.4.1 of 3GPP TS 38.304.";
reference "CellReselectionPriority in 3GPP TS 38.331, priority in
3GPP TS 38.304";
mandatory true;
type int32 { range "0..7"; }
}
leaf cellReselectionSubPriority {
description "Indicates a fractional value to be added to the value of
cellReselectionPriority to obtain the absolute priority of the
concerned carrier frequency for E-UTRA and NR.";
reference "3GPP TS 38.331";
type uint8 { range "2 | 4 | 6 | 8"; }
units "0.1";
}
leaf pMax {
description "Used for calculation of the parameter Pcompensation
(defined in 3GPP TS 38.304), at cell reselection to a cell.";
reference "PEMAX in 3GPP TS 38.101-1";
mandatory true;
type int32 { range "-30..33"; }
units dBm;
}
leaf qOffsetFreq {
description "The frequency specific offset applied when evaluating
candidates for cell reselection.";
type int32;
default 0;
}
leaf qQualMin {
description "Indicates the minimum required quality level in the cell.
Value 0 means that it is not sent and UE applies in such case the
(default) value of negative infinity for Qqualmin. Sent in SIB3 or
SIB5.";
reference "qQualMin in TS 38.304";
mandatory true;
type int32 { range "-34..-3 | 0"; }
units dB;
}
leaf qRxLevMin {
description "Indicates the required minimum received Reference Symbol
Received Power (RSRP) level in the (E-UTRA) frequency for cell
reselection. Broadcast in SIB3 or SIB5, depending on whether the
related frequency is intra- or inter-frequency. Resolution is 2.";
reference "Qrxlevmin in 3GPP TS 38.304";
mandatory true;
type int32 { range "-140..-44"; }
units dBm;
}
leaf threshXHighP {
description "Specifies the Srxlev threshold used by the UE when
reselecting towards a higher priority RAT/frequency than the current
serving frequency. Each frequency of NR and E-UTRAN might have a
specific threshold. Resolution is 2.";
reference "ThreshX, HighP in 3GPP TS 38.304";
mandatory true;
type int32 { range "0..62"; }
units dB;
}
leaf threshXHighQ {
description "Specifies the Squal threshold used by the UE when
reselecting towards a higher priority RAT/frequency than the current
serving frequency. Each frequency of NR and E-UTRAN might have a
specific threshold.";
reference "ThreshX, HighQ in 3GPP TS 38.304";
mandatory true;
type int32 { range 0..31; }
units dB;
}
leaf threshXLowP {
description "Specifies the Srxlev threshold used by the UE when
reselecting towards a lower priority RAT/frequency than the current
serving frequency. Each frequency of NR and E-UTRAN might have a
specific threshold. Resolution is 2.";
reference "ThreshX, LowP in 3GPP TS 38.304";
mandatory true;
type int32 { range "0..62"; }
units dB;
}
leaf threshXLowQ {
description "Specifies the Squal threshold used by the UE when
reselecting towards a lower priority RAT/frequency than the current
serving frequency. Each frequency of NR and E-UTRAN might have a
specific threshold.";
reference "ThreshX, LowQ in 3GPP TS 38.304";
mandatory false;
type int32 { range "0..31"; }
units dB;
}
leaf tReselectionEutra {
description "Cell reselection timer for intra frequency E-UTRA cell
reselection. May be used for Mobility Robustness Optimization.";
reference "t-ReselectionEUTRA in 3GPP TS 36.331 and in 3GPP TS 23.207";
mandatory true;
type uint8 { range "0..7"; }
units s;
}
leaf tReselectionEutraSfHigh {
description "The attribute tReselectionEutra (parameter TreselectionEUTRA
in 3GPP TS 38.304) multiplied with this scaling factor if the UE is in
high mobility state.";
reference "Speed dependent ScalingFactor for TreselectionEUTRA for high
mobility state in 3GPP TS 38.304";
mandatory true;
type uint8 { range "25 | 50 | 75 | 100"; }
units %;
}
leaf tReselectionEutraSfMedium {
description "The attribute tReselectionEutra (parameter TreselectionEUTRA
in 3GPP TS 38.304) multiplied with this scaling factor if the UE is in
medium mobility state.";
reference "Speed dependent ScalingFactor for TreselectionEUTRA for medium
mobility state in 3GPP TS 38.304";
mandatory true;
type uint8 { range "25 | 50 | 75 | 100"; }
units %;
}
leaf eUtranFrequencyRef {
description "Reference to a corresponding EUtranFrequency instance.";
mandatory true;
type types3gpp:DistinguishedName;
}
}
augment /me3gpp:ManagedElement/gnbcucp3gpp:GNBCUCPFunction/nrcellcu3gpp:NRCellCU {
list EUtranFreqRelation {
description "Represents a frequency relation between an NR cell and an
E-UTRAN cell.";
reference "3GPP TS 28.541";
key id;
uses top3gpp:Top_Grp;
container attributes {
uses EUtranFreqRelationGrp;
}
uses mf3gpp:ManagedFunctionContainedClasses;
}
}
}
<CODE ENDS>
E.5.6 module _3gpp-nr-nrm-eutranfrequency.yang
<CODE BEGINS>
module _3gpp-nr-nrm-eutranfrequency {
yang-version 1.1;
namespace "urn:3gpp:sa5:_3gpp-nr-nrm-eutranfrequency";
prefix "eutraneteutranfreq3gpp";
import _3gpp-common-managed-function { prefix mf3gpp; }
import _3gpp-nr-nrm-eutranetwork { prefix eutranet3gpp; }
import _3gpp-common-subnetwork { prefix subnet3gpp; }
import _3gpp-common-top { prefix top3gpp; }
organization "3GPP SA5";
description "Defines the YANG mapping of the EUtranFrequency Information
Object Class (IOC), that is part of the NR Network Resource Model (NRM).";
reference "3GPP TS 28.541 5G Network Resource Model (NRM),
3GPP TS 28.658 (E-UTRAN) Network Resource Model (NRM)";
revision 2019-10-28 { reference S5-193518 ; }
revision 2019-06-17 {
description "Initial revision";
}
grouping EUtranFrequencyGrp {
description "Represents the EUtranFrequency IOC.";
reference "3GPP TS 28.541";
uses mf3gpp:ManagedFunctionGrp;
leaf earfcnDL {
description "Specifies the channel number for the central DL frequency.";
reference "3GPP TS 36.101";
mandatory true;
type uint32 { range "0..262143"; }
}
leaf-list multiBandInfoListEutra {
description "List of additional frequency bands the frequency belongs to.";
config false;
min-elements 0;
type uint16 { range "1..256"; }
}
}
grouping EUtranFrequencyWrapper {
list EUtranFrequency {
description "Represents certain E-UTRAN frequency properties.";
reference "3GPP TS 28.658";
key id;
uses top3gpp:Top_Grp;
container attributes {
uses EUtranFrequencyGrp;
}
uses mf3gpp:ManagedFunctionContainedClasses;
}
}
augment "/subnet3gpp:SubNetwork" {
if-feature subnet3gpp:ExternalsUnderSubNetwork ;
uses EUtranFrequencyWrapper ;
}
augment "/eutranet3gpp:EUtraNetwork" {
if-feature eutranet3gpp:ExternalsUnderEUtraNetwork;
uses EUtranFrequencyWrapper ;
}
}
<CODE ENDS>
E.5.7 module _3gpp-nr-nrm-externalamffunction.yang
<CODE BEGINS>
module _3gpp-nr-nrm-externalamffunction {
yang-version 1.1;
namespace "urn:3gpp:sa5:_3gpp-nr-nrm-externalamffunction";
prefix "extamf3gpp";
import _3gpp-common-managed-function { prefix mf3gpp; }
import _3gpp-common-subnetwork { prefix subnet3gpp; }
import _3gpp-nr-nrm-nrnetwork { prefix nrnet3gpp; }
import _3gpp-common-top { prefix top3gpp; }
import _3gpp-common-yang-types { prefix types3gpp; }
organization "3GPP SA5";
description "Defines the YANG mapping of the ExternalAMFFunction Information
Object Class (IOC) that is part of the NR Network Resource Model (NRM).";
reference "3GPP TS 28.541 5G Network Resource Model (NRM)";
revision 2019-10-28 { reference S5-193518 ; }
revision 2019-06-17 {
description "Initial revision";
}
grouping ExternalAMFFunctionGrp {
description "Represents the ExternalAMFFunction IOC.";
reference "3GPP TS 28.541";
uses mf3gpp:ManagedFunctionGrp;
list pLMNIdList {
description "List of at most six entries of PLMN Identifiers, but at least
one (the primary PLMN Id).
The PLMN Identifier is composed of a Mobile Country Code (MCC) and a
Mobile Network Code (MNC).";
min-elements 1;
max-elements 6;
key "mcc mnc";
uses types3gpp:PLMNId;
}
container aMFIdentifier {
presence true;
description "An AMF identifier, comprising an AMF Region ID, an AMF Set ID and an AMF Pointer.";
uses types3gpp:AmfIdentifier;
}
}
grouping ExternalAMFFunctionWrapper {
list ExternalAMFFunction {
description "Represents the properties, known by the management
function, of a AMFFunction managed by another management
function.";
reference "3GPP TS 28.541";
key id;
uses top3gpp:Top_Grp;
container attributes {
uses ExternalAMFFunctionGrp;
}
uses mf3gpp:ManagedFunctionContainedClasses;
}
}
augment "/subnet3gpp:SubNetwork" {
if-feature subnet3gpp:ExternalsUnderSubNetwork ;
uses ExternalAMFFunctionWrapper;
}
augment "/nrnet3gpp:NRNetwork" {
if-feature nrnet3gpp:ExternalsUnderNRNetwork;
uses ExternalAMFFunctionWrapper;
}
}
<CODE ENDS>
E.5.8 module _3gpp-nr-nrm-externalenbfunction.yang
<CODE BEGINS>
module _3gpp-nr-nrm-externalenbfunction {
yang-version 1.1;
namespace "urn:3gpp:sa5:_3gpp-nr-nrm-externalenbfunction";
prefix "extenb3gpp";
import _3gpp-common-managed-function { prefix mf3gpp; }
import _3gpp-nr-nrm-eutranetwork { prefix eutranet3gpp; }
import _3gpp-common-subnetwork { prefix subnet3gpp; }
import _3gpp-common-top { prefix top3gpp; }
organization "3GPP SA5";
description "Defines the YANG mapping of the ExternalENBFunction
Information Object Class (IOC) that is part of the NR Network Resource
Model (NRM).";
reference "3GPP TS 28.541 5G Network Resource Model (NRM),
3GPP TS 28.658 (E-UTRAN) Network Resource Model (NRM)";
revision 2019-10-28 { reference S5-193518 ; }
revision 2019-06-17 {
description "Initial revision";
}
grouping ExternalENBFunctionGrp {
description "Represets the ExternalENBFunction IOC.";
reference "3GPP TS 28.658";
uses mf3gpp:ManagedFunctionGrp;
leaf eNBId {
description "Unambiguously identifies an eNodeB within a PLMN.";
reference "3GPP TS 36.413, 3GPP TS 36.300";
mandatory true;
type int32 { range "0..268435455"; } // Representing 28 bit eNB ID.
// 18, 20 and 21 bit eNB IDs also
// allowed.
}
}
grouping ExternalENBFunctionWrapper {
list ExternalENBFunction {
description "Represents an external eNB functionality.";
reference "3GPP TS 28.658";
key id;
uses top3gpp:Top_Grp;
container attributes {
uses ExternalENBFunctionGrp;
}
uses mf3gpp:ManagedFunctionContainedClasses;
}
}
augment "/subnet3gpp:SubNetwork" {
if-feature subnet3gpp:ExternalsUnderSubNetwork ;
uses ExternalENBFunctionWrapper;
}
augment "/eutranet3gpp:EUtraNetwork" {
if-feature eutranet3gpp:ExternalsUnderEUtraNetwork;
uses ExternalENBFunctionWrapper;
}
}
<CODE ENDS>
E.5.9 module _3gpp-nr-nrm-externaleutrancell.yang
<CODE BEGINS>
module _3gpp-nr-nrm-externaleutrancell {
yang-version 1.1;
namespace "urn:3gpp:sa5:_3gpp-nr-nrm-externaleutrancell";
prefix "exteutrancell3gpp";
import _3gpp-common-yang-types { prefix types3gpp; }
import _3gpp-common-managed-function { prefix mf3gpp; }
import _3gpp-common-subnetwork { prefix subnet3gpp; }
import _3gpp-nr-nrm-eutranetwork { prefix eutranet3gpp; }
import _3gpp-nr-nrm-externalenbfunction { prefix extenb3gpp; }
import _3gpp-common-top { prefix top3gpp; }
organization "3GPP SA5";
description "Defines the YANG mapping of the ExternalEUtranCellFDD and
ExternalEUtranCellTDD Information Object Classes (IOCs) that are part
of the NR Network Resource Model (NRM).";
reference "3GPP TS 28.541 5G Network Resource Model (NRM),
3GPP TS 28.658 (E-UTRAN) Network Resource Model (NRM)";
revision 2019-10-28 { reference S5-193518 ; }
revision 2019-06-17 {
description "Initial revision";
}
grouping ExternalEUtranGenericCellGrp {
description "Represents the ExternalEUtranGenericCell IOC.";
reference "3GPP TS 28.658";
uses mf3gpp:ManagedFunctionGrp;
leaf pci {
description "The Physical Cell Identity (PCI) of the cell (for
NM-Centralized, EM-Centralized and Distributed PCI assignment cases).
In the case of NM-Centralized PCI assignment, see 3GPP TS 36.300.";
reference "3GPP TS 36.211";
mandatory true;
type int32 { range "0..503"; }
}
list plmnIdList {
description "List of unique identities for PLMNs. A cell can broadcast
up to 6 PLMN IDs. This is to support the case that one cell can be
used by up to 6 operator’s core networks. The PLMN(s) included in this
list will use the same single tracking area code (TAC) and the same
Cell Identity (cellLocalId) for sharing the radio access network
resources. One member of plmnIdList is the primary PLMN ID. A PLMN ID
included in this list cannot be included in the cellAccessInfoList.
The PLMN ID is composed of a Mobile Country Code (MCC) and a Mobile
Network Code (MNC).";
reference "3GPP TS 36.300, 3GPP TS 36.331, 3GPP TS 23.003";
key "mcc mnc";
min-elements 1;
max-elements 6;
uses types3gpp:PLMNId;
}
leaf cellLocalId {
description "Unambiguously identifies a cell within an eNodeB.";
reference "NCI defined in 3GPP TS 38.300";
type int32 {range "0..255"; }
}
leaf eNBId {
description "Unambiguously identifies an eNodeB within a PLMN.";
reference "3GPP TS 36.413, 3GPP TS 36.300";
mandatory true;
type int32 { range "0..268435455"; } // Representing 28 bit eNB ID.
// 18, 20 and 21 bit eNB IDs also
// allowed.
}
}
grouping ExternalEUtranCellFDDGrp {
description "Represents the ExternalEUtranCellFDD IOC.";
reference "3GPP TS 28.658";
uses ExternalEUtranGenericCellGrp;
leaf earfcnDL {
description "The channel number for the central DL frequency.";
reference "3GPP TS 36.101";
mandatory true;
type int32 { range "0..17999 | 46590..262143"; }
}
leaf earfcnUL {
description "The channel number for the central UL frequency. Value 0
means that the UL channel number is N/A for the DL-only bands.";
reference "3GPP TS 36.101";
mandatory true;
type int32 { range "0 | 18000..35999 | 46590..262143"; }
}
}
grouping ExternalEUtranCellTDDGrp {
description "Represents the ExternalEUtranCellTDD IOC.";
reference "3GPP TS 28.658";
uses ExternalEUtranGenericCellGrp;
leaf earfcn {
description "The frequency number for the central frequency.";
reference "3GPP TS 36.104";
mandatory true;
type int32 { range "36000..262143"; }
}
}
grouping ExternalEUtranCellFDDWrapper {
list ExternalEUtranCellFDD {
description "Represents the common properties of external E-UTRAN FDD
cell provided by eNB or NG-RAN FDD cell provided by ng-eNB.";
reference "3GPP TS 28.658";
key id;
uses top3gpp:Top_Grp;
container attributes {
uses ExternalEUtranCellFDDGrp;
}
uses mf3gpp:ManagedFunctionContainedClasses;
}
}
grouping ExternalEUtranCellTDDWrapper {
list ExternalEUtranCellTDD {
description "Represents the common properties of external E-UTRAN cell
TDD provided by eNB or NG-RAN TDD cell provided by ng-eNB.";
reference "3GPP TS 28.658";
key id;
uses top3gpp:Top_Grp;
container attributes {
uses ExternalEUtranCellTDDGrp;
}
uses mf3gpp:ManagedFunctionContainedClasses;
}
}
augment "/subnet3gpp:SubNetwork/extenb3gpp:ExternalENBFunction" {
if-feature subnet3gpp:ExternalsUnderSubNetwork;
uses ExternalEUtranCellFDDWrapper;
}
augment "/eutranet3gpp:EUtraNetwork/extenb3gpp:ExternalENBFunction" {
if-feature eutranet3gpp:ExternalsUnderEUtraNetwork;
uses ExternalEUtranCellFDDWrapper;
}
augment "/subnet3gpp:SubNetwork/extenb3gpp:ExternalENBFunction" {
if-feature subnet3gpp:ExternalsUnderSubNetwork;
uses ExternalEUtranCellTDDWrapper;
}
augment "/eutranet3gpp:EUtraNetwork/extenb3gpp:ExternalENBFunction" {
if-feature eutranet3gpp:ExternalsUnderEUtraNetwork;
uses ExternalEUtranCellTDDWrapper;
}
}
<CODE ENDS>
E.5.10 module _3gpp-nr-nrm-externalgnbcucpfunction.yang
<CODE BEGINS>
module _3gpp-nr-nrm-externalgnbcucpfunction {
yang-version 1.1;
namespace "urn:3gpp:sa5:_3gpp-nr-nrm-externalgnbcucpfunction";
prefix "extgnbcucp3gpp";
import _3gpp-common-yang-types { prefix types3gpp; }
import _3gpp-common-managed-function { prefix mf3gpp; }
import _3gpp-nr-nrm-nrnetwork { prefix nrnet3gpp; }
import _3gpp-common-subnetwork { prefix subnet3gpp; }
import _3gpp-common-top { prefix top3gpp; }
organization "3GPP SA5";
description "Defines the YANG mapping of the ExternalGNBCUCPFunction
Information Object Class (IOC), that is part of the NR Network Resource
Model (NRM).";
reference "3GPP TS 28.541 5G Network Resource Model (NRM)";
revision 2019-10-28 { reference S5-193518 ; }
revision 2019-06-17 {
description "Initial revision";
}
grouping ExternalGNBCUCPFunctionGrp {
description "Represets the ExternalGNBCUCPFunction IOC.";
reference "3GPP TS 28.541";
uses mf3gpp:ManagedFunctionGrp;
leaf gNBId {
description "Identifies a gNB within a PLMN.";
reference "gNB Identifier (gNB ID) in 3GPP TS 38.300, Global gNB ID
in 3GPP TS 38.413";
mandatory true;
type int64 { range "0..4294967295"; }
}
leaf gNBIdLength {
description "Indicates the number of bits for encoding the gNB ID.";
reference "gNB ID in 3GPP TS 38.300, Global gNB ID in 3GPP TS 38.413";
mandatory true;
type int32 { range "22..32"; }
}
list pLMNId {
description "Specifies the PLMN identifier to be used as part of the
global RAN node identity.";
key "mcc mnc";
min-elements 1;
max-elements 1;
uses types3gpp:PLMNId;
}
}
grouping ExternalGNBCUCPFunctionWrapper {
list ExternalGNBCUCPFunction {
description "Represents the properties, known by the management function,
of a GNBCUCPFunction managed by another management function.";
reference "3GPP TS 28.541";
key id;
uses top3gpp:Top_Grp;
container attributes {
uses ExternalGNBCUCPFunctionGrp;
}
uses mf3gpp:ManagedFunctionContainedClasses;
}
}
augment "/subnet3gpp:SubNetwork" {
if-feature subnet3gpp:ExternalsUnderSubNetwork ;
uses ExternalGNBCUCPFunctionWrapper;
}
augment "/nrnet3gpp:NRNetwork" {
if-feature nrnet3gpp:ExternalsUnderNRNetwork;
uses ExternalGNBCUCPFunctionWrapper;
}
}
<CODE ENDS>
E.5.11 module _3gpp-nr-nrm-externalgnbcuupfunction.yang
<CODE BEGINS>
module _3gpp-nr-nrm-externalgnbcuupfunction {
yang-version 1.1;
namespace "urn:3gpp:sa5:_3gpp-nr-nrm-externalgnbcuupfunction";
prefix "extgnbcuup3gpp";
import _3gpp-common-managed-function { prefix mf3gpp; }
import _3gpp-nr-nrm-nrnetwork { prefix nrnet3gpp; }
import _3gpp-common-subnetwork { prefix subnet3gpp; }
import _3gpp-common-top { prefix top3gpp; }
organization "3GPP SA5";
description "Defines the YANG mapping of the ExternalGNBCUUPFunction
Information Object Class (IOC), that is part of the NR Network
Resource Model (NRM).";
reference "3GPP TS 28.541 5G Network Resource Model (NRM)";
revision 2019-10-28 { reference S5-193518 ; }
revision 2019-06-17 {
description "Initial revision";
}
grouping ExternalGNBCUUPFunctionGrp {
description "Represets the ExternalGNBCUUPFunction IOC.";
reference "3GPP TS 28.541";
uses mf3gpp:ManagedFunctionGrp;
leaf gNBId {
description "Identifies a gNB within a PLMN.";
reference "gNB Identifier (gNB ID) in 3GPP TS 38.300, Global gNB ID
in 3GPP TS 38.413";
mandatory true;
type int64 { range "0..4294967295"; }
}
leaf gNBIdLength {
description "Indicates the number of bits for encoding the gNB ID.";
reference "gNB ID in 3GPP TS 38.300, Global gNB ID in 3GPP TS 38.413";
mandatory true;
type int32 { range "22..32"; }
}
}
grouping ExternalGNBCUUPFunctionWrapper {
list ExternalGNBCUUPFunction {
description "Represents the properties, known by the management function,
of a GNBCUUPFunction managed by another management function.";
reference "3GPP TS 28.541";
key id;
uses top3gpp:Top_Grp;
container attributes {
uses ExternalGNBCUUPFunctionGrp;
}
uses mf3gpp:ManagedFunctionContainedClasses;
}
}
augment "/subnet3gpp:SubNetwork" {
if-feature subnet3gpp:ExternalsUnderSubNetwork ;
uses ExternalGNBCUUPFunctionWrapper;
}
augment "/nrnet3gpp:NRNetwork" {
if-feature nrnet3gpp:ExternalsUnderNRNetwork;
uses ExternalGNBCUUPFunctionWrapper;
}
}
<CODE ENDS>
E.5.12 module _3gpp-nr-nrm-externalgnbdufunction.yang
<CODE BEGINS>
module _3gpp-nr-nrm-externalgnbdufunction {
yang-version 1.1;
namespace "urn:3gpp:sa5:_3gpp-nr-nrm-externalgnbdufunction";
prefix "extgnbdu3gpp";
import _3gpp-common-yang-types { prefix types3gpp; }
import _3gpp-common-managed-function { prefix mf3gpp; }
import _3gpp-nr-nrm-nrnetwork { prefix nrnet3gpp; }
import _3gpp-common-subnetwork { prefix subnet3gpp; }
import _3gpp-common-top { prefix top3gpp; }
organization "3GPP SA5";
description "Defines the YANG mapping of the ExternalGNBDUFunction
Information Object Class (IOC) that is part of the NR Network Resource
Model (NRM).";
reference "3GPP TS 28.541 5G Network Resource Model (NRM)";
revision 2019-10-28 { reference S5-193518 ; }
revision 2019-06-17 {
description "Initial revision";
}
grouping ExternalGNBDUFunctionGrp {
description "Represets the ExternalGNBDUFunction IOC.";
reference "3GPP TS 28.541";
uses mf3gpp:ManagedFunctionGrp;
leaf gNBId {
description "Identifies a gNB within a PLMN.";
reference "gNB Identifier (gNB ID) in 3GPP TS 38.300, Global gNB ID
in 3GPP TS 38.413";
mandatory true;
type int64 { range "0..4294967295"; }
}
leaf gNBIdLength {
description "Indicates the number of bits for encoding the gNB ID.";
reference "gNB ID in 3GPP TS 38.300, Global gNB ID in 3GPP TS 38.413";
mandatory true;
type int32 { range "22..32"; }
}
list pLMNId {
description "Specifies the PLMN identifier to be used as part of the
global RAN node identity.";
key "mcc mnc";
min-elements 1;
max-elements 1;
uses types3gpp:PLMNId;
}
}
grouping ExternalGNBDUFunctionWrapper {
list ExternalGNBDUFunction {
description "Represents the properties, known by the management function,
of a GNBDUFunction managed by another management function.";
reference "3GPP TS 28.541";
key id;
uses top3gpp:Top_Grp;
container attributes {
uses ExternalGNBDUFunctionGrp;
}
uses mf3gpp:ManagedFunctionContainedClasses;
}
}
augment "/subnet3gpp:SubNetwork" {
if-feature subnet3gpp:ExternalsUnderSubNetwork ;
uses ExternalGNBDUFunctionWrapper;
}
augment "/nrnet3gpp:NRNetwork" {
if-feature nrnet3gpp:ExternalsUnderNRNetwork;
uses ExternalGNBDUFunctionWrapper;
}
}
<CODE ENDS>
E.5.13 module _3gpp-nr-nrm-externalnrcellcu.yang
<CODE BEGINS>
module _3gpp-nr-nrm-externalnrcellcu {
yang-version 1.1;
namespace "urn:3gpp:sa5:_3gpp-nr-nrm-externalnrcellcu";
prefix "extnrcellcu3gpp";
import _3gpp-common-yang-types { prefix types3gpp; }
import _3gpp-common-managed-function { prefix mf3gpp; }
import _3gpp-nr-nrm-nrnetwork { prefix nrnet3gpp; }
import _3gpp-common-subnetwork { prefix subnet3gpp; }
import _3gpp-nr-nrm-externalgnbcucpfunction { prefix extgnbcucp3gpp; }
import _3gpp-common-top { prefix top3gpp; }
organization "3GPP SA5";
description "Defines the YANG mapping of the ExternalNRCellCU Information
Object Class (IOC), that is part of the NR Network Resource Model (NRM).";
reference "3GPP TS 28.541 5G Network Resource Model (NRM)";
revision 2019-10-28 { reference S5-193518 ; }
revision 2019-06-17 {
description "Initial revision";
}
grouping ExternalNRCellCUGrp {
description "Represents the ExternalNRCellCU IOC.";
reference "3GPP TS 28.541";
uses mf3gpp:ManagedFunctionGrp;
leaf cellLocalId {
description "Identifies an NR cell of a gNB. Together with corresponding
gNB ID it forms the NR Cell Identifier (NCI).";
reference "NCI in 3GPP TS 38.300";
mandatory true;
type int32 {range "0..16383"; }
}
leaf nRPCI {
description "The Physical Cell Identity (PCI) of the NR cell.";
reference "3GPP TS 36.211";
mandatory true;
type int32 { range "0..1007"; }
}
list pLMNIdList {
description "Defines which PLMNs that are assumed to be served by the
NR cell in another gNB CU-CP. This list is either updated by the
managed element itself (e.g. due to ANR, signalling over Xn, etc.) or
by consumer over the standard interface.";
key "mcc mnc";
min-elements 1;
max-elements 12;
uses types3gpp:PLMNId;
}
leaf nRFrequencyRef {
description "Reference to corresponding NRFrequency instance.";
mandatory true;
type types3gpp:DistinguishedName;
}
}
grouping ExternalNRCellCUWrapper {
list ExternalNRCellCU {
description "Represents the properties of an NRCellCU controlled by
another Management Service Provider.";
reference "3GPP TS 28.541";
key id;
uses top3gpp:Top_Grp;
container attributes {
uses ExternalNRCellCUGrp;
}
uses mf3gpp:ManagedFunctionContainedClasses;
}
}
augment "/subnet3gpp:SubNetwork/extgnbcucp3gpp:ExternalGNBCUCPFunction" {
if-feature subnet3gpp:ExternalsUnderSubNetwork ;
uses ExternalNRCellCUWrapper;
}
augment "/nrnet3gpp:NRNetwork/extgnbcucp3gpp:ExternalGNBCUCPFunction" {
if-feature nrnet3gpp:ExternalsUnderNRNetwork;
uses ExternalNRCellCUWrapper;
}
}
<CODE ENDS>
E.5.14 module _3gpp-nr-nrm-externalservinggwfunction.yang
<CODE BEGINS>
module _3gpp-nr-nrm-externalservinggwfunction {
yang-version 1.1;
namespace "urn:3gpp:sa5:_3gpp-nr-nrm-externalservinggwfunction";
prefix "extservgw3gpp";
import _3gpp-common-managed-function { prefix mf3gpp; }
import _3gpp-common-subnetwork { prefix subnet3gpp; }
import _3gpp-nr-nrm-eutranetwork { prefix eutranet3gpp; }
import _3gpp-common-top { prefix top3gpp; }
organization "3GPP SA5";
description "Defines the YANG mapping of the ExternalServingGWFunction
Information Object Class (IOC) that is part of the NR Network Resource
Model (NRM).";
reference "3GPP TS 28.541 5G Network Resource Model (NRM)";
revision 2019-10-28 { reference S5-193518 ; }
revision 2019-06-17 {
description "Initial revision";
}
grouping ExternalServingGWFunctionGrp {
description "Represents the ExternalServingGWFunction IOC.";
reference "3GPP TS 28.541";
uses mf3gpp:ManagedFunctionGrp;
}
grouping ExternalServingGWFunctionWrapper {
list ExternalServingGWFunction {
description "Represents the properties, known by the management
function, of a ServingGWFunction managed by another management
function.";
reference "3GPP TS 28.658";
key id;
uses top3gpp:Top_Grp;
container attributes {
uses ExternalServingGWFunctionGrp;
}
uses mf3gpp:ManagedFunctionContainedClasses;
}
}
augment "/subnet3gpp:SubNetwork" {
if-feature subnet3gpp:ExternalsUnderSubNetwork ;
uses ExternalServingGWFunctionWrapper;
}
augment "/eutranet3gpp:EUtraNetwork" {
if-feature eutranet3gpp:ExternalsUnderEUtraNetwork;
uses ExternalServingGWFunctionWrapper;
}
}
<CODE ENDS>
E.5.15 module _3gpp-nr-nrm-externalupffunction.yang
<CODE BEGINS>
module _3gpp-nr-nrm-externalupffunction {
yang-version 1.1;
namespace "urn:3gpp:sa5:_3gpp-nr-nrm-externalupffunction";
prefix "extupf3gpp";
import _3gpp-common-managed-function { prefix mf3gpp; }
import _3gpp-common-subnetwork { prefix subnet3gpp; }
import _3gpp-nr-nrm-nrnetwork { prefix nrnet3gpp; }
import _3gpp-common-top { prefix top3gpp; }
organization "3GPP SA5";
description "Defines the YANG mapping of the ExternalUPFFunction Information
Object Class (IOC) that is part of the NR Network Resource Model (NRM).";
reference "3GPP TS 28.541 5G Network Resource Model (NRM)";
revision 2019-10-28 { reference S5-193518 ; }
revision 2019-06-17 {
description "Initial revision";
}
grouping ExternalUPFFunctionGrp {
description "Represents the ExternalUPFFunction IOC.";
reference "3GPP TS 28.541";
uses mf3gpp:ManagedFunctionGrp;
}
grouping ExternalUPFFunctionWrapper {
list ExternalUPFFunction {
description "Represents the properties, known by the management
function, of a UPFFunction managed by another management
function.";
reference "3GPP TS 28.541";
key id;
uses top3gpp:Top_Grp;
container attributes {
uses ExternalUPFFunctionGrp;
}
uses mf3gpp:ManagedFunctionContainedClasses;
}
}
augment "/subnet3gpp:SubNetwork" {
if-feature subnet3gpp:ExternalsUnderSubNetwork ;
uses ExternalUPFFunctionWrapper;
}
augment "/nrnet3gpp:NRNetwork" {
if-feature nrnet3gpp:ExternalsUnderNRNetwork;
uses ExternalUPFFunctionWrapper;
}
}
<CODE ENDS>
E.5.16 module _3gpp-nr-nrm-gnbcucpfunction.yang
<CODE BEGINS>
module _3gpp-nr-nrm-gnbcucpfunction {
yang-version 1.1;
namespace "urn:3gpp:sa5:_3gpp-nr-nrm-gnbcucpfunction";
prefix "gnbcucp3gpp";
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 GNBCUCPFunction Information
Object Class (IOC) that is part of the NR Network Resource Model (NRM).";
reference "3GPP TS 28.541 5G Network Resource Model (NRM)";
revision 2022-07-28 { reference "CR-0770"; }
revision 2021-11-06 { reference "CR-0611"; }
revision 2021-11-05 { reference "CR-0609"; }
revision 2020-10-02 { reference CR-0384 ; }
revision 2020-08-06 { reference "CR-0333"; }
revision 2020-08-03 { reference "CR-0321"; }
revision 2020-06-03 { reference "CR-0286"; }
revision 2020-05-08 { reference S5-203316 ; }
revision 2020-04-28 { reference "0260"; }
revision 2020-02-14 { reference S5-20XXXX ; }
revision 2019-10-28 { reference S5-193518 ; }
revision 2019-06-17 {description "Initial revision";}
feature DESManagementFunction {
description "Classs representing Distributed SON Energy Saving feature";
}
feature DANRManagementFunction {
description "Classs representing D-SON function of ANR Management feature";
}
feature DMROFunction {
description "Classs representing D-SON function of MRO feature";
}
grouping GNBCUCPFunctionGrp {
description "Represents the GNBCUCPFunction IOC.";
reference "3GPP TS 28.541";
uses mf3gpp:ManagedFunctionGrp;
leaf gNBId {
description "Identifies a gNB within a PLMN. The gNB Identifier (gNB ID)
is part of the NR Cell Identifier (NCI) of the gNB cells.";
reference "gNB ID in 3GPP TS 38.300, Global gNB ID in 3GPP TS 38.413";
mandatory true;
type int64 { range "0..4294967295"; }
}
leaf gNBIdLength {
description "Indicates the number of bits for encoding the gNB ID.";
reference "gNB ID in 3GPP TS 38.300, Global gNB ID in 3GPP TS 38.413";
mandatory true;
type int32 { range "22..32"; }
}
leaf gNBCUName {
description "Identifies the Central Unit of an gNB.";
reference "3GPP TS 38.473";
mandatory true;
type string { length "1..150"; }
}
list pLMNId {
description "The PLMN identifier to be used as part of the global RAN
node identity.";
key "mcc mnc";
min-elements 1;
max-elements 1;
uses types3gpp:PLMNId;
}
leaf-list x2BlackList {
type string;
description "List of nodes to which X2 connections are prohibited.";
}
leaf-list x2WhiteList {
type string;
description "List of nodes to which X2 connections are enforced.";
}
leaf-list xnBlackList {
type string;
description "List of nodes to which Xn connections are prohibited.";
}
leaf-list xnWhiteList {
type string;
description "List of nodes to which X2 connections are enforced.";
}
leaf-list xnHOBlackList {
type string;
description "List of nodes to which handovers over Xn are prohibited.";
}
leaf configurable5QISetRef {
type types3gpp:DistinguishedName;
description "DN of the Configurable5QISet that the GNBCUCPFunction
supports (is associated to).";
}
leaf-list x2HOBlackList {
type string;
description "List of nodes to which handovers over X2 are prohibited.";
}
leaf dynamic5QISetRef {
type types3gpp:DistinguishedName;
description "DN of the Dynamic5QISet that the GNBCUCPFunction supports
(is associated to).";
}
leaf dCHOControl {
type boolean;
description "This attribute determines whether the CHO function is
enabled or disabled.";
}
leaf dDAPSHOControl {
type boolean;
description "This attribute determines whether the DAPS handover function
is enabled or disabled.";
}
}
augment "/me3gpp:ManagedElement" {
list GNBCUCPFunction {
description "Represents the logical function CU-CP of gNB and en-gNB.";
reference "3GPP TS 28.541";
key id;
uses top3gpp:Top_Grp;
container attributes {
uses GNBCUCPFunctionGrp;
}
uses mf3gpp:ManagedFunctionContainedClasses;
}
}
}
<CODE ENDS>
E.5.17 module _3gpp-nr-nrm-gnbcuupfunction.yang
<CODE BEGINS>
module _3gpp-nr-nrm-gnbcuupfunction {
yang-version 1.1;
namespace "urn:3gpp:sa5:_3gpp-nr-nrm-gnbcuupfunction";
prefix "gnbcuup3gpp";
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; }
import _3gpp-5g-common-yang-types { prefix types5g3gpp; }
organization "3GPP SA5";
contact "https://www.3gpp.org/DynaReport/TSG-WG–S5–officials.htm?Itemid=464";
description "Defines the YANG mapping of the GNBCUUPFunction Information
Object Class (IOC) that is part of the NR Network Resource Model (NRM).";
reference "3GPP TS 28.541 5G Network Resource Model (NRM)";
revision 2022-07-28 { reference "CR-0770"; }
revision 2020-11-05 { reference CR-0412 ; }
revision 2020-08-06 { reference "CR-0333"; }
revision 2020-08-03 { reference "CR-0321"; }
revision 2020-06-03 { reference "CR-0286"; }
revision 2020-05-28 { reference "CR-0318"; }
revision 2020-03-12 { reference "SP-200233 S5-201547"; }
revision 2020-02-14 { reference S5-20XXXX ; }
revision 2019-10-28 { reference S5-193518 ; }
revision 2019-08-21 { reference "Initial revision"; }
grouping TAIGrp {
description "Tracking Area Identity";
list pLMNId {
key "mcc mnc";
description "PLMN IDs for the Tracking area";
uses types3gpp:PLMNId;
}
leaf nRTAC {
type int64;
description "Identity of the common Tracking Area Code for the PLMNs
allowedValues:
a) It is the TAC or Extended-TAC.
b) A cell can only broadcast one TAC or Extended-TAC.
See TS 36.300, subclause 10.1.7 (PLMNID and TAC relation).
c) TAC is defined in subclause 19.4.2.3 of 3GPP TS 23.003 and
Extended-TAC is defined in subclause 9.3.1.29 of 3GPP TS 38.473.
d) For a 5G SA (Stand Alone), it has a non-null value.";
}
}
grouping BackhaulAddressGrp {
description "Indicates the backhauladdress of gNB.";
leaf gNBId {
type uint32 {
range "0..4294967295";
}
description "It identifies a gNB within a PLMN. The gNB ID is part of
the NR Cell Identifier (NCI) of the gNB cells.";
reference "gNB Identifier (gNB ID) of subclause 8.2 of TS 38.300.
Global gNB ID in subclause 9.3.1.6 of TS 38.413";
}
list tAI {
key nRTAC;
min-elements 1;
max-elements 1;
description "Tracking Area Identity";
reference "subclause 9.3.3.11 in TS 38.413";
uses TAIGrp;
}
}
grouping MappingSetIDBackhaulAddressGrp {
description "Mapping relationship between setID and backhaulAddress of gNB";
leaf idx {
type uint32 ;
description "ID value";
}
leaf setID {
type uint32;
mandatory true;
description "Indicates the setID of gNB.";
reference "Subclause 7.4.1.6 in TS 38.211";
}
list backhaulAddress {
key gNBId;
min-elements 1;
max-elements 1;
description "Indicates the backhauladdress of gNB.";
uses BackhaulAddressGrp;
}
}
grouping GNBCUUPFunctionGrp {
description "Represents the GNBCUUPFunction IOC.";
reference "3GPP TS 28.541";
uses mf3gpp:ManagedFunctionGrp;
leaf gNBCUUPId {
type uint64 {
range "0..68719476735" ;
}
config false;
mandatory true;
description "Identifies the gNB-CU-UP at least within a gNB-CU-CP";
reference "’gNB-CU-UP ID’ in subclause 9.3.1.15 of 3GPP TS 38.463";
}
leaf gNBId {
type uint32;
mandatory true;
description "Identifies a gNB within a PLMN. The gNB ID is part of the
NR Cell Identifier (NCI) of the gNB cells. ";
reference "gNB Identifier (gNB ID) of subclause 8.2 of TS 38.300.
Global gNB ID in subclause 9.3.1.6 of TS 38.413";
}
leaf gNBIdLength {
mandatory true;
type int32 { range "22..32"; }
description "Indicates the number of bits for encoding the gNB Id.";
reference "gNB Id in 3GPP TS 38.300, Global gNB ID in 3GPP TS 38.413";
}
list pLMNInfoList {
description "The PLMNInfoList is a list of PLMNInfo data type. It
defines which PLMNs that can be served by the GNBCUUPFunction and
which S-NSSAIs can be supported by the GNBCUUPFunction for
corresponding PLMN in case of network slicing feature is supported";
key "mcc mnc sd sst";
uses types5g3gpp:PLMNInfo;
}
list mappingSetIDBackhaulAddressList {
key idx;
description "Specifies a list of mappingSetIDBackhaulAddress used to
retrieve the backhaul address of the victim set.
Must be present if Remote Interference Management function is
supported.";
uses MappingSetIDBackhaulAddressGrp;
}
leaf configurable5QISetRef {
type types3gpp:DistinguishedName;
description "DN of the Configurable5QISet that the GNBCUUPFunction
supports (is associated to).";
}
leaf dynamic5QISetRef {
type types3gpp:DistinguishedName;
description "DN of the Dynamic5QISet that the GNBCUUPFunction
supports (is associated to).";
}
}
augment "/me3gpp:ManagedElement" {
list GNBCUUPFunction {
key id;
description "Represents the logical function CU-UP of gNB or en-gNB.";
reference "3GPP TS 28.541";
uses top3gpp:Top_Grp;
container attributes {
uses GNBCUUPFunctionGrp;
}
uses mf3gpp:ManagedFunctionContainedClasses;
}
}
}
<CODE ENDS>
E.5.18 module _3gpp-nr-nrm-gnbdufunction.yang
<CODE BEGINS>
module _3gpp-nr-nrm-gnbdufunction {
yang-version 1.1;
namespace "urn:3gpp:sa5:_3gpp-nr-nrm-gnbdufunction";
prefix "gnbdu3gpp";
import _3gpp-common-managed-function { prefix mf3gpp; }
import _3gpp-common-managed-element { prefix me3gpp; }
import _3gpp-common-top { prefix top3gpp; }
import _3gpp-common-yang-types { prefix types3gpp; }
organization "3GPP SA5";
contact "https://www.3gpp.org/DynaReport/TSG-WG–S5–officials.htm?Itemid=464";
description "Defines the YANG mapping of the GNBDUFunction Information
Object Class (IOC) that is part of the NR Network Resource Model (NRM).";
reference "3GPP TS 28.541 5G Network Resource Model (NRM)";
revision 2022-11-02 { reference "CR-0753"; }
revision 2022-07-28 { reference "CR-0770"; }
revision 2021-10-28 { reference CR-0607 ; }
revision 2021-04-30 { reference CR-0490 ; }
revision 2020-10-02 { reference CR-0384 ; }
revision 2020-03-12 { reference "SP-200233 S5-201547" ; }
revision 2020-02-14 { reference S5-20XXXX ; }
revision 2019-10-28 { reference S5-193518 ; }
revision 2019-08-21 {reference "Initial revision."; }
feature DRACHOptimizationFunction {
description "Class representing D-SON function of RACH optimization
feature";
}
grouping RimRSReportInfoGrp {
description "This data type defines necessary reporting information
derived from the detected RIM-RS, including
1) The detected set ID;
2) Propagation delay in number of OFDM symbols
3) Functionality of the RS (RS-1 or RS-2, Enough or Not enough
mitigation for RS-1).
RS-1 is equivalent to RIM-RS type 1 (see 38.211, subclause 7.4.1.6).
RS-2 is equivalent to RIM-RS type 2 (see 38.211, subclause 7.4.1.6).
Enough mitigation for RS-1 means ‘Enough’ / ‘Not enough’ indication
functionality is enabled for RIM RS-1 and RIM-RS type 1 is used to
indicate ‘enough mitigation’ functionality.
Not enough mitigation for RS-1 means ‘Enough’ / ‘Not enough’ indication
functionality is enabled for RIM RS-1 and RIM-RS type 1 is used to
indicate ‘Not enough mitigation’ functionality.";
leaf detectedSetID {
type uint32 ;
description "Set ID of the detected RIM-RS
allowedValues: 0,1…max{totalnrofSetIdofRS1, totalnrofSetIdofRS2}";
}
leaf propagationDelay {
type uint32 ;
must ‘. <= ../../maxPropagationDelay’ {
error-message "allowedValues: 0, 1.. maxPropagationDelay";
}
description "This attribute indicates the propagation delay of the
detected RIM-RS, in number of OFDM symbol.";
}
leaf functionalityOfRIMRS {
type enumeration {
enum RS1;
enum RS2;
enum RS1_FOR_ENOUGH_MITIGATION;
enum RS1_FOR_NOT_ENOUGH_MITIGATION;
}
mandatory true;
description "Indicates the functionality of the detected RIM-RS.
If the indication of enableEnoughNotEnoughIndication is ‘enabled’,
valid values are {RS2, RS1forEnoughMitigation,
RS1forNotEnoughMitigation};
If the indication of enableEnoughNotEnoughIndication is ‘disabled’,
valid values are {RS1, RS2}.
RS1forEnoughMitigation means RIM-RS type 1 is used to indicate
‘enough mitigation’ functionality.
RS1forNotEnoughMitigation means RIM-RS type 1 is used to indicate
‘Not enough mitigation’ functionality.";
}
}
grouping RimRSReportConfGrp {
description "Defines RIM-RS reporting configuration";
leaf reportIndicator {
type types3gpp:EnabledDisabled;
default DISABLED;
description "Used to enable or disable the RS report on a gNB.
If the indication is ‘enable’, the gNB starts to periodically report
necessary information derived from the detected RIM-RS to OAM.
If the indication is ‘disable’, the gNB stops reporting.";
}
leaf reportInterval {
type uint32;
mandatory true;
units ms;
description "Used to define reporting interval of a gNB in ms.";
}
leaf nrofRIMRSReportInfo {
type uint32;
mandatory true;
description "Used to define the maximum number of RIMRSReportInfo in
a single report.";
}
leaf maxPropagationDelay {
type uint32 {
range "0..327679";
}
mandatory true;
description "Used to define the maximum reported OFDM symbol number for
the propagation delay of the detected RIM-RS in each RIMRSReportInfo.
allowedValues: 0, 1..20**2*maxNrofSymbols-1, where maxNrofSymbols=14.";
}
list RimRSReportInfoList {
key detectedSetID;
description "Represents a list (the length of the list is
nrofRIMRSReportInfo) of necessary information derived from the
detected RIM-RS.";
uses RimRSReportInfoGrp;
}
}
grouping GNBDUFunctionGrp {
description "Represents the GNBDUFunction IOC.";
reference "3GPP TS 28.541";
uses mf3gpp:ManagedFunctionGrp;
leaf gNBId {
type int64 { range "0..4294967295"; }
mandatory true;
description "Identifies a gNB within a PLMN. The gNB Identifier (gNB ID)
is part of the NR Cell Identifier (NCI) of the gNB cells.";
reference "gNB ID in 3GPP TS 38.300, Global gNB ID in 3GPP TS 38.413";
}
leaf gNBIdLength {
type int32 { range "22..32"; }
mandatory true;
description "Indicates the number of bits for encoding the gNB ID.";
reference "gNB ID in 3GPP TS 38.300, Global gNB ID in 3GPP TS 38.413";
}
leaf gNBDUId {
type int64 { range "0..68719476735"; }
mandatory true;
description "Uniquely identifies the DU at least within a gNB.";
reference "3GPP TS 38.473";
}
leaf gNBDUName {
type string { length "1..150"; }
description "Identifies the Distributed Unit of an NR node";
reference "3GPP TS 38.473";
}
list rimRSReportConf {
key reportInterval;
config false;
min-elements 1;
max-elements 1;
description "Used to configure gNBs to report the all necessary
information derived from the detected RIM-RS to OAM.";
uses RimRSReportConfGrp;
}
}
leaf configurable5QISetRef {
type types3gpp:DistinguishedName;
description "DN of the Configurable5QISet that the GNBDUFunction supports (is associated
to).";
}
leaf dynamic5QISetRef {
type types3gpp:DistinguishedName;
description "DN of the Dynamic5QISet that the GNBDUFunction supports (is associated to).";
}
augment "/me3gpp:ManagedElement" {
list GNBDUFunction {
key id;
description "Represents the logical function DU of gNB or en-gNB.";
reference "3GPP TS 28.541";
uses top3gpp:Top_Grp;
container attributes {
uses GNBDUFunctionGrp;
}
uses mf3gpp:ManagedFunctionContainedClasses;
}
}
}<CODE ENDS>
E.5.19 module _3gpp-nr-nrm-nrcellcu.yang
<CODE BEGINS>
module _3gpp-nr-nrm-nrcellcu {
yang-version 1.1;
namespace "urn:3gpp:sa5:_3gpp-nr-nrm-nrcellcu";
prefix "nrcellcu3gpp";
import _3gpp-common-yang-types { prefix types3gpp; }
import _3gpp-common-managed-function { prefix mf3gpp; }
import _3gpp-common-managed-element { prefix me3gpp; }
import _3gpp-nr-nrm-gnbcucpfunction { prefix gnbcucp3gpp; }
import _3gpp-common-top { prefix top3gpp; }
import _3gpp-5g-common-yang-types { prefix types5g3gpp; }
organization "3GPP SA5";
contact "https://www.3gpp.org/DynaReport/TSG-WG–S5–officials.htm?Itemid=464";
description "Defines the YANG mapping of the NRCellCU Information Object
Class (IOC) that is part of the NR Network Resource Model (NRM).";
reference "3GPP TS 28.541 5G Network Resource Model (NRM)";
revision 2021-01-25 { reference CR-0454 ; }
revision 2020-11-25 { reference CR-0386 ; }
revision 2020-11-05 { reference CR-0412 ; }
revision 2020-10-02 { reference CR-0384 ; }
revision 2020-05-08 { reference S5-203316 ; }
revision 2020-02-14 { reference S5-20XXXX ; }
revision 2019-10-28 { reference S5-193518 ; }
revision 2019-06-17 { reference "Initial revision"; }
feature DPCIConfigurationFunction {
description "Class representing Distributed SON
function of PCI configuration feature";
}
feature DESManagementFunction {
description "Class representing Distributed SON
Energy Saving feature";
}
feature DMROFunction {
description "Class representing D-SON function of MRO feature";
}
feature CESManagementFunction {
description "Class representing Centralized SON Energy Saving
feature";
}
grouping NRCellCUGrp {
description "Represents the NRCellCU IOC.";
reference "3GPP TS 28.541";
uses mf3gpp:ManagedFunctionGrp;
leaf cellLocalId {
description "Identifies an NR cell of a gNB. Together with corresponding
gNB ID it forms the NR Cell Identifier (NCI).";
mandatory true;
type int32 { range "0..16383"; }
}
list pLMNInfoList {
description "The PLMNInfoList is a list of PLMNInfo data type. It defines
which PLMNs that can be served by the NR cell, and which S-NSSAIs that
can be supported by the NR cell for corresponding PLMN in case of
network slicing feature is supported.";
// Note: Whether the attribute pLMNId in the pLMNInfo can be writable
// depends on the implementation.
key "mcc mnc sd sst";
min-elements 1;
uses types5g3gpp:PLMNInfo;
}
leaf nRFrequencyRef {
description "Reference to corresponding NRFrequency instance.";
config false;
type types3gpp:DistinguishedName;
}
}
augment "/me3gpp:ManagedElement/gnbcucp3gpp:GNBCUCPFunction" {
list NRCellCU {
description "Represents the information required by CU that is
responsible for the management of inter-cell mobility and neighbour
relations via ANR.";
reference "3GPP TS 28.541";
key id;
uses top3gpp:Top_Grp;
container attributes {
uses NRCellCUGrp;
}
uses mf3gpp:ManagedFunctionContainedClasses;
}
}
}
<CODE ENDS>
E.5.20 module _3gpp-nr-nrm-nrcelldu.yang
<CODE BEGINS>
module _3gpp-nr-nrm-nrcelldu {
yang-version 1.1;
namespace "urn:3gpp:sa5:_3gpp-nr-nrm-nrcelldu";
prefix "nrcelldu3gpp";
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; }
import _3gpp-nr-nrm-gnbdufunction { prefix gnbdu3gpp; }
import _3gpp-5g-common-yang-types { prefix types5g3gpp; }
import ietf-yang-types { prefix yang; }
organization "3GPP SA5";
contact "https://www.3gpp.org/DynaReport/TSG-WG–S5–officials.htm?Itemid=464";
description "Defines the YANG mapping of the NRCellDU Information Object
Class (IOC) that is part of the NR Network Resource Model (NRM).";
reference "3GPP TS 28.541 5G Network Resource Model (NRM)";
revision 2022-07-28 { reference "CR-0770"; }
revision 2022-06-29 { reference CR-0756 ; }
revision 2021-10-28 { reference CR-0607 ; }
revision 2021-01-25 { reference CR-0454 ; }
revision 2020-11-25 { reference CR-0386 ; }
revision 2020-11-05 { reference CR-0412 ; }
revision 2020-10-02 { reference CR-0384 ; }
revision 2020-05-08 { reference S5-203316 ; }
revision 2020-02-14 { reference S5-20XXXX ; }
revision 2019-10-28 { reference S5-193518 ; }
revision 2019-09-03 { reference "Initial revision"; }
feature DRACHOptimizationFunction {
description "Class representing D-SON function of RACH optimization
feature";
}
feature CPCIConfigurationFunction {
description "Class representing Centralized SON function of
PCI configuration feature";
}
grouping NPNIdentityGrp {
description "Represents the NPN supported by the <<IOC>> using this
<<dataType>> as one of its attributes in case of the cell is a
NPN-only cell.";
list plmnid {
key "mcc mnc";
min-elements 1;
description "PLMNId";
uses types3gpp:PLMNId;
}
leaf cAGIdList {
type string;
mandatory true;
description "It identifies a CAG list containing up to 12 CAG-identifiers
per PLMN Identity, see TS 38.331.
CAG is used for the PNI-NPNs to prevent UE(s), which are not allowed
to access the NPN via the associated cell(s), from automatically
selecting and accessing the associated CAG cell(s).
CAG ID is used to combine with PLMN ID to identify a PNI-NPN.
Exist if the cell is a NPN-only cell see TS 38.331";
}
leaf nIDList {
type string;
mandatory true;
description "It identifies a list of NIDs containing up to 12 NIDs per
PLMN Identity, see TS 38.331.
NID is used to combine with PLMN ID to identify an SNPN.
Exist if the cell is a NPN-only cell see TS 38.331";
}
}
grouping NRCellDUGrp {
description "Represents the NRCellDU IOC.";
reference "3GPP TS 28.541";
uses mf3gpp:ManagedFunctionGrp;
leaf cellLocalId {
description "Identifies an NR cell of a gNB. Together with the
corresponding gNB identifier in forms the NR Cell Identity (NCI).";
reference "NCI in 3GPP TS 38.300";
mandatory true;
type int32 { range "0..16383"; }
}
leaf operationalState {
description "Operational state of the NRCellDU instance. Indicates
whether the resource is installed and partially or fully operable
(ENABLED) or the resource is not installed or not operable
(DISABLED).";
config false;
type types3gpp:OperationalState;
}
leaf administrativeState {
description "Administrative state of the NRCellDU. Indicates the
permission to use or prohibition against using the cell, imposed
through the OAM services.";
type types3gpp:AdministrativeState;
default LOCKED;
}
leaf cellState {
description "Cell state of the NRCellDU instance. Indicates whether the
cell is not currently in use (IDLE), or currently in use but not
configured to carry traffic (INACTIVE), or currently in use and is
configured to carry traffic (ACTIVE).";
config false;
type types3gpp:CellState;
}
list pLMNInfoList {
description "The PLMNInfoList is a list of PLMNInfo data type. It
defines which PLMNs that can be served by the NR cell, and which
S-NSSAIs that can be supported by the NR cell for corresponding PLMN
in case of network slicing feature is supported. The plMNId of the
first entry of the list is the PLMNId used to construct the nCGI for
the NR cell.";
key "mcc mnc sd sst";
min-elements 1;
ordered-by user;
uses types5g3gpp:PLMNInfo;
}
list nPNIdentityList {
key idx ;
min-elements 1;
ordered-by user;
description "It defines which NPNs that can be served by the NR cell,
and which CAG IDs or NIDs can be supported by the NR cell for
corresponding PNI-NPN or SNPN in case of the cell is NPN-only cell.";
reference "3GPP TS 38.331";
leaf idx { type uint32 ; }
uses NPNIdentityGrp;
}
leaf nRPCI {
description "The Physical Cell Identity (PCI) of the NR cell.";
reference "3GPP TS 36.211";
mandatory true;
type int32 { range "0..1007"; }
}
leaf nRTAC {
description "The common 5GS Tracking Area Code for the PLMNs.";
reference "3GPP TS 23.003, 3GPP TS 38.473";
type types3gpp:Tac;
}
leaf arfcnDL {
description "NR Absolute Radio Frequency Channel Number (NR-ARFCN) for
downlink.";
reference "3GPP TS 38.104";
mandatory true;
type int32;
}
leaf arfcnUL {
description "NR Absolute Radio Frequency Channel Number (NR-ARFCN) for
uplink.";
reference "3GPP TS 38.104";
type int32;
}
leaf arfcnSUL {
description "NR Absolute Radio Frequency Channel Number (NR-ARFCN) for
supplementary uplink.";
reference "3GPP TS 38.104";
type int32;
}
leaf bSChannelBwDL {
description "Base station channel bandwidth for downlink.";
reference "3GPP TS 38.104";
type int32;
units MHz;
}
leaf rimRSMonitoringStartTime {
type yang:date-and-time ;
mandatory true;
description "Configures the UTC time when the gNB attempts to start
RIM-RS monitoring.";
}
leaf rimRSMonitoringStopTime {
type yang:date-and-time ;
mandatory true;
description "Configures the UTC time when the gNB stops RIM-RS
monitoring.";
}
leaf rimRSMonitoringWindowDuration {
type uint32 {
range 1..16384 ;
}
mandatory true;
description "Configures a duration of the monitoring window in which
gNB monitors the RIM-RS, in unit of P_t, where P_t is the RIM-RS
transmission periodicity in units of uplink-downlink switching period (
see 38.211 subclause 7.4.1.6).
This field is configured together with rimRSMonitoringInterval,
rimRSMonitoringWindowStartingOffset, rimRSMonitoringOccasionInterval
and rimRSMonitoringOccasionStartingOffset.
The duration of the monitoring window is expected to be larger than
or equal to M*P_t, where M is the interval between adjacent monitoring
occasions within the monitoring window
(configured by rimRSMonitoringInterval).
The absolute duration of the monitoring window is not expected to be
larger than the periodicity of the monitoring window (configured by
rimRSMonitoringWindowPeriodicity).
See 3GPP TS 28.541 attribute descrition rimRSMonitoringWindowDuration
for the exact math formulas.
Only the earliest N_T consecutive detection durations in each RIM-RS
transmission periodicity (P_t) in the monitoring window are taken as
valid time for monitoring potential interference, and they are
consecutively monitored in the monitoring window, while the residual
part of each RIM-RS transmission periodicity is not used for
discovering potential interference, where, a consecutive detection
duration spans P1*R1 (if only P1 is configured) or ((P1+P2))/2*R1 (
if both P1 and P2 are configured), where,
R1 is the number of consecutive uplink-downlinkswitching periods
for RS-1 (configured by nrofConsecutiveRIMRS1),
P1 is the first uplink-downlinkswitching period (configured by
dlULSwitchingPeriod1),
P2 is the second uplink-downlink switching period (configured by
dlULSwitchingPeriod2), and
N_T=
((N_setID # RIM,1)/(N_f # RI N_s # RIM,1)
if enableEnoughNotEnoughIndication is ‘disable’
(2N_setID # RIM,1)/(N_f # RIM N_s # RIM,1)
if enableEnoughNotEnoughIndication is ‘enable’
N_setID # ‘RIM,1’ is the total number of set IDs for RIM RS-1
(configured by totalnrofSetIdofRS1),
N_f # RIM is the number of candidate frequency resources in the whole
network (configured by nrofGlobalRIMRSFrequencyCandidates), and
N_s # ‘RIM,1’ is the number of candidate sequences assigned for
RIM RS-1 (configured by nrofRIMRSSequenceCandidatesofRS1).";
}
leaf rimRSMonitoringWindowStartingOffset {
type uint8 {
range 0..23 ;
}
mandatory true;
units hours;
description "Configures the start offset of the first monitoring window
within one day, in unit of hours.";
}
leaf rimRSMonitoringWindowPeriodicity {
type uint8 {
range 1|2|3|4|6|8|12|24 ;
}
units hours;
mandatory true;
description "Configures the periodicity of the monitoring window, in
unit of hours";
}
leaf rimRSMonitoringOccasionInterval {
type uint32 {
range 1..max ;
}
mandatory true;
description "Configures the interval between adjacent monitoring
occasions (M) within the monitoring window, in unit of consecutive
detection duration.
M is expected to be prime to N_T, where N_T is given in above
attribute rimRSMonitoringWindowDuration.
allowedValues: 1,2..N_T-1";
}
leaf rimRSMonitoringOccasionStartingOffset {
type uint32 ;
mandatory true;
description "Configures the start offset of the first monitoring occasions
within the monitoring window (S_M), in unit of consecutive detection
duration.
gNB starts monitoring potential interference from the S_M-th consecutive
detection duration in the first complete RIM-RS transmission
periodicity (P_t) within the monitoring window.
allowedValues: 0,1,2..M-1
where M is the the interval between adjacent monitoring occasions
within the monitoring window
(configured by rimRSMonitoringOccasionInterval)";
}
leaf ssbFrequency {
description "Indicates cell defining SSB frequency domain position.
Frequency (in terms of NR-ARFCN) of the cell defining SSB transmission.
The frequency identifies the position of resource element RE=#0
(subcarrier #0) of resource block RB#10 of the SS block. The frequency
must be positioned on the NR global frequency raster, as defined in
3GPP TS 38.101-1, and within bSChannelBwDL.";
mandatory true;
type int32 { range "0..3279165"; }
}
leaf ssbPeriodicity {
description "Indicates cell defined SSB periodicity. The SSB periodicity
is used for the rate matching purpose.";
mandatory true;
type int32 { range "5 | 10 | 20 | 40 | 80 | 160"; }
units "subframes (ms)";
}
leaf ssbSubCarrierSpacing {
description "Subcarrier spacing of SSB. Only the values 15 kHz or 30 kHz
(< 6 GHz), 120 kHz or 240 kHz (> 6 GHz) are applicable.";
reference "3GPP TS 38.211";
mandatory true;
type int32 { range "15 | 30 | 120 | 240"; }
units kHz;
}
leaf ssbOffset {
description "Indicates cell defining SSB time domain position. Defined
as the offset of the measurement window, in which to receive SS/PBCH
blocks, where allowed values depend on the ssbPeriodicity
(ssbOffset < ssbPeriodicity).";
mandatory true;
type int32 { range "0..159"; }
units "subframes (ms)";
}
leaf ssbDuration {
description "Duration of the measurement window in which to receive
SS/PBCH blocks.";
reference "3GPP TS 38.213";
mandatory true;
type int32 { range "1..5"; }
units "subframes (ms)";
}
leaf bSChannelBwUL {
description "Base station channel bandwidth for uplink.";
reference "3GPP TS 38.104";
type int32;
units MHz;
}
leaf bSChannelBwSUL {
description "Base station channel bandwidth for supplementary uplink.";
reference "3GPP TS 38.104";
type int32;
units MHz;
}
leaf-list nRSectorCarrierRef {
description "Reference to corresponding NRSectorCarrier instance.";
min-elements 1;
type types3gpp:DistinguishedName;
}
leaf-list bWPRef {
description "Reference to corresponding BWP instance.";
type types3gpp:DistinguishedName;
}
leaf-list bWPSetRef {
description "Reference to corresponding BWPSet instance.";
type types3gpp:DistinguishedName;
}
leaf-list nRFrequencyRef {
description "Reference to corresponding NRFrequency instance.";
type types3gpp:DistinguishedName;
}
leaf victimSetRef {
type types3gpp:DistinguishedName;
mandatory true;
description "DN of a victim Set (RimRSSet)
Implemented if RIM feature is supported";
}
leaf aggressorSetRef {
type types3gpp:DistinguishedName;
mandatory true;
description "DN of an aggressor Set (RimRSSet)";
}
}
augment "/me3gpp:ManagedElement/gnbdu3gpp:GNBDUFunction" {
list NRCellDU {
description "This IOC represents the part of NR cell information that
describes s the specific resources instances.
An NR cell transmits SS/PBCH block and always requires downlink
transmission at a certain carrier frequency with a certain channel
bandwidth. Transmission may be performed from multiple sector-carriers
using different transmission points, and these may be configured with
different carrier frequencies and channel bandwidths, as long as they
are aligned to the cell’s downlink resource grids as defined in
subclause 4.4 in TS 38.211. The values of arfcnDL and bSChannelBwDL
attributes define the resource grids which each sector-carrier needs to
be aligned to. See subclauses 5.3 and 5.4.2 of TS 38.104 for definitions
of BS channel bandwidth and NR-ARFCN, respectively.
An NR cell requires an uplink in order to provide initial access. In
case of TDD, the values of arfcnUL and bSChannelBwUL have to always be
set to the same values as for the corresponding DL attributes. For both
FDD and TDD, the arfcnUL and bSChannelBwUL define uplink resource grids
to which each sector-carrier needs to align to.
An NR cell can in addition be configured with a supplementary uplink,
which has its own arfcnSUL and bSChannelBwSUL, which define resource
grids for supplementary uplink sector-carriers.
Each of downlink, uplink and supplementary uplink (if configured) need
an initial bandwidth part (BWP), which defines resources to be used by
UEs during and immediately after initial access. Additional BWPs can be
either configured or calculated by gNB internally and be applied to UEs
dynamically by gNB based on e.g. UE capability and bandwidth need of
each UE.";
key id;
uses top3gpp:Top_Grp;
container attributes {
uses NRCellDUGrp;
}
uses mf3gpp:ManagedFunctionContainedClasses;
}
}
}
<CODE ENDS>
E.5.21 module _3gpp-nr-nrm-nrcellrelation.yang
<CODE BEGINS>
module _3gpp-nr-nrm-nrcellrelation {
yang-version 1.1;
namespace "urn:3gpp:sa5:_3gpp-nr-nrm-nrcellrelation";
prefix "nrcellrel3gpp";
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; }
import _3gpp-nr-nrm-gnbcucpfunction { prefix gnbcucp3gpp; }
import _3gpp-nr-nrm-nrcellcu { prefix nrcellcu3gpp; }
organization "3GPP SA5";
description "Defines the YANG mapping of the NRCellRelation Information
Object Class (IOC) that is part of the NR Network Resource Model (NRM).";
reference "3GPP TS 28.541 5G Network Resource Model (NRM)";
revision 2021-01-25 { reference CR-0454 ; }
revision 2020-06-03 { reference S5-202333 ; }
revision 2020-04-23 { reference CR0281 ; }
revision 2019-10-28 { reference S5-193518 ; }
revision 2019-08-30 {
description "Initial revision";
}
typedef EnergySavingCoverage {
type enumeration {
enum FULL;
enum NO;
enum PARTIAL;
}
}
grouping NRCellRelationGrp {
description "Represents the NRCellRelation IOC.";
reference "3GPP TS 28.541";
leaf nRTCI {
description "Target NR Cell Identifier. It consists of NR Cell
Identifier (NCI) and Physical Cell Identifier of the target NR cell
(nRPCI).";
type uint64;
}
container cellIndividualOffset {
description "A set of offset values for the neighbour cell. Used when
UE is in connected mode. Defined for rsrpOffsetSSB, rsrqOffsetSSB,
sinrOffsetSSB, rsrpOffsetCSI-RS, rsrqOffsetCSI-RS and
sinrOffsetCSI-RS.";
reference "cellIndividualOffset in MeasObjectNR in 3GPP TS 38.331";
leaf rsrpOffsetSsb {
description "Offset value of rsrpOffsetSSB.";
default 0;
type types3gpp:QOffsetRange;
}
leaf rsrqOffsetSsb{
description "Offset value of rsrqOffsetSSB.";
default 0;
type types3gpp:QOffsetRange;
}
leaf sinrOffsetSsb {
description "Offset value of sinrOffsetSSB.";
default 0;
type types3gpp:QOffsetRange;
}
leaf rsrpOffsetCsiRs{
description "Offset value of rsrpOffsetCSI-RS.";
default 0;
type types3gpp:QOffsetRange;
}
leaf rsrqOffsetCsiRs {
description "Offset value of rsrqOffsetCSI-RS.";
default 0;
type types3gpp:QOffsetRange;
}
leaf sinrOffsetCsiRs {
description "Offset value of sinrOffsetCSI-RS.";
default 0;
type types3gpp:QOffsetRange;
}
}
leaf nRFreqRelationRef {
description "Reference to a corresponding NRFreqRelation instance.";
mandatory true;
type types3gpp:DistinguishedName;
}
leaf adjacentNRCellRef {
description "Reference to an adjacent NR cell (NRCellCU or
ExternalNRCellCU).";
mandatory true;
type types3gpp:DistinguishedName;
}
leaf isRemoveAllowed {
type boolean;
default true;
description "True if the ANR function in the node is allowed to remove this relation.";
}
leaf isHOAllowed {
type boolean;
default true;
description "True if handovers are allowed over this relation.";
}
leaf isESCoveredBy {
description "Indicates whether the adjacent cell
provides no, partial or full coverage for the parent cell
instance. Adjacent cells with this attribute equal to FULL are
recommended to be considered as candidate cells to take over the
coverage when the original cell is about to be changed to energy
saving state. All adjacent cells with this property equal
to PARTIAL are recommended to be considered as entirety of candidate
cells to take over the coverage when the original cell is about to be
changed to energy saving state.";
type EnergySavingCoverage;
}
}
augment /me3gpp:ManagedElement/gnbcucp3gpp:GNBCUCPFunction/nrcellcu3gpp:NRCellCU {
list NRCellRelation {
description "Represents a neighbour cell relation from a source cell
to a target cell, where the target cell is an NRCellCU or
ExternalNRCellCU instance.";
reference "3GPP TS 28.541";
key id;
uses top3gpp:Top_Grp;
container attributes {
uses NRCellRelationGrp;
}
uses mf3gpp:ManagedFunctionContainedClasses;
}
}
}
<CODE ENDS>
E.5.22 module _3gpp-nr-nrm-nrfreqrelation.yang
<CODE BEGINS>
module _3gpp-nr-nrm-nrfreqrelation {
yang-version 1.1;
namespace "urn:3gpp:sa5:_3gpp-nr-nrm-nrfreqrelation";
prefix "nrfreqrel3gpp";
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; }
import _3gpp-nr-nrm-gnbcucpfunction { prefix gnbcucp3gpp; }
import _3gpp-nr-nrm-nrcellcu { prefix nrcellcu3gpp; }
organization "3GPP SA5";
description "Defines the YANG mapping of the NRFreqRelation Information
Object Class (IOC) that is part of the NR Network Resource Model (NRM).";
reference "3GPP TS 28.541 5G Network Resource Model (NRM)";
revision 2020-04-23 { reference CR0281 ; }
revision 2019-10-28 { reference S5-193518 ; }
revision 2019-06-17 {
description "Initial revision";
}
grouping NRFreqRelationGrp {
description "Represents the NRFreqRelation IOC.";
reference "3GPP TS 28.541";
container offsetMO {
description "A set of offset values applicable to all measured cells
with reference signal(s) indicated in corresponding MeasObjectNR. It
is used to indicate a cell, beam or measurement object specific offset
to be applied when evaluating candidates for cell re-selection or when
evaluating triggering conditions for measurement reporting. It is
defined for rsrpOffsetSSB, rsrqOffsetSSB, sinrOffsetSSB,
rsrpOffsetCSI-RS, rsrqOffsetCSI-RS and sinrOffsetCSI-RS.";
reference "offsetMO in MeasObjectNR in 3GPP TS 38.331";
leaf rsrpOffsetSsb {
description "Offset value of rsrpOffsetSSB.";
default 0;
type types3gpp:QOffsetRange;
}
leaf rsrqOffsetSsb {
description "Offset value of rsrqOffsetSSB.";
default 0;
type types3gpp:QOffsetRange;
}
leaf sinrOffsetSsb {
description "Offset value of sinrOffsetSSB.";
default 0;
type types3gpp:QOffsetRange;
}
leaf rsrpOffsetCsiRs {
description "Offset value of rsrpOffsetCSI-RS.";
default 0;
type types3gpp:QOffsetRange;
}
leaf rsrqOffsetCsiRs {
description "Offset value of rsrqOffsetCSI-RS.";
default 0;
type types3gpp:QOffsetRange;
}
leaf sinrOffsetCsiRs {
description "Offset value of sinrOffsetCSI-RS.";
default 0;
type types3gpp:QOffsetRange;
}
}
leaf-list blackListEntry {
description "A list of Physical Cell Identities (PCIs) that are
blacklisted in NR measurements.";
reference "3GPP TS 38.331";
min-elements 0;
type uint16 { range "0..1007"; }
}
leaf-list blackListEntryIdleMode {
description "A list of Physical Cell Identities (PCIs) that are
blacklisted in SIB4 and SIB5.";
min-elements 0;
type uint16 { range "0..1007"; }
}
leaf cellReselectionPriority {
description "The absolute priority of the carrier frequency used by the
cell reselection procedure. Value 0 means lowest priority. The value
must not already used by other RAT, i.e. equal priorities between RATs
are not supported. The UE behaviour when no value is entered is
specified in subclause 5.2.4.1 of 3GPP TS 38.304.";
reference "CellReselectionPriority in 3GPP TS 38.331, priority in
3GPP TS 38.304";
type uint32;
default 0;
}
leaf cellReselectionSubPriority {
description "Indicates a fractional value to be added to the value of
cellReselectionPriority to obtain the absolute priority of the
concerned carrier frequency for E-UTRA and NR.";
reference "3GPP TS 38.331";
type uint8 { range "2 | 4 | 6 | 8"; }
units "0.1";
}
leaf pMax {
description "Used for calculation of the parameter Pcompensation
(defined in 3GPP TS 38.304), at cell reselection to a cell.";
reference "PEMAX in 3GPP TS 38.101-1";
mandatory false;
type int32 { range "-30..33"; }
units dBm;
}
leaf qOffsetFreq {
description "The frequency specific offset applied when evaluating
candidates for cell reselection.";
mandatory false;
type types3gpp:QOffsetRange;
default 0;
}
leaf qQualMin {
description "Indicates the minimum required quality level in the cell.
Value 0 means that it is not sent and UE applies in such case the
(default) value of negative infinity for Qqualmin. Sent in SIB3 or
SIB5.";
reference "3GPP TS 38.304";
type int32 { range "-34..-3 | 0"; }
units dB;
default 0;
}
leaf qRxLevMin {
description "Indicates the required minimum received Reference Symbol
Received Power (RSRP) level in the NR frequency for cell reselection.
Broadcast in SIB3 or SIB5, depending on whether the related frequency
is intra- or inter-frequency. Resolution is 2.";
reference "3GPP TS 38.304";
mandatory true;
type int32 { range "-140..-44"; }
units dBm;
}
leaf threshXHighP {
description "Specifies the Srxlev threshold used by the UE when
reselecting towards a higher priority RAT/frequency than the current
serving frequency. Each frequency of NR and E-UTRAN might have a
specific threshold. Resolution is 2.";
reference "ThreshX, HighP in 3GPP TS 38.304";
mandatory true;
type int32 { range "0..62"; }
units dB;
}
leaf threshXHighQ {
description "Specifies the Squal threshold used by the UE when
reselecting towards a higher priority RAT/frequency than the current
serving frequency. Each frequency of NR and E-UTRAN might have a
specific threshold.";
reference "ThreshX, HighQ in 3GPP TS 38.304";
mandatory true;
type int32 { range "0..31"; }
units dB;
}
leaf threshXLowP {
description "Specifies the Srxlev threshold used by the UE when
reselecting towards a lower priority RAT/frequency than the current
serving frequency. Each frequency of NR and E-UTRAN might have a
specific threshold. Resolution is 2.";
reference "ThreshX, LowP in 3GPP TS 38.304";
mandatory true;
type int32 { range "0..62"; }
units dB;
}
leaf threshXLowQ {
description "Specifies the Squal threshold used by the UE when
reselecting towards a lower priority RAT/frequency than the current
serving frequency. Each frequency of NR and E-UTRAN might have a
specific threshold.";
reference "ThreshX, LowQ in 3GPP TS 38.304";
mandatory true;
type int32 { range "0..31"; }
units dB;
}
leaf tReselectionNR {
description "Cell reselection timer for NR.";
reference "TreselectionRAT for NR in 3GPP TS 38.331";
mandatory true;
type int32 { range "0..7"; }
units s;
}
leaf tReselectionNRSfHigh {
description "The attribute tReselectionNr (parameter TreselectionNR in
3GPP TS 38.304) is multiplied with this scaling factor if the UE is
in high mobility state.";
reference "Speed dependent ScalingFactor for TreselectionNR for high
mobility state in 3GPP TS 38.304";
mandatory true;
type uint8 { range "25 | 50 | 75 | 100"; }
units %;
}
leaf tReselectionNRSfMedium {
description "The attribute tReselectionNr (parameter TreselectionNR in
3GPP TS 38.304) multiplied with this scaling factor if the UE is in
medium mobility state.";
reference "Speed dependent ScalingFactor for TreselectionNR for medium
mobility state in 3GPP TS 38.304";
mandatory true;
type uint8 { range "25 | 50 | 75 | 100"; }
units %;
}
leaf nRFrequencyRef {
description "Reference to a corresponding NRFrequency instance.";
mandatory true;
type types3gpp:DistinguishedName;
}
}
augment /me3gpp:ManagedElement/gnbcucp3gpp:GNBCUCPFunction/nrcellcu3gpp:NRCellCU {
list NRFreqRelation {
description "Together with the target NRFrequency, it represents the
frequency properties applicable to the referencing NRFreqRelation.";
reference "3GPP TS 28.541";
key id;
uses top3gpp:Top_Grp;
container attributes {
uses NRFreqRelationGrp;
}
uses mf3gpp:ManagedFunctionContainedClasses;
}
}
}
<CODE ENDS>
E.5.23 module _3gpp-nr-nrm-nrfrequency.yang
<CODE BEGINS>
module _3gpp-nr-nrm-nrfrequency {
yang-version 1.1;
namespace "urn:3gpp:sa5:_3gpp-nr-nrm-nrnetwork-nrfrequency";
prefix "nrfreq3gpp";
import _3gpp-common-managed-function { prefix mf3gpp; }
import _3gpp-nr-nrm-nrnetwork { prefix nrnet3gpp; }
import _3gpp-common-subnetwork { prefix subnet3gpp; }
import _3gpp-common-top { prefix top3gpp; }
organization "3GPP SA5";
description "Defines the YANG mapping of the NRFrequency Information Object
Class (IOC) that is part of the NR Network Resource Model (NRM).";
reference "3GPP TS 28.541 5G Network Resource Model (NRM)";
revision 2019-10-28 { reference S5-193518 ; }
revision 2019-06-17 {
description "Initial revision";
}
grouping NRFrequencyGrp {
description "Represents the NRFrequency IOC.";
reference "3GPP TS 28.541";
uses mf3gpp:ManagedFunctionGrp;
leaf absoluteFrequencySSB {
description "The absolute frequency applicable for a downlink NR carrier
frequency associated with the SSB, in terms of NR-ARFCN.";
mandatory true;
type uint32 { range "0.. 3279165"; }
}
leaf sSBSubCarrierSpacing {
description "Sub-carrier spacing of the SSB.";
mandatory true;
type uint8 { range "15 | 30 | 60 | 120"; }
units "kHz";
}
leaf-list multiFrequencyBandListNR {
description "List of additional frequency bands the frequency belongs to.
The list is automatically set by the gNB.";
config false;
min-elements 0;
type uint16 { range "1..256"; }
}
}
grouping NRFrequencyWrapper {
list NRFrequency {
description "Represents certain NR frequency properties.";
reference "3GPP TS 28.541";
key id;
uses top3gpp:Top_Grp;
container attributes {
uses NRFrequencyGrp;
}
uses mf3gpp:ManagedFunctionContainedClasses;
}
}
augment "/subnet3gpp:SubNetwork" {
if-feature subnet3gpp:ExternalsUnderSubNetwork ;
uses NRFrequencyWrapper;
}
augment "/nrnet3gpp:NRNetwork" {
if-feature nrnet3gpp:ExternalsUnderNRNetwork;
uses NRFrequencyWrapper;
}
}
<CODE ENDS>
E.5.24 module _3gpp-nr-nrm-nrnetwork.yang
<CODE BEGINS>
module _3gpp-nr-nrm-nrnetwork {
yang-version 1.1;
namespace "urn:3gpp:sa5:_3gpp-nr-nrm-nrnetwork";
prefix "nrnet3gpp";
import _3gpp-common-subnetwork { prefix subnet3gpp; }
import _3gpp-common-top { prefix top3gpp; }
organization "3GPP SA5";
description "Defines the YANG mapping of the NRNetwork Information Object
Class (IOC) that is part of the NR Network Resource Model (NRM).";
reference "3GPP TS 28.541 5G Network Resource Model (NRM)";
revision 2019-06-17 {
description "Initial revision";
}
feature ExternalsUnderNRNetwork {
description "Classes representing external entities like NRFrequency,
ExternalGNBCUCPFunction, ExternalGNBDUFunction
are contained under a NRNetwork list/class.";
}
grouping NRNetworkGrp {
description "Represents the NRNetwork IOC.";
reference "3GPP TS 28.541";
uses subnet3gpp:SubNetworkGrp;
}
list NRNetwork {
description "A subnetwork containing gNB external NR entities.";
reference "3GPP TS 28.541";
key id;
uses top3gpp:Top_Grp;
container attributes {
uses NRNetworkGrp;
}
}
}
<CODE ENDS>
E.5.25 module _3gpp-nr-nrm-nrsectorcarrier.yang
<CODE BEGINS>
module _3gpp-nr-nrm-nrsectorcarrier {
yang-version 1.1;
namespace "urn:3gpp:sa5:_3gpp-nr-nrm-nrnetwork-nrsectorcarrier";
prefix "nrsectcarr3gpp";
import _3gpp-common-yang-types { prefix types3gpp; }
import _3gpp-common-managed-function { prefix mf3gpp; }
import _3gpp-common-managed-element { prefix me3gpp; }
import _3gpp-nr-nrm-gnbdufunction { prefix gnbdu3gpp; }
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 NRSectorCarrier Information
Object Class (IOC) that is part of the NR Network Resource Model (NRM).";
reference "3GPP TS 28.541 5G Network Resource Model (NRM)";
revision 2020-05-28 { reference CR-0316 ; }
revision 2019-10-28 { reference S5-193518 ; }
revision 2019-06-17 {
description "Initial revision";
}
grouping NRSectorCarrierGrp {
description "Represents the NRSectorCarrier IOC.";
reference "3GPP TS 28.541";
uses mf3gpp:ManagedFunctionGrp;
leaf txDirection {
description "Indicates if the transmission direction is downlink,
uplink, or both downlink and uplink.";
mandatory true;
type types3gpp:TxDirection;
}
leaf configuredMaxTxPower {
description "Maximum transmisssion power at the antenna port for all
downlink channels, used simultaneously in a cell, added together.
Condition: The sector-carrier has a downlink and the
configuration of Tx power at antenna port reference point is supported.";
mandatory true;
type int32;
units mW;
}
leaf configuredMaxTxEIRP {
type int64;
units dBm;
mandatory true;
description "The maximum emitted isotroptic radiated power (EIRP) in dBm
for all downlink channels, used simultaneously in a cell, added together.
Condition: the sector-carrier has a downlink and the
configuration of emitted isotropic radiated power is supported";
}
leaf arfcnDL {
description "NR Absolute Radio Frequency Channel Number (NR-ARFCN)
for downlink.
Condition: The sector-carrier has a downlink AND the value
differs from the referring cell’s value of arfcnDL.";
reference "3GPP TS 38.104";
mandatory true;
type int32 { range "0..3279165"; }
}
leaf arfcnUL {
description "NR Absolute Radio Frequency Channel Number (NR-ARFCN)
for uplink.
Condition: The sector-carrier has an uplink AND the value
differs from the referring cell’s value of arfcnUL.";
reference "3GPP TS 38.104";
mandatory true;
type int32 { range "0..3279165"; }
}
leaf bSChannelBwDL {
description "Base station channel bandwitdth for downlink.
Condition: The sector-carrier has a downlink AND the value
differs from the referring cell’s value of bSChannelBwDL.";
reference "3GPP TS 38.104";
mandatory true;
type int32 { range "5 | 10 | 15 | 20 | 30 | 40 | 50 | 60 | 70 | 80 |
90 | 100"; }
units MHz;
}
leaf bSChannelBwUL {
description "Base station channel bandwitdth for uplink.";
reference "3GPP TS 38.104";
mandatory true;
type int32 { range "5 | 10 | 15 | 20 | 30 | 40 | 50 | 60 | 70 | 80 |
90 | 100"; }
units MHz;
}
leaf sectorEquipmentFunctionRef {
description "Reference to corresponding SectorEquipmentFunction
instance.";
reference "3GPP TS 23.622";
mandatory true;
type types3gpp:DistinguishedName;
}
}
augment "/me3gpp:ManagedElement/gnbdu3gpp:GNBDUFunction" {
list NRSectorCarrier {
description "Represents the resources of each transmission point
included in the cell.";
reference "3GPP TS 28.541";
key id;
uses top3gpp:Top_Grp;
container attributes {
uses NRSectorCarrierGrp;
}
uses mf3gpp:ManagedFunctionContainedClasses;
}
}
}
<CODE ENDS>
E.5.26 module _3gpp-nr-nrm-rrmpolicy.yang
<CODE BEGINS>
module _3gpp-nr-nrm-rrmpolicy {
yang-version 1.1;
namespace "urn:3gpp:sa5:_3gpp-nr-nrm-rrmpolicy";
prefix "rrmpolicy3gpp";
import _3gpp-5g-common-yang-types { prefix types5g3gpp; }
import _3gpp-common-top { prefix top3gpp; }
import _3gpp-common-managed-element { prefix me3gpp; }
import _3gpp-nr-nrm-nrcellcu { prefix nrcellcu3gpp ; }
import _3gpp-nr-nrm-nrcelldu { prefix nrcelldu3gpp ; }
import _3gpp-nr-nrm-gnbcucpfunction { prefix gnbcucp3gpp ; }
import _3gpp-nr-nrm-gnbcuupfunction { prefix gnbcuup3gpp ; }
import _3gpp-nr-nrm-gnbdufunction { prefix gnbdu3gpp ; }
organization "3GPP SA5";
contact "https://www.3gpp.org/DynaReport/TSG-WG–S5–officials.htm?Itemid=464";
description "Defines the YANG mapping of the RRMPolicy abstract class that
is part of the NR Network Resource Model (NRM).";
reference "3GPP TS 28.541 5G Network Resource Model (NRM)";
revision 2022-07-28 { reference "CR-0770"; }
revision 2020-11-05 { reference CR-0412 ; }
revision 2020-04-28 { reference "CR0285"; }
revision 2020-02-14 { reference "Initial revision"; }
grouping rRMPolicyMemberGrp {
description "This data type represents an RRM Policy member that will be
part of a rRMPolicyMemberList. A RRMPolicyMember is defined by its
pLMNId and sNSSAI (S-NSSAI).
The members in a rRMPolicyMemberList are assigned a specific amount of
RRM resources based on settings in RRMPolicy.";
uses types5g3gpp:PLMNInfo;
}
grouping RRMPolicy_Grp {
description "This IOC represents the properties of an abstract RRMPolicy
. The RRMPolicy_ IOC needs to be subclassed to be instantiated.
It defines two attributes apart from those inherited from Top IOC, the
resourceType attribute defines type of resource (PRB, RRC
connected users, DRB usage etc.) and the rRMPolicyMemberList attribute
defines the RRMPolicyMember(s)that are subject to this policy.
An RRM resource (defined in resourceType
attribute) is located in NRCellDU, NRCellCU, GNBDUFunction,
GNBCUCPFunction or in GNBCUUPFunction. The RRMPolicyRatio IOC is one
realization of a RRMPolicy_ IOC. This RRM framework allows adding new
policies, both standardized (like RRMPolicyRatio) or as vendor specific,
by inheriting from the abstract RRMPolicy_ IOC.";
leaf resourceType {
description "The resourceType attribute defines type of resource (PRB,
RRC connected users, DRB usage etc.) that is subject to policy.
Valid values are ‘PRB’, ‘PRB_UL’ , ‘PRB_DL’,’RRC’ or ‘DRB’";
mandatory true;
type enumeration {
enum PRB;
enum PRB_UL;
enum PRB_DL;
enum RRC;
enum DRB;
}
}
list rRMPolicyMemberList{
description "It represents the list of RRMPolicyMember (s) that the
managed object is supporting. A RRMPolicyMember <<dataType>> include
the PLMNId <<dataType>> and S-NSSAI <<dataType>>." ;
min-elements 1;
  key "mcc mnc sd sst";
uses rRMPolicyMemberGrp;
}
} // grouping
grouping RRMPolicyRatioGrp {
description "Represents the RRMPolicyRatio concrete IOC.";
uses RRMPolicy_Grp; // Inherits RRMPolicy_
leaf rRMPolicyMaxRatio {
description " This attribute specifies the maximum percentage of radio
resource that can be used by the associated rRMPolicyMemberList.
The maximum percentage of radio resource include at least one of
the shared resources, prioritized resources and dedicated resources.
The sum of the rRMPolicyMaxRatio values assigned to all RRMPolicyRatio(s)
name-contained by same ManagedEntity can be greater that 100.";
default 100;
type uint8 { range "0..100"; }
units percent;
}
leaf rRMPolicyMinRatio {
description " This attribute specifies the minimum percentage of radio
resources that can be used by the associated rRMPolicyMemberList.
The minimum percentage of radio resources including at least one of
prioritized resources and dedicated resources. The sum of the
rRMPolicyMinRatio values assigned to all RRM PolicyRatio(s)
name-contained by same ManagedEntity shall be less or equal 100.";
default 0;
type uint8 { range "0..100"; }
units percent;
}
leaf rRMPolicyDedicatedRatio {
description " This attribute specifies the percentage of radio resource
that dedicatedly used by the associated rRMPolicyMemberList. The sum of
the rRMPolicyDeidctaedRatio values assigned to all RRMPolicyRatio(s)
name-contained by same ManagedEntity shall be less or equal 100. ";
default 0;
type uint8 { range "0..100"; }
units percent;
}
}
grouping RrmPolicySubtree {
description "Contains RrmPolicy related classes.
Should be used in all classes (or classes inheriting from)
– NRCellCU, NRCellDU, GNBCUUPFunction, GNBCUCPFunction, GNBDUFunction
If some YAM wants to augment these classes/list/groupings they must
augment all user classes!";
list RRMPolicyRatio {
description "This IOC represents the properties of RRMPolicyRatio.
RRMPolicyRatio is one realization of abstract RRMPolicy_ IOC.
RRMPolicyRatio has three attributes, apart from those inherited
(DN, resourceType, rRMPolicyMemberList).
Structure of RRMPolicyRatio includes in order: Dedicated Resources,
Prioritized Resources, Shared Resources, etc.
– The attribute rRMPolicyMaxRatio defines the maximum resource usage
quota for the associated rRMPolicyMemberList, including at least one of
shared resources, prioritized resources and dedicated resources. The
sum of the ‘rRMPolicyMaxRatio’ values assigned to all RRMPolicyRatio(s)
name-contained by same MangedEntity can be greater than 100.
– The attribute rRMPolicyMinRatio defines the minimum resource usage
quota for the associated RRMPolicyMemberList, including at least one
of prioritized resources and dedicated resources, which means the
resources quota that need to be guaranteed for use by the associated
rRMPolicyMemberList. The sum of the ‘rRMPolicyMinRatio’ values assigned
to all RRMPolicyRatio(s) name-contained by same MangedEntity shall be
less or equal 100.
– The attribute rRMPolicyDedicatedRatio defines the dedicated resource
usage quota for the RRMPolicyMemberList, including dedicated resources.
The sum of the ‘rRMPolicyDedicatedRatio’ values assigned to all
RRMPolicyRatio(s) name-contained by same MangedEntity shall be less
or equal 100.
The following are the definition for above mentioned three resource
categories:
– Shared resources: means the resources that are shared with other
rRMPolicyMemberList(s) (i.e. the rRMPolicyMemberList(s) defined in
RRMPolicyRatio(s) name-contained by the same ManagedEntity). The shared
resources are not guaranteed for use by the associated
rRMPolicyMemberList. The shared resources quota is represented by
[rRMPolicyMaxRatio-rRMPolicyMinRatio].
– Priortized resources: means the resources are preferentially used by
the associated RRMPolicyMemberList. These resources are guaranteed for
use by the associated RRMPolicyMemberList when it needs to use them.
When not used, these resources may be used by other
rRMPolicyMemberList(s) (i.e. the rRMPolicyMemberList(s) defined in
RRMPolicyRatio(s) name-contained by the same ManagedEntity).
The prioritized resources quota is represented by
[rRMPolicyMinRatio-rRMPolicyDedicatedRatio]
– Dedicated resources: means the resources are dedicated for use by
the associated RRMPolicyMemberList. These resources can not be shared
even if the associated RRMPolicyMember does not use them. The Dedicated
resources quota is represented by [rRMPolicyDedicatedRatio].";
key id;
uses top3gpp:Top_Grp;
container attributes {
uses RRMPolicyRatioGrp;
}
}
}
augment "/me3gpp:ManagedElement/gnbcucp3gpp:GNBCUCPFunction/" +
"nrcellcu3gpp:NRCellCU" {
uses RrmPolicySubtree;
}
augment "/me3gpp:ManagedElement/gnbdu3gpp:GNBDUFunction/" +
"nrcelldu3gpp:NRCellDU" {
uses RrmPolicySubtree;
}
augment "/me3gpp:ManagedElement/gnbcuup3gpp:GNBCUUPFunction" {
uses RrmPolicySubtree;
}
augment "/me3gpp:ManagedElement/gnbcucp3gpp:GNBCUCPFunction" {
uses RrmPolicySubtree;
}
augment "/me3gpp:ManagedElement/gnbdu3gpp:GNBDUFunction" {
uses RrmPolicySubtree;
}
}
<CODE ENDS>
E.5.27 Void
E.5.28 module _3gpp-nr-nrm-danrmanagementfunction.yang
<CODE BEGINS>
module _3gpp-nr-nrm-danrmanagementfunction {
yang-version 1.1;
namespace "urn:3gpp:sa5:_3gpp-nr-nrm-danrmanagementfunction";
prefix "danrmanagementfunction3gpp";
import _3gpp-common-top { prefix top3gpp; }
import _3gpp-nr-nrm-gnbcucpfunction { prefix gnbcucp3gpp; }
import _3gpp-common-managed-element { prefix me3gpp; }
organization "3GPP SA5";
contact "https://www.3gpp.org/DynaReport/TSG-WG–S5–officials.htm?Itemid=464";
description "Defines the YANG mapping of the DANRManagementFunction Information Object Class
(IOC) that is part of the NR Network Resource Model (NRM).";
reference "3GPP TS 28.541 5G Network Resource Model (NRM)";
revision 2020-05-08 { reference S5-203316; }
grouping DANRManagementFunctionGrp {
description "Represents the DANRManagementFunction IOC.";
reference "3GPP TS 28.541";
uses top3gpp:Top_Grp;
leaf intrasystemANRManagementSwitch {
description "This attribute determines whether the intra-system ANR function is activated or deactivated.";
type boolean;
}
leaf intersystemANRManagementSwitch {
description "This attribute determines whether the inter-system ANR function is activated or deactivated.";
type boolean;
}
}
augment "/me3gpp:ManagedElement/gnbcucp3gpp:GNBCUCPFunction" {
if-feature gnbcucp3gpp:DANRManagementFunction;
uses DANRManagementFunctionGrp;
}
}
<CODE ENDS>
E.5.29 module _3gpp-nr-nrm-desmanagementfunction.yang
<CODE BEGINS>
module _3gpp-nr-nrm-desmanagementfunction {
yang-version 1.1;
namespace "urn:3gpp:sa5:_3gpp-nr-nrm-desmanagementfunction";
prefix "desmf3gpp";
import _3gpp-common-top { prefix top3gpp; }
import _3gpp-nr-nrm-gnbcucpfunction { prefix gnbcucp3gpp; }
import _3gpp-common-managed-element { prefix me3gpp; }
import _3gpp-nr-nrm-nrcellcu { prefix nrcellcu3gpp; }
import _3gpp-common-subnetwork { prefix subnet3gpp; }
import _3gpp-5g-common-yang-types { prefix type5g3gpp; }
organization "3GPP SA5";
contact "https://www.3gpp.org/DynaReport/TSG-WG–S5–officials.htm?Itemid=464";
description "Defines the YANG mapping of the DESManagementFunction
Information Object Class (IOC) that is part of the NR Network Resource
Model (NRM).";
reference "3GPP TS 28.541 5G Network Resource Model (NRM)";
revision 2021-08-05 { reference S5-214053/CR-0518; }
revision 2020-05-08 { reference S5-203316; }
grouping loadTimeThresholdGrp {
description "Represents the the traffic load threshold and the time
duration.";
leaf loadThreshold {
description "This attribute is used by distributed ES algorithms to allow
a cell to enter the energySaving state.";
type type5g3gpp:EnergySavingLoadThresholdT;
}
leaf timeDuration {
description "The time duration indicates how long the traffic load
(either for UL or DL) in the cell needs to have been above the
threshold to wake up one or more original cells which have been
provided backup coverage by the candidate cell.";
type type5g3gpp:EnergySavingTimeDurationT;
}
}
grouping DESManagementFunctionGrp {
description "Represents the DESManagementFunction IOC.";
leaf desSwitch {
description "This attribute determines whether the Distributed SON
energy saving function is enabled or disabled.";
type boolean;
}
list intraRatEsActivationOriginalCellLoadParameters {
description "This attributes is relevant, if the cell acts as an original
cell. This attribute indicates the traffic load threshold and the time
duration, which are used by distributed ES algorithms to allow a cell
to enter the energySaving state.";
key loadThreshold;
min-elements 1;
max-elements 1;
uses loadTimeThresholdGrp;
}
list intraRatEsActivationCandidateCellsLoadParameters {
description "This attribute indicates the traffic load threshold and the
time duration, which are used by distributed ES algorithms level to
allow an ‘original’ cell to enter the energySaving state.";
key loadThreshold;
min-elements 1;
max-elements 1;
uses loadTimeThresholdGrp;
}
list intraRatEsDeactivationCandidateCellsLoadParameters {
description "This attributes is relevant, if the cell acts as a candidate
cell.This attribute indicates the traffic load threshold and the time
duration which is used by distributed ES algorithms to allow a cell to
leave the energySaving state.";
key loadThreshold;
min-elements 1;
max-elements 1;
uses loadTimeThresholdGrp;
}
list esNotAllowedTimePeriod {
description "This is a list of time periods during which
inter-RAT energy saving is not allowed";
key idx;
leaf idx {
type uint32;
}
uses EsNotAllowedTimePeriodGrp;
}
list interRatEsActivationOriginalCellParameters {
description "This attribute indicates the traffic load threshold and the
time duration, which are used by distributed inter-RAT ES algorithms to
allow an original cell to enter the energySaving state.";
key loadThreshold;
min-elements 1;
max-elements 1;
uses loadTimeThresholdGrp;
}
list interRatEsActivationCandidateCellParameters {
description "This attribute indicates the traffic load threshold and the
time duration, which are used by distributed inter-RAT ES algorithms to
allow an original cell to enter the energySaving state.";
key loadThreshold;
min-elements 1;
max-elements 1;
uses loadTimeThresholdGrp;
}
list interRatEsDeactivationCandidateCellParameters {
description "This attribute indicates the traffic load threshold and the
time duration which is used by distributed inter-RAT ES algorithms to
allow an original cell to leave the energySaving state.";
key loadThreshold;
min-elements 1;
max-elements 1;
uses loadTimeThresholdGrp;
}
leaf energySavingState {
description "Specifies the status regarding the energy saving in the
cell.";
type enumeration {
enum isNotEnergySaving;
enum isEnergySaving;
}
}
leaf isProbingCapable {
description "This attribute indicates whether this cell is capable of
performing the ES probing procedure.";
type enumeration{
enum yes;
enum no;
}
}
}
grouping EsNotAllowedTimePeriodGrp {
leaf startTime {
description "Start of not allowed time period in UTC time zone.
If set, the endTime must also be set. If not set, this is
interpreted as around the clock.";
must ../endTime;
type type5g3gpp:UTC24TimeOfDayT;
}
leaf endTime {
description "If endTime has a lower value than startTime, it will
be interpreted as referring to the following day.";
type type5g3gpp:UTC24TimeOfDayT;
must ../startTime;
}
leaf-list daysOfWeek {
description "Specifies that the not allowed periods are only
applicable to the specified days in UTC timezone. Every day if
not set.";
type type5g3gpp:DayOfWeekT;
}
}
grouping DESManagementFunctionSubtree {
list DESManagementFunction {
description "This IOC represents the management capabilities of
Distributed SON Energy Saving (ES) functions. This is provided for
Energy Saving purposes.
In the case where multiple DESManagement MOIs exist at different
levels of the containment tree, the DESManagement MOI at the lower
level overrides the DESManagement MOIs at higher level(s) of the same
containment tree.";
reference "clause 6.2.3.0 in TS 28.310";
key id;
uses top3gpp:Top_Grp;
container attributes {
uses DESManagementFunctionGrp;
}
}
}
augment "/me3gpp:ManagedElement/gnbcucp3gpp:GNBCUCPFunction/"+
"nrcellcu3gpp:NRCellCU" {
if-feature nrcellcu3gpp:DESManagementFunction;
uses DESManagementFunctionSubtree;
}
augment /me3gpp:ManagedElement/gnbcucp3gpp:GNBCUCPFunction {
if-feature gnbcucp3gpp:DESManagementFunction;
uses DESManagementFunctionSubtree;
}
augment /me3gpp:ManagedElement {
if-feature me3gpp:DESManagementFunction;
uses DESManagementFunctionSubtree;
}
augment /subnet3gpp:SubNetwork {
if-feature subnet3gpp:DESManagementFunction;
uses DESManagementFunctionSubtree;
}
}
<CODE ENDS>
E.5.30 module _3gpp-nr-nrm-drachoptimizationfunction.yang
<CODE BEGINS>
module _3gpp-nr-nrm-drachoptimizationfunction {
yang-version 1.1;
namespace "urn:3gpp:sa5:_3gpp-nr-nrm-drachoptimizationfunction";
prefix "dracho3gpp";
import _3gpp-common-subnetwork { prefix subnet3gpp; }
import _3gpp-common-top { prefix top3gpp; }
import _3gpp-common-managed-element { prefix me3gpp; }
import _3gpp-nr-nrm-nrcelldu { prefix nrcelldu3gpp; }
import _3gpp-nr-nrm-gnbdufunction { prefix gnbdu3gpp; }
organization "3GPP SA5";
contact "https://www.3gpp.org/DynaReport/TSG-WG–S5–officials.htm?Itemid=464";
description "Defines the YANG mapping of the DRACHOptimizationFunction
Information Object Class (IOC) that is part of the NR Network Resource
Model (NRM).";
reference "3GPP TS 28.541 5G Network Resource Model (NRM)";
revision 2021-08-05 { reference S5-214053/CR-0518; }
revision 2021-01-25 { reference CR-0454 ; }
revision 2020-10-02 { reference "CR-0384, CR-0382" ; }
revision 2020-05-08 { reference S5-203316; }
typedef TargetProbabilityT {
type enumeration {
enum 25;
enum 50;
enum 75;
enum 90;
}
}
typedef NumberofpreamblessentT {
type uint32 {
range "1..200";
}
}
typedef AccessdelayT {
type uint32 {
range "10..560";
}
}
grouping NumPreableAccessDelayGrp {
description "Represents the target Access Probability (APn) for the RACH
optimization function.";
leaf targetProbability {
description "This attribute determines the target Probability.";
mandatory true;
type TargetProbabilityT;
}
leaf numberofpreamblessent {
description "This attribute determines the number of preambles sent.";
mandatory true;
type NumberofpreamblessentT;
}
}
grouping DRACHOptimizationFunctionGrp {
description "Represents the DRACHOptimizationFunction IOC.";
list ueAccProbilityDist {
description "This is a list of target Access Probability (APn) for the
RACH optimization function.";
key "targetProbability numberofpreamblessent";
uses NumPreableAccessDelayGrp;
}
list ueAccDelayProbilityDist {
description "This is a list of target Access Delay probability (ADP)
for the RACH optimization function.";
key "targetProbability numberofpreamblessent";
uses NumPreableAccessDelayGrp;
}
leaf drachOptimizationControl {
description "This attribute determines whether the RACH Optimization
function is enabled or disabled.";
type boolean;
}
}
grouping DRACHOptimizationFunctionSubtree {
list DRACHOptimizationFunction {
description "This IOC represents the management capabilities of
Centralized SON Energy Saving (ES) functions. This is provided for
Energy Saving purposes.
In the case where multiple CESManagement MOIs exist at different
levels of the containment tree, the CESManagement MOI at the lower
level overrides the CESManagement MOIs at higher level(s) of the
same containment tree.";
reference "clause 6.2.2 in TS 28.310";
key id;
uses top3gpp:Top_Grp;
container attributes {
uses DRACHOptimizationFunctionGrp;
}
}
}
augment "/me3gpp:ManagedElement/gnbdu3gpp:GNBDUFunction/"+
"nrcelldu3gpp:NRCellDU" {
if-feature nrcelldu3gpp:DRACHOptimizationFunction;
uses DRACHOptimizationFunctionSubtree;
}
augment "/me3gpp:ManagedElement/gnbdu3gpp:GNBDUFunction" {
if-feature gnbdu3gpp:DRACHOptimizationFunction;
uses DRACHOptimizationFunctionSubtree;
}
augment "/me3gpp:ManagedElement" {
if-feature me3gpp:DRACHOptimizationFunction;
uses DRACHOptimizationFunctionSubtree;
}
augment "/subnet3gpp:SubNetwork" {
if-feature nrcelldu3gpp:DRACHOptimizationFunction;
uses DRACHOptimizationFunctionSubtree;
}
}
<CODE ENDS>
E.5.31 module _3gpp-nr-nrm-dmrofunction.yang
<CODE BEGINS>
module _3gpp-nr-nrm-dmrofunction {
yang-version 1.1;
namespace "urn:3gpp:sa5:_3gpp-nr-nrm-dmrofunction";
prefix "dmrof3gpp";
import _3gpp-common-subnetwork { prefix subnet3gpp; }
import _3gpp-common-top { prefix top3gpp; }
import _3gpp-nr-nrm-gnbcucpfunction { prefix gnbcucp3gpp; }
import _3gpp-common-managed-element { prefix me3gpp; }
import _3gpp-nr-nrm-nrcellcu { prefix nrcellcu3gpp; }
organization "3GPP SA5";
contact "https://www.3gpp.org/DynaReport/TSG-WG–S5–officials.htm?Itemid=464";
description "Defines the YANG mapping of the DMROFunction
Information Object Class (IOC) that is part of the NR Network Resource
Model (NRM).";
reference "3GPP TS 28.541 5G Network Resource Model (NRM)";
revision 2022-01-07 { reference CR-0633; }
revision 2021-08-05 { reference S5-214053/CR-0518; }
revision 2020-05-08 { reference S5-203316; }
grouping DMROFunctionGrp {
description "Represents the DMROFunction IOC.";
leaf maximumDeviationHoTriggerLow {
description "This parameter defines the maximum allowed lower
deviation of the Handover Trigger, from the default point of
operation.";
type int32 {range "-20..20";}
units "0.5 dB";
}
leaf maximumDeviationHoTriggerHigh {
description "This parameter defines the maximum allowed upper
deviation of the Handover Trigger, from the default point of
operation.";
type int32 {range "-20..20";}
units "0.5 dB";
}
leaf minimumTimeBetweenHoTriggerChange {
description "This parameter defines the minimum allowed time interval
between two Handover Trigger change performed by MRO. This is used to
control the stability and convergence of the algorithm.";
type uint32 {
range 0..604800; // <= 1 week
}
units seconds;
}
leaf tstoreUEcntxt {
description "The timer used for detection of too early HO, too late HO
and HO to wrong cell.";
type uint32 {
range 0..1023;
}
units "100 milliseconds";
}
leaf dmroControl {
description "This attribute determines whether the MRO function is
enabled or disabled.";
type boolean;
}
}
grouping DMROFunctionSubtree {
list DMROFunction {
description "This IOC contains attributes to support the D-SON function
of MRO.
In the case where multiple DMRO MOIs exist at different levels of the
containment tree, the DMRO MOI at the lower level overrides the DMRO
MOIs at higher level(s) of the same containment tree.";
reference "clause 7.1.2 in TS 28.313";
key id;
uses top3gpp:Top_Grp;
container attributes {
uses DMROFunctionGrp;
}
}
}
augment "/me3gpp:ManagedElement/gnbcucp3gpp:GNBCUCPFunction/"+
"nrcellcu3gpp:NRCellCU" {
if-feature nrcellcu3gpp:DMROFunction;
uses DMROFunctionSubtree;
}
augment /me3gpp:ManagedElement/gnbcucp3gpp:GNBCUCPFunction {
if-feature gnbcucp3gpp:DMROFunction;
uses DMROFunctionSubtree;
}
augment /me3gpp:ManagedElement {
if-feature me3gpp:DMROFunction;
uses DMROFunctionSubtree;
}
augment /subnet3gpp:SubNetwork {
if-feature subnet3gpp:DMROFunction;
uses DMROFunctionSubtree;
}
}
<CODE ENDS>
E.5.32 module _3gpp-nr-nrm-dpciconfigurationfunction.yang
<CODE BEGINS>
module _3gpp-nr-nrm-dpciconfigurationfunction {
yang-version 1.1;
namespace "urn:3gpp:sa5:_3gpp-nr-nrm-dpciconfigurationfunction";
prefix "dpcicf3gpp";
import _3gpp-common-subnetwork { prefix subnet3gpp; }
import _3gpp-common-top { prefix top3gpp; }
import _3gpp-nr-nrm-nrcellcu { prefix nrcellcu3gpp; }
import _3gpp-nr-nrm-gnbcucpfunction { prefix gnbcucp3gpp; }
import _3gpp-common-managed-element { prefix me3gpp; }
import _3gpp-5g-common-yang-types { prefix type5g3gpp; }
organization "3GPP SA5";
contact "https://www.3gpp.org/DynaReport/TSG-WG–S5–officials.htm?Itemid=464";
description "Defines the YANG mapping of the DPCIConfigurationFunction
Information Object Class (IOC) that is part of the NR Network Resource
Model (NRM).";
reference "3GPP TS 28.541 5G Network Resource Model (NRM)";
revision 2021-08-05 { reference S5-214053/CR-0518; }
revision 2021-01-25 { reference CR-0454 ; }
revision 2020-11-25 { reference CR-0386 ; }
revision 2020-05-08 { reference S5-203316; }
grouping DPCIConfigurationFunctionGrp {
description "Represents the DPCICONFIGURATIONFunction IOC.";
list nRPciList {
description "This holds a list of physical cell identities that can be
assigned to the NR cells. This attribute shall be supported if D-SON
PCI configuration function is supported.";
key NRPci;
leaf NRPci {
type type5g3gpp:PhysCellID;
}
}
leaf dPciConfigurationControl {
description "This attribute determines whether the Distributed SON PCI
configuration Function is enabled or disabled.";
type boolean;
}
}
grouping DPCIConfigurationFunctionSubtree {
list DPCIConfigurationFunction {
description "This IOC contains attributes to support the Distributed SON
function of PCI configuration.
In the case where multiple DPCIConfiguration MOIs exist at different
levels of the containment tree, the DPCIConfiguration MOI at the lower
level overrides the DPCIConfiguration MOIs at higher level(s) of the
same containment tree.";
reference "clause 7.1.3 in TS 28.313";
key id;
uses top3gpp:Top_Grp;
container attributes {
uses DPCIConfigurationFunctionGrp;
}
}
}
augment "/me3gpp:ManagedElement/gnbcucp3gpp:GNBCUCPFunction/"+
"nrcellcu3gpp:NRCellCU" {
if-feature nrcellcu3gpp:DPCIConfigurationFunction;
uses DPCIConfigurationFunctionSubtree;
}
augment /me3gpp:ManagedElement {
if-feature me3gpp:DPCIConfigurationFunction;
uses DPCIConfigurationFunctionSubtree;
}
augment /subnet3gpp:SubNetwork {
if-feature subnet3gpp:DPCIConfigurationFunction;
uses DPCIConfigurationFunctionSubtree;
}
}
<CODE ENDS>
E.5.33 module _3gpp-nr-nrm-cpciconfigurationfunction.yang
<CODE BEGINS>
module _3gpp-nr-nrm-cpciconfigurationfunction {
yang-version 1.1;
namespace "urn:3gpp:sa5:_3gpp-nr-nrm-cpciconfigurationfunction";
prefix "cpcicf3gpp";
import _3gpp-common-subnetwork { prefix subnet3gpp; }
import _3gpp-common-top { prefix top3gpp; }
import _3gpp-nr-nrm-nrcelldu { prefix nrcelldu3gpp; }
import _3gpp-nr-nrm-gnbdufunction { prefix gnbdu3gpp; }
import _3gpp-common-managed-element { prefix me3gpp; }
organization "3GPP SA5";
contact "https://www.3gpp.org/DynaReport/TSG-WG–S5–officials.htm?Itemid=464";
description "Represents the CPCIConfigurationFunction Information Object
Class(IOC) that is part of the NR Network Resource Model.";
reference "3GPP TS 28.541 5G Network Resource Model (NRM)";
revision 2021-08-05 { reference S5-214053/CR-0518; }
revision 2020-05-08 { reference S5-203316; }
grouping CPCIConfigurationFunctionGrp {
description "Represents the CPCIConfigurationFunction IOC.";
leaf cPciConfigurationControl {
description "This attribute determines whether the Centralized SON
PCI configuration function is enabled or disabled.";
type boolean;
mandatory true;
}
leaf-list cSonPciList {
type int32 { range "0..1007"; }
min-elements 1;
description "Holds a list of physical cell identities that can be
assigned to the pci attribute by gNB. The assignment algorithm is not
specified.
See TS 38.211 clause 7.4.2.1 for legal values of pci.
This attribute shall be supported if and only if the C-SON PCI
configuration is supported.";
reference "See TS 38.211 clause 7.4.2.1";
}
}
grouping CPCIConfigurationFunctionSubtree {
list CPCIConfigurationFunction {
description "This IOC contains attributes to support the Cross
Domain-Centralized SON function of PCI configuration
In the case where multiple CPCIConfiguration MOIs exist at different
levels of the containment tree, the CPCIConfiguration MOI at the lower
level overrides the CPCIConfiguration MOIs at higher level(s) of the
same containment tree.";
reference "clause 7.2.1 in TS 28.313";
key id;
uses top3gpp:Top_Grp ;
container attributes {
uses CPCIConfigurationFunctionGrp ;
}
}
}
augment /me3gpp:ManagedElement/gnbdu3gpp:GNBDUFunction/nrcelldu3gpp:NRCellDU {
if-feature nrcelldu3gpp:CPCIConfigurationFunction;
uses CPCIConfigurationFunctionSubtree;
}
augment /me3gpp:ManagedElement {
if-feature me3gpp:CPCIConfigurationFunction;
uses CPCIConfigurationFunctionSubtree;
}
augment /subnet3gpp:SubNetwork {
if-feature subnet3gpp:CPCIConfigurationFunction;
uses CPCIConfigurationFunctionSubtree;
}
}
<CODE ENDS>
E.5.34 module _3gpp-nr-nrm-cesmanagementfunction.yang
<CODE BEGINS>
module _3gpp-nr-nrm-cesmanagementfunction {
yang-version 1.1;
namespace "urn:3gpp:sa5:_3gpp-nr-nrm-cesmanagementfunction";
prefix "cesmf3gpp";
import _3gpp-common-subnetwork { prefix subnet3gpp; }
import _3gpp-common-top { prefix top3gpp; }
import _3gpp-nr-nrm-nrcellcu { prefix nrcellcu3gpp; }
import _3gpp-nr-nrm-gnbcucpfunction { prefix gnbcucp3gpp; }
import _3gpp-common-managed-element { prefix me3gpp; }
import _3gpp-5g-common-yang-types { prefix type5g3gpp; }
organization "3GPP SA5";
contact "https://www.3gpp.org/DynaReport/TSG-WG–S5–officials.htm?Itemid=464";
description "Defines the YANG mapping of the CESManagementFunction
Information Object Class (IOC) that is part of the NR Network Resource Model
(NRM).";
reference "3GPP TS 28.541 5G Network Resource Model (NRM)";
revision 2021-08-05 { reference S5-214053/CR-0518; }
revision 2020-05-08 { reference S5-203316; }
grouping loadTimeThresholdGrp {
description "Represents the the traffic load threshold and the time
duration.";
leaf loadThreshold {
description "This attribute is used by distributed ES algorithms to allow
a cell to enter the energySaving state.";
type type5g3gpp:EnergySavingLoadThresholdT;
}
leaf timeDuration {
description "The time duration indicates how long the traffic load
(either for UL or DL) in the cell needs to have been above the
threshold to wake up one or more original cells which have been
provided backup coverage by the candidate cell.";
type type5g3gpp:EnergySavingLoadThresholdT;
}
}
grouping CESManagementFunctionGrp {
description "Represents the CESManagementFunction IOC.";
leaf cesSwitch {
description "This attribute determines whether the Centralized SON energy
saving function is enabled or disabled.";
type boolean;
default true;
}
list intraRatEsActivationOriginalCellLoadParameters {
description "This attributes is relevant, if the cell acts as an original
cell.This attribute indicates the traffic load threshold and the time
duration, which are used by distributed ES algorithms to allow a cell
to enter the energySaving state. The time duration indicates how long
the load needs to have been below the threshold.";
key loadThreshold;
min-elements 1;
max-elements 1;
uses loadTimeThresholdGrp;
}
list intraRatEsActivationCandidateCellsLoadParameters {
description "This attributes is relevant, if the cell acts as a candidate
cell. This attribute indicates the traffic load threshold and the time
duration, which are used by distributed ES algorithms level to allow an
‘original’ cell to enter the energySaving state. Threshold and duration
are applied to the candidate cell(s) which will provides coverage
backup of an original cell when it is in the energySaving state. The
threshold applies in the same way for a candidate cell, no matter for
which original cell it will provide backup coverage.
The time duration indicates how long the traffic in the candidate cell
needs to have been below the threshold before any original cells which
will be provided backup coverage by the candidate cell enters energy
saving state.";
key loadThreshold;
min-elements 1;
max-elements 1;
uses loadTimeThresholdGrp;
}
list intraRatEsDeactivationCandidateCellsLoadParameters {
description "This attributes is relevant, if the cell acts as a candidate
cell. This attribute indicates the traffic load threshold and the time
duration which is used by distributed ES algorithms to allow a cell to
leave the energySaving state. Threshold and time duration are applied
to the candidate cell when it which provides coverage backup for the
cell in energySaving state. The threshold applies in the same way for a
candidate cell, no matter for which original cell it provides backup
coverage.
The time duration indicates how long the traffic in the candidate cell
needs to have been above the threshold to wake up one or more original
cells which have been provided backup coverage by the candidate cell.";
key loadThreshold;
min-elements 1;
max-elements 1;
uses loadTimeThresholdGrp;
}
list esNotAllowedTimePeriod {
description "This is a list of time periods during which
inter-RAT energy saving is not allowed";
key idx;
leaf idx {
type uint32;
}
uses EsNotAllowedTimePeriodGrp;
}
list interRatEsActivationOriginalCellParameters {
description "This attribute is relevant, if the cell acts as an original
cell. This attribute indicates the traffic load threshold and the time
duration, which are used by distributed inter-RAT ES algorithms to
allow an original cell to enter the energySaving state. The time
duration indicates how long the traffic load (both for UL and DL) needs
to have been below the threshold.
In case the original cell is an EUTRAN cell, the load information
refers to Composite Available Capacity Group IE (see 3GPP TS 36.413
[12] Annex B.1.5) and the following applies:
Load = (100 – ‘Capacity Value’ ) * ‘Cell Capacity Class Value’,
where ‘Capacity Value’ and ‘Cell Capacity Class Value’ are defined in
3GPP TS 36.423 [7].
In case the original cell is a UTRAN cell, the load information refers
to Cell Load Information Group IE (see 3GPP TS 36.413 [12] Annex B.1.5)
and the following applies:
Load= ‘Load Value’ * ‘Cell Capacity Class Value’, where ‘Load Value’
and ‘Cell Capacity Class Value’ are defined in 3GPP TS 25.413 [19].
If the ‘Cell Capacity Class Value’ is not known, then ‘Cell Capacity
Class Value’ should be set to 1 when calculating the load, and the load
threshold should be set in range of 0..100.";
key loadThreshold;
min-elements 1;
max-elements 1;
uses loadTimeThresholdGrp;
}
list interRatEsActivationCandidateCellParameters {
description "This attribute is relevant, if the cell acts as a candidate
cell. This attribute indicates the traffic load threshold and the time
duration, which are used by distributed inter-RAT ES algorithms to
allow an original cell to enter the energySaving state. Threshold and
time duration are applied to the candidate cell(s) which will provides
coverage backup of an original cell when it is in the energySaving
state. The time duration indicates how long the traffic load (both for
UL and DL) in the candidate cell needs to have been below the threshold
before any original cells which will be provided backup coverage by the
candidate cell enters energySaving state.
In case the candidate cell is a UTRAN or GERAN cell, the load
information refers to Cell Load Information Group IE (see 3GPP TS
36.413 [12] Annex B.1.5) and the following applies:
Load= ‘Load Value’ * ‘Cell Capacity Class Value’, where ‘Load Value’
and ‘Cell Capacity Class Value’ are defined in 3GPP TS 25.413 [19]
(for UTRAN) / TS 48.008 [20] (for GERAN).
If the ‘Cell Capacity Class Value’ is not known, then ‘Cell Capacity
Class Value’ should be set to 1 when calculating the load, and the load
threshold should be set in range of 0..100.";
min-elements 1;
max-elements 1;
key loadThreshold;
uses loadTimeThresholdGrp;
}
list interRatEsDeactivationCandidateCellParameters {
description "This attribute is relevant, if the cell acts as a candidate
cell. This attribute indicates the traffic load threshold and the time
duration which is used by distributed inter-RAT ES algorithms to allow
an original cell to leave the energySaving state. Threshold and time
duration are applied to the candidate cell which provides coverage
backup for the cell in energySaving state.
The time duration indicates how long the traffic load (either for UL or
DL) in the candidate cell needs to have been above the threshold to
wake up one or more original cells which have been provided backup
coverage by the candidate cell.
For the load see the definition of
interRatEsActivationCandidateCellParameters.
This attribute indicates the traffic load threshold and the time
duration which is used by distributed inter-RAT ES algorithms to allow
an original cell to leave the energySaving state.";
key loadThreshold;
min-elements 1;
max-elements 1;
uses loadTimeThresholdGrp;
}
leaf energySavingState {
description "Specifies the status regarding the energy saving in the
cell. If the value of energySavingControl is toBeEnergySaving, then it
shall be tried to achieve the value isEnergySaving for the
energySavingState. If the value of energySavingControl is
toBeNotEnergySaving, then it shall be tried to achieve the value
isNotEnergySaving for the energySavingState. ";
type enumeration{
enum isNotEnergySaving;
enum isEnergySaving;
}
}
leaf energySavingControl {
description "This attribute allows the Cross Domain-Centralized SON
energy saving function to initiate energy saving activation or
deactivation.";
type enumeration{
enum toBeEnergySaving;
enum toBeNotEnergySaving;
}
}
}
grouping EsNotAllowedTimePeriodGrp {
leaf startTime {
description "Start of not allowed time period in UTC time zone.
If set, the endTime must also be set. If not set, this is
interpreted as around the clock.";
must ../endTime;
type type5g3gpp:UTC24TimeOfDayT;
}
leaf endTime {
description "If endTime has a lower value than startTime, it will
be interpreted as referring to the following day.";
must ../startTime;
type type5g3gpp:UTC24TimeOfDayT;
}
leaf-list daysOfWeek {
description "Specifies that the not allowed periods are only
applicable to the specified days in UTC timezone. Every day if
not set.";
type type5g3gpp:DayOfWeekT;
}
}
grouping CESManagementFunctionSubtree {
list CESManagementFunction {
description "This IOC represents the management capabilities of
Centralized SON Energy Saving (ES) functions. This is provided for
Energy Saving purposes.
In the case where multiple CESManagement MOIs exist at different
levels of the containment tree, the CESManagement MOI at the lower
level overrides the CESManagement MOIs at higher level(s) of the
same containment tree.";
reference "clause 6.2.2 in TS 28.310";
key id;
uses top3gpp:Top_Grp;
container attributes {
uses CESManagementFunctionGrp;
}
}
}
augment "/me3gpp:ManagedElement/gnbcucp3gpp:GNBCUCPFunction/"+
"nrcellcu3gpp:NRCellCU" {
if-feature nrcellcu3gpp:CESManagementFunction;
uses CESManagementFunctionSubtree;
}
augment /me3gpp:ManagedElement {
if-feature me3gpp:CESManagementFunction;
uses CESManagementFunctionSubtree;
}
augment /subnet3gpp:SubNetwork {
if-feature subnet3gpp:CESManagementFunction;
uses CESManagementFunctionSubtree;
}
}
<CODE ENDS>
E.5.35 module _3gpp-nr-nrm-operatordu.yang
<CODE BEGINS>
module _3gpp-nr-nrm-operatordu {
yang-version 1.1;
namespace "urn:3gpp:sa5:_3gpp-nr-nrm-operatordu";
prefix "operdu3gpp";
import _3gpp-common-top { prefix top3gpp; }
import _3gpp-common-managed-element { prefix me3gpp; }
import _3gpp-nr-nrm-gnbdufunction {prefix gnbdu3gpp; }
organization "3GPP SA5";
contact "https://www.3gpp.org/DynaReport/TSG-WG–S5–officials.htm?Itemid=464";
description "Defines the YANG mapping of the OperatorDU Information Object
Class (IOC) that is part of the NR Network Resource Model (NRM).";
reference "3GPP TS 28.541 5G Network Resource Model (NRM)";
revision 2021-10-01 { reference "Initial revision"; }
grouping OperatorDUGrp {
description "Represents the OperatorDU IOC.";
reference "3GPP TS 28.541";
uses gnbdu3gpp:GNBDUFunctionGrp {
refine gNBId {
mandatory true;
}
refine gNBIdLength {
mandatory true;
}
}
}
augment "/me3gpp:ManagedElement/gnbdu3gpp:GNBDUFunction" {
list OperatorDU {
description "Contains attributes to support the 5G MOCN network sharing.";
reference "3GPP TS 28.541";
key id;
uses top3gpp:Top_Grp;
container attributes {
uses OperatorDUGrp;
}
uses gnbdu3gpp:GNBDUFunctionGrp;
}
}
}
<CODE ENDS>
E.5.36 module _3gpp-nr-nrm-nroperatorcelldu.yang
<CODE BEGINS>
module _3gpp-nr-nrm-nroperatorcelldu {
yang-version 1.1;
namespace "urn:3gpp:sa5:_3gpp-nr-nrm-nroperatorcelldu";
prefix "nropcelld3gpp";
import _3gpp-common-top { prefix top3gpp; }
import _3gpp-common-managed-element { prefix me3gpp; }
import _3gpp-nr-nrm-operatordu { prefix operdu3gpp; }
import _3gpp-5g-common-yang-types { prefix types5g3gpp; }
import _3gpp-common-yang-types { prefix types3gpp; }
import _3gpp-nr-nrm-gnbdufunction { prefix gnbdu3gpp; }
organization "3GPP SA5";
contact "https://www.3gpp.org/DynaReport/TSG-WG–S5–officials.htm?Itemid=464";
description "Defines the YANG mapping of the OperatorDU Information Object
Class (IOC) that is part of the NR Network Resource Model (NRM).";
reference "3GPP TS 28.541 5G Network Resource Model (NRM)";
revision 2021-10-01 { reference "Initial revision"; }
grouping NROperatorCellDUGrp {
description "Represents the NROperatorCellDU IOC.";
reference "3GPP TS 28.541";
uses operdu3gpp:OperatorDUGrp;
leaf cellLocalId {
description "Identifies an NR cell of a gNB. Together with the
corresponding gNB identifier in forms the NR Cell Identity (NCI).";
reference "NCI in 3GPP TS 38.300";
type int32 { range "0..16383"; }
}
leaf administrativeState {
description "Administrative state of the NROperatorCellDU. Indicates the
permission to use or prohibition against using the cell, imposed
through the OAM services.";
type types3gpp:AdministrativeState;
default LOCKED;
}
list pLMNInfoList {
description "The PLMNInfoList is a list of PLMNInfo data type. It
defines which PLMNs that can be served by the NR cell, and which
S-NSSAIs that can be supported by the NR cell for corresponding PLMN
in case of network slicing feature is supported. The plMNId of the
first entry of the list is the PLMNId used to construct the nCGI for
the NR cell.";
key "mcc mnc sd sst";
min-elements 1;
ordered-by user;
uses types5g3gpp:PLMNInfo;
}
leaf nRTAC {
description "The common 5GS Tracking Area Code for the PLMNs.";
reference "3GPP TS 23.003, 3GPP TS 38.473";
type types3gpp:Tac;
}
leaf-list nRCellDURef {
description "Reference to corresponding NRCellDU instance.";
type types3gpp:DistinguishedName;
}
}
augment "/me3gpp:ManagedElement/gnbdu3gpp:GNBDUFunction/operdu3gpp:OperatorDU"
{
list NROperatorCellDU {
description "Contains attributes to support 5G MOCN network sharing.";
reference "3GPP TS 28.541";
key id;
uses top3gpp:Top_Grp;
container attributes {
uses NROperatorCellDUGrp;
}
uses gnbdu3gpp:GNBDUFunctionGrp;
}
}
}
<CODE ENDS>
E.5.37 module _3gpp-nr-nrm-dlbofunction.yang
<CODE BEGINS>
module _3gpp-nr-nrm-dlbofunction {
yang-version 1.1;
namespace "urn:3gpp:sa5:_3gpp-nr-nrm-dlbofunction";
prefix "dlbof3gpp";
import _3gpp-common-subnetwork { prefix subnet3gpp; }
import _3gpp-common-top { prefix top3gpp; }
import _3gpp-nr-nrm-gnbcucpfunction { prefix gnbcucp3gpp; }
import _3gpp-common-managed-element { prefix me3gpp; }
import _3gpp-nr-nrm-nrcellcu { prefix nrcellcu3gpp; }
organization "3GPP SA5";
contact "https://www.3gpp.org/DynaReport/TSG-WG–S5–officials.htm?Itemid=464";
description "Defines the YANG mapping of the DLBOFunction
Information Object Class (IOC) that is part of the NR Network Resource
Model (NRM).";
reference "3GPP TS 28.541 5G Network Resource Model (NRM)";
revision 2022-03-25 { reference "CR-0683"; }
revision 2021-10-22 { reference "CR-0577"; }
feature DLBOUnderGNBCUCPFunction {
description "The DLBOFunction shall be available under
GNBCUCPFunction";
}
feature DLBOUnderManagedElement {
description "The DLBOFunction shall be available under
ManagedElement";
}
feature DLBOUnderSubNetwork {
description "The DLBOFunction shall be available under
SubNetwork";
}
grouping DLBOFunctionGrp {
description "Represents the DLBOFunction IOC.";
leaf dlboControl {
description "This attribute determines whether the LBO function is
enabled or disabled.";
type boolean;
}
leaf maximumDeviationHoTriggerLow {
description "This parameter defines the maximum allowed lower
deviation of the Handover Trigger, from the default point of
operation.";
type int32 { range "-20..20"; }
units "0.5 dB";
}
leaf maximumDeviationHoTriggerHigh {
description "This parameter defines the maximum allowed upper
deviation of the Handover Trigger, from the default point of
operation.";
type int32 { range "-20..20"; }
units "0.5 dB";
}
leaf minimumTimeBetweenHoTriggerChange {
description "This parameter defines the minimum allowed time interval
between two Handover Trigger change performed by MRO. This is used
to control the stability and convergence of the algorithm.";
type int32 { range "0..604800"; }
units "1";
}
}
grouping DLBOFunctionSubtree {
list DLBOFunction {
description "This IOC contains attributes to support the D-SON function
of LBO.
In the case where multiple DLBO MOIs exist at different levels of the
containment tree, the DLBO MOI at the lower level overrides the DLBO
MOIs at higher level(s) of the same containment tree.";
reference "clause 7.1.2 in TS 28.313";
key id;
uses top3gpp:Top_Grp;
container attributes {
uses DLBOFunctionGrp;
}
}
}
augment "/me3gpp:ManagedElement/gnbcucp3gpp:GNBCUCPFunction/"+
"nrcellcu3gpp:NRCellCU" {
if-feature DLBOUnderGNBCUCPFunction;
uses DLBOFunctionSubtree;
}
augment /me3gpp:ManagedElement {
if-feature DLBOUnderManagedElement;
uses DLBOFunctionSubtree;
}
augment /subnet3gpp:SubNetwork {
if-feature DLBOUnderSubNetwork;
uses DLBOFunctionSubtree;
}
}
<CODE ENDS>
E.5.38 module _3gpp-nr-nrm-rimrsset.yang
<CODE BEGINS>
module _3gpp-nr-nrm-rimrsset {
yang-version 1.1;
namespace "urn:3gpp:sa5:_3gpp-nr-nrm-rimrsset";
prefix "rrsset3gpp";
import _3gpp-common-subnetwork { prefix subnet3gpp; }
import _3gpp-common-top { prefix top3gpp; }
import _3gpp-common-yang-types { prefix types3gpp; }
organization "3GPP SA5";
contact "https://www.3gpp.org/DynaReport/TSG-WG–S5–officials.htm?Itemid=464";
description "Defines the YANG mapping of the RimRSSet Information Object
Class (IOC) that is part of the NR Network Resource Model (NRM).";
reference "3GPP TS 28.541 5G Network Resource Model (NRM)";
revision 2021-10-28 { reference CR-0607 ; }
grouping FrequencyDomainParaGrp {
description "Configuration parameters of frequency domain resource to
support RIM RS. ";
leaf rimRSSubcarrierSpacing {
type uint8 {
range 0|1 ;
}
mandatory true;
description
"It is the subcarrier spacing configuration (u) for the RIM-RS.
Subcarrier spacing delta-f=2^u*15 kHz. (see 38.211 subclause 5.3.3).";
}
leaf rIMRSBandwidth {
type uint8 {
range 1..96 ;
}
mandatory true;
description "It is the bandwidth of the RIM-RS in resource blocks
(see 38.211 subclause 5.3.3).
For carrier bandwidth larger than 20MHz, this attribute should be
96 if subcarrier spacing is15kHz
48 or 96 if subcarrier spacing is 30kHz
For carrier bandwidth smaller than or equal to 20MHz, this attribute
should be
Minimum of {96 , bandwidth of downlink carrier in number of PRBs} if
subcarrier spacing is15kHz
Minimum of {48, bandwidth of downlink carrier in number of PRBs } if
subcarrier spacing is 30kHz";
}
leaf nrofGlobalRIMRSFrequencyCandidates {
type uint8 {
range 1|2|4 ;
}
mandatory true;
description "The number of candidate frequency resources in the whole
network (N_f^RIM ) (see 38.211 subclause 7.4.1.6).";
}
leaf-list rimRSCommonCarrierReferencePoint {
type int32 ;
}
leaf rimRSStartingFrequencyOffsetIdList {
type uint32 {
range 0..550;
}
must ‘count(.) = ../nrofGlobalRIMRSFrequencyCandidates’ {
error-message
"The multiplicity must be equal to nrofGlobalRIMRSFrequencyCandidates";
}
description "List of configured frequency offsets in units of resource
blocks, where each element is the frequency offset relative to a
configured reference point for RIM-RS. The size of the list is
nrofGlobalRIMRSFrequencyCandidates and the resulting frequency resource
blocks of RIM-RS corresponding to different configured frequency offset
have no overlapping bandwidth. (see 38.211 subclause 7.4.1.6).
allowedValues: 0..maxNrofPhysicalResourceBlocks-1 where
maxNrofPhysicalResourceBlocks = 550";
}
}
grouping SequenceDomainParaGrp {
description "Configuration parameters of sequence domain resource to
support RIM RS. ";
leaf nrofRIMRSSequenceCandidatesofRS1 {
type uint8 {
range 1..8 ;
}
mandatory true;
description "The number of candidate sequences assigned for RIM RS-1
(N_s^RIM,1) (see 38.211 [subclause 7.4.1.6). It should be even when
enableEnoughNotEnoughIndication for RS-1 is ON";
}
leaf-list rimRSScrambleIdListofRS1 {
type uint32 {
range 0..1023 ;
}
must ‘count(.) = ../nrofRIMRSSequenceCandidatesofRS1’ {
error-message
"The multiplicity must be equal to nrofRIMRSSequenceCandidatesofRS1";
}
description "List of configured scrambling identities for RIM RS-1 (
see 38.211 [subclause 7.4.1.6). The size of the list is
nrofRIMRSSequenceCandidatesofRS1.";
}
leaf nrofRIMRSSequenceCandidatesofRS2 {
type uint8 {
range 1..8 ;
}
mandatory true;
description "The number of candidate sequences assigned for RIM RS-2
(N_s^RIM,2) (see 38.211 subclause 7.4.1.6).";
}
leaf rimRSScrambleIdListofRS2 {
type uint32 {
range 0..1023 ;
}
must ‘count(.) = ../nrofRIMRSSequenceCandidatesofRS2’ {
error-message
"The multiplicity must be equal to nrofRIMRSSequenceCandidatesofRS2";
}
description "List of configured scrambling identities for RIM RS-2 (
see 38.211 subclause 7.4.1.6).
The size of the list is nrofRIMRSSequenceCandidatesofRS2.";
}
leaf enableEnoughNotEnoughIndication {
type types3gpp:EnabledDisabled;
default DISABLED;
description "It is indication of whether ‘Enough’/’Not enough’ indication
functionality is enabled for RIM RS-1 (see 38.211 subclause 7.4.1.6).
If the indication is ‘ENABLED’, the first half of
nrofRIMRSSequenceCandidatesofRS1 sequences indicates ‘Not enough
mitigation’, and the second half indicates ‘Enough mitigation’, where,
‘Enough mitigation’ indicates that IoT going back to certain level at
victim side and/or no further interference mitigation actions are
needed at aggressor side
‘Not enough mitigation’ indicates that IoT exceeding certain level at
victim side and/or further interference mitigation actions are needed
at aggressor side
enableEnoughNotEnoughIndication is equivalent to EnoughIndication
(see 38.211 subclause 7.4.1.6)";
}
leaf RIMRSScrambleTimerMultiplier {
type uint32 {
range 0..2147483647;
}
mandatory true;
description "It is parameter multiplier factor gamma for initialization
seed of the pseudo-random sequence c~(i)
(see 38.211 subclause 7.4.1.6.2).
allowedValues: 0,1…2^31-1";
}
leaf RIMRSScrambleTimerOffset {
type uint32 {
range 0..2147483647;
}
mandatory true;
description "It is parameter offset delta for initialization seed of
the pseudo-random sequence c~(i) (see 38.211 subclause 7.4.1.6.2).
allowedValues: 0,1…2^31-1";
}
}
grouping TimeDomainParaGrp {
description "Configuration parameters of time domain resource to
support RIM RS. ";
leaf dlULSwitchingPeriod1 {
type enumeration {
enum MS0P5;
enum MS0P625;
enum MS1;
enum MS1P25;
enum MS2;
enum MS2P5;
enum MS3;
enum MS4;
enum MS5;
enum MS10;
enum MS20;
}
mandatory true;
description "This attribute is used to configure the first uplink-downlink
switching period (P1) for RIM RS transmission in the network, where one
RIM RS is configured in one uplink-downlink switching period.
(see 38.211 subclause 7.4.1.6).
When only one TDD-UL-DL-Pattern is configured, only
dl-UL-SwitchingPeriod1 is configured, where P1 equals to the
transmission periodicity of the TDD-UL-DL-Pattern.
When two concatenated TDD-UL-DL-Patterns are configured, and RIM-RS
resources is configured only in one of the TDD patterns, only
dl-UL-SwitchingPeriod1 is configured, where P1 equals to the addition
of the concatenated transmission periodicity of the two
TDD-UL-DL-Patterns.
When two concatenated TDD-UL-DL-Patterns are configured, and RIM-RS
resources are configured in both TDD patterns, both
dl-UL-SwitchingPeriod1 and dl-UL-SwitchingPeriod2 are configured,
where P1 equals to the transmission periodicity of the first
TDD-UL-DL-Pattern.
P1 is equivalent to T_(per,1)^RIM (see 38.211, subclause 7.4.1.6).
allowedValues:
MS0P5, MS0P625, MS1, MS1P25, MS2, MS2P5, MS4, MS5, MS10, MS20,
if a single uplink-downlink period is configured for RIM-RS purposes;
MS0P5, MS0P625, MS1, MS1P25, MS2, MS2P5, MS3, MS4, MS5, MS10, MS20,
if two uplink-downlink periods are configured for RIM-RS purposes.";
}
leaf symbolOffsetOfReferencePoint1 {
type uint32 {
range 2..327679 ;
}
mandatory true;
description "This attribute is used to configure the reference point in
the first uplink-downlink switching period, which is the symbols offset
of the reference point after the starting boundary of the first
uplink-downlink switching period. It’s Configured together with
dl-UL-SwitchingPeriod1 (see 38.211 subclause 7.4.1.6).
When only one TDD-UL-DL-Pattern is configured, the reference point
configured for the first uplink-downlink switching period is the DL
transmission boundary of the TDD-UL-DL-Pattern.
When two concatenated TDD-UL-DL-Patterns are configured, and RIM-RS
resources is configured only in one of the TDD patterns, the reference
point configured for the first uplink-downlink switching period is the
DL transmission boundary of the TDD-UL-DL-Pattern where the RIM-RS
resource is configured.
When two concatenated TDD-UL-DL-Patterns are configured, and RIM-RS
resources are configured in both TDD patterns, the reference points
configured for first uplink-downlink switching period is the DL
transmission boundary of the first TDD-UL-DL-Pattern.
allowedValues: 2, 3..20*2*maxNrofSymbols-1, where maxNrofSymbols=14";
}
leaf dlULSwitchingPeriod2 {
type enumeration {
enum MS0P5;
enum MS0P625;
enum MS1;
enum MS1P25;
enum MS2;
enum MS2P5;
enum MS3;
enum MS4;
enum MS5;
enum MS10;
}
mandatory true;
description "Used to configure the second uplink-downlink switching
period (P2) for RIM RS transmission in the network, where one RIM RS is
configured in one uplink-downlink switching period
(see 38.211 subclause 7.4.1.6).
When two concatenated TDD-UL-DL-Patterns are configured, and RIM-RS
resources are configured in both TDD patterns, both
dl-UL-SwitchingPeriod1 and dl-UL-SwitchingPeriod2 are configured,
where P2 equals to the transmission periodicity of the second
TDD-UL-DL-Pattern, and where (P1 + P2) divides 20 ms.
allowedValues: MS0P5, MS0P625, MS1, MS1P25, MS2, MS2P5, MS3, MS4, MS5,
MS10
P2 is equivalent to T_(per,2)^RIM (see 38.211 subclause 7.4.1.6)";
}
leaf symbolOffsetOfReferencePoint2 {
type uint32 {
range 2..327679 ;
}
mandatory true;
description "This attribute is used to configure the reference point in
the second uplink-downlink switching period, which is the symbol offset
of the reference point after starting boundary of the second
uplink-downlink switching period. Configured together with
dl-UL-SwitchingPeriod2 (see 38.211 subclause 7.4.1.6).
When two concatenated TDD-UL-DL-Patterns are configured, and RIM-RS
resources are configured in both TDD patterns, the reference points
configured for second uplink-downlink switching period is the
DL transmission boundary of the second TDD-UL-DL-Pattern.
allowedValues: 2, 3..20*2*maxNrofSymbols-1, where maxNrofSymbols=14";
}
leaf totalnrofSetIdofRS1 {
type uint32 {
range 0..4194303 ;
}
mandatory true;
description "It is the total number of set IDs for RIM RS-1
(N_setID ^RIM,1) (see 38.211 subclause 7.4.1.6).
allowedValues: 0,1…2^22-1";
}
leaf totalnrofSetIdofRS2 {
type uint32 {
range 0..4194304 ;
}
mandatory true;
description "It is the total number of set IDs for RIM RS-2
(N_setID^RIM,2) (see 38.211 subclause 7.4.1.6).
allowedValues: 0,1…2^22";
}
leaf nrofConsecutiveRIMRS1 {
type uint8 {
range 1|2|4|8 ;
}
mandatory true;
description "It is the number of consecutive uplink-downlink switching
periods for RS-1 (R1) for repetition/near-far indication:.
(see 38.211 subclause 7.4.1.6).
allowedValues: 1,2,4,8";
}
leaf nrofConsecutiveRIMRS2 {
type uint8 {
range 1|2|4|8 ;
}
mandatory true;
description "It is the number of consecutive uplink-downlink switching
periods for RS-2 (R2) for repetition/near-far indication.
(see 38.211 subclause 7.4.1.6).
allowedValues: 1,2,4,8";
}
leaf-list consecutiveRIMRS1List {
type uint32 {
range 2..327679 ;
}
description "It is used to configure the OFDM symbol position(s) of RIM
RS-1 within the uplink-downlink switching period. It is a list of symbol
offset of RIM RS-1 (N_symb,ref^(RIM,1)) before the reference point.
The size of the list is nrofConsecutiveRIMRS1
(see 38.211 subclause 7.4.1.6).
The resulting RIM RS-1 symbols and its reference point shall belong to
the same 10ms frame.
allowedValues: 2,3..20*2**maxNrofSymbols-1, where maxNrofSymbols=14";
}
leaf-list consecutiveRIMRS2List {
type uint32 {
range 2..327679 ;
}
description "It is used to configure the OFDM symbol position(s) of
RIM RS-2 within the uplink-downlink switching period. It is a list of
symbol offset of RIM RS-2 (N_symb,ref^(RIM,2)) before the reference
point. The size of the list is nrofConsecutiveRIMRS2
(see 38.211 subclause 7.4.1.6).
The resulting RIM RS-2 symbols and its reference point shall belong to
the same 10ms frame.
allowedValues: 2,3..20*2**maxNrofSymbols-1, where maxNrofSymbols=14";
}
leaf enablenearfarIndicationRS1 {
type types3gpp:EnabledDisabled;
default DISABLED;
description "It is indication of whether near-far functionality is enabled
for RIM RS1.
If the indication is ‘ENABLED’,
the first half of nrofConsecutiveRIMRS1 (R1) consecutive uplink-downlink
switching period is for ‘Near’ indication with R1/2 repetitions,
the second half of R1 consecutive uplink-downlink switching period is
for ‘Far’ indication with R1/2 repetitions.";
}
leaf enablenearfarIndicationRS2 {
type types3gpp:EnabledDisabled;
default DISABLED;
description "It is indication of whether near-far functionality is enabled
for RIM RS2.
If the indication is ‘enable’,
the first half of nrofConsecutiveRIMRS2 (R2) consecutive uplink-downlink
switching period is for ‘Near’ indication with R2/2 repetitions,
the second half of R2 consecutive uplink-downlink switching period is
for ‘Far’ indication with R2/2 repetitions.";
}
}
grouping RimRSGlobalGrp {
description "Represents the RimRSGlobal IOC.";
list frequencyDomainPara {
key rimRSSubcarrierSpacing;
min-elements 1;
max-elements 1;
description "Configuration parameters of frequency domain resource to
support RIM RS. ";
uses FrequencyDomainParaGrp;
}
list sequenceDomainPara {
key nrofRIMRSSequenceCandidatesofRS1;
min-elements 1;
max-elements 1;
description "Configuration parameters of sequence domain resource to
support RIM RS. ";
uses SequenceDomainParaGrp;
}
list timeDomainPara {
key dlULSwitchingPeriod1;
min-elements 1;
max-elements 1;
description "Configuration parameters of time domain resource to
support RIM RS. ";
uses TimeDomainParaGrp;
}
}
grouping RimRSSetGrp {
description "Represents the RimRSSet IOC.";
leaf setId {
type uint32 {
range 0..4194303 ;
}
mandatory true;
description "This specifies the set ID of a victim Set (RIM-RS1 Set) or
aggressor Set (RIM-RS2 set). (See subclause 7.4.1.6 in TS 38.211).
allowedValues: The bit length of the set ID is maximum 22bit.";
}
leaf setType {
type enumeration {
enum RS1;
enum RS2;
}
mandatory true;
description "The attribute specifies type of a RIM-RS Set .
RIM RS1 is generated and transmitted by victim to indicate its suffering
remote interference, and RIM RS2 is generated and transmitted by
aggressor to measure if Remote Interference still exist
If the attribute value is ‘RS1’, the RIM-RS Set is victim set.
If the attribute value is ‘RS2’, the RIM-RS Set is aggressor set.";
}
leaf-list nRCellDURef {
type types3gpp:DistinguishedName;
config false;
description "This attribute contains the DN of a NR Cell (NRCellDU)";
}
}
augment "/subnet3gpp:SubNetwork" {
list RimRSGlobal {
description "Represents global/common Remote Interference Management (RIM)
Reference Signal (RS) resource allocated for the whole network.
Resource for RIM-RS transmission is defined by Sequence domain resource,
Time domain resource and Frequency resource. The configure parameters
of the RIM RS resource are applied to all Sets of RIM RS Resource
across gNBs/cells in the network.";
key id;
max-elements 1;
uses top3gpp:Top_Grp;
container attributes {
uses RimRSGlobalGrp;
}
list RimRSSet {
description "Represents aggressor or victim Set organized by OAM.
The RIM RS Resource is assigned to each Set, which is identified by
triple indices set of
<Time domain index, Frequency domain index, and Sequence index >.
The triple indices set can be derived by setId attribute
(See subclause 7.4.1.6 in TS 38.211 ).";
key id;
uses top3gpp:Top_Grp;
container attributes {
uses RimRSSetGrp;
}
}
}
}
}
<CODE ENDS>
E.5.39_module 3gpp-nr-nrm-bwpset.yang
<CODE BEGINS>
module _3gpp-nr-nrm-bwpset {
yang-version 1.1;
namespace "urn:3gpp:sa5:_3gpp-nr-nrm-bwpset";
prefix "bwpset3gpp";
import _3gpp-common-managed-element { prefix me3gpp; }
import _3gpp-common-managed-function { prefix mf3gpp; }
import _3gpp-common-top { prefix top3gpp; }
import _3gpp-nr-nrm-gnbdufunction { prefix gnbdu3gpp; }
organization "3GPP SA5";
contact "https://www.3gpp.org/DynaReport/TSG-WG–S5–officials.htm?Itemid=464";
description "Defines the YANG mapping of the BWPSet Information Object Class
(IOC) that is part of the NR Network Resource Model (NRM).";
reference "3GPP TS 28.541 5G Network Resource Model (NRM)";
revision 2022-06-29 { reference CR-0756 ; }
grouping BWPSetGrp {
description "Represents the BWPSet IOC.";
reference "3GPP TS 28.541";
uses mf3gpp:ManagedFunctionGrp;
}
augment "/me3gpp:ManagedElement/gnbdu3gpp:GNBDUFunction" {
list BWPList {
description "Represents a bandwidth part (BWP) set.";
key id;
uses top3gpp:Top_Grp;
container attributes {
uses BWPSetGrp;
}
uses mf3gpp:ManagedFunctionContainedClasses;
}
}
}
<CODE ENDS>