module openconfig-wavelength-router {

    yang-version 1;

    namespace
      "http://openconfig.net/yang/wavelength-router";

    prefix oc-wave-router;

    import openconfig-extensions {
      prefix oc-ext;
    }
    import openconfig-platform {
      prefix oc-platform;
    }
    import openconfig-transport-types {
      prefix oc-opt-types;
    }

    organization "OpenConfig working group";

    contact
      "OpenConfig working group
      www.openconfig.net";

    description
      "This model describes configuration and operational state data
    for an optical transport line system node, or ROADM (incl. CDC
    ROADMs, WSS, Dynamic Gain Equalizer/DGE).

    Nodes are modeled as a configurable switching element with
    ingress and egress ports, as well as a number of add/drop ports
    that can be set up to direct portions of the optical spectrum
    to the appropriate degrees.

    In relation to configuring target spectrum powers, there
    are two, non-overlapping, configuration possibilities that are
    supported.
    1. Non-noise loaded wavelength router:
       - The target spectrum powers are configured on each media
         channel.
    2. Noise-loaded wavelength router:
       - The target spectrum power values will be configured as a
         target spectrum power profile over the full spectrum instead
         of individual media channels.";

    revision "2024-04-08" {
      description
        "Add attenuation-control-range to media channel config";
      reference
        "1.2.0";

    }

    revision "2021-07-26" {
      description
        "Add dynamic loss damped mode.";
      reference
        "1.1.0";

    }

    revision "2020-08-28" {
      description
        "Add ase-injection-delta-threshold leaf.";
      reference
        "1.0.0";

    }

    revision "2020-06-03" {
      description
        "Add attenutation-control-mode to media channel config";
      reference
        "0.8.0";

    }

    revision "2019-10-24" {
      description
        "Migrate from using power spectral densisty to using power
      target values";
      reference
        "0.7.0";

    }

    revision "2019-09-20" {
      description
        "Add ASE related state and config. Also add a super channel
      parent leaf";
      reference
        "0.6.0";

    }

    revision "2019-06-03" {
      description
        "PSD profile top-level description and
      port changed to a leafref.";
      reference
        "0.5.0";

    }

    revision "2019-04-03" {
      description
        "Add port PSD profile modeling.";
      reference
        "0.4.0";

    }

    revision "2018-11-21" {
      description
        "Add OpenConfig module metadata extensions.";
      reference
        "0.3.3";

    }

    revision "2018-07-17" {
      description
        "Correct bug so that source/dest ports are components";
      reference
        "0.3.2";

    }

    revision "2017-09-08" {
      description
        "Correct bug with OSC interfaces";
      reference
        "0.3.1";

    }

    revision "2017-07-08" {
      description
        "Support multiple OCMs, add monitor port type
      and refs to hw ports, ";
      reference
        "0.3.0";

    }

    revision "2017-03-28" {
      description
        "Added min/max/avg stats, status for media channels, OCM, APS";
      reference
        "0.2.0";

    }

    revision "2016-03-31" {
      description "Initial public release";
      reference
        "0.1.0";

    }

    oc-ext:openconfig-version "1.2.0";
    oc-ext:regexp-posix;
    oc-ext:catalog-organization "openconfig";
    oc-ext:origin "openconfig";

    identity ATTENUATION_CONTROL_MODE {
      description
        "The definition for different types of attenutation control
      modes on a media channel";
    }

    identity ATTENUATION_FIXED_LOSS {
      base ATTENUATION_CONTROL_MODE;
      description
        "The attenuation applied across a media channel will be
      calculated based on the target input and output powers as well
      as the internal losses of the wavelength router. The target
      power levels are configured using port-spectrum-power-profiles
      of the two ports";
    }

    identity ATTENUATION_DYNAMIC_LOSS {
      base ATTENUATION_CONTROL_MODE;
      description
        "The attenuation applied across a media channel is dynamically
      controlled by the device by attempting to meet the target output
      power as defined in the output port's
      port-spectrum-power-profile";
    }

    identity ATTENUATION_DYNAMIC_LOSS_DAMPED {
      base ATTENUATION_CONTROL_MODE;
      description
        "The attenuation applied across a media channel is dynamically
      controlled by the device by attempting to meet the target output
      power as defined in the output port's
      port-spectrum-power-profile. In this mode, convergence to the
      target output power occurs gradually to minimize any power
      oscillations across the line system. These changes will happen
      within the order of minutes";
    }

    identity ATTENUATION_CONTROL_RANGE {
      description
        "The definition for different types of modes to specify
       attenuation control range settings on a media channel";
    }

    identity CONTROL_RANGE_FULL {
      base ATTENUATION_CONTROL_RANGE;
      description
        "Media channel power compensation range is not constrained,
      and is limited by available WSS dynamic range. Operator does not
      explicitly set the undershoot and overshoot compensation range";
    }

    identity CONTROL_RANGE_LIMITED {
      base ATTENUATION_CONTROL_RANGE;
      description
        "Media channel undershoot and overshoot compensation ranges
      are defined by max-undershoot-compensation and
      max-overshoot-compensation";
    }

    identity ASE_CONTROL_MODE {
      description
        "The definition for different types of ASE control modes
      on a media channel";
    }

    identity ASE_ENABLED {
      base ASE_CONTROL_MODE;
      description
        "The media channel will immediately have ASE noise injected";
    }

    identity ASE_DISABLED {
      base ASE_CONTROL_MODE;
      description
        "Removes any ASE noise injection that may be present on the
      media channel";
    }

    identity AUTO_ASE_ON_FAILURE {
      base ASE_CONTROL_MODE;
      description
        "The media channel will automatically be injected with noise
      if the media channel target spectrum power drops below the
      provided threshdold. In this mode, at time of a failure, the
      media channel is removed from the system and would need to be
      reconfigured to restore traffic. In addition, unprovisioned
      spectrum will be injected with noise";
    }

    identity AUTO_ASE_FAILURE_AND_RESTORE {
      base ASE_CONTROL_MODE;
      description
        "The media channel will automatically be injected with noise
      if the media channel target spectrum power drops below the
      provided threshold. When the original signal is restored above
      the threshold the ASE noise injection will be automatically
      removed. In addition, unprovisioned spectrum will be injected
      with noise";
    }
  }  // module openconfig-wavelength-router