<?xml version='1.0' encoding='utf-8'?>
<!DOCTYPE rfc [
  <!ENTITY nbsp    "&#160;">
  <!ENTITY zwsp   "&#8203;">
  <!ENTITY nbhy   "&#8209;">
  <!ENTITY wj     "&#8288;">
]>
<?xml-stylesheet type="text/xsl" href="rfc2629.xslt" ?>
<!-- generated by https://github.com/cabo/kramdown-rfc version 1.7.27 (Ruby 2.6.10) -->
<rfc xmlns:xi="http://www.w3.org/2001/XInclude" ipr="trust200902" docName="draft-ybam-rfc8561bis-02" category="std" consensus="true" submissionType="IETF" obsoletes="8561" tocInclude="true" sortRefs="true" symRefs="true" version="3">
  <!-- xml2rfc v2v3 conversion 3.28.1 -->
  <front>
    <title abbrev="Microwave Radio Link YANG">A YANG Data Model for Microwave Radio Link</title>
    <seriesInfo name="Internet-Draft" value="draft-ybam-rfc8561bis-02"/>
    <author fullname="Scott Mansfield">
      <organization>Ericsson</organization>
      <address>
        <email>scott.mansfield@ericsson.com</email>
      </address>
    </author>
    <author fullname="Jonas Ahlberg">
      <organization>Ericsson AB</organization>
      <address>
        <postal>
          <street>Lindholmspiren 11</street>
          <city>Goteborg</city>
          <code>417 56</code>
          <country>Sweden</country>
        </postal>
        <email>jonas.ahlberg@ericsson.com</email>
      </address>
    </author>
    <author fullname="Min Ye">
      <organization>Huawei Technologies</organization>
      <address>
        <postal>
          <street>No.1899, Xiyuan Avenue</street>
          <city>Chengdu</city>
          <code>611731</code>
          <country>China</country>
        </postal>
        <email>amy.yemin@huawei.com</email>
      </address>
    </author>
    <author fullname="Daniela Spreafico">
      <organization>Nokia - IT</organization>
      <address>
        <postal>
          <street>Via Energy Park, 14</street>
          <city>Vimercate (MI)</city>
          <code>20871</code>
          <country>Italy</country>
        </postal>
        <email>daniela.spreafico@nokia.com</email>
      </address>
    </author>
    <author fullname="Danilo Pala">
      <organization>SIAE</organization>
      <address>
        <email>danilo.pala@saiemic.com</email>
      </address>
    </author>
    <date year="2025" month="April" day="04"/>
    <area>Routing</area>
    <workgroup>CCAMP Working Group</workgroup>
    <keyword>Internet-Draft</keyword>
    <abstract>
      <?line 173?>

<t>This document defines a YANG data model for control and management of
radio link interfaces and their connectivity to packet (typically
Ethernet) interfaces in a microwave/millimeter wave node.  The data
nodes for management of the interface protection functionality is
broken out into a separate and generic YANG data model in order to
make it available for other interface types as well. This document obsoletes RFC 8561.</t>
    </abstract>
    <note removeInRFC="true">
      <name>About This Document</name>
      <t>
        The latest revision of this draft can be found at <eref target="https://example.com/LATEST"/>.
        Status information for this document may be found at <eref target="https://datatracker.ietf.org/doc/draft-ybam-rfc8561bis/"/>.
      </t>
      <t>
        Discussion of this document takes place on the
        CCAMP Working Group mailing list (<eref target="mailto:WG@example.com"/>),
        which is archived at <eref target="https://example.com/WG"/>.
      </t>
      <t>Source for this draft and an issue tracker can be found at
        <eref target="https://github.com/USER/REPO"/>.</t>
    </note>
  </front>
  <middle>
    <?line 182?>

<section anchor="introduction">
      <name>Introduction</name>
      <t>This document defines a YANG data model for management and control of
the radio link interface(s) and the relationship to packet (typically
Ethernet) and/or Time-Division Multiplexing (TDM) interfaces in a
microwave/millimeter wave node.  The ETSI EN 302 217 series defines
the characteristics and requirements of microwave/millimeter wave
equipment and antennas.  Specifically, ETSI EN 302 217-2 <xref target="EN302217-2"/>
specifies the essential parameters for systems operating from 1.4 GHz
to 86 GHz.  The data model includes configuration and state data
according to the new Network Management Datastore Architecture
<xref target="RFC8342"/>.</t>
      <t>The design of the data model follows the framework for management and
control of microwave and millimeter wave interface parameters defined
in <xref target="RFC8432"/>.  This framework identifies the need and the scope of
the YANG data model, use cases, and requirements that the model needs
to support.  Moreover, it provides a detailed gap analysis to
identify the missing parameters and functionalities of the existing
and established models to support the specified use cases and
requirements, and based on that, it recommends how the gaps should be
filled with the development of the new model.  According to the
conclusion of the gap analysis, the structure of the data model is
based on the structure defined in <xref target="RFC8561"/>, and it
augments <xref target="RFC8343"/> to align with the same structure for management of
the packet interfaces.  More specifically, the model will include
interface layering to manage the capacity provided by a radio link
terminal for the associated Ethernet and TDM interfaces, using the
principles for interface layering described in <xref target="RFC8343"/> as a basis.</t>
      <t>The data nodes for management of the interface protection
functionality is broken out into a separate and generic YANG data
module in order to make it also available for other interface types.</t>
      <t>The designed YANG data model uses established microwave equipment and
radio standards, such as ETSI EN 302 217-2; the IETF Radio Link Model
<xref target="RFC8561"/>; and the ONF Microwave Model <xref target="ONF-model"/>, as
the basis for the definition of the detailed leafs/parameters, and it
proposes new ones to cover identified gaps, which are analyzed in
<xref target="RFC8432"/>.</t>
      <section anchor="terminology-and-definitions">
        <name>Terminology and Definitions</name>
        <t>The following terms are used in this document:</t>
        <t>Carrier Termination (CT) is an interface for the capacity provided
over the air by a single carrier.  It is typically defined by its
transmitting and receiving frequencies.</t>
        <t>Radio Link Terminal (RLT) is an interface providing packet capacity
and/or TDM capacity to the associated Ethernet and/or TDM interfaces
in a node and is used for setting up a transport service over a
microwave/millimeter wave link.</t>
        <t>The following acronyms are used in this document:</t>
        <t>ACM Adaptive Coding Modulation</t>
        <t>ATPC Automatic Transmitter Power Control</t>
        <t>BBE Background Block Error</t>
        <t>BER Bit Error Ratio</t>
        <t>BPSK Binary Phase-Shift Keying</t>
        <t>CM Coding Modulation</t>
        <t>CT Carrier Termination</t>
        <t>ES Errored Seconds</t>
        <t>IF Intermediate Frequency</t>
        <t>MIMO Multiple Input Multiple Output</t>
        <t>RF Radio Frequency</t>
        <t>RLT Radio Link Terminal</t>
        <t>QAM Quadrature Amplitude Modulation</t>
        <t>QPSK Quadrature Phase-Shift Keying</t>
        <t>RTPC Remote Transmit Power Control</t>
        <t>SES Severely Errored Seconds</t>
        <t>TDM Time-Division Multiplexing</t>
        <t>UAS Unavailable Seconds</t>
        <t>XPIC Cross Polarization Interference Cancellation</t>
      </section>
      <section anchor="tree-structure">
        <name>Tree Structure</name>
        <t>A simplified graphical representation of the data model is used in
