<?xml version="1.0" encoding="utf-8"?>
  <?xml-stylesheet type="text/xsl" href="rfc2629.xslt" ?>
  <!-- generated by https://github.com/cabo/kramdown-rfc version 1.7.19 (Ruby 3.2.3) -->


<!DOCTYPE rfc  [
  <!ENTITY nbsp    "&#160;">
  <!ENTITY zwsp   "&#8203;">
  <!ENTITY nbhy   "&#8209;">
  <!ENTITY wj     "&#8288;">

]>

<?rfc comments="yes"?>

<rfc ipr="trust200902" docName="draft-ietf-ccamp-rfc9093-bis-12" category="std" consensus="true" submissionType="IETF" obsoletes="9093" tocInclude="true" sortRefs="true" symRefs="true">
  <front>
    <title abbrev="L0 Common YANG Types">Common YANG Data Types for Layer 0 Networks</title>

    <author initials="S." surname="Belotti" fullname="Sergio Belotti" role="editor">
      <organization>Nokia</organization>
      <address>
        <email>sergio.belotti@nokia.com</email>
      </address>
    </author>
    <author initials="I." surname="Busi" fullname="Italo Busi" role="editor">
      <organization>Huawei</organization>
      <address>
        <email>italo.busi@huawei.com</email>
      </address>
    </author>
    <author initials="D." surname="Beller" fullname="Dieter Beller" role="editor">
      <organization>Nokia</organization>
      <address>
        <email>dieter.beller@nokia.com</email>
      </address>
    </author>
    <author initials="E." surname="Le Rouzic" fullname="Esther Le Rouzic">
      <organization>Orange</organization>
      <address>
        <email>esther.lerouzic@orange.com</email>
      </address>
    </author>
    <author initials="A." surname="Guo" fullname="Aihua Guo">
      <organization>Futurewei Technologies</organization>
      <address>
        <email>aihuaguo.ietf@gmail.com</email>
      </address>
    </author>

    <date year="2024" month="December" day="04"/>

    
    <workgroup>CCAMP Working Group</workgroup>
    

    <abstract>


<?line 186?>

<t>This document defines a collection of common data types, identities, and groupings
in the YANG data modeling language. 
These common types and groupings, derived from the built-in YANG data types, identities,
and groupings are intended to be imported by modules that model Layer 0
configuration and state capabilities, such as Wavelength Switched Optical Networks (WSONs) and
flexi-grid Dense Wavelength Division Multiplexing (DWDM) networks.</t>

<t>This document obsoletes RFC 9093 by replacing the YANG module it contained with a new revision that includes additional YANG data types, identities and groupings.</t>



    </abstract>



  </front>

  <middle>


<?line 197?>

<section anchor="introduction"><name>Introduction</name>

<t>YANG <xref target="RFC7950"/> is a data modeling language used to model
   configuration data, state data, Remote Procedure Calls, and
   notifications for network management protocols such as the Network
   Configuration Protocol (NETCONF) <xref target="RFC6241"/>.  The YANG language
   supports a small set of built-in data types and provides mechanisms
   to derive other types from the built-in types.</t>

<t>This document introduces a collection of common data types derived
   from the built-in YANG data types.  The derived types and groupings
   are designed to be the common types applicable for modeling Traffic
   Engineering (TE) features as well as non-TE features (e.g., physical
   network configuration aspects) for Layer 0 optical networks in
   model(s) defined outside of this document.  The applicability of
   Layer 0 types specified in this document includes Wavelength Switched
   Optical Networks (WSONs) <xref target="RFC6163"/> <xref target="ITU-T_G.694.1"/> and <xref target="ITU-T_G.694.2"/>, and flexi-grid Dense
   Wavelength Division Multiplexing (DWDM) networks <xref target="RFC7698"/>
   <xref target="ITU-T_G.694.1"/>.</t>

<t>This document adds new type definitions to the YANG modules and
   obsoletes <xref target="RFC9093"/>.  For further details, see the revision
   statements of the YANG module in <xref target="yang-code"/> or the summary in
   <xref target="changes-bis"/>.</t>

<t>This document obsoletes <xref target="RFC9093"/> by replacing it in its entirety. It
provides a new revision of the YANG module contained in that RFC,
and retains the data types previously defined, but also adds new type
definitions to the YANG module.
For further details, see <xref target="changes-bis"/>.</t>

<t>The YANG data model in this document conforms to the Network
   Management Datastore Architecture defined in <xref target="RFC8342"/>.</t>

<section anchor="terminology-and-notations"><name>Terminology and Notations</name>

<t>Refer to <xref target="RFC7446"/> and <xref target="RFC7581"/> for the key terms used in this
   document, and the terminology for describing YANG data models can be
   found in <xref target="RFC7950"/>.</t>

<t>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 <xref target="RFC2119"/> <xref target="RFC8174"/> when, and only when, they
appear in all capitals, as shown here.
<?line -6?></t>

</section>
<section anchor="prefix-in-data-node-names"><name>Prefix in Data Node Names</name>

<t>In this document, names of data nodes and other data model objects
   are prefixed using the standard prefix associated with the
   corresponding YANG imported module.</t>

<texttable title="Prefixes and corresponding YANG module" anchor="tab-prefixes">
      <ttcol align='left'>Prefix</ttcol>
      <ttcol align='left'>YANG module</ttcol>
      <ttcol align='left'>Reference</ttcol>
      <c>te-types</c>
      <c>ietf-te-types</c>
      <c>[RFCYYYY]</c>
      <c>l0-types</c>
      <c>ietf-layer0-types</c>
      <c>RFC XXXX</c>
</texttable>

<ul empty="true"><li>
  <t>RFC Editor Note:
Please replace XXXX with the RFC number assigned to this document.
Please replace YYYY with the RFC number assigned to <xref target="I-D.ietf-teas-rfc8776-update"/>.
Please remove this note.</t>
</li></ul>

</section>
</section>
<section anchor="layer-0-types-module-contents"><name>Layer 0 Types Module Contents</name>

<t>This document defines a YANG module for common Layer 0 types, ietf-
   layer0-types.  This module is used for WSON and flexi-grid DWDM
   networks.  The "ietf-layer0-types" module contains the following YANG
   reusable YANG data types, identities and groupings:</t>

<dl>
  <dt>l0-grid-type:</dt>
  <dd>
    <t>A base YANG identity for the grid type as defined in <xref target="RFC6205"/> and <xref target="RFC7699"/>.</t>
  </dd>
  <dt>cwdm-ch-spc-type:</dt>
  <dd>
    <t>A base YANG identity for the Coarse Wavelength Division
Multiplexing (CWDM) channel-spacing type as defined in <xref target="RFC6205"/>.</t>
  </dd>
  <dt>dwdm-ch-spc-type:</dt>
  <dd>
    <t>A base YANG identity for the DWDM channel-spacing type as defined
in <xref target="RFC6205"/>.</t>
  </dd>
  <dt>flexi-ncfg-type:</dt>
  <dd>
    <t>A base YANG identity for the DWDM flexi-grid Nominal Central Frequency Granularity (NCFG) 
type as defined in <xref target="RFC7699"/>.</t>
  </dd>
</dl>

<ul empty="true"><li>
  <t>Note that the only value for NCFG standardized in <xref target="ITU-T_G.694.1"/> is 6.25GHz.</t>
</li></ul>

<dl>
  <dt>flexi-slot-width-granularity:</dt>
  <dd>
    <t>A base YANG identity for the DWDM flexi-grid Slot Width Granularity (SWG) type, as defined in <xref target="RFC7699"/>.</t>
  </dd>
  <dt/>
  <dd>
    <t>Note that the only value for SWG standardized in <xref target="ITU-T_G.694.1"/> is 12.5GHz.</t>
  </dd>
  <dt>fec-type:</dt>
  <dd>
    <t>A base YANG identity from which specific FEC (Forward Error Correction) type identities are derived.</t>
  </dd>
  <dt>line-coding:</dt>
  <dd>
    <t>A base YANG identity from which specific identities defining the bit rate/line coding of optical tributary signals are derived.</t>
  </dd>
  <dt>wavelength-assignment:</dt>
  <dd>
    <t>A base YANG identity from which for Wavelength selection method, as defined in <xref target="RFC7689"/>.</t>
  </dd>
  <dt>operational-mode:</dt>
  <dd>
    <t>A YANG data type used to identify an organization (e.g., vendor) specific mode for transceiver capability description, as defined in Section 2.5.2 of <xref target="I-D.ietf-ccamp-optical-impairment-topology-yang"/></t>
  </dd>
  <dt>wson-label-start-end:</dt>
  <dd>
    <t>The WSON label range was defined in <xref target="RFC6205"/>, and the generic
topology model defines the label-start/label-end in <xref target="RFC8795"/>.
This grouping shows the WSON-specific label-start and label-end
information. See <xref target="label-range"/> for more details.</t>
  </dd>
  <dt>wson-label-hop:</dt>
  <dd>
    <t>The WSON label range was defined in <xref target="RFC6205"/>, and the generic
topology model defines the label-hop in <xref target="RFC8795"/>.  This grouping
shows the WSON-specific label-hop information. See <xref target="label-range"/> for more details.</t>
  </dd>
  <dt>l0-label-range-info:</dt>
  <dd>
    <t>A YANG grouping that defines the Layer 0 label range information
applicable for WSON as defined in <xref target="RFC6205"/>. The label range info is defined per priority <xref target="RFC4203"/>.</t>
  </dd>
  <dt/>
  <dd>
    <t>This grouping is used in the flexi-grid DWDM by adding more flexi-grid-specific
parameters. See <xref target="label-range"/> for more details.</t>
  </dd>
  <dt>wson-label-step:</dt>
  <dd>
    <t>A YANG grouping that defines label steps for WSON as defined in
<xref target="I-D.ietf-teas-rfc8776-update"/>. See <xref target="label-range"/> for more details.</t>
  </dd>
  <dt>flexi-grid-label-start-end:</dt>
  <dd>
    <t>The flexi-grid label range was defined in <xref target="RFC7699"/>, and the
generic topology model defines the label-start/label-end in
<xref target="RFC8795"/>.</t>
  </dd>
  <dt/>
  <dd>
    <t>This grouping shows the flexi-grid-specific label-
start and label-end information which is used to describe the range of available nominal central frequencies. See <xref target="label-range"/> for more details.</t>
  </dd>
  <dt/>
  <dd>
    <t>As described in section 3.1 of <xref target="RFC8363"/>, the range of available nominal central frequencies are advertised for m=1, which means that for an available central frequency n, the frequency slot from central frequency n-1 to central frequency n+1 is available.</t>
  </dd>
  <dt>flexi-grid-label-hop:</dt>
  <dd>
    <t>The flexi-grid label range was defined in <xref target="RFC8363"/>, and the
generic topology model defines the label-hop in <xref target="RFC8795"/>.</t>
  </dd>
  <dt/>
  <dd>
    <t>This grouping shows the WSON-specific label-hop information. See <xref target="label-range"/> for more details.</t>
  </dd>
  <dt>flexi-grid-label-range-info:</dt>
  <dd>
    <t>A YANG grouping that defines flexi-grid label range information as
defined in <xref target="RFC8363"/>. See <xref target="label-range"/> for more details. See <xref target="label-range"/> for more details.</t>
  </dd>
  <dt>flexi-grid-label-step:</dt>
  <dd>
    <t>A YANG grouping that defines flexi-grid label steps as defined in
<xref target="I-D.ietf-teas-rfc8776-update"/>. See <xref target="label-range"/> for more details.</t>
  </dd>
  <dt>wdm-label-start-end:</dt>
  <dd>
    <t>A YANG grouping that combines the definition of label-start/label-end information
that was defined separately in wson-label-start-end and flexi-grid-label-start-end,
to support optical network scenarios that contain both fixed- and flexi-grid
links. See <xref target="label-range"/> for more details.</t>
  </dd>
  <dt>wdm-label-hop:</dt>
  <dd>
    <t>A YANG grouping that combines the definition of label hop information
that was defined separately in wson-label-hop and flexi-grid-label-hop,
to support optical network scenarios that contain both fixed- and flexi-grid
links. See <xref target="label-range"/> for more details.</t>
  </dd>
  <dt>wdm-label-range-info:</dt>
  <dd>
    <t>A YANG grouping that combines the definition of label range information
that was defined separately in wson-label-range-info and flexi-grid-label-range-info,
to support optical network scenarios that contain both fixed- and flexi-grid
links. See <xref target="label-range"/> for more details.</t>
  </dd>
  <dt>wdm-label-step:</dt>
  <dd>
    <t>A YANG grouping that combines the definition of label step information
defined separately in wson-label-step and flexi-grid-label-step,
to support optical network scenarios that contain both fixed- and flexi-grid
links. See <xref target="label-range"/> for more details.</t>
  </dd>
  <dt>transceiver-capabilities:</dt>
  <dd>
    <t>A YANG grouping to define the transceiver capabilities (also called
"modes") needed to determine optical signal compatibility.</t>
  </dd>
  <dt>standard-mode:</dt>
  <dd>
    <t>A YANG grouping for the standard modes defined in <xref target="ITU-T_G.698.2"/>.</t>
  </dd>
  <dt>organizational-mode:</dt>
  <dd>
    <t>A YANG grouping to define transponder operational mode supported by
organizations or vendors, as defined in <xref target="I-D.ietf-ccamp-optical-impairment-topology-yang"/>.</t>
  </dd>
  <dt>explicit-mode:</dt>
  <dd>
    <t>A YANG grouping to define the list of attributes related to optical
impairments limits in case of transceiver explicit mode, as defined in <xref target="I-D.ietf-ccamp-optical-impairment-topology-yang"/>.</t>
  </dd>
  <dt/>
  <dd>
    <t>Note that the the actual portion of the spectrum occupied by an OTSi is not explicitly reported within the explicit-mode parameters because it can be calculated using the available-baud-rate, the roll-off and the min-carrier-spacing attributes.</t>
  </dd>
  <dt>transmitter-tuning-range:</dt>
  <dd>
    <t>A YANG grouping that defines the transmitter tuning range, which
includes the minimum and maximum tuning frequency, as well as the
frequency tuning steps.</t>
  </dd>
  <dt>common-organizational-explicit-mode:</dt>
  <dd>
    <t>A YANG grouping to define the common capabilities attributes limit
range in case of operational mode and explicit mode.</t>
  </dd>
  <dt>modulation:</dt>
  <dd>
    <t>A base YANG identity to define the different modulation types, as defined in <xref target="ITU-T_G.Sup39"/></t>
  </dd>
  <dt>snr:</dt>
  <dd>
    <t>A YANG data type used to represent an (Optical) Signal to Noise Ratio measured over 0.1 nm resolution bandwidth, as defined in <xref target="ITU-T_G.977.1"/></t>
  </dd>
  <dt>psd:</dt>
  <dd>
    <t>A YANG data type used to represent a Power Spectral Density (PSD), as defined in <xref target="ITU-T_G.9700"/></t>
  </dd>
  <dt>penalty-value:</dt>
  <dd>
    <t>A YANG grouping to define the penalty value for multiple penalty types, such as Chromatic Dispersion (CD), Polarization Mode Dispersion (PMD), as defined in <xref target="ITU-T_G.666"/> or Polarization Dependent Loss(PDL)</t>
  </dd>
  <dt>switching-wson-lsc:</dt>
  <dd>
    <t>A YANG identity for the Wavelength Switched Optical Network Lambda-Switch Capable (WSON-LSC) interface switching capability as defined in <xref target="RFC7688"/>.</t>
  </dd>
  <dt>switching-flexi-grid-lsc:</dt>
  <dd>
    <t>A YANG identity for the Flexi-Grid Lambda-Switch Capable (Flexi-Grid-LSC) interface switching capability as defined in <xref target="RFC8363"/>.</t>
  </dd>
</dl>

<t>It is worth noting that there is an inheritance relationship between the Lambda-Switch Capable (LSC) switching capability, defined in <xref target="RFC3471"/>, and the WSON-LSC and Flexi-Grid-LSC, defined respectively in <xref target="RFC7688"/> and <xref target="RFC8363"/>. As a consequence, the 'switching-wson-lsc' and 'switching-flexi-grid-lsc' YANG identities are defined as derived identities from the 'switching-lsc', defined in <xref target="I-D.ietf-teas-rfc8776-update"/>.</t>

<section anchor="label-range"><name>WDM Label and Label Range</name>

<t>As described in <xref target="RFC6205"/> and <xref target="RFC7699"/>, the WDM label represents the frequency slot assigned to a WDM Label Switched Path (LSP) on a given WDM Link, which models an Optical Multiplex Section (OMS) Media Channel Group (MCG) as described in <xref target="I-D.ietf-ccamp-optical-impairment-topology-yang"/>.</t>

<t>The same WDM label shall be assigned to the same WDM LSP on all the WDM Links on a regen-free LSP path or path segment.</t>

