module org-openroadm-device { namespace "http://org/openroadm/device"; prefix org-openroadm-device; import ietf-yang-types { prefix ietf-yang-types; revision-date 2013-07-15; } import ietf-inet-types { prefix ietf-inet-types; revision-date 2013-07-15; } import ietf-netconf { prefix ietf-nc; revision-date 2011-06-01; } import org-openroadm-common-types { prefix org-openroadm-common-types; revision-date 2023-05-26; } import org-openroadm-common-alarm-pm-types { prefix org-openroadm-common-alarm-pm-types; revision-date 2019-11-29; } import org-openroadm-common-equipment-types { prefix org-openroadm-common-equipment-types; revision-date 2019-11-29; } import org-openroadm-common-state-types { prefix org-openroadm-common-state-types; revision-date 2019-11-29; } import org-openroadm-common-amplifier-types { prefix org-openroadm-common-amplifier-types; revision-date 2019-11-29; } import org-openroadm-common-link-types { prefix org-openroadm-common-link-types; revision-date 2019-11-29; } import org-openroadm-common-node-types { prefix org-openroadm-common-node-types; revision-date 2021-05-28; } import org-openroadm-common-optical-channel-types { prefix org-openroadm-common-optical-channel-types; revision-date 2023-05-26; } import org-openroadm-device-types { prefix org-openroadm-device-types; revision-date 2022-12-09; } import org-openroadm-resource-types { prefix org-openroadm-resource-types; revision-date 2022-03-25; } import org-openroadm-physical-types { prefix org-openroadm-physical-types; revision-date 2019-11-29; } import org-openroadm-user-mgmt { prefix org-openroadm-user-mgmt; revision-date 2020-09-25; } import org-openroadm-port-types { prefix org-openroadm-port-types; revision-date 2023-05-26; } import org-openroadm-interfaces { prefix org-openroadm-interfaces; revision-date 2022-09-30; } import org-openroadm-swdl { prefix org-openroadm-swdl; revision-date 2023-05-26; } import org-openroadm-equipment-states-types { prefix org-openroadm-equipment-states-types; revision-date 2019-11-29; } import org-openroadm-switching-pool-types { prefix org-openroadm-switching-pool-types; revision-date 2019-11-29; } import org-openroadm-optical-operational-interfaces { prefix org-openroadm-optical-operational-interfaces; revision-date 2023-05-26; } import org-openroadm-otn-common-types { prefix org-openroadm-otn-common-types; revision-date 2021-09-24; } import org-openroadm-common-phy-codes { prefix org-openroadm-common-phy-codes; revision-date 2022-05-27; } import org-openroadm-pm-types { prefix org-openroadm-pm-types; revision-date 2022-12-09; } organization "Open ROADM MSA"; contact "OpenROADM.org"; description "YANG definitions of ROADM device Copyright of the Members of the Open ROADM MSA Agreement dated (c) 2016, All other rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: * Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. * Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. * Neither the Members of the Open ROADM MSA Agreement nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission. THIS SOFTWARE IS PROVIDED BY THE MEMBERS OF THE OPEN ROADM MSA AGREEMENT ''AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT THE MEMBERS OF THE OPEN ROADM MSA AGREEMENT BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. Also contains code components extracted from IETF netconf. These code components are copyrighted and licensed as follows: Copyright (c) 2016 IETF Trust and the persons identified as the document authors. All rights reserved. This document is subject to BCP 78 and the IETF Trust's Legal Provisions Relating to IETF Documents (http://trustee.ietf.org/license-info) in effect on the date of publication of this document. Please review these documents carefully, as they describe your rights and restrictions with respect to this document. Code Components extracted from this document must include Simplified BSD License text as described in Section 4.e of the Trust Legal Provisions and are provided without warranty as described in the Simplified BSD License."; revision 2023-05-26 { description "Version 13.1"; } revision 2023-03-31 { description "Version 13.0"; } revision 2022-12-09 { description "Version 12.1"; } revision 2022-09-30 { description "Version 12.0"; } revision 2022-05-27 { description "Version 11.1"; } revision 2022-03-25 { description "Version 11.0"; } revision 2021-12-10 { description "Version 10.1"; } revision 2021-09-24 { description "Version 10.0"; } revision 2021-05-28 { description "Version 9.1"; } revision 2021-03-26 { description "Version 9.0"; } revision 2020-12-11 { description "Version 8.1"; } revision 2020-09-25 { description "Version 8.0"; } revision 2020-05-29 { description "Version 7.1.0"; } revision 2020-03-27 { description "Version 7.0.0"; } revision 2019-11-29 { description "Version 6.1.0"; } revision 2019-09-27 { description "Version 6.0.0"; } revision 2019-05-31 { description "Version 5.1.0"; } revision 2019-03-29 { description "Version 5.0.0"; } revision 2018-11-30 { description "Version 4.1.0"; } revision 2018-09-28 { description "Version 4.0.0"; } revision 2018-05-30 { description "Version 3.1.0"; } revision 2018-03-30 { description "Version 3.0.0"; } revision 2017-12-15 { description "Version 2.2"; } revision 2017-09-29 { description "Version 2.1"; } revision 2017-07-28 { description "Version 2.0.1 - added revision-date to imports"; } revision 2017-06-26 { description "Version 2.0"; } revision 2017-02-06 { description "Version 1.2.1 - removed pattern for current-datetime in info tree and rpc"; } revision 2016-10-14 { description "Version 1.2"; } feature netconf-idle-supervision { description "This feature indicates that the device supports NETCONF idle supervision."; } feature ssh-idle-supervision { description "This feature indicates that the device supports SSH keep-alive and idle supervision."; } feature recovery-mode-support { description "The device supports the ability to detect invalid database situation and enters a recovery-mode which preserve traffic on the data plane, while waiting for the user to initiate recovery actions. The recovery action could be database restore, or in-service database rebuild via configuration replay."; } identity connection-direction-identity { description "Bidrectional capable, or Bi and Unidirectional capable"; } identity connection-direction_bi { base connection-direction-identity; description "Bidrectional capable"; } identity connection-direction_bi_and_uni { base connection-direction-identity; description "Bi and Unidirectional capable"; } typedef interface-ref { type leafref { path "/org-openroadm-device:org-openroadm-device/org-openroadm-device:interface/org-openroadm-device:name"; } description "This type is used by data models that need to reference configured interfaces."; } grouping create-tech-info-group { leaf shelf-id { type leafref { path "/org-openroadm-device/shelves/shelf-name"; } description "shelf ID"; } leaf log-file-name { type string; description "The log file name a vendor can specify for a given log collection operation"; } } grouping device-common { leaf node-id { type org-openroadm-common-node-types:node-id-type; default "openroadm"; description "Globally unique identifier for a device."; } leaf node-number { type uint32; description "Number assigned to a ROADM node at a given office"; } leaf node-type { type org-openroadm-common-node-types:node-types; config true; description "Identifier for node-type e.g Roadm, xponder. Once the node-type is configured, it should not be modified."; } leaf node-subtype { type org-openroadm-common-node-types:node-subtypes; config true; description "A refinement of the node-type. Once the node-subtype is configured, it should not be modified."; } leaf clli { type string; description "Common Language Location Identifier."; } uses org-openroadm-physical-types:node-info; leaf macAddress { type ietf-yang-types:mac-address; config false; description "MAC Address of device"; } leaf softwareVersion { type string; config false; description "Software version"; } leaf software-build { type string; config false; description "Software build version"; } leaf openroadm-version { type org-openroadm-common-types:openroadm-version-type; config false; description "openroadm version used on the device"; } leaf template { type string; description "Template information used in the deployment."; } leaf current-datetime { type ietf-yang-types:date-and-time; config false; description "The current system date and time in UTC. Format: YYYY-MM-DDTHH:MM:SS.mm+ "; } leaf lifecycle-state { type org-openroadm-common-state-types:lifecycle-state; description "Lifecycle State of the device node. Whether it is planned, deployed, in maintenance, etc."; } leaf recovery-mode { if-feature recovery-mode-support; type boolean; config false; default "false"; description "Identify if the device is in recovery mode (True) or not (False)."; } container geoLocation { description "GPS location"; leaf latitude { type decimal64 { fraction-digits 16; range "-90 .. 90"; } description "[From wikipedia] Latitude is an angle (defined below) which ranges from 0 at the Equator to 90 (North or South) at the poles"; } leaf longitude { type decimal64 { fraction-digits 16; range "-180 .. 180"; } description "[From wikipedia] The longitude is measured as the angle east or west from the Prime Meridian, ranging from 0 at the Prime Meridian to +180 eastward and -180 westward."; } } container netconf { description "NETCONF session parameters"; leaf idle-timeout { if-feature netconf-idle-supervision; type uint32 { range "0..1440"; } default "60"; description "NETCONF session idle timeout in minutes. A value of 0 disables idle supervision. Sessions with an active subscription will always disable idle supervision, regardless of this value."; } } container ssh { description "SSH session parameters"; leaf client-alive-interval { if-feature ssh-idle-supervision; type uint32 { range "0..3600"; } default "120"; description "Number of idle seconds before a SSH keep-alive message is sent to the SSH/NETCONF client. A value of 0 disables SSH keep-alive and idle supervision."; } leaf client-alive-max-count { if-feature ssh-idle-supervision; type uint32 { range "0..20"; } default "3"; description "Max number of missing SSH keep-alive message responses before the SSN/NETCONF session is terminated. A value of 0 disables SSH keep-alive and idle supervision."; } } } grouping slot-info { description "slots information. To be populated by NE during retrieval."; leaf slot-name { type string; description "The name of this slot."; } leaf label { type string; description "Faceplate label"; } leaf provisioned-circuit-pack { type leafref { path "/org-openroadm-device/circuit-packs/circuit-pack-name"; } description "The supported circuit-pack. It will be empty if holder status is empty-not-prov, or installed-not-prov"; } leaf slot-status { type enumeration { enum empty-not-prov { value 1; description "Slot is empty and not provisioned"; } enum empty-prov-match { value 2; status obsolete; description "(Deprecated) Slot is empty and expected type is provisioned"; } enum empty-prov-mismatch { value 3; status obsolete; description "(Deprecated) Slot is empty and an unsupported type is provisioned"; } enum installed-not-prov { value 4; description "Slot is occupied but not provisioned"; } enum installed-prov-match { value 5; description "Slot is occupied with matching provisioned type"; } enum installed-prov-mismatch { value 6; description "Slot is occupied with mismatched provisioned type"; } enum empty-prov { value 7; description "Slot is empty and provisioned"; } } } } grouping shelves { list shelves { key "shelf-name"; uses shelf; } } grouping user-description-grp { description "user description group"; leaf user-description { type string; description "user provided description"; } } grouping shelf { leaf shelf-name { type string; description "Unique identifier for this shelf within a device"; } leaf shelf-type { type string; mandatory true; description "The shelf type: describe the shelf with a unique string."; } leaf rack { type string; description "Reflect the shelf physical location data including floor, aisle, bay values."; } leaf shelf-position { type string; description "Reflect the shelf vertical position within an equipment bay."; } leaf lifecycle-state { type org-openroadm-common-state-types:lifecycle-state; description "Lifecycle State of shelf. Whether it is planned, deployed, in maintenance, etc."; } leaf administrative-state { type org-openroadm-equipment-states-types:admin-states; mandatory true; description "Admin State of the shelf"; } uses org-openroadm-physical-types:common-info; leaf equipment-state { type org-openroadm-equipment-states-types:states; description "equipment state for the shelf, used to track the lifecycle state."; } leaf is-physical { type boolean; config false; mandatory true; description "is the entity physical or logical"; } leaf is-passive { type boolean; config false; mandatory true; description "is the entity passive and not actively managed by the device; e.g., no physical inventory or plug-in notification supported"; } leaf faceplate-label { type string; config false; mandatory true; description "label on the faceplace silk screening"; } uses user-description-grp; leaf due-date { type ietf-yang-types:date-and-time; description "due date for the shelf."; } list slots { key "slot-name"; config false; description "List of slots on this shelf. To be populated by NE during retrieval."; uses slot-info; } } grouping circuit-packs { list circuit-packs { key "circuit-pack-name"; description "List of circuit packs. This includes common equipment, like fans, power supplies, etc."; leaf circuit-pack-type { type string; mandatory true; description "Type of circuit-pack For pluggable circuit packs, optical lanes are modeled as child ports with pointers to the physical port as the parent. The number of lanes supported by the pluggable circuit pack is determined by the provisioned circuit-pack-type and/or circuit-pack-product-code. The specific implementation is up to the vendor. For a pluggable circuit pack with only one lane, only the physical port would exist and there should not be a child port (i.e, the single lane is represented by the physical port)"; } leaf circuit-pack-product-code { type string; description "Product Code for the circuit-pack For pluggable circuit packs, optical lanes are modeled as child ports with pointers to the physical port as the parent. The number of lanes supported by the pluggable circuit pack is determined by the provisioned circuit-pack-type and/or circuit-pack-product-code. The specific implementation is up to the vendor. For a pluggable circuit pack with only one lane, only the physical port would exist and there should not be a child port (i.e, the single lane is represented by the physical port)"; } leaf third-party-pluggable { type empty; description "Indicates whether the physical pluggable circuit-pack is from this vendor (attribute is absent) or a third party (attribute is present)."; } uses circuit-pack; } } grouping circuit-pack-features { leaf software-load-version { type string; config false; description "Software version running on the circuit pack."; } list circuit-pack-features { config false; container feature { description "List of features supported by the installed load and indications on whether the features have been applied or not."; leaf description { type string; mandatory true; description "Feature description."; } leaf boot { type boolean; default false; description "Flag to indicate boot loader or unprotected firmware update required"; } leaf activated { type boolean; mandatory true; description "Indicator if the feature has been activated."; } leaf is-service-affecting { type boolean; mandatory true; description "Indicates if the feature/component is service affecting when activated/applied"; } leaf activate-timeout { type uint16; mandatory true; units "seconds"; description "The timeout when activating/applying the circuit pack feature/component. The timer starts when the activation begins for non-service affecting updates (plug-in, power on, software download commit, etc.) or when the cold restart RPC response is received for service affecting updates."; } } } list circuit-pack-components { config false; container component { description "Optional list of components on the circuit-pack and the load information applicable to those components. If a load is not up to date and will upgrade when a cold restart occurs, the version that will be applied should also be listed. If there is no misalignment, this does not need to be reported."; leaf name { type string; mandatory true; description "Name of a component on the circuit-pack that can have a load applied to it."; } leaf boot { type boolean; default "false"; description "Flag to indicate boot loader or unprotected firmware update required"; } leaf current-version { type string; mandatory true; description "Name of the load version currently running on the component."; } leaf version-to-apply { type string; description "Name of the load version for the component that will be applied when cold restart occurs on the circuit-pack."; } leaf is-service-affecting { type boolean; mandatory true; description "Indicates if the feature/component is service affecting when activated/applied"; } leaf activate-timeout { type uint16; mandatory true; units "seconds"; description "The timeout when activating/applying the circuit pack feature/component. The timer starts when the activation begins for non-service affecting updates (plug-in, power on, software download commit, etc.) or when the cold restart RPC response is received for service affecting updates."; } } } } grouping circuit-pack { leaf circuit-pack-name { type string; description "Unique identifier for this circuit-pack within a device"; } leaf lifecycle-state { type org-openroadm-common-state-types:lifecycle-state; description "Lifecycle State of circuit-pack. Whether it is planned, deployed, in maintenance, etc."; } leaf administrative-state { type org-openroadm-equipment-states-types:admin-states; mandatory true; description "Administrative state of circuit-pack"; } uses org-openroadm-physical-types:common-info; container circuit-pack-category { config false; description "General type of circuit-pack"; uses org-openroadm-common-equipment-types:equipment-type; } leaf equipment-state { type org-openroadm-equipment-states-types:states; description "Equipment state, which complements operational state."; } leaf circuit-pack-mode { type string; default "NORMAL"; description "Circuit-pack mode allowed. e.g. NORMAL or REGEN"; } leaf shelf { type leafref { path "/org-openroadm-device/shelves/shelf-name"; } mandatory true; } leaf slot { type string; mandatory true; } leaf subSlot { type string; mandatory false; } leaf is-pluggable-optics { type boolean; config false; mandatory true; description "True if circuitpack is pluggable optics"; } leaf is-physical { type boolean; config false; mandatory true; description "is the entity physical or logical"; } leaf is-passive { type boolean; config false; mandatory true; description "is the entity passive and not actively managed by the device; e.g., no physical inventory or plug-in notification supported"; } leaf faceplate-label { type string; config false; mandatory true; description "label on the faceplace silk screening"; } uses user-description-grp; leaf due-date { type ietf-yang-types:date-and-time; description "due date for this circuit-pack."; } container parent-circuit-pack { description "In the case of circuit packs that contain other equipment (modules or pluggables), this captures the hierarchy of that equipment. It is a vendor specific design decision if the ports for single-port pluggables are modeled as children of the parent circuit-pack, or as children of the pluggable circuit-pack contained in the parent circuit-pack. For modules with multiple ports, it is recommended that ports be children of the module and not the carrier, to help in fault correlation and isolation in the case of a module failure."; uses circuit-pack-name; leaf cp-slot-name { type string; description "Slot name on parent-circuit-pack."; } } list cp-slots { key "slot-name"; config false; description "List of circuit-pack slots on this circuit-pack. To be populated by NE during retrieval."; uses slot-info; leaf slot-type { type enumeration { enum pluggable-optics-holder { value 1; description "slot accepts dedicated pluggable port circuit-pack"; } enum other { value 2; description "slot accepts parent circuit-pack"; } } } } uses circuit-pack-features; list ports { key "port-name"; description "List of ports on this circuit-pack. Note that pluggables are considered independent circuit-packs. All ports that are physically present on a pluggable, need to be modeled as a port against that pluggable circuit-pack, and not against the parent circuit-pack."; uses port; container interconnect-loss-alarm { leaf user-threshold { type org-openroadm-common-link-types:ratio-dB; description "User configurable setting for interconnect loss alarm threshold [dB]"; } leaf threshold-default { type org-openroadm-common-link-types:ratio-dB; config false; description "Vendor-specific default value for the interconnect loss alarm [dB]"; } } container roadm-port { when "../port-qual='roadm-external'"; uses org-openroadm-port-types:roadm-port; } container transponder-port { when "../port-qual='xpdr-network' or ../port-qual='xpdr-client' or ../port-qual='switch-network' or ../port-qual='switch-client'"; uses org-openroadm-port-types:common-port; } container otdr-port { when "../port-qual='otdr'"; description "Settings for otdr port."; leaf launch-cable-length { type uint32; units "m"; default "30"; } leaf port-direction { type org-openroadm-common-alarm-pm-types:direction; } } container ila-port { when "../port-qual='ila-external'"; uses org-openroadm-port-types:common-port; } container roadm-monitor-port { when "../port-qual='roadm-internal-monitor'"; description "Represents a logical optical monitor point in the device. Used to monitor optical channel power at internal locations."; leaf center-frequency { type org-openroadm-common-optical-channel-types:frequency-THz; config false; description "Center frequency associated with the channel being monitored"; } leaf-list roadm-connection { type leafref { path "/org-openroadm-device/roadm-connections/connection-name"; } config false; description "The roadm-connection(s) associated with this monitor port. Typically, there would be one roadm-connection associated with uni-directional monitor ports and two roadm-connections associated with bi-directional monitor ports."; } } } } grouping eth-connection { description "Grouping used to define eth-connections."; leaf connection-name { type string; description "roadm-connection, eth-connection and odu-connection share the same resource-type and resource definition (e.g. connection)"; } leaf direction { type enumeration { enum bidirectional { value 2; } } default "bidirectional"; description "Directionality of connection."; } container source { leaf src-if { type leafref { path "/org-openroadm-device/interface/name"; } mandatory true; } } container destination { leaf dst-if { type leafref { path "/org-openroadm-device/interface/name"; } mandatory true; } } leaf circuit-id { type string { length "0..45"; } description "circuit identifier/user label, can be used in alarm correlation and/or connection management "; } } grouping odu-connection { description "Grouping used to define odu-connections."; leaf connection-name { type string; description "roadm-connection, eth-connection and odu-connection share the same resource-type and resource definition (e.g. connection)"; } leaf direction { type enumeration { enum unidirectional { value 1; } enum bidirectional { value 2; } } default "bidirectional"; description "Directionality of connection. If bidirectional, both directions are created."; } container source { leaf src-if { type leafref { path "/org-openroadm-device/interface/name"; } mandatory true; } } container destination { leaf dst-if { type leafref { path "/org-openroadm-device/interface/name"; } mandatory true; } } leaf circuit-id { type string { length "0..45"; } description "circuit identifier/user label, can be used in alarm correlation and/or connection management "; } } grouping connection { description "Grouping used to define connections."; leaf connection-name { type string; description "roadm-connection, eth-connection and odu-connection share the same resource-type and resource definition (e.g. connection)"; } leaf opticalControlMode { type org-openroadm-common-link-types:optical-control-mode; default "off"; description "Whether connection is currently in power or gain/loss mode"; reference "openroadm.org: Open ROADM MSA Specification."; } leaf target-output-power { type org-openroadm-common-link-types:power-dBm; description "The output target power for this connection. When set, the ROADM will work to ensure that current-output-power reaches this level."; } container source { leaf src-if { type leafref { path "/org-openroadm-device/interface/name"; } mandatory true; } } container destination { leaf dst-if { type leafref { path "/org-openroadm-device/interface/name"; } mandatory true; } } leaf circuit-id { type string { length "0..45"; } description "circuit identifier/user label, can be used in alarm correlation and/or connection management "; } } grouping mc-capabilities-grp { description "Media channel capabilities grouping"; leaf-list mc-capability-profile-name { type leafref { path "/org-openroadm-device/mc-capability-profile/profile-name"; } config false; description "Media channel capabilities"; } } grouping degree { leaf degree-number { type uint16; description "Degree number should be greater than zero and not greater than max-degrees"; } leaf lifecycle-state { type org-openroadm-common-state-types:lifecycle-state; description "Lifecycle State of degree. Whether it is planned, deployed, in maintenance, etc."; } leaf max-wavelengths { type uint16; config false; mandatory true; description "maximum number of wavelengths"; } leaf-list optical-operational-mode-profile-name { type string; config false; description "defines the supported openroadm specifications"; } list circuit-packs { key "index"; description "list for Cards associated with a degree"; leaf index { type uint32; } uses circuit-pack-name { refine "circuit-pack-name" { mandatory true; } } } list connection-ports { key "index"; description "Port associated with degree: One if bi-directional; two if uni-directional"; leaf index { type uint32; } uses port-name { refine "circuit-pack-name" { mandatory true; } refine "port-name" { mandatory true; } } } container otdr-port { description "otdr port associated with degree."; uses port-name; } uses mc-capabilities-grp; } grouping amplifier { leaf amp-number { type uint8 { range "1..128"; } description "Unique identifier/number for the amplifier entry which corresponds to a logical amplifier"; } leaf amp-type { type org-openroadm-common-amplifier-types:amplifier-types; config false; mandatory true; description "Amplifier type"; } leaf-list optical-operational-mode-profile-name { type string; config false; description "defines the supported openroadm specifications"; } leaf control-mode { type org-openroadm-common-amplifier-types:line-amplifier-control-mode; default "off"; description "Whether the line amplifier is currently in off or gainLoss mode. control-mode can only be set to gainLoss when target-gain, target-tilt and egress-average-channel-power are set and the OMS interfaces are provisioned. The amplifier will be turned off when the control-mode is set to off"; } leaf amp-gain-range { type org-openroadm-common-amplifier-types:amplifier-gain-range; default "gain-range-1"; config false; description "Amplifier gain-range (gain-range 1 to 4 for switched gain amplifiers) gain-range-1 (default value) for standard amplifiers"; } leaf target-gain { type org-openroadm-common-link-types:ratio-dB; config true; description "Target overall Amplifier Signal gain, excluding ASE, including VOA attenuation. Defined as optional for ODL support, but shall be considered as mandatory and provided by the controller when the control-mode is set to gainLoss for amplifier setting"; } leaf target-tilt { type org-openroadm-common-link-types:ratio-dB; config true; description "Target tilt configured in case of smart EDFA. Tilt value provided as specified in Open-ROADM-MSA-specifications spreadsheet Defined as optional for ODL support, but shall be considered as mandatory and provided by the controller when the control-mode is set to gainLoss for amplifier setting"; } leaf egress-average-channel-power { type org-openroadm-common-link-types:power-dBm; config true; description "Based upon the total max power across the 4.8 THz passband. Defined as optional for ODL support, but shall be considered as mandatory and provided by the controller when the control-mode is set to gainLoss for amplifier setting"; } leaf out-voa-att { type org-openroadm-common-link-types:ratio-dB; config false; description "Used to provide the value output VOA attenuation, optional"; } leaf partner-amp { type leafref { path "/org-openroadm-device/line-amplifier/amp-number"; } config false; description "amp-number of amp module that is functionally associated to the amplifier in the opposite direction"; } leaf ila-direction-label { type string; description "Amplifier direction. Each operators may have its own naming convention. Shall be consistent with tx-instance-port-direction-label and rx-instance-port-direction-label."; } leaf lifecycle-state { type org-openroadm-common-state-types:lifecycle-state; description "Lifecycle State of the amplifier. Whether it is planned, deployed, in maintenance, etc."; } } grouping external-links { description "YANG definitions for external links.. - physical links between ROADMs and between the ROADMs and XPonders, which can be added and removed manually."; list external-link { key "external-link-name"; uses external-link; } } grouping external-link { leaf external-link-name { type string; } container source { uses org-openroadm-resource-types:device-id { refine "node-id" { mandatory true; } } uses org-openroadm-resource-types:port-name { refine "circuit-pack-name" { mandatory true; } refine "port-name" { mandatory true; } } } container destination { uses org-openroadm-resource-types:device-id { refine "node-id" { mandatory true; } } uses org-openroadm-resource-types:port-name { refine "circuit-pack-name" { mandatory true; } refine "port-name" { mandatory true; } } } } grouping internal-links { list internal-link { key "internal-link-name"; config false; uses internal-link; } } grouping internal-link { leaf internal-link-name { type string; } container source { uses port-name { refine "circuit-pack-name" { mandatory true; } refine "port-name" { mandatory true; } } } container destination { uses port-name { refine "circuit-pack-name" { mandatory true; } refine "port-name" { mandatory true; } } } } grouping physical-links { description "YANG definitions for physical links. - physical links (fiber, cables,etc.) between ports within a node. "; list physical-link { key "physical-link-name"; uses physical-link; } } grouping physical-link { leaf physical-link-name { type string; } leaf is-physical { type boolean; description "is the entity physical or logical"; } uses user-description-grp; container source { uses port-name { refine "circuit-pack-name" { mandatory true; } refine "port-name" { mandatory true; } } } container destination { uses port-name { refine "circuit-pack-name" { mandatory true; } refine "port-name" { mandatory true; } } } leaf lifecycle-state { type org-openroadm-common-state-types:lifecycle-state; description "Lifecycle State of the physical link. Whether it is planned, deployed, in maintenance, etc."; } } grouping srg { leaf max-add-drop-ports { type uint16; config false; mandatory true; description "The max number of ports available for a given srg"; } leaf current-provisioned-add-drop-ports { type uint16; config false; mandatory true; description "The number of ports currently provisioned for a given srg."; } leaf prov-max-add-drop-ports { type uint16; description "Provisioned max add/drop ports. Used by a management system to keep track of the maximum number of add/drop port based on external constraints such as rack configuration. It is expected that the management system would set this attribute to a value less than or equal to the RO max-add-drop-ports. This value is for management system use only and is not enforced by the system. E.g., this value will not restrict any provisioning. It is up to the management system to ensure equipment is not provisioned to exceed this value."; } leaf srg-number { type uint16; description "Srg number should be greater than zero and not greater than max-srgs"; } leaf-list optical-operational-mode-profile-name { type string; config false; description "defines the supported openroadm specifications"; } leaf lifecycle-state { type org-openroadm-common-state-types:lifecycle-state; description "Lifecycle State of shared-risk-group. Whether it is planned, deployed, in maintenance, etc."; } leaf wavelength-duplication { type org-openroadm-common-optical-channel-types:wavelength-duplication-type; config false; mandatory true; description "Whether the SRG can handle duplicate wavelengths and if so to what extent."; } list circuit-packs { key "index"; description "list for Cards associated with an add/drop group and srg"; leaf index { type uint32; } uses circuit-pack-name { refine "circuit-pack-name" { mandatory true; } } } uses mc-capabilities-grp; } grouping xponder { leaf xpdr-number { type uint16; must 'current() > 0' { error-message "Xponder not supported by device "; description "Validating if the Xponder is supported by device"; } } leaf xpdr-type { type org-openroadm-common-node-types:xpdr-node-types; mandatory true; description "Identifier for xponder-type e.g Transponder, Muxponder"; } leaf lifecycle-state { type org-openroadm-common-state-types:lifecycle-state; description "Lifecycle State of xponder. Whether it is planned, deployed, in maintenance, etc."; } leaf recolor { type boolean; config false; description "Indication if recolor is supported"; } list xpdr-port { key "index"; description "Network Ports with in a Xponder"; leaf index { type uint32; } uses port-name { refine "circuit-pack-name" { mandatory true; } refine "port-name" { mandatory true; } } leaf eqpt-srg-id { type uint32; description "Shared Risk Group identifier. All ports in a circuit-pack will have same srg-id"; } } list xpdr-pluggable-optics-holder { key "index"; description "Xponder pluggable optics"; leaf index { type uint32; } uses circuit-pack-name { refine "circuit-pack-name" { mandatory true; } } leaf cp-slot-name { type string; mandatory true; description "cp-slot-name mapped to /org-openroadm-device/circuit-packs[circuit-pack-name=current()/../circuit-pack-name]/cp-slots/slot-name"; } leaf eqpt-srg-id { type uint32; description "Shared Risk Group identifier. All ports in a circuit-pack will have same srg-id"; } } } grouping ext-pluggable { leaf extplug-number { type uint16; must 'current() > 0' { error-message "External pluggable not supported by device "; description "Validating if the External pluggable is supported by device"; } } leaf lifecycle-state { type org-openroadm-common-state-types:lifecycle-state; description "Lifecycle State of external-pluggable. Whether it is planned, deployed, in maintenance, etc."; } list extplug-port { key "index"; description "Network Port(s) within a External Plug : only one port if it is bidirectionnal"; leaf index { type uint16; } uses port-name { refine "circuit-pack-name" { mandatory true; } refine "port-name" { mandatory true; } } leaf eqpt-srg-id { type uint32; description "Shared Risk Group identifier. All ports in a circuit-pack will have same srg-id"; } } } grouping degree-number { leaf degree-number { type leafref { path "/org-openroadm-device/degree/degree-number"; } description "Degree identifier. Unique within the context of a device."; } } grouping circuit-pack-name { leaf circuit-pack-name { type leafref { path "/org-openroadm-device/circuit-packs/circuit-pack-name"; } description "Circuit-Pack identifier. Unique within the context of a device."; } } grouping port-name { uses circuit-pack-name; leaf port-name { type leafref { path "/org-openroadm-device/circuit-packs[circuit-pack-name=current()/../circuit-pack-name]/ports/port-name"; } description "Port identifier. Unique within the context of a circuit-pack."; } } grouping srg-number { leaf srg-number { type leafref { path "/org-openroadm-device/shared-risk-group/srg-number"; } description "Shared Risk Group identifier. Unique within the context of a device."; } } grouping supporting-port-name { leaf supporting-circuit-pack-name { type leafref { path "/org-openroadm-device/circuit-packs/circuit-pack-name"; } description "Identifier of the supporting circuit-pack."; } leaf supporting-port { type leafref { path "/org-openroadm-device/circuit-packs[circuit-pack-name=current()/../supporting-circuit-pack-name]/ports/port-name"; } description "Identifier of the supporting port."; } } grouping supporting-circuit-pack-list-grp { description "supporting circuit pack list grouping"; list supporting-port-list { key "index"; description "supporting port list"; leaf index { type uint8; description "supporting circuit pack index"; } leaf circuit-pack-name { type leafref { path "/org-openroadm-device/circuit-packs/circuit-pack-name"; } mandatory true; description "The supported circuit-pack."; } leaf-list port-list { type leafref { path "/org-openroadm-device/circuit-packs[circuit-pack-name=current()/../circuit-pack-name]/ports/port-name"; } description "port list"; } } } grouping interface-name { description "interface name grouping"; leaf interface-name { type leafref { path "/org-openroadm-device/interface/name"; } description "Name of an interface. Unique within the context of a device."; } } grouping interfaces-grp { description "OpenROADM Interface configuration parameters."; list interface { key "name"; description "The list of configured interfaces on the device."; leaf name { type string; description "The name of the interface."; } leaf description { type string; description "A textual description of the interface."; } leaf type { type identityref { base org-openroadm-interfaces:interface-type; } mandatory true; description "The type of the interface."; } leaf lifecycle-state { type org-openroadm-common-state-types:lifecycle-state; description "Lifecycle State of interface. Whether it is planned, deployed, in maintenance, etc."; } leaf administrative-state { type org-openroadm-equipment-states-types:admin-states; mandatory true; } leaf operational-state { type org-openroadm-common-state-types:state; config false; mandatory true; description "Operational state. For bidirectional entity this attribute represents the summary operational state for the entity. If either direction is outOfService then the operational-state is outOfService. If one direction is degraded and the other direction is either inService or degraded, then the operational state is degraded. If both directions are inService then the operational-state is inService. The operational state represents the functional state of an entity. An operational-state of outOfService or degraded should have a standing condition that relates to this status."; } leaf operational-state-rx { type org-openroadm-common-state-types:state; config false; description "Operational state for the receive direction. The operational state represents the functional state of an entity. An operational-state of outOfService or degraded should have a standing condition that relates to this status."; } leaf operational-state-tx { type org-openroadm-common-state-types:state; config false; description "Operational state for the transmit direction. The operational state represents the functional state of an entity. An operational-state of outOfService or degraded should have a standing condition that relates to this status."; } leaf circuit-id { type string { length "0..45"; } description "circuit identifier/user label, can be used in alarm correlation and/or connection management "; } uses supporting-port-name; leaf-list supporting-interface-list { type leafref { path "/org-openroadm-device/interface/name"; } description "Supporting interface list. a) For an interface that is created directly on a port, this leaf-list is not applicable and must not be specified. b) For an interface that is created on another interface(s), this leaf-list must be provided. The supporting-circuit-pack-name and supporting-port-name is not required to be specified. If not specified, the device will auto-populate the supporting-circuit-pack-name and supporting-port-name. The supporting-circuit-pack-name and supporting-port-name may optionally be supplied in addition to the supporting-interface-list; however, the device shall validate that they are consistent or deny the provisioning."; } container common-functions { description "Container to take common interface functions from augments in sub-modules."; } } } grouping protection-groups { description "OpenROADM facility protection configuration parameters."; container protection-grps { description "The list of configured protection groups on the device."; } container protection-profiles { config false; description "The list of defined protection profiles on the device."; } } grouping port { description "Grouping of attributes related to a port object."; leaf port-name { type string; mandatory true; description "Identifier for a port, unique within a circuit pack"; } uses supporting-circuit-pack-list-grp; leaf port-type { type string; description "Type of the pluggable or fixed port."; } leaf port-qual { type org-openroadm-device-types:port-qual; } leaf port-wavelength-type { type org-openroadm-port-types:port-wavelength-types; config false; description "Type of port - single, multiple-wavelength, etc."; } leaf port-direction { type org-openroadm-common-alarm-pm-types:direction; config false; mandatory true; description "Whether port is uni (tx/rx) or bi-directional and"; } leaf-list compliance-codes { type org-openroadm-common-phy-codes:compliance-codes-union; config false; description "A list of OpenROADM defined compliance codes supported by this port."; } uses org-openroadm-port-types:port-features { refine "is-physical" { config false; mandatory true; } refine "pm-capable" { config false; mandatory true; } refine "alarm-capable" { config false; mandatory true; } } leaf faceplate-label { type string; config false; mandatory true; description "label on the faceplace silk screening"; } uses user-description-grp; leaf circuit-id { type string { length "0..45"; } description "circuit identifier/user label, can be used in alarm correlation and/or connection management "; } leaf lifecycle-state { type org-openroadm-common-state-types:lifecycle-state; description "Lifecycle State of port. Whether it is planned, deployed, in maintenance, etc."; } leaf administrative-state { type org-openroadm-equipment-states-types:admin-states; default "outOfService"; description "Administrative state of port. The value of this field independent of the state of its contained and containing resources. Setting this a port to administratively down will impact both its operational state, as well the operational state of its contained resources. If this port is an endpoint to a connection, internal-link, physical-link, etc, then administratively disabling this port will impact the operational state of those items unless they are using some form of port-protection schema."; } leaf operational-state { type org-openroadm-common-state-types:state; config false; mandatory true; description "Operational state of a port. For bidirectional entity this attribute represents the summary operational state for the entity. If either direction is outOfService then the operational-state is outOfService. If one direction is degraded and the other direction is either inService or degraded, then the operational state is degraded. If both directions are inService then the operational-state is inService. The operational state represents the functional state of an entity. An operational-state of outOfService or degraded should have a standing condition that relates to this status."; } leaf operational-state-rx { type org-openroadm-common-state-types:state; config false; description "Operational state for the receive direction. The operational state represents the functional state of an entity. An operational-state of outOfService or degraded should have a standing condition that relates to this status."; } leaf operational-state-tx { type org-openroadm-common-state-types:state; config false; description "Operational state for the transmit direction. The operational state represents the functional state of an entity. An operational-state of outOfService or degraded should have a standing condition that relates to this status."; } leaf logical-connection-point { type string; description "delete or replace with list logical-ports or connections?"; } container partner-port { config false; description "For ports which are not identified as having a direction of bidirectional, this field is used to identify the port which corresponds to the reverse direction. A port pair should include a port for each direction (tx, rx) and report their mate as partner-port."; uses port-name; } container parent-port { config false; description "In the case of port hierarchy, this is the parent port, which is also modeled as port within this circuit-pack. This is used in the case of a port that supports a parallel connector that contains subports. The parent-port of the subport will be the port that contains this subport. This can be used to help isolate faults when a single fault on a parallel connector introduces symptomatic failures on the contained subports."; uses port-name; } list interfaces { config false; description "List of the interfaces this port supports. This is a list of names of instances in the flat instance list. Implementations must provide the list of interfaces for port that has interfaces provisioned on that port."; uses interface-name; } uses mc-capabilities-grp; } grouping odu-mux-hierarchy-grp { description "ODU mux hierarchy group"; list mux-capability { key "stage-number ho-odu-type ho-odu-payload-type"; description "low order ODU TCM direction capability"; leaf stage-number { type uint8 { range "1 .. 2"; } description "stage number"; } leaf ho-odu-type { type identityref { base org-openroadm-otn-common-types:odu-rate-identity; } description "High order ODU type"; } leaf ho-odu-payload-type { type org-openroadm-otn-common-types:payload-type-def; description "High order ODU payload type"; } leaf-list supported-lo-odu-type { type identityref { base org-openroadm-otn-common-types:odu-rate-identity; } description "Supported low order ODU type"; } leaf lo-odu-proactive-DMp { type boolean; description "low order ODU PM delay measurement (DMp) (G.709 06-2016 15.8.2.1.6)"; } leaf lo-odu-tcm-capable { type boolean; description "only when lo-odu-tcm-capable=true, the following two are applicable (ie, lo-odu-proactive-DMt, lo-odu-tcm-direction"; } leaf lo-odu-proactive-DMt { when "../lo-odu-tcm-capable= 'true'"; type boolean; description "low order ODU TCM delay measurement (DMt) (G.709 06-2016 15.8.2.2.8)"; } leaf lo-odu-tcm-direction-capability { when "../lo-odu-tcm-capable= 'true'"; type org-openroadm-common-types:tcm-direction-capability-type; description "Supported tcm direction capability for low order ODU associated with the port."; } } } identity flexo-modulation-format-identity { description "Flexo modulation format identification"; } grouping flexo-grp { description "Flexo group"; leaf circuit-pack-name { type leafref { path "/org-openroadm-device:org-openroadm-device/org-openroadm-device:circuit-packs/org-openroadm-device:circuit-pack-name"; } description "Circuit-Pack identifier. Unique within the context of a device."; } leaf port-name { type leafref { path "/org-openroadm-device:org-openroadm-device/org-openroadm-device:circuit-packs/org-openroadm-device:ports/org-openroadm-device:port-name"; } description "Port index identifier. Unique within the context of a circuit-pack."; } leaf otsi-rate { type identityref { base org-openroadm-common-optical-channel-types:otsi-rate-identity; } mandatory true; description "Flexo rate"; } leaf otsi-modulation-format { type identityref { base flexo-modulation-format-identity; } description "Flexo modulation format"; } leaf otsi-width { type uint16; description "OTSI width"; } leaf operational-mode-id { type string; mandatory true; description "Optical profile operational mode identifier"; } } grouping otsigroup-capability-grp { description "Otsigroup group capability"; leaf if-cap-type { type identityref { base org-openroadm-port-types:supported-if-capability; } description "Interface type/hierarchy/rate supported on this Otsi port. For example, if-n-otu4-n-odu4 and if-otucn-oducn"; } leaf flexo-payload-type { type org-openroadm-otn-common-types:flexo-payload-type-def; description "By default 0x00. Payload type 0x02 in FlexO multiplexed structure (G.709.3 Annex F (2020-12)) G.798 15.3.5.1 (FlexO-n/OTUCni_A_So) source to insert PT code '0000 0010' (2021-01)"; } choice otu-rate { description "To specify the supported rate in the case of OTUCn or NxOTU4"; case otucn { leaf otucn-n-rate { type uint16; description "Specify the N associated with OTUCn, e.g. N = 2,3,4 for 200G/300G/400G respectively. When NE publishes in the OTSi group capability profile with FlexO payload type = 0x02, (Section 9.2.6.2, G.709.1 2020-12) this RO attribute indicates the OTSiG group supports multiple OTUCni, with the highest rate up to the specific otucn-n-rate "; } } case nxotu4 { leaf supported-n-otu4 { type uint16; description "Specify the number of N in the case of N x OTU4"; } } } leaf-list foic-type { type identityref { base org-openroadm-common-optical-channel-types:foic-identity; } description "FlexO interface type "; } leaf otn-capability-profile-name { type leafref { path "/org-openroadm-device/otn-capability-profile/profile-name"; } description "OTN capabilities"; } leaf otn-odu-mux-hierarchy-profile-name { type leafref { path "/org-openroadm-device/otn-odu-mux-hierarchy-profile/profile-name"; } description "OTN ODU Mux hierarchy capabilities"; } } grouping split-lambda-capability-grp { description "Split lambda capability group"; container logical-port { leaf circuit-pack-name { type string; description "The circuit pack supporting the logical port"; } leaf port-name { type string; description "Port name for logical-port"; } description "Logical port container"; } list otsi { key "circuit-pack-name port-name"; unique "order-index"; description "OTSI list for split lambda"; leaf circuit-pack-name { type string; description "OTSI circuit pack name"; } leaf port-name { type string; description "OTSI port name"; } leaf otsi-rate { type identityref { base org-openroadm-common-optical-channel-types:otsi-rate-identity; } description "OTSI rate"; } leaf-list optical-operational-mode { type leafref { path "/org-openroadm-device/optical-operational-mode-profile/profile-name"; } description "Optical operational mode leaf list"; } leaf order-index { type int8; description "The device supported FlexO-x-DO/OTSi interfaces's sequential order within the FlexO-group/OTSi-group"; } } leaf-list otsigroup-capability-profile-name { type leafref { path "/org-openroadm-device/otsigroup-capability-profile/profile-name"; } description "OTSI group capability mode"; } } grouping otn-capability-grp { description "OTN capability group"; leaf-list if-protection-capability { type identityref { base org-openroadm-common-types:otn-protection-type; } description "supported protection types if protection is supported on this port"; } leaf proactive-DMp { type boolean; description "ODU PM delay measurement (DMp) (G.709 06-2016 15.8.2.1.6)"; } leaf tcm-capable { type boolean; description "only when tcm-capable=true, the following two are applicable (ie, proactive-DMt, tcm-direction"; } leaf proactive-DMt { when "../tcm-capable= 'true'"; type boolean; description "ODU TCM delay measurement (DMt) (G.709 06-2016 15.8.2.2.8)"; } leaf tcm-direction-capability { when "../tcm-capable= 'true'"; type org-openroadm-common-types:tcm-direction-capability-type; description "Supported tcm direction capability on the ODUk associated with the port."; } leaf-list opu-payload-type-mapping { type org-openroadm-otn-common-types:payload-type-def; description "OPU payload-type mapping OPU."; } } grouping otn-odu-mux-hierarchy-grp { description "ODU mux hierarchy base group"; list mux-capability { key "stage-number ho-odu-type ho-odu-payload-type"; description "low order ODU TCM direction capability"; leaf stage-number { type uint8 { range "1 .. 2"; } description "stage number"; } leaf ho-odu-type { type identityref { base org-openroadm-otn-common-types:odu-rate-identity; } description "High order ODU type"; } leaf ho-odu-payload-type { type org-openroadm-otn-common-types:payload-type-def; description "High order ODU payload type"; } leaf-list supported-lo-odu-type { type identityref { base org-openroadm-otn-common-types:odu-rate-identity; } description "Supported low order ODU type"; } leaf lo-odu-proactive-DMp { type boolean; description "low order ODU PM delay measurement (DMp) (G.709 06-2016 15.8.2.1.6)"; } leaf lo-odu-tcm-capable { type boolean; description "only when lo-odu-tcm-capable=true, the following two are applicable (ie, lo-odu-proactive-DMt, lo-odu-tcm-direction"; } leaf lo-odu-proactive-DMt { when "../lo-odu-tcm-capable= 'true'"; type boolean; description "low order ODU TCM delay measurement (DMt) (G.709 06-2016 15.8.2.2.8)"; } leaf lo-odu-tcm-direction-capability { when "../lo-odu-tcm-capable= 'true'"; type org-openroadm-common-types:tcm-direction-capability-type; description "Supported tcm direction capability for low order ODU associated with the port."; } } } grouping mux-grp { leaf odtu-type { type identityref { base org-openroadm-otn-common-types:odtu-type-identity; } mandatory true; description "ODTU type, part of the MSI (Multiplex Structure Identifier)"; } leaf network-odu-rate { type identityref { base org-openroadm-otn-common-types:odu-rate-identity; } mandatory true; description "Network ODU rate"; } leaf network-oducn-n-rate { type uint16; description "Network ODUCn rate, eg, network-oducn-n-rate=4 for ODUC4"; } leaf network-ho-odu-trib-port-number { type uint16 { range "1 .. 80"; } mandatory true; description "Tributary port number"; } leaf-list network-ho-odu-trib-slots { type uint16 { range "1 .. 80"; } max-elements 80; description "Network high order ODU trib slots for ODUk (HO-ODU4 and below)"; } leaf-list network-ho-odu-opucn-trib-slots { type org-openroadm-otn-common-types:opucn-trib-slot-def; description "Network high order ODU OPU tributary slots"; } description "Mux group grouping"; } grouping mux-eth-grp { leaf network-flexo-trib-port-number { type uint16 { range "1 .. 128"; } mandatory true; description "Tributary port number"; reference "G.709.1 Amd.4 2023-03 clause 10.2.3.1"; } leaf-list network-flexo-iid { type uint16; description "Network FlexO instance id"; } description "Mux group grouping for Ethernet optimized FlexO"; } grouping otsi-grp { leaf otsi-rate { type identityref { base org-openroadm-common-optical-channel-types:otsi-rate-identity; } mandatory true; description "OTSi rate"; } list otsi-optical-mode-support { config false; description "List of supported optical mode attributes"; leaf modulation-format { type org-openroadm-common-optical-channel-types:modulation-format; mandatory true; description "OTSi modulation formats supported by the profile"; } leaf fec { type identityref { base org-openroadm-common-types:fec-identity; } mandatory true; description "OTSi FEC types supported by the profile"; } } description "OTSi group grouping"; } grouping org-openroadm-device-container { container org-openroadm-device { container info { uses device-common; leaf max-degrees { type uint16; config false; description "Max. number of degrees supported by device"; } leaf max-srgs { type uint16; config false; description "Max. number of SRGs in an add/drop group"; } leaf max-num-bin-15min-historical-pm { type uint16; config false; description "Max. number of bin the NE support for 15min historical PM"; } leaf max-num-bin-24hour-historical-pm { type uint16; config false; description "Max. number of bin the NE support for 24hour historical PM"; } } container users { description "Stores a list of users"; uses org-openroadm-user-mgmt:user-profile; } container pending-sw { config false; description "pending software information"; uses org-openroadm-swdl:sw-bank; } container database-info { config false; description "database restore information"; uses org-openroadm-swdl:database-info-group; } uses shelves; uses circuit-packs; uses interfaces-grp; uses protection-groups; container protocols { description "Contains the supported protocols"; leaf lifecycle-state { type org-openroadm-common-state-types:lifecycle-state; description "Lifecycle State of the protocols. Whether it is planned or deployed, etc."; } } uses internal-links; uses physical-links; uses external-links; list degree { when "/org-openroadm-device/info/node-type='rdm'"; key "degree-number"; uses degree; } list shared-risk-group { when "/org-openroadm-device/info/node-type='rdm'"; key "srg-number"; uses srg; } list line-amplifier { when "/org-openroadm-device/info/node-type='ila'"; key "amp-number"; description "lists amplifiers in different directions"; uses amplifier; list circuit-pack { key "index"; description "list for Cards associated with an amplifier"; leaf index { type uint32; } uses circuit-pack-name { refine "circuit-pack-name" { mandatory true; } } } list line-port { key "port-direction"; description "Port associated with an amplifier which face the line (ila-external): traffic port."; leaf port-direction { type org-openroadm-common-alarm-pm-types:direction; config true; mandatory true; description "partly allows identifying ports associated with logical amp :TX for egress, RX for ingress TXRX in case of bidirectional port"; } leaf tx-instance-port-direction-label { type string; config true; description "Complements ports identification. Used notably in case of bidirectional ports, and/or in multi-degree amplifier nodes. Allows associating one of the directions specified in ila-direction-label. Shall be consistent with ila-direction-label"; } leaf rx-instance-port-direction-label { type string; config true; description "Complements ports identification. Used notably in case of bidirectional ports, and/or in multi-degree amplifier nodes. Allows associating one of the directions specified in ila-direction-label. Shall be consistent with ila-direction-label"; } uses port-name { refine "circuit-pack-name" { mandatory true; } refine "port-name" { mandatory true; } } } list osc-port { key "port-direction"; description "Ports associated with OSC"; leaf port-direction { type org-openroadm-common-alarm-pm-types:direction; config true; mandatory true; description "allows identifying ports associated with logical amp : TX for OSC circuit-pack IN RX for OSC circuit-pack OUT"; } uses port-name { refine "circuit-pack-name" { mandatory true; } refine "port-name" { mandatory true; } } } list otdr-port { key "otdr-direction"; description "otdr ports associated with an ILA"; leaf otdr-direction { type string; config true; description "allows identifying associated logical amp port in which OTDR is launched: corresponds to rx-instance-port-direction-label of corresponding amplifier line-port"; } uses port-name { refine "circuit-pack-name" { mandatory true; } refine "port-name" { mandatory true; } } } } list xponder { when "/org-openroadm-device/info/node-type='xpdr'"; key "xpdr-number"; uses xponder; } list ext-pluggable { when "/org-openroadm-device/info/node-type='extplug'"; key "extplug-number"; uses ext-pluggable; } list roadm-connections { when "/org-openroadm-device/info/node-type='rdm'"; key "connection-name"; uses connection; } list eth-connections { when "/org-openroadm-device/info/node-type='xpdr'"; key "connection-name"; uses eth-connection; } list odu-connection { when "/org-openroadm-device/info/node-type='xpdr'"; key "connection-name"; uses odu-connection; } list connection-map { key "connection-map-number"; config false; leaf connection-map-number { type uint32; description "Unique identifier for this connection-map entry"; } container source { leaf circuit-pack-name { type leafref { path "/org-openroadm-device/circuit-packs/circuit-pack-name"; } mandatory true; } leaf port-name { type leafref { path "/org-openroadm-device/circuit-packs[circuit-pack-name=current()/../circuit-pack-name]/ports/port-name"; } mandatory true; description "Port identifier. Unique within the context of a circuit-pack."; } } list destination { key "circuit-pack-name port-name"; min-elements 1; leaf circuit-pack-name { type leafref { path "/org-openroadm-device/circuit-packs/circuit-pack-name"; } mandatory true; } leaf port-name { type leafref { path "/org-openroadm-device/circuit-packs[circuit-pack-name=current()/../circuit-pack-name]/ports/port-name"; } mandatory true; description "Port identifier. Unique within the context of a circuit-pack."; } } } list odu-switching-pools { when "/org-openroadm-device/info/node-type='xpdr'"; key "switching-pool-number"; config false; leaf switching-pool-number { type uint16; description "Unique identifier for this odu-switching-pool"; } leaf switching-pool-type { type org-openroadm-switching-pool-types:switching-pool-types; description "Blocking/Non-Blocking"; } leaf odu-connection-direction-capabilities { type identityref { base connection-direction-identity; } description "Bidrectional capable, or Bi and Unidirectional capable"; } list non-blocking-list { key "nbl-number"; config false; description "List of ports in a non-blocking switch element"; leaf nbl-number { type uint16; description "Identifier for this non-blocking-list. Unique within odu-switching-pool"; } leaf interconnect-bandwidth-unit { type uint32; config false; description "Switch fabric interconnect bandwidth unit rate in bits per second. Represents granularity of switch fabric"; } leaf interconnect-bandwidth { type uint32; config false; description "Total interconnect bandwidth for a non-blocking element expressed as number of inter-connect-bandwidth units"; } list port-list { key "circuit-pack-name port-name"; leaf circuit-pack-name { type leafref { path "/org-openroadm-device/circuit-packs/circuit-pack-name"; } config false; } leaf port-name { type leafref { path "/org-openroadm-device/circuit-packs/ports/port-name"; } config false; description "Port name. Unique within device"; } } list pluggable-optics-holder-list { key "circuit-pack-name slot-name"; leaf circuit-pack-name { type leafref { path "/org-openroadm-device/circuit-packs/circuit-pack-name"; } config false; description "Name of parent circuit-pack"; } leaf slot-name { type leafref { path "/org-openroadm-device/circuit-packs/cp-slots/slot-name"; } config false; description "Name of pluggable-optics-holder"; } } } } list eth-switching-pools { when "/org-openroadm-device/info/node-type='xpdr'"; key "switching-pool-number"; config false; leaf switching-pool-number { type uint16; description "Unique identifier for this eth-switching-pool"; } leaf switching-pool-type { type org-openroadm-switching-pool-types:switching-pool-types; description "Blocking/Non-Blocking"; } list non-blocking-list { key "nbl-number"; config false; description "List of ports in a non-blocking switch element"; leaf nbl-number { type uint16; description "Identifier for this non-blocking-list. Unique within eth-switching-pool"; } leaf interconnect-bandwidth-unit { type uint32; config false; description "Switch fabric interconnect bandwidth unit rate in bits per second. Represents granularity of switch fabric"; } leaf interconnect-bandwidth { type uint32; config false; description "Total interconnect bandwidth for a non-blocking element expressed as number of inter-connect-bandwidth units"; } list port-list { key "circuit-pack-name port-name"; leaf circuit-pack-name { type leafref { path "/org-openroadm-device/circuit-packs/circuit-pack-name"; } config false; } leaf port-name { type leafref { path "/org-openroadm-device/circuit-packs/ports/port-name"; } config false; description "Port name. Unique within device"; } } list pluggable-optics-holder-list { key "circuit-pack-name slot-name"; leaf circuit-pack-name { type leafref { path "/org-openroadm-device/circuit-packs/circuit-pack-name"; } config false; description "Name of parent circuit-pack"; } leaf slot-name { type leafref { path "/org-openroadm-device/circuit-packs/cp-slots/slot-name"; } config false; description "Name of pluggable-optics-holder"; } } } } list otsigroup-capability-profile { key "profile-name"; config false; description "OTSI group operational profile"; leaf profile-name { type string; description "OTSI group profile name"; } uses otsigroup-capability-grp; } list mc-capability-profile { key "profile-name"; config false; description "Media channel capability profile list"; leaf profile-name { type string; description "Media channel profile name"; } leaf center-freq-granularity { type org-openroadm-common-optical-channel-types:frequency-GHz; default "50"; config false; description "Granularity of allowed center frequencies. The base frequency for this computation is 193.1 THz (G.694.1)"; } leaf min-edge-freq { type org-openroadm-common-optical-channel-types:frequency-THz; config false; description "Minimum edge frequency"; } leaf max-edge-freq { type org-openroadm-common-optical-channel-types:frequency-THz; config false; description "Maximum edge frequency"; } leaf slot-width-granularity { type org-openroadm-common-optical-channel-types:frequency-GHz; default "50"; config false; description "Width of a slot measured in GHz."; } leaf min-slots { type uint32; default "1"; config false; description "Minimum number of slots permitted to be joined together to form a media channel. Must be less than or equal to the max-slots"; } leaf max-slots { type uint32; default "1"; config false; description "Maximum number of slots permitted to be joined together to form a media channel. Must be greater than or equal to the min-slots"; } } list split-lambda-profile { key "profile-name"; config false; description "OTN capability profile"; leaf profile-name { type string; description "Split lambda profile name"; } uses split-lambda-capability-grp; } list otn-odu-mux-hierarchy-profile { key "profile-name"; config false; description "OTN ODU mux hierarchy profile list"; leaf profile-name { type string; description "OTN ODU mux hierarchy profile name"; } uses otn-odu-mux-hierarchy-grp; } list optical-operational-mode-profile { key "profile-name"; config false; description "List of optical operational mode profiles which includes : _specific operational mode used for bookended applications _openroadm operational mode introduced in R10.0 to describe the specifications a device may complies with whether it is a Xponder (port), Pluggable (port), degree (Node), srg (Node)or ila (Node)."; leaf profile-name { type string; description "Optical operational profile name"; } uses org-openroadm-optical-operational-interfaces:optical-operational-modes-grp-attr; } list otn-capability-profile { key "profile-name"; config false; description "OTN capability profile"; leaf profile-name { type string; description "OTN capability profile name"; } uses otn-capability-grp; } list muxp-profile { key "profile-name"; config false; description "Muxp profile list"; leaf profile-name { type string; description "Mux profile name"; } uses mux-grp; } list muxp-eth-profile { key "profile-name"; config false; description "Muxp profile list"; leaf profile-name { type string; description "Mux profile name"; } leaf network-eth-speed { type uint32; description "Network ethernet speed types supported by the profile, unit mbps"; } uses mux-eth-grp; } list otsi-profile { key "profile-name"; config false; description "Optical Tributary Signal (OTSi) profile"; leaf profile-name { type string; description "OTSI profile name"; } uses otsi-grp; } } } grouping common-session-parms { description "Common session parameters to identify a management session."; leaf username { type org-openroadm-user-mgmt:username-type; mandatory true; description "Name of the user for the session."; } leaf session-id { type ietf-nc:session-id-or-zero-type; mandatory true; description "Identifier of the session. A NETCONF session MUST be identified by a non-zero value. A non-NETCONF session MAY be identified by the value zero."; } leaf source-host { type ietf-inet-types:ip-address; description "Address of the remote host for the session."; } } grouping changed-by-parms { description "Common parameters to identify the source of a change event, such as a configuration or capability change."; container changed-by { description "Indicates the source of the change. If caused by internal action, then the empty leaf 'server' will be present. If caused by a management session, then the name, remote host address, and session ID of the session that made the change will be reported."; choice server-or-user { leaf server { type empty; description "If present, the change was caused by the server."; } case by-user { uses common-session-parms; } } } } rpc led-control { description "This command is used to allow user to find an entity on the NE, The specified entity will have LED blinking. The equipmentLedOn alarm will be raised and cleared for the indication"; input { choice equipment-entity { mandatory true; case shelf { leaf shelf-name { type leafref { path "/org-openroadm-device/shelves/shelf-name"; } mandatory true; description "shelf-name for the operation"; } } case circuit-pack { leaf circuit-pack-name { type leafref { path "/org-openroadm-device/circuit-packs/circuit-pack-name"; } mandatory true; description "circuit-pack-name for the operation"; } } } leaf enabled { type boolean; mandatory true; description "led-control enabled flag. when enabled=true, equipmentLedOn alarm will be raised when enabled=false, equipmentLedOn alarm will be cleared"; } } output { uses org-openroadm-common-types:rpc-response-status; } } rpc create-tech-info { description "Collects all log data for debugging and place it in a location accessible via ftp/sftp. This model assumes ASYNC operation, i.e. the command will return after the device accepts the command, A create-tech-info-notification will be send out later for the result of the operation. The log-file is cleared at the start of every create-tech-info operation in order to ensure the up-to-date logs are collected. If a vendor does not support concurrent log collection, the second create-tech-info command will be rejected."; input { leaf shelf-id { type leafref { path "/org-openroadm-device/shelves/shelf-name"; } description "This optional field is used to specify the shelf for log collection. When this filed is not provided, it is expected to collect logs for the whole node. Vendor should reject the command if the whole node log collection is not supported."; } leaf log-option { type string; description "The log type a vendor can specify. Maybe used in future"; } } output { uses create-tech-info-group; uses org-openroadm-common-types:rpc-response-status; } } rpc get-connection-port-trail { input { leaf connection-name { type string; mandatory true; } } output { uses org-openroadm-common-types:rpc-response-status; list ports { uses org-openroadm-device-types:physical-location; uses port-name { refine "circuit-pack-name" { mandatory true; } refine "port-name" { mandatory true; } } uses org-openroadm-port-types:port-features { refine "is-physical" { mandatory true; } refine "pm-capable" { mandatory true; } refine "alarm-capable" { mandatory true; } } } } } rpc get-connection-port-trail-optical-pm { input { leaf connection-name { type string; mandatory true; } } output { uses org-openroadm-common-types:rpc-response-status; list port { key "circuit-pack-name port-name"; uses port-name { refine "circuit-pack-name" { mandatory true; } refine "port-name" { mandatory true; } } leaf is-physical { type boolean; mandatory true; description "Indicates if the port is a physical port or logical port (internal channel monitor port)"; } leaf is-aggregate-or-channel { type enumeration { enum aggregate { value 1; description "Total aggregate power"; } enum channel { value 2; description "Individual channel power"; } } mandatory true; description "Indicates if the port represents a total aggregate power or an individual channel power."; } leaf pm-retrieval-time { type ietf-yang-types:date-and-time; mandatory true; description "Represents the time when the data is being read, not the bin start or end time."; } list pm-data { uses current-pm-val-group; } } list interface { key "interface-name"; uses interface-name { refine "interface-name" { mandatory true; } } leaf type { type identityref { base org-openroadm-interfaces:interface-type; } mandatory true; description "The type of the interface."; } leaf pm-retrieval-time { type ietf-yang-types:date-and-time; mandatory true; description "Represents the time when the data is being read, not the bin start or end time."; } list pm-data { uses current-pm-val-group; } description "List of the interfaces this port supports. This is a list of names of instances in the flat instance list. Implementations must provide the list of interfaces for port that has interfaces provisioned on that port."; } } } grouping current-pm-val-group { uses org-openroadm-pm-types:pm-names; leaf location { type org-openroadm-common-alarm-pm-types:location; mandatory true; } leaf direction { type org-openroadm-common-alarm-pm-types:direction; mandatory true; } uses org-openroadm-pm-types:pm-measurement; leaf start-time { type ietf-yang-types:date-and-time; mandatory true; description "Represents the start time of the bin (15m, 24h granularity) or the start of data collection (notApplicable/untimed granularity)."; } } rpc disable-automatic-shutoff { input { choice degree-or-amp { mandatory true; description "The choice describes the option to specify the entity for the disable-automatic-shutoff RPC. It can be degree-number for rdm and amp-number for ila"; case degree { leaf degree-number { type leafref { path "/org-openroadm-device/degree/degree-number"; } mandatory true; description "The degree-number defined in degree"; } } case amp { leaf amp-number { type leafref { path "/org-openroadm-device/line-amplifier/amp-number"; } mandatory true; description "The amp-number defined in line-amplifier"; } } } leaf support-timer { type uint16 { range "1..600"; } default "20"; } } output { uses org-openroadm-common-types:rpc-response-status; } } rpc start-scan { input { choice degree-or-amp { mandatory true; description "The choice describes the option to specify the entity for the start-scan RPC. It can be degree-number for rdm and amp-number for ila"; case degree { leaf degree-number { type leafref { path "/org-openroadm-device/degree/degree-number"; } mandatory true; description "The degree-number defined in degree"; } } case amp { leaf amp-number { type leafref { path "/org-openroadm-device/line-amplifier/amp-number"; } mandatory true; description "The amp-number defined in line-amplifier"; } } } leaf port-direction { type org-openroadm-common-alarm-pm-types:direction; } leaf distance { type decimal64 { fraction-digits 2; } description "Units are in meters (m)"; } leaf resolution { type decimal64 { fraction-digits 2; } description "Units for (sampling) resolution are in meters (m)"; } } output { uses org-openroadm-common-types:rpc-response-status; } } rpc set-current-datetime { description "Set the info/current-datetime leaf to the specified value."; input { leaf current-datetime { type ietf-yang-types:date-and-time; mandatory true; description "The current system date and time in UTC. Format: YYYY-MM-DDTHH:MM:SS"; } } output { uses org-openroadm-common-types:rpc-response-status; } } rpc clear-recovery-mode { if-feature recovery-mode-support; description "Upon receiving this RPC, the device push the current configuration datastore contents to the hardware, exits the traffic preservation mode immediately, and sets the recovery-mode attribute to FALSE."; output { uses org-openroadm-common-types:rpc-response-status; } } notification create-tech-info-notification { description "This Notification is sent when the create-tech-info is complete or failed."; uses create-tech-info-group; uses org-openroadm-common-types:rpc-response-status; } notification otdr-scan-result { description "This Notification is sent when the otdr-scan-result is complete or failed."; uses org-openroadm-common-types:rpc-response-status; leaf result-file { type string; } } notification change-notification { description "The Notification that a resource has been added, modified or removed. This notification can be triggered by changes in configuration and operational data. It shall contain the changed field pointed by the xpath. Typically it is not intended for frequently changing volatile data e.g. PM, power levels"; leaf change-time { type ietf-yang-types:date-and-time; description "The time the change occurs."; } uses changed-by-parms; leaf datastore { type enumeration { enum running { description "The datastore has changed."; } enum startup { description "The datastore has changed"; } } default "running"; description "Indicates which configuration datastore has changed."; } list edit { description "An edit (change) record SHOULD be present for each distinct edit operation that the server has detected on the target datastore. This list MAY be omitted if the detailed edit operations are not known. The server MAY report entries in this list for changes not made by a NETCONF session."; leaf target { type instance-identifier; description "Top most node associated with the configuration or operational change. A server SHOULD set this object to the node within the datastore that is being altered. A server MAY set this object to one of the ancestors of the actual node that was changed, or omit this object, if the exact node is not known."; } leaf operation { type ietf-nc:edit-operation-type; description "Type of edit operation performed. A server MUST set this object to the NETCONF edit operation performed on the target datastore."; } } } uses org-openroadm-device-container; }