<xref target="tree"/> of this document.  The meaning of the symbols in these
diagrams is defined in <xref target="RFC8340"/>.</t>
      </section>
      <section anchor="prefixes-in-data-node-names">
        <name>Prefixes 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 modules, as shown in <xref target="tab-prefix"/>.</t>
        <table anchor="tab-prefix">
          <name>Prefixes for imported YANG modules</name>
          <thead>
            <tr>
              <th align="left">Prefix</th>
              <th align="left">YANG Module</th>
              <th align="left">Reference</th>
            </tr>
          </thead>
          <tbody>
            <tr>
              <td align="left">mrl</td>
              <td align="left">ietf-microwave-radio-link</td>
              <td align="left">This document</td>
            </tr>
            <tr>
              <td align="left">yang</td>
              <td align="left">ietf-yang-types</td>
              <td align="left">
                <xref target="RFC6991"/></td>
            </tr>
            <tr>
              <td align="left">ianaift</td>
              <td align="left">iana-if-type</td>
              <td align="left">
                <xref target="IANA-if-type-module"/></td>
            </tr>
            <tr>
              <td align="left">if</td>
              <td align="left">ietf-interfaces</td>
              <td align="left">
                <xref target="RFC8343"/></td>
            </tr>
            <tr>
              <td align="left">ifprot</td>
              <td align="left">ietf-interface-protection</td>
              <td align="left">This document</td>
            </tr>
            <tr>
              <td align="left">mw-types</td>
              <td align="left">ietf-microwave-types</td>
              <td align="left">This document</td>
            </tr>
          </tbody>
        </table>
        <t># Microwave Radio Link YANG Data Model</t>
      </section>
      <section anchor="tree">
        <name>YANG Tree</name>
        <artwork type="ascii-art" name="ietf-microwave-radio-link.tree"><![CDATA[
module: ietf-microwave-radio-link
  +--rw radio-link-protection-groups
  |  +--rw protection-group* [name]
  |     +---x manual-switch-working
  |     +---x manual-switch-protection
  |     +---x forced-switch
  |     +---x lockout-of-protection
  |     +---x freeze
  |     +---x exercise
  |     +---x clear
  |     +--rw name                            string
  |     +--rw protection-architecture-type?   identityref
  |     +--rw members*                        if:interface-ref
  |     +--rw operation-type?                 enumeration
  |     +--rw working-entity*                 if:interface-ref
  |     +--rw revertive-wait-to-restore?      uint16
  |     +--rw hold-off-timer?                 uint16
  |     +--ro status?                         identityref
  +--rw xpic-pairs {xpic}?
  |  +--rw xpic-pair* [name]
  |     +--rw name       string
  |     +--rw enabled?   boolean
  |     +--rw members*   if:interface-ref
  +--rw mimo-groups {mimo}?
     +--rw mimo-group* [name]
        +--rw name       string
        +--rw enabled?   boolean
        +--rw members*   if:interface-ref

  augment /if:interfaces/if:interface:
    +--rw id?                     string
    +--rw (mode-option)
    |  x--:(mode)
    |  |  x--rw mode              identityref
    |  +--:(rlt-mode)
    |     +--rw rlt-mode
    |        +--rw num-bonded-carriers        uint32
    |        +--rw num-protecting-carriers    uint32
    +--rw carrier-terminations*   if:interface-ref
    +--rw rlp-groups*
    |       -> /radio-link-protection-groups/protection-group/name
    +--rw xpic-pairs*             -> /xpic-pairs/xpic-pair/name
    |       {xpic}?
    +--rw mimo-groups*            -> /mimo-groups/mimo-group/name
    |       {mimo}?
    +--rw tdm-connections* [tdm-type] {tdm}?
    |  +--rw tdm-type           identityref
    |  +--rw tdm-connections    uint16
    +--rw header-compression {header-compression}?
       +--ro supported-profile* [name]
       |  +--ro name           string
       |  +--ro description?   string
       +--rw configured-profile?   -> ../supported-profile/name
       +--rw enabled?              boolean
       +--ro oper-status?          enumeration
  augment /if:interfaces/if:interface:
    +--rw carrier-id?                     string
    +--rw tx-enabled?                     boolean
    +--ro tx-oper-status?                 enumeration
    +--rw tx-frequency                    uint32
    +--ro actual-rx-frequency?            uint32
    +--rw channel-separation              uint32
    +--ro actual-transmitted-level?       power
    +--ro actual-tx-cm?                   identityref
    +--ro actual-snir?                    decimal64
    +--rw (freq-or-distance)
    |  +--:(rx-frequency)
    |  |  +--rw rx-frequency?             uint32
    |  +--:(duplex-distance)
    |     +--rw duplex-distance?          int32
    +--ro actual-duplex-distance?         uint32
    +--rw polarization?                   enumeration
    +--rw (power-mode)
    |  +--:(rtpc)
    |  |  +--rw rtpc
    |  |     +--rw maximum-nominal-power    mw-types:power
    |  +--:(atpc)
    |     +--rw atpc
    |        +--rw maximum-nominal-power    mw-types:power
    |        +--rw minimum-nominal-power    mw-types:power
    |        +--rw atpc-lower-threshold     mw-types:power
    |        +--rw atpc-upper-threshold     mw-types:power
    +--ro actual-received-level?          mw-types:power
    +--rw (coding-modulation-mode)
    |  +--:(single)
    |  |  +--rw single
    |  |     +--rw selected-cm    identityref
    |  +--:(adaptive)
    |     +--rw adaptive
    |        +--rw selected-min-acm        identityref
    |        +--rw selected-max-acm        identityref
    |        +--rw reference-modulation?   identityref
    +--ro actual-xpi?                     decimal64 {xpic}?
    +--rw ct-performance-thresholds
    |  +--rw received-level-alarm-threshold?      mw-types:power
    |  +--rw transmitted-level-alarm-threshold?   mw-types:power
    |  +--rw ber-alarm-threshold?                 enumeration
    +--rw if-loop?                        enumeration
    +--rw rf-loop?                        enumeration
    +--ro capabilities
    |  +--ro min-tx-frequency?          uint32
    |  +--ro max-tx-frequency?          uint32
    |  +--ro min-rx-frequency?          uint32
    |  +--ro max-rx-frequency?          uint32
    |  +--ro minimum-power?             mw-types:power
    |  +--ro maximum-available-power?   mw-types:power
    |  +--ro available-min-acm?         identityref
    |  +--ro available-max-acm?         identityref
    |  +--ro acm-profile-list*
    |          [profile-channel-separation-id profile-coding-modulation-id]
    |     +--ro profile-channel-separation-id      uint32
    |     +--ro profile-coding-modulation-id       identityref
    |     +--ro modulation-scheme?                 uint8
    |     +--ro nominal-tx-capacity?               uint32
    |     +--ro support-as-fixed-modulation?       boolean
    |     +--ro support-as-reference-modulation?   boolean
    |     +--ro max-tx-power?                      mw-types:power
    |     +--ro min-tx-power?                      mw-types:power
    |     +--ro lower-acm-profile-ptr
    |     |  +--ro profile-coding-modulation-id-ref?    leafref
    |     |  +--ro profile-channel-separation-id-ref?   leafref
    |     +--ro upper-acm-profile-ptr
    |        +--ro profile-coding-modulation-id-ref?    leafref
    |        +--ro profile-channel-separation-id-ref?   leafref
    +--ro error-performance-statistics
    |  +--ro bbe?   yang:counter32
    |  +--ro es?    yang:counter32
    |  +--ro ses?   yang:counter32
    |  +--ro uas?   yang:counter32
    +--ro radio-performance-statistics
       +--ro min-rltm?   mw-types:power
       +--ro max-rltm?   mw-types:power
       +--ro min-tltm?   mw-types:power
       +--ro max-tltm?   mw-types:power
]]></artwork>
      </section>
      <section anchor="explanation-of-the-microwave-data-model">
        <name>Explanation of the Microwave Data Model</name>
        <t>The leafs in the Interface Management Module augmented by RLT and CT
are not always applicable.</t>
        <t>"/interfaces/interface/enabled" is not applicable for RLT.  Enable
and disable of an interface is done in the constituent CTs.</t>
        <t>The packet-related measurements "in-octets", "in-unicast-pkts",
"in-broadcast-pkts", "in-multicast-pkts", "in-discards", "in-errors",
"in-unknown-protos", "out-octets", "out-unicast-pkts", "out-
broadcast-pkts", "out-multicast-pkts", "out-discards", and "out-
errors" are not within the scope of the microwave radio link domain
and therefore are not applicable for RLT and CT.</t>
      </section>
    </section>
    <section anchor="microwave-radio-link-yang-data-model">
      <name>Microwave Radio Link YANG Data Model</name>
      <t>This module imports typedefs and modules from <xref target="RFC6991"/>, <xref target="RFC8343"/>