<t>A frequency slot is defined in <xref target="ITU-T_G.694.1"/> as a contiguous frequency range characterized by its nominal central frequency and slot width. The frequency range allocated to a frequency slot is unavailable to other frequency slots.</t>

<t>The definition of the frequency slot depends on the WDM grid type:</t>

<t><list style="symbols">
  <t>In case of CWDM fixed-grid, defined in <xref target="ITU-T_G.694.2"/>, the frequency slot is defined by a fixed CWDM channel spacing (cwdm-ch-spc-type) and by the nominal central wavelength which is computed as described in <xref target="RFC6205"/>. The formula in <xref target="RFC6205"/> is copied here for reader convenience:</t>
</list></t>

<figure><artwork><![CDATA[
      lambda = 1471 nm + n * channel spacing (measured in nm)
]]></artwork></figure>

<ul empty="true"><li>
  <t>where 'n' is defined in <xref target="RFC6205"/> as integer (positive, negative, or 0)</t>
</li></ul>

<t><list style="symbols">
  <t>In case of DWDM fixed-grid, defined in <xref target="ITU-T_G.694.1"/>, the frequency slot is defined by a fixed DWDM channel spacing (dwdm-ch-spc-type) and by the nominal central frequency, which is computed as described in <xref target="RFC6205"/>. The formula in <xref target="RFC6205"/> is copied here for reader convenience:</t>
</list></t>

<figure><artwork><![CDATA[
      f = 193100.000 GHz + n * channel spacing (measured in GHz)
]]></artwork></figure>

<ul empty="true"><li>
  <t>where 'n' is defined in <xref target="RFC6205"/> as integer (positive, negative, or 0)</t>
</li></ul>

<t><list style="symbols">
  <t>In case of DWDM flexible-grid, defined in <xref target="ITU-T_G.694.1"/>, the frequency slot is defined by the slot width and by the nominal central frequency, which are computed, based on the slot width granularity (SWG, fixed at 12.5GHz in <xref target="ITU-T_G.694.1"/>), and of the nominal central frequency granularity (NCFG, fixed at 6.25GHz in <xref target="ITU-T_G.694.1"/>) respectively, as described in <xref target="RFC7698"/> and <xref target="RFC7699"/>. The formulas in <xref target="RFC7699"/> can be generalized as follows:</t>
</list></t>

<figure><artwork><![CDATA[
      SW = m * SWG (measured in GHz)
      f = 193100.000 GHz + N * NCFG (measured in GHz)
]]></artwork></figure>

<ul empty="true"><li>
  <t>where 'n' is defined in <xref target="RFC7699"/> as integer (positive, negative, or 0) and 'm' is defined in <xref target="RFC7698"/> as an integer greater than or equal to 1.</t>
</li></ul>

<t>The definition of the channel spacing, NCFG and SWG in the YANG model have been generalized to support modelling of vendor-specific values (e.g., finer vendor-specific granularity for NCFG and SWG).</t>

<t>The WDM Label Range represents the frequency slots that are available for WDM LSPs to be set up over a given WDM Link.</t>

<t>The WDM Label Range is defined by augmenting the label-restriction list, defined in <xref target="I-D.ietf-teas-rfc8776-update"/>, with WDM technology-specific attributes, using the l0-label-range-info grouping (for WSON only models) or the flexi-grid-label-range-info grouping (for DWDM flexible-grid only models) or the wdm-label-range-info grouping (for models that supports both WSON and DWDM flexible-grid).</t>

<t>Each entry in the label-restriction list represents either the range of the available central wavelength values (in case of CWDM fixed-grid) or the range of the available nominal central frequencies values (in case of DWDM fixed or flexible grids): the grid-type attribute defines the type of grid for each entry of the list.</t>

<t>In case of DWDM flexible grid, each entry in the label-restriction
list represents also the range of the supported slot width values
based on the following attributes, defined based on concepts used in <xref target="RFC7699"/>:</t>

<t><list style="symbols">
  <t>slot-width-granularity, which represents the minimum space between slot widths;</t>
  <t>min-slot-width-factor: a multiplier of the slot width granularity, indicating the minimum slot width supported by each entry in the label-restriction list;</t>
  <t>max-slot-width-factor: a multiplier of the slot width granularity, indicating the maximum slot width supported by each entry in the label-restriction list.</t>
</list></t>

<t>Each entry of the label-restriction list, as defined in <xref target="I-D.ietf-teas-rfc8776-update"/>, defines a label-start, a label-end, a label-step and a range-bitmap.</t>

<t>The label-start and label-end definitions, when used for representing WDM labe range, are augmented with WDM technology-specific attributes, using the wson-label-start-end grouping (for WSON only models) or the flexi-grid-label-start-end grouping (for DWDM flexible-grid only models) or the wdm-label-start-end grouping (for models that supports both WSON and DWDM flexible-grid).</t>

<t>The label-step definition, when used for representing WDM labe range, are augmented with WDM technology-specific attributes, using the wson-label-step grouping (for WSON only models) or the flexi-grid-label-step grouping (for DWDM flexible-grid only models) or the wdm-label-step grouping (for models that supports both WSON and DWDM flexible-grid). The label-step definition for WDM depends on the WDM grid type:</t>

<t><list style="symbols">
  <t>For CWDM and DWDM fixed grids, it describes the channel spacing, as defined in <xref target="RFC6205"/>;</t>
  <t>For DWDM flexible grids, it describes the nominal central frequency granularity (e.g., 6,25 GHz) as well as the multiplier for the supported values of n, as defined in <xref target="RFC7699"/>.</t>
</list></t>

</section>
</section>
<section anchor="yang-code"><name>YANG Module for Layer 0 Types</name>

<t>This YANG module references <xref target="RFC6205"/>, <xref target="RFC7689"/>, <xref target="RFC7699"/>, <xref target="RFC7698"/>, <xref target="RFC8363"/>, <xref target="RFC8363"/>, <xref target="RFC9093"/>, <xref target="ITU-T_G.666"/>, <xref target="ITU-T_G.694.1"/>, <xref target="ITU-T_G.694.2"/>, <xref target="ITU-T_G.698.2"/>, <xref target="ITU-T_G.709"/>, <xref target="ITU-T_G.709.2"/>, <xref target="ITU-T_G.709.3"/>, <xref target="ITU-T_G.959.1"/> <xref target="ITU-T_G.975"/>, <xref target="ITU-T_G.975.1"/>, <xref target="ITU-T_G.977.1"/>, <xref target="ITU-T_G.9700"/> and <xref target="OIF_400ZR"/>.</t>

<figure title="Layer 0 Types YANG module" anchor="fig-yang-code"><sourcecode type="yang" markers="true" name="ietf-layer0-types@2024-11-27.yang"><![CDATA[
module ietf-layer0-types {
  yang-version 1.1;
  namespace "urn:ietf:params:xml:ns:yang:ietf-layer0-types";
  prefix l0-types;

  import ietf-te-types {
    prefix te-types;
    reference
      "RFC YYYY: Common YANG Data Types for Traffic Engineering";
  }
  // RFC Editor: replace YYYY with actual RFC number assigned to 
  // [I-D.ietf-teas-rfc8776-update] and remove this note

  organization
    "IETF CCAMP Working Group";
  contact
    "WG Web:  <https://datatracker.ietf.org/wg/ccamp/>
     WG List: <mailto:ccamp@ietf.org>

     Editor:  Dieter Beller
              <mailto:Dieter.Beller@nokia.com>

     Editor:  Sergio Belotti
              <mailto:Sergio.Belotti@nokia.com>

     Editor:  Italo Busi
              <mailto:Italo.Busi@huawei.com>

     Editor:  Haomian Zheng
              <mailto:zhenghaomian@huawei.com>";
  description
    "This module defines Optical Layer 0 types.  This module
     provides groupings that can be applicable to Layer 0
     Fixed Optical Networks (e.g., CWDM (Coarse Wavelength
     Division Multiplexing) and DWDM (Dense Wavelength Division
     Multiplexing)) and flexi-grid optical networks.

     Copyright (c) 2024 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.: replace XXXX with actual RFC number and remove
// this note

// replace the revision date with the module publication date
// the format is (year-month-day)
  revision 2024-11-27 {
    description
      "To be updated";
    reference
      "RFC XXXX: A YANG Data Model for Layer 0 Types";
  }

  revision 2021-08-13 {
    description
      "Initial version";
    reference
      "RFC 9093: A YANG Data Model for Layer 0 Types";
  }

/*
 * Identities
 */

  identity l0-grid-type {
    description
      "Layer 0 grid type";
    reference
      "RFC 6205: Generalized Labels for Lambda-Switch-Capable 
      (LSC), Label Switching Routers,

       ITU-T G.694.2 (12/2003): Spectral grids for WDM applications:
       CWDM wavelength grid";
  }

    identity wson-grid-cwdm {
      base l0-grid-type;
      description
        "CWDM grid";
      reference
        "RFC 6205: Generalized Labels for Lambda-Switch-Capable (LSC)
        Label Switching Routers,

        ITU-T G.694.2 (12/2003): Spectral grids for WDM applications:
        CWDM wavelength grid";
    }

    identity wson-grid-dwdm {
      base l0-grid-type;
      description
        "DWDM grid";
      reference
        "RFC 6205: Generalized Labels for Lambda-Switch-Capable 
        (LSC), Label Switching Routers,

        ITU-T G.694.1 (10/2020): Spectral grids for WDM applications:
        DWDM frequency grid";
    }

    identity flexi-grid-dwdm {
      base l0-grid-type;
      description
        "Flexi-grid";
      reference
        "RFC 7699: Generalized Labels for the Flexi-Grid in Lambda
        Switch Capable (LSC) Label Switching Routers,

        ITU-T G.694.1 (10/2020): Spectral grids for WDM applications:
        DWDM frequency grid";
    }

  identity cwdm-ch-spc-type {
    description
      "CWDM channel-spacing type";
    reference
      "RFC 6205: Generalized Labels for Lambda-Switch-Capable (LSC)
       Label Switching Routers,
       
       ITU-T G.694.2 (12/2003): Spectral grids for WDM applications:
       CWDM wavelength grid";
  }

    identity cwdm-20nm {
      base cwdm-ch-spc-type;
      description
        "20nm channel spacing";
      reference
        "RFC 6205: Generalized Labels for Lambda-Switch-Capable (LSC)
        Label Switching Routers,
        
        ITU-T G.694.2 (12/2003): Spectral grids for WDM applications:
        CWDM wavelength grid";
    }

  identity dwdm-ch-spc-type {
    description
      "DWDM channel-spacing type";
    reference
      "RFC 6205: Generalized Labels for Lambda-Switch-Capable (LSC)
       Label Switching Routers,

       ITU-T G.694.1 (10/2020): Spectral grids for WDM applications:
       DWDM frequency grid";
  }

    identity dwdm-100ghz {
      base dwdm-ch-spc-type;
      description
        "100 GHz channel spacing";
      reference
        "RFC 6205: Generalized Labels for Lambda-Switch-Capable (LSC)
        Label Switching Routers,

        ITU-T G.694.1 (10/2020): Spectral grids for WDM applications:
        DWDM frequency grid";
    }

    identity dwdm-50ghz {
      base dwdm-ch-spc-type;
      description
        "50 GHz channel spacing";
      reference
        "RFC 6205: Generalized Labels for Lambda-Switch-Capable (LSC)
        Label Switching Routers,

        ITU-T G.694.1 (10/2020): Spectral grids for WDM applications:
        DWDM frequency grid";
    }

    identity dwdm-25ghz {
      base dwdm-ch-spc-type;
      description
        "25 GHz channel spacing";
      reference
        "RFC 6205: Generalized Labels for Lambda-Switch-Capable (LSC)
        Label Switching Routers,

        ITU-T G.694.1 (10/2020): Spectral grids for WDM applications:
        DWDM frequency grid";
    }

    identity dwdm-12p5ghz {
      base dwdm-ch-spc-type;
      description
        "12.5 GHz channel spacing";
      reference
        "RFC 6205: Generalized Labels for Lambda-Switch-Capable (LSC)
        Label Switching Routers,

        ITU-T G.694.1 (10/2020): Spectral grids for WDM applications:
        DWDM frequency grid";
    }

  identity flexi-ch-spc-type {
    status deprecated;
    description
      "Flexi-grid channel-spacing type";
  }

    identity flexi-ch-spc-6p25ghz {
      base flexi-ch-spc-type;
      status deprecated;
      description
        "6.25 GHz channel spacing";
    }

  identity flexi-ncfg-type {
    description
      "Flexi-grid Nominal Central Frequency Granularity (NCFG) 
      type";
    reference
      "RFC 7699: Generalized Labels for the Flexi-Grid in Lambda
      Switch Capable (LSC) Label Switching Routers,

      ITU-T G.694.1 (10/2020): Spectral grids for WDM applications:
      DWDM frequency grid";
  }

    identity flexi-ncfg-6p25ghz {
      base flexi-ncfg-type;
      description
        "6.25 GHz Nominal Central Frequency Granularity (NCFG)";
      reference
        "RFC 7699: Generalized Labels for the Flexi-Grid in Lambda
        Switch Capable (LSC) Label Switching Routers,

        ITU-T G.694.1 (10/2020): Spectral grids for WDM applications:
        DWDM frequency grid";
    }

  identity flexi-slot-width-granularity {
    description
      "Flexi-grid slot width granularity";
    reference
      "RFC 7699: Generalized Labels for the Flexi-Grid in Lambda
      Switch Capable (LSC) Label Switching Routers,

      ITU-T G.694.1 (10/2020): Spectral grids for WDM applications:
      DWDM frequency grid";
  }

    identity flexi-swg-12p5ghz {
      base flexi-slot-width-granularity;
      description
        "12.5 GHz slot width granularity";
      reference
        "RFC 7699: Generalized Labels for the Flexi-Grid in Lambda
        Switch Capable (LSC) Label Switching Routers,

        ITU-T G.694.1 (10/2020): Spectral grids for WDM applications:
        DWDM frequency grid";
    }

  identity modulation {
    description "base identity for modulation type";
  }

    identity DPSK {
      base modulation;
      description
        "DPSK (Differential Phase Shift Keying) modulation";
    }

    identity QPSK {
      base modulation;
      description
        "QPSK (Quadrature Phase Shift Keying) modulation";
    }

    identity DP-QPSK {
      base modulation;
      description
        "DP-QPSK (Dual Polarization Quadrature
        Phase Shift Keying) modulation";
    }

    identity QAM8 {
      base modulation;
      description
        "8QAM (8 symbols Quadrature Amplitude Modulation)";
    }

    identity DP-QAM8 {
      base modulation;
      description
        "DP-QAM8 (8 symbols Dual Polarization Quadrature Amplitude
        Modulation)";
    }

    identity QAM16 {
      base modulation;
      description
        "QAM16 (16 symbols Quadrature Amplitude Modulation)";
    }

    identity DP-QAM16 {
      base modulation;
      description
        "DP-QAM16 (16 symbols Dual Polarization Quadrature Amplitude 
        Modulation)";
    }

    identity QAM32 {
      base modulation;
      description
        "QAM32 (32 symbols Quadrature Amplitude Modulation)";
    }

    identity DP-QAM32 {
      base modulation;
      description
        "DP-QAM32 (32 symbols Dual Polarization Quadrature Amplitude
        Modulation)";
    }

    identity QAM64 {
      base modulation;
      description
        "QAM64 (64 symbols Quadrature Amplitude Modulation)";
    }

    identity DP-QAM64 {
      base modulation;
      description
        "DP-QAM64 (64 symbols Dual Polarization Quadrature Amplitude
        Modulation)";
    }

  identity fec-type {
    description
      "Base identity from which specific FEC
      (Forward Error Correction) type identities are derived.";
  }

    identity g-fec {
      base fec-type;
      description
        "Generic Forward Error Correction (G-FEC).";
      reference
        "ITU-T G.975 v2.0 (10/2000): Forward error correction for 
        submarine systems.";
    }

    identity super-fec {
      base fec-type;
      description
        "Super Forward Error Correction (S-FEC).";
      reference
        "ITU-T G.975.1 v1.2 (07/2013): Forward error correction for 
        high bit-rate DWDM submarine systems.";
    }

    identity no-fec {
      base fec-type;
      description
        "No FEC";
    }

    identity sc-fec {
      base fec-type;
      description
        "Staircase Forward Error Correction (SC-FEC).";
      reference
        "Annex A of ITU-T G.709.2 v1.1 (09/2020):OTU4 long-reach 
        interface.";
    }

    identity o-fec {
      base fec-type;
      description
        "Open Forward Error Correction (O-FEC) which reuses the 
        Bose, Chaudhuri and Hocquenghem (BCH) FEC.";
      reference
        "Clause 16.4.4 of ITU-T G.709.3 v2.1 (11/2022): Flexible OTN 
        long-reach interfaces;

        Annex E of ITU-T G.709.3 v2.1 (11/2022): Flexible OTN 
        long-reach interfaces.";
    }

    identity c-fec {
      base fec-type;
      description
        "Concatenated FEC (C-FEC) that combines an outer Staircase 
        Forward Error Correction (SC-FEC) code and an inner 
        double-extended SD-FEC (128,119) Hamming code.
        
        More details are provided in clause 15/G.709.3 where it is 
        called DSH instead of concatenated FEC.";
      reference
        "Annex A of ITU-T G.709.2 v1.1 (09/2020):OTU4 long-reach 
        interface;
        
        Annex D of ITU-T G.709.3 v2.1 (11/2022): Flexible OTN 
        long-reach interfaces;
        
        Clause 15 of ITU-T G.709.3 v2.1 (11/2022): Flexible OTN 
        long-reach interfaces.";
    }

  identity line-coding {
    description
      "Base identity to defined the bit rate/line coding of optical 
      tributary signals.";
    reference 
      "Section 7.1.2 of ITU-T G.698.2 v3.0 (11/2018).";
  }  

    identity line-coding-NRZ-2p5G {
      base line-coding;
      description
        "The non return to zero (NRZ) bit rate/line coding used by 
        the optical tributary signal class NRZ 2.5G";
      reference 
        "Section 3.2.6 of ITU-T G.959.1 v8.0 (07/2018).";
    }

    identity line-coding-NRZ-OTU1 {
      base line-coding;
      description
        "The non return to zero (NRZ) bit rate/line coding used by 
        the Optical channel Transport Unit order 1 (OTU1) optical 
        tributary signals";
      reference 
        "Section 7.2.1.2 of ITU-T G.959.1 v8.0 (07/2018).";
    }

    identity line-coding-NRZ-10G {
      description
        "The non return to zero (NRZ) bit rate/line coding used by 
        the optical tributary signal class NRZ 10G";
      reference 
        "Section 3.2.7 of ITU-T G.959.1 v8.0 (07/2018).";
    }

    identity line-coding-NRZ-OTU2 {
      base line-coding;
      description
        "The non return to zero (NRZ) bit rate/line coding used by 
        the Optical channel Transport Unit order 2 (OTU2) optical 
        tributary signals";
      reference 
        "Section 7.2.1.2 of ITU-T G.959.1 v8.0 (07/2018).";
    }

    identity line-coding-OTL4.4-SC {
      base line-coding;
      description
        "The bit rate/line coding used by optical tributary 
        signals carrying a 100G Optical Transport Unit order 4 
        (OTU4) with Staircase Forward Error Correction (SC FEC) 
        from a group of four Optical Transport Lanes (OTL).";
      reference 
        "Section 3.2.1 of ITU-T G.698.2 v3.0 (11/2018).";
    }

    identity line-coding-FOIC1.4-SC {
      base line-coding;
      description
        "The bit rate/line coding used by optical tributary signals 
        carrying a FlexO Interface of order C1 with 4 lanes 
        (FOIC1.1) with Staircase Forward Error Correction 
        (SC FEC).";
      reference 
        "Section 3.2.1 of ITU-T G.698.2 v3.0 (11/2018).";
    }

  identity wavelength-assignment {
    description
      "Wavelength selection base";
    reference
      "RFC 7689: Signaling Extensions for Wavelength Switched 
      Optical Networks";
  }

    identity first-fit-wavelength-assignment {
      base wavelength-assignment;
      description
        "All the available wavelengths are numbered,
        and this WA (Wavelength Assignment) method chooses
        the available wavelength with the lowest index";
      reference
        "RFC 7689: Signaling Extensions for Wavelength Switched 
        Optical Networks";
    }

    identity random-wavelength-assignment {
      base wavelength-assignment;
      description
        "This WA method chooses an available
        wavelength randomly";
      reference
        "RFC 7689: Signaling Extensions for Wavelength Switched 
        Optical Networks";
    }

    identity least-loaded-wavelength-assignment {
      base wavelength-assignment;
      description
        "This WA method selects the wavelength that
        has the largest residual capacity on the most loaded
        link along the route (in multi-fiber networks)";
      reference
        "RFC 7689: Signaling Extensions for Wavelength Switched 
        Optical Networks";
    }

    identity lower-first-wavelength-assignment {
      base wavelength-assignment;
      description
        "Allocate wavelengths in ascending order, beginning from the
        lowest frequency and progressing toward the highest frequency
        within the permissible frequency range.";
    }

    identity upper-first-wavelength-assignment {
      base wavelength-assignment;
      description
        "Allocate wavelengths in decending order, beginning from the
        highest frequency and progressing toward the lowest frequency
        within the permissible frequency range.";
    }

  identity type-power-mode {
    description
      "power equalization mode used within the 
       OMS and its elements";
  }

    identity power-spectral-density {
      base type-power-mode;
      description
        "all elements must use power spectral density (W/Hz)";
    }

    identity carrier-power {
      base type-power-mode;
      description
        "all elements must use power (dBm)";
    }

  identity switching-wson-lsc {
    base te-types:switching-lsc;
    description
      "Wavelength Switched Optical Network Lambda-Switch Capable
      (WSON-LSC).";
    reference
      "Section 3 of RFC 7688: GMPLS OSPF Enhancement for Signal and
      Network Element Compatibility for Wavelength Switched Optical
      Networks";
  }

  identity switching-flexi-grid-lsc {
    base te-types:switching-lsc;
    description
      "Flexi-grid Lambda-Switch Capable (Flexi-Grid-LSC).";
    reference
      "Section 4.1 of RFC 8363: GMPLS OSPF-TE Extensions in Support
      of Flexi-Grid Dense Wavelength Division Multiplexing (DWDM)
      Networks";
  }

