Internet Engineering Task Force G. Galimberti, Ed. Internet-Draft Cisco Intended status: Experimental R. Kunze Expires: January 12, 2023 A. Burk Deutsche Telekom D. Hiremagalur, Ed. G. Grammel, Ed. Juniper July 11, 2022 A YANG model to manage the optical interface parameters for an external transponder in a WDM network draft-ietf-ccamp-dwdm-if-param-yang-07 Abstract This memo defines a Yang model related to the Optical Transceiver parameters characterising coherent 100G and above interfaces. 100G and above Transceivers support coherent modulation, multiple modulation formats, multiple FEC codes including some not yet specified (or by in phase of specification by) ITU-T G.698.2 [ITU.G698.2] or any other ITU-T recommendation. Use cases are described in RFC7698. The Yang model defined in this memo can be used for Optical Parameters monitoring and/or configuration of the endpoints of a multi-vendor IaDI optical link. The use of this model does not guarantee interworking of transceivers over a DWDM. Optical path feasibility and interoperability has to be determined by tools and algorithms outside the scope of this document. The purpose of this model is to program interface parameters to consistently configure the mode of operation of transceivers. Copyright Notice Copyright (c) 2014 IETF Trust and the persons identified as the document authors. All rights reserved. Status of This Memo This Internet-Draft is submitted in full conformance with the provisions of BCP 78 and BCP 79. Internet-Drafts are working documents of the Internet Engineering Task Force (IETF). Note that other groups may also distribute working documents as Internet-Drafts. The list of current Internet- Drafts is at https://datatracker.ietf.org/drafts/current/. G. Galimberti, et al. Expires January 12, 2023 [Page 1] Internet-Draft draft-ietf-ccamp-dwdm-if-param-yang-07 July 2022 Internet-Drafts are draft documents valid for a maximum of six months and may be updated, replaced, or obsoleted by other documents at any time. It is inappropriate to use Internet-Drafts as reference material or to cite them other than as "work in progress." This Internet-Draft will expire on January 12, 2023. Copyright Notice Copyright (c) 2022 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 (https://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. Table of Contents 1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . 3 2. The Internet-Standard Management Framework . . . . . . . . . 3 3. Conventions . . . . . . . . . . . . . . . . . . . . . . . . . 4 4. Overview . . . . . . . . . . . . . . . . . . . . . . . . . . 4 4.1. Optical Parameters Description . . . . . . . . . . . . . 5 4.1.1. Parameters at Ss . . . . . . . . . . . . . . . . . . 5 4.1.2. Interface at point Rs . . . . . . . . . . . . . . . . 5 4.2. Use Cases . . . . . . . . . . . . . . . . . . . . . . . . 5 4.3. Optical Interface for external transponder in a WDM network . . . . . . . . . . . . . . . . . . . . . . . . . 5 5. Structure of the Yang Module . . . . . . . . . . . . . . . . 9 6. Yang Module . . . . . . . . . . . . . . . . . . . . . . . . . 9 7. Security Considerations . . . . . . . . . . . . . . . . . . . 23 8. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 23 9. Acknowledgements . . . . . . . . . . . . . . . . . . . . . . 23 10. Contributors . . . . . . . . . . . . . . . . . . . . . . . . 23 11. References . . . . . . . . . . . . . . . . . . . . . . . . . 25 11.1. Normative References . . . . . . . . . . . . . . . . . . 25 11.2. Informative References . . . . . . . . . . . . . . . . . 27 Appendix A. Change Log . . . . . . . . . . . . . . . . . . . . . 27 Appendix B. Open Issues . . . . . . . . . . . . . . . . . . . . 27 Appendix C. Applicability examples . . . . . . . . . . . . . . . 27 Authors' Addresses . . . . . . . . . . . . . . . . . . . . . . . 28 G. Galimberti, et al. Expires January 12, 2023 [Page 2] Internet-Draft draft-ietf-ccamp-dwdm-if-param-yang-07 July 2022 1. Introduction This memo defines a Yang model that translates and obsolete the SNMP mib module defined in draft-galikunze-ccamp-dwdm-if-snmp-mib for managing single channel optical interface parameters of DWDM applications, using the approach specified in G.698.2. This model supports parameters to characterize coherent transceivers found in current implementations to specify the mode of operation. As application identifiers like those specified in ITU-T G.874 [ITU.G874] ITU-T G.698.2 [ITU.G698.2] may not be available we use mode templates instead. A mode template describes transceiver characteristics in detail and can be identified by a mode-id. This draft refers and supports the RFC7698. The YANG model describing and extending the optical parameters allows different vendors and operators to retrieve, provision and exchange information across the multi-vendor IaDI interfaces in an abstract manner. The concept introduced by this YANG model is the notion of a mode. A mode is a combination of parameters or parameter ranges that is supported by a transceiver. As an example, operating a device in QPSK mode may use a different FEC and requires less OSNR to reach the FEC limit than the same transceiver operating in QAM16 mode. Given the number of parameters and their possible combinations it is important for vendors to be able to qualify a set of combinations which is the basis to define a mode. The YANG model furthermore provides means to select one mode as current-mode from that pre- defined list of modes supported by the transceiver module. Once selected, current-opt-if-och-mode-params provide the means to configure specific parameters at run time and retrieve actual parameters from the module. For example, the frequency is a parameter that can be set within min/max boundaries set by the current mode. Laser Temperature however is a ro parameter available at run-time that can be checked against the mode boundaries and may trigger an event. 2. The Internet-Standard Management Framework For a detailed overview of the documents that describe the current Internet-Standard Management Framework, please refer to section 7 of RFC 3410 [RFC3410]. This memo specifies a Yang model for optical interfaces. G. Galimberti, et al. Expires January 12, 2023 [Page 3] Internet-Draft draft-ietf-ccamp-dwdm-if-param-yang-07 July 2022 3. Conventions The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this document are to be interpreted as described in RFC 2119 [RFC2119] In the description of OIDs the convention: Set (S) Get (G) and Trap (T) conventions will describe the action allowed by the parameter. 4. Overview Figure 1 shows a set of reference points, for single-channel connection between transmitters (Tx) and receivers (Rx). Here the DWDM network elements include an OM (Optical Multiplexer) and an OD (Optical Demultiplexer) which are used as a pair with the opposing element, one or more optical amplifiers and may also include one or more OADMs. Ss +-------------------------------------------------+ Rs | | DWDM Network Elements | | +---+ | | | \ / | | | +---+ Tx L1---|->| \ +------+ +------+ / |--|-->Rx L1 +---+ | | | | | +------+ | | | | | +---+ +---+ | | | | | | | | | | | | +---+ Tx L2---|->| OM |-->|------|->|ROADM |--|------|->| OD |--|-->Rx L2 +---+ | | | | | | | | | | | | +---+ +---+ | | | | | +------+ | | | | | +---+ Tx L3---|->| / | DWDM | | ^ | DWDM | \ |--|-->Rx L3 +---+ | | / | Link +----|--|----+ Link | \ | | +---+ +-----------+ | | +----------+ +--+ +--+ | | Rs v | Ss +-----+ +-----+ |RxLx | |TxLx | +-----+ +-----+ Ss = reference point at the DWDM network element tributary output Rs = reference point at the DWDM network element tributary input Lx = Lambda x OM = Optical Mux OD = Optical Demux ROADM = Reconfigurable Optical Add Drop Mux from Fig. 5.1/G.698.2 Figure 1: External transponder in WDM netwoks G. Galimberti, et al. Expires January 12, 2023 [Page 4] Internet-Draft draft-ietf-ccamp-dwdm-if-param-yang-07 July 2022 4.1. Optical Parameters Description The link between the external transponders through a WDM network media channels are managed at the edges, i.e. at the transmitters (Tx) and receivers (Rx) attached to the S and R reference points respectively. Definitions of the optical parameters are provided below to increase the readability of the document. 4.1.1. Parameters at Ss output-power: The mean launched power at Ss is the average power (in dBm) of a pseudo-random data sequence coupled into the DWDM link. central frequency: This parameter indicates the Central frequency value that Ss and Rs will be set to work (in THz) 4.1.2. Interface at point Rs input-power: The average received power (in dBm) at point Rs. Curr-OSNR: Current Optical Signal to Noise Ratio (OSNR) estimated at Rx Transceiver port. Curr-q-factor: "Q" factor estimated at Rx Transceiver port. 4.2. Use Cases The use cases are described in draft-ietf-ccamp-dwdm-if-mng-ctrl-fwk 4.3. Optical Interface for external transponder in a WDM network The ietf-ext-xponder-wdm-if is an augment to the ietf-interface. It allows the user to set the operating mode of transceivers as well as other operational parameters. The module provides also treshold settings and notifications to supervise measured parameters and notify the client. module: ietf-ext-xponder-wdm-if augment /if:interfaces/if:interface: +--rw optIfOChRsSs +--ro if-current-mode G. Galimberti, et al. Expires January 12, 2023 [Page 5] Internet-Draft draft-ietf-ccamp-dwdm-if-param-yang-07 July 2022 | +--ro mode-id? string | +--ro (mode) | +--:(G.698.2) | | +--ro standard-mode? standard-mode | | +--ro application-code | +--:(organizational-mode) | | +--ro organizational-mode | | +--ro operational-mode? | | | operational-mode | | +--ro organization-identifier? | | | organization-identifier | | +--ro part-number-identifier? | | | part-number-identifier | | +--ro fec-info? string | | +--ro modulation-format? string | | +--ro baud-rate? uint32 | +--:(explicit-mode) | +--ro explicit-mode | +--ro supported-modes | | +--ro supported-application-codes* | | | -> ../../../mode-id | | +--ro supported-organizational-modes* | | | -> ../../../mode-id | +--ro line-coding-bitrate? | | identityref | +--ro min-central-frequency? | | layer0-types:frequency-thz | +--ro max-central-frequency? | | layer0-types:frequency-thz | +--ro min-channel-input-power? dbm-t | +--ro max-channel-input-power? dbm-t | +--ro min-channel-output-power? dbm-t | +--ro max-channel-output-power? dbm-t | +--ro osnr-margin? int32 | +--ro q-margin? int32 | +--ro fec-info? string | +--ro fec-bitrate? string | +--ro fec-gain? string | +--ro pre-fec-ber-mantissa-threshold? uint32 | +--ro pre-fec-ber-exponent-threshold? int32 | +--ro number-of-lanes? uint32 | +--ro min-laser-temperature? int32 | +--ro max-laser-temperature? int32 | +--ro max-total-rx-optical-power? dbm-t | +--ro chromatic-and-polariz-disp-penal* [] | | +--ro chromatic-dispersion | | | decimal64 | | +--ro polarization-mode-dispersion G. Galimberti, et al. Expires January 12, 2023 [Page 6] Internet-Draft draft-ietf-ccamp-dwdm-if-param-yang-07 July 2022 | | | decimal64 | | +--ro penalty | | decimal64 | +--ro max-chromatic-dispersion? int32 | +--ro max-diff-group-delay? int32 | +--ro max-polarization-dependent-loss? | | decimal64 | +--ro modulation-format? string | +--ro baud-rate? uint32 | +--ro bits-per-symbol? uint32 | +--ro num-symbols-in-alphabet? uint32 | +--ro symbols-index? uint32 +--ro if-supported-mode | +--ro number-of-modes-supported? uint32 +--rw if-supported-modes* | | +--ro mode-id? string | +--ro (mode) | +--:(G.698.2) | | +--ro standard-mode? standard-mode | +--:(organizational-mode) | | +--ro organizational-mode | | +--ro operational-mode? | | | operational-mode | | +--ro organization-identifier? | | | organization-identifier string | | +--ro part-number-identifier? | | | part-number-identifier string | | +--ro fec-info? string | | +--ro modulation-format? string | | +--ro baud-rate? uint32 | +--:(explicit-mode) | +--ro explicit-mode | +--ro supported-modes | | +--ro supported-application-codes* | | | -> ../../../mode-id | | +--ro supported-organizational-modes* | | | -> ../../../mode-id | +--ro line-coding-bitrate? | | | identityref | +--ro min-central-frequency? | | | layer0-types:frequency-thz | +--ro max-central-frequency? | | | layer0-types:frequency-thz | +--ro min-channel-input-power? dbm-t | +--ro max-channel-input-power? dbm-t | +--ro min-channel-output-power? dbm-t | +--ro max-channel-output-power? dbm-t | +--ro osnr-margin? int32 G. Galimberti, et al. Expires January 12, 2023 [Page 7] Internet-Draft draft-ietf-ccamp-dwdm-if-param-yang-07 July 2022 | +--ro q-margin? int32 | +--ro fec-info? string | +--ro fec-bitrate? string | +--ro fec-gain? string | +--ro pre-fec-ber-mantissa-threshold? uint32 | +--ro pre-fec-ber-exponent-threshold? int32 | +--ro number-of-lanes? uint32 | +--ro min-laser-temperature? int32 | +--ro max-laser-temperature? int32 | +--ro max-total-rx-optical-power? dbm-t | +--ro chromatic-and-polariz-disp-penal* [] | | +--ro chromatic-dispersion | | | decimal64 | | +--ro polarization-mode-dispersion | | | decimal64 | | +--ro penalty | | | decimal64 | +--ro max-chromatic-dispersion? int32 | +--ro max-diff-group-delay? int32 | +--ro max-polarization-dependent-loss? | | decimal64 | +--ro modulation-format? string | +--ro baud-rate? uint32 | +--ro bits-per-symbol? uint32 | +--ro num-symbols-in-alphabet? uint32 | +--ro symbols-index? uint32 +--rw provisioning-opt-if-och-mode-params +--rw provisioning-opt-if-och-mode-params +--rw mode-id? string +--rw (mode) +--rw central-frequency? | layer0-types:frequency-thz +--rw channel-output-power? dbm-t +--ro channel-input-power? dbm-t +--ro total-input-power? dbm-t +--rw number-of-tcas-supported? uint32 +--rw mode-list* [tca-type] | +--rw tca-type opt-if-och-tca-types | +--rw min-threshold? int32 | +--rw max-threshold? int32 +--ro cur-osnr? int32 +--ro cur-q-factor? int32 +--ro uncorrected-words? uint64 +--ro pre-fec-ber-mantissa? uint32 +--ro pre-fec-ber-exponent? int32 +--ro cd-pmd-penalty | layer0-types:cd-pmd-penalty +--ro pdl-penalty G. Galimberti, et al. Expires January 12, 2023 [Page 8] Internet-Draft draft-ietf-ccamp-dwdm-if-param-yang-07 July 2022 | layer0-types:pdl-penalty +--ro diff-group-delay int32 +--rw explicit-mode-provisioning +--rw fec string +--rw pre-fec-ber-mantissa-threshold? uint32 +--rw pre-fec-ber-exponent-threshold? int32 +--rw number-of-lanes? uint32 +--rw modulation-format? string +--rw baud-rate? uint32 +--rw bits-per-symbol? uint32 +--rw num-symbols-in-alphabet? uint32 +--rw symbols-index? uint32 notifications: +---n opt-if-och-central-frequency-change | +--ro if-name? -> /if:interfaces/interface/name | +--ro new-opt-if-och-central-frequency | +--ro central-frequency? layer0-types:frequency-thz +---n opt-if-och-mode-change | +--ro if-name? -> /if:interfaces/interface/name | +--ro mode-id? string +---n opt-if-och-min-tca +--ro if-name? -> /if:interfaces/interface/name +--ro tca-type? opt-if-och-tca-types 5. Structure of the Yang Module ietf-ext-xponder-wdm-if is a top level model for the support of this feature. 6. Yang Module The ietf-ext-xponder-wdm-if is defined as an extension to ietf interfaces. file "ietf-ext-xponder-wdm-if.yang" module ietf-ext-xponder-wdm-if { namespace "urn:ietf:params:xml:ns:yang:ietf-ext-xponder-wdm-if"; prefix ietf-ext-xponder-wdm-if; import ietf-interfaces { prefix if; } G. Galimberti, et al. Expires January 12, 2023 [Page 9] Internet-Draft draft-ietf-ccamp-dwdm-if-param-yang-07 July 2022 import ietf-layer0-types { prefix "l0-types"; } import ietf-layer0-types-ext { prefix "l0-types-ext"; } organization "IETF CCAMP Working Group"; contact "WG Web: WG List: Editor: Dharini Hiremagalur "; description "This module contains a collection of YANG definitions for configuring Optical interfaces. Copyright (c) 2016 IETF Trust and the persons identified as authors of the code. All rights reserved. Redistribution and use in source and binary forms, with or without modification, is permitted pursuant to, and subject to the license terms contained in, the Simplified BSD License set forth in Section 4.c of the IETF Trust's Legal Provisions Relating to IETF Documents (http://trustee.ietf.org/license-info)."; revision "2022-01-10" { description "Revision 1.7"; reference ""; } revision "2021-06-28" { description "Revision 1.6"; reference ""; } G. Galimberti, et al. Expires January 12, 2023 [Page 10] Internet-Draft draft-ietf-ccamp-dwdm-if-param-yang-07 July 2022 revision "2020-03-09" { description "Revision 1.5"; reference ""; } revision "2019-11-04" { description "Revision 1.4"; reference ""; } revision "2019-07-08" { description "Revision 1.3"; reference ""; } revision "2018-10-22" { description "Revision 1.2"; reference ""; } revision "2018-03-06" { description "Revision 1.1"; reference ""; } revision "2017-03-06" { description "Revision 1.0"; reference ""; } revision "2016-03-17" { description "Initial revision."; reference ""; } G. Galimberti, et al. Expires January 12, 2023 [Page 11] Internet-Draft draft-ietf-ccamp-dwdm-if-param-yang-07 July 2022 typedef opt-if-och-tca-types { type enumeration { enum max-laser-linewdt { description "The maximum laser linewidth"; } enum min-tx-power-tca { description "The min tx power TCA"; } enum max-tx-power-tca { description "The min tx power TCA"; } enum min-rx-power-tca{ description "The min tx power TCA"; } enum max-rx-power-tca{ description "The min tx power TCA"; } enum max-pol-power-diff-tca{ description "The power difference between polarization TCA"; } enum max-pol-skew-diff-tca{ description "The skew between the two polarization TCA"; } enum min-frequency-offset-tca{ description "Min Frequency offset TCA"; } enum max-frequency-offset-tca{ description "Max Frequency offset TCA"; } enum min-osnr-tca{ description "Min OSNR TCA"; } enum max-osnr-tca{ description "Max OSNR TCA"; } enum min-laser-temperature-tca{ description "The min tx power TCA"; } enum max-laser-temperature-tca{ description "Temperature TCA"; } enum min-fec-ber-tca{ description "Min Pre Fec BER TCA"; } enum max-fec-ber-tca{ description "Max Pre Fec BER TCA"; } G. Galimberti, et al. Expires January 12, 2023 [Page 12] Internet-Draft draft-ietf-ccamp-dwdm-if-param-yang-07 July 2022 enum min-q-tca{ description "Min Q TCA"; } enum max-q-tca { description "Max Q TCA"; } } description "The different types of TCA's"; } grouping opt-if-och-power { description "Interface optical Power"; leaf channel-output-power { type dbm-t; description "The output power for this interface in .01 dBm. The setting of the output power is optional"; } leaf channel-input-power { type dbm-t; config false; description "The current channel input power of this interface"; } leaf total-input-power { type dbm-t; config false; description "The total input power of this interface"; } } grouping opt-if-och-tca-thresholds { description "Thresholds for TCA's"; leaf tca-type { type opt-if-och-tca-types; description "type of the TCA eg TX Power"; } leaf min-threshold { type int32; description "A TCA is generated if the variable is less than this value"; } leaf max-threshold { type int32; description "A TCA is generated if the variable is more than this value"; G. Galimberti, et al. Expires January 12, 2023 [Page 13] Internet-Draft draft-ietf-ccamp-dwdm-if-param-yang-07 July 2022 } } grouping opt-if-och-fec { description "FEC info"; leaf fec-info { type string { length "1..255"; } config false; description "FEC Type - eg GFEC"; } leaf fec-bitrate { type string { length "1..255"; } config false; description "FEC Overhead rate "; } leaf fec-gain { type string { length "1..255"; } config false; description "FEC Overhead rate "; } leaf pre-fec-ber-mantissa-threshold { type uint32; description "Mantissa of the FEC BER threshold"; } leaf pre-fec-ber-exponent-threshold { type int32; description "Exponent of the FEC BER threshold"; } } grouping opt-if-och-central-frequency { description "Interface Central Frequency"; leaf central-frequency { type layer0-types:frequency-thz; description "This parameter indicates the frequency of this interface "; } } grouping opt-if-och-modulation-params { description "Optical modulation parameters for the lane"; leaf modulation-format { type string { length "1..255"; } config false; description "Modulation format for this mode"; } G. Galimberti, et al. Expires January 12, 2023 [Page 14] Internet-Draft draft-ietf-ccamp-dwdm-if-param-yang-07 July 2022 leaf baud-rate { type uint32; description "Baud-rate or symbol rate"; } leaf bits-per-symbol { type uint32; description "This parameter the bits per symbol for this mode"; } leaf num-symbols-in-alphabet { type uint32; description "This parameter the bits per symbol for this mode"; } leaf symbols-index { type uint32; description "This parameter is the symbol index this mode"; } } grouping opt-if-och-lane-param { description "Optical parameters for the lane"; leaf number-of-lanes { type uint32; config false; description "Number of optical lanes of this interface"; } leaf min-laser-temperature { type int32; units ".01C"; config false; description "Minimum Laser Temperature of this mode for this lane"; } leaf max-laser-temperature { type int32; units ".01C"; config false; description "Maximum Laser Temperature of this mode for this lane"; } leaf max-total-rx-optical-power { type dbm-t; config false; description "Maximum rx optical power of this mode for this lane"; } G. Galimberti, et al. Expires January 12, 2023 [Page 15] Internet-Draft draft-ietf-ccamp-dwdm-if-param-yang-07 July 2022 leaf max-chromatic-dispersion { type int32; config false; description "Maximum chromatic dispersion of this mode for this lane"; } leaf max-diff-group-delay { type int32; config false; description "Maximum Differential group delay of this mode for this lane"; } leaf max-polarization-dependent-loss{ type decimal64; config false; description "Maximum max loss between the two carrier polarizations"; } uses opt-if-och-modulation-params; } grouping chromatic-and-polariz-disp-penal { description "list of chromatic dispersion and polarization dispersion penalties"; list cd-and-pmd-penalties {} key "penalties" description "list of CD and PMD penalties" } leaf chromatic-dispersion { type decimal64; config false; description "Chromatic Dispersion of this mode for this lane"; } leaf polarization-mode-dispersion { type decimal64; config false; description "Polarization Mode Dispersion"; } leaf penalty { type decimal64; config false; description "penalty given by CD and PMD"; } } grouping opt-if-och-tca-list { description "List of TCA's"; G. Galimberti, et al. Expires January 12, 2023 [Page 16] Internet-Draft draft-ietf-ccamp-dwdm-if-param-yang-07 July 2022 leaf number-of-tcas-supported { type uint32; description "Number of TCAs supported by this interface"; } list mode-list { key "tca-type"; description "List of the TCAs"; uses opt-if-och-tca-thresholds; } } grouping opt-if-och-fec-tca-thresholds { description "Pre FEC BER Thresholds for TCA's"; leaf min-fec-ber-mantissa-threshold { type uint32; description "Min Mantissa of the FEC BER threshold"; } leaf min-fec-ber-exponent-threshold { type int32; description "Min Exponent of the FEC BER threshold"; } leaf max-fec-ber-mantissa-threshold { type uint32; description "Max Mantissa of the FEC BER threshold"; } leaf max-fec-ber-exponent-threshold { type int32; description "Max Exponent of the FEC BER threshold"; } } grouping opt-if-och-mode-params { description "OCh mode parameters"; leaf mode-id { type string { length "1..255"; } description "ID for the OCh mode template"; } leaf min-osnr-margin { type int32; units "dB"; config false; description "OSNR margin to FEC threshold"; } leaf q-margin { type int32; units "dB"; config false; description "Q-Factor margin to FEC threshold"; G. Galimberti, et al. Expires January 12, 2023 [Page 17] Internet-Draft draft-ietf-ccamp-dwdm-if-param-yang-07 July 2022 } uses opt-if-och-central-frequency; uses opt-if-och-power; uses opt-if-och-fec-tca-thresholds; uses opt-if-och-tca-list; } grouping opt-if-och-statistics { description "OCh statistics"; leaf cur-osnr { type int32; units "dB"; config false; description "OSNR margin to FEC threshold"; } leaf cur-q-factor { type int32; units "dB"; config false; description "Q-Factor of the interface"; } leaf uncorrected-words { type uint64; config false; description "Post-FEC errored words"; } leaf pre-fec-ber-mantissa { type uint32; config false; description "Pre-FEC errored words mantissa"; } leaf pre-fec-ber-exponent { type int32; config false; description "Pre-FEC errored words exponent"; } } grouping opt-if-och-mode { description "OCh mode template"; leaf mode-id { type string { length "1..255"; } config false; description "ID for the OCh mode template"; } leaf (G.698.2) { type strings; G. Galimberti, et al. Expires January 12, 2023 [Page 18] Internet-Draft draft-ietf-ccamp-dwdm-if-param-yang-07 July 2022 config false; description "This parameter indicates the application identifier according to G.698.2"; uses standard-mode; } leaf (organizational-mode) { type strings; config false; description "This parameter indicates the operational-mode of different organization"; uses organizational-modes; } leaf (explicit-mode) { type strings; config false; description "This parameter indicates the operational-mode of different organization"; uses explicit-modes; } grouping standard-mode { description "ITU-T G.698.2 application codes"; leaf application-code { type string; description "ITU-T G.698.2 application code e.g. DScW-ytz(v)"; } } grouping organizational-modes { description "this identifies the vendor or organization operational mode including the Organization Unique Identifier, the i/f part number"; leaf operational-mode { type string; description "this string is defined by the oprganization or the vendor"; } leaf organization-identifier { type string; description "this string identified the OUI of the vendor or the organization"; G. Galimberti, et al. Expires January 12, 2023 [Page 19] Internet-Draft draft-ietf-ccamp-dwdm-if-param-yang-07 July 2022 } leaf part-number-identifier { type string; description "this string identified the optical interfaces part number or name given by the vendor or the organization"; } | | +--ro fec-info? string | | +--ro modulation-format? string | | +--ro baud-rate? uint32 } grouping explicit-modes { description "interface explicit-modes"; leaf min-central-frequency { type layer0-types:frequency-thz; config false; description "his parameter indicates the minimum frequency for this template"; } leaf max-central-frequency { type layer0-types:frequency-thz; config false; description "This parameter indicates the minimum frequency for this template"; } leaf min-channel-input-power { type dbm-t; config false; description "The minimum input power of this interface"; } leaf max-channel-input-power { type dbm-t; config false; description "The maximum input power of this interface"; } leaf min-channel-output-power { type dbm-t; config false; description "The minimum output power of this interface"; } G. Galimberti, et al. Expires January 12, 2023 [Page 20] Internet-Draft draft-ietf-ccamp-dwdm-if-param-yang-07 July 2022 leaf max-channel-output-power { type dbm-t; config false; description "The maximum output power of this interface"; } leaf osnr-margin { type int32; units "dB"; config false; description "OSNR margin to FEC threshold"; } leaf q-margin { type int32; units "dB"; config false; description "Q-Factor margin to FEC threshold"; } uses standard-mode; uses organizational-modes; uses opt-if-och-fec; uses opt-if-och-lane-param; } grouping opt-if-och-mode-list { description "List of Mode list group"; leaf number-of-modes-supported { type uint32; description "Number of modes supported by this interface"; } list mode-list { key "mode-id"; description "List of the modes"; uses opt-if-och-mode; } } notification opt-if-och-central-frequency-change { description "A change of Central Frequency has been detected"; leaf "if-name" { type leafref { path "/if:interfaces/if:interface/if:name"; } description "Interface name"; } container new-opt-if-och-central-frequency { description "The new Central Frequency of the interface"; uses opt-if-och-central-frequency; } G. Galimberti, et al. Expires January 12, 2023 [Page 21] Internet-Draft draft-ietf-ccamp-dwdm-if-param-yang-07 July 2022 } notification opt-if-och-mode-change { description "A change of Mode Template has been detected"; leaf "if-name" { type leafref { path "/if:interfaces/if:interface/if:name"; } description "Interface name"; } leaf mode-id { type string { length "1..255"; } description "ID for the OCh mode template"; } } notification opt-if-och-min-tca { description "A min output TCA notification"; leaf "if-name" { type leafref { path "/if:interfaces/if:interface/if:name"; } description "Interface name"; } leaf tca-type { type opt-if-och-tca-types; description "Type of TCA for eg min tx power TCA"; } } augment "/if:interfaces/if:interface" { description "Parameters for an optical interface"; container optIfOChRsSs { description "RsSs path configuration for an interface"; container if-current-mode { description "Current mode template of the interface"; uses opt-if-och-mode; } container if-supported-mode { config false; description "Supported mode list of this interface"; uses opt-if-och-mode-list; } container current-opt-if-och-mode-params { description "Current parameters of this interface"; uses opt-if-och-mode-params; uses opt-if-och-statistics; } G. Galimberti, et al. Expires January 12, 2023 [Page 22] Internet-Draft draft-ietf-ccamp-dwdm-if-param-yang-07 July 2022 } } } 7. Security Considerations The YANG module defined in this memo is designed to be accessed via the NETCONF protocol [RFC6241]. he lowest NETCONF layer is the secure transport layer and the mandatory-to-implement secure transport is SSH [RFC6242]. The NETCONF access control model [RFC6536] provides the means to restrict access for particular NETCONF users to a pre- configured subset of all available NETCONF protocol operation and content. 8. IANA Considerations This document registers a URI in the IETF XML registry [RFC3688]. Following the format in [RFC3688], the following registration is requested to be made: URI: urn:ietf:params:xml:ns:yang:ietf-interfaces:ietf-ext-xponder- wdm-if Registrant Contact: The IESG. XML: N/A, the requested URI is an XML namespace. This document registers a YANG module in the YANG Module Names registry [RFC6020]. This document registers a YANG module in the YANG Module Names registry [RFC6020]. prefix: ietf-ext-xponder-wdm-if reference: RFC XXXX 9. Acknowledgements 10. Contributors Dean Bogdanovic Westford U.S.A. email ivandean@gmail.com Bernd Zeuner G. Galimberti, et al. Expires January 12, 2023 [Page 23] Internet-Draft draft-ietf-ccamp-dwdm-if-param-yang-07 July 2022 Deutsche Telekom Darmstadt Germany email B.Zeuner@telekom.de Massimiliano Salsi Juniper Networks 1133 Innovation Way Sunnyvale, CA, 94089 U.S.A. +1 408936847 email msalsi@google.com Arnold Mattheus Deutsche Telekom Darmstadt Germany email a.mattheus@telekom.de Manuel Paul Deutsche Telekom Berlin Germany email Manuel.Paul@telekom.de Walid Wakim Cisco 9501 Technology Blvd ROSEMONT, ILLINOIS 60018 UNITED STATES email wwakim@cisco.com Kam Lam Nokia USA +1 732 331 3476 kam.lam@nokia.com Sergio Belotti Nokia Via Energy Park 20871 Vimercate (MB) Italy Sergio.belotti@nokia.com G. Galimberti, et al. Expires January 12, 2023 [Page 24] Internet-Draft draft-ietf-ccamp-dwdm-if-param-yang-07 July 2022 11. References 11.1. Normative References [ITU.G694.1] International Telecommunications Union, "Spectral grids for WDM applications: DWDM frequency grid", ITU-T Recommendation G.694.1, February 2012. [ITU.G698.2] International Telecommunications Union, "Amplified multichannel dense wavelength division multiplexing applications with single channel optical interfaces", ITU-T Recommendation G.698.2, November 2009. [ITU.G709] International Telecommunications Union, "Interface for the Optical Transport Network (OTN)", ITU-T Recommendation G.709, June 2016. [ITU.G7710] International Telecommunications Union, "Common equipment management function requirements", ITU-T Recommendation G.7710, August 2017. [ITU.G798] International Telecommunications Union, "Characteristics of optical transport network hierarchy equipment functional blocks", ITU-T Recommendation G.798, Devember 2017. [ITU.G8201] International Telecommunications Union, "Error performance parameters and objectives for multi-operator international paths within the Optical Transport Network (OTN)", ITU-T Recommendation G.8201, April 2011. [ITU.G826] International Telecommunications Union, "End-to-end error performance parameters and objectives for international, constant bit-rate digital paths and connections", ITU-T Recommendation G.826, December 2002. [ITU.G872] International Telecommunications Union, "Architecture of optical transport networks", ITU-T Recommendation G.872, January 2017. G. Galimberti, et al. Expires January 12, 2023 [Page 25] Internet-Draft draft-ietf-ccamp-dwdm-if-param-yang-07 July 2022 [ITU.G874] International Telecommunications Union, "Management aspects of optical transport network elements", ITU-T Recommendation G.874, October 2020. [ITU.G874.1] International Telecommunications Union, "Optical transport network (OTN): Protocol-neutral management information model for the network element view", ITU-T Recommendation G.874.1, November 2016. [ITU.G959.1] International Telecommunications Union, "Optical transport network physical layer interfaces", ITU-T Recommendation G.959.1, November 2009. [RFC2119] Bradner, S., "Key words for use in RFCs to Indicate Requirement Levels", BCP 14, RFC 2119, DOI 10.17487/RFC2119, March 1997, . [RFC2578] McCloghrie, K., Ed., Perkins, D., Ed., and J. Schoenwaelder, Ed., "Structure of Management Information Version 2 (SMIv2)", STD 58, RFC 2578, DOI 10.17487/RFC2578, April 1999, . [RFC2579] McCloghrie, K., Ed., Perkins, D., Ed., and J. Schoenwaelder, Ed., "Textual Conventions for SMIv2", STD 58, RFC 2579, DOI 10.17487/RFC2579, April 1999, . [RFC2580] McCloghrie, K., Ed., Perkins, D., Ed., and J. Schoenwaelder, Ed., "Conformance Statements for SMIv2", STD 58, RFC 2580, DOI 10.17487/RFC2580, April 1999, . [RFC2863] McCloghrie, K. and F. Kastenholz, "The Interfaces Group MIB", RFC 2863, DOI 10.17487/RFC2863, June 2000, . [RFC3591] Lam, H-K., Stewart, M., and A. Huynh, "Definitions of Managed Objects for the Optical Interface Type", RFC 3591, DOI 10.17487/RFC3591, September 2003, . G. Galimberti, et al. Expires January 12, 2023 [Page 26] Internet-Draft draft-ietf-ccamp-dwdm-if-param-yang-07 July 2022 [RFC6205] Otani, T., Ed. and D. Li, Ed., "Generalized Labels for Lambda-Switch-Capable (LSC) Label Switching Routers", RFC 6205, DOI 10.17487/RFC6205, March 2011, . 11.2. Informative References [RFC2629] Rose, M., "Writing I-Ds and RFCs using XML", RFC 2629, DOI 10.17487/RFC2629, June 1999, . [RFC3410] Case, J., Mundy, R., Partain, D., and B. Stewart, "Introduction and Applicability Statements for Internet- Standard Management Framework", RFC 3410, DOI 10.17487/RFC3410, December 2002, . [RFC4054] Strand, J., Ed. and A. Chiu, Ed., "Impairments and Other Constraints on Optical Layer Routing", RFC 4054, DOI 10.17487/RFC4054, May 2005, . [RFC4181] Heard, C., Ed., "Guidelines for Authors and Reviewers of MIB Documents", BCP 111, RFC 4181, DOI 10.17487/RFC4181, September 2005, . Appendix A. Change Log This optional section should be removed before the internet draft is submitted to the IESG for publication as an RFC. Note to RFC Editor: please remove this appendix before publication as an RFC. Appendix B. Open Issues Note to RFC Editor: please remove this appendix before publication as an RFC. Appendix C. Applicability examples As an examample here below is the way and OpenROADM compliant equipment could be managed using the Yang models described in thei draft. In OpenROADM MSA there is a limited number of DWDM interfaces supported. Basically only the 100G Staircase FEC and 400G oFEC are G. Galimberti, et al. Expires January 12, 2023 [Page 27] Internet-Draft draft-ietf-ccamp-dwdm-if-param-yang-07 July 2022 supported and these two kind of interfaces can be easily summarized with the "mode-id" and the "application-identifier" strings. the models below are enough to identify the interface and few working parameters: module: ietf-ext-xponder-wdm-if augment /if:interfaces/if:interface: +--rw optIfOChRsSs +--rw if-current-mode | +--ro mode-id? string | +--ro application-identifier? string . . . +--rw current-opt-if-och-mode-params +--rw mode-id? string +--rw central-frequency? frequency-thz +--rw channel-output-power? dbm-t +--ro channel-input-power? dbm-t . . . +--ro cur-osnr? int32 +--ro cur-q-factor? int32 +--ro uncorrected-words? uint64 +--ro pre-fec-ber-mantissa? uint32 +--ro pre-fec-ber-exponent? int32 Authors' Addresses Gabriele Galimberti (editor) Cisco Via Santa Maria Molgora, 48 c 20871 - Vimercate Italy Phone: +390392091462 Email: ggalimbe@cisco.com G. Galimberti, et al. Expires January 12, 2023 [Page 28] Internet-Draft draft-ietf-ccamp-dwdm-if-param-yang-07 July 2022 Ruediger Kunze Deutsche Telekom Winterfeldtstr. 21-27 10781 Berlin Germany Phone: +491702275321 Email: RKunze@telekom.de Andreas Burk Deutsche Telekom Germany Phone: +49 Email: andreas.burk@telekom.de Dharini Hiremagalur (editor) Juniper 1133 Innovation Way Sunnyvale - 94089 California USA Email: dharinih@juniper.net Gert Grammel (editor) Juniper Oskar-Schlemmer Str. 15 80807 Muenchen Germany Phone: +49 1725186386 Email: ggrammel@juniper.net G. Galimberti, et al. Expires January 12, 2023 [Page 29]