and <xref target="RFC7224"/>, and it references <xref target="TR102311"/>, <xref target="EN302217-1"/>,
<xref target="EN301129"/>, and <xref target="G.826"/>.</t>
      <sourcecode type="yang" markers="true" name="ietf-microwave-radio-link@2025-04-04.yang"><![CDATA[
module ietf-microwave-radio-link {
  yang-version 1.1;
  namespace "urn:ietf:params:xml:ns:yang:ietf-microwave-radio-link";
  prefix mrl;

  import ietf-yang-types {
    prefix yang;
    reference
      "RFC 6991";
  }
  import iana-if-type {
    prefix ianaift;
  }
  import ietf-interfaces {
    prefix if;
    reference
      "RFC 8343";
  }
  import ietf-interface-protection {
    prefix ifprot;
    reference
      "RFC 8561";
  }
  import ietf-microwave-types {
    prefix mw-types;
    reference
      "RFC 8561";
  }

  organization
    "Internet Engineering Task Force (IETF) CCAMP WG";
  contact
    "WG List: <mailto:ccamp@ietf.org>

     Editors:
      Jonas Ahlberg (jonas.ahlberg@ericsson.com)
      Min Ye (amy.yemin@huawei.com)
      Xi Li (Xi.Li@neclab.eu)
      Daniela Spreafico (daniela.spreafico@nokia.com)
      Marko Vaupotic (Marko.Vaupotic@aviatnet.com)
      Danilo Pala (danilo.pala@siaemic.com)";
  description
    "This is a module for the entities in
     a generic microwave system.

     Copyright (c) 2025 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
     (http://trustee.ietf.org/license-info).

     This version of this YANG module is part of RFC XXXX;
     see the RFC itself for full legal notices.";

  // 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 2025-04-04 {
    description
      "Draft - Issue #32 Compression,
               Issue #35 grouping common-microwave-properties,
               Issue #31 added minimum-nominal-power";
    reference
      "RFC XXX: A YANG Data Model for Microwave Radio Link";
  }

  /*
   * Features
   */

  feature xpic {
    description
      "Indicates that the device supports XPIC.";
    reference
      "ETSI TR 102 311";
  }

  feature mimo {
    description
      "Indicates that the device supports MIMO.";
    reference
      "ETSI TR 102 311";
  }

  feature tdm {
    description
      "Indicates that the device supports TDM.";
  }

  feature header-compression {
    description
      "Indicates that the device supports Header Compression
       profiles.";
  }

  /*
   * Typedefs
   */

  grouping acm-profile {
    description
      "acm-profile";
    leaf modulation-scheme {
      type uint8;
      description
        "It is the logarithm base two of the number of points in the
         transmitted constellation.  E.G.:  value would be 2 for
         4QAM, 10 fo 1024QAM, and 12 for 4096QAM.";
    }
    leaf nominal-tx-capacity {
      type uint32;
      description
        "The nominal radio link capacity associated to this
         acm-profile.";
    }
    leaf support-as-fixed-modulation {
      type boolean;
      description
        "True when the profile can be used in single
         coding-modulation-mode.";
    }
    leaf support-as-reference-modulation {
      type boolean;
      description
        " 'true' when the profile can be used to configure the
          reference-modulation in adaptive coding-modulation-mode.
          Otherwise the value is 'false' and the reference-modulation
          to use cannot be configured 
          (it could be selected automatically by the system).
        ";
    }
    leaf max-tx-power {
      type mw-types:power;
      description
        "The maximum transmitted power when the carrier termination
         is operating this acm-profile.  Used to configure
         transmitted power.";
    }
    leaf min-tx-power {
      type mw-types:power;
      description
        "The minimum transmitted power when the carrier termination
         is operating this acm-profile.  Used to configure
         transmitted power.";
    }
  }

  /*
   * Radio Link Terminal (RLT)
   */

  augment "/if:interfaces/if:interface" {
    when "derived-from-or-self(if:type,"
       + "'ianaift:microwaveRadioLinkTerminal')";
    description
      "Addition of data nodes for the radio link terminal to
       the standard Interface data model, for interfaces of
       the type 'microwaveRadioLinkTerminal'.";
    leaf id {
      type string;
      description
        "Descriptive identity of the radio link terminal used by
         far-end RLT to check that it's connected to the correct
         near-end RLT.  Does not need to be configured if this
         check is not used.";
    }
    choice mode-option {
      mandatory true;
      description
        "A description of the mode in which the radio link
         terminal is configured in terms of:
         - number of bonded carrier terminations;
         - number of protecting carrier terminations.";
      leaf mode {
        type identityref {
          base mw-types:rlt-mode;
        }
        mandatory true;
        status deprecated;
        description
          "A description of the mode in which the radio link
           terminal is configured.  The format is X plus Y.
           X represents the number of bonded carrier terminations.
           Y represents the number of protecting carrier
           terminations.

           This attribute has been deprecated: the rlt-mode container
           which provide flexible definitions of number of bonded
           carriers and protecting carriers should be used instead.";
      }
      container rlt-mode {
        description
          "This grouping provides a flexible definition of number
           of bonded carriers and protecting carriers of a radio
           link.";
        uses mw-types:rlt-mode;
      }
    }
    leaf-list carrier-terminations {
      type if:interface-ref;
      must "derived-from-or-self(/if:interfaces/if:interface"
         + "[if:name = current()]"
         + "/if:type, 'ianaift:microwaveCarrierTermination')" {
        description
          "The type of interface must be
           'microwaveCarrierTermination'.";
      }
      min-elements 1;
      description
        "A list of references to carrier terminations
         included in the radio link terminal.";
    }
    leaf-list rlp-groups {
      type leafref {
        path "/mrl:radio-link-protection-groups/"
           + "mrl:protection-group/mrl:name";
      }
      description
        "A list of references to the carrier termination
         groups configured for radio link protection in this
         radio link terminal.";
    }
    leaf-list xpic-pairs {
      if-feature "xpic";
      type leafref {
        path "/mrl:xpic-pairs/mrl:xpic-pair/mrl:name";
      }
      description
        "A list of references to the XPIC pairs used in this
         radio link terminal.  One pair can be used by two
         terminals.";
      reference
        "ETSI TR 102 311";
    }
    leaf-list mimo-groups {
      if-feature "mimo";
      type leafref {
        path "/mrl:mimo-groups/mrl:mimo-group/mrl:name";
      }
      description
        "A reference to the MIMO group used in this
         radio link terminal.  One group can be used by more
         than one terminal.";
      reference
        "ETSI TR 102 311";
    }
    list tdm-connections {
      if-feature "tdm";
      key "tdm-type";
      description
        "A list stating the number of active TDM connections
         of a specified tdm-type that is configured to be
         supported by the RLT.";
      leaf tdm-type {
        type identityref {
          base mw-types:tdm-type;
        }
        description
          "The type of TDM connection, which also indicates
           the supported capacity.";
      }
      leaf tdm-connections {
        type uint16;
        mandatory true;
        description
          "Number of connections of the specified type.";
      }
    }
    container header-compression {
      if-feature "header-compression";
      description
        "Configuration of Header Compression ";
      list supported-profile {
        key "name";
        config false;
        description
        "The list of header compression profiles supported by the
         RLT.
         Header compression is typically vendor proprietary and it is
         assumed there is no ambition to change that. For this reason
         the list provides only generic attributes to be augmented by
         vendor with proprietary implementation attributes.";
        leaf name {
          type string;
          description
            "A name that uniquely identifies the header compression
             profile in an RLT.";
        }
        leaf description {
          type string;
          description
            "Detailed description of the profile.";
        }
      }
      leaf configured-profile {
        type leafref {
          path "../mrl:supported-profile/mrl:name";
          require-instance false;
        }
        description
          "Select the profile of header compression to be used.";
      }
      leaf enabled {
        type boolean;
        description
          "Disables (false) or enables (true) the header
           compression.";
      }
      leaf oper-status {
        type enumeration {
          enum off {
            description
              "Header compression is off.";
          }
          enum on {
            description
              "Header compression is on.";
          }
        }
        config false;
        description
          "Shows the operative status of the header compression.";
      }
    }
  }

  /*
   * Carrier Termination
   */

  augment "/if:interfaces/if:interface" {
    when "derived-from-or-self(if:type,"
       + "'ianaift:microwaveCarrierTermination')";
    description
      "Addition of data nodes for carrier termination to
       the standard Interface data model, for interfaces
       of the type 'microwaveCarrierTermination'.";
    leaf carrier-id {
      type string;
      default "A";
      description
        "ID of the carrier (e.g., A, B, C, or D).
         Used in XPIC and MIMO configurations to check that
         the carrier termination is connected to the correct
         far-end carrier termination.  Should be the same
         carrier ID on both sides of the hop.  Left as
         default value when MIMO and XPIC are not in use.";
    }
    leaf tx-enabled {
      type boolean;
      default "false";
      description
        "Disables (false) or enables (true) the transmitter.
         Only applicable when the interface is enabled
         (interface:enabled = true); otherwise, it's always
         disabled.";
    }
    leaf tx-oper-status {
      type enumeration {
        enum off {
          description
            "Transmitter is off.";
        }
        enum on {
          description
            "Transmitter is on.";
        }
        enum standby {
          description
            "Transmitter is in standby.";
        }
      }
      config false;
      description
        "Shows the operative status of the transmitter.";
    }

    uses mw-types:common-microwave-properties;

    choice freq-or-distance {
      mandatory true;
      description
        "A choice to configure rx-frequency directly or compute
         it as duplex-distance subtracted from tx-frequency.";
      leaf rx-frequency {
        type uint32;
        units "kHz";
        description
          "Selected receiver frequency.";
      }
      leaf duplex-distance {
        type int32;
        units "kHz";
        description
          "Distance between transmitter and receiver frequencies.";
      }
    }
    leaf actual-duplex-distance {
      type uint32;
      units "kHz";
      config false;
      description
        "Computed distance between Tx and Rx frequencies.";
    }
    leaf polarization {
      type enumeration {
        enum horizontal {
          description
            "Horizontal polarization.";
        }
        enum vertical {
          description
            "Vertical polarization.";
        }
        enum not-specified {
          description
            "Polarization not specified.";
        }
      }
      default "not-specified";
      description
        "Polarization - a textual description for info only.";
    }
    choice power-mode {
      mandatory true;
      description
        "A choice of RTPC or ATPC.";
      container rtpc {
        description
          "Remote Transmit Power Control (RTPC).";
        reference
          "ETSI EN 302 217-1";
        leaf maximum-nominal-power {
          type mw-types:power {
            range "-99..99";
          }
          units "dBm";
          mandatory true;
          description
            "Selected output power.";
          reference
            "ETSI EN 302 217-1";
        }
      }
      container atpc {
        description
          "Automatic Transmitter Power Control (ATPC).";
        reference
          "ETSI EN 302 217-1";
        leaf maximum-nominal-power {
          type mw-types:power {
            range "-99..99";
          }
          units "dBm";
          mandatory true;
          description
            "Nominal maximum output power.";
          reference
            "ETSI EN 302 217-1";
        }
        leaf minimum-nominal-power {
          type mw-types:power {
            range "-99..99";
          }
          units "dBm";
          mandatory true;
          description
            "Minimum output power.

             By default, minimum output power is the same as the
             system capability minimum-power.";
        }
        leaf atpc-lower-threshold {
          type mw-types:power {
            range "-99..-20";
          }
          units "dBm";
          must 'current() <= ../atpc-upper-threshold';
          mandatory true;
          description
            "The lower threshold for the input power at the
             far end, which is used in the ATPC mode.";
          reference
            "ETSI EN 302 217-1";
        }
        leaf atpc-upper-threshold {
          type mw-types:power {
            range "-99..-20";
          }
          units "dBm";
          mandatory true;
          description
            "The upper threshold for the input power at the
             far end, which is used in the ATPC mode.";
          reference
            "ETSI EN 302 217-1";
        }
      }
    }
    leaf actual-received-level {
      type mw-types:power {
        range "-99..-20";
      }
      units "dBm";
      config false;
      description
        "Actual received power level (0.1 dBm resolution).";
      reference
        "ETSI EN 301 129";
    }
    choice coding-modulation-mode {
      mandatory true;
      description
        "A selection of single or
         adaptive coding/modulation mode.";
      container single {
        description
          "A single modulation order only.";
        reference
          "ETSI EN 302 217-1";
        leaf selected-cm {
          type identityref {
            base mw-types:coding-modulation;
          }
          mandatory true;
          description
            "Selected the single coding/modulation.";
        }
      }
      container adaptive {
        description
          "Adaptive coding/modulation.";
        reference
          "ETSI EN 302 217-1";
        leaf selected-min-acm {
          type identityref {
            base mw-types:coding-modulation;
          }
          mandatory true;
          description
            "Selected minimum coding/modulation.
             Adaptive coding/modulation shall not go
             below this value.";
        }
        leaf selected-max-acm {
          type identityref {
            base mw-types:coding-modulation;
          }
          mandatory true;
          description
            "Selected maximum coding/modulation.
             Adaptive coding/modulation shall not go
             above this value.";
        }
        leaf reference-modulation {
          type identityref {
            base mw-types:coding-modulation;
          }
          description
            "the reference-modulation is the coding modulation to be
             used in the reference mode, as defined in
             ETSI EN 302 217-1 V3.2.2 (2020-02). 
             The reference mode identifies the operative mode which
             characteristics (i.e. system capacity, spectral
             efficiency class over a given channel separation) are
             used (i.e. declared in the licensing process) in the
             link per link coordination analysis. Its value has to be
             between the 'selected-min-acm' and the
             'selected-max-acm' attribute's values.
         ";
        }
      }
    }
    leaf actual-xpi {
      if-feature "xpic";
      type decimal64 {
        fraction-digits 1;
        range "0..99";
      }
      units "dB";
      config false;
      description
        "The actual carrier to cross-polar interference.
         Only valid if XPIC is enabled (0.1 dB resolution).";
      reference
        "ETSI TR 102 311";
    }
    container ct-performance-thresholds {
      description
        "Specification of thresholds for when alarms should
         be sent and cleared for various performance counters.";
      leaf received-level-alarm-threshold {
        type mw-types:power {
          range "-99..-20";
        }
        units "dBm";
        default "-99";
        description
          "An alarm is sent when the received power level is
           below the specified threshold.";
        reference
          "ETSI EN 301 129";
      }
      leaf transmitted-level-alarm-threshold {
        type mw-types:power {
          range "-99..99";
        }
        units "dBm";
        default "-99";
        description
          "An alarm is sent when the transmitted power level
           is below the specified threshold.";
        reference
          "ETSI EN 301 129";
      }
      leaf ber-alarm-threshold {
        type enumeration {
          enum 1e-9 {
            description
              "Threshold at 1e-9 (10^-9).";
          }
          enum 1e-8 {
            description
              "Threshold at 1e-8 (10^-8).";
          }
          enum 1e-7 {
            description
              "Threshold at 1e-7 (10^-7).";
          }
          enum 1e-6 {
            description
              "Threshold at 1e-6 (10^-6).";
          }
          enum 1e-5 {
            description
              "Threshold at 1e-5 (10^-5).";
          }
          enum 1e-4 {
            description
              "Threshold at 1e-4 (10^-4).";
          }
          enum 1e-3 {
            description
              "Threshold at 1e-3 (10^-3).";
          }
          enum 1e-2 {
            description
              "Threshold at 1e-2 (10^-2).";
          }
          enum 1e-1 {
            description
              "Threshold at 1e-1 (10^-1).";
          }
        }
        default "1e-6";
        description
          "Specification of at which BER an alarm should
           be raised.";
        reference
          "ETSI EN 302 217-1";
      }
    }
    leaf if-loop {
      type enumeration {
        enum disabled {
          description
            "Disables the IF Loop.";
        }
        enum client {
          description
            "Loops the signal back to the client side.";
        }
        enum radio {
          description
            "Loops the signal back to the radio side.";
        }
      }
      default "disabled";
      description
        "Enable (client/radio) or disable (disabled)
         the IF Loop, which loops the signal back to
         the client side or the radio side.";
    }
    leaf rf-loop {
      type enumeration {
        enum disabled {
          description
            "Disables the RF Loop.";
        }
        enum client {
          description
            "Loops the signal back to the client side.";
        }
        enum radio {
          description
            "Loops the signal back to the radio side.";
        }
      }
      default "disabled";
      description
        "Enable (client/radio) or disable (disabled)
         the RF loop, which loops the signal back to
         the client side or the radio side.";
    }
    container capabilities {
      config false;
      description
        "Capabilities of the installed equipment and
         some selected configurations.";
      leaf min-tx-frequency {
        type uint32;
        units "kHz";
        description
          "Minimum Tx frequency possible to use.";
      }
      leaf max-tx-frequency {
        type uint32;
        units "kHz";
        description
          "Maximum Tx frequency possible to use.";
      }
      leaf min-rx-frequency {
        type uint32;
        units "kHz";
        description
          "Minimum Rx frequency possible to use.";
      }
      leaf max-rx-frequency {
        type uint32;
        units "kHz";
        description
          "Maximum Tx frequency possible to use.";
      }
      leaf minimum-power {
        type mw-types:power;
        units "dBm";
        description
          "The minimum output power supported.";
        reference
          "ETSI EN 302 217-1";
      }
      leaf maximum-available-power {
        type mw-types:power;
        units "dBm";
        description
          "The maximum output power supported.";
        reference
          "ETSI EN 302 217-1";
      }
      leaf available-min-acm {
        type identityref {
          base mw-types:coding-modulation;
        }
        description
          "Minimum coding-modulation possible to use.";
      }
      leaf available-max-acm {
        type identityref {
          base mw-types:coding-modulation;
        }
        description
          "Maximum coding-modulation possible to use.";
      }
      list acm-profile-list {
        key "profile-channel-separation-id "
          + "profile-coding-modulation-id";
        description
          "A list of acm-profile.
           Each acm-profile is identified by a channel-separation and
           coding-modulation values as supported by the carrier
           termination and defines the parameter's values of each
           transmission acm profile.
           Basically, the list contains all acm profiles supported by
           the device.  Profiles are organized into profile chains
           for each different channel separation value available. The
           chains are formed by the lower-acm-profile-ptr and
           upper-acm-profile-ptr pointers.  The sequence in the list
           reflects the sequence of profiles that are operated by the
           device according to the fading conditions, from the clear
           sky down to the persistent rain, and vice versa. The
           channel-separation and selected-cm configuration
           parameters (or the selected-min-acm/selected-max-acm
           pair) must address one of the profiles in the list.";
        leaf profile-channel-separation-id {
          type uint32;
          description
            "Uniquely identifies the acm profile (together with
             'profile-coding-modulation-id').  It could be used to
             allow the configuration of the channel-separation
             value.";
        }
        leaf profile-coding-modulation-id {
          type identityref {
            base mw-types:coding-modulation;
          }
          description
            "Uniquely identifies the acm profile (together with
             'profile-channel-separation-id').  It could be used to
             allow the configuration of the selected-cm (single
             mode) or selected-min-acm/selected-max-acm (adaptive
             mode).";
        }
        uses acm-profile;
        container lower-acm-profile-ptr {
          description
            "Together with the upper-acm-profile-ptr parameters it
             creates a chain of acm profiles related to a specific
             channel separation value.  Specifically it references
             the next lower acm-profile, while upper-acm-profile-ptr
             references the next higher profile.  The lowest profile
             in the chain, shall not instantiate this container.  The
             acm-profile-list can contain multiple chains related to
             different channel separation values supported by the
             device.";
          leaf profile-coding-modulation-id-ref {
            type leafref {
              path "../../../acm-profile-list"
                 + "/profile-coding-modulation-id";
            }
            description
              "A reference to an acm-profile to give an order in
               acm-profile-list.  This is the reference to the
               'profile-coding-modulation-id' key of the next lower
               acm-profile in the list respect to the current one.";
          }
          leaf profile-channel-separation-id-ref {
            type leafref {
              path "../../.."
                 + "/acm-profile-list[profile-coding-modulation-id="
                 + "current()/../profile-coding-modulation-id-ref]"
                 + "/profile-channel-separation-id";
            }
            description
              "A reference to an acm-profile to give an order in
               acm-profile-list.  This is the reference to the
               'profile-channel-separation-id' key of the next lower
               acm-profile in the list respect to the current one.";
          }
        }
        container upper-acm-profile-ptr {
          description
            "Together with the lower-acm-profile-ptr parameters it
             creates a chain of acm profiles related to a specific
             channel separation value.  Specifically it references
             the next higher acm-profile, while lower-acm-profile-ptr
             references the next lower profile.  The highest profile
             in the chain, shall not instantiate this container.  The
             acm-profile-list can contain multiple chains related to
             different channel separation values supported by the
             device.";
          leaf profile-coding-modulation-id-ref {
            type leafref {
              path "../../../acm-profile-list"
                 + "/profile-coding-modulation-id";
            }
            description
              "A reference to an acm-profile to give an order in
               acm-profile-list.  This is the reference to the
               'profile-coding-modulation-id' key of the next higher
               acm-profile in the list respect to the current one.";
          }
          leaf profile-channel-separation-id-ref {
            type leafref {
              path "../../.."
                 + "/acm-profile-list[profile-coding-modulation-id="
                 + "current()/../profile-coding-modulation-id-ref]"
                 + "/profile-channel-separation-id";
            }
            description
              "A reference to an acm-profile to give an order in
               acm-profile-list.  This is the reference to the
               'profile-channel-separation-id' key of the next higher
               acm-profile in the list respect to the current one.";
          }
        }
      }
    }
    container error-performance-statistics {
      config false;
      description
        "ITU-T G.826 error performance statistics relevant for
         a microwave/millimeter wave carrier.";
      leaf bbe {
        type yang:counter32;
        units "number of block errors";
        description
          "Number of Background Block Errors (BBEs).  A BBE is an
           errored block not occurring as part of Severely Errored
           Seconds (SES).  Discontinuities in the value of this
           counter can occur at re-initialization of the management
           system and at other times as indicated by the value of
           'discontinuity-time' in ietf-interfaces.";
        reference
          "ITU-T G.826";
      }
      leaf es {
        type yang:counter32;
        units "seconds";
        description
          "Number of Errored Seconds (ES).  An ES is a one-second
           period with one or more errored blocks or at least one
           defect.  Discontinuities in the value of this counter
           can occur at re-initialization of the management system
           and at other times as indicated by the value of
           'discontinuity-time' in ietf-interfaces.";
        reference
          "ITU-T G.826";
      }
      leaf ses {
        type yang:counter32;
        units "seconds";
        description
          "Number of SES.  SES is a one-second period that contains
           equal or more than 30% errored blocks or at least
           one defect.  SES is a subset of ES.  Discontinuities in
           the value of this counter can occur at re-initialization
           of the management system and at other times as indicated
           by the value of 'discontinuity-time' in ietf-interfaces.";
        reference
          "ITU-T G.826";
      }
      leaf uas {
        type yang:counter32;
        units "seconds";
        description
          "Number of Unavailable Seconds (UAS); that is, the
           total time that the node has been unavailable.
           Discontinuities in the value of this counter can occur
           at re-initialization of the management system and at
           other times as indicated by the value of
           'discontinuity-time' in ietf-interfaces.";
        reference
          "ITU-T G.826";
      }
    }
    container radio-performance-statistics {
      config false;
      description
        "ETSI EN 301 129 radio physical interface statistics relevant
         for a carrier termination.";
      leaf min-rltm {
        type mw-types:power {
          range "-99..-20";
        }
        units "dBm";
        description
          "Minimum received power level.  Discontinuities in the
           value of this counter can occur at re-initialization
           of the management system and at other times as
           indicated by the value of 'discontinuity-time' in
           ietf-interfaces.";
        reference
          "ETSI EN 301 129";
      }
      leaf max-rltm {
        type mw-types:power {
          range "-99..-20";
        }
        units "dBm";
        description
          "Maximum received power level.  Discontinuities in the
           value of this counter can occur at re-initialization
           of the management system and at other times as
           indicated by the value of 'discontinuity-time' in
           ietf-interfaces.";
        reference
          "ETSI EN 301 129";
      }
      leaf min-tltm {
        type mw-types:power {
          range "-99..99";
        }
        units "dBm";
        description
          "Minimum transmitted power level.  Discontinuities
           in the value of this counter can occur at
           re-initialization of the management system and
           at other times as indicated by the value of
           'discontinuity-time' in ietf-interfaces.";
        reference
          "ETSI EN 301 129";
      }
      leaf max-tltm {
        type mw-types:power {
          range "-99..99";
        }
        units "dBm";
        description
          "Maximum transmitted power level.  Discontinuities
           in the value of this counter can occur at
           re-initialization of the management system and
           at other times as indicated by the value of
           'discontinuity-time' in ietf-interfaces.";
        reference
          "ETSI EN 301 129";
      }
    }
  }

  /*
   * Radio Link Protection Groups
   */

  container radio-link-protection-groups {
    description
      "Configuration of radio link protected groups of
       carrier terminations in a radio link.  More than one
       protected group per radio link terminal is allowed.";
    uses ifprot:protection-groups {
      refine "protection-group/members" {
        must "derived-from-or-self(/if:interfaces/if:interface"
           + "[if:name = current()]"
           + "/if:type, 'ianaift:microwaveCarrierTermination')" {
          description
            "The type of a protection member must be
             'microwaveCarrierTermination'.";
        }
      }
      refine "protection-group/working-entity" {
        must "derived-from-or-self(/if:interfaces/if:interface"
           + "[if:name = current()]"
           + "/if:type, 'ianaift:microwaveCarrierTermination')" {
          description
            "The type of a working-entity must be
             'microwaveCarrierTermination'.";
        }
      }
    }
  }

  /*
   * XPIC & MIMO groups - Configuration data nodes
   */

  container xpic-pairs {
    if-feature "xpic";
    description
      "Configuration of carrier termination pairs
       for operation in XPIC mode.";
    reference
      "ETSI TR 102 311";
    list xpic-pair {
      key "name";
      description
        "List of carrier termination pairs in XPIC mode.";
      leaf name {
        type string;
        description
          "Name used for identification of the XPIC pair.";
      }
      leaf enabled {
        type boolean;
        default "false";
        description
          "Enable(true)/disable(false) XPIC";
      }
      leaf-list members {
        type if:interface-ref;
        must "derived-from-or-self(/if:interfaces/if:interface"
           + "[if:name = current()]"
           + "/if:type, 'ianaift:microwaveCarrierTermination')" {
          description
            "The type of a member must be
             'microwaveCarrierTermination'.";
        }
        min-elements 2;
        max-elements 2;
        description
          "Association to XPIC pairs used in the radio link
           terminal.";
      }
    }
  }
  container mimo-groups {
    if-feature "mimo";
    description
      "Configuration of carrier terminations
       for operation in MIMO mode.";
    reference
      "ETSI TR 102 311";
    list mimo-group {
      key "name";
      description
        "List of carrier terminations in MIMO mode.";
      leaf name {
        type string;
        description
          "Name used for identification of the MIMO group.";
      }
      leaf enabled {
        type boolean;
        default "false";
        description
          "Enable(true)/disable(false) MIMO.";
      }
      leaf-list members {
        type if:interface-ref;
        must "derived-from-or-self(/if:interfaces/if:interface"
           + "[if:name = current()]"
           + "/if:type, 'ianaift:microwaveCarrierTermination')" {
          description
            "The type of a member must be
             'microwaveCarrierTermination'.";
        }
        min-elements 2;
        description
          "Association to a MIMO group if used in the radio
           link terminal.";
      }
    }
  }
}
]]></sourcecode>
    </section>
    <section anchor="interface-protection-yang-data-model">
      <name>Interface Protection YANG Data Model</name>
      <t>The data nodes for management of the interface protection