/*
 * Typedefs
 */

  typedef dwdm-n {
    type int16;
    description
      "The given value 'N' is used to determine the nominal central
       frequency.

       The nominal central frequency, 'f', is defined by:
         f = 193100.000 GHz + N x channel spacing (measured in GHz),

       where 193100.000 GHz (193.100000 THz) is the ITU-T 'anchor
       frequency' for transmission over the DWDM grid, and where
       'channel spacing' is defined by the dwdm-ch-spc-type.";
    reference
      "RFC6205: Generalized Labels for Lambda-Switch-Capable (LSC)
       Label Switching Routers,

       ITU-T G.694.1 (10/2020): Spectral grids for WDM applications:
       DWDM frequency grid";
  }

  typedef cwdm-n {
    type int16;
    description
      "The given value 'N' is used to determine the nominal central
       wavelength.

       The nominal central wavelength is defined by:
         Wavelength = 1471 nm + N x channel spacing (measured in nm)

       where 1471 nm is the conventional 'anchor wavelength' for
       transmission over the CWDM grid, and where 'channel spacing'
       is defined by the cwdm-ch-spc-type.";
    reference
      "RFC 6205: Generalized Labels for Lambda-Switch-Capable (LSC)
       Label Switching Routers,

       ITU-T G.694.2 (12/2003): Spectral grids for WDM applications:
       CWDM wavelength grid";
  }

  typedef flexi-n {
    type int16;
    description
      "The given value 'N' is used to determine the nominal central
       frequency.

       The nominal central frequency, 'f', is defined by:
         f = 193100.000 GHz + N x NCFG (measured in GHz),

       where 193100.000 GHz (193.100000 THz) is the ITU-T 'anchor
       frequency' for transmission over the DWDM grid, and where
       NCFG is defined by the flexi-ncfg-type, or by the deprecated 
       flexi-ch-spc-type.";
    reference
      "RFC 7699: Generalized Labels for the Flexi-Grid in Lambda
      Switch Capable (LSC) Label Switching Routers,

       ITU-T G.694.1 (10/2020): Spectral grids for WDM applications:
       DWDM frequency grid";
  }

  typedef flexi-m {
    type uint16;
    description
      "The given value 'M' is used to determine the slot width.

       A slot width is defined by:
         slot width = M x SWG (measured in GHz),

       where SWG is defined by the flexi-slot-width-granularity.";
    reference
      "RFC 7699: Generalized Labels for the Flexi-Grid in Lambda
      Switch Capable (LSC) Label Switching Routers,

       ITU-T G.694.1 (10/2020): Spectral grids for WDM applications:
       DWDM frequency grid";
  }

  typedef standard-mode {
    type string;
    description
      "Identifies an ITU-T G.698.2 standard application code.

      It MUST be a string with a format that follows the 
      nomenclature defined in section 5.3 of ITU-T G.698.2.";
    reference
      "ITU-T G.698.2 (11/2018)";
  }

  typedef organization-identifier {
    type string;
    description
      "vendor/organization identifier that uses a private mode
      out of already defined in G.698.2 ITU-T application-code";
    reference
      "Section 2.5.2 of RFC YYYY: A YANG Data Model for Optical
      Impairment-aware Topology.";
  }
// RFC Ed.: replace YYYY with actual RFC number and remove
// this note after draft-ietf-ccamp-optical-impairment-topology-yang
// is published as an RFC

  typedef operational-mode {
    type string;
    description
      "Identifies an organization (e.g., vendor) specific mode.
      
      The format of the string has to be defined by the 
      organization which is responsible for defining the 
      corresponding optical interface specification.";
    reference
      "Section 2.5.2 of RFC YYYY: A YANG Data Model for Optical
      Impairment-aware Topology.";
  }
// RFC Ed.: replace YYYY with actual RFC number and remove
// this note after draft-ietf-ccamp-optical-impairment-topology-yang
// is published as an RFC

  typedef frequency-thz {
    type decimal64 {
      fraction-digits 9;
    }
    units "THz";
    description
      "The DWDM frequency in THz, e.g., 193.112500000";
  }

  typedef frequency-ghz {
    type decimal64 {
      fraction-digits 6;
    }
    units "GHz";
    description
      "The DWDM frequency in GHz, e.g., 193112.500000";
  }    

  typedef snr {
    type decimal-2;
    units "dB@0.1nm";
    description
      "(Optical) Signal to Noise Ratio measured over 0.1 nm
      resolution bandwidth";
    reference
      "ITU-T G.977.1 (02/2021): Transverse compatible dense
      wavelength division multiplexing applications for repeatered
      optical fibre submarine cable systems";
  }

  typedef snr-or-null {
    type union {
      type snr;
      type empty;
    }
    description
      "(Optical) Signal to Noise Ratio measured over 0.1 nm
      resolution bandwidth, when known, or an empty value when
      unknown.";
  }

  typedef fiber-type {
    type enumeration {
      enum G.652 {
        description
          "G.652 Standard Singlemode Fiber";                 
      }
      enum G.654 {
        description
          "G.654 Cutoff Shifted Fiber";
      }
      enum G.653 {
        description "G.653 Dispersion Shifted Fiber";
      }
      enum G.655 {
        description "G.655 Non-Zero Dispersion Shifted Fiber";
      }
      enum G.656 {
        description
          "G.656 Non-Zero Dispersion for Wideband Optical Transport";
      }
      enum G.657 {
        description
          "G.657 Bend-Insensitive Fiber";
      }
    }
    description
      "ITU-T based fiber-types";
  }

  typedef decimal-2 {
    type decimal64 {
      fraction-digits 2;
    }
    description
      "A decimal64 value with two digits.";
  }

  typedef decimal-2-or-null {
    type union {
      type decimal-2;
      type empty;
    }
    description
      "A decimal64 value with two digits, when the value is known or
      an empty value when the value is not known.";
  }

  typedef power-gain {
    type decimal-2 {
      range "0..max";
    }
    units "dB";
    description
      "The gain in dB.";
  }

  typedef power-gain-or-null {
    type union {
      type power-gain;
      type empty;
    }
    description
      "The gain in dB, when it is known or an empty 
      value when the power gain/loss is not known.";
  }

  typedef power-loss {
    type decimal-2 {
      range "0..max";
    }
    units "dB";
    description
      "The power attenuation in dB.";
  }

  typedef power-loss-or-null {
    type union {
      type power-loss;
      type empty;
    }
    description
      "The power attenuation in dB, when it is known or an empty 
      value when the loss is not known.";
  }

  typedef power-ratio {
    type decimal-2;
    units "dB";
    description
      "The power difference in dB.";
  }

  typedef power-ratio-or-null {
    type union {
      type power-ratio;
      type empty;
    }
    description
      "The power difference in dB, when it is known or an empty 
      value when the difference is not known.";
  }

  typedef power-dbm {
    type decimal-2;
    units "dBm";
    description
      "The power in dBm.";
  }

  typedef power-dbm-or-null {
    type union {
      type power-dbm;
      type empty;
    }
    description
      "The power in dBm, when it is known or an empty value when the
      power is not known.";
  }

  typedef decimal-5 {
    type decimal64 {
      fraction-digits 5;
    }
    description
      "A decimal64 value with five digits.";
  }

  typedef decimal-5-or-null {
    type union {
      type decimal-5;
      type empty;
    }
    description
      "A decimal64 value with five digits, when the value is known 
      or an empty value when the value is not known.";
  }

  typedef psd {
    type decimal64 {
      fraction-digits 16;
    }
    units "W/Hz";
    description
      "The power spectral density (PSD).
      
      Typical value : 3.9 E-14, resolution 0.1nW/MHz.";
    reference
      "ITU-T G.9700 (07/2019): Fast access to subscriber terminals
      (G.fast) - Power spectral density specification";
  }

  typedef psd-or-null {
    type union {
      type psd;
      type empty;
    }
    description
      "The power spectral density (PSD), when it is known or an
      empty value when the PSD is not known.";
  }

  typedef decimal-18 {
    type decimal64 {
      fraction-digits 18;
    }
    description
      "A decimal64 value with eighteen digits.";
  }

  typedef decimal-18-or-null {
    type union {
      type decimal-18;
      type empty;
    }
    description
      "A decimal64 value with eighteen digits, when the value is
      known or an empty value when the value is not known.";
  }

