Internet Engineering Task Force G. Galimberti, Ed. Internet-Draft Nokia Intended status: Standards Track D. Hiremagalur Expires: 4 January 2027 G. Grammel, Ed. HPE R. Manzotti, Ed. Cisco D. Breuer DEUTSCHE TELEKOM AG 3 July 2026 A YANG data model to manage configurable DWDM optical interfaces draft-ietf-ccamp-dwdm-if-param-yang-16 Abstract This document 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 Forward Error Correction (FEC) codes including some not yet specified (or in phase of specification by) ITU-T G.698.2 or any other ITU-T recommendation. Use cases are described in RFC7698. The YANG model defined in this document can be used for Optical Parameters monitoring and/or configuration of Dense Wavelength Division Multiplexing (DWDM) interfaces. The use of this model does not guarantee interworking of DWDM transceivers. 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. 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/. 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." Galimberti, et al. Expires 4 January 2027 [Page 1] Internet-Draft draft-ietf-ccamp-dwdm-if-param-yang-16 July 2026 This Internet-Draft will expire on 4 January 2027. Copyright Notice Copyright (c) 2026 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 Revised BSD License text as described in Section 4.e of the Trust Legal Provisions and are provided without warranty as described in the Revised BSD License. Table of Contents 1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . 3 1.1. Terminology . . . . . . . . . . . . . . . . . . . . . . . 4 1.2. Tree Diagram . . . . . . . . . . . . . . . . . . . . . . 5 1.3. Prefixes in Data Node Names . . . . . . . . . . . . . . . 5 1.4. Conventions . . . . . . . . . . . . . . . . . . . . . . . 5 2. Module Description . . . . . . . . . . . . . . . . . . . . . 6 2.1. Overview . . . . . . . . . . . . . . . . . . . . . . . . 6 2.2. YANG Module Classification . . . . . . . . . . . . . . . 7 2.3. Optical Parameters Description . . . . . . . . . . . . . 7 2.4. Use Cases . . . . . . . . . . . . . . . . . . . . . . . . 7 3. WDM Interface YANG Module . . . . . . . . . . . . . . . . . . 7 4. Security Considerations . . . . . . . . . . . . . . . . . . . 23 5. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 23 6. Acknowledgements . . . . . . . . . . . . . . . . . . . . . . 24 7. Contributors . . . . . . . . . . . . . . . . . . . . . . . . 24 8. References . . . . . . . . . . . . . . . . . . . . . . . . . 25 8.1. Normative References . . . . . . . . . . . . . . . . . . 25 8.2. Informative References . . . . . . . . . . . . . . . . . 29 Appendix A. YANG Tree . . . . . . . . . . . . . . . . . . . . . 29 Appendix B. Threshold crossing example . . . . . . . . . . . . . 33 Appendix C. Tree description - examples . . . . . . . . . . . . 34 Appendix D. Applicability examples . . . . . . . . . . . . . . . 37 Authors' Addresses . . . . . . . . . . . . . . . . . . . . . . . 40 Galimberti, et al. Expires 4 January 2027 [Page 2] Internet-Draft draft-ietf-ccamp-dwdm-if-param-yang-16 July 2026 1. Introduction This document defines a YANG model for managing single channel optical interface parameters of coherent interfaces supporting Dense Wavelength Division Multiplexing (DWDM) applications, using the approach specified in [ITU-T_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-T_G.874.1], [ITU-T_G.698.2] and [ITU-T_G.959.1] may not always be available, mode templates are used. A mode template describes transceiver characteristics in detail and can be identified by a mode-id. This document refers to [RFC7698] use cases and is aligned to the definition of [RFC9093] and its update in [I-D.ietf-ccamp-rfc9093-bis]. Finally, the models described in here are compliant with the models described in [I-D.ietf-ccamp-optical-impairment-topology-yang] and [I-D.ietf-ccamp-wdm-tunnel-yang]. The key concept introduced by this YANG model in accordance with documents [I-D.ietf-ccamp-optical-impairment-topology-yang] and [I-D.ietf-ccamp-rfc9093-bis] is the notion of a mode. A mode is a combination of parameters and parameter ranges that is supported by a transceiver. As an example, operating a device in Quadrature Phase Shift Keying (QPSK) modulation may use a different FEC and requires less Optical Signal to Noise Ratio (OSNR) than the same transceiver operating in 16 Quadrature Amplitude Modulation (QAM16). 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. As described in [I-D.ietf-ccamp-optical-impairment-topology-yang] and modeled in [I-D.ietf-ccamp-rfc9093-bis], the list of transceiver modes (properly classified in standard, organizational and explicit modes) provide information about the transmission capabilities of an optical DWDM interface. The same approach is used in this RFC to allow the device netconf agent to export such capabilities to the client controllers. To advertise the capability supported by an interface, a list of transceiver modes is provided by the device for each dwdm coherent module (supported-modes). The YANG model provides a configuration attribute named "configured- mode" as a means to provision the working mode of the interface from the supported-modes listed as capabilities. Once provisioned, wdm- if-config container provides the means to configure specific parameters at run time while wdm-if-status container allow to retrieve operational state information from the module as defined in Galimberti, et al. Expires 4 January 2027 [Page 3] Internet-Draft draft-ietf-ccamp-dwdm-if-param-yang-16 July 2026 [ITU-T_G.7710]. For example, the frequency is a parameter that can be set within min/max boundaries defined in the current mode. Laser Temperature, RX/TX optical power, RX OSNR, etc. however are read-only parameters available at run-time that can be checked against the mode boundaries and may trigger events. 1.1. Terminology Refer to [RFC6566], [RFC7698], and [ITU-T_G.807] for the key terms used in this document. The following terms are defined in [RFC7950] * client * server * augment * data model * data node The following terms are defined in [RFC6241] * configuration data * state data The terminology for describing YANG data models is found in [RFC7950]. The term DWDM Network Element refers to a physical device, which is managed as a single network element, that has Dense Wavelength Division Multiplexing capabilities. The term DWDM Link refers to a physical optical link (fiber pair) between two DWDM Network Elements where one or multiple channels are transmitted using Dense Wavelength Division Multiplexing technology. The term DWDM interface refers to an interface, as defined and modelled in [RFC8343], that is capable to generate and receive a signal at a specific wavelength and suitable to be transmitted over a DWDM Link. The term ROADM in this document refers to the term "multi-degree reconfigurable optical add/drop multiplexer (MD-ROADM)" as defined in [ITU-T_G.672]. Galimberti, et al. Expires 4 January 2027 [Page 4] Internet-Draft draft-ietf-ccamp-dwdm-if-param-yang-16 July 2026 1.2. Tree Diagram A simplified graphical representation of the data model is used in the Appendix A of this document. The meaning of the symbols in these diagrams is defined in [RFC8340]. 1.3. Prefixes in Data Node Names In this document, names of data nodes and other data model objects are prefixed using the standard prefix associated with the corresponding YANG imported modules, as shown in Table 1. +========+==============+==========================================+ |Prefix | YANG module | Reference | +========+==============+==========================================+ |wdm-if | ietf-wdm- | [RFCXXXX] | | | interface | | +--------+--------------+------------------------------------------+ |rev | ietf-yang- | [I-D.ietf-netmod-yang-module-versioning] | | | revisions | | +--------+--------------+------------------------------------------+ |if | ietf- | [RFC8343] | | | interfaces | | +--------+--------------+------------------------------------------+ |l0-types| ietf- | [I-D.ietf-ccamp-rfc9093-bis] | | | layer0-types | | +--------+--------------+------------------------------------------+ Table 1: Prefixes and corresponding YANG modules [Note to RFC editor: Please replace XXXX with the number assigned to the RFC along the full document once this draft becomes an RFC.] 1.4. 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 BCP 14 [RFC2119] [RFC8174] when, and only when, they appear in all capitals, as shown here. This document is structured following the guidelines for documents containing YANG Data defined in [RFC8407] and its update in [I-D.ietf-netmod-rfc8407bis] Galimberti, et al. Expires 4 January 2027 [Page 5] Internet-Draft draft-ietf-ccamp-dwdm-if-param-yang-16 July 2026 2. Module Description 2.1. 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 ROADMs. Is to be noted that the TX L1 and RX L1 may be located outside the DWDM network and fitted in the packet layer network elements as pluggable modules. Ss +-------------------------------------------------+ Rs | | DWDM Network Elements | | +---+ | | | \ / | | | +---+ TX L1---|->| \ +------+ +------+ / |--|-->RX L1 +---+ | | | | | +------+ | | | | | +---+ +---+ | | | | | | | | | | | | +---+ TX L2---|->| OM |-->|------|->|ROADM |--|------|->| OD |--|-->RX L2 +---+ | | | | | | | | | | | | +---+ +---+ | | | | | +------+ | | | | | +---+ TX L3---|->| / | DWDM | | ^ | DWDM | \ |--|-->RX L4 +---+ | | / | Link +----|--|----+ Link | \ | | +---+ +-----------+ | | +----------+ +----+ +----+ | | Rs v | Ss +-----+ +-----+ |RX L3| |TX L4| +-----+ +-----+ 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 Multiplexer Figure 1: Transponder in WDM networks from Fig. 5.1/[ITU-T_G.698.2] Galimberti, et al. Expires 4 January 2027 [Page 6] Internet-Draft draft-ietf-ccamp-dwdm-if-param-yang-16 July 2026 This document introduces the ietf-wdm-interface model as an augment to the ietf-interface. It allows the client to set the operating mode of transceivers as well as other operational parameters. The YANG model also provide the container wdm-if-tca for the configuration of Threshold Crossing Alert (TCA) that can trigger stateless notification to supervise parameters and notify the client [ITU-T_G.8201]. 2.2. YANG Module Classification The model defined in this document is meant to be used as Device Model as per definition in [RFC8199] and [RFC8309] 2.3. Optical Parameters Description The network architecture presented in Figure 1 is described in [ITU-T_G.698.2] section 5.2. The transponders are usually a combination of the TX and RX function in single interface, implementing the connectivity at Rs and Ss points in a bidirectional way. Definitions of the optical parameters introduced in this document are listed in the YANG tree in Appendix A and described within the model definition in Section 3 2.4. Use Cases The use cases are described in [I-D.ietf-ccamp-optical-impairment-topology-yang]. 3. WDM Interface YANG Module ietf-wdm-interface is a top level model that allow the configuration and monitoring of DWDM interfaces optical parameters. It is defined as an extension to ietf-interfaces. file "ietf-wdm-interface.yang" module ietf-wdm-interface { yang-version 1.1; namespace "urn:ietf:params:xml:ns:yang:ietf-wdm-interface"; prefix wdm-if; import ietf-yang-revisions { prefix rev; } import ietf-interfaces { prefix if; } Galimberti, et al. Expires 4 January 2027 [Page 7] Internet-Draft draft-ietf-ccamp-dwdm-if-param-yang-16 July 2026 import ietf-layer0-types { prefix l0-types; rev:recommended-min-date "2025-11-03"; } organization "IETF CCAMP Working Group"; contact "WG Web: WG List: Editor: Dharini Hiremagalur Editor: Gabriele Galimberti Editor: Gert Grammel Editor: Roberto Manzotti "; description "This module contains a collection of YANG definitions for configuring DWDM Optical interfaces. Copyright (c) 2025 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 Revised BSD License set forth in Section 4.c of the IETF Trust's Legal Provisions Relating to IETF Documents (https://trustee.ietf.org/license-info). This version of this YANG module is part of RFC XXXX; see the RFC itself for full legal notices. The key words 'MUST', 'MUST NOT', 'REQUIRED', 'SHALL', 'SHALL NOT', 'SHOULD', 'SHOULD NOT', 'RECOMMENDED', 'NOT RECOMMENDED', 'MAY', and 'OPTIONAL' in this document are to be interpreted as described in BCP 14 (RFC 2119) (RFC 8174) when, and only when, they appear in all capitals, as shown here."; // RFC Ed. please: // - replace XXXX with actual RFC number of this document // - replace ZZZZ with the RFC number assigned to // draft-ietf-ccamp-optical-impairment-topology-yang // - replace the revision date with the module publication date // the format is (year-month-day) // // and finally delete this note. Galimberti, et al. Expires 4 January 2027 [Page 8] Internet-Draft draft-ietf-ccamp-dwdm-if-param-yang-16 July 2026 revision 2026-07-03 { description "Initial Version"; reference "RFC XXXX: A YANG data model to manage configurable DWDM optical interfaces"; } identity wdm-if-tca-type { description "The different types of Threshold Crossing Alert (TCA's) for DWDM Interfaces. Any augmentation of the list of tca-type MUST use this identity as base"; } identity laser-linewdt-tca { base wdm-if-tca-type; description "The laser linewidth TCA"; } identity tx-power-tca { base wdm-if-tca-type; description "The Interface Transmit power TCA"; } identity rx-power-tca { base wdm-if-tca-type; description "The Interface Receive power TCA"; } identity rx-pol-power-diff-tca { base wdm-if-tca-type; description "The X-Y power difference between the two polarizations TCA on the receiver interface"; } identity rx-pol-skew-diff-tca { base wdm-if-tca-type; description "The X-Y skew between the two polarizations TCA on the receiver interface"; } identity rx-cd-tca { Galimberti, et al. Expires 4 January 2027 [Page 9] Internet-Draft draft-ietf-ccamp-dwdm-if-param-yang-16 July 2026 base wdm-if-tca-type; description "The fiber chromatic dispersion (CD) TCA on the receiver interface"; } identity rx-pmd-tca { base wdm-if-tca-type; description "The polarization mode dispersion (PMD) TCA on the receiver interface"; } identity rx-pdl-tca { base wdm-if-tca-type; description "The polarization dependent loss (PDL) TCA on the receiver interface"; } identity rx-frequency-offset-tca { base wdm-if-tca-type; description "The Frequency offset TCA "; } identity rx-osnr-tca { base wdm-if-tca-type; description "Optical Signal to Noise Ratio (OSNR) TCA on the receiver interface"; } identity laser-temperature-tca { base wdm-if-tca-type; description "Laser temperature TCA on the transmiter laser"; } identity rx-pre-fec-ber-tca { base wdm-if-tca-type; description "Pre-FEC Bit Error Rate (BER) TCA on the receiver interface"; } identity rx-uncorrected-words-tca { base wdm-if-tca-type; Galimberti, et al. Expires 4 January 2027 [Page 10] Internet-Draft draft-ietf-ccamp-dwdm-if-param-yang-16 July 2026 description "Counter of Post-FEC uncorrected words TCA on the receiver interface"; } identity rx-q-factor-tca { base wdm-if-tca-type; description "Q-factor TCA on the receiver interface"; } grouping wdm-if-tca-thresholds { description "Thresholds for TCA's"; leaf tca-type { type identityref { base wdm-if-tca-type; } mandatory true; description "type of the TCA that identify the performance measurement, eg tx-power-tca"; } leaf tca-name { type string; mandatory true; description "A textual name of the TCA that explain its scope eg 'High-RX-Power'"; } leaf raise-threshold { type l0-types:decimal-5; must 'current() != ../clear-threshold' { error-message "TCA raise and clear thresholds must be different"; } mandatory true; description "A TCA is raised if the variable cross this threshold: - if raise-threshold is greater than clear-threshold the TCA is raised when the value exceed this threshold - if raise-threshold is smaller than clear-threshold, the TCA is raised when the value fall below this threshold"; } leaf clear-threshold { type l0-types:decimal-5; must 'current() != ../raise-threshold' { error-message Galimberti, et al. Expires 4 January 2027 [Page 11] Internet-Draft draft-ietf-ccamp-dwdm-if-param-yang-16 July 2026 "TCA raise and clear thresholds must be different"; } mandatory true; description "A TCA cleared when the variable cross this threshold: - if clear-threshold is smaller than raise-threshold the TCA is cleared when the value fall below this threshold - if clear-threshold is grater than raise-threshold, the TCA is cleared when the value exceed this threshold"; } } // end grouping wdm-if-tca-threshold grouping wdm-if-tca-list { description "List of TCA's"; leaf number-of-tcas-supported { type uint32; default "0"; config false; description "Number of TCAs supported by this interface, if the implementation do not suport TCAs it SHALL leave this value to defualt = 0"; } list tca-list { key "tca-id"; description "List of the TCAs"; leaf tca-id { type string; mandatory true; description "Unique Identifier of the TCA defined for the interface"; } uses wdm-if-tca-thresholds; } } // end grouping wdm-if-tca-list grouping wdm-if-parameters { description "DWDM Interface Configuration and Operational parameters"; leaf central-frequency { type l0-types:frequency-thz; description "This parameter indicates the interface Central Frequency. In the configuration datastore the target central-frequency configuration can be set/get; when reading the operational datastore the implementation Galimberti, et al. Expires 4 January 2027 [Page 12] Internet-Draft draft-ietf-ccamp-dwdm-if-param-yang-16 July 2026 shall provide the current central-frequency, that may differ from the configured value"; reference "ITU-T G.694.1 (10/2020): Spectral grids for WDM applications: DWDM frequency grid"; } uses l0-types:common-transceiver-param; leaf tx-total-power { type l0-types:power-dbm-or-unknown; default "unknown"; config false; description "The current total transmitted power, if not supported by the implementation SHALL not be present"; } leaf cur-osnr { type l0-types:snr-or-unknown; units "dB"; default "unknown"; config false; description "Current measured Optical Signal to Noise Ratio (OSNR), if not supported by the implementation SHALL not be present"; } leaf min-osnr-margin { type l0-types:snr-or-unknown; default "unknown"; config false; description "Optical Signal to Noise (OSNR) margin to FEC threshold, if not supported by the implementation SHALL remain undefined"; } leaf q-margin { type l0-types:decimal-2-or-unknown; units "dB"; default "unknown"; config false; description "Q-factor margin to FEC threshold, if not supported by the implementationp SHALL remain undefined"; reference "ITU-T O.201 (07/2003): Q-factor test equipment to estimate the transmission performance of optical channels"; } leaf q-factor { type l0-types:decimal-2-or-unknown; units "dB"; Galimberti, et al. Expires 4 January 2027 [Page 13] Internet-Draft draft-ietf-ccamp-dwdm-if-param-yang-16 July 2026 default "unknown"; config false; description "Current measured Q-factor of the interface, if not supported by the implementation SHALL not be present"; reference "ITU-T O.201 (07/2003): Q-factor test equipment to estimate the transmission performance of optical channels"; } leaf fec-uncorrected-words { type uint64; config false; description "Counter of Post-FEC uncorrected errored words, if not supported by the implementation SHALL not be present"; } leaf fec-uncorrectable-blocks { type uint64; config false; description "Counter of the uncorectable FEC data blocks, if not supported by the implementation SHALL not be present"; } leaf pre-fec-ber { type l0-types:decimal-18-or-unknown; default "unknown"; config false; description "Current measured Pre-FEC error rate, if not supported by the implementation SHALL not be present"; } leaf chromatic-dispersion { type l0-types:decimal-2-or-unknown; units "ps/nm"; default "unknown"; config false; description "Chromatic ispersion (CD) on the receive, if not supported by the implementation SHALL not be present"; reference "RFC ZZZZ: A YANG Data Model for Optical Impairment-aware Topology, Section 2.4.6"; } Galimberti, et al. Expires 4 January 2027 [Page 14] Internet-Draft draft-ietf-ccamp-dwdm-if-param-yang-16 July 2026 leaf polarization-mode-dispersion { type l0-types:decimal-2-or-unknown; units "ps"; default "unknown"; config false; description "Current polarization mode dispersion (PMD) on the receive, if not supported by the implementation SHALL not be present"; reference "ITU-T G.650.2 (02/2015): Definitions and test methods for statistical and non-linear related attributes of single-mode fibre and cable. Section 3.1 RFC ZZZZ: A YANG Data Model for Optical Impairment-aware Topology, Section 2.4.6"; } leaf polarization-dependent-loss { type l0-types:power-loss-or-unknown; default "unknown"; config false; description "Current polarization dependent loss (PDL) on the receive, if not supported by the implementation SHALL not be present"; reference "RFC ZZZZ: A YANG Data Model for Optical Impairment-aware Topology, Section 2.4.6"; } leaf tx-central-frequency-offset { type l0-types:frequency-ghz; default "0"; config false; description "Frequency difference between nominal and actual optical carrier frequency, if not supported by the implementation SHALL not be present"; reference "OIF-400GZR-02.0 Implementation Agreement Section 13.1"; } leaf rx-central-frequency-offset { type l0-types:frequency-ghz; default "0"; config false; description "Frequency difference between received signal carrier frequency and the local laser frequency in coherent optical interfaces, if not supported by the implementation Galimberti, et al. Expires 4 January 2027 [Page 15] Internet-Draft draft-ietf-ccamp-dwdm-if-param-yang-16 July 2026 SHALL not be present"; reference "OIF-400GZR-02.0 Implementation Agreement Section 13.1"; } leaf laser-temperature { type l0-types:decimal-2-or-unknown; units "Deg Celsius"; default "unknown"; config false; description "Laser temperature mesured in degree Celsius, if not supported by the implementation SHALL not be present"; reference "Openconfig openconfig-platform.yang rev. 0.32.0"; } leaf diff-group-delay { type l0-types:decimal-2-or-unknown; units "ps"; default "unknown"; config false; description "Transmission delay between polarization modes at the reciever, if not supported by the implementation SHALL not be present"; reference "OIF-400GZR-02.0 Implementation Agreement Section 13.4.7"; } leaf laser-bias-current { type l0-types:decimal-2-or-unknown; units "mA"; default "unknown"; config false; description "The electircal current applied the the Tx Laser to achieve the required output power, expressed in mA, if not supported by the implementation SHALL not be present"; reference "Openconfig openconfig-platform.yang rev. 0.32.0"; } leaf modulation-error-ratio { type l0-types:power-ratio-or-unknown; default "unknown"; config false; description Galimberti, et al. Expires 4 January 2027 [Page 16] Internet-Draft draft-ietf-ccamp-dwdm-if-param-yang-16 July 2026 "Modulation error ratio in dB with two decimal precision. if not supported by the implementation SHALL not be present"; reference "OIF-400GZR-02.0 Implementation Agreement Section 14.4.3"; } leaf tx-variable-optical-attenuation { type l0-types:power-ratio-or-unknown; default "unknown"; config false; description "Variable Optical Attenutor on the TX signal. if not supported by the implementation SHALL not be present"; reference "TAPI v2.5.0 Reference Implementation Agreement TR-547, Table 106"; } leaf rx-variable-optical-attenuation { type l0-types:power-ratio-or-unknown; default "unknown"; config false; description "Variable Optical Attenutor on the RX signal. if not supported by the implementation SHALL not be present"; reference "TAPI v2.5.0 Reference Implementation Agreement TR-547, Table 106"; } leaf max-error-vector-magnitude { type l0-types:decimal-5-or-unknown; default "unknown"; config false; description "EVMmax (Error Vector Magnitude Max) is a metric for evaluating maximum error vector magnitude in coherent optics, if not supported by the implementation SHALL not be present"; reference "OIF-400GZR-02.0 Implementation Agreement Section 14.4.1 and 20.1"; } leaf rms-error-vector-magnitude { type l0-types:decimal-5-or-unknown; default "unknown"; config false; Galimberti, et al. Expires 4 January 2027 [Page 17] Internet-Draft draft-ietf-ccamp-dwdm-if-param-yang-16 July 2026 description "Error Vector Magnitude normalized by RMS value of reference constellation points; used to evaluate coherent optical signal quality, if not supported by the implementation SHALL not be present"; reference "OIF-400GZR-02.0 Implementation Agreement Section 14.4.2"; } leaf second-order-polarization-mode-dispersion { type l0-types:decimal-5-or-unknown; default "unknown"; config false; description "Second Order Polarization Mode Dispersion, if not supported by the implementation SHALL not be present"; reference "ITU-T G.650.2 (02/2015): Definitions and test methods for statistical and non-linear related attributes of single-mode fibre and cable. Section 3.1"; } leaf sop-rate-of-change { type l0-types:decimal-5-or-unknown; default "unknown"; config false; description "Rate of change of polarization state, measured in real-time by tracking the speed of polarization state rotation at the receiver, if not supported by the implementation SHALL not be present"; reference "ITU-T G.698.2 (11/2018): Amplified multichannel dense wavelength division multiplexing applications with single channel optical interfaces. Section 7.3.7"; } leaf modulation-bias-x-i { type l0-types:decimal-2-or-unknown; default "unknown"; config false; description "Bias on the in-phase (I) path of polarization X in a coherent optical modulator, expressed as a percentage, if not supported by the implementation SHALL not be present"; reference "Openconfig openconfig-platform.yang rev. 0.32.0"; } leaf modulation-bias-x-q { type l0-types:decimal-2-or-unknown; Galimberti, et al. Expires 4 January 2027 [Page 18] Internet-Draft draft-ietf-ccamp-dwdm-if-param-yang-16 July 2026 default "unknown"; config false; description "Bias on the quadrature (Q) path of polarization X in a coherent optical modulator, expressed as a percentage, if not supported by the implementation SHALL not be present"; reference "Openconfig openconfig-platform.yang rev. 0.32.0l"; } leaf modulation-bias-y-i { type l0-types:decimal-2-or-unknown; default "unknown"; config false; description "Bias on the in-phase (I) path of polarization Y in a coherent optical modulator, expressed as a percentage, if not supported by the implementation SHALL not be present"; reference "Openconfig openconfig-platform.yang rev. 0.32.0"; } leaf modulation-bias-y-q { type l0-types:decimal-2-or-unknown; default "unknown"; config false; description "Bias on the quadrature (Q) path of polarization Y in a coherent optical modulator, expressed as a percentag, if not supported by the implementation SHALL not be present"; reference "Openconfig openconfig-platform.yang rev. 0.32.0"; } leaf modulation-bias-x-phase { type l0-types:decimal-2-or-unknown; default "unknown"; config false; description "Bias on the phase path of polarization X in a coherent optical modulator, expressed as a percentage, if not supported by the implementation SHALL not be present"; reference "Openconfig openconfig-platform.yang rev. 0.32.0"; } leaf modulation-bias-y-phase { type l0-types:decimal-2-or-unknown; default "unknown"; config false; description "Bias on the phase path of polarization Y in a coherent Galimberti, et al. Expires 4 January 2027 [Page 19] Internet-Draft draft-ietf-ccamp-dwdm-if-param-yang-16 July 2026 optical modulator, expressed as a percentage, if not supported by the implementation SHALL not be present"; reference "Openconfig openconfig-platform.yang rev. 0.32.0"; } leaf self-phase-modulation { type l0-types:decimal-2-or-unknown; default "unknown"; config false; description "Self-phase modulation (SPM) is a nonlinear optical effect where the phase of a light pulse is modulated by its own intensity due to the Kerr effect, if not supported by the implementation SHALL not be present"; reference "ITU-T G.650.2 (02/2015): Definitions and test methods for statistical and non-linear related attributes of single-mode fibre and cable. Section II.3.1"; } leaf cross-phase-modulation { type l0-types:decimal-2-or-unknown; default "unknown"; config false; description "Cross-phase modulation (XPM) is a nonlinear optical effect where the intensity of one light signal modulates the phase of another signal traveling through the same fiber, if not supported by the implementation SHALL not be present"; reference "ITU-T G.650.2 (02/2015): Definitions and test methods for statistical and non-linear related attributes of single-mode fibre and cable. Section II.3.3"; } } // end grouping wdm-if-parameters notification wdm-if-tca { description "A notification for a Threshold Crossing Alert (TCA)"; leaf if-name { type leafref { path "/if:interfaces/if:interface/if:name"; } mandatory true; description "Interface name"; } leaf tca-type { type identityref { Galimberti, et al. Expires 4 January 2027 [Page 20] Internet-Draft draft-ietf-ccamp-dwdm-if-param-yang-16 July 2026 base wdm-if-tca-type; } mandatory true; description "The Type of TCA that have triggered the notification, e.g, tx-power-tca"; } leaf tca-name { type string; mandatory true; description "A textual name of the TCA that have triggered the notification that explain its scope, eg 'TX Power Degrade'"; } } // end notification wdm-if-tca augment "/if:interfaces" { description "Template definition for Optical Interface explicit-modes"; container wdm-if-templates { config false; description "Optical Interface explicit-mode templates"; container explicit-transceiver-modes { description "The top level container for the list of the transceivers' explicit modes."; list explicit-transceiver-mode { key "explicit-transceiver-mode-id"; description "The list of the transceivers' explicit modes."; leaf explicit-transceiver-mode-id { type string { length "8..64"; } description "The identifier of the transceivers' explicit mode."; } uses l0-types:explicit-mode; } // end list explicit-transceiver-mode } // end container explicit-transceiver-modes } // end container wdm-if-templates } // end augmentation interfaces augment "/if:interfaces/if:interface" { description "Parameters for an optical interface"; container wdm-interface { Galimberti, et al. Expires 4 January 2027 [Page 21] Internet-Draft draft-ietf-ccamp-dwdm-if-param-yang-16 July 2026 description "Container for capabilities, configuration, current operational data for a DWDM interface"; uses l0-types:transceiver-capabilities { augment "supported-modes/supported-mode/mode/" + "explicit-mode/explicit-mode" { description "Augment the explicit-mode container with the proper leafref."; leaf explicit-transceiver-mode-ref { type leafref { path "../../../../../../wdm-if:wdm-if-templates" + "/wdm-if:explicit-transceiver-modes" + "/wdm-if:explicit-transceiver-mode" + "/wdm-if:explicit-transceiver-mode-id"; } config false; mandatory true; description "The reference to the explicit transceiver mode template."; } // end explicit-transceiver-mode-ref } // end augmentation explicit-mode } // end uses l0-types:transceiver-capabilities container wdm-if-tcas { description "Threshold Crossing Alerts definition and configuration"; uses wdm-if-tca-list; } // end of container wdm-if-tcas leaf configured-mode { type union { type empty; type leafref { path "../supported-modes/supported-mode/mode-id"; require-instance false; } } default "empty"; description "Reference to the configured mode for transceiver compatibility approach. The empty value is used to report that no mode has been configured and there is no default mode. When not present, the configured-mode is not reported by the server, this means the interface is not configured"; Galimberti, et al. Expires 4 January 2027 [Page 22] Internet-Draft draft-ietf-ccamp-dwdm-if-param-yang-16 July 2026 } uses wdm-if-parameters; } // end container wdm-interface } // end augmentation interface } 4. Security Considerations This section is modeled after the template described in Section 3.7 of [RFC8407] and the update in document [I-D.ietf-netmod-rfc8407bis]. The "ietf-wdm-interface" YANG module defines a data model that is designed to be accessed via YANG-based management protocols, such as NETCONF [RFC6241] and RESTCONF [RFC8040]. These protocols have to use a secure transport layer (e.g., SSH [RFC4252], TLS [RFC8446], and QUIC [RFC9000]) and have to use mutual authentication. The Network Configuration Access Control Model (NACM) [RFC8341] provides the means to restrict access for particular NETCONF or RESTCONF users to a preconfigured subset of all available NETCONF or RESTCONF protocol operations and content. There are a number of data nodes defined in this YANG module that are writable/creatable/deletable (i.e., "config true", which is the default). All writable data nodes are likely to be reasonably sensitive or vulnerable in some network environments. Write operations (e.g., edit-config) and delete operations to these data nodes without proper protection or authentication can have a negative effect on network operations. There are no particularly sensitive writable data nodes. There are no particularly sensitive readable data nodes. 5. IANA Considerations This document registers the following namespace URIs in the IETF XML registry [RFC3688]: -------------------------------------------------------------------- URI: urn:ietf:params:xml:ns:yang:ietf-wdm-interface Registrant Contact: The IESG. XML: N/A, the requested URI is an XML namespace. -------------------------------------------------------------------- Galimberti, et al. Expires 4 January 2027 [Page 23] Internet-Draft draft-ietf-ccamp-dwdm-if-param-yang-16 July 2026 This document registers the following YANG modules in the YANG Module Names registry [RFC7950]: -------------------------------------------------------------------- name: ietf-wdm-interface namespace: urn:ietf:params:xml:ns:yang:ietf-wdm-interface prefix: wdm-if reference: RFC XXXX (TDB) -------------------------------------------------------------------- 6. Acknowledgements Italo Busi Huawei Technologies Email: Italo.Busi@huawei.com 7. Contributors Ruediger Kunze Deutsche Telekom Winterfeldtstr. 21-27 10781 Berlin Germany +491702275321 RKunze@telekom.de Dean Bogdanovic Westford U.S.A. email ivandean@gmail.com Bernd Zeuner Deutsche Telekom Darmstadt Germany email B.Zeuner@telekom.de Massimiliano Salsi Nokia Sunnyvale, CA, 94089 U.S.A. email msalsi@google.com Manuel Paul Deutsche Telekom Berlin Germany email Manuel.Paul@telekom.de Galimberti, et al. Expires 4 January 2027 [Page 24] Internet-Draft draft-ietf-ccamp-dwdm-if-param-yang-16 July 2026 Walid Wakim Nokia ILLINOIS UNITED STATES email wakims@mac.com Hing-Kam Lam Fhusa USA kam.lam@fhusainc.com Sergio Belotti Nokia Via Energy Park 20871 Vimercate (MB) Italy Sergio.belotti@nokia.com Andreas Burk Architekt Network Automation CTO Board 1und1 Versatel Deutschland GmbH Solmsstr. 73 D-60486 Frankfurt am Main +49 69 21789246 Andreas.Burk@1und1.net 8. References 8.1. Normative References [RFC2119] Bradner, S., "Key words for use in RFCs to Indicate Requirement Levels", BCP 14, RFC 2119, DOI 10.17487/RFC2119, March 1997, . [RFC8199] Bogdanovic, D., Claise, B., and C. Moberg, "YANG Module Classification", RFC 8199, DOI 10.17487/RFC8199, July 2017, . [RFC8309] Wu, Q., Liu, W., and A. Farrel, "Service Models Explained", RFC 8309, DOI 10.17487/RFC8309, January 2018, . [RFC7698] Gonzalez de Dios, O., Ed., Casellas, R., Ed., Zhang, F., Fu, X., Ceccarelli, D., and I. Hussain, "Framework and Requirements for GMPLS-Based Control of Flexi-Grid Dense Galimberti, et al. Expires 4 January 2027 [Page 25] Internet-Draft draft-ietf-ccamp-dwdm-if-param-yang-16 July 2026 Wavelength Division Multiplexing (DWDM) Networks", RFC 7698, DOI 10.17487/RFC7698, November 2015, . [RFC8174] Leiba, B., "Ambiguity of Uppercase vs Lowercase in RFC 2119 Key Words", BCP 14, RFC 8174, DOI 10.17487/RFC8174, May 2017, . [RFC9093] Zheng, H., Lee, Y., Guo, A., Lopez, V., and D. King, "A YANG Data Model for Layer 0 Types", RFC 9093, DOI 10.17487/RFC9093, August 2021, . [I-D.ietf-ccamp-rfc9093-bis] Belotti, S., Busi, I., Beller, D., Le Rouzic, E., and A. Guo, "Common YANG Data Types for Layer 0 Optical Networks", Work in Progress, Internet-Draft, draft-ietf- ccamp-rfc9093-bis-20, 22 June 2026, . [I-D.ietf-ccamp-optical-impairment-topology-yang] Beller, D., Le Rouzic, E., Belotti, S., Galimberti, G., and I. Busi, "A YANG Data Model for Optical Impairment- aware Topology", Work in Progress, Internet-Draft, draft- ietf-ccamp-optical-impairment-topology-yang-22, 20 February 2026, . [RFC3688] Mealling, M., "The IETF XML Registry", BCP 81, RFC 3688, DOI 10.17487/RFC3688, January 2004, . [RFC8040] Bierman, A., Bjorklund, M., and K. Watsen, "RESTCONF Protocol", RFC 8040, DOI 10.17487/RFC8040, January 2017, . [RFC6241] Enns, R., Ed., Bjorklund, M., Ed., Schoenwaelder, J., Ed., and A. Bierman, Ed., "Network Configuration Protocol (NETCONF)", RFC 6241, DOI 10.17487/RFC6241, June 2011, . [RFC8341] Bierman, A. and M. Bjorklund, "Network Configuration Access Control Model", STD 91, RFC 8341, DOI 10.17487/RFC8341, March 2018, . Galimberti, et al. Expires 4 January 2027 [Page 26] Internet-Draft draft-ietf-ccamp-dwdm-if-param-yang-16 July 2026 [RFC8446] Rescorla, E., "The Transport Layer Security (TLS) Protocol Version 1.3", RFC 8446, DOI 10.17487/RFC8446, August 2018, . [RFC9000] Iyengar, J., Ed. and M. Thomson, Ed., "QUIC: A UDP-Based Multiplexed and Secure Transport", RFC 9000, DOI 10.17487/RFC9000, May 2021, . [RFC4252] Ylonen, T. and C. Lonvick, Ed., "The Secure Shell (SSH) Authentication Protocol", RFC 4252, DOI 10.17487/RFC4252, January 2006, . [RFC7950] Bjorklund, M., Ed., "The YANG 1.1 Data Modeling Language", RFC 7950, DOI 10.17487/RFC7950, August 2016, . [RFC8343] Bjorklund, M., "A YANG Data Model for Interface Management", RFC 8343, DOI 10.17487/RFC8343, March 2018, . [RFC6566] Lee, Y., Ed., Bernstein, G., Ed., Li, D., and G. Martinelli, "A Framework for the Control of Wavelength Switched Optical Networks (WSONs) with Impairments", RFC 6566, DOI 10.17487/RFC6566, March 2012, . [RFC8340] Bjorklund, M. and L. Berger, Ed., "YANG Tree Diagrams", BCP 215, RFC 8340, DOI 10.17487/RFC8340, March 2018, . [RFC8342] Bjorklund, M., Schoenwaelder, J., Shafer, P., Watsen, K., and R. Wilton, "Network Management Datastore Architecture (NMDA)", RFC 8342, DOI 10.17487/RFC8342, March 2018, . [I-D.ietf-netmod-yang-module-versioning] Wilton, R., Rahman, R., Lengyel, B., Clarke, J., and J. Sterne, "Updated YANG Module Revision Handling", Work in Progress, Internet-Draft, draft-ietf-netmod-yang-module- versioning-15, 18 October 2025, . Galimberti, et al. Expires 4 January 2027 [Page 27] Internet-Draft draft-ietf-ccamp-dwdm-if-param-yang-16 July 2026 [ITU-T_G.698.2] International Telecommunications Union, "Amplified multichannel dense wavelength division multiplexing applications with single channel optical interfaces", ITU-T Recommendation G.698.2, November 2018. [ITU-T_G.874] International Telecommunications Union, "Management aspects of optical transport network elements", ITU-T Recommendation G.874, October 2020. [ITU-T_G.874.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-T_G.959.1] International Telecommunications Union, "Optical transport network physical layer interfaces", ITU-T Recommendation G.959.1, January 2024. [ITU-T_G.8201] 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-T_G.694.1] International Telecommunications Union, "Spectral grids for WDM applications: DWDM frequency grid", ITU-T Recommendation G.694.1, October 2020. [ITU-T_G.7710] International Telecommunications Union, "Common equipment management function requirements", ITU-T Recommendation G.7710, October 2020. [ITU-T_G.672] International Telecommunications Union, "Characteristics of multi-degree reconfigurable optical add/drop multiplexers", ITU-T Recommendation G.672, May 2025. [ITU-T_G.807] International Telecommunications Union, "Generic functional architecture of the optical media layer", ITU-T Recommendation G.807, October 2024. Galimberti, et al. Expires 4 January 2027 [Page 28] Internet-Draft draft-ietf-ccamp-dwdm-if-param-yang-16 July 2026 8.2. Informative References [RFC8407] Bierman, A., "Guidelines for Authors and Reviewers of Documents Containing YANG Data Models", RFC 8407, DOI 10.17487/RFC8407, October 2018, . [I-D.ietf-netmod-rfc8407bis] Bierman, A., Boucadair, M., and Q. Wu, "Guidelines for Authors and Reviewers of Documents Containing YANG Data Models", Work in Progress, Internet-Draft, draft-ietf- netmod-rfc8407bis-28, 5 June 2025, . [I-D.ietf-ccamp-wdm-tunnel-yang] Guo, A., Belotti, S., Galimberti, G., de Madrid, U. A., and D. P. Burrero, "A YANG Data Model for WDM Tunnels", Work in Progress, Internet-Draft, draft-ietf-ccamp-wdm- tunnel-yang-06, 20 October 2025, . Appendix A. YANG Tree module: ietf-wdm-interface augment /if:interfaces: +--ro wdm-if-templates +--ro explicit-transceiver-modes +--ro explicit-transceiver-mode* [explicit-transceiver-mode-id] +--ro explicit-transceiver-mode-id string +--ro line-coding-bitrate? identityref +--ro bitrate? uint16 +--ro max-diff-group-delay? decimal-2 +--ro max-chromatic-dispersion? decimal-2 +--ro cd-penalty* [cd-value] | +--ro cd-value decimal-2 | +--ro penalty-value union +--ro max-polarization-mode-dispersion? decimal-2 +--ro pmd-penalty* [pmd-value] | +--ro pmd-value decimal-2 | +--ro penalty-value union +--ro max-polarization-dependent-loss | power-loss-or-unknown +--ro pdl-penalty* [pdl-value] | +--ro pdl-value power-loss Galimberti, et al. Expires 4 January 2027 [Page 29] Internet-Draft draft-ietf-ccamp-dwdm-if-param-yang-16 July 2026 | +--ro penalty-value union +--ro available-modulation-type? identityref +--ro min-osnr? snr +--ro rx-ref-channel-power? power-dbm +--ro rx-channel-power-penalty* [rx-channel-power-value] | +--ro rx-channel-power-value power-dbm | +--ro penalty-value union +--ro min-q-factor? decimal-2 +--ro available-baud-rate? decimal64 +--ro roll-off? decimal64 +--ro min-carrier-spacing? frequency-ghz +--ro available-fec-type? identityref +--ro fec-code-rate? decimal64 +--ro fec-threshold? decimal64 +--ro in-band-osnr? snr +--ro out-of-band-osnr? snr +--ro tx-polarization-power-difference? power-ratio +--ro polarization-skew? decimal-2 augment /if:interfaces/if:interface: +--rw wdm-interface +--ro supported-modes! | +--ro supported-mode* [mode-id] | +--ro mode-id string | +--ro (mode) | +--:(g.698.2) | | +--ro g.698.2 | | +--ro standard-mode standard-mode | | +--ro line-coding-bitrate* identityref | | +--ro transceiver-tuning-range | | | +--ro min-central-frequency? | | | | frequency-thz | | | +--ro max-central-frequency? | | | | frequency-thz | | | +--ro transceiver-tunability-granularity? | | | frequency-ghz | | +--ro tx-channel-power-min? power-dbm | | +--ro tx-channel-power-max? power-dbm | | +--ro rx-channel-power-min? power-dbm | | +--ro rx-channel-power-max? power-dbm | | +--ro rx-total-power-max? power-dbm | +--:(organizational-mode) | | +--ro organizational-mode | | +--ro operational-mode | | | operational-mode | | +--ro organization-identifier | | | organization-identifier | | +--ro line-coding-bitrate* identityref | | +--ro transceiver-tuning-range Galimberti, et al. Expires 4 January 2027 [Page 30] Internet-Draft draft-ietf-ccamp-dwdm-if-param-yang-16 July 2026 | | | +--ro min-central-frequency? | | | | frequency-thz | | | +--ro max-central-frequency? | | | | frequency-thz | | | +--ro transceiver-tunability-granularity? | | | frequency-ghz | | +--ro tx-channel-power-min? power-dbm | | +--ro tx-channel-power-max? power-dbm | | +--ro rx-channel-power-min? power-dbm | | +--ro rx-channel-power-max? power-dbm | | +--ro rx-total-power-max? power-dbm | +--:(explicit-mode) | +--ro explicit-mode | +--ro transceiver-tuning-range | | +--ro min-central-frequency? | | | frequency-thz | | +--ro max-central-frequency? | | | frequency-thz | | +--ro transceiver-tunability-granularity? | | frequency-ghz | +--ro tx-channel-power-min? | | power-dbm | +--ro tx-channel-power-max? | | power-dbm | +--ro rx-channel-power-min? | | power-dbm | +--ro rx-channel-power-max? | | power-dbm | +--ro rx-total-power-max? | | power-dbm | +--ro compatible-modes | | +--ro supported-application-code* | | | -> ../../../../supported-mode/mode-id | | +--ro supported-organizational-mode* | | -> ../../../../supported-mode/mode-id | +--ro explicit-transceiver-mode-ref leafref +--rw wdm-if-tcas | +--ro number-of-tcas-supported? uint32 | +--rw tca-list* [tca-id] | +--rw tca-id string | +--rw tca-type identityref | +--rw tca-name string | +--rw raise-threshold l0-types:decimal-5 | +--rw clear-threshold l0-types:decimal-5 +--rw configured-mode? union +--rw central-frequency? | l0-types:frequency-thz +--rw line-coding-bitrate? identityref Galimberti, et al. Expires 4 January 2027 [Page 31] Internet-Draft draft-ietf-ccamp-dwdm-if-param-yang-16 July 2026 +--rw tx-channel-power? | power-dbm-or-unknown +--ro rx-channel-power? | power-dbm-or-unknown +--ro rx-total-power? | power-dbm-or-unknown +--ro tx-total-power? | l0-types:power-dbm-or-unknown +--ro cur-osnr? | l0-types:snr-or-unknown +--ro min-osnr-margin? | l0-types:snr-or-unknown +--ro q-margin? | l0-types:decimal-2-or-unknown +--ro q-factor? | l0-types:decimal-2-or-unknown +--ro fec-uncorrected-words? uint64 +--ro fec-uncorrectable-blocks? uint64 +--ro pre-fec-ber? | l0-types:decimal-18-or-unknown +--ro chromatic-dispersion? | l0-types:decimal-2-or-unknown +--ro polarization-mode-dispersion? | l0-types:decimal-2-or-unknown +--ro polarization-dependent-loss? | l0-types:power-loss-or-unknown +--ro tx-central-frequency-offset? | l0-types:frequency-ghz +--ro rx-central-frequency-offset? | l0-types:frequency-ghz +--ro laser-temperature? | l0-types:decimal-2-or-unknown +--ro diff-group-delay? | l0-types:decimal-2-or-unknown +--ro laser-bias-current? | l0-types:decimal-2-or-unknown +--ro modulation-error-ratio? | l0-types:power-ratio-or-unknown +--ro tx-variable-optical-attenuation? | l0-types:power-ratio-or-unknown +--ro rx-variable-optical-attenuation? | l0-types:power-ratio-or-unknown +--ro max-error-vector-magnitude? | l0-types:decimal-5-or-unknown +--ro rms-error-vector-magnitude? | l0-types:decimal-5-or-unknown +--ro second-order-polarization-mode-dispersion? | l0-types:decimal-5-or-unknown Galimberti, et al. Expires 4 January 2027 [Page 32] Internet-Draft draft-ietf-ccamp-dwdm-if-param-yang-16 July 2026 +--ro sop-rate-of-change? | l0-types:decimal-5-or-unknown +--ro modulation-bias-x-i? | l0-types:decimal-2-or-unknown +--ro modulation-bias-x-q? | l0-types:decimal-2-or-unknown +--ro modulation-bias-y-i? | l0-types:decimal-2-or-unknown +--ro modulation-bias-y-q? | l0-types:decimal-2-or-unknown +--ro modulation-bias-x-phase? | l0-types:decimal-2-or-unknown +--ro modulation-bias-y-phase? | l0-types:decimal-2-or-unknown +--ro self-phase-modulation? | l0-types:decimal-2-or-unknown +--ro cross-phase-modulation? l0-types:decimal-2-or-unknown notifications: +---n wdm-if-tca +--ro if-name -> /if:interfaces/interface/name +--ro tca-type identityref +--ro tca-name string Appendix B. Threshold crossing example Identity: rx-power-tca ^ RX-Power | | .. | . . | ------.-----.-------------------------- raise-threshold | . | . | ----.---------.------------------------ clear-threshold | . | |. . . | ... | | .... . | | | . . | ---------------------.----------.------ clear-threshold | | | . .| | -----------------------.------.-------- raise-threshold | | | |.. .. | | | | | .. | +--------------------------------------------------------> High-RX-Power Low-RX-Power raise clear raise clear Galimberti, et al. Expires 4 January 2027 [Page 33] Internet-Draft draft-ietf-ccamp-dwdm-if-param-yang-16 July 2026 Figure 2: Example of Threshold crossing Threshold Crossing Alarm use a hysteresis mechanism. To avoid ambiguity and TCA flipping the rise and clear thresholds are always mandatory. A check on the proper value must be done carefully. E.g. the Low-RX-Power alarm has the raise-threshold < clear-threshold while the High-RX-Power alarm has raise-threshold > clear-threshold. Appendix C. Tree description - examples This section provides a simple description of the wdm-if Yang models through the tree representation. This model follows the indication of Network Management Datastore Architecture (NMDA) [RFC8342] whereby configured parameters are stored in the config datastore and operational parameters in the operational datastore. E.g. the tx-power is configurable and describes a target that can be set and read from the config datastore. The same parameter can be read from the operational datastore and in this case reports the transmit power that is actually transmitted as reported by the transceiver. The key model to start the description is the "wdm-if-templates", this augments the IETF general "/if:interfaces:" The leaves of this model represent and describe the most important wdm interface parameters covering the optical parameters and the electrical characteristics. The detailed description of the parameters is out of scope of this document and can be found in the referenced standard documents. An important parameter to identify the wdm interface capabilities and apply the proper provisioning is: Galimberti, et al. Expires 4 January 2027 [Page 34] Internet-Draft draft-ietf-ccamp-dwdm-if-param-yang-16 July 2026 +--rw wdm-interface +--ro supported-modes! | +--ro supported-mode* [mode-id] | +--ro mode-id string | +--ro (mode) | +--:(g.698.2) | | +--ro g.698.2 | | +--ro standard-mode standard-mode snipped | +--:(organizational-mode) | | +--ro organizational-mode | | +--ro operational-mode | | | operational-mode | | +--ro organization-identifier | | | organization-identifier snipped | +--:(explicit-mode) | +--ro explicit-mode The "supported-modes" is a list of the interface supported modes, they represent the transceiver capabilities. Each list element can be either a "standard-mode", an "organizational-mode" or an "explicit-mode". There are not limits to the list length. Only one element of the list can be selected to provision the transceiver using the model: +--rw wdm-interface +--ro supported-modes! | +--ro supported-mode* [mode-id] snipped +--rw configured-mode? union +--rw central-frequency? l0-types:frequency-thz +--rw line-coding-bitrate? identityref +--rw tx-channel-power? power-dbm-or-unknown snipped It is possible at any time to read the wdm interface status to verify the provisioning and the operational status: Galimberti, et al. Expires 4 January 2027 [Page 35] Internet-Draft draft-ietf-ccamp-dwdm-if-param-yang-16 July 2026 +--rw wdm-interface +--ro supported-modes! | +--ro supported-mode* [mode-id] snipped +--ro rx-channel-power? | power-dbm-or-unknown +--ro rx-total-power? | power-dbm-or-unknown +--ro tx-total-power? | l0-types:power-dbm-or-unknown +--ro cur-osnr? | l0-types:snr-or-unknown +--ro min-osnr-margin? | l0-types:snr-or-unknown +--ro q-margin? | l0-types:decimal-2-or-unknown +--ro q-factor? | l0-types:decimal-2-or-unknown +--ro fec-uncorrected-words? uint64 +--ro fec-uncorrectable-blocks? uint64 +--ro pre-fec-ber? | l0-types:decimal-18-or-unknown +--ro chromatic-dispersion? | l0-types:decimal-2-or-unknown +--ro polarization-mode-dispersion? | l0-types:decimal-2-or-unknown +--ro polarization-dependent-loss? | l0-types:power-loss-or-unknown +--ro tx-central-frequency-offset? | l0-types:frequency-ghz +--ro rx-central-frequency-offset? | l0-types:frequency-ghz +--ro laser-temperature? | l0-types:decimal-2-or-unknown +--ro diff-group-delay? | l0-types:decimal-2-or-unknown +--ro laser-bias-current? | l0-types:decimal-2-or-unknown +--ro modulation-error-ratio? | l0-types:power-ratio-or-unknown +--ro tx-variable-optical-attenuation? | l0-types:power-ratio-or-unknown +--ro rx-variable-optical-attenuation? | l0-types:power-ratio-or-unknown +--ro max-error-vector-magnitude? | l0-types:decimal-5-or-unknown Galimberti, et al. Expires 4 January 2027 [Page 36] Internet-Draft draft-ietf-ccamp-dwdm-if-param-yang-16 July 2026 +--ro rms-error-vector-magnitude? | l0-types:decimal-5-or-unknown +--ro second-order-polarization-mode-dispersion? | l0-types:decimal-5-or-unknown +--ro sop-rate-of-change? | l0-types:decimal-5-or-unknown +--ro modulation-bias-x-i? | l0-types:decimal-2-or-unknown +--ro modulation-bias-x-q? | l0-types:decimal-2-or-unknown +--ro modulation-bias-y-i? | l0-types:decimal-2-or-unknown +--ro modulation-bias-y-q? | l0-types:decimal-2-or-unknown +--ro modulation-bias-x-phase? | l0-types:decimal-2-or-unknown +--ro modulation-bias-y-phase? | l0-types:decimal-2-or-unknown +--ro self-phase-modulation? | l0-types:decimal-2-or-unknown +--ro cross-phase-modulation? l0-types:decimal-2-or-unknown Appendix D. Applicability examples As an example here below is the way an OpenZR+ compliant interface could be configured using the YANG models described in this document. The optical interface considered in this example is able to support OpenZR+ ("organizational-mode") at 400G High Power colorless. The interface also extend the OpenZR+ 400G-HB performance specification, hence also expose an explicit-mode with detailed specs that is fully compatible with OpenZR+. Both capability are exposed using the "wdw- if-template" container for the explicit mode, that is then reference in the "supported-mode" list together with the OpenZR+ "organizational-mode" The example also describes how the configuration section show (or allow to configure with write operation) the actual working mode of the interface, the carrier central frequency and the transmitter power. The JSON example below is enough to identify the interface capabilities and properly show the optical interface configuration: Galimberti, et al. Expires 4 January 2027 [Page 37] Internet-Draft draft-ietf-ccamp-dwdm-if-param-yang-16 July 2026 { "ietf-interfaces:interfaces": { "ietf-wdm-interface:wdm-if-templates": { "explicit-transceiver-modes": { "explicit-transceiver-mode": [ { "explicit-transceiver-mode-id": "VenA-400G-ZR+-HB", "bitrate": 400, "max-diff-group-delay": "50", "max-chromatic-dispersion": "22000", "cd-penalty": [ { "cd-value": "1000", "penalty-value": "0" }, { "cd-value": "20000", "penalty-value": "0.5" } ], "max-polarization-mode-dispersion": "20", "pmd-penalty": [ { "pmd-value": "20", "penalty-value": "0.5" } ], "max-polarization-dependent-loss": "3.5", "pdl-penalty": [ { "pdl-value": "3.0", "penalty-value": "1.3" }, { "pdl-value": "3.5", "penalty-value": "1.8" } ], "available-modulation-type": "ietf-layer0-types:dp-qam16", "min-osnr": "24.0", "rx-ref-channel-power": "-10.0", "available-baud-rate": "60138547000", "roll-off": "0.25", "min-carrier-spacing": "75", "available-fec-type": "ietf-layer0-types:c-fec", "in-band-osnr": "34", "out-of-band-osnr": "23" } Galimberti, et al. Expires 4 January 2027 [Page 38] Internet-Draft draft-ietf-ccamp-dwdm-if-param-yang-16 July 2026 ] } }, "interface": [ { "name": "Trunk-0/1", "description": "DWDM Trunk interface - slot0 port1", "type": "iana-if-type:opticalChannel", "admin-status": "up", "oper-status": "up", "if-index": 1234, "ietf-wdm-interface:wdm-interface": { "supported-modes": { "supported-mode": [ { "mode-id": "ZR400-OFEC-16QAM-HB", "organizational-mode": { "operational-mode": "ZR400-OFEC-16QAM-HB", "organization-identifier": "Open-ZR+", "transceiver-tuning-range": { "min-central-frequency": "191.275", "max-central-frequency": "196.125", "transceiver-tunability-granularity": "0.1" }, "tx-channel-power-min": "-4.0", "tx-channel-power-max": "1.0", "rx-channel-power-min": "-12" } }, { "mode-id": "VendorA-400G-ZR+-HB", "explicit-mode": { "transceiver-tuning-range": { "min-central-frequency": "191.275", "max-central-frequency": "196.125", "transceiver-tunability-granularity": "0.1" }, "tx-channel-power-min": "-4.0", "tx-channel-power-max": "1.0", "rx-channel-power-min": "-12.0", "compatible-modes": { "supported-organizational-mode": [ "Open-ZR+-400G-HB" ] }, "explicit-transceiver-mode-ref": "VenA-400G-ZR+-HB" } } Galimberti, et al. Expires 4 January 2027 [Page 39] Internet-Draft draft-ietf-ccamp-dwdm-if-param-yang-16 July 2026 ] }, "configured-mode": "VendorA-400G-ZR+-HB", "central-frequency": "193.100", "tx-channel-power": "-1.0" }, "statistics": { "discontinuity-time": "2026-06-26T14:00:00Z" } } ] } } Authors' Addresses Gabriele Galimberti (editor) Nokia Via Melgacciata 13 c 20813 - Bovisio Masciago Italy Phone: +393357481947 Email: ggalimbe56@gmail.com Dharini Hiremagalur HPE 1133 Innovation Way Sunnyvale - 94089 California, United States of America Email: dharini.hiremagalur@hpe.com Gert Grammel (editor) HPE Oskar-Schlemmer Str. 15 80807 Muenchen Germany Phone: +49 1725186386 Email: gert.grammel@hpe.com Roberto Manzotti (editor) Cisco Santa Maria Molgora 48 C 20871 Vimercate Italy Phone: +390392091280 Galimberti, et al. Expires 4 January 2027 [Page 40] Internet-Draft draft-ietf-ccamp-dwdm-if-param-yang-16 July 2026 Email: rmanzott@cisco.com Dirk Breuer DEUTSCHE TELEKOM AG Winterfeldtstr 21 10781 Berlin Germany Phone: +4930835358828 Email: d.breuer@telekom.de Galimberti, et al. Expires 4 January 2027 [Page 41]