functionality is broken out from the Microwave Radio Link Module into
a separate and generic YANG data model in order to make it also
available for other interface types.</t>
      <t>This module imports modules from <xref target="RFC8343"/>, and it references
<xref target="G.808.1"/>.</t>
      <sourcecode type="yang" markers="true" name="ietf-interface-protection@2024-03-03.yang"><![CDATA[
module ietf-interface-protection {
  yang-version 1.1;
  namespace "urn:ietf:params:xml:ns:yang:ietf-interface-protection";
  prefix ifprot;

  import ietf-interfaces {
    prefix if;
    reference
      "RFC 8343";
  }

  organization
    "Internet Engineering Task Force (IETF) CCAMP WG";
  contact
    "WG List: <mailto:ccamp@ietf.org>

     Editors:
      Jonas Ahlberg (jonas.ahlberg@ericsson.com)
      Min Ye (amy.yemin@huawei.com)
      Xi Li (Xi.Li@neclab.eu)
      Daniela Spreafico (daniela.spreafico@nokia.com)
      Marko Vaupotic (Marko.Vaupotic@aviatnet.com)";
  description
    "This is a module for the entities in
     a generic interface protection mechanism.

     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 Simplified BSD License
     set forth in Section 4.c of the IETF Trust's Legal Provisions
     Relating to IETF Documents
     (http://trustee.ietf.org/license-info).

     This version of this YANG module is part of RFC XXXX; see
     the RFC itself for full legal notices.";

  // 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-03-03 {
    description
      "Updating reference to RFC XXXX. - pretty printing";
    reference
      "RFC XXX: A YANG Data Model for Microwave Radio Link";
  }
  revision 2020-10-06 {
    description
      "Updating reference to RFC XXXX.";
    reference
      "RFC XXX: A YANG Data Model for Microwave Radio Link";
  }
  revision 2019-06-19 {
    description
      "Initial revision.";
    reference
      "RFC 8561: A YANG Data Model for Microwave Radio Link";
  }

  /*
   * Protection architecture type identities
   */

  identity protection-architecture-type {
    description
      "protection architecture type";
    reference
      "ITU-T G.808.1";
  }

  identity one-plus-one-type {
    base protection-architecture-type;
    description
      "1+1; one interface protects
       another one interface.";
    reference
      "ITU-T G.808.1";
  }

  identity one-to-n-type {
    base protection-architecture-type;
    description
      "1:N; one interface protects
       n other interfaces.";
    reference
      "ITU-T G.808.1";
  }

  /*
   * Protection states identities
   */

  identity protection-states {
    description
      "Identities describing the status of the protection
       in a group of interfaces configured in
       a protection mode.";
  }

  identity unprotected {
    base protection-states;
    description
      "Not protected.";
  }

  identity protected {
    base protection-states;
    description
      "Protected.";
  }

  identity unable-to-protect {
    base protection-states;
    description
      "Unable to protect.";
  }

  /*
   * Protection Groups
   */

  grouping protection-groups {
    description
      "Configuration of protected groups of interfaces
       providing protection for each other.  More than one
       protected group per higher-layer interface is allowed.";
    list protection-group {
      key "name";
      description
        "List of protected groups of interfaces
         in a higher-layer interface.";
      action manual-switch-working {
        description
          "A switch action initiated by an operator command.
           It switches a normal traffic signal to the working
           transport entity.";
        reference
          "ITU-T G.808.1";
      }
      action manual-switch-protection {
        description
          "A switch action initiated by an operator command.
           It switches a normal traffic signal to the protection
           transport entity.";
        reference
          "ITU-T G.808.1";
      }
      action forced-switch {
        description
          "A switch action initiated by an operator command.
           It switches a normal traffic signal to the protection
           transport entity and forces it to remain on that
           entity even when criteria for switching back to
           the original entity are fulfilled.";
        reference
          "ITU-T G.808.1";
      }
      action lockout-of-protection {
        description
          "A switch action temporarily disables access to the
           protection transport entity for all signals.";
        reference
          "ITU-T G.808.1";
      }
      action freeze {
        description
          "A switch action temporarily prevents any switch action
           to be taken and, as such, freezes the current state.
           Until the freeze is cleared, additional near-end external
           commands are rejected, and fault condition changes and
           received Automatic Protection-Switching (APS) messages
           are ignored.";
        reference
          "ITU-T G.808.1";
      }
      action exercise {
        description
          "A switch action to test if the APS communication is
           operating correctly.  It is lower priority than any 'real'
           switch request.";
        reference
          "ITU-T G.808.1";
      }
      action clear {
        description
          "An action clears all switch commands.";
        reference
          "ITU-T G.808.1";
      }
      leaf name {
        type string;
        description
          "Name used for identification of the protection group.";
      }
      leaf protection-architecture-type {
        type identityref {
          base protection-architecture-type;
        }
        default "ifprot:one-plus-one-type";
        description
          "The type of protection architecture used, e.g., one
           interface protecting one or several other interfaces.";
        reference
          "ITU-T G.808.1";
      }
      leaf-list members {
        type if:interface-ref;
        min-elements 2;
        description
          "Association to a group of interfaces configured for
           protection and used by a higher-layer interface.";
      }
      leaf operation-type {
        type enumeration {
          enum non-revertive {
            description
              "In non-revertive operation, the traffic does not
               return to the working interface if the switch requests
               are terminated.";
            reference
              "ITU-T G.808.1";
          }
          enum revertive {
            description
              "In revertive operation, the traffic always
               returns to (or remains on) the working interface
               if the switch requests are terminated.";
            reference
              "ITU-T G.808.1";
          }
        }
        default "non-revertive";
        description
          "The type of protection operation, i.e., revertive
           or non-revertive operation.";
      }
      leaf-list working-entity {
        when "../operation-type = 'revertive'";
        type if:interface-ref;
        min-elements 1;
        description
          "The interfaces that the traffic normally should
           be transported over when there is no need to use the
           protecting interface.";
      }
      leaf revertive-wait-to-restore {
        when "../operation-type = 'revertive'";
        type uint16;
        units "seconds";
        default "0";
        description
          "The time to wait before switching back to the working
           interface if operation-type is revertive.";
        reference
          "ITU-T G.808.1";
      }
      leaf hold-off-timer {
        type uint16;
        units "milliseconds";
        default "0";
        description
          "Time interval after the detection of a fault and its
           confirmation as a condition requiring the protection-
           switching procedure.";
        reference
          "ITU-T G.808.1";
      }
      leaf status {
        type identityref {
          base protection-states;
        }
        config false;
        description
          "Status of the protection in a group of interfaces
           configured in a protection mode.";
        reference
          "ITU-T G.808.1";
      }
    }
  }
}
]]></sourcecode>
    </section>
    <section anchor="microwave-types-yang-data-model">
      <name>Microwave Types YANG Data Model</name>
      <t>This module defines a collection of common data types using the YANG