/*
 * Groupings
 */

  grouping wdm-label-start-end {
    description
      "The WDM label-start or label-end used to specify DWDM and
       CWDM label range.";

    choice grid-type {
      description
        "Label for fixed & flexi-DWDM or CWDM grid";
      case fixed-dwdm {
        leaf dwdm-n {
          when "derived-from-or-self(../../../grid-type,
                \"wson-grid-dwdm\")" {
            description
              "Valid only when grid type is DWDM.";
          }
          type l0-types:dwdm-n;
          description
            "The given value 'N' is used to determine the
             nominal central frequency.";
          reference
            "RFC 6205: Generalized Labels for Lambda-Switch-Capable
             (LSC) Label Switching Routers";
        }
      }
      case cwdm {
        leaf cwdm-n {
          when "derived-from-or-self(../../../grid-type,
                \"wson-grid-cwdm\")" {
            description
              "Valid only when grid type is CWDM.";
          }
          type l0-types:cwdm-n;
          description
            "The given value 'N' is used to determine the nominal
             central wavelength.";
          reference
            "RFC 6205: Generalized Labels for Lambda-Switch-Capable
             (LSC) Label Switching Routers";
        }
      }
      case flexi-grid {
        uses l0-types:flexi-grid-label-start-end;
      }
    }
    reference
      "RFC 6205: Generalized Labels for Lambda-Switch-Capable (LSC)
       Label Switching Routers";
  }

  grouping wdm-label-step {
    description
      "Label step information for fixed & flexi-DWDM or CWDM grid";
    choice l0-grid-type {
      description
        "Grid type: DWDM, CWDM, etc.";
      case fixed-dwdm {
        leaf wson-dwdm-channel-spacing {
          when "derived-from-or-self(../../grid-type,
                \"wson-grid-dwdm\")" {
            description
              "Valid only when grid type is DWDM.";
          }
          type identityref {
            base dwdm-ch-spc-type;
          }
          description
            "Label-step is the channel spacing (GHz), e.g., 100.000,
             50.000, 25.000, or 12.500 GHz for DWDM.";
          reference
            "RFC 6205: Generalized Labels for Lambda-Switch-Capable
             (LSC) Label Switching Routers";
        }
      }
      case cwdm {
        leaf wson-cwdm-channel-spacing {
          when "derived-from-or-self(../../grid-type,
                \"wson-grid-cwdm\")" {
            description
              "Valid only when grid type is CWDM.";
          }
          type identityref {
            base cwdm-ch-spc-type;
          }
          description
            "Label-step is the channel spacing (nm), i.e., 20 nm
             for CWDM, which is the only value defined for CWDM.";
          reference
            "RFC 6205: Generalized Labels for Lambda-Switch-Capable
             (LSC) Label Switching Routers";
        }
      }
      case flexi-grid {
        uses flexi-grid-label-step;
      }
    }
    reference
      "RFC 6205: Generalized Labels for Lambda-Switch-Capable (LSC)
       Label Switching Routers,
       ITU-T G.694.2 (12/2003): Spectral grids for WDM applications:
       CWDM wavelength grid,
       RFC 8363: GMPLS OSPF-TE Extensions in Support of Flexi-Grid
       Dense Wavelength Division Multiplexing (DWDM) Networks";
  }

  grouping wdm-label-hop {
    description
      "Generic label-hop information for fixed & flexi-DWDM or
       CWDM grid";
    choice grid-type {
      description
        "Label for DWDM or CWDM grid";
      case fixed-dwdm {
        choice fixed-single-or-super-channel {
          description
            "single or super channel";
          case single {
            leaf dwdm-n {
              type l0-types:dwdm-n;
              description
                "The given value 'N' is used to determine the
                 nominal central frequency.";
            }
          }
          case multi {
            leaf-list subcarrier-dwdm-n {
              type l0-types:dwdm-n;
              min-elements 2;
              description
                "The given values 'N' are used to determine the
                 nominal central frequency for each subcarrier
                 channel.";
              reference
                "ITU-T G.694.1 (10/2020): Spectral grids for WDM
                applications: DWDM frequency grid";
            }
          }
        }
      }
      case cwdm {
        leaf cwdm-n {
          type l0-types:cwdm-n;
          description
            "The given value 'N' is used to determine the nominal
             central wavelength.";
          reference
            "RFC 6205: Generalized Labels for Lambda-Switch-Capable
             (LSC) Label Switching Routers";
        }
      }
      case flexi-grid {
        uses l0-types:flexi-grid-label-hop;
      }
    }
    reference
      "RFC 6205: Generalized Labels for Lambda-Switch-Capable (LSC)
       Label Switching Routers";
  }

  grouping wdm-label-range-info {
    description
      "WDM label range related information";
    uses l0-label-range-info;
    container flexi-grid {
      when "derived-from-or-self(../grid-type,
          \"flexi-grid-dwdm\")" {
        description
          "Applicable only when the grid type is flexi-grid-dwdm.";
      }
      description
        "flexi-grid definition";
      leaf slot-width-granularity {
        type identityref {
          base flexi-slot-width-granularity;
        }
        default "flexi-swg-12p5ghz";
        description
          "Minimum space between slot widths. Default is 12.500
           GHz.";
        reference
          "RFC 7698: Framework and Requirements for GMPLS-Based
           Control of Flexi-Grid Dense Wavelength Division
           Multiplexing (DWDM) Networks";
      }
      leaf min-slot-width-factor {
        type uint16 {
          range "1..max";
        }
        default "1";
        description
          "A multiplier of the slot width granularity, indicating
           the minimum slot width supported by an optical port.

           Minimum slot width is calculated by:
             Minimum slot width (GHz) =
               min-slot-width-factor * slot-width-granularity.";
        reference
          "RFC 8363: GMPLS OSPF-TE Extensions in Support of Flexi-
           Grid Dense Wavelength Division Multiplexing (DWDM)
           Networks";
      }
      leaf max-slot-width-factor {
        type uint16 {
          range "1..max";
        }
        must '. >= ../min-slot-width-factor' {
          error-message
            "Maximum slot width must be greater than or equal to
             minimum slot width.";
        }
        description
          "A multiplier of the slot width granularity, indicating
           the maximum slot width supported by an optical port.

           Maximum slot width is calculated by:
             Maximum slot width (GHz) =
               max-slot-width-factor * slot-width-granularity

           If specified, maximum slot width must be greater than or
           equal to minimum slot width.  If not specified, maximum
           slot width is equal to minimum slot width.";
        reference
          "RFC 8363: GMPLS OSPF-TE Extensions in Support of Flexi-
           Grid Dense Wavelength Division Multiplexing (DWDM)
           Networks";
      }
    }
  }

  grouping wson-label-start-end {
    description
      "The WSON label-start or label-end used to specify WSON label
       range.";
    choice grid-type {
      description
        "Label for DWDM or CWDM grid";
      case dwdm {
        leaf dwdm-n {
          when "derived-from-or-self(../../../grid-type,
                \"wson-grid-dwdm\")" {
            description
              "Valid only when grid type is DWDM.";
          }
          type l0-types:dwdm-n;
          description
            "The central frequency of DWDM.";
          reference
            "RFC 6205: Generalized Labels for Lambda-Switch-Capable
             (LSC) Label Switching Routers";
        }
      }
      case cwdm {
        leaf cwdm-n {
          when "derived-from-or-self(../../../grid-type,
                \"wson-grid-cwdm\")" {
            description
              "Valid only when grid type is CWDM.";
          }
          type l0-types:cwdm-n;
          description
            "Channel wavelength computing input.";
          reference
            "RFC 6205: Generalized Labels for Lambda-Switch-Capable
             (LSC) Label Switching Routers";
        }
      }
    }
    reference
      "RFC 6205: Generalized Labels for Lambda-Switch-Capable (LSC)
       Label Switching Routers";
  }

  grouping wson-label-hop {
    description
      "Generic label-hop information for WSON";
    choice grid-type {
      description
        "Label for DWDM or CWDM grid";
      case dwdm {
        choice single-or-super-channel {
          description
            "single or super channel";
          case single {
            leaf dwdm-n {
              type l0-types:dwdm-n;
              description
                "The given value 'N' is used to determine the
                 nominal central frequency.";
            }
          }
          case super {
            leaf-list subcarrier-dwdm-n {
              type l0-types:dwdm-n;
              description
                "The given values 'N' are used to determine the
                 nominal central frequency for each subcarrier
                 channel.";
              reference
                "ITU-T G.694.1 (10/2020): Spectral grids for WDM
                applications: DWDM frequency grid";
            }
          }
        }
      }
      case cwdm {
        leaf cwdm-n {
          type l0-types:cwdm-n;
          description
            "The given value 'N' is used to determine the nominal
             central wavelength.";
          reference
            "RFC 6205: Generalized Labels for Lambda-Switch-Capable
             (LSC) Label Switching Routers";
        }
      }
    }
    reference
      "RFC 6205: Generalized Labels for Lambda-Switch-Capable (LSC)
       Label Switching Routers";
  }

  grouping l0-label-range-info {
    description
      "Information about Layer 0 label range.";
    leaf grid-type {
      type identityref {
        base l0-grid-type;
      }
      description
        "Grid type";
    }
    leaf priority {
      type uint8;
      description
        "Priority in Interface Switching Capability Descriptor
         (ISCD).";
      reference
        "RFC 4203: OSPF Extensions in Support of Generalized
         Multi-Protocol Label Switching (GMPLS)";
    }
    reference
      "RFC 6205: Generalized Labels for Lambda-Switch-Capable (LSC)
       Label Switching Routers";
  }

  grouping wson-label-step {
    description
      "Label step information for WSON";
    choice l0-grid-type {
      description
        "Grid type: DWDM, CWDM, etc.";
      case dwdm {
        leaf wson-dwdm-channel-spacing {
          when "derived-from-or-self(../../grid-type,
                \"wson-grid-dwdm\")" {
            description
              "Valid only when grid type is DWDM.";
          }
          type identityref {
            base dwdm-ch-spc-type;
          }
          description
            "Label-step is the channel spacing (GHz), e.g., 100.000,
             50.000, 25.000, or 12.500 GHz for DWDM.";
          reference
            "RFC 6205: Generalized Labels for Lambda-Switch-Capable
             (LSC) Label Switching Routers";
        }
      }
      case cwdm {
        leaf wson-cwdm-channel-spacing {
          when "derived-from-or-self(../../grid-type,
                \"wson-grid-cwdm\")" {
            description
              "Valid only when grid type is CWDM.";
          }
          type identityref {
            base cwdm-ch-spc-type;
          }
          description
            "Label-step is the channel spacing (nm), i.e., 20 nm
             for CWDM, which is the only value defined for CWDM.";
          reference
            "RFC 6205: Generalized Labels for Lambda-Switch-Capable
             (LSC) Label Switching Routers";
        }
      }
    }
    reference
      "RFC 6205: Generalized Labels for Lambda-Switch-Capable (LSC)
       Label Switching Routers,

       ITU-T G.694.2 (12/2003): Spectral grids for WDM applications:
       CWDM wavelength grid";
  }

  grouping flexi-grid-label-start-end {
    description
      "The flexi-grid label-start or label-end used to specify
       flexi-grid label range.";
    leaf flexi-n {
      type l0-types:flexi-n;
      description
        "The given value 'N' is used to determine the nominal
        central frequency.

        As described in section 3.1 of RFC 8363, the range of 
        available nominal central frequencies are advertised for 
        m=1, which means that for an available central frequency n, 
        the frequency slot from central frequency n-1 to central 
        frequency n+1 is available.";
    }
    reference
      "RFC 7699: Generalized Labels for the Flexi-Grid in Lambda
      Switch Capable (LSC) Label Switching Routers,
      
      RFC 8363: GMPLS OSPF-TE Extensions in Support of Flexi-Grid 
      Dense Wavelength Division Multiplexing (DWDM) Networks";
  }

  grouping flexi-grid-frequency-slot {
    description
      "Flexi-grid frequency slot grouping.";
    uses flexi-grid-label-start-end;
    leaf flexi-m {
      type l0-types:flexi-m;
      description
        "The given value 'M' is used to determine the slot width.";
    }
    reference
      "RFC 7699: Generalized Labels for the Flexi-Grid in Lambda
      Switch Capable (LSC) Label Switching Routers";
  }

  grouping flexi-grid-label-hop {
    description
      "Generic label-hop information for flexi-grid";
    choice single-or-super-channel {
      description
        "single or super channel";
      case single {
        uses flexi-grid-frequency-slot;
      }
      case super {
        status deprecated;
        list subcarrier-flexi-n {
          key "flexi-n";
          status deprecated;
          uses flexi-grid-frequency-slot {
            status deprecated;
          }
          description
            "List of subcarrier channels for flexi-grid super
             channel.";
        }
      }
      case multi {
        container frequency-slots {
          description
            "The top level container for the list of frequency 
            slots used for flexi-grid super channel.";
          list frequency-slot {
            key "flexi-n";
            min-elements 2;
            uses flexi-grid-frequency-slot;
            description
              "List of frequency slots used for flexi-grid super 
              channel.";
          }
        }
      }
    }
    reference
      "RFC 8363: GMPLS OSPF-TE Extensions in Support of Flexi-Grid 
      Dense Wavelength Division Multiplexing (DWDM) Networks";
  }

  grouping flexi-grid-label-range-info {
    description
      "Flexi-grid-specific label range related information";
    uses l0-label-range-info;
    container flexi-grid {
      description
        "flexi-grid definition";
      leaf slot-width-granularity {
        type identityref {
          base flexi-slot-width-granularity;
        }
        default "flexi-swg-12p5ghz";
        description
          "Minimum space between slot widths. Default is 12.500
           GHz.";
        reference
          "RFC 8363: GMPLS OSPF-TE Extensions in Support of 
          Flexi-Grid Dense Wavelength Division Multiplexing (DWDM) 
          Networks";
      }
      leaf min-slot-width-factor {
        type uint16 {
          range "1..max";
        }
        default "1";
        description
          "A multiplier of the slot width granularity, indicating
           the minimum slot width supported by an optical port.

           Minimum slot width is calculated by:
             Minimum slot width (GHz) =
               min-slot-width-factor * slot-width-granularity.";
        reference
          "RFC 8363: GMPLS OSPF-TE Extensions in Support of Flexi-
           Grid Dense Wavelength Division Multiplexing (DWDM)
           Networks";
      }
      leaf max-slot-width-factor {
        type uint16 {
          range "1..max";
        }
        must '. >= ../min-slot-width-factor' {
          error-message
            "Maximum slot width must be greater than or equal to
             minimum slot width.";
        }
        description
          "A multiplier of the slot width granularity, indicating
           the maximum slot width supported by an optical port.

           Maximum slot width is calculated by:
             Maximum slot width (GHz) =
               max-slot-width-factor * slot-width-granularity

           If specified, maximum slot width must be greater than or
           equal to minimum slot width.  If not specified, maximum
           slot width is equal to minimum slot width.";
        reference
          "RFC 8363: GMPLS OSPF-TE Extensions in Support of Flexi-
           Grid Dense Wavelength Division Multiplexing (DWDM)
           Networks";
      }
    }
  }

  grouping flexi-grid-label-step {
    description
      "Label step information for flexi-grid";
    leaf flexi-grid-channel-spacing {
      type identityref {
        base flexi-ch-spc-type;
      }
      default "flexi-ch-spc-6p25ghz";
      status deprecated;
      description
        "Label-step is the nominal central frequency granularity
         (GHz), e.g., 6.25 GHz.";
      reference
        "RFC 7699: Generalized Labels for the Flexi-Grid in Lambda
         Switch Capable (LSC) Label Switching Routers";
    }
    leaf flexi-ncfg {
      type identityref {
        base flexi-ncfg-type;
      }
      default "flexi-ncfg-6p25ghz";
      description
        "Label-step is the nominal central frequency granularity
         (GHz), e.g., 6.25 GHz.";
      reference
        "RFC 7699: Generalized Labels for the Flexi-Grid in Lambda
         Switch Capable (LSC) Label Switching Routers";
    }
    leaf flexi-n-step {
      type uint8;
      description
        "This attribute defines the multiplier for the supported
         values of 'N'.

         For example, given a grid with a nominal central frequency
         granularity of 6.25 GHz, the granularity of the supported
         values of the nominal central frequency could be 12.5 GHz.
         In this case, the values of flexi-n should be even and this
         constraint is reported by setting the flexi-n-step to 2.

         This attribute is also known as central frequency
         granularity in RFC 8363.";
      reference
        "RFC 8363: GMPLS OSPF-TE Extensions in Support of Flexi-Grid
         Dense Wavelength Division Multiplexing (DWDM) Networks";
    }
  }

  grouping transceiver-mode {
    description
      "This grouping is intended to be used for reporting the
      information of a transceiver's mode.

      The attributes for the explicit mode shall be augmented when
      used with either:
      - the proper leafrefs, when explicit mode templates are used;
        or,
      - the explicit-mode grouping, when explicit mode templates
        are not used.

      The compatible-modes container shall be augmented with the 
      proper leafrefs when used: see for example the 
      transceiver-capabilities grouping below.";
    choice mode {
      config false;
      mandatory true;
      description
        "Indicates whether the transceiver's mode is a standard
          mode, an organizational mode or an explicit mode.";
      case G.698.2 {
        uses standard-mode;
        uses common-standard-organizational-mode;
        uses common-all-modes;
      }
      case organizational-mode {
        container organizational-mode {
          config false;
          description
            "The set of attributes for an organizational mode";
          uses organizational-mode;
          uses common-standard-organizational-mode;
          uses common-all-modes;
        }  // container organizational-mode
      }
      case explicit-mode {
        container explicit-mode {
          config false;
          description
            "The set of attributes for an explicit mode";
          // uses explicit-mode;
          uses common-all-modes;
          container compatible-modes {
            description
              "Container for all the standard and organizational
                modes supported by the transceiver's explicit
                mode.";
          }  // container compatible-modes
        }  // container explicit-mode
      } // end of case explicit-mode
    } // end of choice
  }

  grouping transceiver-capabilities {
    description
      "This grouping is intended to be used for reporting the
      capabilities of a transceiver.
      
      The attributes for the explicit mode shall be augmented when
      used with either:
      - the proper leafrefs, when explicit mode templates are used;
        or,
      - the explicit-mode grouping, when explicit mode templates
        are not used.";

    container supported-modes {
      presence
        "When present, it indicates that the modes supported by a 
        transceiver are reported.";
      config false;
      description
        "The top level container for the list supported 
        transceiver's modes.";
      list supported-mode {
        key "mode-id";
        config false;
        min-elements 1;
        description "The list of supported transceiver's modes.";
        leaf mode-id {
          type string { 
            length "1..255";
          }
          description "ID for the supported transceiver's mode.";
        }
        uses transceiver-mode {
          augment "mode/explicit-mode/explicit-mode/"
                + "compatible-modes" {
            description
              "Augments the compatible modes with the proper 
              leafrefs.";
            leaf-list supported-application-codes {
              type leafref {
                path "../../../../supported-mode/mode-id";
              }
              must "../../../../"
                  + "supported-mode[mode-id=current()]/"
                  + "standard-mode" {
                description
                  "The pointer is only for application codes
                  supported by transceiver."; 
              }
              description
                "List of pointers to the application codes
                supported by the transceiver's explicit mode.";
            }
            leaf-list supported-organizational-modes {
              type leafref {
                path "../../../../supported-mode/mode-id";
              }
              must "../../../../"
                  + "supported-mode[mode-id=current()]/"
                  + "organizational-mode" {
                description
                  "The pointer is only for organizational modes
                  supported by transceiver.";
              }
              description
                "List of pointers to the organizational modes
                  supported by the transceiver's explicit mode.";
            }
          }
        }
      }  // list supported-modes
    }  // container supported-modes
  }  // grouping transceiver-capabilities

  grouping standard-mode {
    description
      "ITU-T G.698.2 standard mode that guarantees interoperability.
       It must be an string with the following format:
       B-DScW-ytz(v) where all these attributes are conformant
       to the ITU-T recomendation";

    leaf standard-mode {
      type standard-mode;
      config false;
      description
        "G.698.2 standard mode";
    }
  }

  grouping organizational-mode {
    description
      "Transponder operational mode supported by organizations or
       vendor";

    leaf operational-mode {
      type operational-mode;
      config false;
      description
        "configured organization- or vendor-specific
         application identifiers (AI) supported by the transponder";
    }
    leaf organization-identifier {
      type organization-identifier;
      config false;
      description
        "organization identifier that uses organizational
         mode";
    }
  }

  grouping penalty-value {
    description
      "A common definition of the penalty value used for describing
      multiple penalty types (.e.g, CD, PMD, PDL).";

    leaf penalty-value {
      type union {
        type decimal-2 {
          range "0..max";
        }
        type empty;
      }
      units "dB";
      config false;
      mandatory true;
      description
        "The OSNR penalty associated with the related optical 
        impairment at the receiver, when the value is known or an 
        empty value when the value is not known.";
    }
  }

  grouping explicit-mode {
    description
      "Attributes capabilities related to explicit transceiver's
      mode.
      
      This grouping also contains the list of attributes related to
      optical impairment limits for explicit mode (min OSNR, max PMD,
      max CD, max PDL, Q-factor limit, etc.).

      In case of standard and operational mode the attributes are
      implicit.";
    leaf line-coding-bitrate {
      type identityref {
        base line-coding;
      }
      config false;
      description
        "Bit rate/line coding of the optical tributary signal.";
      reference 
        "ITU-T G.698.2 section 7.1.2";
    }
    leaf bitrate {
      type uint16;
      units "Gbit/sec";
      config false;
      description
        "The gross bitrate (e.g., 100, 200) of the optical tributary
        signal.";
    }
    leaf max-diff-group-delay  {
      type decimal-2;
      units "ps";
      config false;
      description
        "Maximum Differential group delay of this mode for this 
        lane";
    }
    leaf max-chromatic-dispersion {
      type decimal-2 {
        range "0..max";
      }
      units "ps/nm";
      config false;
      description
        "Maximum acceptable accumulated chromatic dispersion (CD) 
        on the receiver";
    }
    list cd-penalty {
      key cd-value;
      config false;
      description
        "Optional penalty associated with a given accumulated
        chromatic dispersion (CD) value.

        This list of pair CD and penalty values can be used to
        sample the function penalty = f(CD).";
      leaf cd-value {
        type decimal-2;
        units "ps/nm";
        config false;
        mandatory true;
        description
          "The Chromatic Dispersion (CD).";
      }
      uses penalty-value;
    }
    leaf max-polarization-mode-dispersion {
      type decimal-2 {
        range "0..max";
      }
      units "ps";
      config false;
      description
        "Maximum acceptable accumulated polarization mode
         dispersion (PMD) on the receiver";
      reference
        "ITU-T G.666 (02/2011): Characteristics of polarization
        mode dispersion compensators and of receivers that
        compensate for polarization mode dispersion";
    }
    list pmd-penalty {
      key pmd-value;
      config false;
      description
        "Optional penalty associated with a given accumulated
        polarization mode dispersion (PMD) value.

        This list of pair PMD and penalty can be used to
        sample the function penalty = f(PMD).";
      leaf pmd-value {
        type decimal-2 {
          range "0..max";
        }
        units "ps";
        config false;
        mandatory true;
        description
          "The Polarization Mode Dispersion (PMD).";
      }
      uses penalty-value;
    }
    leaf max-polarization-dependent-loss {
      type power-loss-or-null;
      config false;
      mandatory true;
      description
        "Maximum acceptable accumulated accumulated polarization 
        dependent loss (PDL) on the receiver";
    }
    list pdl-penalty {
      key pdl-value;
      config false;
      description
        "Optional penalty associated with a given accumulated 
        polarization dependent loss (PDL) value.

        This list of pair PDL and penalty values can be used to
        sample the function PDL = f(penalty).";
      leaf pdl-value {
        type power-loss;
        config false;
        mandatory true;
        description
          "Maximum acceptable accumulated polarization dependent
          loss (PDL).";
      }
      uses penalty-value;
    }
    leaf available-modulation-type {
      type identityref {
        base modulation;
      }
      config false;
      description
        "Modulation type the specific transceiver in the list
         can support";
    }
    leaf min-OSNR {
      type snr;
      units "dBm";
      config false;
      description
        "min OSNR measured over 0.1 nm resolution bandwidth:
        if received OSNR at Rx-power reference point
        (rx-ref-channel-power) is lower than MIN-OSNR, an increased 
        level of bit-errors post-FEC needs to be expected";
    }
    leaf rx-ref-channel-power {
      type power-dbm;
      config false;
      description
        "The channel power used as reference for defining penalties 
        and min-OSNR";
    }
    list rx-channel-power-penalty {
      key rx-channel-power-value;
      config false;
      description
        "Optional penalty associated with a received power
        lower than rx-ref-channel-power.

        This list of pair power and penalty can be used to
        sample the function penalty = f(rx-channel-power).";
      leaf rx-channel-power-value {
        type power-dbm;
        units "dBm";
        config false;
        mandatory true;
        description
          "The Received Power.";
      }
      uses penalty-value;
    }
    leaf min-Q-factor {
      type decimal-2;
      units "dB";
      config false;
      description "min Qfactor at FEC threshold";
    }
    leaf available-baud-rate {
      type decimal64 {
        fraction-digits 1;
      }
      units "Bd";
      config false;
      description
        "Baud-rate the specific transceiver in 
        the list can support.
         Baud-rate is the unit for
         symbol rate or modulation rate 
         in symbols per second or
         pulses per second. 
         It is the number of distinct symbol
         changes (signal events) made to the 
         transmission medium
         per second in a digitally 
         modulated signal or a line code";
    }
    leaf roll-off {
      type decimal64 {
        fraction-digits 4;
        range "0..1";
      }
      config false;
      description 
        "the roll-off factor (beta with values from 0 to 1) 
        identifies how the real signal shape exceed 
        the baud rate. If=0 it is exactly matching 
        the baud rate.If=1 the signal exceeds the 
        50% of the baud rate at each side.";             
    }
    leaf min-carrier-spacing {
      type frequency-ghz;
      config false;
      description
        "This attribute specifies the minimum nominal difference
        between the carrier frequencies of two homogeneous OTSis
        (which have the same optical characteristics but the central
        frequencies) such that if they are placed next to each other
        the interference due to spectrum overlap between them can be
        considered negligible.

        In case of heterogeneous OTSi it is up to path computation
        engine to determine the minimum distance between the carrier
        frequency of the two adjacent OTSi.";
    }
    leaf available-fec-type {
      type identityref {
        base fec-type;
      }
      config false;
      description "Available FEC";
    }
    leaf fec-code-rate {
      type decimal64 {
        fraction-digits 8;
        range "0..max";
      }
      config false;
      description "FEC-code-rate";
    }
    leaf fec-threshold {
      type decimal64 {
        fraction-digits 8;
        range "0..max";
      }
      config false;
      description
        "Threshold on the BER, for which FEC 
         is able to correct errors";
    }
    leaf in-band-osnr {
      type snr;
      config false;
      description
        "The OSNR defined within the bandwidth of the transmit 
        spectral excursion (i.e.,  between the nominal central 
        frequency of the channel and the -3.0dB points of the 
        transmitter spectrum furthest from the nominal central 
        frequency) measured at reference point Ss.
        
        The in-band OSNR is referenced to an optical bandwidth of 
        0.1nm @ 193.7 THz or 12.5 GHz.";
      reference
        "OIF-400ZR-01.0: Implementation Agreement 400ZR";
    }
    leaf out-of-band-osnr {
      type snr;
      config false;
      description
        "The ratio of the peak transmitter power to the integrated 
        power outside the transmitter spectral excursion.
        
        The spectral resolution of the measurement shall be better 
        than the maximum spectral width of the peak.
        
        The out-of-band OSNR is referenced to an optical bandwidth 
        of 0.1nm @ 193.7 THz or 12.5 GHz";
      reference
        "OIF-400ZR-01.0: Implementation Agreement 400ZR";
    }
    leaf tx-polarization-power-difference {
      type power-ratio;
      config false;
      description
        "The transmitter polarization dependent power difference 
        defined as the power difference between X and Y 
        polarizations";
      reference
        "OIF-400ZR-01.0: Implementation Agreement 400ZR";
    }
    leaf polarization-skew {
      type decimal-2;
      units "ps";
      config false;
      description
        "The X-Y skew, included as a fixed value in the receiver 
        polarization mode dispersion (PMD) tolerance limits.";
      reference
        "OIF-400ZR-01.0: Implementation Agreement 400ZR";
    }
  } // grouping explicit-mode

  grouping common-standard-organizational-mode {
    description
      "Common attributes used by standard and organizational 
      transceiver's modes.";
    
    leaf-list line-coding-bitrate {
      type identityref {
        base line-coding;
      }
      config false;
      description
        "The list of the bit rate/line coding of the optical 
        tributary signal supported by the transceiver.

        Reporting this list is optional when the standard or 
        organization mode supports only one bit rate/line coding.";
      reference 
        "ITU-T G.698.2 section 7.1.2";
    }
  } // grouping common-standard-organizational-mode

  grouping transmitter-tuning-range {
    description
      "Transmitter tuning range (f_tx-min, f_tx-max)";

    leaf min-central-frequency {
      type frequency-thz;
      description
        "This parameter indicates the minimum frequency for the
        transmitter tuning range.";
    }
    leaf max-central-frequency {
      type frequency-thz;
      description
        "This parameter indicates the maximum frequency for the
        transmitter tuning range.";
    }

    leaf transceiver-tunability {
      type frequency-ghz;
      description
        "This parameter indicates the transmitter frequency fine
        tuning steps e.g 3.125GHz or 0.001GHz.";
    }
  } // grouping transmitter-tuning-range

  grouping common-all-modes {
    description
      "Common attributes used by all transceiver's modes.";

    container transmitter-tuning-range {
      config false;
      description
        "Transmitter tuning range (f_tx-min, f_tx-max)";
      uses transmitter-tuning-range;
    }
/* Alternative solution (not future safe):

    uses transmitter-tuning-range {
      refine min-central-frequency {
        config false;
      }
      refine max-central-frequency {
        config false;
      }
      refine transceiver-tunability {
        config false;
      }
    }
*/
    leaf tx-channel-power-min {
      type power-dbm;
      config false;
      description "The minimum output power of this interface";
    }
    leaf tx-channel-power-max {
      type power-dbm;
      config false;
      description "The maximum output power of this interface";
    } 
    leaf rx-channel-power-min {
      type power-dbm;
      config false;
      description "The minimum input power of this interface";
    }
    leaf rx-channel-power-max {
      type power-dbm;
      config false;
      description "The maximum input power of this interface";
    }
    leaf rx-total-power-max {
      type power-dbm;
      config false;
      description
        "Maximum rx optical power for all the channels.
        
        It is applicable only to multi-channel modes.";
    }
  } // grouping common-all-modes

  grouping common-transceiver-param {
    description
      "The common parameters of an optical transceiver,
      that supplement the configured mode.";

    uses common-transceiver-configured-param;
    uses common-transceiver-readonly-param;
  }

  grouping common-transceiver-configured-param {
    description
      "The configured parameters of an optical transceiver,
      that supplement the configured mode.";

    leaf line-coding-bitrate {
      type identityref {
        base line-coding;
      }
      description
        "Bit rate/line coding of the optical tributary signal.
        
        Support of this attribute is optional when the configured 
        mode supports only one bit rate/line coding.";
      reference 
        "ITU-T G.698.2 section 7.1.2";
    }
    leaf tx-channel-power {
      type power-dbm-or-null;
      description
        "The current channel transmit power, when the value is 
        known or an empty value when the value is not known.
        
        The empty value MUST NOT be used when this attribute is 
        configured.";
    }
  } // grouping for configured transceiver attributes out of mode

  grouping common-transceiver-readonly-param {
    description
      "The common read-only parameters of an optical transceiver,
      that supplement the configured mode.";

    leaf rx-channel-power {
      type power-dbm-or-null;
      config false;
      description
        "The current channel received power, when the value is 
        known or an empty value when the value is not known.";
    }
    leaf rx-total-power {
      type power-dbm-or-null;
      config false;
      description
        "The current total received power, when the value is known 
        or an empty value when the value is not known.";
    }
  } // grouping for read-only transceiver attributes out of mode

  grouping l0-tunnel-attributes {
    description
      "Parameters for Layer0 (WSON or Flexi-Grid) Tunnels.";

    leaf wavelength-assignment {
      type identityref {
        base wavelength-assignment;
      }
      description "Wavelength Allocation Method";
    }
  }

  grouping frequency-range {
    description
      "This grouping defines the lower and upper bounds of a
      frequency range (e.g., a band).
        
      This grouping SHOULD NOT be used to define a frequency slot,
      which SHOULD be defined using the n and m values instead.";
    leaf lower-frequency {
      type frequency-thz;
      mandatory true;
      description
        "The lower frequency boundary of the
        frequency range.";
    }
    leaf upper-frequency {
      type frequency-thz;
      must '. > ../lower-frequency' {
        error-message
          "The upper frequency must be greater than the lower
          frequency.";
      }
      mandatory true;
      description
        "The upper frequency boundary of the
        frequency range.";
    }
  }

  grouping l0-path-constraints {
    description
      "Common attribute for Layer 0 path constraints to be used by
      Layer 0 computation.";
    leaf gsnr-extra-margin {
      type snr {
        range 0..max;
      }
      default 0;
      description
        "An additional margin to be added to the OSNR-min of the
        transceiver when checking the estimated received Generalized
        SNR (GSNR).";
    }
  }

  grouping l0-path-properties {
    description
      "Common attribute for reporting the Layer 0 computed path
      properties.";
    leaf estimated-gsnr {
      type snr;
      config false;
      description
        "The estimate received GSNR for the computed path.";
    }
    leaf estimated-eol-gsnr {
      type snr;
      config false;
      description
        "The estimate received GSNR for the computed path
         degraded at the end of life.";
    }
    leaf estimated-lowest-gsnr {
      type snr;
      config false;
      description
        "The estimate lowest received GSNR for the computed path
         among all possible wavelength channels along the same
         path.";
    }
  }
}
]]></sourcecode></figure>

