<?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.6.17 (Ruby 2.7.0) -->


<!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-11" 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="July" day="25"/>

    
    <workgroup>CCAMP Working Group</workgroup>
    

    <abstract>


<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>


<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.</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>l0-types</c>
      <c>ietf-layer0-types</c>
      <c>RFC XXXX</c>
</texttable>

<t>RFC Editor Note:
Please replace XXXX with the RFC number assigned to this document and remove this note.</t>

</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>otu-type:</dt>
  <dd>
    <t>This specifies the type of OTU, including the types specified in <xref target="ITU-T_G.709"/>.</t>
  </dd>
  <dt/>
  <dd>
    <t>Since <xref target="ITU-T_G.Sup43"/> does not guarantee interoperability in the data plane, the type of OTUk defined in <xref target="ITU-T_G.Sup43"/> can be defined in vendor-specific YANG modules using the otu-type identity, defined in this document, as the base.</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>
</dl>

<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" anchor="yang-tree">
  <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-tree-for-layer-0-types-groupings"><name>YANG Tree for Layer 0 Types Groupings</name>

<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:
    +-- (mode)
       +--:(G.698.2)
       |  +--ro standard-mode?            standard-mode
       |  +--ro line-coding-bitrate*      identityref
       |  +-- min-central-frequency?    frequency-thz
       |  +-- max-central-frequency?    frequency-thz
       |  +-- 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 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 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:
    +-- 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 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 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 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-dependant-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:
    +-- min-central-frequency?    frequency-thz
    +-- max-central-frequency?    frequency-thz
    +-- 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="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-03-04.yang"><![CDATA[
module ietf-layer0-types {
  yang-version 1.1;
  namespace "urn:ietf:params:xml:ns:yang:ietf-layer0-types";
  prefix l0-types;

  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-07-23 {
    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 otu-type {
    description
      "Base identity from which specific OTU identities are derived";
    reference
      "ITU-T G.709: Interfaces for the Optical Transport Network";
  }

    identity OTU1 {
      base otu-type;
      description
        "OTU1 (2.66 Gb/s)";
      reference
        "ITU-T G.709 v6.0 (06/2020): Interfaces for the Optical
        Transport Network (OTN)";
    }

    identity OTU2 {
      base otu-type;
      description
        "OTU2 (10.70 Gb/s)";
      reference
        "ITU-T G.709 v6.0 (06/2020): Interfaces for the Optical
        Transport Network (OTN)";
    }

    identity OTU3 {
      base otu-type;
      description
        "OTU3 (43.01 Gb/s)";
      reference
        "ITU-T G.709 v6.0 (06/2020): Interfaces for the Optical
        Transport Network (OTN)";
    }

    identity OTU4 {
      base otu-type;
      description
        "OTU4 (111.80 Gb/s)";
      reference
        "ITU-T G.709 v6.0 (06/2020): Interfaces for the Optical
        Transport Network (OTN)";
    }

    identity OTUCn {
      base otu-type;
      description
        "OTUCn (n x 105.25 Gb/s)";
      reference
        "ITU-T G.709 v6.0 (06/2020): Interfaces for the Optical
        Transport Network (OTN)";
    }

  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)";
    }

/*
 * 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 {
      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.";
      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.";

    uses transmitter-tuning-range;
    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>The YANG module specified in this document defines a schema for data
   that is designed to be accessed via network management protocols such
   as NETCONF <xref target="RFC6241"/> or RESTCONF <xref target="RFC8040"/>.  The lowest NETCONF layer
   is the secure transport layer, and the mandatory-to-implement secure
   transport is Secure Shell (SSH) <xref target="RFC6242"/>.  The lowest RESTCONF layer
   is HTTPS, and the mandatory-to-implement secure transport is TLS
   <xref target="RFC8446"/>.</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.  The NETCONF protocol over
   Secure Shell (SSH) specification <xref target="RFC6242"/> describes a method for
   invoking and running NETCONF within a Secure Shell (SSH) session as
   an SSH subsystem.</t>

<t>The objects in this YANG module are common data types and groupings.
   No object in this module can be read or written to.  These
   definitions can be imported and used by other Layer 0 specific
   modules.  It is critical to consider how imported definitions will be
   utilized and accessible via RPC operations, as the resultant schema
   will have data nodes that can be writable, or readable, and will have
   a significant effect on the network operations if used incorrectly or
   maliciously.  All of these considerations belong in the document that
   defines the modules that import from this YANG module.  Therefore, it
   is important to manage access to resultant data nodes that are
   considered sensitive or vulnerable in some network environments.</t>

<t>The security considerations spelled out in the YANG 1.1 specification
   <xref target="RFC7950"/> apply for this document as well.</t>

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

<t>For the following URI in the "IETF XML Registry" <xref target="RFC3688"/>, IANA has updated the reference field 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 also adds an updated YANG module to the "YANG Module
Names" registry <xref target="RFC7950"/>:</t>

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

<t>RFC Editor Note: Please replace XXXX with the RFC number assigned to this document.</t>

</section>


  </middle>

  <back>


    <references title='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' target='https://www.rfc-editor.org/info/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' target='https://www.rfc-editor.org/info/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' target='https://www.rfc-editor.org/info/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' target='https://www.rfc-editor.org/info/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' target='https://www.rfc-editor.org/info/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' target='https://www.rfc-editor.org/info/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' target='https://www.rfc-editor.org/info/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='RFC6205' target='https://www.rfc-editor.org/info/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' target='https://www.rfc-editor.org/info/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' target='https://www.rfc-editor.org/info/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' target='https://datatracker.ietf.org/doc/html/draft-ietf-ccamp-optical-impairment-topology-yang-16'>
   <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='5' month='July' 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-16'/>
   
</reference>

<reference anchor='RFC8795' target='https://www.rfc-editor.org/info/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' target='https://www.rfc-editor.org/info/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='I-D.ietf-teas-rfc8776-update' target='https://datatracker.ietf.org/doc/html/draft-ietf-teas-rfc8776-update-12'>
   <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='25' month='July' 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-12'/>
   
</reference>

<reference anchor='RFC8363' target='https://www.rfc-editor.org/info/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='RFC8040' target='https://www.rfc-editor.org/info/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='RFC6242' target='https://www.rfc-editor.org/info/rfc6242'>
  <front>
    <title>Using the NETCONF Protocol over Secure Shell (SSH)</title>
    <author fullname='M. Wasserman' initials='M.' surname='Wasserman'/>
    <date month='June' year='2011'/>
    <abstract>
      <t>This document describes a method for invoking and running the Network Configuration Protocol (NETCONF) within a Secure Shell (SSH) session as an SSH subsystem. This document obsoletes RFC 4742. [STANDARDS-TRACK]</t>
    </abstract>
  </front>
  <seriesInfo name='RFC' value='6242'/>
  <seriesInfo name='DOI' value='10.17487/RFC6242'/>
</reference>

<reference anchor='RFC8446' target='https://www.rfc-editor.org/info/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='RFC8341' target='https://www.rfc-editor.org/info/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>




    </references>

    <references title='Informative References'>

<reference anchor="ITU-T_G.Sup43" >
  <front>
    <title>Transport of IEEE 10GBASE-R in optical transport networks (OTN)</title>
    <author >
      <organization>International Telecommunication Union</organization>
    </author>
    <date year="2003" month="December"/>
  </front>
  <seriesInfo name="ITU-T Supplement G.Sup43" value=""/>
</reference>
<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' target='https://www.rfc-editor.org/info/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' target='https://www.rfc-editor.org/info/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' target='https://www.rfc-editor.org/info/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='RFC3688' target='https://www.rfc-editor.org/info/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>




    </references>


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

<t>This version adds new data types, identities, and groupings to the YANG modules.</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 identities have been added to the 'ietf-layer0-types' module:</t>

<t><list style="symbols">
  <t>identity cwdm-ch-spc-type</t>
  <t>identity flexi-ncfg-type</t>
  <t>identity flexi-ncfg-6p25gh</t>
  <t>identity modulation</t>
  <t>identity DPSK</t>
  <t>identity QPSK</t>
  <t>identity DP-QPSK</t>
  <t>identity QAM8</t>
  <t>identity DP-QAM8</t>
  <t>identity QAM16</t>
  <t>identity DP-QAM16</t>
  <t>identity QAM32</t>
  <t>identity DP-QAM32</t>
  <t>identity QAM64</t>
  <t>identity DP-QAM64</t>
  <t>identity fec-type</t>
  <t>identity g-fec</t>
  <t>identity super-fec</t>
  <t>identity no-fec</t>
  <t>identity sc-fec</t>
  <t>identity o-fec</t>
  <t>identity c-fec</t>
  <t>identity line-coding</t>
  <t>identity line-coding-NRZ-2p5G</t>
  <t>identity line-coding-NRZ-OTU1</t>
  <t>identity line-coding-NRZ-10G</t>
  <t>identity line-coding-NRZ-OTU2</t>
  <t>identity line-coding-OTL4.4-SC</t>
  <t>identity line-coding-FOIC1.4-SC</t>
  <t>identity wavelength-assignment</t>
  <t>identity first-fit-wavelength-assignment</t>
  <t>identity random-wavelength-assignment</t>
  <t>identity least-loaded-wavelength-assignment</t>
  <t>identity lower-first-wavelength-assignment</t>
  <t>identity upper-first-wavelength-assignment</t>
  <t>identity otu-type</t>
  <t>identity OTU1</t>
  <t>identity OTU2</t>
  <t>identity OTU3</t>
  <t>identity OTU4</t>
  <t>identity OTUCn</t>
  <t>identity type-power-mode</t>
  <t>identity power-spectral-density</t>
  <t>identity carrier-power</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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
wjHXXjD3R3b/VBpwu+mA2+xgXqTDIb+liCnNfKxq0FsVoDm8LXaoyss0h7lT
C3MHVj4J/opZdasA321Ki13vOGRyg52GrFQ+wasb+GnTgZ+yl2AeBMewwzFQ
De5WxaxqNgwXJxiqHhg86t/ASj4uK+Q3F2/cfQOO2FqUQ3MDziIB8W8rhVJj
yeIK+eXky0I0hcBAQ4l/D2qfxALT0Q6PDLE7gK3BamQJP04YhXHiV196xnTi
zda6nc40VPlHtqodvFykaWkgPNN/uQidxougu6y0CjZWguT8HoaktSay7OUQ
mx+qIJQNqhTVlOzU+HOQnSMYFgUIBuH1LVoDs8ZVwzXALiuvQQWKqy3IUqtA
KrOZ8daMzrp60GIy0+BL0pn63JHQLo6r0dmE0pDag+tpM1rX2sh6IoT9dMGI
SxIYetyRvByrBUS1iSmhCAALySkJt+MjZ50G3VlZNQ3RLGiiQneWVqE7KxF8
MZ7VOlQCqV6R5ko0Hyy7CD2/s4rZAc34vpxZcH55uF4O59zOyFrkU9ljW53n
7CjobbdNFwVd0l83Tt58bBCrxDom8krGc7xoF2Llg34/yik8BE4cfxQ+Yzws
H05UknPrdWcIrddZwM79c7DiPFWkbr6Z88Edt7GfyFXbWlnfPl6Cjkts6t6z
pRnq2crbJcLKExHg2WRr954tvbcVaveyuR1sPRtcQlgkcRfsb5ES81qWNnms
c2JUFSg8tZ7g2QoW88uKIEqUJKjiLIw1GV0QP/5nxAt70KEW3wi3PDKl63GI
42Rqb6Sg8m/74zQGRVx6J78qQYifCVHRCqrF8r/FkRWNiVdWyu+V08UWau28
3c0wwd3NEeI/RO01kbgaYJ4rMhAWzGipasYK57bZk//8x5r9APt/rK2v2SNU
erY0zX8LJ7FRd0KXBsCFx7kat28MjjT4VZZG2uPTs1pXjrzU2byDdOXBu4Oq
J6+Phl4tQ8JBovbg0MRDEeyTxSZ9H4P0H5hB+vfNIAdLMUj/oRhEsoSDfDmB
6O+JQ4ySS8Zy0fmjoqhRLcCRsxWBqc+bL2SpSq9WiGZ1CoGDpVZYmwiP3WTA
r6FQFlLfVyCl8u0gyeB7JP94ta02i4p+p7mopz0nUgvt922X29xft+g3Kla6
A9c/tlwCVy0H3mpOkQl5bkIf5Z3I8yieGOWSa4d/yjZ3+L/AK/zUijKokKE8
E/6qxYNXgRBD9D8f230ZhbKI7SqLUZTA3YntkilwXdyJgOs2u8bplvgZCnnU
1qf99M4CTpyrNJkpIFv+PbFfjXbyKKVo9lXoI83ND5e9qsegAm9bu1swk5Pz
t5fs7PL8VXB1ZN7axHJ/8xndE0mHRt6aglFZqtEq0shaKL3W/RfDPXp3nNaq
Xfl6nm7cSPvaZPFo4RV8r9W8LTEe/zKnY1oScPS+ntzHvzcTBLw74kDdpRiw
tyrhIlo6EqnS88OfhQ5ULW6E3x0cKfxp6kw5gvNTafaU3eCbfDCJ8wIjX/Ly
zp2IgZXu1b2dzbvRKidiYSLTnalFzEoPZ+mJevoL5inRtlLYE9pL5p6WIVjS
q+7Fa/lTtdZ3dWa/+YOf2R8E4f1VaN5FGomidVSAtk4xOdE9mMOELhUY6kkS
UtLFBS81kqjOm3nJWm8f+43j/1hzSve5dnFVfsm+LgOtjWJkYsswdoAbjKu4
xK9Ljfnx5FKTSmKr1tdswJ96u7t5DQJLmgA+IWgNiaNR3sDcDlV0O4G5TOdT
xmu7X4Ppg2FvfUsh74D1xAcA+nFvz9qSr40THe+OULvi6e7zZ3vsVRZOI7rL
i4lGFyA/40woItwdZOQF+G7BwBrmAFgtSye2gVdt2Fl9Fxt5FklpMVFDGqsw
DPtFmpXWkt8rsZdRJFP0rGSKqjXrNVmjfZn0iPnzMmHaW2eijS/3kI5yqrfT
4ypyqXXXnJvNPM8aU7pF3hd+aN5tISqWu8f4AtmkP+fyw77oUtGFwgzsh5J2
9dP7+4pN1ZDjVvAbbN6u5TEfX1ndF/JY+OEBeYyuYz/psD//wEDceun7xIZK
71EH0yjPw5GrvE/CD+5S0gDXKGEp5RZvdtBJGN2qB2vCWeMy+3Uqd8fD7oPy
VJbaB+XuC/dBuUvlPvDyRNU+cFA7HsrT7WjQ9s2zYsksIHL5fAtGQ+BBZnkY
C4ZNmzqIf98b+ZPXHsPA3rIHtpdnp81PbHVrhab9VtDDhQq+HcnWj0yrWXZs
gS3/IULj385W9bgHIgRmhC7xIssclQ6IJPjl72K5vyZPVkvOOwdXUUZ+fnEo
RvoWLf0s0VJOnQePln4Lh34Lh/6jhUO/IqnviS/Wif5jQ9CH1/hcwNvwFi9H
llIWFdd4BH9dKI4/EG4kuzSNEqqkFzn6JwOJWRandkBQufc6d9UP91x2BUdH
PxyuyUuLEE+obJoAYDl1rePLg8NF1ZRw4bc3u+BnoYdV7V4ZbGEMQS5UcJ6l
RdpPJyUGaJHvtu7Q5WvgPstbWzmRymNtPEy21Lc8qW95Ul+LM/gtT+pbntQ/
opnyBR7oU+qoOhd5UQjROKJsGkhU+Ll9fUaU83aga3eLrxdYMnczuMsOo1V8
MBeDXtsPZm3xeiYyjtzmVQToBAU+1v11ZYwqj0y+kB4O3kdZEediN2kQ0x96
cgNOozDJ5StfmVVNwuPpJW2nTJL+ioLl9HS7p1vQQ7LJLzQIo8mfekhhNXin
kQ32OV+H453kv3fI91Mw7jPfz9iQ+uEgWpOa/fhK7ydnISVctQxVyZ72DQRj
B07rd+B02R3Y8KXDr4ttGgrPu6doKoiOdb8wwuen/sLIXkVUz+USmxXL/qk/
PAZcVcxRSsqHRA3N60bMSuIef95FtzLPJLHNhzrQi9B3zap6WE1NKpwPiAc9
JUns3FlZTifHYvEF1Sps41LOppEWZc0ztydaH5YqgBsnEUgwE5zYRRMxNy1b
HALSYHOpn9ypVkQMCWr9ylSv/4Kc0ob8u4AwxrLaYrVusi4I/+Rr4pG1Eu8r
VVXLBNS0sgrUs42fIz/wW6bdQ2XaLcWUZu8mqXVexjSBfEut+5Za9y217ltq
3bfUum+pdfecWue9FLnikU3ZtTOcbB5vropqLzw8LJVl8J0gWsaEaLs727Tt
iWpfqCZ1xYokV6cXWNyuVsQ64NilSl+W4VFdVvMOvj9bxf23z1d15YylF0qV
21i4TNSytEjflsK7FNbuXOK4m0rMhgWvpy0PLjgFDS0l56IUjDEBkYkDEuvJ
6RNby7xCNfohnIJMaotAWMhPhUR9hspFMoCYXgcMIpemLW4cWV8uxrGeNfrp
fDJAzYIuATGAAeQ44a+9YyCird+bIrAygpOPJYSIZisKSBtQwE/LYVRYGv6a
vlbYeVQU8iF9a1VB5WzahHVWDf+Y5Kl4ICvMG9MzTlQMuAGr3/Vq+N088Ao1
ReWA+hEw1+JKhEQ21TPOqSJBMuDR2OtIBzb4sojFkN1NpYZVM8yhn+Sy+oJs
jXEltUJaGkQf8MwqLngJxHyMVf2wcMl8hMGcaGC/Gi4rJLII/hNlyiAL+DO1
GZaYIDEASyZfTrNHKCLYfWEhDlMQoGGppFnbhij7ckpKStUD1uCoinpKFUcG
DiX0q/MEOjfCFT4ayBLpEoQzU44PDrMHu4bXoRByxupm8kZf5u3gwZLiARCz
6Y2bym+yEZqyySAE6/UWwM0XFWk85vZ6RCjikhE+ZUahLauq25hWGn7bdkt+
wFamXuLtO3Mh3KQVWbnFDWhbBXpeOF/C8kxTlDaijT12XRdYO76iFXFxDyR/
+HZBQ2o6jMEsBUlnn/vXx3ZBqtJutbein752mJKmWU+Jlci3iIAM61FsbNTT
xk9te/966VzZ5P4pbPGpTVuYHhHBwmYpGplzKkmXJZJWDqyIP4oiXiNH1p0C
DW6Tv+TrMj6m5XyXd72cqb+7GyF3GMCdYDWrWARVTIJtMCcBlqnMJ0K5mm1I
Di7StpZEfTCta43iql1vtaP/yVoX2UjoMq1gJWO6mwPc3Nwx837FIfnnRZte
xFUKjdIryC8os3toZlTo5SHcpInbWeTDNTqJ08N6RxTqNTcGs7uVxB4ds+GH
gZ1FXyEMrZO3nj/qzacyUYeiEuN6PGU0laPiSbsXdbt+d07ZhCWNUdTNnZ2a
DDsLw+PDslPnM2grYpsknatMb8GXfHNx4m5YPO78tVaWiX9ia67MWyoVcZ8P
LuvhqpJHnHeVfSn2sttd7u3SNQ/zvotkKLc4Xkn7yNwRDrT8LWzEEBdQXeCD
/9n8uuHhT88C4w+FRi1QHuoSfe0h/l0M8UN/noHvV7TW/7O6p2lKlpYFf2pv
8agXuakeHCoEypwk9etUecx9vW1FayiDtRellSzRp/5+kTzxFrjRC+jIJw3w
aqj+fdq+hKaPzTw24D8+p3kmfa/85vEBlmW5B+K41TC7C9t5szLIuvRo0Fwa
jbb16WnEmyw0IB0701tOtrpGValcLDeW0GIZzUMYsogibneSwBcXeHRw77hQ
Z0rgt5g1ZCkYR5Vj6UyEAkD6XOxlcHjZ/zW4LT623q+L6sHChcgtQxQNIbQo
sH+ifQCx2HwSWdTHcrQDlfXBm/EsDB89lF3g8+y99kvFjRgf9WqDbjXOutcD
4KXNwObPzKqowho3OdgEnJtHerzYqUOVqgqrgjDu16vQhjflZQHNir0YiuE4
qUQeYzOZ+kLX481Za/94vWLLcvL4IvwLKgXLyfpbrTLnxeWEKz3ihZwzi6BD
cRvwhNgantkXzr+RmSTj9wKGSKpV7qNISDfOymX9StWDkndZqxN1wL06OGyz
8xP8z+Hb9Y7DWl48/bUxqmt94Y+33pexxKq/WUXD+LZUq6piKZcKU6I+PLs8
vVCECfM87cehFXyVuWgyi0D317VsmfAJQXaRTK8rcYeiVcNYroBHBTd5g1le
btKi2AooyDmCIFaq0tKgirz+2spmZIOOYIQuzK3cUUMR6AElEFUdWRN1Ek9j
8Uab7f63wP2khaN8BeJevf4fiKPp88O3bfazzLogaPyC47oRlj9ORIR26ES7
XAFdjF1VJkEAyoScfXllAqYAekJAk+A6BmoWS90F1r09IeXmQuwl0AyH3phQ
BdqUV6LmAkSSnM8phD2TU0VY3xmYwbKusSHuvDzt9DqbPsHtnzxPhHrh7O/X
0HgDIC7Y5TX3DDKskSeHbKk7k3iFrbteOXMNxSGBORHM5sHScAHxejAAHr5l
zrTKtTPFzGb5SnOSyUaHoiRdEdP9Lxif8fFpRrE4TuGxDPhLQ5iEifduOE6m
P85SPMnrw7RUVdaK+ZgcWiHMXWE9yzd0SeiVZo0FuGYFZQTAr/OpyMlSeDMD
79bBoZkUmiaWRHZJgCKpPwik4FeTwzgYfE4SeBXMz2ZCZlSplFBmAOj56O7V
EyOErNNvkrpStKLMBLlHksuyC1DQJyq8bKbx5fqgcDhP+B6WXX9gw5Z9fZ8/
hTFwDYFKrq9iguqIol9xV+cP4m4/UPQ6tOnle2aVTDbLoKnYFrMU8wKEDUlu
+gNtj4fYGybyzDz9QIAGkUBprldtEn/ugxL7u7uiqHoPi6ofjEOs2RZlwIpx
P+devMbBWGGUUAYKGI+MkhwXPecqd6gw4XF2k2lEWy7jSpM04Pp2+mxasdXx
iy+01+vmIJanyaaHhtauX3W744DuflfUuU8r38P99ysUzk3CniBhDx3C3p90
GEQzPMNLCqvocal8sKwteI++ywIxUCkSTBoK3Hld4Rb6f03U5mwwqdhM8MVn
3UysYjd5Z9ZoMx2+vasKRRC4nwSI8p6SRCrtKU+16fvbGMtoDUU+E4Km5Mq7
R10IR6WKA+MOWvKNJN3zTm7RiQLDh6QDQHkTzTy6jRPlwhrUQIYQ8SuvbR0n
AcUVnAhlouNQ5XrQS+EvHWC885/zsBxi2+30WDI1a+BeA6NQbr5xiyFWenbA
gYQFu0DBhrVhtcdHsXjdq5V9COBLlaJOzdcxSjGhjnT74OT4NOCOeYiVzvtZ
hM+qm+4InWqn5BUGdEUF+CbNi+DV0QFLomiQi3QI8PjBsYwGPvr6MPHKXrPi
9ZKOpLxdzYHT1g9zgzo81IYxORXOw0iKhoJyRDKCT4xmH+wJ+GVqqdVDCljF
FTSUsWh6gX2kXyBUOQXvw0ZxiVESrn5qVUhakzn8G/J+7ZILSV2qEr26DQI8
9XPpell98GFh2NRKikDh8rMYAEQD7sxiDDJlnE6821HL9etwPgg8wR5PoWdP
qedKT+nlYCUh+VJhUyfeDd6QsUpDvJuZ7xqeuFyB6KEgMNrkt9PrdEIhN4z1
anXFPzJa4nMx1BiXPMMwWkpJdkaT2XzCOUJ+3TEBHBfqksd8es0v0Q3QCYOd
I0CbKmuMtjmocB7gosT8Il8HVsbYZmolDDORTDSNczKap9Egtu6EGQjHeJmB
VjCcTKxXAcTcgeHFkMhOTMYhvUGpLJ1MgnQ4XIV9to1tqP2QnmebLdwBBg+R
MSyxEnuidR0VIZeZwkCkt3K6SMaeGYNSh0Y5G6c3wrAGQgh65OMQDzw+9CM7
jwua4UYijumw4+EPXVGUPfoACACRp6G4EFPVCfr0ONOLxaYxcmeRd7r/SwZE
VVfc8Pz915hOypn54xdG8vkO/501/ezCaPxxNWVsXfKQdxVz6xa0vMsyEGFS
M3Ah771TDpR4l8N8XglJcJPCCk3TUZRE6TxnZ1eX5m2VFn9faRy+F6IknOoY
ct+JfwCWfCh++cRkWDUmnn72x/wkMaYVuKWz8dkk7AMvJNGHgs5icCFSTL60
F5pO8KUhMphH8n0tUEZTMgQn4cyc9lRoXEuv4QJnNNhoAjsI32ky9bhxLjLG
B3os2gh+nNOlHEqm4c+QOxGfKBnRsz7uGz9y1VBahYnxNIGxRGW6qatNuFrh
4L9CpDCh443Wa600jPrLuhmyywrCY21fPboFmtN7Vw2AowRcWVM+84o6f7Bx
Mb6ApUanCl9lAHxpfC3JIHESUYuXR+B4oGHO9ysaLqbCBTGCq4Kvl6UZ2LoF
vyPvvU8Icg1dpyAFp63GjVvSqSBvS76KiApEuJfKS1MsztVvYeCfy9f/QJjP
RTCLP85obR/3Vl/NPpIuDr+eF7Fgq9MdvOR+n7olaEgegRNmjylpM5xnmOUj
notriMC6dltBADoeJ7vMDaPLdCwiuSqcjrHhjtHRtXHV3yKohgH+MbjHP7He
863OU3b15qN8J7XBLdez41fBdrf714ug2+t099gx+ip4Ts3Nu/1RFtGfjBp5
M1jmBZgRD8FXdFKt80LCd9ZicQdM2HioO0ZZKXqGLQA/VAoWA+rFNjmvcoFU
UyMEIdASS04kUlcPgHMLK/OYnEzrXQcJ0dofOMdKJAw6L8MpGggMUsspD80o
hRNlFv6qsm28sQ7igVUZyGYXbyiV84iBhOn1cokWcqOs1FLKp7+QqPmtImyb
PzRZLZrm76KbBz67R8L+JfiN4VD4hkl/Mh9wKoWiELNI9LFj7lVRbf8ZUZFO
ooyMKJ4u83BS7JOVwercncIG6rsGFwHrspQOeMabkWxDkSK8G159H81327V0
vUQzA88r/zpydMxrMmQNNMjZMdWynb1TmwttmfgXxkUzGbTDtHAZKFT5aIrs
1suzVn6kmcMqMsvTxD+V+0ovsvmxAc/5LvFxmRcUc4zj8ufkFqbwCjnJ+wiD
tjX8G0htsHzAAKXfwg/rTi4l+crcKNKPEVZ6y4XhLdc4xrMQi5tSQr9xRU27
WHZll8KsBlNUzKUy9+nzIS90/x2RNzWqkW8PzWXpiiahihXwN5Ez5gBbwJgA
RxpftsjxuRV8M3pz5zU3NPAx/55pkn5iZY6v4l+/MFaXh1eTvJTOXyFZeXd9
F86D0wvburGD9BhvvuvpDZeikuvBApzNpckiM+RiWcakwuRykAo/3BdSgpsb
ImUoqfJ5xv2TiqrGLUOpMk73TqlVcCrSIrxPjIy9Ls/Osw/GU3I3zlV5+dKv
1yvhofrQKRiOb6hRDRvpiNvGSrWSU3vZv9VNYUciqlaj8ZuhuO2VOOM3zBMj
TVYBVInWFLtEhc/NR3HDVN0SURetDOHgQU/34Ji+qG+eReEASWc0dnPhGwyy
mBxqGg9IkodOEr/HfHAfSxtvHBWlZ5jKJqRBBw3jCxiNFeK+SlyUErdqEgb4
PU4VVVMhPALmuxGiAZh3Q5reCPEtCuJh9j/55fKKnZ5dqdN2AdBdLw1Br1Od
HELBZ6yo9daBth2wUFo6ZNUOYvXWbiixsFNAfPPQG9XVeo0ZZtm0E4eL7JSM
++eixdr0oWdKQzWYJ5+d6X6uPM8yM2tGWpqXsRjGnBjDaF7DvueaU3nRoNso
67IWFdiGv/WDcevsas5NCocXdVWfIMxRRBMTN1cb3v61CoStGY/V7U8mqbjU
eRIV49TOCSm9n6qcqsXOtXWPzHyDcaJSiGDTwm/X6TwZ8J0ue2s/Szjk/OpP
SAHedY+0tEe7fHP2y9tDS1bSsSXigOE66+1/JUj4OZPoe60LXs1z+YIhf/xw
KhMF4gQcvlDLVm4E0JZazqte+p4jJ6EehEiIOp4rf93aIaRXQtAqLIuxfMEa
H7B2pmw9XV35cDXNgzOAHtr7CLLiGbO7r+bvp5Xp6eKxGj09hUnxOD3Qz2Mu
5a9ricK68lxeAzLembpWN95ka+MA36lkmidZEH0AIOBXZaOSA2odZMnzXX68
65Mp/G3b7gIK78OkBoNY3r/k43L84XO+OQtxoEpOsUt1U4yTXuiPo/47uSuj
vIindAam9I63xigeHrVew3/Xmy0bf0hn0Utg3lWzXv1yVoUckWIsAehR7JVS
swpG93q6KOEaxELCyIeTLBy94kIjFqWTL4icIQ0GeAg64AfQxBH8/tEkHvol
np4CypW8eKhZcOhLTiYEdhpRJGKWgkLHAINR+U/VIAonqWAvTGAy+pcXDv4D
//tv+Hn86Pc99h3MJbiFnU2JIgwMi0n0w5pk0it6TuC3/dPXPOcvWnv8KE/n
WT+itBLYve/A2vlhDSXrGjO+SQCNH9biqBgGEzKDeFmxnza7m9tBdyvobndw
0DXabt+xywhsRgzbHojsJX5sKGwjJKOBg37Unp+vgbIfpP05mUrStAhZDmJh
GvJk7rDgxgTPyqLKfmAbqff58OZEjrLzfRyyhL/Ji2oDlBQBnYlCxDnldhGk
MGenR1cHZ6ev2O+//9PFq4Pdze3ep09o5l0cXZpfPOtudz996vBZCB6QXYk0
BE+ke+ZIB/VeBvjg1KKt8jiULgMzPojlAZ/oxqeougLISw7uchwBA7UuL9+s
a2w3XaQU3hZWb66uzi8bImAPfvX2koAIMmxv78KIxoqKx49xyck9E8eUtBb4
YZGlE7rkBaif7h+cSNyfbSGlCQwszPt4II8WeI3EFBMUQPz2C7Gu/FphCFIV
Cz9kivgiH1dNG7Qnf50oxPcBDacxn1/LF0CBjLrwYhUgyS76oQF+CRJfTgBi
CarL3rr1e0F1z6rJDGdOI3MN5aMgxPNTMtpV3nKcvE9JMeLoGXgc+LscV+Qo
hd7hIp4dHPJMSTC74GOiwy0YuVNzFdPr/4r6Ra52orlP+ZtA/I0T2ILicRJE
RqpXEVM9TQUcBUZAENcJ0IfDrXWT4fkDmguciDnnef2AirrQBazJD0pDWagU
397BfEulgK1Xbfh4eUcGdIGkIsiQqoxKyvRVgM1Bb2LKeSFI8yLmr+TjyJwD
SWyjbLk4PzCYoi2zKoBhwXIKcR+R0CI4BJPyUol2STqQT1SKKSIxkA+pIjRS
iP+Bw6q+fPko2EfsA0NEwyESWuTVSWlnsGo85ASLE5FLh7E7zlDTEBMD0nk+
uQVKgbcojLM8UkQSQPDZaXwLlY+ixLO6+ms9w89pL6Qz0VfmnNkMxRcd/N40
i/DtTimjeJ+QIg5Cbsu9z8WBoK5LSPnQh5Eym+Nb7wXoZ3r+aD5ByxFXD1P6
06mmV5S8j7OU3Ovc3A65VGQOPYDZJhO8yzUvJFFoYr1Oz97chsh8+nwHNAed
Ldzq9x8ULYF5bgBoh2vQ4/3TfY/2fCXsC/3C1y8XxxKDteOjq1fsLydv2UU0
ikFo3q7B0D/C0Fu7z559+tTmUMch5gMP+KsuxK7qplQcTQacxkOZh2aguIcY
cEsDJgUD78H2yJI9NAv2KKyX732YTvaSfA+Ngb2SucDlKscNF5CeMu4Xe5zW
x0eXr6kFzAA+Ot3YfyHwA68sR2xprihxaJJok1C9tI7E6vGjK5uk+MANeCHU
RU7ZlGjCN1mjz+imIXDQKcJdg2E5Da3Vs0mALQFT/zxPJXorUekcliD+AF0n
Nu3EUu3xWrh/gR89efzkCFwx4JHTtIA25xO81IcOC2arU2v9WhK2FtdReGxJ
+moGBYkZgyBg12H/Hf6OFqa4nxJcx7kw9w7EjRXa5Qj3eff5llqO9yILihYi
iW4M5dGW0a8Yf7c0iVwbY7n4zryy2B/hURNDI5GUvcY0NssDfVKi9BMBmFY1
YJfmu3T4wZn/iTL6ynmqDT+zoin2ByP+Afgd4h8Zk6VmoO4zwgj/Urlt1h9m
ex7YHYVxYv9VboNXge2/ym1oGs6f5VaD66n1h9lCIrlj/WHByAfiH/1p5Upq
llh5JWVMlfVvBlOz1JL1pVPfp+o7XtHH+lZfFrM+Pjy//FdmffIzfOI0CUqf
/bx/8qzUyP0MPujtelo5H8InW5vM0879FD7a3fa0cz6U1yusD0d4UcP6hNc5
dj9NUvzIHjfvlz/zNPO0Ms5QK78ITi/+GmzOdl7Xtzi7+qVX36LXXQxis7rF
2dXb7c52cHlQ3eTV2fFBz9PGf2ZgL0qc5UUwjIvA29hqC4p2kE79DR3kQFng
6xgYbGnUnkeGCZcGzUUkumnztJjzq0DWp+WFK68DfLJV+mS79MlBYn+Eg8ms
FAydWF/yz2WGezAgs/LWYVlxu46fxdUIOK3jVpVvKNWcWvDux9HM/mScOh/o
grz4ufs0uvuZ/fRtYL/hih94szgD+440fuBkIwfN0kGDmhw6BUIm2xgflRJs
Kr5zE08qmtlH39jId6Zoq36FpefEwPxYx4qFocWNs2jwwxrFJmVsbb+P56Tg
fPAH4yWfhfNiLJ9nQh5Ctwa5jr9Ahw+y4MdxhvXj+/jsLx6/vCMz6yKFcUBq
/BpPClH/UFleYAkW5I++j4F9CXjK9gdZDBb1K2B4cSnpCgy/8wjrwoneMdUA
ERgO5pkMl08pAIRdjBgfCIN0puxN24a/AW9lBhZsmKnTundA+wFPrPj/Zkod
CX+lAQA=

-->

</rfc>