data modeling language.  These common types are designed to be
imported by other modules defined in the microwave area.</t>
      <sourcecode type="yang" markers="true" name="ietf-microwave-types@2025-04-04.yang"><![CDATA[
module ietf-microwave-types {
  yang-version 1.1;
  namespace "urn:ietf:params:xml:ns:yang:ietf-microwave-types";
  prefix mw-types;

  organization
    "Internet Engineering Task Force (IETF) CCAMP WG";
  contact
    "WG List: <mailto:ccamp@ietf.org>

     Editors:
      Jonas Ahlberg (jonas.ahlberg@ericsson.com)
      Min Ye (amy.yemin@huawei.com)
      Xi Li (Xi.Li@neclab.eu)
      Daniela Spreafico (daniela.spreafico@nokia.com)
      Marko Vaupotic (Marko.Vaupotic@aviatnet.com)
      Danilo Pala (danilo.pala@siaemic.com)";
  description
    "This module contains a collection of YANG data types
     considered generally useful for microwave interfaces.

     Copyright (c) 2025 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
     (http://trustee.ietf.org/license-info).

     This version of this YANG module is part of RFC 8561; see
     the RFC itself for full legal notices.";

  // 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 2025-04-04 {
    description
      "Draft - Comression #32, new grouping Issue #35";
    reference
      "RFC XXX: A YANG Data Model for Microwave Radio Link";
  }

  /*
   * Radio-link-terminal mode identities
   */

  identity rlt-mode {
    status deprecated;
    description
      "A description of the mode in which the radio link
       terminal is configured.  The format is X plus Y.
       X represents the number of bonded carrier terminations.
       Y represents the number of protecting carrier
       terminations.";
  }

  identity one-plus-zero {
    base rlt-mode;
    status deprecated;
    description
      "1 carrier termination only.";
  }

  identity one-plus-one {
    base rlt-mode;
    status deprecated;
    description
      "1 carrier termination
       and 1 protecting carrier termination.";
  }

  identity two-plus-zero {
    base rlt-mode;
    status deprecated;
    description
      "2 bonded carrier terminations.";
  }

  /*
   * Coding and modulation identities
   */

  identity coding-modulation {
    description
      "The coding and modulation schemes.";
  }

  identity half-bpsk {
    base coding-modulation;
    description
      "Half BPSK coding and modulation scheme.";
  }

  identity half-bpsk-strong {
    base half-bpsk;
    description
      "Half BPSK strong coding and modulation scheme.";
  }

  identity half-bpsk-light {
    base half-bpsk;
    description
      "Half BPSK light coding and modulation scheme.";
  }

  identity bpsk {
    base coding-modulation;
    description
      "BPSK coding and modulation scheme.";
  }

  identity bpsk-strong {
    base bpsk;
    description
      "BPSK strong coding and modulation scheme.";
  }

  identity bpsk-light {
    base bpsk;
    description
      "BPSK light coding and modulation scheme.";
  }

  identity qpsk {
    base coding-modulation;
    description
      "QPSK coding and modulation scheme.";
  }

  identity psk-8 {
    base coding-modulation;
    description
      "8PSK coding and modulation scheme.";
  }

  identity qam-4 {
    base coding-modulation;
    description
      "4 QAM coding and modulation scheme.";
  }

  identity qam-4-strong {
    base qam-4;
    description
      "4 QAM strong coding and modulation scheme.";
  }

  identity qam-4-light {
    base qam-4;
    description
      "4 QAM light coding and modulation scheme.";
  }

  identity qam-16 {
    base coding-modulation;
    description
      "16 QAM coding and modulation scheme.";
  }

  identity qam-16-strong {
    base qam-16;
    description
      "16 QAM strong coding and modulation scheme.";
  }

  identity qam-16-light {
    base qam-16;
    description
      "16 QAM light coding and modulation scheme.";
  }

  identity qam-32 {
    base coding-modulation;
    description
      "32 QAM coding and modulation scheme.";
  }

  identity qam-32-strong {
    base qam-32;
    description
      "32 QAM strong coding and modulation scheme.";
  }

  identity qam-32-light {
    base qam-32;
    description
      "32 QAM light coding and modulation scheme.";
  }

  identity qam-64 {
    base coding-modulation;
    description
      "64 QAM coding and modulation scheme.";
  }

  identity qam-64-strong {
    base qam-64;
    description
      "64 QAM strong coding and modulation scheme.";
  }

  identity qam-64-light {
    base qam-64;
    description
      "64 QAM light coding and modulation scheme.";
  }

  identity qam-128 {
    base coding-modulation;
    description
      "128 QAM coding and modulation scheme.";
  }

  identity qam-128-strong {
    base qam-128;
    description
      "128 QAM strong coding and modulation scheme.";
  }

  identity qam-128-light {
    base qam-128;
    description
      "128 QAM light coding and modulation scheme.";
  }

  identity qam-256 {
    base coding-modulation;
    description
      "256 QAM coding and modulation scheme.";
  }

  identity qam-256-strong {
    base qam-256;
    description
      "256 QAM strong coding and modulation scheme.";
  }

  identity qam-256-light {
    base qam-256;
    description
      "256 QAM light coding and modulation scheme.";
  }

  identity qam-512 {
    base coding-modulation;
    description
      "512 QAM coding and modulation scheme.";
  }

  identity qam-512-strong {
    base qam-512;
    description
      "512 QAM strong coding and modulation scheme.";
  }

  identity qam-512-light {
    base qam-512;
    description
      "512 QAM light coding and modulation scheme.";
  }

  identity qam-1024 {
    base coding-modulation;
    description
      "1024 QAM coding and modulation scheme.";
  }

  identity qam-1024-strong {
    base qam-1024;
    description
      "1024 QAM strong coding and modulation scheme.";
  }

  identity qam-1024-light {
    base qam-1024;
    description
      "1024 QAM light coding and modulation scheme.";
  }

  identity qam-2048 {
    base coding-modulation;
    description
      "2048 QAM coding and modulation scheme.";
  }

  identity qam-2048-strong {
    base qam-2048;
    description
      "2048 QAM strong coding and modulation scheme.";
  }

  identity qam-2048-light {
    base qam-2048;
    description
      "2048 QAM light coding and modulation scheme.";
  }

  identity qam-4096 {
    base coding-modulation;
    description
      "4096 QAM coding and modulation scheme.";
  }

  identity qam-4096-strong {
    base qam-4096;
    description
      "4096 QAM strong coding and modulation scheme.";
  }

  identity qam-4096-light {
    base qam-4096;
    description
      "4096 QAM light coding and modulation scheme.";
  }

  /*
   * TDM-type identities
   */

  identity tdm-type {
    description
      "A description of the type of TDM connection,
       also indicating the supported capacity of the
       connection.";
  }

  identity E1 {
    base tdm-type;
    description
      "E1 connection, 2.048 Mbit/s.";
  }

  identity STM-1 {
    base tdm-type;
    description
      "STM-1 connection, 155.52 Mbit/s.";
  }

  typedef power {
    type decimal64 {
      fraction-digits 1;
    }
    description
      "Type used for the power values in the data nodes
       for configuration or status.";
  }

  /*
   * Radio-link-terminal mode grouping
   */

  grouping rlt-mode {
    description
      "This grouping provides a flexible definition of number
       of bonded carriers and protecting carriers of a radio
       link.";
    leaf num-bonded-carriers {
      type uint32;
      mandatory true;
      description
        "Number of bonded carriers.";
    }
    leaf num-protecting-carriers {
      type uint32;
      mandatory true;
      description
        "Number of protecting carriers.";
    }
  }

  /*
   * Common microwave properties ode grouping
   */

  grouping common-microwave-properties {
    description
      "This grouping provides a reusable set of microwave
       properties.";
    leaf tx-frequency {
      type uint32;
      units "kHz";
      mandatory true;
      description
        "Selected transmitter frequency.";
    }
    leaf actual-rx-frequency {
      type uint32;
      units "kHz";
      config false;
      description
        "Computed receiver frequency.";
    }
    leaf channel-separation {
      type uint32;
      units "kHz";
      mandatory true;
      description
        "The amount of bandwidth allocated to a carrier.  The
         distance between adjacent channels in a radio
         frequency channels arrangement";
      reference
        "ETSI EN 302 217-1";
    }
    leaf actual-transmitted-level {
      type power {
        range "-99..99";
      }
      units "dBm";
      config false;
      description
        "Actual transmitted power level (0.1 dBm resolution).";
      reference
        "ETSI EN 301 129";
    }
    leaf actual-tx-cm {
      type identityref {
        base mw-types:coding-modulation;
      }
      config false;
      description
        "Actual coding/modulation in transmitting direction.";
    }
    leaf actual-snir {
      type decimal64 {
        fraction-digits 1;
        range "0..99";
      }
      units "dB";
      config false;
      description
        "Actual signal to noise plus the interference ratio
         (0.1 dB resolution).";
    }
  }
}
]]></sourcecode>
    </section>
    <section anchor="security-considerations">
      <name>Security Considerations</name>
      <t>The YANG data models specified in this document define schemas 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.</t>
      <t>There are a number of data nodes defined in these YANG data models