</section>
<section anchor="security-considerations"><name>Security Considerations</name>

<t>This section is modeled after the template described in Section 3.7
of <xref target="I-D.ietf-netmod-rfc8407bis"/>.</t>

<t>The "ietf-layer0-types" YANG module define data models that are
designed to be accessed via YANG-based management protocols, such as
NETCONF <xref target="RFC6241"/> and RESTCONF <xref target="RFC8040"/>. These protocols have to
use a secure transport layer (e.g., SSH <xref target="RFC4252"/>, TLS <xref target="RFC8446"/>, and
QUIC <xref target="RFC9000"/>) and have to use mutual authentication.</t>

<t>The Network Configuration Access Control Model (NACM) <xref target="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.</t>

<t>The YANG modules define a set of identities, types, and
groupings. These nodes are intended to be reused by other YANG
modules. The modules by themselves do not expose any data nodes that
are writable, data nodes that contain read-only state, or RPCs.
As such, there are no additional security issues related to
the YANG module that need to be considered.</t>

<t>Modules that use the groupings that are defined in this document
should identify the corresponding security considerations. For
example, reusing some of these groupings will expose privacy-related
information (e.g., 'node-example').</t>

</section>
<section anchor="iana-considerations"><name>IANA Considerations</name>

<t>This document requests IANA to update the following URIs in the "IETF XML Registry" <xref target="RFC3688"/> to refer to this document:</t>

<figure><artwork><![CDATA[
   URI:  urn:ietf:params:xml:ns:yang:ietf-layer0-types
   Registrant Contact:  The IESG
   XML:  N/A; the requested URI is an XML namespace.
]]></artwork></figure>

<t>This document requests IANA to register the following YANG modules in the "YANG Module Names" registry <xref target="RFC6020"/> within the "YANG Parameters" registry group.</t>

<figure><artwork><![CDATA[
   Name:  ietf-layer0-types
   Maintained by IANA?  N
   Namespace:  urn:ietf:params:xml:ns:yang:ietf-layer0-types
   Prefix:  l0-types
   Reference:  RFC XXXX
]]></artwork></figure>

<ul empty="true"><li>
  <t>RFC Editor Note: Please replace XXXX with the RFC number assigned to this document and remove this note.</t>
</li></ul>

</section>


  </middle>

  <back>


<references title='References' anchor="sec-combined-references">

    <references title='Normative References' anchor="sec-normative-references">

