1 module org-openroadm-common-types {
2 namespace "http://org/openroadm/common-types";
3 prefix org-openroadm-common-types;
10 "YANG definitions of common types.
12 Copyright of the Members of the Open ROADM MSA Agreement dated (c) 2016,
13 AT&T Intellectual Property. All other rights reserved.
15 Redistribution and use in source and binary forms, with or without modification,
16 are permitted provided that the following conditions are met:
18 * Redistributions of source code must retain the above copyright notice, this
19 list of conditions and the following disclaimer.
20 * Redistributions in binary form must reproduce the above copyright notice,
21 this list of conditions and the following disclaimer in the documentation and/or
22 other materials provided with the distribution.
23 * Neither the Members of the Open ROADM MSA Agreement nor the names of its
24 contributors may be used to endorse or promote products derived from this software
25 without specific prior written permission.
27 THIS SOFTWARE IS PROVIDED BY THE MEMBERS OF THE OPEN ROADM MSA AGREEMENT ''AS IS''
28 AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
29 WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
30 IN NO EVENT THE MEMBERS OF THE OPEN ROADM MSA AGREEMENT BE LIABLE FOR ANY DIRECT,
31 INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
32 NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA,
33 OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
34 WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
35 ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
36 POSSIBILITY OF SUCH DAMAGE";
55 identity och-rate-identity {
57 "A unique och rate identification";
61 base och-rate-identity;
63 "Identity for 200G Rate";
67 base och-rate-identity;
69 "Identity for 100G Rate";
73 base och-rate-identity;
75 "Identity for 10.7G Rate";
79 base och-rate-identity;
81 "Identity for 11.1G Rate";
100 "Identifier for node type
102 2. xpdr for Transponder, Regen
103 3. ila for in-line amplifier
104 4. extplug for external plugable";
107 typedef node-id-type {
110 pattern "([a-zA-Z][a-zA-Z0-9-]{5,18}[a-zA-Z0-9])" {
112 "A node-id must be 7 to 63 characters in length.
113 A node-id can contain letters, numbers, and hyphens.
114 The first character must be a letter.
115 The last character must be a letter or number.";
119 "Globally unique identifer for a device.";
122 typedef xpdr-node-types {
141 "Identifier for Xponder node type
146 5. Regenerator based on unidirectional model";
149 typedef frequency-THz {
155 "Frequency value in THz.";
158 typedef frequency-GHz {
164 "Frequency value in GHz.";
173 "Power value in dBm.";
182 "Power ratio in dB.";
189 units "ps/(km[1/2])";
191 "Polarization Mode Dispersion expressed in ps/km(1/2).";
194 typedef amplifier-types {
201 "identifier for amplifier type
202 1. standard for amplifier as defined initially in the ROADM MSA specifications
203 To be completed if/when additional amplifier types are required ";
206 typedef line-amplifier-control-mode {
216 "Identifies the line amplifier control mode, either off or gain.";
219 typedef amplifier-gain-range {
221 enum "gain-range-1" {
224 enum "gain-range-2" {
227 enum "gain-range-3" {
230 enum "gain-range-4" {
235 "Operational mode for the amplifier:
236 this parameter allows modeling different operational modes (gain ranges) ,notably for switched-gain amplifiers.
237 It indicates which performance model shall be used by the path feasibility engine.
238 For standard amplifier, or when performance evaluation is based on incremental noise, use gain-range-1.
239 When performance evaluation is based on advanced parameters, specify used gain-range (1 to 4).
240 Up to release 2.1, only gain-range-1 is to be used (default value) ";
260 enum "indeterminate" {
265 "Severity, based on X.733 perceived severity";
268 typedef activate-notification-type {
273 "software or database activation";
278 "commit the software or database.
279 For software activate, this event can happen in the following scenarios:
280 1) immediately when user issue db-activate command without rollBackTimer
281 or if the rollBackTimer is specified as 00-00-00;
282 2) when user issue cancel-rollback-timer before it expires and with accept=true.
283 For database activate, this event can occur in the following scenarios:
284 1) immediately when user issue db-activate command without rollBackTimer
285 or if the rollBackTimer is specified as 00-00-00;
286 2) when user issue cancel-rollback-timer before it expires and with accept=true.";
291 "cancel the database or software activation operation.
292 For software activate, this event can happen in the following cases:
293 1) when the rollBackTimer expires;
294 2) when the user issues cancel-rollback-timer with accept=false.
295 For database activate, this event can happen in the following cases:
296 1) when the rollBackTimer expires;
297 2) when the user issues cancel-rollback-timer with accept=false.";
301 "Type of notification on software or database activation events";
317 typedef extended-rpc-status {
333 typedef lifecycle-state {
359 enum "deploy-failed" {
362 enum "undeploy-failed" {
375 enum "outOfService" {
383 "State that indicates whether the resource is able to provide fullfill its role - carry traffic, etc.";
386 typedef optic-types {
397 typedef equipment-type-enum {
405 enum "shelfProcessor" {
408 enum "crossConnect" {
423 typedef optical-control-mode {
436 "Optical Control Mode: identifies specific algorithm related to power management and general optical control.";
437 reference "openroadm.org: Open ROADM MSA Specification.";
448 enum "bidirectional" {
451 enum "notApplicable" {
459 enum "notApplicable" {
471 typedef wavelength-duplication-type {
476 "The SRG cannot handle wavelength duplication. Attempting to provision a connection on this SRG that uses the same wavelength as an existing service will result in failure.";
478 enum "one-per-degree" {
481 "The SRG can handle wavelength duplication, but only one per degree. Attempting to provision a connection on this SRG that uses the same wavelength as an existing service will succeed, so long as the connections are not using the same degree.";
485 "One per srg is applied to C/D add/drop group
486 one per degree is applied to C/D/C add drop group";
491 enum "roadm-internal" {
494 enum "roadm-external" {
497 enum "xpdr-network" {
506 enum "switch-network" {
509 enum "switch-client" {
512 enum "ila-external" {
515 enum "ila-internal" {
521 typedef modulation-format {
526 "binary phase-shift keying";
531 "DC dual-polarization binary phase-shift keying";
536 "quadrature phase-shift keying";
541 "dual-polarization binary phase-shift keying";
546 "quadrature amplitude modulation 16";
551 "dual-polarization quadrature amplitude modulation 16";
556 "DC dual-polarization quadrature amplitude modulation 16";
561 "quadrature amplitude modulation 8";
566 "dual-polarization quadrature amplitude modulation 8";
571 "DC dual-polarization quadrature amplitude modulation 8";
578 grouping physical-location {
597 grouping rpc-response-status {
602 "Successful or Failed";
604 leaf status-message {
607 "Gives a more detailed status";
611 grouping extended-rpc-response-status {
613 type extended-rpc-status;
616 "Successful, Failed or In-progress";
618 leaf status-message {
621 "Gives a more detailed status.";
625 grouping equipment-type {
627 type equipment-type-enum;
636 "Populated with equipment type when enum value is set to vendorExtension";