Tech-invite3GPPspaceIETFspace
96959493929190898887868584838281807978777675747372717069686766656463626160595857565554535251504948474645444342414039383736353433323130292827262524232221201918171615141312111009080706050403020100
in Index   Prev   Next

RFC 8561

A YANG Data Model for Microwave Radio Link

Pages: 53
Proposed Standard
Errata
Part 1 of 2 – Pages 1 to 26
None   None   Next

Top   ToC   RFC8561 - Page 1
Internet Engineering Task Force (IETF)                        J. Ahlberg
Request for Comments: 8561                                   Ericsson AB
Category: Standards Track                                          M. Ye
ISSN: 2070-1721                                      Huawei Technologies
                                                                   X. Li
                                                 NEC Laboratories Europe
                                                            D. Spreafico
                                                              Nokia - IT
                                                             M. Vaupotic
                                                          Aviat Networks
                                                               June 2019


               A YANG Data Model for Microwave Radio Link

Abstract

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. Status of This Memo This is an Internet Standards Track document. This document is a product of the Internet Engineering Task Force (IETF). It represents the consensus of the IETF community. It has received public review and has been approved for publication by the Internet Engineering Steering Group (IESG). Further information on Internet Standards is available in Section 2 of RFC 7841. Information about the current status of this document, any errata, and how to provide feedback on it may be obtained at https://www.rfc-editor.org/info/rfc8561.
Top   ToC   RFC8561 - Page 2
Copyright Notice

   Copyright (c) 2019 IETF Trust and the persons identified as the
   document authors.  All rights reserved.

   This document is subject to BCP 78 and the IETF Trust's Legal
   Provisions Relating to IETF Documents
   (https://trustee.ietf.org/license-info) in effect on the date of
   publication of this document.  Please review these documents
   carefully, as they describe your rights and restrictions with respect
   to this document.  Code Components extracted from this document must
   include Simplified BSD License text as described in Section 4.e of
   the Trust Legal Provisions and are provided without warranty as
   described in the Simplified BSD License.

Table of Contents

1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . 3 1.1. Terminology and Definitions . . . . . . . . . . . . . . . 3 1.2. Tree Structure . . . . . . . . . . . . . . . . . . . . . 5 2. Microwave Radio Link YANG Data Model . . . . . . . . . . . . 5 2.1. YANG Tree . . . . . . . . . . . . . . . . . . . . . . . . 5 2.2. Explanation of the Microwave Data Model . . . . . . . . . 7 3. Microwave Radio Link YANG Data Model . . . . . . . . . . . . 7 4. Interface Protection YANG Data Model . . . . . . . . . . . . 27 5. Microwave Types YANG Data Model . . . . . . . . . . . . . . . 33 6. Security Considerations . . . . . . . . . . . . . . . . . . . 40 7. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 42 8. References . . . . . . . . . . . . . . . . . . . . . . . . . 43 8.1. Normative References . . . . . . . . . . . . . . . . . . 43 8.2. Informative References . . . . . . . . . . . . . . . . . 44 Appendix A. Example: 1+0 and 2+0 Configuration Instances . . . . 47 A.1. 1+0 Instance . . . . . . . . . . . . . . . . . . . . . . 47 A.2. 2+0 Instance . . . . . . . . . . . . . . . . . . . . . . 49 A.3. 2+0 XPIC Instance . . . . . . . . . . . . . . . . . . . . 50 Contributors . . . . . . . . . . . . . . . . . . . . . . . . . . 52 Authors' Addresses . . . . . . . . . . . . . . . . . . . . . . . 53
Top   ToC   RFC8561 - Page 3

1. Introduction

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 [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 [RFC8342]. The design of the data model follows the framework for management and control of microwave and millimeter wave interface parameters defined in [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 [MICROWAVE-RADIO-LINK], and it augments [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 [RFC8343] as a basis. 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. The designed YANG data model uses established microwave equipment and radio standards, such as ETSI EN 302 217-2; the IETF Radio Link Model [MICROWAVE-RADIO-LINK]; and the ONF Microwave Model [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 [RFC8432].

1.1. Terminology and Definitions

The following terms are used in this document: 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.
Top   ToC   RFC8561 - Page 4
   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.

   The following acronyms are used in this document:

       ACM:  Adaptive Coding Modulation

       ATPC: Automatic Transmitter Power Control

       BBE:  Background Block Error

       BER:  Bit Error Ratio

       BPSK: Binary Phase-Shift Keying

       CM:   Coding Modulation

       CT:   Carrier Termination

       ES:   Errored Seconds

       IF:   Intermediate Frequency

       MIMO: Multiple Input Multiple Output

       RF:   Radio Frequency

       RLT:  Radio Link Terminal

       QAM:  Quadrature Amplitude Modulation

       QPSK: Quadrature Phase-Shift Keying

       RTPC: Remote Transmit Power Control

       SES:  Severely Errored Seconds

       TDM:  Time-Division Multiplexing

       UAS:  Unavailable Seconds

       XPIC: Cross Polarization Interference Cancellation
Top   ToC   RFC8561 - Page 5

1.2. Tree Structure

A simplified graphical representation of the data model is used in Section 2.1 of this document. The meaning of the symbols in these diagrams is defined in [RFC8340].

2. Microwave Radio Link YANG Data Model

2.1. YANG Tree

module: ietf-microwave-radio-link +--rw radio-link-protection-groups | +--rw protection-group* [name] | +--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 | +---x manual-switch-working | +---x manual-switch-protection | +---x forced-switch | +---x lockout-of-protection | +---x freeze | +---x exercise | +---x clear +--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 identityref +--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}?
Top   ToC   RFC8561 - Page 6
       +--rw tdm-connections* [tdm-type] {tdm}?
          +--rw tdm-type             identityref
          +--rw tdm-connections      uint16
     augment /if:interfaces/if:interface:
       +--rw carrier-id?                     string
       +--rw tx-enabled?                     boolean
       +--ro tx-oper-status?                 enumeration
       +--rw tx-frequency                    uint32
       +--rw (freq-or-distance)
       |  +--:(rx-frequency)
       |  |  +--rw rx-frequency?                   uint32
       |  +--:(duplex-distance)
       |     +--rw duplex-distance?                int32
       +--ro actual-rx-frequency?            uint32
       +--ro actual-duplex-distance?         uint32
       +--rw channel-separation              uint32
       +--rw polarization?                   enumeration
       +--rw (power-mode)
       |  +--:(rtpc)
       |  |  +--rw rtpc
       |  |     +--rw maximum-nominal-power        power
       |  +--:(atpc)
       |     +--rw atpc
       |        +--rw maximum-nominal-power        power
       |        +--rw atpc-lower-threshold         power
       |        +--rw atpc-upper-threshold         power
       +--ro actual-transmitted-level?             power
       +--ro actual-received-level?                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
       +--ro actual-tx-cm?                   identityref
       +--ro actual-snir?                    decimal64
       +--ro actual-xpi?                     decimal64 {xpic}?
       +--rw ct-performance-thresholds
       |  +--rw received-level-alarm-threshold?      power
       |  +--rw transmitted-level-alarm-threshold?   power
       |  +--rw ber-alarm-threshold?                 enumeration
       +--rw if-loop?                        enumeration
       +--rw rf-loop?                        enumeration
Top   ToC   RFC8561 - Page 7
       +--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?             power
       |  +--ro maximum-available-power?   power
       |  +--ro available-min-acm?         identityref
       |  +--ro available-max-acm?         identityref
       +--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?   power
          +--ro max-rltm?   power
          +--ro min-tltm?   power
          +--ro max-tltm?   power

2.2. Explanation of the Microwave Data Model

The leafs in the Interface Management Module augmented by RLT and CT are not always applicable. "/interfaces/interface/enabled" is not applicable for RLT. Enable and disable of an interface is done in the constituent CTs. 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.

3. Microwave Radio Link YANG Data Model

This module imports typedefs and modules from [RFC6991], [RFC8343] and [RFC7224], and it references [TR102311], [EN302217-1], [EN301129], and [G.826]. <CODE BEGINS> file "ietf-microwave-radio-link@2019-06-19.yang" module ietf-microwave-radio-link { yang-version 1.1; namespace "urn:ietf:params:xml:ns:yang:ietf-microwave-radio-link"; prefix mrl;
Top   ToC   RFC8561 - Page 8
     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)";
     description
       "This is a module for the entities in
        a generic microwave system.

        Copyright (c) 2019 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).
Top   ToC   RFC8561 - Page 9
        This version of this YANG module is part of RFC 8561; see
        the RFC itself for full legal notices.";

     revision 2019-06-19 {
       description
         "Initial revision.";
       reference
         "RFC 8561: 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.";
     }

     /*
      * Typedefs
      */

     typedef power {
       type decimal64 {
         fraction-digits 1;
       }
       description
         "Type used for the power values in the data nodes
          for configuration or status.";
     }
Top   ToC   RFC8561 - Page 10
     /*
      * 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.";
       }
       leaf mode {
         type identityref {
           base mw-types:rlt-mode;
         }
         mandatory true;
         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.";
       }
       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.";
       }
Top   ToC   RFC8561 - Page 11
       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.";
Top   ToC   RFC8561 - Page 12
         }
         leaf tdm-connections {
           type uint16;
           mandatory true;
           description
             "Number of connections of the specified type.";
         }
       }
     }

     /*
      * 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 {
Top   ToC   RFC8561 - Page 13
             description
               "Transmitter is on.";
           }
           enum standby {
             description
               "Transmitter is in standby.";
           }
         }
         config false;
         description
           "Shows the operative status of the transmitter.";
       }
       leaf tx-frequency {
         type uint32;
         units "kHz";
         mandatory true;
         description
           "Selected transmitter frequency.";
       }
       choice freq-or-distance {
         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.";
         }
         mandatory true;
         description
           "A choice to configure rx-frequency directly or compute
            it as duplex-distance subtracted from tx-frequency.";
       }
       leaf actual-rx-frequency {
         type uint32;
         units "kHz";
         config false;
         description
           "Computed receiver frequency.";
       }
       leaf actual-duplex-distance {
         type uint32;
         units "kHz";
         config false;
Top   ToC   RFC8561 - Page 14
         description
           "Computed distance between Tx and Rx frequencies.";
       }
       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 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 {
         container rtpc {
           description
             "Remote Transmit Power Control (RTPC).";
           reference
             "ETSI EN 302 217-1";
           leaf maximum-nominal-power {
             type power {
               range "-99..99";
             }
             units "dBm";
             mandatory true;
             description
               "Selected output power.";
Top   ToC   RFC8561 - Page 15
             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 power {
               range "-99..99";
             }
             units "dBm";
             mandatory true;
             description
               "Selected maximum output power.  Minimum output
                power is the same as the system capability,
                minimum-power.";
             reference
               "ETSI EN 302 217-1";
           }
           leaf atpc-lower-threshold {
             type 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 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";
           }
         }
Top   ToC   RFC8561 - Page 16
         mandatory true;
         description
           "A choice of RTPC or ATPC.";
       }
       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-received-level {
         type 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 {
         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";
Top   ToC   RFC8561 - Page 17
           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.";
           }
         }
         mandatory true;
         description
           "A selection of single or
            adaptive coding/modulation mode.";
       }
       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).";
       }
       leaf actual-xpi {
         if-feature "xpic";
         type decimal64 {
Top   ToC   RFC8561 - Page 18
           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 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 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).";
Top   ToC   RFC8561 - Page 19
             }
             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.";
           }
Top   ToC   RFC8561 - Page 20
           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.";
Top   ToC   RFC8561 - Page 21
         }
         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 power;
           units "dBm";
           description
             "The minimum output power supported.";
           reference
             "ETSI EN 302 217-1";
         }
         leaf maximum-available-power {
           type 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.";
         }
       }
       container error-performance-statistics {
         config false;
Top   ToC   RFC8561 - Page 22
         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.
Top   ToC   RFC8561 - Page 23
              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 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 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 power {
             range "-99..99";
           }
           units "dBm";
Top   ToC   RFC8561 - Page 24
           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 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()]"
Top   ToC   RFC8561 - Page 25
              + "/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;
Top   ToC   RFC8561 - Page 26
           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.";
         }
       }
     }
   }

   <CODE ENDS>


(next page on part 2)

Next Section