<reference anchor="ITU-T_G.666" target="https://www.itu.int/rec/T-REC-G.666">
  <front>
    <title>Characteristics of polarization mode dispersion compensators and of receivers that compensate for polarization mode dispersion"</title>
    <author >
      <organization>International Telecommunication Union</organization>
    </author>
    <date year="2011" month="February"/>
  </front>
  <seriesInfo name="ITU-T Recommendation G.666" value=""/>
</reference>
<reference anchor="ITU-T_G.694.1" target="https://www.itu.int/rec/T-REC-G.694.1">
  <front>
    <title>Spectral grids for WDM applications: DWDM frequency grid</title>
    <author >
      <organization>International Telecommunication Union</organization>
    </author>
    <date year="2020" month="October"/>
  </front>
  <seriesInfo name="ITU-T Recommendation G.694.1" value=""/>
</reference>
<reference anchor="ITU-T_G.694.2" target="https://www.itu.int/rec/T-REC-G.694.2">
  <front>
    <title>Spectral grids for WDM applications: CWDM wavelength grid</title>
    <author >
      <organization>International Telecommunication Union</organization>
    </author>
    <date year="2003" month="December"/>
  </front>
  <seriesInfo name="ITU-T Recommendation G.694.2" value=""/>
</reference>
<reference anchor="ITU-T_G.698.2" target="https://www.itu.int/rec/T-REC-G.698.2">
  <front>
    <title>Amplified multichannel dense wavelength division multiplexing applications with single channel optical interfaces</title>
    <author >
      <organization>International Telecommunication Union</organization>
    </author>
    <date year="2018" month="November"/>
  </front>
  <seriesInfo name="ITU-T Recommendation G.698.2" value=""/>
</reference>
<reference anchor="ITU-T_G.709" target="https://www.itu.int/rec/T-REC-G.709">
  <front>
    <title>Interfaces for the optical transport network</title>
    <author >
      <organization>International Telecommunication Union</organization>
    </author>
    <date year="2020" month="June"/>
  </front>
  <seriesInfo name="ITU-T Recommendation G.709" value=""/>
</reference>
<reference anchor="ITU-T_G.709.2" target="https://www.itu.int/rec/T-REC-G.709.2">
  <front>
    <title>OTU4 long-reach interface</title>
    <author >
      <organization>International Telecommunication Union</organization>
    </author>
    <date year="2020" month="September"/>
  </front>
  <seriesInfo name="ITU-T Recommendation G.709.2, Corrigendum 1" value=""/>
</reference>
<reference anchor="ITU-T_G.709.3" target="https://www.itu.int/rec/T-REC-G.709.3">
  <front>
    <title>Flexible OTN B100G long-reach interfaces</title>
    <author >
      <organization>International Telecommunication Union</organization>
    </author>
    <date year="2022" month="November"/>
  </front>
  <seriesInfo name="ITU-T Recommendation G.709.3, Amendment 1" value=""/>
</reference>
<reference anchor="ITU-T_G.959.1" target="https://www.itu.int/rec/T-REC-G.959.1">
  <front>
    <title>Optical transport network physical layer interfaces</title>
    <author >
      <organization>International Telecommunication Union</organization>
    </author>
    <date year="2018" month="July"/>
  </front>
  <seriesInfo name="ITU-T Recommendation G.959.1" value=""/>
</reference>
<reference anchor="ITU-T_G.975" target="https://www.itu.int/rec/T-REC-G.975">
  <front>
    <title>Forward error correction for submarine systems</title>
    <author >
      <organization>International Telecommunication Union</organization>
    </author>
    <date year="2000" month="October"/>
  </front>
  <seriesInfo name="ITU-T Recommendation G.975" value=""/>
</reference>
<reference anchor="ITU-T_G.975.1" target="https://www.itu.int/rec/T-REC-G.975.1">
  <front>
    <title>Forward error correction for high bit-rate DWDM submarine systems</title>
    <author >
      <organization>International Telecommunication Union</organization>
    </author>
    <date year="2013" month="July"/>
  </front>
  <seriesInfo name="ITU-T Recommendation G.975.1, Corrigendum 2" value=""/>
</reference>
<reference anchor="ITU-T_G.977.1" target="https://www.itu.int/rec/T-REC-G.977.1">
  <front>
    <title>Transverse compatible dense wavelength division multiplexing applications for repeatered optical fibre submarine cable systems</title>
    <author >
      <organization>International Telecommunication Union</organization>
    </author>
    <date year="2021" month="February"/>
  </front>
  <seriesInfo name="ITU-T Recommendation G.977.1" value=""/>
</reference>
<reference anchor="ITU-T_G.9700" target="https://www.itu.int/rec/T-REC-G.9700">
  <front>
    <title>Fast access to subscriber terminals (G.fast) - Power spectral density specification</title>
    <author >
      <organization>International Telecommunication Union</organization>
    </author>
    <date year="2019" month="July"/>
  </front>
  <seriesInfo name="ITU-T Recommendation G.9700" value=""/>
</reference>
<reference anchor="OIF_400ZR" target="https://www.oiforum.com/wp-content/uploads/OIF-400ZR-01.0_reduced2.pdf">
  <front>
    <title>Implementation Agreement 400ZR</title>
    <author >
      <organization>Optical Internetworking Forum</organization>
    </author>
    <date year="2020" month="March"/>
  </front>
  <seriesInfo name="OIF-400ZR-01.0 Implementation Agreement" value=""/>
</reference>


<reference anchor="RFC7950">
  <front>
    <title>The YANG 1.1 Data Modeling Language</title>
    <author fullname="M. Bjorklund" initials="M." role="editor" surname="Bjorklund"/>
    <date month="August" year="2016"/>
    <abstract>
      <t>YANG is a data modeling language used to model configuration data, state data, Remote Procedure Calls, and notifications for network management protocols. This document describes the syntax and semantics of version 1.1 of the YANG language. YANG version 1.1 is a maintenance release of the YANG language, addressing ambiguities and defects in the original specification. There are a small number of backward incompatibilities from YANG version 1. This document also specifies the YANG mappings to the Network Configuration Protocol (NETCONF).</t>
    </abstract>
  </front>
  <seriesInfo name="RFC" value="7950"/>
  <seriesInfo name="DOI" value="10.17487/RFC7950"/>
</reference>

<reference anchor="RFC6241">
  <front>
    <title>Network Configuration Protocol (NETCONF)</title>
    <author fullname="R. Enns" initials="R." role="editor" surname="Enns"/>
    <author fullname="M. Bjorklund" initials="M." role="editor" surname="Bjorklund"/>
    <author fullname="J. Schoenwaelder" initials="J." role="editor" surname="Schoenwaelder"/>
    <author fullname="A. Bierman" initials="A." role="editor" surname="Bierman"/>
    <date month="June" year="2011"/>
    <abstract>
      <t>The Network Configuration Protocol (NETCONF) defined in this document provides mechanisms to install, manipulate, and delete the configuration of network devices. It uses an Extensible Markup Language (XML)-based data encoding for the configuration data as well as the protocol messages. The NETCONF protocol operations are realized as remote procedure calls (RPCs). This document obsoletes RFC 4741. [STANDARDS-TRACK]</t>
    </abstract>
  </front>
  <seriesInfo name="RFC" value="6241"/>
  <seriesInfo name="DOI" value="10.17487/RFC6241"/>
</reference>

<reference anchor="RFC7698">
  <front>
    <title>Framework and Requirements for GMPLS-Based Control of Flexi-Grid Dense Wavelength Division Multiplexing (DWDM) Networks</title>
    <author fullname="O. Gonzalez de Dios" initials="O." role="editor" surname="Gonzalez de Dios"/>
    <author fullname="R. Casellas" initials="R." role="editor" surname="Casellas"/>
    <author fullname="F. Zhang" initials="F." surname="Zhang"/>
    <author fullname="X. Fu" initials="X." surname="Fu"/>
    <author fullname="D. Ceccarelli" initials="D." surname="Ceccarelli"/>
    <author fullname="I. Hussain" initials="I." surname="Hussain"/>
    <date month="November" year="2015"/>
    <abstract>
      <t>To allow efficient allocation of optical spectral bandwidth for systems that have high bit-rates, the International Telecommunication Union Telecommunication Standardization Sector (ITU-T) has extended its Recommendations G.694.1 and G.872 to include a new Dense Wavelength Division Multiplexing (DWDM) grid by defining a set of nominal central frequencies, channel spacings, and the concept of the "frequency slot". In such an environment, a data-plane connection is switched based on allocated, variable-sized frequency ranges within the optical spectrum, creating what is known as a flexible grid (flexi-grid).</t>
      <t>Given the specific characteristics of flexi-grid optical networks and their associated technology, this document defines a framework and the associated control-plane requirements for the application of the existing GMPLS architecture and control-plane protocols to the control of flexi-grid DWDM networks. The actual extensions to the GMPLS protocols will be defined in companion documents.</t>
    </abstract>
  </front>
  <seriesInfo name="RFC" value="7698"/>
  <seriesInfo name="DOI" value="10.17487/RFC7698"/>
</reference>

<reference anchor="RFC9093">
  <front>
    <title>A YANG Data Model for Layer 0 Types</title>
    <author fullname="H. Zheng" initials="H." surname="Zheng"/>
    <author fullname="Y. Lee" initials="Y." surname="Lee"/>
    <author fullname="A. Guo" initials="A." surname="Guo"/>
    <author fullname="V. Lopez" initials="V." surname="Lopez"/>
    <author fullname="D. King" initials="D." surname="King"/>
    <date month="August" year="2021"/>
    <abstract>
      <t>This document defines a collection of common data types and groupings in the YANG data modeling language. These derived common types and groupings are intended to be imported by modules that model Layer 0 optical Traffic Engineering (TE) configuration and state capabilities such as Wavelength Switched Optical Networks (WSONs) and flexi-grid Dense Wavelength Division Multiplexing (DWDM) networks.</t>
    </abstract>
  </front>
  <seriesInfo name="RFC" value="9093"/>
  <seriesInfo name="DOI" value="10.17487/RFC9093"/>
</reference>

<reference anchor="RFC8342">
  <front>
    <title>Network Management Datastore Architecture (NMDA)</title>
    <author fullname="M. Bjorklund" initials="M." surname="Bjorklund"/>
    <author fullname="J. Schoenwaelder" initials="J." surname="Schoenwaelder"/>
    <author fullname="P. Shafer" initials="P." surname="Shafer"/>
    <author fullname="K. Watsen" initials="K." surname="Watsen"/>
    <author fullname="R. Wilton" initials="R." surname="Wilton"/>
    <date month="March" year="2018"/>
    <abstract>
      <t>Datastores are a fundamental concept binding the data models written in the YANG data modeling language to network management protocols such as the Network Configuration Protocol (NETCONF) and RESTCONF. This document defines an architectural framework for datastores based on the experience gained with the initial simpler model, addressing requirements that were not well supported in the initial model. This document updates RFC 7950.</t>
    </abstract>
  </front>
  <seriesInfo name="RFC" value="8342"/>
  <seriesInfo name="DOI" value="10.17487/RFC8342"/>
</reference>

<reference anchor="RFC2119">
  <front>
    <title>Key words for use in RFCs to Indicate Requirement Levels</title>
    <author fullname="S. Bradner" initials="S." surname="Bradner"/>
    <date month="March" year="1997"/>
    <abstract>
      <t>In many standards track documents several words are used to signify the requirements in the specification. These words are often capitalized. This document defines these words as they should be interpreted in IETF documents. This document specifies an Internet Best Current Practices for the Internet Community, and requests discussion and suggestions for improvements.</t>
    </abstract>
  </front>
  <seriesInfo name="BCP" value="14"/>
  <seriesInfo name="RFC" value="2119"/>
  <seriesInfo name="DOI" value="10.17487/RFC2119"/>
</reference>

<reference anchor="RFC8174">
  <front>
    <title>Ambiguity of Uppercase vs Lowercase in RFC 2119 Key Words</title>
    <author fullname="B. Leiba" initials="B." surname="Leiba"/>
    <date month="May" year="2017"/>
    <abstract>
      <t>RFC 2119 specifies common key words that may be used in protocol specifications. This document aims to reduce the ambiguity by clarifying that only UPPERCASE usage of the key words have the defined special meanings.</t>
    </abstract>
  </front>
  <seriesInfo name="BCP" value="14"/>
  <seriesInfo name="RFC" value="8174"/>
  <seriesInfo name="DOI" value="10.17487/RFC8174"/>
</reference>


<reference anchor="I-D.ietf-teas-rfc8776-update">
   <front>
      <title>Common YANG Data Types for Traffic Engineering</title>
      <author fullname="Italo Busi" initials="I." surname="Busi">
         <organization>Huawei</organization>
      </author>
      <author fullname="Aihua Guo" initials="A." surname="Guo">
         <organization>Futurewei Technologies</organization>
      </author>
      <author fullname="Xufeng Liu" initials="X." surname="Liu">
         <organization>Alef Edge</organization>
      </author>
      <author fullname="Tarek Saad" initials="T." surname="Saad">
         <organization>Cisco Systems Inc.</organization>
      </author>
      <author fullname="Igor Bryskin" initials="I." surname="Bryskin">
         <organization>Individual</organization>
      </author>
      <date day="4" month="November" year="2024"/>
      <abstract>
	 <t>   This document defines a collection of common data types, identities,
   and groupings in YANG data modeling language.  These derived common
   data types, identities and groupings are intended to be imported by
   other modules, e.g., those which model the Traffic Engineering (TE)
   configuration and state capabilities.

   This document obsoletes RFC 8776.

	 </t>
      </abstract>
   </front>
   <seriesInfo name="Internet-Draft" value="draft-ietf-teas-rfc8776-update-14"/>
   
</reference>

<reference anchor="RFC6205">
  <front>
    <title>Generalized Labels for Lambda-Switch-Capable (LSC) Label Switching Routers</title>
    <author fullname="T. Otani" initials="T." role="editor" surname="Otani"/>
    <author fullname="D. Li" initials="D." role="editor" surname="Li"/>
    <date month="March" year="2011"/>
    <abstract>
      <t>Technology in the optical domain is constantly evolving, and, as a consequence, new equipment providing lambda switching capability has been developed and is currently being deployed.</t>
      <t>Generalized MPLS (GMPLS) is a family of protocols that can be used to operate networks built from a range of technologies including wavelength (or lambda) switching. For this purpose, GMPLS defined a wavelength label as only having significance between two neighbors. Global wavelength semantics are not considered.</t>
      <t>In order to facilitate interoperability in a network composed of next generation lambda-switch-capable equipment, this document defines a standard lambda label format that is compliant with the Dense Wavelength Division Multiplexing (DWDM) and Coarse Wavelength Division Multiplexing (CWDM) grids defined by the International Telecommunication Union Telecommunication Standardization Sector. The label format defined in this document can be used in GMPLS signaling and routing protocols. [STANDARDS-TRACK]</t>
    </abstract>
  </front>
  <seriesInfo name="RFC" value="6205"/>
  <seriesInfo name="DOI" value="10.17487/RFC6205"/>
</reference>

<reference anchor="RFC7699">
  <front>
    <title>Generalized Labels for the Flexi-Grid in Lambda Switch Capable (LSC) Label Switching Routers</title>
    <author fullname="A. Farrel" initials="A." surname="Farrel"/>
    <author fullname="D. King" initials="D." surname="King"/>
    <author fullname="Y. Li" initials="Y." surname="Li"/>
    <author fullname="F. Zhang" initials="F." surname="Zhang"/>
    <date month="November" year="2015"/>
    <abstract>
      <t>GMPLS supports the description of optical switching by identifying entries in fixed lists of switchable wavelengths (called grids) through the encoding of lambda labels. Work within the ITU-T Study Group 15 has defined a finer-granularity grid, and the facility to flexibly select different widths of spectrum from the grid. This document defines a new GMPLS lambda label format to support this flexi-grid.</t>
      <t>This document updates RFCs 3471 and 6205 by introducing a new label format.</t>
    </abstract>
  </front>
  <seriesInfo name="RFC" value="7699"/>
  <seriesInfo name="DOI" value="10.17487/RFC7699"/>
</reference>

<reference anchor="RFC7689">
  <front>
    <title>Signaling Extensions for Wavelength Switched Optical Networks</title>
    <author fullname="G. Bernstein" initials="G." role="editor" surname="Bernstein"/>
    <author fullname="S. Xu" initials="S." surname="Xu"/>
    <author fullname="Y. Lee" initials="Y." role="editor" surname="Lee"/>
    <author fullname="G. Martinelli" initials="G." surname="Martinelli"/>
    <author fullname="H. Harai" initials="H." surname="Harai"/>
    <date month="November" year="2015"/>
    <abstract>
      <t>This document provides extensions to Generalized Multiprotocol Label Switching (GMPLS) signaling for control of Wavelength Switched Optical Networks (WSONs). Such extensions are applicable in WSONs under a number of conditions including: (a) when optional processing, such as regeneration, must be configured to occur at specific nodes along a path, (b) where equipment must be configured to accept an optical signal with specific attributes, or (c) where equipment must be configured to output an optical signal with specific attributes. This document provides mechanisms to support distributed wavelength assignment with a choice of distributed wavelength assignment algorithms.</t>
    </abstract>
  </front>
  <seriesInfo name="RFC" value="7689"/>
  <seriesInfo name="DOI" value="10.17487/RFC7689"/>
