netconfcentral logo

openconfig-transport-line-protection

HTML

openconfig-transport-line-protection@2018-11-21



  module openconfig-transport-line-protection {

    yang-version 1;

    namespace
      "http://openconfig.net/yang/optical-transport-line-protection";

    prefix oc-line-protect;

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

    organization "OpenConfig working group";

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

    description
      "This model describes configuration and operational state data
    for optical line protection elements, deployed as part of a
    transport line system. An Automatic Protection Switch (APS)
    is typically installed in the same device as the amplifiers
    and wave-router, however an APS can also be a standalone
    device. In both scenarios, it serves the same purpose of
    providing protection using two dark fiber pairs to ensure the
    amplifiers can still receive a signal if one of the two fiber
    pairs is broken. The APS port details and directionality are
    shown below. The three major attributes, together with their
    modifiers, define the behavior of the APS and can be prioritized
    in the descending order as shown in the following table";

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

    }

    revision "2018-07-25" {
      description
        "Added wait-to-restore-time, hold-off-time,
      relative-switch-threshold, relative-switch-threshold-offset,
      forced-to-port, removed secondary-switch-hysteresis, and
      edited the description of primary-switch-threshold,
      secondary-switch-threshold, and primary-switch-hysteresis";
      reference
        "0.4.0";

    }

    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-08-05" {
      description "Initial public release";
      reference
        "0.1.0";

    }

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

    identity APS_PATHS {
      base 
      description
        "Base identity for identifying the line paths on an
      automatic protection switch";
    }

    identity PRIMARY {
      base APS_PATHS;
      description
        "The primary line path connected to an automatic protection
      switch port indicating the primary/preferred path";
    }

    identity SECONDARY {
      base APS_PATHS;
      description
        "The secondary line path connected to an automatic protection
      switch port indicating the secondary path";
    }

    grouping aps-input-port-config {
      description
        "Grouping for config related to unidirectional automatic
      protection switch input ports";
      leaf enabled {
        type boolean;
        default "true";
        description
          "This leaf contains the configured, desired state of the
        port. Disabling the port turns off alarm reporting for
        the port";
      }

      leaf target-attenuation {
        type decimal64 {
          fraction-digits 2;
        }
        units "dB";
        description
          "Target attenuation of the variable optical attenuator
        associated with the port in increments of 0.01 dB.";
      }
    }  // grouping aps-input-port-config

    grouping aps-output-port-config {
      description
        "Grouping for config related to unidirectional automatic
      protection switch output ports";
      leaf target-attenuation {
        type decimal64 {
          fraction-digits 2;
        }
        units "dB";
        description
          "Target attenuation of the variable optical attenuator
        associated with the port in increments of 0.01 dB";
      }
    }  // grouping aps-output-port-config

    grouping aps-input-port-state {
      description
        "Grouping for state related to unidirectional automatic
      protection switch input ports";
      leaf attenuation {
        type decimal64 {
          fraction-digits 2;
        }
        units "dB";
        description
          "The attenuation of the variable optical attenuator
        associated with the port in increments of 0.01 dB.";
      }

      container optical-power {
        description
          "The optical input power of this port in units of
        0.01dBm. Optical input power represents the signal
        traversing from an external destination into the module.
        The power is measured before any attenuation. If avg/min/max
        statistics are not supported, the target is expected to
        just supply the instant value";
        uses oc-types:avg-min-max-instant-stats-precision2-dBm;
      }  // container optical-power
    }  // grouping aps-input-port-state

    grouping aps-output-port-state {
      description
        "Grouping for state related to unidirectional automatic
      protection switch output ports";
      leaf attenuation {
        type decimal64 {
          fraction-digits 2;
        }
        units "dB";
        description
          "The attenuation of the variable optical attenuator
        associated with the port in increments of 0.01 dB";
      }

      container optical-power {
        description
          "The optical output power of this port in units of
        0.01dBm. Optical output power represents the signal
        traversing from the module to an external destination. The
        power is measured after any attenuation. If avg/min/max
        statistics are not supported, the target is expected to
        just supply the instant value";
        uses oc-types:avg-min-max-instant-stats-precision2-dBm;
      }  // container optical-power
    }  // grouping aps-output-port-state

    grouping aps-ports {
      description
        "Top level grouping for automatic protection switch ports";
      container line-primary-in {
        description
          "Container for information related to the line primary
        input port";
        container config {
          description
            "Configuration data for the line primary input port";
          uses aps-input-port-config;
        }  // container config

        container state {
          config false;
          description
            "State data for the line primary input port";
          uses aps-input-port-config;

          uses aps-input-port-state;
        }  // container state
      }  // container line-primary-in

      container line-primary-out {
        description
          "Container for information related to the line primary
        output port";
        container config {
          description
            "Configuration data for the line primary output port";
          uses aps-output-port-config;
        }  // container config

        container state {
          config false;
          description
            "State data for the line primary output port";
          uses aps-output-port-config;

          uses aps-output-port-state;
        }  // container state
      }  // container line-primary-out

      container line-secondary-in {
        description
          "Container for information related to the line secondary
        input port";
        container config {
          description
            "Configuration data for the line secondary input port";
          uses aps-input-port-config;
        }  // container config

        container state {
          config false;
          description
            "State data for the line secondary input port";
          uses aps-input-port-config;

          uses aps-input-port-state;
        }  // container state
      }  // container line-secondary-in

      container line-secondary-out {
        description
          "Container for information related to the line secondary
        output port";
        container config {
          description
            "Configuration data for the line secondary output port";
          uses aps-output-port-config;
        }  // container config

        container state {
          config false;
          description
            "State data for the line secondary output port";
          uses aps-output-port-config;

          uses aps-output-port-state;
        }  // container state
      }  // container line-secondary-out

      container common-in {
        description
          "Container for information related to the line common
        input port";
        container config {
          description
            "Configuration data for the line common input port";
          uses aps-input-port-config;
        }  // container config

        container state {
          config false;
          description
            "State data for the line common input port";
          uses aps-input-port-config;

          uses aps-input-port-state;
        }  // container state
      }  // container common-in

      container common-output {
        description
          "Container for information related to the line common
        output port";
        container config {
          description
            "Configuration data for the line common output port";
          uses aps-output-port-config;
        }  // container config

        container state {
          config false;
          description
            "State data for the line common output port";
          uses aps-output-port-config;

          uses aps-output-port-state;
        }  // container state
      }  // container common-output
    }  // grouping aps-ports

    grouping aps-config {
      description
        "Configuration data for automatic protection switch modules";
      leaf name {
        type leafref {
          path
            "/oc-platform:components/oc-platform:component/"
              + "oc-platform:name";
        }
        description
          "Reference to the component name (in the platform model)
        corresponding to this automatic protection switch module
        in the device";
      }

      leaf revertive {
        type boolean;
        description
          "Revertive behavior of the module. If True, then
        automatically revert after protection switch once the
        fault is restored. This leaf is not valid when the
        relative-switch-threshold is in effect";
      }

      leaf wait-to-restore-time {
        type uint32;
        units "milliseconds";
        description
          "The time that must elapse before an APS path
         that has recovered from an signal failure (SF) or signal
         degradation (SD) condition can be used again to transport
         the normal traffic signal. During this time period, an SF or
         SD condition shall override the wait-to-restore time period.
         This leaf can only take effect when the revertive leaf
         equals true";
      }

      leaf hold-off-time {
        type uint32;
        units "milliseconds";
        description
          "The time delay between the declaration of an SF or SD
        condition and the initiation of the protection switching
        algorithm";
      }

      leaf primary-switch-threshold {
        type decimal64 {
          fraction-digits 2;
        }
        units "dBm";
        description
          "The threshold at which the primary line port will switch to
        the opposite line port in increments of 0.01 dBm. If the
        hardware supports only one switch threshold for primary and
        and secondary ports then it is recommended to set both
        primary-switch-threshold and secondary-switch-threshold to
        the same value to be explicit. When the relative switch
        threshold is enabled, i.e. set to a non-zero value, the
        primary switch threshold will be overridden";
      }

      leaf primary-switch-hysteresis {
        type decimal64 {
          fraction-digits 2;
        }
        units "dB";
        default '0';
        description
          "The delta in dB between the primary-switch-threshold
        and the signal received on the primary APS_PATH before
        initiating a switch from the secondary APS_PATH to the
        primary APS_PATH, in order to prevent toggling between ports
        when an input signal is very close to the threshold. A zero
        value means the switch hysteresis is disabled.";
      }

      leaf secondary-switch-threshold {
        type decimal64 {
          fraction-digits 2;
        }
        units "dBm";
        description
          "The threshold at which the secondary line port will switch to
        the opposite line port in increments of 0.01 dBm. If the
        hardware supports only one switch threshold for primary and
        and secondary ports then it is recommended to set both
        primary-switch-threshold and secondary-switch-threshold to
        the same value to be explicit. When the relative switch
        threshold is enabled, i.e. set to a non-zero value, the
        secondary switch threshold will be overridden";
      }

      leaf relative-switch-threshold {
        type decimal64 {
          fraction-digits 2;
        }
        units "dB";
        default '0';
        description
          "The delta threshold in dB at which the current line port
        will switch to the opposite line port. It can be set to
        the value of 0dB. When set to 0dB, the threshold is ignored
        and the system automatically applies the primary and
        secondary switch thresholds. When set to a non-zero value,
        it overrides the primary and secondary switch thresholds";
      }

      leaf relative-switch-threshold-offset {
        type decimal64 {
          fraction-digits 2;
        }
        units "dB";
        default '0';
        description
          "The offset of the relative switch threshold that compensates
        the normal difference of receiving power between the primary
        and secondary line ports. A negative offset corresponds to
        the situation where the secondary line port receives a higher
        power than the primary line port in normal condition, and a
        positive offset means the opposite. The offset will only work
        when the relative switch threshold is set to a non-zero
        value";
      }

      leaf force-to-port {
        type enumeration {
          enum "NONE" {
            value 0;
            description
              "Do not force the switch to stay on any line port";
          }
          enum "PRIMARY" {
            value 1;
            description
              "Force the switch to stay on the primary line port";
          }
          enum "SECONDARY" {
            value 2;
            description
              "Force the switch to stay on the secondary line port";
          }
        }
        default 'NONE';
        description
          "Explicitly set the switch to stay on a port regardless of
        its operational condition";
      }
    }  // grouping aps-config

    grouping aps-state {
      description
        "State data for automatic protection switch modules";
      leaf active-path {
        type identityref {
          base APS_PATHS;
        }
        description
          "Indicates which line path on the protection switch is
         currently the active path connected to the common port";
      }
    }  // grouping aps-state

    grouping automatic-protection-switch-top {
      description
        "Top level grouping for automatic protection switch data";
      container aps-modules {
        description
          "Enclosing container for list of automatic protection
	       switch modules";
        list aps-module {
          key "name";
          description
            "List of automatic protection switch modules present
          in the device";
          leaf name {
            type leafref {
              path "../config/name";
            }
            description
              "Reference to the config name list key";
          }

          container config {
            description
              "Configuration data for an automatic protection
            switch module";
            uses aps-config;
          }  // container config

          container state {
            config false;
            description
              "Operational state data for an automatic protection
            switch module";
            uses aps-config;

            uses aps-state;
          }  // container state

          container ports {
            description
              "Top level grouping for automatic protection switch ports";
            uses aps-ports;
          }  // container ports
        }  // list aps-module
      }  // container aps-modules
    }  // grouping automatic-protection-switch-top

    grouping transport-line-protection-top {
      description
        "Top level grouping for transport line protection data";
      container aps {
        description
          "Top level grouping for automatic protection switch data";
        uses automatic-protection-switch-top;
      }  // container aps
    }  // grouping transport-line-protection-top

    uses transport-line-protection-top;
  }  // module openconfig-transport-line-protection

