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 {
1696 if-feature mcap:CONFIGURABLE-TDD-PATTERN-SUPPORTED;
1698 //checkAS added if-feature
1699 path "/user-plane-configuration/static-low-level-rx-endpoints[name=current()/../name]/configurable-tdd-pattern-supported";
1700 require-instance false;
1702 description "RO to RW parameter mapping - needed for conditional under tx-array-carrier";
1706 list low-level-rx-endpoints {
1710 "Object model for low-level-rx-endpoint configuration - augmented static-low-level-rx-endpoints by local-address
1711 which cannot be added to static low-level-rx-endpoints as we cannot have modificable element in static object";
1715 path "/user-plane-configuration/static-low-level-rx-endpoints/name";
1716 require-instance false;
1721 "Unique name of low-level-rx-endpoint object. Reference to static object";
1724 container compression {
1726 "Container which consists of global configurable parameters for compression";
1728 uses cf:compression-details;
1731 if-feature cf:CONFIGURABLE-FS-OFFSET;
1735 "Adjusts FS (full scale) value of IQ format relative to FS derived from unmodified IQ format.
1736 Please refer to CU-Plane specification for details";
1739 list dynamic-compression-configuration {
1740 when "../compression-type = 'DYNAMIC'";
1742 unique "compression-method iq-bitwidth fs-offset";
1744 "List of possible configuration in case dynamic configuration is used
1745 Note: In case of empty list all available compressions can be choosen dynamically
1746 and default fs-offset is taken (0).";
1751 "Identification number for particular compression";
1754 uses cf:compression-method-grouping;
1757 if-feature cf:CONFIGURABLE-FS-OFFSET;
1761 "Adjusts FS (full scale) value of IQ format relative to FS derived from unmodified IQ format.
1762 Please refer to CU-Plane specification for details";
1769 list ul-fft-sampling-offsets {
1772 "List of FFT sampling offsets configured for each SCS that will be used.
1773 Client shall configure one element for each SCS that will be used.";
1776 type mcap:scs-config-type;
1778 "Value corresponds to SCS values defined for frameStructure in C-plane
1779 Note: set of allowed values is restricted by SCS derived from values in supported-frame-structures.";
1782 leaf ul-fft-sampling-offset {
1787 "Determines time advance of capture window for FFT.
1788 Value represents time advance of capture window start in relation to the end of CP. Unit is Ts.
1789 Note: value of this parameter is usually set to '0' (zero) for PRACH channels.
1790 Any phase offset resulting from the non-zero value of this parameter is handled in O-DU.";
1798 "Contains local address of low level RX endpoint offered by Netconf server.";
1801 leaf eaxc-gain-correction {
1802 if-feature EAXC-GAIN-CORRECTION;
1809 "eAxC specifc part of overall gain_correction.
1810 gain_correction = common array-carrier gain-correction + eAxC-gain-correction.";
1813 leaf non-time-managed-delay-enabled {
1817 "Tells if non time managed delay shall be enabled";
1820 uses coupling-methods;
1822 leaf static-config-supported {
1824 path "/user-plane-configuration/static-low-level-rx-endpoints[name=current()/../name]/static-config-supported";
1825 require-instance false;
1827 description "RO to RW parameter mapping - for further conditionals";
1830 leaf static-prach-configuration {
1831 if-feature mcap:PRACH-STATIC-CONFIGURATION-SUPPORTED;
1832 when "(/user-plane-configuration/low-level-rx-endpoints[name=current()/../name]/static-config-supported = 'PRACH')";
1834 //checkAS added if-feature
1835 path "/user-plane-configuration/static-prach-configurations/static-prach-config-id";
1838 "This parameter creates reference to static PRACH configuration applicable for particular endpoint";
1841 leaf static-srs-configuration {
1842 when "(/user-plane-configuration/low-level-rx-endpoints[name=current()/../name]/static-config-supported = 'SRS')";
1843 if-feature mcap:SRS-STATIC-CONFIGURATION-SUPPORTED;
1845 //checkAS added if-feature
1846 path "/user-plane-configuration/static-srs-configurations/static-srs-config-id";
1849 "This parameter creates reference to static SRS configuration applicable for particular endpoint";
1852 leaf configurable-tdd-pattern-supported {
1853 if-feature mcap:CONFIGURABLE-TDD-PATTERN-SUPPORTED;
1855 //checkAS added if-feature
1856 path "/user-plane-configuration/static-low-level-rx-endpoints[name=current()/../name]/configurable-tdd-pattern-supported";
1857 require-instance false;
1859 description "RO to RW parameter mapping - needed for conditional under rx-array-carrier";
1863 list tx-array-carriers {
1866 "Object model for tx-array-carriers configuration";
1872 "Unique name of tx-array-carriers object.";
1875 uses tx-common-array-carrier-elements;
1878 if-feature mcap:LAA;
1880 path "/mcap:module-capability/mcap:band-capabilities/mcap:band-number";
1881 require-instance false;
1884 "This parameter informing which frequency band particular antenna
1885 array is serving for.
1886 Intended use is to deal with multiband solutions.";
1889 container lte-tdd-frame {
1890 when "(/user-plane-configuration/tx-array-carriers/rw-type = 'LTE') and (/user-plane-configuration/tx-array-carriers/rw-duplex-scheme = 'TDD')";
1893 "Container which consists of global configurable parameters for tdd Frame.
1894 This contained is deprecated due to introduction of TDD pattern configuration
1895 applicable in a common way for LTE and NR.";
1897 leaf subframe-assignment {
1900 description "subframe assignment configuration 0";
1903 description "subframe assignment configuration 1";
1906 description "subframe assignment configuration 2";
1909 description "subframe assignment configuration 3";
1912 description "subframe assignment configuration 4";
1915 description "subframe assignment configuration 5";
1918 description "subframe assignment configuration 6";
1923 "Indicates DL/UL subframe configuration as specified in
1924 3GPP TS 36.211 [v15.3.0, table 4.2-2]";
1926 leaf special-subframe-pattern {
1929 description "special subframe pattern configuration 0";
1932 description "special subframe pattern configuration 1";
1935 description "special subframe pattern configuration 2";
1938 description "special subframe pattern configuration 3";
1941 description "special subframe pattern configuration 4";
1944 description "special subframe pattern configuration 5";
1947 description "special subframe pattern configuration 6";
1950 description "special subframe pattern configuration 7";
1953 description "special subframe pattern configuration 8";
1956 description "special subframe pattern configuration 9";
1959 description "special subframe pattern configuration 10";
1964 "Indicates TDD special subframe configuration as in TS 36.211
1965 [v15.3.0, table 4.2-1] ";
1969 container laa-carrier-configuration {
1970 when "../band-number = 46";
1971 if-feature mcap:LAA;
1972 description "Container to specify LAA feature related carrier configuration.";
1973 uses laa-carrier-config;
1984 "Transmission gain in dB. Value applicable to each array element carrier belonging to array carrier.";
1987 leaf downlink-radio-frame-offset {
1994 "This parameter is used for offsetting the starting position of 10ms radio frame.
1995 Note: The value should have same value within DU to all tx-array-carrierss that have same frequency and bandwidth.
1996 Note2: Unit is 1/1.2288e9 s. Then, its range is calculated 0..12288000.";
1999 leaf downlink-sfn-offset {
2001 range -32768..32767;
2006 "This parameter is used for offsetting SFN value.
2008 Note: The value should have same value within DU to all tx-array-carrierss that have same frequency and bandwidth.";
2011 leaf reference-level {
2012 if-feature TX-REFERENCE-LEVEL;
2019 "Allows to adjust reference level for sum of IQ signal power over eAxCs in this array-carrier.";
2022 leaf configurable-tdd-pattern {
2023 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')";
2024 if-feature mcap:CONFIGURABLE-TDD-PATTERN-SUPPORTED;
2026 path "/user-plane-configuration/configurable-tdd-patterns/tdd-pattern-id";
2029 "This parameter creates reference to configuration for TDD pattern applicable for particular tx-array-carrier.
2030 The leaf may exist under tx-array-carrier only in case O-RU supports feature 'CONFIGURABLE-TDD-PATTERN-SUPPORTED'
2031 AND all low-level-tx-endpoints linked to this tx-array-carrier have configurable-tdd-pattern-supported = 'true'";
2035 list rx-array-carriers {
2038 "Object model for rx-array-carriers configuration";
2043 "Unique name of rx-array-carriers object.";
2046 uses rx-common-array-carrier-elements;
2048 leaf downlink-radio-frame-offset {
2055 "This parameter is used for offsetting the starting position of 10ms radio frame.
2056 Note: The value should have same value within DU to all tx-array-carrierss that have same frequency and bandwidth.
2057 Note2: Unit is 1/1.2288e9 s. Then, its range is calculated 0..12288000.";
2060 leaf downlink-sfn-offset {
2062 range -32768..32767;
2067 "This parameter is used for offsetting SFN value.
2069 Note: The value should have same value within DU to all tx-array-carrierss that have same frequency and bandwidth.";
2072 leaf gain-correction {
2080 "Gain correction of RF path linked with array element or array layers.
2081 Common part of overall gain_correction.
2082 gain_correction = common array-carrier gain-correction + eAxC gain correction.";
2090 "Value of configurable N-TA offset
2091 units are Tc=~0.5ns=1/1.96608GHz";
2094 leaf configurable-tdd-pattern {
2095 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')";
2096 if-feature mcap:CONFIGURABLE-TDD-PATTERN-SUPPORTED;
2098 path "/user-plane-configuration/configurable-tdd-patterns/tdd-pattern-id";
2101 "This parameter creates reference to configuration for TDD pattern applicable for particular rx-array-carrier.
2102 The leaf may exist under rx-array-carrier only in case O-RU supports feature 'CONFIGURABLE-TDD-PATTERN-SUPPORTED'
2103 AND all low-level-rx-endpoints linked to this rx-array-carrier have configurable-tdd-pattern-supported = 'true'";
2111 "Structure describing TX array parameters";
2123 "Max gain of RF path linked with array element (minimum over elements of array) or array layers";
2126 leaf independent-power-budget {
2130 "If true then every element of array has own, power budget independent from power budget of other elements.
2131 Else all elements of array that are at same row and column and have same polarization share power budget";
2136 "List of capabilities related to this tx-array";
2137 uses mcap:support-for-dl;
2144 description "Structure describing RX array parameters";
2147 container gain-correction-range {
2154 description "Array gain correction factor - maximum allowed value";
2162 description "Array gain correction factor - minimum allowed value";
2166 "Array gain correction factor";
2171 "List of capabilities related to this rx-array";
2172 uses mcap:support-for-ul;
2179 description "Structure describing relations between array elements";
2185 "Relation entity. Used as a key for list of relations.";
2192 "Defnes name for first array";
2198 "Defnes name for second array";
2201 key "relation-type";
2203 "Defines relation type and pairs for array elements for given arrays";
2205 leaf relation-type {
2208 description "SHARED";
2211 description "COALOCATED";
2214 description "Type of relation between array elements";
2217 key "element-array1";
2219 "defines related array elements";
2221 leaf element-array1 {
2225 "Tells about id of element from array1";
2227 leaf element-array2 {
2231 "Tells about id of element from array2";
2237 container eaxc-id-group-configuration {
2238 if-feature mcap:EAXC-ID-GROUP-SUPPORTED;
2240 "This is the container for eAxC ID group configuration.";
2241 leaf max-num-tx-eaxc-id-groups {
2243 path "/mcap:module-capability/mcap:ru-capabilities/mcap:eaxcid-grouping-capabilities/mcap:max-num-tx-eaxc-id-groups";
2244 require-instance false;
2246 description "eaxc-id-group-configuration";
2248 leaf max-num-tx-eaxc-ids-per-group {
2250 path "/mcap:module-capability/mcap:ru-capabilities/mcap:eaxcid-grouping-capabilities/mcap:max-num-tx-eaxc-ids-per-group";
2251 require-instance false;
2253 description "max-num-tx-eaxc-ids-per-group";
2255 leaf max-num-rx-eaxc-id-groups {
2257 path "/mcap:module-capability/mcap:ru-capabilities/mcap:eaxcid-grouping-capabilities/mcap:max-num-rx-eaxc-id-groups";
2258 require-instance false;
2260 description "max-num-rx-eaxc-id-groups";
2262 leaf max-num-rx-eaxc-ids-per-group {
2264 path "/mcap:module-capability/mcap:ru-capabilities/mcap:eaxcid-grouping-capabilities/mcap:max-num-rx-eaxc-ids-per-group";
2265 require-instance false;
2267 description "max-num-rx-eaxc-ids-per-group";
2270 list tx-eaxc-id-group {
2271 must "count(../tx-eaxc-id-group) <= ../max-num-tx-eaxc-id-groups" {
2272 error-message "too many tx-eaxcid-id groups";
2274 key "representative-tx-eaxc-id";
2276 "This is a list of the groups of the eAxC IDs assigned to low-level-tx-endpoints.
2277 Each group is a union of the 'member-tx-eaxc-id's and a 'representative-tx-eaxc-id'.
2278 The low-level-tx-endpoint associated to 'representative-tx-eaxc-id' is able to
2279 process the DL C-plane information for all the low-level-tx-endpoints associated
2280 to 'member-tx-eaxc-id's.
2282 Take Note: This list should only contain eAxC IDs assigned to a tx-endpoint.";
2285 leaf representative-tx-eaxc-id {
2288 "This parameter contains eAxC_ID that populates content of C-Plane section
2289 extension 11 to eAxC_IDs configured in the group as 'member-tx-eaxc-id'(s).";
2291 leaf-list member-tx-eaxc-id {
2293 must "count(../member-tx-eaxc-id) <= ../../max-num-tx-eaxc-ids-per-group" {
2294 error-message "too many tx-eaxcid-id members";
2296 must "current()!=../representative-tx-eaxc-id" {
2297 error-message "the representative eaxcid does not need to be a list member";
2300 "This is a list of member eAxC IDs, which together with the representative-tx-eaxc-id,
2301 are assigned to low-level-tx-endpoints in the group.";
2305 list rx-eaxc-id-group {
2306 must "count(../rx-eaxc-id-group) <= ../max-num-rx-eaxc-id-groups" {
2307 error-message "too many rx-eaxcid-id groups";
2309 key "representative-rx-eaxc-id";
2311 "This is a list of the groups of the eAxC IDs assigned to low-level-rx-endpoints.
2312 Each group is a union of 'member-rx-eaxc-id's and a 'representative-rx-eaxc-id'.
2313 The low-level-rx-endpoint associated to 'representative-rx-eaxc-id' is able to
2314 process the UL C-plane information for all the low-level-rx-endpoints associated
2315 to 'member-rx-eaxc-id's.
2317 Take Note: This list should only contain eAxC IDs assigned to a rx-endpoint.";
2319 leaf representative-rx-eaxc-id {
2322 "This parameter contains eAxC_ID that populates content of C-Plane section
2323 extension 11 to eAxC_IDs configured in the group as 'member-rx-eaxc-id'(s).";
2326 leaf-list member-rx-eaxc-id {
2328 must "count(../member-rx-eaxc-id) <= ../../max-num-rx-eaxc-ids-per-group" {
2329 error-message "too many rx-eaxcid-id members";
2331 must "current()!=../representative-rx-eaxc-id" {
2332 error-message "the representative eaxcid does not need to be a list member";
2335 "This is a list of member eAxC IDs assigned to low-level-rx-endpoints in the group.";
2340 list static-prach-configurations {
2341 if-feature mcap:PRACH-STATIC-CONFIGURATION-SUPPORTED;
2342 key static-prach-config-id;
2344 "List of static PRACH configurations. An O-RU shall reject any configuration
2345 modification which exceed the maximum permitted configurations supported by
2348 leaf static-prach-config-id {
2351 "Supplementary parameter acting as key in list of static PRACH configurations.";
2354 uses static-prach-configuration;
2357 grouping static-prach-configuration {
2359 "Set of parameters related to static PRACH configuration";
2361 leaf pattern-period {
2367 "Period after which static PRACH patterns are repeated. Unit: number of frames.";
2370 leaf guard-tone-low-re {
2374 "Number of REs occupied by the low guard tones.";
2381 "Number of contiguous PRBs per data section description";
2384 leaf guard-tone-high-re {
2388 "Number of REs occupied by the high guard tones.";
2391 leaf sequence-duration {
2398 "Duration of single sequence of the PRACH. Sequence may be considered as 'single PRACH symbol'";
2401 list prach-patterns {
2402 key prach-pattern-id;
2405 "Provides a PRACH pattern. Each record in the list represents a single PRACH occasion. Number of list entries cannot exceed max-prach-patterns";
2407 leaf prach-pattern-id {
2411 "Supplementary parameter acting as key for prach-pattern list.";
2414 leaf number-of-repetitions {
2420 "This parameter defines number of PRACH repetitions in PRACH occasion,
2421 to which the section control is applicable.";
2424 leaf number-of-occasions {
2428 "This parameter informs how many consecutive PRACH occasions is described by the PRACH pattern.";
2435 "Offset between the start of lowest-frequency RE of lowest-frequency PRB
2436 and the start of lowest-frequency RE belonging to the PRACH occasion.
2437 The re-offset is configured as number of PRACH REs.";
2440 list occasion-parameters {
2444 "This is list of cp-lengths, gp-lengths and beam-ids applicable
2445 per each PRACH occasion in PRACH pattern.
2446 Note: the number of records in this list MUST be equal
2447 to value of parameter number-of-occasions.";
2453 "Supplementary parameter acting as key in 'occasion-parameters' list";
2461 "Cyclic prefix length. See CUS-plane specification for detailed description.";
2468 "Guard period length.";
2475 "This parameter defines the beam pattern to be applied to the U-Plane data.
2476 beamId = 0 means no beamforming operation will be performed.";
2486 "This parameter is an index inside the pattern-length, such that
2487 PRACH occasion is happening for SFN which fulfills following equation:
2488 [SFN mod pattern-length = frame-id]";
2495 "Identifier of sub-frame of the PRACH occasion. Value is interpreted in the same way
2496 as subframeId field in a section description of a C-Plane message.";
2504 "This parameter defines the time-offset from the start of the sub-frame
2505 to the start of the first Cyclic Prefix of PRACH pattern";
2510 grouping static-srs-configuration {
2512 "Set of parameters related to static PRACH configuration";
2514 leaf pattern-period {
2520 "Period after which static SRS patterns are repeated. Unit: number of frames.";
2527 "Provides a SRS pattern. Each record in the list represents a single PRACH occasion. Number of list entries cannot exceed max-srs-patterns.";
2529 leaf srs-pattern-id {
2533 "Supplementary parameter acting as key for srs-pattern list.";
2540 "Identifier of sub-frame of the Raw SRS occasion. Value is interpreted in the same way
2541 as subframeId field in a section description of a C-Plane message.";
2548 "Identifier of slot of the Raw SRS occasion. Value is interpreted in the same way
2549 as slotId field in a section description of a C-Plane message.";
2552 leaf start-symbol-id {
2556 "Identifier of first symbol of the Raw SRS occasion. Value is interpreted in the same way
2557 as startSymbolId field in a section description of a C-Plane message.";
2564 "This parameter defines the beam pattern to be applied to the U-Plane data.
2565 beamId = 0 means no beamforming operation will be performed.";
2572 "This parameter defines number of consecutive symbols covered by specific srs-pattern.
2573 Single srs-pattern may address at least one symbol. However, possible optimizations
2574 could allow for several (up to 14) symbols.";
2583 "Identifier of first PRB of the Raw SRS occasion. Value is interpreted in the same way
2584 as startPrbc field in a section description of a C-Plane message.";
2591 "Number of PRBs of the Raw SRS occasion. Value is interpreted in the same way
2592 as numPrbc field in a section description of a C-Plane message.";
2597 grouping configurable-tdd-pattern {
2599 "Set of parameters related to configurable TDD pattern.
2600 Note: configurable-tdd-pattern shall not be used in case the usage would collide with
2601 deprecated 'lte-tdd-pattern'.";
2603 list switching-points {
2604 key switching-point-id;
2606 "List of switching points within frame, related to configurable TDD pattern.
2607 An O-RU shall reject any configuration modification which exceeds the maximum
2608 number of switching-points supported by the O-RU";
2610 leaf switching-point-id {
2613 "Supplementary parameter acting as key for switching-points list.";
2619 description "Uplink";
2622 description "Downlink";
2625 description "Guard period";
2630 "Parameter provides information regarding desired signal direction at the moment switching point occurs.";
2637 "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.";
2642 list static-srs-configurations {
2643 if-feature mcap:SRS-STATIC-CONFIGURATION-SUPPORTED;
2644 key static-srs-config-id;
2646 "List of static SRS configurations";
2648 leaf static-srs-config-id {
2651 "Supplementary parameter acting as key in the list of static SRS configurations.";
2654 uses static-srs-configuration;
2657 list configurable-tdd-patterns {
2658 if-feature mcap:CONFIGURABLE-TDD-PATTERN-SUPPORTED;
2661 "List of configured TDD patterns";
2663 leaf tdd-pattern-id {
2666 "Supplementary parameter acting as key in the list of configured TDD patterns.";
2669 uses configurable-tdd-pattern;
2673 grouping tx-array-notification-group {
2675 "Grouping for tx-array for notification";
2677 list tx-array-carriers{
2679 description "notification of state change for tx-array-carriers";
2683 path "/user-plane-configuration/tx-array-carriers/name";
2686 "name of tx-array-carriers is notified at state change";
2690 path "/user-plane-configuration/tx-array-carriers/state";
2693 "state of tx-array-carriers is notified at state change";
2698 grouping rx-array-notification-group {
2700 "Grouping for rx-array for notification";
2702 list rx-array-carriers{
2705 "Notification used to inform about state change of rx-array-carriers";
2708 path "/user-plane-configuration/rx-array-carriers/name";
2711 "name of rx-array-carriers is notified at state change";
2715 path "/user-plane-configuration/rx-array-carriers/state";
2718 "state of rx-array-carriers is notified at state change";
2723 // top level container
2725 container user-plane-configuration {
2726 description "top level container for user plane configuration";
2728 uses uplane-conf-group;
2729 uses general-config;
2732 //notification statement
2733 notification tx-array-carriers-state-change {
2735 "Notification used to inform about state change of tx-array-carriers";
2736 uses tx-array-notification-group;
2738 notification rx-array-carriers-state-change {
2740 "Notification used to inform about state change of tx-array-carriers";
2742 uses rx-array-notification-group;