</reference>


<reference anchor="I-D.ietf-ccamp-optical-impairment-topology-yang">
   <front>
      <title>A YANG Data Model for Optical Impairment-aware Topology</title>
      <author fullname="Dieter Beller" initials="D." surname="Beller">
         <organization>Nokia</organization>
      </author>
      <author fullname="Esther Le Rouzic" initials="E." surname="Le Rouzic">
         <organization>Orange</organization>
      </author>
      <author fullname="Sergio Belotti" initials="S." surname="Belotti">
         <organization>Nokia</organization>
      </author>
      <author fullname="Gabriele Galimberti" initials="G." surname="Galimberti">
         <organization>Individual</organization>
      </author>
      <author fullname="Italo Busi" initials="I." surname="Busi">
         <organization>Huawei Technologies</organization>
      </author>
      <date day="21" month="October" year="2024"/>
      <abstract>
	 <t>   In order to provision an optical connection through optical networks,
   a combination of path continuity, resource availability, and
   impairment constraints must be met to determine viable and optimal
   paths through the network.  The determination of appropriate paths is
   known as Impairment-Aware Routing and Wavelength Assignment (IA-RWA)
   for WSON, while it is known as Impairment-Aware Routing and Spectrum
   Assignment (IA-RSA) for SSON.

   This document provides a YANG data model for the impairment-aware TE
   topology in optical networks.

	 </t>
      </abstract>
   </front>
   <seriesInfo name="Internet-Draft" value="draft-ietf-ccamp-optical-impairment-topology-yang-17"/>
   
</reference>

<reference anchor="RFC8795">
  <front>
    <title>YANG Data Model for Traffic Engineering (TE) Topologies</title>
    <author fullname="X. Liu" initials="X." surname="Liu"/>
    <author fullname="I. Bryskin" initials="I." surname="Bryskin"/>
    <author fullname="V. Beeram" initials="V." surname="Beeram"/>
    <author fullname="T. Saad" initials="T." surname="Saad"/>
    <author fullname="H. Shah" initials="H." surname="Shah"/>
    <author fullname="O. Gonzalez de Dios" initials="O." surname="Gonzalez de Dios"/>
    <date month="August" year="2020"/>
    <abstract>
      <t>This document defines a YANG data model for representing, retrieving, and manipulating Traffic Engineering (TE) Topologies. The model serves as a base model that other technology-specific TE topology models can augment.</t>
    </abstract>
  </front>
  <seriesInfo name="RFC" value="8795"/>
  <seriesInfo name="DOI" value="10.17487/RFC8795"/>
</reference>

<reference anchor="RFC4203">
  <front>
    <title>OSPF Extensions in Support of Generalized Multi-Protocol Label Switching (GMPLS)</title>
    <author fullname="K. Kompella" initials="K." role="editor" surname="Kompella"/>
    <author fullname="Y. Rekhter" initials="Y." role="editor" surname="Rekhter"/>
    <date month="October" year="2005"/>
    <abstract>
      <t>This document specifies encoding of extensions to the OSPF routing protocol in support of Generalized Multi-Protocol Label Switching (GMPLS). [STANDARDS-TRACK]</t>
    </abstract>
  </front>
  <seriesInfo name="RFC" value="4203"/>
  <seriesInfo name="DOI" value="10.17487/RFC4203"/>
</reference>

<reference anchor="RFC8363">
  <front>
    <title>GMPLS OSPF-TE Extensions in Support of Flexi-Grid Dense Wavelength Division Multiplexing (DWDM) Networks</title>
    <author fullname="X. Zhang" initials="X." surname="Zhang"/>
    <author fullname="H. Zheng" initials="H." surname="Zheng"/>
    <author fullname="R. Casellas" initials="R." surname="Casellas"/>
    <author fullname="O. Gonzalez de Dios" initials="O." surname="Gonzalez de Dios"/>
    <author fullname="D. Ceccarelli" initials="D." surname="Ceccarelli"/>
    <date month="May" year="2018"/>
    <abstract>
      <t>The International Telecommunication Union Telecommunication standardization sector (ITU-T) has extended its Recommendations G.694.1 and G.872 to include a new Dense Wavelength Division Multiplexing (DWDM) grid by defining channel spacings, a set of nominal central frequencies, and the concept of the "frequency slot". Corresponding techniques for data-plane connections are known as "flexi-grid".</t>
      <t>Based on the characteristics of flexi-grid defined in G.694.1 and in RFCs 7698 and 7699, this document describes the Open Shortest Path First - Traffic Engineering (OSPF-TE) extensions in support of GMPLS control of networks that include devices that use the new flexible optical grid.</t>
    </abstract>
  </front>
  <seriesInfo name="RFC" value="8363"/>
  <seriesInfo name="DOI" value="10.17487/RFC8363"/>
</reference>

<reference anchor="RFC7688">
  <front>
    <title>GMPLS OSPF Enhancement for Signal and Network Element Compatibility for Wavelength Switched Optical Networks</title>
    <author fullname="Y. Lee" initials="Y." role="editor" surname="Lee"/>
    <author fullname="G. Bernstein" initials="G." role="editor" surname="Bernstein"/>
    <date month="November" year="2015"/>
    <abstract>
      <t>This document provides Generalized Multiprotocol Label Switching (GMPLS) Open Shortest Path First (OSPF) routing enhancements to support signal compatibility constraints associated with Wavelength Switched Optical Network (WSON) elements. These routing enhancements are applicable in common optical or hybrid electro-optical networks where not all the optical signals in the network are compatible with all network elements participating in the network.</t>
      <t>This compatibility constraint model is applicable to common optical or hybrid electro-optical systems such as optical-electronic-optical (OEO) switches, regenerators, and wavelength converters, since such systems can be limited to processing only certain types of WSON signals.</t>
    </abstract>
  </front>
  <seriesInfo name="RFC" value="7688"/>
  <seriesInfo name="DOI" value="10.17487/RFC7688"/>
</reference>

<reference anchor="RFC3471">
  <front>
    <title>Generalized Multi-Protocol Label Switching (GMPLS) Signaling Functional Description</title>
    <author fullname="L. Berger" initials="L." role="editor" surname="Berger"/>
    <date month="January" year="2003"/>
    <abstract>
      <t>This document describes extensions to Multi-Protocol Label Switching (MPLS) signaling required to support Generalized MPLS. Generalized MPLS extends the MPLS control plane to encompass time-division (e.g., Synchronous Optical Network and Synchronous Digital Hierarchy, SONET/SDH), wavelength (optical lambdas) and spatial switching (e.g., incoming port or fiber to outgoing port or fiber). This document presents a functional description of the extensions. Protocol specific formats and mechanisms, and technology specific details are specified in separate documents. [STANDARDS-TRACK]</t>
    </abstract>
  </front>
  <seriesInfo name="RFC" value="3471"/>
  <seriesInfo name="DOI" value="10.17487/RFC3471"/>
</reference>

<reference anchor="RFC8341">
  <front>
    <title>Network Configuration Access Control Model</title>
    <author fullname="A. Bierman" initials="A." surname="Bierman"/>
    <author fullname="M. Bjorklund" initials="M." surname="Bjorklund"/>
    <date month="March" year="2018"/>
    <abstract>
      <t>The standardization of network configuration interfaces for use with the Network Configuration Protocol (NETCONF) or the RESTCONF protocol requires a structured and secure operating environment that promotes human usability and multi-vendor interoperability. There is a need for standard mechanisms to restrict NETCONF or RESTCONF protocol access for particular users to a preconfigured subset of all available NETCONF or RESTCONF protocol operations and content. This document defines such an access control model.</t>
      <t>This document obsoletes RFC 6536.</t>
    </abstract>
  </front>
  <seriesInfo name="STD" value="91"/>
  <seriesInfo name="RFC" value="8341"/>
  <seriesInfo name="DOI" value="10.17487/RFC8341"/>
</reference>

<reference anchor="RFC6020">
  <front>
    <title>YANG - A Data Modeling Language for the Network Configuration Protocol (NETCONF)</title>
    <author fullname="M. Bjorklund" initials="M." role="editor" surname="Bjorklund"/>
    <date month="October" year="2010"/>
    <abstract>
      <t>YANG is a data modeling language used to model configuration and state data manipulated by the Network Configuration Protocol (NETCONF), NETCONF remote procedure calls, and NETCONF notifications. [STANDARDS-TRACK]</t>
    </abstract>
  </front>
  <seriesInfo name="RFC" value="6020"/>
  <seriesInfo name="DOI" value="10.17487/RFC6020"/>
</reference>




    </references>

    <references title='Informative References' anchor="sec-informative-references">

<reference anchor="ITU-T_G.Sup39" >
  <front>
    <title>Optical system design and engineering considerations</title>
    <author >
      <organization>International Telecommunication Union</organization>
    </author>
    <date year="2016" month="February"/>
  </front>
  <seriesInfo name="ITU-T Supplement G.Sup39" value=""/>
</reference>


<reference anchor="RFC6163">
  <front>
    <title>Framework for GMPLS and Path Computation Element (PCE) Control of Wavelength Switched Optical Networks (WSONs)</title>
    <author fullname="Y. Lee" initials="Y." role="editor" surname="Lee"/>
    <author fullname="G. Bernstein" initials="G." role="editor" surname="Bernstein"/>
    <author fullname="W. Imajuku" initials="W." surname="Imajuku"/>
    <date month="April" year="2011"/>
    <abstract>
      <t>This document provides a framework for applying Generalized Multi-Protocol Label Switching (GMPLS) and the Path Computation Element (PCE) architecture to the control of Wavelength Switched Optical Networks (WSONs). In particular, it examines Routing and Wavelength Assignment (RWA) of optical paths.</t>
      <t>This document focuses on topological elements and path selection constraints that are common across different WSON environments; as such, it does not address optical impairments in any depth. This document is not an Internet Standards Track specification; it is published for informational purposes.</t>
    </abstract>
  </front>
  <seriesInfo name="RFC" value="6163"/>
  <seriesInfo name="DOI" value="10.17487/RFC6163"/>
</reference>

<reference anchor="RFC7446">
  <front>
    <title>Routing and Wavelength Assignment Information Model for Wavelength Switched Optical Networks</title>
    <author fullname="Y. Lee" initials="Y." role="editor" surname="Lee"/>
    <author fullname="G. Bernstein" initials="G." role="editor" surname="Bernstein"/>
    <author fullname="D. Li" initials="D." surname="Li"/>
    <author fullname="W. Imajuku" initials="W." surname="Imajuku"/>
    <date month="February" year="2015"/>
    <abstract>
      <t>This document provides a model of information needed by the Routing and Wavelength Assignment (RWA) process in Wavelength Switched Optical Networks (WSONs). The purpose of the information described in this model is to facilitate constrained optical path computation in WSONs. This model takes into account compatibility constraints between WSON signal attributes and network elements but does not include constraints due to optical impairments. Aspects of this information that may be of use to other technologies utilizing a GMPLS control plane are discussed.</t>
    </abstract>
  </front>
  <seriesInfo name="RFC" value="7446"/>
  <seriesInfo name="DOI" value="10.17487/RFC7446"/>
</reference>

<reference anchor="RFC7581">
  <front>
    <title>Routing and Wavelength Assignment Information Encoding for Wavelength Switched Optical Networks</title>
    <author fullname="G. Bernstein" initials="G." role="editor" surname="Bernstein"/>
    <author fullname="Y. Lee" initials="Y." role="editor" surname="Lee"/>
    <author fullname="D. Li" initials="D." surname="Li"/>
    <author fullname="W. Imajuku" initials="W." surname="Imajuku"/>
    <author fullname="J. Han" initials="J." surname="Han"/>
    <date month="June" year="2015"/>
    <abstract>
      <t>A Wavelength Switched Optical Network (WSON) requires certain key information fields be made available to facilitate path computation and the establishment of Label Switched Paths (LSPs). The information model described in "Routing and Wavelength Assignment Information Model for Wavelength Switched Optical Networks" (RFC 7446) shows what information is required at specific points in the WSON. Part of the WSON information model contains aspects that may be of general applicability to other technologies, while other parts are specific to WSONs.</t>
      <t>This document provides efficient, protocol-agnostic encodings for the WSON-specific information fields. It is intended that protocol- specific documents will reference this memo to describe how information is carried for specific uses. Such encodings can be used to extend GMPLS signaling and routing protocols. In addition, these encodings could be used by other mechanisms to convey this same information to a Path Computation Element (PCE).</t>
    </abstract>
  </front>
  <seriesInfo name="RFC" value="7581"/>
  <seriesInfo name="DOI" value="10.17487/RFC7581"/>
</reference>


<reference anchor="I-D.ietf-netmod-rfc8407bis">
   <front>
      <title>Guidelines for Authors and Reviewers of Documents Containing YANG Data Models</title>
      <author fullname="Andy Bierman" initials="A." surname="Bierman">
         <organization>YumaWorks</organization>
      </author>
      <author fullname="Mohamed Boucadair" initials="M." surname="Boucadair">
         <organization>Orange</organization>
      </author>
      <author fullname="Qin Wu" initials="Q." surname="Wu">
         <organization>Huawei</organization>
      </author>
      <date day="13" month="November" year="2024"/>
      <abstract>
	 <t>   This memo provides guidelines for authors and reviewers of
   specifications containing YANG modules, including IANA-maintained
   modules.  Recommendations and procedures are defined, which are
   intended to increase interoperability and usability of Network
   Configuration Protocol (NETCONF) and RESTCONF protocol
   implementations that utilize YANG modules.  This document obsoletes
   RFC 8407.

   Also, this document updates RFC 8126 by providing additional
   guidelines for writing the IANA considerations for RFCs that specify
   IANA-maintained modules.  The document also updates RFC 6020 by
   clarifying how modules and their revisions are handled by IANA.

	 </t>
      </abstract>
   </front>
   <seriesInfo name="Internet-Draft" value="draft-ietf-netmod-rfc8407bis-21"/>
   
</reference>

<reference anchor="RFC8040">
  <front>
    <title>RESTCONF Protocol</title>
    <author fullname="A. Bierman" initials="A." surname="Bierman"/>
    <author fullname="M. Bjorklund" initials="M." surname="Bjorklund"/>
    <author fullname="K. Watsen" initials="K." surname="Watsen"/>
    <date month="January" year="2017"/>
    <abstract>
      <t>This document describes an HTTP-based protocol that provides a programmatic interface for accessing data defined in YANG, using the datastore concepts defined in the Network Configuration Protocol (NETCONF).</t>
    </abstract>
  </front>
  <seriesInfo name="RFC" value="8040"/>
  <seriesInfo name="DOI" value="10.17487/RFC8040"/>
</reference>

<reference anchor="RFC4252">
  <front>
    <title>The Secure Shell (SSH) Authentication Protocol</title>
    <author fullname="T. Ylonen" initials="T." surname="Ylonen"/>
    <author fullname="C. Lonvick" initials="C." role="editor" surname="Lonvick"/>
    <date month="January" year="2006"/>
    <abstract>
      <t>The Secure Shell Protocol (SSH) is a protocol for secure remote login and other secure network services over an insecure network. This document describes the SSH authentication protocol framework and public key, password, and host-based client authentication methods. Additional authentication methods are described in separate documents. The SSH authentication protocol runs on top of the SSH transport layer protocol and provides a single authenticated tunnel for the SSH connection protocol. [STANDARDS-TRACK]</t>
    </abstract>
  </front>
  <seriesInfo name="RFC" value="4252"/>
  <seriesInfo name="DOI" value="10.17487/RFC4252"/>
</reference>

<reference anchor="RFC8446">
  <front>
    <title>The Transport Layer Security (TLS) Protocol Version 1.3</title>
    <author fullname="E. Rescorla" initials="E." surname="Rescorla"/>
    <date month="August" year="2018"/>
    <abstract>
      <t>This document specifies version 1.3 of the Transport Layer Security (TLS) protocol. TLS allows client/server applications to communicate over the Internet in a way that is designed to prevent eavesdropping, tampering, and message forgery.</t>
      <t>This document updates RFCs 5705 and 6066, and obsoletes RFCs 5077, 5246, and 6961. This document also specifies new requirements for TLS 1.2 implementations.</t>
    </abstract>
  </front>
  <seriesInfo name="RFC" value="8446"/>
  <seriesInfo name="DOI" value="10.17487/RFC8446"/>
</reference>