Summary

  
  
Organization OpenConfig working group
  
Module openconfig-transport-line-protection
Version 2018-11-21
File openconfig-transport-line-protection.yang
  
Prefix oc-line-protect
Namespace http://openconfig.net/yang/optical-transport-line-protection
  
Cooked /cookedmodules/openconfig-transport-line-protection/2018-11-21
YANG /src/openconfig-transport-line-protection@2018-11-21.yang
XSD /xsd/openconfig-transport-line-protection@2018-11-21.xsd
  
Abstract This model describes configuration and operational state data for optical line protection elements, deployed as part of a transp...
  
Contact
OpenConfig working group
www.openconfig.net

Description

 
This model describes configuration and operational state data
for optical line protection elements, deployed as part of a
transport line system. An Automatic Protection Switch (APS)
is typically installed in the same device as the amplifiers
and wave-router, however an APS can also be a standalone
device. In both scenarios, it serves the same purpose of
providing protection using two dark fiber pairs to ensure the
amplifiers can still receive a signal if one of the two fiber
pairs is broken. The APS port details and directionality are
shown below. The three major attributes, together with their
modifiers, define the behavior of the APS and can be prioritized
in the descending order as shown in the following table

Groupings

Grouping Objects Abstract
aps-config name revertive wait-to-restore-time hold-off-time primary-switch-threshold primary-switch-hysteresis secondary-switch-threshold relative-switch-threshold relative-switch-threshold-offset force-to-port Configuration data for automatic protection switch modules
aps-input-port-config enabled target-attenuation Grouping for config related to unidirectional automatic protection switch input ports
aps-input-port-state attenuation optical-power Grouping for state related to unidirectional automatic protection switch input ports
aps-output-port-config target-attenuation Grouping for config related to unidirectional automatic protection switch output ports
aps-output-port-state attenuation optical-power Grouping for state related to unidirectional automatic protection switch output ports
aps-ports line-primary-in line-primary-out line-secondary-in line-secondary-out common-in common-output Top level grouping for automatic protection switch ports
aps-state active-path State data for automatic protection switch modules
automatic-protection-switch-top aps-modules Top level grouping for automatic protection switch data
transport-line-protection-top aps Top level grouping for transport line protection data

