netconfcentral logo

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