1 module o-ran-uplane-conf {
3 namespace "urn:o-ran:uplane-conf:1.0";
4 prefix "o-ran-uplane-conf";
6 import o-ran-processing-element {
10 import ietf-interfaces {
14 import o-ran-module-cap {
16 revision-date 2020-12-10;
19 import o-ran-compression-factors {
21 revision-date 2020-08-10;
24 organization "O-RAN Alliance";
30 "This module defines the module capabilities for
31 the O-RAN Radio Unit U-Plane configuration.
33 Copyright 2020 the O-RAN Alliance.
35 THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS 'AS IS'
36 AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
37 IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
38 ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
39 LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
40 CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
41 SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
42 INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
43 CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
44 ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
45 POSSIBILITY OF SUCH DAMAGE.
47 Redistribution and use in source and binary forms, with or without
48 modification, are permitted provided that the following conditions are met:
50 * Redistributions of source code must retain the above copyright notice,
51 this list of conditions and the above disclaimer.
52 * Redistributions in binary form must reproduce the above copyright notice,
53 this list of conditions and the above disclaimer in the documentation
54 and/or other materials provided with the distribution.
55 * Neither the Members of the O-RAN Alliance nor the names of its
56 contributors may be used to endorse or promote products derived from
57 this software without specific prior written permission.";
59 revision "2020-12-10" {
63 1) introduces new coupling method coupling-via-frequency-and-time-with-priorities-optimized
64 2) introduces new max-highest-priority-sections-per-slot parameter";
66 reference "ORAN-WG4.M.0-v05.00";
69 revision "2020-08-10" {
73 1) parameters allowing for static PRACH configuration introduced
74 2) parameters allowing for static SRS configuration introduced
75 3) parameters allowing for configuration of TDD pattern introduced
76 4) Backward compatible change to introduce new parameter 'coupling-method' related
77 to Section Description Priority to serve for CUS-Plane CR";
79 reference "ORAN-WG4.M.0-v04.00";
82 revision "2020-04-17" {
86 1) Adding optional little endian support
87 2) Adding a new capability parameter to indicate that the O-RU
88 supports regularizationFactor in section type 5
89 3) Added support for Dynamic Spectrum Sharing feature
90 4) Clarify the supported number of reMasks in RU side
91 5) Section extension for grouping multiple ports
92 6) adding PRACH formats to endpoint capabilities";
94 reference "ORAN-WG4.M.0-v03.00";
97 revision "2019-07-03" {
101 1) added new leaf multiple-numerology-supported to enable O-RU to report
102 whether it supports multiple numerologies.
104 2) fixing broken constraints (configuration cannot be dependent on
105 operational state). This is a backwards incompatible revision.
107 As these constraints only apply when the LAA feature is used, and also
108 when considering the limited number of implementation that need to be
109 taken into consideration for backwards compatibility, it has been
110 agreed to NOT increment the namespace integer.
112 3) added frequency related capabilities for tx-arrays and rx-array
114 4) removed redundant LAA import";
116 reference "ORAN-WG4.M.0-v01.00";
119 revision "2019-02-04" {
123 1) imported model from xRAN
124 2) changed namespace and reference from xran to o-ran";
126 reference "ORAN-WG4.M.0-v01.00";
129 feature EAXC-GAIN-CORRECTION {
131 "Presence of feature indicates that O-RU supports eAxC specific gain correction.";
134 feature TX-REFERENCE-LEVEL {
136 "Presence of feature indicates that O-RU supports TX gain reference level control";
139 typedef prach-preamble-format {
143 "LTE PRACH Preamble format 0";
147 "LTE PRACH Preamble format 1";
151 "LTE PRACH Preamble format 2";
155 "LTE PRACH Preamble format 3";
159 "LTE PRACH Preamble format 4";
163 "LTE Narrowband PRACH format 0";
167 "LTE Narrowband PRACH format 1";
171 "5GNR PRACH Preamble format 0";
175 "5GNR PRACH Preamble format 1";
179 "5GNR PRACH Preamble format 2";
183 "5GNR PRACH Preamble format 3";
187 "5GNR PRACH Preamble format A1";
191 "5GNR PRACH Preamble format A2";
195 "5GNR PRACH Preamble format A3";
199 "5GNR PRACH Preamble format B1";
203 "5GNR PRACH Preamble format B2";
207 "5GNR PRACH Preamble format B3";
211 "5GNR PRACH Preamble format B4";
215 "5GNR PRACH Preamble format C0";
219 "5GNR PRACH Preamble format C2";
224 "PRACH preamble format definition";
227 typedef polarisation_type {
230 description "MINUS_45";
236 description "PLUS_45";
239 description "PLUS_90";
242 description "Type definition for polarisations";
245 grouping general-config {
246 description "a group for general configuration";
248 container general-config {
249 description "a container for general configuration";
251 leaf regularization-factor-se-configured {
255 "Informs if regularizationfactor in section extension is configured(true) or not(false), this
256 leaf indicates whether the O-DU will send the regularizationfactor in section extension.
258 If the O-RU does not support regularization-factor-se-supported in o-ran-module-cap.yang,
259 this leaf is ignored.";
262 leaf little-endian-byte-order {
267 "If little endian byte order for C/U plane data flows is supported by
268 the O-RU, indicates if the O-RU should use little endian byte order
269 for all UL and DL C/U plane data flows.
271 If little endian byte order is NOT supported, this node is ignored
272 (and the default bigendian byte order used)";
277 grouping laa-carrier-config {
278 description "Carrier Configuration for support of LAA. ";
279 leaf ed-threshold-pdsch {
283 "This value indicates Energy Detection(ED) threshold for LBT for PDSCH and for measurements in dBm.";
286 leaf ed-threshold-drs {
290 "This value indicates Energy Detection(ED) threshold for LBT for DRS in dBm.";
293 leaf tx-antenna-ports {
296 "This value indicates Tx antenna ports for DRS (1, 2, 4)";
299 leaf transmission-power-for-drs {
303 "This value indicates offset of Cell specific reference Signal(CRS) power to reference signal power (dB).
304 DRS signal consists of CRS, PSS, SSS, and optionally CSI-RS.";
317 enum ONE-HUNDRED-SIXTY {
324 "This value indicates DRS measurement timing configuration (DMTC) period in ms";
331 "This value indicates dmtc offset in Subframes.";
338 "This value indicates LBT Timer in milliseconds.";
341 list max-cw-usage-counter {
342 when "/mcap:module-capability/mcap:rw-sub-band-info/mcap:rw-self-configure = 'true'";
348 description "priority 1";
351 description "priority 2";
354 description "priority 3";
357 description "priority 4";
360 description "This value provides the priority class traffic for which the counter is calculated.";
367 description "This value indicates the maximum value of counter
368 which shows how many max congestion window value is used for backoff
369 number of priority class traffic. This value is defined at 3GPP 36.213
370 section 15.1.3 as K.";
375 grouping coupling-methods {
377 "Grouping for configuration of desired C-Plane / U-Plane coupling methods (if supported)";
380 path "/mcap:module-capability/mcap:ru-capabilities/mcap:coupling-methods/mcap:coupling-via-frequency-and-time";
381 require-instance false;
385 "RW instance of RO parameter.";
387 leaf coupling-method {
388 when "../coupling-to = 'true'";
391 description "Coupling via sectionId value. This value can be used always.";
393 enum FREQUENCY_AND_TIME {
394 description "Coupling via frequency and time. Can be used when coupling-via-frequency-and-time = true
395 or coupling-via-frequency-and-time-with-priorities = true in o-ran-module-cap.yang";
397 enum FREQUENCY_AND_TIME_WITH_PRIORITIES {
398 description "Coupling via frequency and time with priorities. Can be used when
399 coupling-via-frequency-and-time-with-priorities = true in o-ran-module-cap.yang";
401 enum FREQUENCY_AND_TIME_WITH_PRIORITIES_OPTIMIZED {
402 description "Coupling via frequency and time with priorities optimized. Can be used when
403 coupling-via-frequency-and-time-with-priorities-optimized = true in o-ran-module-cap.yang";
408 "Method of coupling between C-Plane and U-Plane messages; see methods of coupling
409 of C-Plane and U-Plane in CUS-Plane specification. If an O-RU doesn't support the
410 necessary capability as defined in o-ran-module-cap.yang, the O-RU shall respond
411 with rpc-error including an error-message describing the error condition";
417 "One eAxC identifier (eAxC ID) comprises a band and sector
418 identifier (BandSector_ID), a component-carrier identifier (CC_ID) and a
419 spatial stream identifier (RU_Port_ID).
421 In this version of the specification, one eAxC contains only one spatial
422 stream (i.e. one beam per subcarrier) at a time.
424 Bit allocation is subdivided as follows:
425 * O_DU_Port_ID: Used to differentiate processing units at O-DU
426 * BandSector_ID: Aggregated cell identifier
427 * CC_ID: distinguishes Carrier Components
428 * RU_Port_ID: Used to differentiate spatial streams or beams on the O-RU
430 The bitwidth of each of the above fields is variable this model is supposed to check
431 if we are occpying bits continuously but we do not have to occupy all 16 bits";
434 leaf o-du-port-bitmask {
438 "mask for eaxc-id bits used to encode O-DU Port ID";
441 leaf band-sector-bitmask {
445 "mask for eaxc-id bits used to encode the band sector ID";
452 "mask for eaxc-id bits used to encode the component carrier id";
455 leaf ru-port-bitmask {
459 "mask for eaxc-id bits used to encode the O-RU Port ID";
466 "encoded value of eaxcid to be read by CU-Plane";
470 grouping parameters {
472 "Grouping of all parameters common between UL and DL";
477 description "Unique name of array antenna";
480 leaf number-of-rows {
483 description "Number of rows array elements are shaped into - M";
486 leaf number-of-columns {
489 description "Number of columns array elements are shaped into - N";
492 leaf number-of-array-layers {
495 description "Number of array layers array elements are shaped into - Q";
498 leaf horizontal-spacing {
504 description "Average distance between centers of nearby AE in horizontal direction (in array coordinates system)";
507 leaf vertical-spacing{
513 description "Average distance between centers of nearby AE in vertical direction (in array coordinates system)";
516 container normal-vector-direction {
518 "Counter-clockwise rotation around z and y axis.";
526 description "Azimuth angle, counter-clockwise rotation around z-axis. Value 'zero' points to broad-side, value '90' points to y-axis";
534 description "Zenith angle, counter-clockwise rotation around y-axis. Value 'zero' points to zenith, value '90' points to horizon";
538 container leftmost-bottom-array-element-position {
539 description "Structure describing position of leftmost, bottom array element.";
546 description "X dimension of position of leftmost, bottom array element";
555 description "Y dimension of position of leftmost, bottom array element";
564 description "Z dimension of position of leftmost, bottom array element";
573 "List of supported polarisations.";
579 "Polarisation index. See CUS-plane";
583 type polarisation_type;
585 description "Type of polarisation supported by array.";
590 path "/mcap:module-capability/mcap:band-capabilities/mcap:band-number";
594 "This parameter informing which frequency band particular antenna
595 array is serving for.
596 Intended use is to deal with multiband solutions.";
600 grouping array-choice {
601 choice antenna-type {
605 path "/o-ran-uplane-conf:user-plane-configuration/o-ran-uplane-conf:tx-arrays/o-ran-uplane-conf:name";
609 "Leafref to tx array if such is choosen";
615 path "/o-ran-uplane-conf:user-plane-configuration/o-ran-uplane-conf:rx-arrays/o-ran-uplane-conf:name";
619 "Leafref to rx array if such is choosen";
623 "Choice for antenna type";
626 "Elements which groups choice for antenna type";
629 grouping scs-config {
631 "It groups all parameters related to SCS configuration";
633 leaf frame-structure {
637 "This parameter defines the frame structure. The first 4 bits define the FFT/iFFT size
638 being used for all IQ data processing related to this message.
639 The second 4 bits define the sub carrier spacing as well as the number of slots per 1ms sub-frame
640 according to 3GPP TS 38.211, taking for completeness also 3GPP TS 36.211 into account";
647 "Normal cyclic prefix";
652 "Extended cyclic prefix";
657 "Provides type of CP (cyclic prefix) if section type 3 is not used or type of CP cannot be determined from cpLength.";
665 "Used for symbol 0 for NR & LTE, and symbol 7*2u for NR.
669 leaf cp-length-other {
674 "Used for other symbols than by cp-length above";
677 leaf offset-to-absolute-frequency-center {
681 "This provides value of freqOffset to be used if section type 3 is not used. See freqOffset in CUS-plane.
682 offset-to-absolute-frequency-center defines the relative spacing between the center of RE#0 of RB#0 to the center-of-channel-bandwidth.
683 If offset-to-absolute-frequency-center for NR with SCS=15kHz is odd,
684 it implies that 7.5kHz shift as indicated by the parameter frequencyShift7p5khz for UL is applied.
685 When type (in tx/rx-array-carrier) is DSS, “offset-to-absolute-frequency-center” indicates the 1st RE of 1st RB of NR.";
688 list number-of-prb-per-scs {
691 "List of configured for each SCS that will be used.";
694 type mcap:scs-config-type;
696 "Value corresponds to SCS values defined for frameStructure in C-plane.
697 Note: set of allowed values is restricted by SCS derived from values in supported-frame-structures.";
704 "Determines max number of PRBs that will be used in all sections per one symbol.
705 This is affecting allocation of resources to endpoint. Value shall not exceed constrains
706 defined by max-prb-per-symbol of endpoint type. In addition sum (over all used epoints
707 within a group of endpoints sharing resources) of number-of-prb rounded up to
708 nearest value from prb-capacity-allocation-granularity shall not exceed max-prb-per-symbol of the group.";
713 grouping tx-common-array-carrier-elements {
715 "This grouping containes all common parameters for tx-array-carriers and rx-array-carriers";
717 leaf absolute-frequency-center {
721 "deprecated in version 5.0.0 and replaced with offset-to-absolute-frequency-center
722 and common FREF translated from absolute-frequency-center (NREF) as defined in 38.104";
725 leaf center-of-channel-bandwidth {
730 "Center frequency of channel bandwidth in Hz. Common for all numerologies.
731 center-of-channel-bandwidth is the FREF translated from absolute-frequency-center (NREF) as per 3GPP TS 38.104";
734 leaf channel-bandwidth {
740 "Width of carrier given in Hertz";
747 "carrier does not provide signal - transmission is disabled";
751 "carrier is fully configured and was active but is energy saving mode";
755 "carrier is fully configured and properly providing the signal";
761 "Indicates if transmission is enabled for this array carriers. Note that Netconf server uses state parameter
762 to indicate actual state of array carriers operation. When array carriers is in sleep status,
763 Netconf server rejects all other operation request to tx-array-carriers object except either request to change from sleep
764 to active status or delete MO operation (see 4.8) to the object.";
771 "array carrier is not active - transmission of signal is disabled.";
775 "array carrier is processing an operation requested by change of active parameter.
776 When array carriers is BUSY the transmission of signal is not guaranteed.";
780 "array carrier had completed activation operation - is active and transmission of signal is ongoing.";
786 "Indicates state of array carriers activation operation";
800 if-feature mcap:DSS_LTE_NR;
802 "NR and LTE technologies in Dynamic Spectrum Sharing mode";
806 "Type of carrier. Indicates array-carrier technology.";
823 "Type of duplex scheme O-RU supports.";
825 leaf rw-duplex-scheme {
827 path "/user-plane-configuration/tx-array-carriers[name=current()/../name]" + "/duplex-scheme";
828 require-instance false;
831 "Config true type of duplex scheme.";
835 path "/user-plane-configuration/tx-array-carriers[name=current()/../name]" + "/type";
836 require-instance false;
839 "Config true type of carrier.";
843 grouping rx-common-array-carrier-elements {
845 "This grouping containes all common parameters for tx-array-carriers and rx-array-carriers";
847 leaf absolute-frequency-center {
851 "deprecated in version 5.0.0 and replaced with offset-to-absolute-frequency-center
852 and common FREF translated from absolute-frequency-center (NREF) as defined in 38.104";
855 leaf center-of-channel-bandwidth {
860 "Center frequency of channel bandwidth in Hz. Common for all numerologies.
861 center-of-channel-bandwidth is the FREF translated from absolute-frequency-center (NREF) as per 3GPP TS 38.104";
864 leaf channel-bandwidth {
870 "Width of carrier given in Hertz";
877 "carrier does not provide signal - transmission is disabled";
881 "carrier is fully configured and was active but is energy saving mode";
885 "carrier is fully configured and properly providing the signal";
891 "Indicates if transmission is enabled for this array carriers. Note that Netconf server uses state parameter
892 to indicate actual state of array carriers operation. When array carriers is in sleep status,
893 Netconf server rejects all other operation request to tx-array-carriers object except either request to change from sleep
894 to active status or delete MO operation (see 4.8) to the object.";
901 "array carrier is not active - transmission of signal is disabled.";
905 "array carrier is processing an operation requested by change of active parameter.
906 When array carriers is BUSY the transmission of signal is not guaranteed.";
910 "array carrier had completed activation operation - is active and transmission of signal is ongoing.";
916 "Indicates state of array carriers activation operation";
930 if-feature mcap:DSS_LTE_NR;
932 "NR and LTE technologies in Dynamic Spectrum Sharing mode";
936 "Type of carrier. Indicates array-carrier technology.";
953 "Type of duplex scheme O-RU supports.";
957 grouping endpoint-section-capacity {
958 leaf max-control-sections-per-data-section {
963 "Max number of C-plane sections (C-plane section is part of C-plane message that carries 'section fields')
964 referring to same U-plane section (U-plane section is part of U-plane message that carries
965 'section header fields' and 'PRB fields') that is supported by endpoint.
966 Note that additional limitations specific for each section type apply on top of this number.";
968 leaf max-sections-per-symbol {
971 "Max number of sections within one symbol that can be processed by endpoint
972 or processed collectively by group of endpoints sharing capacity";
974 leaf max-sections-per-slot {
977 "Max number of sections within one slot that can be processed by endpoint
978 or processed collectively by group of endpoints sharing capacity.";
980 leaf max-highest-priority-sections-per-slot {
981 must "current()<../max-sections-per-slot" {
982 error-message "the sectionID for the highest priority needs to be less than the max sectionIds per slot";
986 "Max number of highest priority sections within one slot that can be processed by endpoint or processed collectively by
987 group of endpoints sharing capacity. This leaf applies only when coupling-via-frequency-and-time-with-priorities-optimized
988 is true, in other instances this leaf is ignored by the O-RU. The sectionId for highest priority section descriptions shall
989 start from 0 to specified max value and is a subset of max-sections-per-slot and must be less than max-sections-per-slot.";
992 leaf max-remasks-per-section-id {
998 "maximum number of different reMask values that is applied to a PRB
999 within one section id. This value can be processed by endpoint
1000 or processed collectively by group of endpoints sharing capacity";
1004 "Parameters describing section capacity where section is undestood as number of different sectionId values";
1007 grouping endpoint-beam-capacity {
1008 leaf max-beams-per-symbol {
1011 "Max number of beams within one symbol that can be processed by endpoint
1012 or processed collectively by group of endpoints sharing capacity";
1014 leaf max-beams-per-slot {
1017 "Max number of beams within one slot that can be processed by endpoint
1018 or processed collectively by group of endpoints sharing capacity";
1022 "Parameters describing beam capacity where number of beams is understood as number of different beamId values";
1025 grouping endpoint-prb-capacity {
1026 leaf max-prb-per-symbol {
1029 "Max number of prbs within one symbol that can be processed by endpoint
1030 or processed collectively by group of endpoints sharing capacity";
1034 "Attributes presenting processing capacity related to PRB.";
1037 grouping endpoint-numerology-capacity {
1038 leaf max-numerologies-per-symbol {
1041 "Max number of numerologies within one symbol that can be processed by endpoint
1042 or processed collectively by group of endpoints sharing capacity";
1046 "Attributes presenting processing capacity related to numerology.
1048 This leaf contains valid data only when multiple-numerology-supported
1052 grouping endpoint-static-config-support {
1053 leaf static-config-supported {
1057 "The endpoint does not support static PRACH / SRS configuration.
1058 Reception of PRACH / SRS is possible through real time C-Plane messages
1059 if other endpoint capabilities allow for that.";
1062 if-feature mcap:PRACH-STATIC-CONFIGURATION-SUPPORTED;
1064 "The endpoint supports statically configured PRACH reception";
1067 if-feature mcap:SRS-STATIC-CONFIGURATION-SUPPORTED;
1069 "The endpoint supports statically configured SRS reception";
1075 "The parameter informs if endpoint can be statically configured to process PRACH or SRS reception";
1078 leaf max-prach-patterns {
1079 when "(/user-plane-configuration/static-low-level-rx-endpoints[name=current()/../name]/static-config-supported = 'PRACH')";
1082 "Maximum number of PRACH patterns the endpoint can handle in PRACH configuration";
1085 leaf max-srs-patterns {
1086 when "(/user-plane-configuration/static-low-level-rx-endpoints[name=current()/../name]/static-config-supported = 'SRS')";
1089 "Maximum number of SRS patterns the endpoint can handle in SRS configuration";
1093 "Endpoint's capabilities related to static PRACH / SRS configuration.";
1096 grouping endpoint-tdd-pattern-support {
1097 leaf configurable-tdd-pattern-supported {
1098 if-feature mcap:CONFIGURABLE-TDD-PATTERN-SUPPORTED;
1103 "The parameter informs if endpoint supports configuration for TDD pattern";
1109 "Parameter is used to group static-low-level-[tr]x-endpoints.
1110 Note: [tr]x-array-carriers using static-low-level-[tr]x-endpoints
1111 having the same value of tdd-group, must have the same TDD switching
1112 points and the same directions to the air interface granted - regardless TDD switching
1113 is controlled by M-Plane or by C-Plane";
1117 "This grouping exposes static-low-level-[tr]x-endpoint's capabilities related to its support for configurable
1118 TDD patterns and limitations regarding common TDD switching per groups of endpoints.";
1121 grouping uplane-conf-group {
1123 "Grouping for uplane configuration related parameters";
1125 list low-level-tx-links {
1128 "Object model for low-level-tx-link configuration";
1133 "Unique name of low-level-tx-link object.";
1136 leaf processing-element {
1138 path "/o-ran-pe:processing-elements/o-ran-pe:ru-elements/o-ran-pe:name";
1142 "Contains name of processing-element to be used as transport by low-level-tx-link";
1145 leaf tx-array-carrier {
1147 path "/user-plane-configuration/tx-array-carriers/name";
1151 "Contains name of tx-array-carriers MO to be used as transport by low-level-tx-link";
1154 leaf low-level-tx-endpoint {
1156 path "/user-plane-configuration/low-level-tx-endpoints/name";
1160 "Contains name of low-level-tx-endpoints MO to be used as transport by low-level-tx-link";
1164 list low-level-rx-links {
1167 "Object model for low-level-rx-links configuration";
1173 "Unique name of low-level-rx-links object.";
1176 leaf processing-element {
1178 path "/o-ran-pe:processing-elements/o-ran-pe:ru-elements/o-ran-pe:name";
1182 "Contains name of processing-element to be used as transport by LowLevelTxLink";
1185 leaf rx-array-carrier {
1187 path "/user-plane-configuration/rx-array-carriers/name";
1192 "Contains name of rx-array-carriers MO to be used as transport by low-level-rx-links";
1195 leaf low-level-rx-endpoint {
1197 path "/user-plane-configuration/low-level-rx-endpoints/name";
1202 "Contains name of low-level-rx-endpoints MO to be used as transport by low-level-rx-links";
1205 leaf user-plane-uplink-marking {
1207 path "/o-ran-pe:processing-elements/o-ran-pe:enhanced-uplane-mapping/o-ran-pe:uplane-mapping/o-ran-pe:up-marking-name";
1210 "Parameter to set the non-default marking for user-plane";
1214 list endpoint-types {
1218 "Properties of endpoint that are common to multiple endpoints if such are identified";
1223 "Identifies type of endpoints sharing same properties. Values shall start with 0 and shall be allocated without gaps.";
1226 list supported-section-types {
1229 "Indicates section types and extensions endpoints of this type support";
1235 "This parameter determines the characteristics of U-plane data to be transferred or received from a beam with one pattern id.";
1238 leaf-list supported-section-extensions {
1242 "This parameter provides the extension types supported by the O-RU
1243 which provides additional parameters specific to the subject data extension";
1247 leaf-list supported-frame-structures {
1251 "List of supported values of frame structure";
1254 leaf managed-delay-support {
1258 "Time managed delays are supported";
1263 "Non time managed delays are supported";
1268 "Both time managed and non time managed delays are supported";
1273 "Type of delay supported by the endpoint";
1276 leaf multiple-numerology-supported {
1280 "Indicates whether the endpoint type supports multiple numerologies";
1283 leaf max-numerology-change-duration {
1290 "Maximum gap of endpoint operation that will be caused by changing of
1293 This time is required for reconfiguration and flushing of pipes.
1295 This leaf contains valid data only when multiple-numerology-supported
1299 uses endpoint-section-capacity;
1300 uses endpoint-beam-capacity;
1301 uses endpoint-prb-capacity;
1303 leaf-list prb-capacity-allocation-granularity {
1307 "List of capacity allocation steps. O-RU allocates PRB capacity rounding it up to nearest value N
1308 from prb-capacity-allocation-granularity such that M >= number-of-prb-per-scs.
1309 See also number-of-prb-per-scs/number-of-prb.";
1312 uses endpoint-numerology-capacity;
1315 list endpoint-capacity-sharing-groups {
1319 "Represents groups of endpoints that share capacity. Depending on O-RU implementation,
1320 processing resources that handle CU-plane (e.g. memory to keep sections and beams)
1321 could be allocated per endpoint or shared between several endpoints.
1322 To address this O-RU shall reports own capability per endpoint (see endpoint-types)
1323 and per group of endpoints sharing capacity.
1324 If endpoint is in multiple groups then resulting constraint is minimum over all groups.
1325 Note: values of parameters representing capacity that is not shared between endpoints in a group
1326 shall be set to max value of specific parameter; this effectively removes related constraint.";
1331 "Identifies group of endpoints sharing resources.
1332 Values shall start with 0 and shall be allocated without gaps.";
1334 uses endpoint-section-capacity;
1335 uses endpoint-beam-capacity;
1336 uses endpoint-prb-capacity;
1337 uses endpoint-numerology-capacity;
1339 leaf max-endpoints {
1342 "Indicates how many endpoints in the group can be used4 simultaneously";
1344 leaf max-managed-delay-endpoints {
1347 "Number of endpoints supporting managed delay that can be used (configured for use) at a time";
1349 leaf max-non-managed-delay-endpoints {
1352 "Number of endpoints supporting non-managed delay that can be used (configured for use) at a time";
1356 list endpoint-prach-group {
1360 "Represents group of a series of PRACH preamble formats";
1365 "Identifies group of PRACH preamble formats.";
1368 leaf-list supported-prach-preamble-formats {
1369 type prach-preamble-format;
1372 "the list of PRACH preamble formats supported by the endpoint-type that is
1373 applicable to static-low-level-rx-endpoints in the O-RU";
1378 list supported-compression-method-sets {
1382 "List of available compression methods supported by device";
1387 "Identification number for compression method set";
1390 list compression-method-supported {
1391 uses cf:compression-parameters;
1393 leaf-list fs-offset {
1394 if-feature cf:CONFIGURABLE-FS-OFFSET;
1398 "Adjusts FS (full scale) value of IQ format relative to FS derived from unmodified IQ format.
1399 Please refer to CU-Plane specification for details";
1403 "List of supported compression methods by O-RU
1404 Note: if O-RU supports different compression methods per endpoint
1405 then please refer to endpoints to have information what
1406 exactly is supported on paticular endpoint";
1410 list static-low-level-tx-endpoints {
1414 "Object model for static-low-level-tx-endpoints configuration";
1420 "Unique name of static-low-level-tx-endpoints object.";
1423 leaf-list restricted-interfaces {
1425 path "/if:interfaces/if:interface/if:name";
1428 "Optionally used to indicate that a low-level link is constrained to operate only via a subset of the available interfaces.";
1433 path "/user-plane-configuration/tx-arrays/name";
1437 "Contains distname of tx-arrays, particular low-level-tx-endpoints is in hardware dependency with.
1438 Note: single instance of tx-arrays can be referenced by many instances of low-level-tx-endpoints
1439 (e.g. to allow DU to handle multiple fronthauls and multiple component carriers).";
1442 leaf endpoint-type {
1444 path "../../endpoint-types/id";
1448 "Reference to endpoint type capabilities list element supported by this endpoint";
1451 leaf-list capacity-sharing-groups {
1453 path "../../endpoint-capacity-sharing-groups/id";
1457 "Reference to capacities of sharing-groups supported by this endpoint";
1460 list supported-reference-level {
1461 if-feature TX-REFERENCE-LEVEL;
1464 "Informs about supported ranges for gain reference level.";
1469 "Identification number for particular range";
1479 "Minimum of supported gain reference level";
1489 "Maximum of supported gain reference level";
1493 container compression {
1495 "Container collecting compression related parameters.";
1497 leaf dynamic-compression-supported {
1501 "Informs if endpoint supports dynamic compression method";
1504 leaf realtime-variable-bit-width-supported {
1508 "Informs if endpoint supports realtime variable bit with";
1511 leaf supported-compression-set-id {
1513 path "../../../supported-compression-method-sets/id";
1517 "Id of supported compression set for this endpoint";
1521 uses endpoint-tdd-pattern-support;
1525 list static-low-level-rx-endpoints {
1529 "Object model for static-low-level-rx-endpoints configuration";
1535 "Unique name of static-low-level-rx-endpoints object.";
1538 leaf-list restricted-interfaces {
1540 path "/if:interfaces/if:interface/if:name";
1543 "Optionally used to indicate that a low-level link is constrained to operate only via a subset of the available interfaces.";
1548 path "/user-plane-configuration/rx-arrays/name";
1552 "Contains distname of rx-arrays, particular low-level-rx-endpoints is in hardware dependency with.
1553 Note: single instance of rx-arrays can be referenced by many instances of low-level-rx-endpoints
1554 (e.g. to allow DU to handle multiple fronthauls and multiple component carriers).";
1557 leaf endpoint-type {
1559 path "../../endpoint-types/id";
1563 "Reference to endpoint type capabilities list element supported by this endpoint";
1566 leaf-list capacity-sharing-groups {
1568 path "../../endpoint-capacity-sharing-groups/id";
1572 "Reference to capacities of sharing-groups supported by this endpoint";
1577 path "../../endpoint-prach-group/id";
1578 require-instance false;
1581 "An optional leaf used for those rx endpoints that support PRACH, indicating
1582 the group id describing the set of of PRACH preambles supported";
1585 container compression {
1587 "Container collecting compression related parameters.";
1589 leaf dynamic-compression-supported {
1593 "Informs if endpoint supports dynamic compression method";
1596 leaf realtime-variable-bit-width-supported {
1600 "Informs if endpoint supports realtime variable bit with";
1603 leaf supported-compression-set-id {
1605 path "../../../supported-compression-method-sets/id";
1609 "Id of supported compression set for this endpoint";
1613 uses endpoint-static-config-support;
1615 uses endpoint-tdd-pattern-support;
1619 list low-level-tx-endpoints {
1623 "Object model for low-level-tx-endpoints configuration - augmented static-low-level-tx-endpoints by local-address
1624 which cannot be added to static low-level-tx-endpoints as we cannot have modificable element in static object";
1628 path "/user-plane-configuration/static-low-level-tx-endpoints/name";
1629 require-instance false;
1634 "Unique name of low-level-tx-endpoint object. Reference to static object";
1637 container compression {
1639 "This container shall exists to avoid missaligned compression
1640 methods between devices";
1643 "Container which consists of global configurable parameters for compression";
1645 uses cf:compression-details;
1648 if-feature cf:CONFIGURABLE-FS-OFFSET;
1652 "Adjusts FS (full scale) value of IQ format relative to FS derived from unmodified IQ format.
1653 Please refer to CU-Plane specification for details";
1656 list dynamic-compression-configuration {
1657 when "../compression-type = 'DYNAMIC'";
1659 unique "compression-method iq-bitwidth fs-offset";
1661 "List of possible configuration in case dynamic configuration is used
1662 Note: In case of empty list all available compressions can be choosen dynamically
1663 and default fs-offset is taken (0).";
1668 "Identification number for particular compression";
1671 uses cf:compression-method-grouping;
1674 if-feature cf:CONFIGURABLE-FS-OFFSET;
1678 "Adjusts FS (full scale) value of IQ format relative to FS derived from unmodified IQ format.
1679 Please refer to CU-Plane specification for details";
1690 "Contains local address of low level TX endpoint offered by Netconf server.";
1693 uses coupling-methods;
1695 leaf configurable-tdd-pattern-supported {
1697 path "/user-plane-configuration/static-low-level-rx-endpoints[name=current()/../name]/configurable-tdd-pattern-supported";
1698 require-instance false;
1700 description "RO to RW parameter mapping - needed for conditional under tx-array-carrier";
1704 list low-level-rx-endpoints {
1708 "Object model for low-level-rx-endpoint configuration - augmented static-low-level-rx-endpoints by local-address
1709 which cannot be added to static low-level-rx-endpoints as we cannot have modificable element in static object";
1713 path "/user-plane-configuration/static-low-level-rx-endpoints/name";
1714 require-instance false;
1719 "Unique name of low-level-rx-endpoint object. Reference to static object";
1722 container compression {
1724 "Container which consists of global configurable parameters for compression";
1726 uses cf:compression-details;
1729 if-feature cf:CONFIGURABLE-FS-OFFSET;
1733 "Adjusts FS (full scale) value of IQ format relative to FS derived from unmodified IQ format.
1734 Please refer to CU-Plane specification for details";
1737 list dynamic-compression-configuration {
1738 when "../compression-type = 'DYNAMIC'";
1740 unique "compression-method iq-bitwidth fs-offset";
1742 "List of possible configuration in case dynamic configuration is used
1743 Note: In case of empty list all available compressions can be choosen dynamically
1744 and default fs-offset is taken (0).";
1749 "Identification number for particular compression";
1752 uses cf:compression-method-grouping;
1755 if-feature cf:CONFIGURABLE-FS-OFFSET;
1759 "Adjusts FS (full scale) value of IQ format relative to FS derived from unmodified IQ format.
1760 Please refer to CU-Plane specification for details";
1767 list ul-fft-sampling-offsets {
1770 "List of FFT sampling offsets configured for each SCS that will be used.
1771 Client shall configure one element for each SCS that will be used.";
1774 type mcap:scs-config-type;
1776 "Value corresponds to SCS values defined for frameStructure in C-plane
1777 Note: set of allowed values is restricted by SCS derived from values in supported-frame-structures.";
1780 leaf ul-fft-sampling-offset {
1785 "Determines time advance of capture window for FFT.
1786 Value represents time advance of capture window start in relation to the end of CP. Unit is Ts.
1787 Note: value of this parameter is usually set to '0' (zero) for PRACH channels.
1788 Any phase offset resulting from the non-zero value of this parameter is handled in O-DU.";
1796 "Contains local address of low level RX endpoint offered by Netconf server.";
1799 leaf eaxc-gain-correction {
1800 if-feature EAXC-GAIN-CORRECTION;
1807 "eAxC specifc part of overall gain_correction.
1808 gain_correction = common array-carrier gain-correction + eAxC-gain-correction.";
1811 leaf non-time-managed-delay-enabled {
1815 "Tells if non time managed delay shall be enabled";
1818 uses coupling-methods;
1820 leaf static-config-supported {
1822 path "/user-plane-configuration/static-low-level-rx-endpoints[name=current()/../name]/static-config-supported";
1823 require-instance false;
1825 description "RO to RW parameter mapping - for further conditionals";
1828 leaf static-prach-configuration {
1829 when "(/user-plane-configuration/low-level-rx-endpoints[name=current()/../name]/static-config-supported = 'PRACH')";
1831 path "/user-plane-configuration/static-prach-configurations/static-prach-config-id";
1834 "This parameter creates reference to static PRACH configuration applicable for particular endpoint";
1837 leaf static-srs-configuration {
1838 when "(/user-plane-configuration/low-level-rx-endpoints[name=current()/../name]/static-config-supported = 'SRS')";
1840 path "/user-plane-configuration/static-srs-configurations/static-srs-config-id";
1843 "This parameter creates reference to static SRS configuration applicable for particular endpoint";
1846 leaf configurable-tdd-pattern-supported {
1848 path "/user-plane-configuration/static-low-level-rx-endpoints[name=current()/../name]/configurable-tdd-pattern-supported";
1849 require-instance false;
1851 description "RO to RW parameter mapping - needed for conditional under rx-array-carrier";
1855 list tx-array-carriers {
1858 "Object model for tx-array-carriers configuration";
1864 "Unique name of tx-array-carriers object.";
1867 uses tx-common-array-carrier-elements;
1870 if-feature mcap:LAA;
1872 path "/mcap:module-capability/mcap:band-capabilities/mcap:band-number";
1873 require-instance false;
1876 "This parameter informing which frequency band particular antenna
1877 array is serving for.
1878 Intended use is to deal with multiband solutions.";
1881 container lte-tdd-frame {
1882 when "(/user-plane-configuration/tx-array-carriers/rw-type = 'LTE') and (/user-plane-configuration/tx-array-carriers/rw-duplex-scheme = 'TDD')";
1885 "Container which consists of global configurable parameters for tdd Frame.
1886 This contained is deprecated due to introduction of TDD pattern configuration
1887 applicable in a common way for LTE and NR.";
1889 leaf subframe-assignment {
1892 description "subframe assignment configuration 0";
1895 description "subframe assignment configuration 1";
1898 description "subframe assignment configuration 2";
1901 description "subframe assignment configuration 3";
1904 description "subframe assignment configuration 4";
1907 description "subframe assignment configuration 5";
1910 description "subframe assignment configuration 6";
1915 "Indicates DL/UL subframe configuration as specified in
1916 3GPP TS 36.211 [v15.3.0, table 4.2-2]";
1918 leaf special-subframe-pattern {
1921 description "special subframe pattern configuration 0";
1924 description "special subframe pattern configuration 1";
1927 description "special subframe pattern configuration 2";
1930 description "special subframe pattern configuration 3";
1933 description "special subframe pattern configuration 4";
1936 description "special subframe pattern configuration 5";
1939 description "special subframe pattern configuration 6";
1942 description "special subframe pattern configuration 7";
1945 description "special subframe pattern configuration 8";
1948 description "special subframe pattern configuration 9";
1951 description "special subframe pattern configuration 10";
1956 "Indicates TDD special subframe configuration as in TS 36.211
1957 [v15.3.0, table 4.2-1] ";
1961 container laa-carrier-configuration {
1962 when "../band-number = 46";
1963 if-feature mcap:LAA;
1964 description "Container to specify LAA feature related carrier configuration.";
1965 uses laa-carrier-config;
1976 "Transmission gain in dB. Value applicable to each array element carrier belonging to array carrier.";
1979 leaf downlink-radio-frame-offset {
1986 "This parameter is used for offsetting the starting position of 10ms radio frame.
1987 Note: The value should have same value within DU to all tx-array-carrierss that have same frequency and bandwidth.
1988 Note2: Unit is 1/1.2288e9 s. Then, its range is calculated 0..12288000.";
1991 leaf downlink-sfn-offset {
1993 range -32768..32767;
1998 "This parameter is used for offsetting SFN value.
2000 Note: The value should have same value within DU to all tx-array-carrierss that have same frequency and bandwidth.";
2003 leaf reference-level {
2004 if-feature TX-REFERENCE-LEVEL;
2011 "Allows to adjust reference level for sum of IQ signal power over eAxCs in this array-carrier.";
2014 leaf configurable-tdd-pattern {
2015 when "not(/user-plane-configuration/low-level-tx-endpoints[name = string(/user-plane-configuration/low-level-tx-links[tx-array-carrier = current()/../name]/tx-array-carrier)]/configurable-tdd-pattern-supported = 'false')";
2016 if-feature mcap:CONFIGURABLE-TDD-PATTERN-SUPPORTED;
2018 path "/user-plane-configuration/configurable-tdd-patterns/tdd-pattern-id";
2021 "This parameter creates reference to configuration for TDD pattern applicable for particular tx-array-carrier.
2022 The leaf may exist under tx-array-carrier only in case O-RU supports feature 'CONFIGURABLE-TDD-PATTERN-SUPPORTED'
2023 AND all low-level-tx-endpoints linked to this tx-array-carrier have configurable-tdd-pattern-supported = 'true'";
2027 list rx-array-carriers {
2030 "Object model for rx-array-carriers configuration";
2035 "Unique name of rx-array-carriers object.";
2038 uses rx-common-array-carrier-elements;
2040 leaf downlink-radio-frame-offset {
2047 "This parameter is used for offsetting the starting position of 10ms radio frame.
2048 Note: The value should have same value within DU to all tx-array-carrierss that have same frequency and bandwidth.
2049 Note2: Unit is 1/1.2288e9 s. Then, its range is calculated 0..12288000.";
2052 leaf downlink-sfn-offset {
2054 range -32768..32767;
2059 "This parameter is used for offsetting SFN value.
2061 Note: The value should have same value within DU to all tx-array-carrierss that have same frequency and bandwidth.";
2064 leaf gain-correction {
2072 "Gain correction of RF path linked with array element or array layers.
2073 Common part of overall gain_correction.
2074 gain_correction = common array-carrier gain-correction + eAxC gain correction.";
2082 "Value of configurable N-TA offset
2083 units are Tc=~0.5ns=1/1.96608GHz";
2086 leaf configurable-tdd-pattern {
2087 when "not(/user-plane-configuration/low-level-rx-endpoints[name = string(/user-plane-configuration/low-level-rx-links[rx-array-carrier = current()/../name]/rx-array-carrier)]/configurable-tdd-pattern-supported = 'false')";
2088 if-feature mcap:CONFIGURABLE-TDD-PATTERN-SUPPORTED;
2090 path "/user-plane-configuration/configurable-tdd-patterns/tdd-pattern-id";
2093 "This parameter creates reference to configuration for TDD pattern applicable for particular rx-array-carrier.
2094 The leaf may exist under rx-array-carrier only in case O-RU supports feature 'CONFIGURABLE-TDD-PATTERN-SUPPORTED'
2095 AND all low-level-rx-endpoints linked to this rx-array-carrier have configurable-tdd-pattern-supported = 'true'";
2103 "Structure describing TX array parameters";
2115 "Max gain of RF path linked with array element (minimum over elements of array) or array layers";
2118 leaf independent-power-budget {
2122 "If true then every element of array has own, power budget independent from power budget of other elements.
2123 Else all elements of array that are at same row and column and have same polarization share power budget";
2128 "List of capabilities related to this tx-array";
2129 uses mcap:support-for-dl;
2136 description "Structure describing RX array parameters";
2139 container gain-correction-range {
2146 description "Array gain correction factor - maximum allowed value";
2154 description "Array gain correction factor - minimum allowed value";
2158 "Array gain correction factor";
2163 "List of capabilities related to this rx-array";
2164 uses mcap:support-for-ul;
2171 description "Structure describing relations between array elements";
2177 "Relation entity. Used as a key for list of relations.";
2184 "Defnes name for first array";
2190 "Defnes name for second array";
2193 key "relation-type";
2195 "Defines relation type and pairs for array elements for given arrays";
2197 leaf relation-type {
2200 description "SHARED";
2203 description "COALOCATED";
2206 description "Type of relation between array elements";
2209 key "element-array1";
2211 "defines related array elements";
2213 leaf element-array1 {
2217 "Tells about id of element from array1";
2219 leaf element-array2 {
2223 "Tells about id of element from array2";
2229 container eaxc-id-group-configuration {
2230 if-feature mcap:EAXC-ID-GROUP-SUPPORTED;
2232 "This is the container for eAxC ID group configuration.";
2233 leaf max-num-tx-eaxc-id-groups {
2235 path "/mcap:module-capability/mcap:ru-capabilities/mcap:eaxcid-grouping-capabilities/mcap:max-num-tx-eaxc-id-groups";
2236 require-instance false;
2238 description "eaxc-id-group-configuration";
2240 leaf max-num-tx-eaxc-ids-per-group {
2242 path "/mcap:module-capability/mcap:ru-capabilities/mcap:eaxcid-grouping-capabilities/mcap:max-num-tx-eaxc-ids-per-group";
2243 require-instance false;
2245 description "max-num-tx-eaxc-ids-per-group";
2247 leaf max-num-rx-eaxc-id-groups {
2249 path "/mcap:module-capability/mcap:ru-capabilities/mcap:eaxcid-grouping-capabilities/mcap:max-num-rx-eaxc-id-groups";
2250 require-instance false;
2252 description "max-num-rx-eaxc-id-groups";
2254 leaf max-num-rx-eaxc-ids-per-group {
2256 path "/mcap:module-capability/mcap:ru-capabilities/mcap:eaxcid-grouping-capabilities/mcap:max-num-rx-eaxc-ids-per-group";
2257 require-instance false;
2259 description "max-num-rx-eaxc-ids-per-group";
2262 list tx-eaxc-id-group {
2263 must "count(../tx-eaxc-id-group) <= ../max-num-tx-eaxc-id-groups" {
2264 error-message "too many tx-eaxcid-id groups";
2266 key "representative-tx-eaxc-id";
2268 "This is a list of the groups of the eAxC IDs assigned to low-level-tx-endpoints.
2269 Each group is a union of the 'member-tx-eaxc-id's and a 'representative-tx-eaxc-id'.
2270 The low-level-tx-endpoint associated to 'representative-tx-eaxc-id' is able to
2271 process the DL C-plane information for all the low-level-tx-endpoints associated
2272 to 'member-tx-eaxc-id's.
2274 Take Note: This list should only contain eAxC IDs assigned to a tx-endpoint.";
2277 leaf representative-tx-eaxc-id {
2280 "This parameter contains eAxC_ID that populates content of C-Plane section
2281 extension 11 to eAxC_IDs configured in the group as 'member-tx-eaxc-id'(s).";
2283 leaf-list member-tx-eaxc-id {
2285 must "count(../member-tx-eaxc-id) <= ../../max-num-tx-eaxc-ids-per-group" {
2286 error-message "too many tx-eaxcid-id members";
2288 must "current()!=../representative-tx-eaxc-id" {
2289 error-message "the representative eaxcid does not need to be a list member";
2292 "This is a list of member eAxC IDs, which together with the representative-tx-eaxc-id,
2293 are assigned to low-level-tx-endpoints in the group.";
2297 list rx-eaxc-id-group {
2298 must "count(../rx-eaxc-id-group) <= ../max-num-rx-eaxc-id-groups" {
2299 error-message "too many rx-eaxcid-id groups";
2301 key "representative-rx-eaxc-id";
2303 "This is a list of the groups of the eAxC IDs assigned to low-level-rx-endpoints.
2304 Each group is a union of 'member-rx-eaxc-id's and a 'representative-rx-eaxc-id'.
2305 The low-level-rx-endpoint associated to 'representative-rx-eaxc-id' is able to
2306 process the UL C-plane information for all the low-level-rx-endpoints associated
2307 to 'member-rx-eaxc-id's.
2309 Take Note: This list should only contain eAxC IDs assigned to a rx-endpoint.";
2311 leaf representative-rx-eaxc-id {
2314 "This parameter contains eAxC_ID that populates content of C-Plane section
2315 extension 11 to eAxC_IDs configured in the group as 'member-rx-eaxc-id'(s).";
2318 leaf-list member-rx-eaxc-id {
2320 must "count(../member-rx-eaxc-id) <= ../../max-num-rx-eaxc-ids-per-group" {
2321 error-message "too many rx-eaxcid-id members";
2323 must "current()!=../representative-rx-eaxc-id" {
2324 error-message "the representative eaxcid does not need to be a list member";
2327 "This is a list of member eAxC IDs assigned to low-level-rx-endpoints in the group.";
2332 list static-prach-configurations {
2333 if-feature mcap:PRACH-STATIC-CONFIGURATION-SUPPORTED;
2334 key static-prach-config-id;
2336 "List of static PRACH configurations. An O-RU shall reject any configuration
2337 modification which exceed the maximum permitted configurations supported by
2340 leaf static-prach-config-id {
2343 "Supplementary parameter acting as key in list of static PRACH configurations.";
2346 uses static-prach-configuration;
2349 grouping static-prach-configuration {
2351 "Set of parameters related to static PRACH configuration";
2353 leaf pattern-period {
2359 "Period after which static PRACH patterns are repeated. Unit: number of frames.";
2362 leaf guard-tone-low-re {
2366 "Number of REs occupied by the low guard tones.";
2373 "Number of contiguous PRBs per data section description";
2376 leaf guard-tone-high-re {
2380 "Number of REs occupied by the high guard tones.";
2383 leaf sequence-duration {
2390 "Duration of single sequence of the PRACH. Sequence may be considered as 'single PRACH symbol'";
2393 list prach-patterns {
2394 key prach-pattern-id;
2397 "Provides a PRACH pattern. Each record in the list represents a single PRACH occasion. Number of list entries cannot exceed max-prach-patterns";
2399 leaf prach-pattern-id {
2403 "Supplementary parameter acting as key for prach-pattern list.";
2406 leaf number-of-repetitions {
2412 "This parameter defines number of PRACH repetitions in PRACH occasion,
2413 to which the section control is applicable.";
2416 leaf number-of-occasions {
2420 "This parameter informs how many consecutive PRACH occasions is described by the PRACH pattern.";
2427 "Offset between the start of lowest-frequency RE of lowest-frequency PRB
2428 and the start of lowest-frequency RE belonging to the PRACH occasion.
2429 The re-offset is configured as number of PRACH REs.";
2432 list occasion-parameters {
2436 "This is list of cp-lengths, gp-lengths and beam-ids applicable
2437 per each PRACH occasion in PRACH pattern.
2438 Note: the number of records in this list MUST be equal
2439 to value of parameter number-of-occasions.";
2445 "Supplementary parameter acting as key in 'occasion-parameters' list";
2453 "Cyclic prefix length. See CUS-plane specification for detailed description.";
2460 "Guard period length.";
2467 "This parameter defines the beam pattern to be applied to the U-Plane data.
2468 beamId = 0 means no beamforming operation will be performed.";
2478 "This parameter is an index inside the pattern-length, such that
2479 PRACH occasion is happening for SFN which fulfills following equation:
2480 [SFN mod pattern-length = frame-id]";
2487 "Identifier of sub-frame of the PRACH occasion. Value is interpreted in the same way
2488 as subframeId field in a section description of a C-Plane message.";
2496 "This parameter defines the time-offset from the start of the sub-frame
2497 to the start of the first Cyclic Prefix of PRACH pattern";
2502 grouping static-srs-configuration {
2504 "Set of parameters related to static PRACH configuration";
2506 leaf pattern-period {
2512 "Period after which static SRS patterns are repeated. Unit: number of frames.";
2519 "Provides a SRS pattern. Each record in the list represents a single PRACH occasion. Number of list entries cannot exceed max-srs-patterns.";
2521 leaf srs-pattern-id {
2525 "Supplementary parameter acting as key for srs-pattern list.";
2532 "Identifier of sub-frame of the Raw SRS occasion. Value is interpreted in the same way
2533 as subframeId field in a section description of a C-Plane message.";
2540 "Identifier of slot of the Raw SRS occasion. Value is interpreted in the same way
2541 as slotId field in a section description of a C-Plane message.";
2544 leaf start-symbol-id {
2548 "Identifier of first symbol of the Raw SRS occasion. Value is interpreted in the same way
2549 as startSymbolId field in a section description of a C-Plane message.";
2556 "This parameter defines the beam pattern to be applied to the U-Plane data.
2557 beamId = 0 means no beamforming operation will be performed.";
2564 "This parameter defines number of consecutive symbols covered by specific srs-pattern.
2565 Single srs-pattern may address at least one symbol. However, possible optimizations
2566 could allow for several (up to 14) symbols.";
2575 "Identifier of first PRB of the Raw SRS occasion. Value is interpreted in the same way
2576 as startPrbc field in a section description of a C-Plane message.";
2583 "Number of PRBs of the Raw SRS occasion. Value is interpreted in the same way
2584 as numPrbc field in a section description of a C-Plane message.";
2589 grouping configurable-tdd-pattern {
2591 "Set of parameters related to configurable TDD pattern.
2592 Note: configurable-tdd-pattern shall not be used in case the usage would collide with
2593 deprecated 'lte-tdd-pattern'.";
2595 list switching-points {
2596 key switching-point-id;
2598 "List of switching points within frame, related to configurable TDD pattern.
2599 An O-RU shall reject any configuration modification which exceeds the maximum
2600 number of switching-points supported by the O-RU";
2602 leaf switching-point-id {
2605 "Supplementary parameter acting as key for switching-points list.";
2611 description "Uplink";
2614 description "Downlink";
2617 description "Guard period";
2622 "Parameter provides information regarding desired signal direction at the moment switching point occurs.";
2629 "Offset from DL air frame boundary transmitted at RF connector to the point in time that is characteristic to the operation on RF switches. Unit is 1/1.2288e9 s.";
2634 list static-srs-configurations {
2635 if-feature mcap:SRS-STATIC-CONFIGURATION-SUPPORTED;
2636 key static-srs-config-id;
2638 "List of static SRS configurations";
2640 leaf static-srs-config-id {
2643 "Supplementary parameter acting as key in the list of static SRS configurations.";
2646 uses static-srs-configuration;
2649 list configurable-tdd-patterns {
2650 if-feature mcap:CONFIGURABLE-TDD-PATTERN-SUPPORTED;
2653 "List of configured TDD patterns";
2655 leaf tdd-pattern-id {
2658 "Supplementary parameter acting as key in the list of configured TDD patterns.";
2661 uses configurable-tdd-pattern;
2665 grouping tx-array-notification-group {
2667 "Grouping for tx-array for notification";
2669 list tx-array-carriers{
2671 description "notification of state change for tx-array-carriers";
2675 path "/user-plane-configuration/tx-array-carriers/name";
2678 "name of tx-array-carriers is notified at state change";
2682 path "/user-plane-configuration/tx-array-carriers/state";
2685 "state of tx-array-carriers is notified at state change";
2690 grouping rx-array-notification-group {
2692 "Grouping for rx-array for notification";
2694 list rx-array-carriers{
2697 "Notification used to inform about state change of rx-array-carriers";
2700 path "/user-plane-configuration/rx-array-carriers/name";
2703 "name of rx-array-carriers is notified at state change";
2707 path "/user-plane-configuration/rx-array-carriers/state";
2710 "state of rx-array-carriers is notified at state change";
2715 // top level container
2717 container user-plane-configuration {
2718 description "top level container for user plane configuration";
2720 uses uplane-conf-group;
2721 uses general-config;
2724 //notification statement
2725 notification tx-array-carriers-state-change {
2727 "Notification used to inform about state change of tx-array-carriers";
2728 uses tx-array-notification-group;
2730 notification rx-array-carriers-state-change {
2732 "Notification used to inform about state change of tx-array-carriers";
2734 uses rx-array-notification-group;