<reference anchor="RFC9000">
  <front>
    <title>QUIC: A UDP-Based Multiplexed and Secure Transport</title>
    <author fullname="J. Iyengar" initials="J." role="editor" surname="Iyengar"/>
    <author fullname="M. Thomson" initials="M." role="editor" surname="Thomson"/>
    <date month="May" year="2021"/>
    <abstract>
      <t>This document defines the core of the QUIC transport protocol. QUIC provides applications with flow-controlled streams for structured communication, low-latency connection establishment, and network path migration. QUIC includes security measures that ensure confidentiality, integrity, and availability in a range of deployment circumstances. Accompanying documents describe the integration of TLS for key negotiation, loss detection, and an exemplary congestion control algorithm.</t>
    </abstract>
  </front>
  <seriesInfo name="RFC" value="9000"/>
  <seriesInfo name="DOI" value="10.17487/RFC9000"/>
</reference>

<reference anchor="RFC3688">
  <front>
    <title>The IETF XML Registry</title>
    <author fullname="M. Mealling" initials="M." surname="Mealling"/>
    <date month="January" year="2004"/>
    <abstract>
      <t>This document describes an IANA maintained registry for IETF standards which use Extensible Markup Language (XML) related items such as Namespaces, Document Type Declarations (DTDs), Schemas, and Resource Description Framework (RDF) Schemas.</t>
    </abstract>
  </front>
  <seriesInfo name="BCP" value="81"/>
  <seriesInfo name="RFC" value="3688"/>
  <seriesInfo name="DOI" value="10.17487/RFC3688"/>
</reference>

<reference anchor="RFC8340">
  <front>
    <title>YANG Tree Diagrams</title>
    <author fullname="M. Bjorklund" initials="M." surname="Bjorklund"/>
    <author fullname="L. Berger" initials="L." role="editor" surname="Berger"/>
    <date month="March" year="2018"/>
    <abstract>
      <t>This document captures the current syntax used in YANG module tree diagrams. The purpose of this document is to provide a single location for this definition. This syntax may be updated from time to time based on the evolution of the YANG language.</t>
    </abstract>
  </front>
  <seriesInfo name="BCP" value="215"/>
  <seriesInfo name="RFC" value="8340"/>
  <seriesInfo name="DOI" value="10.17487/RFC8340"/>
</reference>




    </references>

</references>


<?line 2779?>

<section anchor="yang-tree"><name>The Complete Schema Trees</name>

<t>This appendix presents the complete tree of the Layer 0 Types data model. See <xref target="RFC8340"/> for an explanation of the symbols used. The data type of every leaf node is shown near the right end of the corresponding line.</t>

<figure anchor="fig-yang-tree"><artwork type="ascii-art"><![CDATA[
module: ietf-layer0-types

  grouping wdm-label-start-end:
    +-- (grid-type)?
       +--:(fixed-dwdm)
       |  +-- dwdm-n?    l0-types:dwdm-n
       +--:(cwdm)
       |  +-- cwdm-n?    l0-types:cwdm-n
       +--:(flexi-grid)
          +-- flexi-n?   l0-types:flexi-n
  grouping wdm-label-step:
    +-- (l0-grid-type)?
       +--:(fixed-dwdm)
       |  +-- wson-dwdm-channel-spacing?    identityref
       +--:(cwdm)
       |  +-- wson-cwdm-channel-spacing?    identityref
       +--:(flexi-grid)
          x-- flexi-grid-channel-spacing?   identityref
          +-- flexi-ncfg?                   identityref
          +-- flexi-n-step?                 uint8
  grouping wdm-label-hop:
    +-- (grid-type)?
       +--:(fixed-dwdm)
       |  +-- (fixed-single-or-super-channel)?
       |     +--:(single)
       |     |  +-- dwdm-n?               l0-types:dwdm-n
       |     +--:(multi)
       |        +-- subcarrier-dwdm-n*    l0-types:dwdm-n
       +--:(cwdm)
       |  +-- cwdm-n?                     l0-types:cwdm-n
       +--:(flexi-grid)
          +-- (single-or-super-channel)?
             +--:(single)
             |  +-- flexi-n?              l0-types:flexi-n
             |  +-- flexi-m?              l0-types:flexi-m
             x--:(super)
             |  x-- subcarrier-flexi-n* [flexi-n]
             |     +-- flexi-n?   l0-types:flexi-n
             |     +-- flexi-m?   l0-types:flexi-m
             +--:(multi)
                +-- frequency-slots
                   +-- frequency-slot* [flexi-n]
                      +-- flexi-n?   l0-types:flexi-n
                      +-- flexi-m?   l0-types:flexi-m
  grouping wdm-label-range-info:
    +-- grid-type?    identityref
    +-- priority?     uint8
    +-- flexi-grid
       +-- slot-width-granularity?   identityref
       +-- min-slot-width-factor?    uint16
       +-- max-slot-width-factor?    uint16
  grouping wson-label-start-end:
    +-- (grid-type)?
       +--:(dwdm)
       |  +-- dwdm-n?   l0-types:dwdm-n
       +--:(cwdm)
          +-- cwdm-n?   l0-types:cwdm-n
  grouping wson-label-hop:
    +-- (grid-type)?
       +--:(dwdm)
       |  +-- (single-or-super-channel)?
       |     +--:(single)
       |     |  +-- dwdm-n?              l0-types:dwdm-n
       |     +--:(super)
       |        +-- subcarrier-dwdm-n*   l0-types:dwdm-n
       +--:(cwdm)
          +-- cwdm-n?                    l0-types:cwdm-n
  grouping l0-label-range-info:
    +-- grid-type?   identityref
    +-- priority?    uint8
  grouping wson-label-step:
    +-- (l0-grid-type)?
       +--:(dwdm)
       |  +-- wson-dwdm-channel-spacing?   identityref
       +--:(cwdm)
          +-- wson-cwdm-channel-spacing?   identityref
  grouping flexi-grid-label-start-end:
    +-- flexi-n?   l0-types:flexi-n
  grouping flexi-grid-frequency-slot:
    +-- flexi-n?   l0-types:flexi-n
    +-- flexi-m?   l0-types:flexi-m
  grouping flexi-grid-label-hop:
    +-- (single-or-super-channel)?
       +--:(single)
       |  +-- flexi-n?              l0-types:flexi-n
       |  +-- flexi-m?              l0-types:flexi-m
       x--:(super)
       |  x-- subcarrier-flexi-n* [flexi-n]
       |     +-- flexi-n?   l0-types:flexi-n
       |     +-- flexi-m?   l0-types:flexi-m
       +--:(multi)
          +-- frequency-slots
             +-- frequency-slot* [flexi-n]
                +-- flexi-n?   l0-types:flexi-n
                +-- flexi-m?   l0-types:flexi-m
  grouping flexi-grid-label-range-info:
    +-- grid-type?    identityref
    +-- priority?     uint8
    +-- flexi-grid
       +-- slot-width-granularity?   identityref
       +-- min-slot-width-factor?    uint16
       +-- max-slot-width-factor?    uint16
  grouping flexi-grid-label-step:
    x-- flexi-grid-channel-spacing?   identityref
    +-- flexi-ncfg?                   identityref
    +-- flexi-n-step?                 uint8
  grouping transceiver-mode:
    +--ro (mode)
       +--:(G.698.2)
       |  +--ro standard-mode?              standard-mode
       |  +--ro line-coding-bitrate*        identityref
       |  +--ro transmitter-tuning-range
       |  |  +--ro min-central-frequency?    frequency-thz
       |  |  +--ro max-central-frequency?    frequency-thz
       |  |  +--ro transceiver-tunability?   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 transmitter-tuning-range
       |     |  +--ro min-central-frequency?    frequency-thz
       |     |  +--ro max-central-frequency?    frequency-thz
       |     |  +--ro transceiver-tunability?   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 transmitter-tuning-range
             |  +--ro min-central-frequency?    frequency-thz
             |  +--ro max-central-frequency?    frequency-thz
             |  +--ro transceiver-tunability?   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
  grouping transceiver-capabilities:
    +--ro supported-modes!
       +--ro supported-mode* [mode-id]
          +--ro mode-id?                          string
          +--ro (mode)
             +--:(G.698.2)
             |  +--ro standard-mode?              standard-mode
             |  +--ro line-coding-bitrate*        identityref
             |  +--ro transmitter-tuning-range
             |  |  +--ro min-central-frequency?    frequency-thz
             |  |  +--ro max-central-frequency?    frequency-thz
             |  |  +--ro transceiver-tunability?   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 transmitter-tuning-range
             |     |  +--ro min-central-frequency?    frequency-thz
             |     |  +--ro max-central-frequency?    frequency-thz
             |     |  +--ro transceiver-tunability?   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 transmitter-tuning-range
                   |  +--ro min-central-frequency?    frequency-thz
                   |  +--ro max-central-frequency?    frequency-thz
                   |  +--ro transceiver-tunability?   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-codes*
                      |       -> ../../../../supported-mode/mode-id
                      +--ro supported-organizational-modes*
                              -> ../../../../supported-mode/mode-id
  grouping standard-mode:
    +--ro standard-mode?   standard-mode
  grouping organizational-mode:
    +--ro operational-mode?          operational-mode
    +--ro organization-identifier?   organization-identifier
  grouping penalty-value:
    +--ro penalty-value    union
  grouping explicit-mode:
    +--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-null
    +--ro pdl-penalty* [pdl-value]
    |  +--ro pdl-value        power-loss
    |  +--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
  grouping common-standard-organizational-mode:
    +--ro line-coding-bitrate*   identityref
  grouping transmitter-tuning-range:
    +-- min-central-frequency?    frequency-thz
    +-- max-central-frequency?    frequency-thz
    +-- transceiver-tunability?   frequency-ghz
  grouping common-all-modes:
    +--ro transmitter-tuning-range
    |  +--ro min-central-frequency?    frequency-thz
    |  +--ro max-central-frequency?    frequency-thz
    |  +--ro transceiver-tunability?   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
  grouping common-transceiver-param:
    +-- line-coding-bitrate?   identityref
    +-- tx-channel-power?      power-dbm-or-null
    +--ro rx-channel-power?      power-dbm-or-null
    +--ro rx-total-power?        power-dbm-or-null
  grouping common-transceiver-configured-param:
    +-- line-coding-bitrate?   identityref
    +-- tx-channel-power?      power-dbm-or-null
  grouping common-transceiver-readonly-param:
    +--ro rx-channel-power?   power-dbm-or-null
    +--ro rx-total-power?     power-dbm-or-null
  grouping l0-tunnel-attributes:
    +-- wavelength-assignment?   identityref
  grouping frequency-range:
    +-- lower-frequency    frequency-thz
    +-- upper-frequency    frequency-thz
  grouping l0-path-constraints:
    +-- gsnr-extra-margin?   snr
  grouping l0-path-properties:
    +--ro estimated-gsnr?          snr
    +--ro estimated-eol-gsnr?      snr
    +--ro estimated-lowest-gsnr?   snr
]]></artwork></figure>

</section>
<section anchor="changes-bis"><name>Changes from RFC 9093</name>

<t>This version adds new identities, data types, and groupings to the 'ietf-layer0-types' YANG module.</t>

<t>The following new YANG identities have been added to the 'ietf-layer0-types' module:</t>

<t><list style="symbols">
  <t>cwdm-ch-spc-type</t>
  <t>flexi-ncfg-type</t>
  <t>flexi-ncfg-6p25gh</t>
  <t>modulation</t>
  <t>DPSK</t>
  <t>QPSK</t>
  <t>DP-QPSK</t>
  <t>QAM8</t>
  <t>DP-QAM8</t>
  <t>QAM16</t>
  <t>DP-QAM16</t>
  <t>QAM32</t>
  <t>DP-QAM32</t>
  <t>QAM64</t>
  <t>DP-QAM64</t>
  <t>fec-type</t>
  <t>g-fec</t>
  <t>super-fec</t>
  <t>no-fec</t>
  <t>sc-fec</t>
  <t>o-fec</t>
  <t>c-fec</t>
  <t>line-coding</t>
  <t>line-coding-NRZ-2p5G</t>
  <t>line-coding-NRZ-OTU1</t>
  <t>line-coding-NRZ-10G</t>
  <t>line-coding-NRZ-OTU2</t>
  <t>line-coding-OTL4.4-SC</t>
  <t>line-coding-FOIC1.4-SC</t>
  <t>wavelength-assignment</t>
  <t>first-fit-wavelength-assignment</t>
  <t>random-wavelength-assignment</t>
  <t>least-loaded-wavelength-assignment</t>
  <t>lower-first-wavelength-assignment</t>
  <t>upper-first-wavelength-assignment</t>
  <t>type-power-mode</t>
  <t>power-spectral-density</t>
  <t>carrier-power</t>
  <t>switching-wson-lsc</t>
  <t>switching-flexi-grid-lsc</t>
</list></t>

<t>The following new YANG data types have been added to the 'ietf-layer0-types' module:</t>

<t><list style="symbols">
  <t>Standard-mode</t>
  <t>Organization-identifier</t>
  <t>Operational-mode</t>
  <t>frequency-thz</t>
  <t>frequency-ghz</t>
  <t>snr</t>
  <t>snr-or-null</t>
  <t>fiber-type</t>
  <t>decimal-2</t>
  <t>decimal-2-or-null</t>
  <t>power-gain</t>
  <t>power-gain-or-null</t>
  <t>power-loss</t>
  <t>power-loss-or-null</t>
  <t>power-ratio</t>
  <t>power-ratio-or-null</t>
  <t>power-dbm</t>
  <t>power-dbm-or-null</t>
  <t>decimal-5</t>
  <t>decimal-5-or-null</t>
  <t>psd</t>
  <t>psd-or-null</t>
</list></t>

<t>The following new YANG groupings have been added to the 'ietf-layer0-types' module:</t>

<t><list style="symbols">
  <t>wdm-label-start-end</t>
  <t>wdm-label-step</t>
  <t>wdm-label-hop</t>
  <t>wdm-label-range-info</t>
  <t>transceiver-mode</t>
  <t>transceiver-capabilities</t>
  <t>standard-mode</t>
  <t>organizational-mode</t>
  <t>penalty-value</t>
  <t>explicit-mode</t>
  <t>common-standard-organizational-mode</t>
  <t>transmitter-tuning-range</t>
  <t>common-all-mode</t>
  <t>common-transceiver-param</t>
  <t>common-transceiver-configured-param</t>
  <t>common-transceiver-readonly-param</t>
  <t>l0-tunnel-attributes</t>
  <t>frequency-range</t>
  <t>l0-path-constraints</t>
  <t>l0-path-properties</t>
</list></t>

</section>
<section numbered="false" anchor="acknowledgments"><name>Acknowledgments</name>

<t>The authors and the working group give their sincere thanks to Robert
Wilton for the YANG doctor review and to Adrian Farrel and Tom Petch for their comments
during the model and document development.</t>

<t>This document was prepared using kramdown.</t>

</section>

    <section anchor="contributors" numbered="false" toc="include" removeInRFC="false">
        <name>Contributors</name>
    <contact initials="H." surname="Zheng" fullname="Haomian Zheng">
      <organization>Huawei</organization>
      <address>
        <email>zhenghaomian@huawei.com</email>
      </address>
    </contact>
    <contact initials="D." surname="King" fullname="Daniel King">
      <organization>University of Lancaster</organization>
      <address>
        <email>d.king@lancaster.ac.uk</email>
      </address>
    </contact>
    <contact initials="G." surname="Galimberti" fullname="Gabriele Galimberti">
      <organization>Cisco</organization>
      <address>
        <email>ggalimbe@cisco.com</email>
      </address>
    </contact>
    <contact initials="E." surname="Griseri" fullname="Enrico Griseri">
      <organization>Nokia</organization>
      <address>
        <email>Enrico.Griseri@nokia.com</email>
      </address>
    </contact>
    <contact initials="D." surname="Dhody" fullname="Dhruv Dhody">
      <organization>Huawei</organization>
      <address>
        <email>dhruv.ietf@gmail.com</email>
      </address>
    </contact>
    <contact initials="B. Y." surname="Yoon" fullname="Bin Yeong Yoon">
      <organization>ETRI</organization>
      <address>
        <email>byyun@etri.re.kr</email>
      </address>
    </contact>
    <contact initials="R." surname="Vilalta" fullname="Ricard Vilalta">
      <organization>CTTC</organization>
      <address>
        <email>ricard.vilalta@cttc.es</email>
      </address>
    </contact>
    <contact initials="Y." surname="Lee" fullname="Young Lee">
      <organization>Samsung</organization>
      <address>
        <email>younglee.tx@gmail.com</email>
      </address>
    </contact>
    <contact initials="V." surname="Lopez" fullname="Victor Lopez">
      <organization>Nokia</organization>
      <address>
        <email>victor.lopez@nokia.com</email>
      </address>
    </contact>
    </section>

  </back>

<!-- ##markdown-source:
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
rldhjs9QAeEqv9Q7wP2QpwL8/wskCWUmpwEA

-->

</rfc>