that are writable/creatable/deletable (i.e., config true, which is
the default).  These data nodes may be considered sensitive or
vulnerable in some network environments.  Write operations (e.g.,
edit-config) to these data nodes without proper protection can have a
negative effect on network operations.  These are the subtrees and
data nodes and their sensitivity/vulnerability:</t>
      <t>Interfaces of type microwaveRadioLinkTerminal:</t>
      <artwork><![CDATA[
      /if:interfaces/if:interface/mode,
      /if:interfaces/if:interface/carrier-terminations,
      /if:interfaces/if:interface/rlp-groups,
      /if:interfaces/if:interface/xpic-pairs,
      /if:interfaces/if:interface/mimo-groups, and
      /if:interfaces/if:interface/tdm-connections:
]]></artwork>
      <t>These data nodes represent the configuration of the radio link
terminal, and they need to match the configuration of the radio link
terminal on the other side of the radio link.  Unauthorized access to
these data nodes could interrupt the ability to forward traffic.</t>
      <t>Interfaces of type microwaveCarrierTermination:</t>
      <artwork><![CDATA[
      /if:interfaces/if:interface/carrier-id,
      /if:interfaces/if:interface/tx-enabled,
      /if:interfaces/if:interface/tx-frequency,
      /if:interfaces/if:interface/rx-frequency,
      /if:interfaces/if:interface/duplex-distance,
      /if:interfaces/if:interface/channel-separation,
      /if:interfaces/if:interface/rtpc/maximum-nominal-power,
      /if:interfaces/if:interface/atpc/maximum-nominal-power,
      /if:interfaces/if:interface/atpc/atpc-lower-threshold,
      /if:interfaces/if:interface/atpc/atpc-upper-threshold,
      /if:interfaces/if:interface/single/selected-cm,
      /if:interfaces/if:interface/adaptive/selected-min-acm,
      /if:interfaces/if:interface/adaptive/selected-max-acm,
      /if:interfaces/if:interface/if-loop, and
      /if:interfaces/if:interface/rf-loop:
]]></artwork>
      <t>These data nodes represent the configuration of the carrier
termination, and they need to match the configuration of the carrier
termination on the other side of the carrier.  Unauthorized access to
these data nodes could interrupt the ability to forward traffic.</t>
      <t>Radio link protection:</t>
      <artwork><![CDATA[
      /radio-link-protection-groups/protection-group:
]]></artwork>
      <t>This data node represents the configuration of the protection of
carrier terminations.  Unauthorized access to this data node could
interrupt the ability to forward traffic or remove the ability to
perform a necessary protection switch.</t>
      <t>XPIC:</t>
      <artwork><![CDATA[
      /xpic-pairs:
]]></artwork>
      <t>This data node represents the XPIC configuration of a pair of
carriers.  Unauthorized access to this data node could interrupt the
ability to forward traffic.</t>
      <t>MIMO:</t>
      <artwork><![CDATA[
      /mimo-groups:
]]></artwork>
      <t>This data node represents the MIMO configuration of multiple