Objects

Type Key
Mandatory config
Optional config
Not config
Object Type Abstract
aps container Top level grouping for automatic protection switch data
   aps-modules container Enclosing container for list of automatic protection switch modules
      aps-module list List of automatic protection switch modules present in the device
         config container Configuration data for an automatic protection switch module
            force-to-port leaf Explicitly set the switch to stay on a port regardless of its operational condition
            hold-off-time leaf The time delay between the declaration of an SF or SD condition and the initiation of the protection switching algorithm
            name leaf Reference to the component name (in the platform model) corresponding to this automatic protection switch module in the device
            primary-switch-hysteresis leaf The delta in dB between the primary-switch-threshold and the signal received on the primary APS_PATH before initiating a switch from the secondary APS_PATH to the primary APS_PATH, in order to prevent toggling between ports when an input signal is very cl...
            primary-switch-threshold leaf The threshold at which the primary line port will switch to the opposite line port in increments of 0.01 dBm. If the hardware supports only one switch threshold for primary and and secondary ports then it is recommended to set both primary-switch-threshol...
            relative-switch-threshold leaf The delta threshold in dB at which the current line port will switch to the opposite line port. It can be set to the value of 0dB. When set to 0dB, the threshold is ignored and the system automatically applies the primary and secondary switch thresholds. ...
            relative-switch-threshold-offset leaf The offset of the relative switch threshold that compensates the normal difference of receiving power between the primary and secondary line ports. A negative offset corresponds to the situation where the secondary line port receives a higher power than t...
            revertive leaf Revertive behavior of the module. If True, then automatically revert after protection switch once the fault is restored. This leaf is not valid when the relative-switch-threshold is in effect
            secondary-switch-threshold leaf The threshold at which the secondary line port will switch to the opposite line port in increments of 0.01 dBm. If the hardware supports only one switch threshold for primary and and secondary ports then it is recommended to set both primary-switch-thresh...
            wait-to-restore-time leaf The time that must elapse before an APS path that has recovered from an signal failure (SF) or signal degradation (SD) condition can be used again to transport the normal traffic signal. During this time period, an SF or SD condition shall override the wa...
         name leaf Reference to the config name list key
         ports container Top level grouping for automatic protection switch ports
            common-in container Container for information related to the line common input port
               config container Configuration data for the line common input port
                  enabled leaf This leaf contains the configured, desired state of the port. Disabling the port turns off alarm reporting for the port
                  target-attenuation leaf Target attenuation of the variable optical attenuator associated with the port in increments of 0.01 dB.
               state container State data for the line common input port
                  attenuation leaf The attenuation of the variable optical attenuator associated with the port in increments of 0.01 dB.
                  enabled leaf This leaf contains the configured, desired state of the port. Disabling the port turns off alarm reporting for the port
                  optical-power container The optical input power of this port in units of 0.01dBm. Optical input power represents the signal traversing from an external destination into the module. The power is measured before any attenuation. If avg/min/max statistics are not supported, the tar...
                     avg leaf The arithmetic mean value of the statistic over the time interval.
                     instant leaf The instantaneous value of the statistic.
                     interval leaf If supported by the system, this reports the time interval over which the min/max/average statistics are computed by the system.
                     max leaf The maximum value of the statistic over the time interval.
                     max-time leaf The absolute time at which the maximum value occurred. The value is the timestamp in nanoseconds relative to the Unix Epoch (Jan 1, 1970 00:00:00 UTC).
                     min leaf The minimum value of the statistic over the time interval.
                     min-time leaf The absolute time at which the minimum value occurred. The value is the timestamp in nanoseconds relative to the Unix Epoch (Jan 1, 1970 00:00:00 UTC).
                  target-attenuation leaf Target attenuation of the variable optical attenuator associated with the port in increments of 0.01 dB.
            common-output container Container for information related to the line common output port
               config container Configuration data for the line common output port
                  target-attenuation leaf Target attenuation of the variable optical attenuator associated with the port in increments of 0.01 dB
               state container State data for the line common output port
                  attenuation leaf The attenuation of the variable optical attenuator associated with the port in increments of 0.01 dB
                  optical-power container The optical output power of this port in units of 0.01dBm. Optical output power represents the signal traversing from the module to an external destination. The power is measured after any attenuation. If avg/min/max statistics are not supported, the targ...
                     avg leaf The arithmetic mean value of the statistic over the time interval.
                     instant leaf The instantaneous value of the statistic.
                     interval leaf If supported by the system, this reports the time interval over which the min/max/average statistics are computed by the system.
                     max leaf The maximum value of the statistic over the time interval.
                     max-time leaf The absolute time at which the maximum value occurred. The value is the timestamp in nanoseconds relative to the Unix Epoch (Jan 1, 1970 00:00:00 UTC).
                     min leaf The minimum value of the statistic over the time interval.
                     min-time leaf The absolute time at which the minimum value occurred. The value is the timestamp in nanoseconds relative to the Unix Epoch (Jan 1, 1970 00:00:00 UTC).
                  target-attenuation leaf Target attenuation of the variable optical attenuator associated with the port in increments of 0.01 dB
            line-primary-in container Container for information related to the line primary input port
               config container Configuration data for the line primary input port
                  enabled leaf This leaf contains the configured, desired state of the port. Disabling the port turns off alarm reporting for the port
                  target-attenuation leaf Target attenuation of the variable optical attenuator associated with the port in increments of 0.01 dB.
               state container State data for the line primary input port
                  attenuation leaf The attenuation of the variable optical attenuator associated with the port in increments of 0.01 dB.
                  enabled leaf This leaf contains the configured, desired state of the port. Disabling the port turns off alarm reporting for the port
                  optical-power container The optical input power of this port in units of 0.01dBm. Optical input power represents the signal traversing from an external destination into the module. The power is measured before any attenuation. If avg/min/max statistics are not supported, the tar...
                     avg leaf The arithmetic mean value of the statistic over the time interval.
                     instant leaf The instantaneous value of the statistic.
                     interval leaf If supported by the system, this reports the time interval over which the min/max/average statistics are computed by the system.
                     max leaf The maximum value of the statistic over the time interval.
                     max-time leaf The absolute time at which the maximum value occurred. The value is the timestamp in nanoseconds relative to the Unix Epoch (Jan 1, 1970 00:00:00 UTC).
                     min leaf The minimum value of the statistic over the time interval.
                     min-time leaf The absolute time at which the minimum value occurred. The value is the timestamp in nanoseconds relative to the Unix Epoch (Jan 1, 1970 00:00:00 UTC).
                  target-attenuation leaf Target attenuation of the variable optical attenuator associated with the port in increments of 0.01 dB.
            line-primary-out container Container for information related to the line primary output port
               config container Configuration data for the line primary output port
                  target-attenuation leaf Target attenuation of the variable optical attenuator associated with the port in increments of 0.01 dB
               state container State data for the line primary output port
                  attenuation leaf The attenuation of the variable optical attenuator associated with the port in increments of 0.01 dB
                  optical-power container The optical output power of this port in units of 0.01dBm. Optical output power represents the signal traversing from the module to an external destination. The power is measured after any attenuation. If avg/min/max statistics are not supported, the targ...
                     avg leaf The arithmetic mean value of the statistic over the time interval.
                     instant leaf The instantaneous value of the statistic.
                     interval leaf If supported by the system, this reports the time interval over which the min/max/average statistics are computed by the system.
                     max leaf The maximum value of the statistic over the time interval.
                     max-time leaf The absolute time at which the maximum value occurred. The value is the timestamp in nanoseconds relative to the Unix Epoch (Jan 1, 1970 00:00:00 UTC).
                     min leaf The minimum value of the statistic over the time interval.
                     min-time leaf The absolute time at which the minimum value occurred. The value is the timestamp in nanoseconds relative to the Unix Epoch (Jan 1, 1970 00:00:00 UTC).
                  target-attenuation leaf Target attenuation of the variable optical attenuator associated with the port in increments of 0.01 dB
            line-secondary-in container Container for information related to the line secondary input port
               config container Configuration data for the line secondary input port
                  enabled leaf This leaf contains the configured, desired state of the port. Disabling the port turns off alarm reporting for the port
                  target-attenuation leaf Target attenuation of the variable optical attenuator associated with the port in increments of 0.01 dB.
               state container State data for the line secondary input port
                  attenuation leaf The attenuation of the variable optical attenuator associated with the port in increments of 0.01 dB.
                  enabled leaf This leaf contains the configured, desired state of the port. Disabling the port turns off alarm reporting for the port
                  optical-power container The optical input power of this port in units of 0.01dBm. Optical input power represents the signal traversing from an external destination into the module. The power is measured before any attenuation. If avg/min/max statistics are not supported, the tar...
                     avg leaf The arithmetic mean value of the statistic over the time interval.
                     instant leaf The instantaneous value of the statistic.
                     interval leaf If supported by the system, this reports the time interval over which the min/max/average statistics are computed by the system.
                     max leaf The maximum value of the statistic over the time interval.
                     max-time leaf The absolute time at which the maximum value occurred. The value is the timestamp in nanoseconds relative to the Unix Epoch (Jan 1, 1970 00:00:00 UTC).
                     min leaf The minimum value of the statistic over the time interval.
                     min-time leaf The absolute time at which the minimum value occurred. The value is the timestamp in nanoseconds relative to the Unix Epoch (Jan 1, 1970 00:00:00 UTC).
                  target-attenuation leaf Target attenuation of the variable optical attenuator associated with the port in increments of 0.01 dB.
            line-secondary-out container Container for information related to the line secondary output port
               config container Configuration data for the line secondary output port
                  target-attenuation leaf Target attenuation of the variable optical attenuator associated with the port in increments of 0.01 dB
               state container State data for the line secondary output port
                  attenuation leaf The attenuation of the variable optical attenuator associated with the port in increments of 0.01 dB
                  optical-power container The optical output power of this port in units of 0.01dBm. Optical output power represents the signal traversing from the module to an external destination. The power is measured after any attenuation. If avg/min/max statistics are not supported, the targ...
                     avg leaf The arithmetic mean value of the statistic over the time interval.
                     instant leaf The instantaneous value of the statistic.
                     interval leaf If supported by the system, this reports the time interval over which the min/max/average statistics are computed by the system.
                     max leaf The maximum value of the statistic over the time interval.
                     max-time leaf The absolute time at which the maximum value occurred. The value is the timestamp in nanoseconds relative to the Unix Epoch (Jan 1, 1970 00:00:00 UTC).
                     min leaf The minimum value of the statistic over the time interval.
                     min-time leaf The absolute time at which the minimum value occurred. The value is the timestamp in nanoseconds relative to the Unix Epoch (Jan 1, 1970 00:00:00 UTC).
                  target-attenuation leaf Target attenuation of the variable optical attenuator associated with the port in increments of 0.01 dB
         state container Operational state data for an automatic protection switch module
            active-path leaf Indicates which line path on the protection switch is currently the active path connected to the common port
            force-to-port leaf Explicitly set the switch to stay on a port regardless of its operational condition
            hold-off-time leaf The time delay between the declaration of an SF or SD condition and the initiation of the protection switching algorithm
            name leaf Reference to the component name (in the platform model) corresponding to this automatic protection switch module in the device
            primary-switch-hysteresis leaf The delta in dB between the primary-switch-threshold and the signal received on the primary APS_PATH before initiating a switch from the secondary APS_PATH to the primary APS_PATH, in order to prevent toggling between ports when an input signal is very cl...
            primary-switch-threshold leaf The threshold at which the primary line port will switch to the opposite line port in increments of 0.01 dBm. If the hardware supports only one switch threshold for primary and and secondary ports then it is recommended to set both primary-switch-threshol...
            relative-switch-threshold leaf The delta threshold in dB at which the current line port will switch to the opposite line port. It can be set to the value of 0dB. When set to 0dB, the threshold is ignored and the system automatically applies the primary and secondary switch thresholds. ...
            relative-switch-threshold-offset leaf The offset of the relative switch threshold that compensates the normal difference of receiving power between the primary and secondary line ports. A negative offset corresponds to the situation where the secondary line port receives a higher power than t...
            revertive leaf Revertive behavior of the module. If True, then automatically revert after protection switch once the fault is restored. This leaf is not valid when the relative-switch-threshold is in effect
            secondary-switch-threshold leaf The threshold at which the secondary line port will switch to the opposite line port in increments of 0.01 dBm. If the hardware supports only one switch threshold for primary and and secondary ports then it is recommended to set both primary-switch-thresh...
            wait-to-restore-time leaf The time that must elapse before an APS path that has recovered from an signal failure (SF) or signal degradation (SD) condition can be used again to transport the normal traffic signal. During this time period, an SF or SD condition shall override the wa...