1 module o-ran-operations {
3 namespace "urn:o-ran:operations:1.0";
6 import ietf-yang-types {
10 import ietf-netconf-acm {
13 "RFC 8341: Network Configuration Access Control Model";
16 import ietf-hardware {
20 organization "O-RAN Alliance";
26 "This module defines the YANG model used for O-RAN operations.
28 Copyright 2019 the O-RAN Alliance.
30 THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS 'AS IS'
31 AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
32 IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
33 ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
34 LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
35 CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
36 SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
37 INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
38 CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
39 ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
40 POSSIBILITY OF SUCH DAMAGE.
42 Redistribution and use in source and binary forms, with or without
43 modification, are permitted provided that the following conditions are met:
45 * Redistributions of source code must retain the above copyright notice,
46 this list of conditions and the above disclaimer.
47 * Redistributions in binary form must reproduce the above copyright notice,
48 this list of conditions and the above disclaimer in the documentation
49 and/or other materials provided with the distribution.
50 * Neither the Members of the O-RAN Alliance nor the names of its
51 contributors may be used to endorse or promote products derived from
52 this software without specific prior written permission.";
54 revision "2019-07-03" {
58 1) added timezone-name
59 2) added ru-instance-id
60 3) backward compatible changes to introduce groupings.";
62 reference "ORAN-WG4.M.0-v01.00";
65 revision "2019-02-04" {
69 1) imported model from xRAN
70 2) changed namespace and reference from xran to o-ran";
72 reference "ORAN-WG4.M.0-v01.00";
76 typedef timezone-name {
79 "A time zone name as used by the Time Zone Database,
80 sometimes referred to as the 'Olson Database'.
82 The complete set of valid values is defined in
83 https://www.iana.org/time-zones.
85 The exact set of supported values is an
86 implementation-specific matter.";
89 "RFC 6557: Procedures for Maintaining the Time Zone Database
90 IANA Time Zone Database https://www.iana.org/time-zones ";
95 pattern '[0-9]+(\.[0-9]+){1,2}';
98 "this type definition is used to represent the version of the WG4
99 fronthaul interface.";
102 grouping operational-group {
104 // Container used for WG4 specific declarations
105 container declarations {
106 //FIXME - determine whether it is acceptable to WG4 to change this to a presence
107 //container, where the presence indicates the NETCONF server supports WG4
108 //defined functionality
110 description "WG4 Specific Declarations of supported version of standards";
112 leaf ru-instance-id {
114 // [ast] added extra concat, because only 3 params are accepted in NTS
115 // must "re-match(current(), concat(/hw:hardware/hw:component/hw:mfg-name,
116 // '_', /hw:hardware/hw:component/hw:model-name, '_',
117 // /hw:hardware/hw:component/hw:serial-num ))";
118 must "re-match(current(), concat(concat(/hw:hardware/hw:component/hw:mfg-name,
119 '_', /hw:hardware/hw:component/hw:model-name), '_',
120 /hw:hardware/hw:component/hw:serial-num))";
123 "a unique instance identifier that may be used to identify a
124 particular hardware instance, e.g., when used performing hierarchical
125 management via the O-DU.";
128 leaf supported-mplane-version {
131 description "Parameter provides highest M-Plane specification version device is compliant with.";
134 leaf supported-cusplane-version {
137 description "Parameter provides highest CUS-Plane specification version device is compliant with.";
140 list supported-header-mechanism {
141 description "list provides information regarding type and version of headers.";
148 "Indicates that an O-RU supports the ecpri header format
153 "Indicates that an O-RU supports the 1914.3 header format
157 description "Transport protocol type.";
160 leaf ecpri-concatenation-support {
161 when "../protocol = 'ECPRI'";
165 "This leaf is used to indicate whether the O-RU supports the optional
166 eCPRI concatenation capability";
169 leaf protocol-version {
172 description "Header protocol version.";
177 container operational-state {
180 "Operational state for the O-RAN network element";
185 "Equipment restarted because it was powered on";
187 enum SUPERVISION-WATCHDOG {
189 "Equipment restarted because it's supervision wathcdog timer wasn't reset
190 by a NETCONF client (inferring loss of NETCONF connectivity)";
192 enum MPLANE-TRIGGERED-RESTART {
194 "Equipment restarted because of an M-plane issued rpc";
196 enum SOFTWARE-FAILURE {
198 "Equipment restarted because of software failure";
200 enum OTHER-WATCHDOG-TIMER {
202 "Equipment restarted because of some other non NETCONF watchdog timer";
206 "The restart reason for the Equipment is unknown";
209 description "the cause for the last restart of the O-RAN Network Element";
211 leaf restart-datetime {
212 type yang:date-and-time;
214 "The system date and time when the system last restarted.";
219 // Common cross-WG container used for configuring clock and call home timers
222 "System date and time properties used by all working groups.";
227 "An optional TZ database name to use for the system,
228 such as 'Europe/Stockholm'
230 Time zone name is an informative leaf and is NOT used in the
231 managed element to convert local time zone.
233 The managed element may include time zone name in measurement or
237 leaf timezone-utc-offset {
244 "The number of minutes to add to UTC time to
245 identify the time zone for this system. For example,
246 'UTC - 8:00 hours' would be represented as '-480'.";
250 leaf re-call-home-no-ssh-timer {
255 "A common timer used by the O-RAN equipment to trigger the repeated call
256 home procedure to all identified call home servers to which the O-RAN
257 equipment has not already an established SSH connection.
259 A value of 0 means that the O-RAN equipment shall disable operation
260 of the timer triggered NETCONF call home procedure.";
264 // Top level container
266 container operational-info{
268 "a collection of operational infor for the O-RU";
269 uses operational-group;
276 nacm:default-deny-all;
278 "Management plane triggered restart of the radio unit.
279 A server SHOULD send an rpc reply to the client before
280 restarting the system.";