carriers.  Unauthorized access to this data node could interrupt the
ability to forward traffic.</t>
      <t>Some of the RPC operations in this YANG data model may be considered
sensitive or vulnerable in some network environments.  It is thus
important to control access to these operations.  These are the
operations and their sensitivity/vulnerability:</t>
      <t>Radio link protection:</t>
      <artwork><![CDATA[
  /radio-link-protection-groups/protection-group/
                                          manual-switch-working,
  /radio-link-protection-groups/protection-group/
                                          manual-switch-protection,
  /radio-link-protection-groups/protection-group/forced-switch,
  /radio-link-protection-groups/protection-group/
                                          lockout-of-protection,
  /radio-link-protection-groups/protection-group/freeze,
  /radio-link-protection-groups/protection-group/exercise, and
  /radio-link-protection-groups/protection-group/clear
]]></artwork>
      <t>These data nodes represent actions that might have an impact on the
configuration of the protection of carrier terminations.
Unauthorized access to these data nodes could interrupt the ability
to forward traffic or remove the ability to perform a necessary
protection switch.</t>
      <t>The security considerations of <xref target="RFC8343"/> also apply to this document.</t>
    </section>
    <section anchor="iana-considerations">
      <name>IANA Considerations</name>
      <t>No IANA Considerations in this update.</t>
    </section>
  </middle>
  <back>
    <references anchor="sec-combined-references">
      <name>References</name>
      <references anchor="sec-normative-references">
        <name>Normative References</name>
        <reference anchor="RFC8561">
          <front>
            <title>A YANG Data Model for Microwave Radio Link</title>
            <author fullname="J. Ahlberg" initials="J." surname="Ahlberg"/>
            <author fullname="M. Ye" initials="M." surname="Ye"/>
            <author fullname="X. Li" initials="X." surname="Li"/>
            <author fullname="D. Spreafico" initials="D." surname="Spreafico"/>
            <author fullname="M. Vaupotic" initials="M." surname="Vaupotic"/>
            <date month="June" year="2019"/>
            <abstract>
              <t>This document defines a YANG data model for control and management of radio link interfaces and their connectivity to packet (typically Ethernet) interfaces in a microwave/millimeter wave node. The data nodes for management of the interface protection functionality is broken out into a separate and generic YANG data model in order to make it available for other interface types as well.</t>
            </abstract>
          </front>
          <seriesInfo name="RFC" value="8561"/>
          <seriesInfo name="DOI" value="10.17487/RFC8561"/>
        </reference>
        <reference anchor="RFC8343">
          <front>
            <title>A YANG Data Model for Interface Management</title>
            <author fullname="M. Bjorklund" initials="M." surname="Bjorklund"/>
            <date month="March" year="2018"/>
            <abstract>
              <t>This document defines a YANG data model for the management of network interfaces. It is expected that interface-type-specific data models augment the generic interfaces data model defined in this document. The data model includes definitions for configuration and system state (status information and counters for the collection of statistics).</t>
              <t>The YANG data model in this document conforms to the Network Management Datastore Architecture (NMDA) defined in RFC 8342.</t>
              <t>This document obsoletes RFC 7223.</t>
            </abstract>
          </front>
          <seriesInfo name="RFC" value="8343"/>
          <seriesInfo name="DOI" value="10.17487/RFC8343"/>
        </reference>
        <reference anchor="RFC6991">
          <front>
            <title>Common YANG Data Types</title>
            <author fullname="J. Schoenwaelder" initials="J." role="editor" surname="Schoenwaelder"/>
            <date month="July" year="2013"/>
            <abstract>
              <t>This document introduces a collection of common data types to be used with the YANG data modeling language. This document obsoletes RFC 6021.</t>
            </abstract>
          </front>
          <seriesInfo name="RFC" value="6991"/>
          <seriesInfo name="DOI" value="10.17487/RFC6991"/>
        </reference>
        <reference anchor="RFC7224">
          <front>
            <title>IANA Interface Type YANG Module</title>
            <author fullname="M. Bjorklund" initials="M." surname="Bjorklund"/>
            <date month="May" year="2014"/>
            <abstract>
              <t>This document defines the initial version of the iana-if-type YANG module.</t>
            </abstract>
          </front>
          <seriesInfo name="RFC" value="7224"/>
          <seriesInfo name="DOI" value="10.17487/RFC7224"/>
        </reference>
        <reference anchor="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="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">
          <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">
          <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">
          <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 anchor="sec-informative-references">
        <name>Informative References</name>
        <reference anchor="IANA-if-type-module" target="http://www.iana.or/assignments/iana-if-type">
          <front>
            <title>iana-if-type YANG Module</title>
            <author>
              <organization>IANA</organization>
            </author>
            <date year="2023" month="January"/>
          </front>
        </reference>
        <reference anchor="EN301129">
          <front>
            <title>Transmission and Multiplexing (TM); Digital Radio Relay Systems (DRRS); Synchronous Digital Hierarchy (SDH); System performance monitoring parameters of SDH DRRS</title>
            <author>
              <organization>ETSI</organization>
            </author>
            <date year="1999" month="May"/>
          </front>
          <seriesInfo name="EN 301 129 V1.1.2" value=""/>
        </reference>
        <reference anchor="EN302217-1">
          <front>
            <title>Fixed Radio Systems; Characteristics and requirements for point-to-point equipment and antennas; Part 1: Overview, common characteristics and system- dependent requirements</title>
            <author>
              <organization>ETSI</organization>
            </author>
            <date year="2017" month="May"/>
          </front>
          <seriesInfo name="EN 302 217-1 V3.1.0" value=""/>
        </reference>
        <reference anchor="EN302217-2">
          <front>
            <title>Fixed Radio Systems; Characteristics and requirements for point to-point equipment and antennas; Part 2: Digital systems operating in frequency bands from 1 GHz to 86 GHz; Harmonised Standard covering the essential requirements of article 3.2 of Directive 2014/53/EU</title>
            <author>
              <organization>ETSI</organization>
            </author>
            <date year="2017" month="May"/>
          </front>
          <seriesInfo name="EN 302 217-2 V3.1.1" value=""/>
        </reference>
        <reference anchor="G.808.1">
          <front>
            <title>SERIES G: TRANSMISSION SYSTEMS AND MEDIA, DIGITAL SYSTEMS AND NETWORKS; Digital networks ; General aspects Generic protection switching ; Linear trail and subnetwork protection</title>
            <author>
              <organization>ITU-T</organization>
            </author>
            <date year="2014" month="May"/>
          </front>
          <seriesInfo name="ITU-T Recommendation G.808.1" value=""/>
        </reference>
        <reference anchor="G.826">
          <front>
            <title>SERIES G: TRANSMISSION SYSTEMS AND MEDIA, DIGITAL SYSTEMS AND NETWORKS; Digital networks - Quality and availability targets; End-to-end error performance parameters and objectives for international, constant bit- rate digital paths and connections</title>
            <author>
              <organization>ITU-T</organization>
            </author>
            <date year="2002" month="December"/>
          </front>
          <seriesInfo name="ITU-T Recommendation G.826" value=""/>
        </reference>
        <reference anchor="ONF-model" target="https://www.opennetworking.org/images/stories/downloads/sdn-resources/technical-reports/TR-532-Microwave-Information-Model-V1.pdf">
          <front>
            <title>Microwave Information Model</title>
            <author>
              <organization>ONF</organization>
            </author>
            <date year="2016" month="December"/>
          </front>
          <seriesInfo name="TR-532, version 1.0" value=""/>
        </reference>
        <reference anchor="TR102311">
          <front>
            <title>Fixed Radio Systems; Point-to-point equipment; Specific aspects of the spatial frequency reuse method</title>
            <author>
              <organization>ETSI</organization>
            </author>
            <date year="2015" month="November"/>
          </front>
          <seriesInfo name="ETSI TR 102 311 V1.2.1" value=""/>
        </reference>
        <reference anchor="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="RFC8432">
          <front>
            <title>A Framework for Management and Control of Microwave and Millimeter Wave Interface Parameters</title>
            <author fullname="J. Ahlberg" initials="J." role="editor" surname="Ahlberg"/>
            <author fullname="M. Ye" initials="M." role="editor" surname="Ye"/>
            <author fullname="X. Li" initials="X." surname="Li"/>
            <author fullname="LM. Contreras" initials="LM." surname="Contreras"/>
            <author fullname="CJ. Bernardos" initials="CJ." surname="Bernardos"/>
            <date month="October" year="2018"/>
            <abstract>
              <t>The unification of control and management of microwave radio link interfaces is a precondition for seamless multi-layer networking and automated network provisioning and operation.</t>
              <t>This document describes the required characteristics and use cases for control and management of radio link interface parameters using a YANG data model.</t>
              <t>The purpose is to create a framework to identify the necessary information elements and define a YANG data model for control and management of the radio link interfaces in a microwave node. Some parts of the resulting model may be generic and could also be used by other technologies, e.g., Ethernet technology.</t>
            </abstract>
          </front>
          <seriesInfo name="RFC" value="8432"/>
          <seriesInfo name="DOI" value="10.17487/RFC8432"/>
        </reference>
        <reference anchor="RFC8340">
          <front>
            <title>YANG Tree Diagrams</title>
            <author fullname="M. Bjorklund" initials="M." surname="Bjorklund"/>
            <author fullname="L. Berger" initials="L." role="editor" surname="Berger"/>
            <date month="March" year="2018"/>
            <abstract>
              <t>This document captures the current syntax used in YANG module tree diagrams. The purpose of this document is to provide a single location for this definition. This syntax may be updated from time to time based on the evolution of the YANG language.</t>
            </abstract>
          </front>
          <seriesInfo name="BCP" value="215"/>
          <seriesInfo name="RFC" value="8340"/>
          <seriesInfo name="DOI" value="10.17487/RFC8340"/>
        </reference>
      </references>
    </references>
    <?line 2457?>

