netconfcentral logo

openconfig-transport-line-protection

HTML

openconfig-transport-line-protection@2017-09-08



  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.";

    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.3.1";

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

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

      leaf primary-switch-hysteresis {
        type decimal64 {
          fraction-digits 2;
        }
        units "dB";
        description
          "The delta in 0.01 dB between the primary-switch-threshold
        and the signal received before initiating a reversion in
        order to prevent toggling between ports when an input
        signal is very close to threshold. If the hardware supports
        only one switch hysteresis for primary and secondary ports
        then it is recommended to set both primary-switch-threshold
        and secondary-switch-threshold to the same value to be
        explicit";
      }

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

      leaf secondary-switch-hysteresis {
        type decimal64 {
          fraction-digits 2;
        }
        units "dB";
        description
          "The delta in 0.01 dB between the secondary-switch-threshold
        and the signal received before initiating a reversion in
        order to prevent toggling between ports when an input
        signal is very close to threshold. If the hardware supports
        only one switch hysteresis for primary and secondary ports
        then it is recommended to set both primary-switch-threshold
        and secondary-switch-threshold to the same value to be
        explicit";
      }
    }  // 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 automatic 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 2017-09-08
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/2017-09-08
YANG /src/openconfig-transport-line-protection@2017-09-08.yang
XSD /xsd/openconfig-transport-line-protection@2017-09-08.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.

Groupings

Grouping Objects Abstract
aps-config name revertive primary-switch-threshold primary-switch-hysteresis secondary-switch-threshold secondary-switch-hysteresis 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
            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 0.01 dB between the primary-switch-threshold and the signal received before initiating a reversion in order to prevent toggling between ports when an input signal is very close to threshold. If the hardware supports only one switch hysteresis...
            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...
            revertive leaf Revertive behavior of the module. If True, then automatically revert after protection switch once the fault is restored.
            secondary-switch-hysteresis leaf The delta in 0.01 dB between the secondary-switch-threshold and the signal received before initiating a reversion in order to prevent toggling between ports when an input signal is very close to threshold. If the hardware supports only one switch hysteres...
            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...
         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 sampling period.
                     instant leaf The instantaneous value of the statistic.
                     max leaf The maximum value of the statistic over the sampling period
                     min leaf The minimum value of the statistic over the sampling period
                  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 sampling period.
                     instant leaf The instantaneous value of the statistic.
                     max leaf The maximum value of the statistic over the sampling period
                     min leaf The minimum value of the statistic over the sampling period
                  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 sampling period.
                     instant leaf The instantaneous value of the statistic.
                     max leaf The maximum value of the statistic over the sampling period
                     min leaf The minimum value of the statistic over the sampling period
                  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 sampling period.
                     instant leaf The instantaneous value of the statistic.
                     max leaf The maximum value of the statistic over the sampling period
                     min leaf The minimum value of the statistic over the sampling period
                  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 sampling period.
                     instant leaf The instantaneous value of the statistic.
                     max leaf The maximum value of the statistic over the sampling period
                     min leaf The minimum value of the statistic over the sampling period
                  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 sampling period.
                     instant leaf The instantaneous value of the statistic.
                     max leaf The maximum value of the statistic over the sampling period
                     min leaf The minimum value of the statistic over the sampling period
                  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 automatic protection switch is currently the active path connected to the common port
            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 0.01 dB between the primary-switch-threshold and the signal received before initiating a reversion in order to prevent toggling between ports when an input signal is very close to threshold. If the hardware supports only one switch hysteresis...
            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...
            revertive leaf Revertive behavior of the module. If True, then automatically revert after protection switch once the fault is restored.
            secondary-switch-hysteresis leaf The delta in 0.01 dB between the secondary-switch-threshold and the signal received before initiating a reversion in order to prevent toggling between ports when an input signal is very close to threshold. If the hardware supports only one switch hysteres...
            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...