<section anchor="changes-bis">
      <name>Changes from RFC 8561</name>
      <t>To be added in a future revision of this draft.</t>
    </section>
    <section anchor="example-10-and-20-configuration-instances">
      <name>Example: 1+0 and 2+0 Configuration Instances</name>
      <t>This section gives simple examples of 1+0 and 2+0 instances using the
   YANG data model defined in this document.  The examples are not
   intended as a complete module for 1+0 and 2+0 configuration.</t>
      <section anchor="instance">
        <name>1+0 Instance</name>
        <figure anchor="fig-1-plus-0-example">
          <name>1+0 Example</name>
          <artwork type="ascii-art" name="1+0-example.txt"><![CDATA[
                    /--------- Radio Link ---------\
                     Near End              Far End

              +---------------+           +---------------+
              |  Radio Link   |           | Radio Link    |
              |  Terminal A   |           | Terminal B    |
              |               |           |               |
              |               |           |               |
              | +-----------+ |           | +-----------+ |
              | |           | | Carrier A | |           | |
              | |  Carrier  | |<--------->| |  Carrier  | |
              | |Termination| |           | |Termination| |
              | |     1     | |           | |     1     | |
              | +-----------+ |           | +-----------+ |
              |               |           |               |
              |               |           |               |
              +---------------+           +---------------+

        \--- Microwave Node ---/          \--- Microwave Node ---/
]]></artwork>
        </figure>
        <t><xref target="fig-1-plus-0-example"/> shows a 1+0 example.  The following instance shows the 1+0 configuration of the Near End node.</t>
        <artwork type="ascii-art" name="1+0-example.json"><![CDATA[
{
  "ietf-interfaces:interfaces": {
    "interface": [
      {
        "name": "RLT-A",
        "description": "Radio Link Terminal A",
        "type": "iana-if-type:microwaveRadioLinkTerminal",
        "ietf-microwave-radio-link:mode":
           "ietf-microwave-types:one-plus-zero",
        "ietf-microwave-radio-link:carrier-terminations": [
          "RLT-A:CT-1"
        ]
      },
      {
        "name": "RLT-A:CT-1",
        "description": "Carrier Termination 1",
        "type": "iana-if-type:microwaveCarrierTermination",
        "ietf-microwave-radio-link:carrier-id": "A",
        "ietf-microwave-radio-link:tx-enabled": true,
        "ietf-microwave-radio-link:tx-frequency": 10728000,
        "ietf-microwave-radio-link:duplex-distance": 644000,
        "ietf-microwave-radio-link:channel-separation": 28000,
        "ietf-microwave-radio-link:polarization": "not-specified",
        "ietf-microwave-radio-link:rtpc": {
          "maximum-nominal-power": "20.0"
        },
        "ietf-microwave-radio-link:single": {
          "selected-cm": "ietf-microwave-types:qam-512"
        }
      }
    ]
  }
}
]]></artwork>
      </section>
      <section anchor="instance-1">
        <name>2+0 Instance</name>
        <t><xref target="fig-2-plus-0-example"/> shows a 2+0 example.</t>
        <figure anchor="fig-2-plus-0-example">
          <name>2+0 Example</name>
          <artwork type="ascii-art" name="2+0-example.txt"><![CDATA[
                    /--------- Radio Link ---------\
                     Near End              Far End

              +---------------+           +---------------+
              | Radio Link    |           | Radio Link    |
              | Terminal A    |           | Terminal B    |
              |               |           |               |
              |               |           |               |
              | +-----------+ |           | +-----------+ |
              | |           | | Carrier A | |           | |
              | |  Carrier  | |<--------->| |  Carrier  | |
              | |Termination| |           | |Termination| |
              | |     1     | |           | |     1     | |
              | +-----------+ |           | +-----------+ |
              |               |           |               |
              | +-----------+ |           | +-----------+ |
              | |           | | Carrier B | |           | |
              | |  Carrier  | |<--------->| |  Carrier  | |
              | |Termination| |           | |Termination| |
              | |     2     | |           | |     2     | |
              | +-----------+ |           | +-----------+ |
              |               |           |               |
              +---------------+           +---------------+

        \--- Microwave Node ---/          \--- Microwave Node ---/
]]></artwork>
        </figure>
        <t>The following instance shows the 2+0 configuration of the Near End
node.</t>
        <artwork type="ascii-art" name="2+0-example.json"><![CDATA[
{
  "ietf-interfaces:interfaces": {
    "interface": [
      {
        "name": "RLT-A",
        "description": "Radio Link Terminal A",
        "type": "iana-if-type:microwaveRadioLinkTerminal",
        "ietf-microwave-radio-link:mode":
          "ietf-microwave-types:two-plus-zero",
        "ietf-microwave-radio-link:carrier-terminations": [
          "RLT-A:CT-1",
          "RLT-A:CT-2"
        ]
      },
      {
        "name": "RLT-A:CT-1",
        "description": "Carrier Termination 1",
        "type": "iana-if-type:microwaveCarrierTermination",
        "ietf-microwave-radio-link:carrier-id": "A",
        "ietf-microwave-radio-link:tx-enabled": true,
        "ietf-microwave-radio-link:tx-frequency": 10728000,
        "ietf-microwave-radio-link:duplex-distance": 644000,
        "ietf-microwave-radio-link:channel-separation": 28000,
        "ietf-microwave-radio-link:polarization": "not-specified",
        "ietf-microwave-radio-link:rtpc": {
          "maximum-nominal-power": "20.0"
        },
        "ietf-microwave-radio-link:single": {
          "selected-cm": "ietf-microwave-types:qam-512"
        }
      },
      {
        "name": "RLT-A:CT-2",
        "description": "Carrier Termination 2",
        "type": "iana-if-type:microwaveCarrierTermination",
        "ietf-microwave-radio-link:carrier-id": "B",
        "ietf-microwave-radio-link:tx-enabled": true,
        "ietf-microwave-radio-link:tx-frequency": 10618000,
        "ietf-microwave-radio-link:duplex-distance": 644000,
        "ietf-microwave-radio-link:channel-separation": 28000,
        "ietf-microwave-radio-link:polarization": "not-specified",
        "ietf-microwave-radio-link:rtpc": {
          "maximum-nominal-power": "20.0"
        },
        "ietf-microwave-radio-link:single": {
          "selected-cm": "ietf-microwave-types:qam-512"
        }
      }
    ]
  }
}
]]></artwork>
      </section>
      <section anchor="xpic-instance">
        <name>2+0 XPIC Instance</name>
        <t>The following instance shows the XPIC configuration of the Near End
node.</t>
        <artwork type="ascii-art" name="2+0-xpic-example.json"><![CDATA[
{
  "ietf-interfaces:interfaces": {
    "interface": [
      {
        "name": "RLT-A",
        "description": "Radio Link Terminal A",
        "type": "iana-if-type:microwaveRadioLinkTerminal",
        "ietf-microwave-radio-link:mode":
           "ietf-microwave-types:two-plus-zero",
        "ietf-microwave-radio-link:carrier-terminations": [
          "RLT-A:CT-1",
          "RLT-A:CT-2"
        ],
        "ietf-microwave-radio-link:xpic-pairs": [
          "xpic-pair1"
        ]
      },
      {
        "name": "RLT-A:CT-1",
        "description": "Carrier Termination 1",
        "type": "iana-if-type:microwaveCarrierTermination",
        "ietf-microwave-radio-link:carrier-id": "A",
        "ietf-microwave-radio-link:tx-enabled": true,
        "ietf-microwave-radio-link:tx-frequency": 10728000,
        "ietf-microwave-radio-link:duplex-distance": 644000,
        "ietf-microwave-radio-link:channel-separation": 28000,
        "ietf-microwave-radio-link:polarization": "not-specified",
        "ietf-microwave-radio-link:rtpc": {
          "maximum-nominal-power": "20.0"
        },
        "ietf-microwave-radio-link:single": {
          "selected-cm": "ietf-microwave-types:qam-512"
        }
      },
      {
        "name": "RLT-A:CT-2",
        "description": "Carrier Termination 2",
        "type": "iana-if-type:microwaveCarrierTermination",
        "ietf-microwave-radio-link:carrier-id": "B",
        "ietf-microwave-radio-link:tx-enabled": true,
        "ietf-microwave-radio-link:tx-frequency": 10618000,
        "ietf-microwave-radio-link:duplex-distance": 644000,
        "ietf-microwave-radio-link:channel-separation": 28000,
        "ietf-microwave-radio-link:polarization": "not-specified",
        "ietf-microwave-radio-link:rtpc": {
          "maximum-nominal-power": "20.0"
        },
        "ietf-microwave-radio-link:single": {
          "selected-cm": "ietf-microwave-types:qam-512"
        }
      }
    ]
  },
  "ietf-microwave-radio-link:xpic-pairs": {
    "xpic-pair": [
      {
        "name": "xpic-pair1",
        "members": [
          "RLT-A:CT-1",
          "RLT-A:CT-2"
        ]
      }
    ]
  }
}
]]></artwork>
        <t>~~~~</t>
      </section>
    </section>
    <section anchor="acknowledgments">
      <name>Acknowledgments</name>
      <t>This document was prepared using the kramdown RFC tool written and maintained by Carsten Bormann. Thanks to Martin Thomson for the github integration of the kramdown RFC tool and for the aasvg tool which is used for the ascii to SVG conversion.</t>
    </section>
    <section anchor="contributors" numbered="false" toc="include" removeInRFC="false">
      <name>Contributors</name>
      <contact fullname="Italo Busi">
        <organization>Huawei Technologies</organization>
        <address>
          <email>italo.busi@huawei.com</email>
        </address>
      </contact>
      <contact fullname="Koji Kawada">
        <organization>NEC Corporation</organization>
        <address>
          <postal>
            <street>1753, Shimonumabe Nakahara-ku</street>
            <region>Kawasaki, Kanagawa</region>
            <code>211-8666</code>
            <country>Japan</country>
          </postal>
          <email>k-kawada@ah.jp.nec.com</email>
        </address>
      </contact>
      <contact fullname="Carlos J. Bernardos">
        <organization>Universidad Carlos III de Madrid</organization>
        <address>
          <postal>
            <street>Av. Universidad, 30</street>
            <city>Leganes, Madrid</city>
            <code>28911</code>
            <country>Spain</country>
          </postal>
          <email>cjbc@it.uc3m.es</email>
        </address>
      </contact>
      <contact fullname="Marko Vaupotic">
        <organization>Aviat Networks</organization>
        <address>
          <postal>
            <street>Motnica 9</street>
            <city>Trzin-Ljubljana</city>
            <code>1236</code>
            <country>Slovenia</country>
          </postal>
          <email>Marko.Vaupotic@Aviatnet.com</email>
        </address>
      </contact>
      <contact fullname="Xi Li">
        <organization>NEC Laboratories Europe</organization>
        <address>
          <postal>
            <street>Kurfursten-Anlage 36</street>
            <city>Heidelberg</city>
            <code>69115</code>
            <country>Germany</country>
          </postal>
          <email>Xi.Li@neclab.eu</email>
        </address>
      </contact>
    </section>
  </back>
  <!-- ##markdown-source:
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
7db/B0QC83MUSAEA

-->

</rfc>
