A YANG Data Model for Microwave Radio Link
draft-ietf-ccamp-mw-yang-00

CCAMP                                                        J. Ahlberg 
Internet Draft                                                 Ericsson 
Intended status: Standards Track                                  M. Ye 
                                                                 Huawei 
                                                                  X. Li 
                                                NEC Laboratories Europe 
                                                              K. Kawada 
                                                        NEC Corporation 
                                                          CJ. Bernardos 
                                                                   UC3M 
Expires: October 2017                                    April 22, 2017 
                                   
                               
          A YANG Data Model for Microwave Radio Link 

                 draft-ietf-ccamp-mw-yang-00 

Abstract 

   This document defines a YANG data model in order to 
   control and manage the radio link interfaces, and the 
   connectivity to packet (typically Ethernet) interfaces 
   in a microwave/millimeter wave node.  

Status of this Memo 

   This Internet-Draft is submitted in full conformance 
   with the provisions of BCP 78 and BCP 79. 

   Internet-Drafts are working documents of the Internet 
   Engineering Task Force (IETF). Note that other groups 
   may also distribute working documents as Internet-
   Drafts. The list of current Internet-Drafts is at 
   http://datatracker.ietf.org/drafts/current/. 

   Internet-Drafts are draft documents valid for a maximum 
   of six months and may be updated, replaced, or obsoleted 
   by other documents at any time. It is inappropriate to 
   use Internet-Drafts as reference material or to cite 
   them other than as "work in progress." 

   This Internet-Draft will expire on October 22, 2017. 

Copyright Notice 

   Copyright (c) 2016 IETF Trust and the persons identified 
   as the document authors. All rights reserved. 
 
 
 
Ahlberg, et al.     Expires October 22, 2017      [Page 1] 


Internet-Draft    Microwave YANG Model          April 2017 
    

   This document is subject to BCP 78 and the IETF Trust's 
   Legal Provisions Relating to IETF Documents 
   (http://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. Terminology and Definitions ........................2 
   2. Introduction........................................3 
   3. YANG Data Model (Tree Structure)....................3 
   4. YANG Module.........................................7 
   5. Security Considerations ...........................63 
   6. IANA Considerations ...............................63 
   7. References.........................................63 
      7.1. Normative References .........................63 
      7.2. Informative References .......................63 
    
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. 

   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 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 Transmit Power Control  
   CM   Coding Modulation 
   CT   Carrier Termination 
   RLT  Radio Link Terminal 
   RTPC Remote Transmit Power Control 
   XPIC Cross Polarization Interference Cancellation 

 
Ahlberg, et al.     Expires October 22, 2017      [Page 2] 


Internet-Draft    Microwave YANG Model          April 2017     
   MIMO Multiple-Input Multiple-Output  
   
2. 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 TDM 
   interfaces in a microwave/millimeter wave node. The date 
   model includes configuration and state data. 

   The design of the data model follows the framework for 
   management and control of microwave and millimeter wave 
   interface parameters defined in [mw-fmwk]. This 
   framework identifies the need and the scope of the YANG 
   data model, the 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 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 [I-D.ahlberg-ccamp-microwave-radio-link] and 
   it augments RFC 7223 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 RFC 
   7223 as a basis.  

   The designed YANG data model uses the IETF: Radio Link 
   Model [I-D.ahlberg-ccamp-microwave-radio-link] and the 
   ONF: Microwave Modeling [ONF-model] as the basis for the 
   definition of the detailed leafs/parameters, and 
   proposes new ones to cover identified gaps which are 
   analyzed in [mw-fmwk]. 

3. YANG Data Model (Tree Structure)  

Ahlberg, et al.     Expires October 22, 2017      [Page 3] 


Internet-Draft    Microwave YANG Model          April 2017 
module: ietf-microwave-radio-link 
    +--rw radio-link-protection-groups         
    |  +--rw radio-link-protection-group* [name] 
    |     +--rw name                             string 
    |     +--rw protection-architecture-type?    identityref 
    |     +--rw protection-operation-type?       enumeration        
    |     +--rw working-entity*                  if:interface-ref 
    |     +--rw revertive-wait-to-restore?       uint16 
    |     +--rw radio-link-protection-members*   if:interface-ref 
    |     +---x protection-external-commands 
    |        +---w input 
    |           +---w protection-external-command?  identityref 
    +--ro radio-link-protection-groups-state 
    |  +--ro radio-link-protection-group* [name] 
    |     +--ro name                 string 
    |     +--ro protection-status?   identityref 
    +--rw xpic-pairs {xpic}? 
    |  +--rw xpic-pair* [name] 
    |     +--rw name            string 
    |     +--rw enabled?        boolean 
    |     +--rw xpic-members*   if:interface-ref 
    +--rw mimo-groups {mimo}? 
       +--rw mimo-group* [name] 
          +--rw name            string 
          +--rw enabled?        boolean
          +--rw mimo-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
                                     /radio-link-protection-group/name 
    +--rw xpic-pairs*            -> /xpic-pairs/xpic-pair/name {xpic}? 
    +--rw mimo-group?            -> /mimo-groups/mimo-group/name {mimo}? 
    +--rw tdm-connections* [tdm-type] {tdm}? 
       +--rw tdm-type           identityref
       +--rw tdm-connections    unit16
  augment /if:interfaces/if:interface: 
    +--rw carrier-id?                  string 
    +--rw tx-enabled?                  boolean 
    +--rw tx-frequency                 uint32 
    +--rw rx-frequency?                uint32  
 
Ahlberg, et al.     Expires October 22, 2017      [Page 4] 


Internet-Draft    Microwave YANG Model          April 2017            

    +--rw rx-frequency-config?         boolean 
    +--rw duplex-distance              uint32 
    +--rw channel-separation           decimal64 
    +--rw polarization?                enumeration 
    +--rw power-mode                   enumeration 
    +--rw selected-output-power        power 
    +--rw atpc-lower-threshold         power 
    +--rw atpc-upper-threshold         power 
    +--rw coding-modulation-mode       enumeration 
    +--rw selected-cm                  identityref 
    +--rw selected-min-acm             identityref 
    +--rw selected-max-acm             identityref 
    +--rw if-loop?                     enumeration 
    +--rw rf-loop?                     enumeration 
    +--rw ct-performance-thresholds 
       +--rw received-level-alarm-threshold?      power 
       +--rw transmitted-level-alarm-threshold?   power 
       +--rw ber-alarm-threshold?                 enumeration 
  augment /if:interfaces-state/if:interface: 
    +--ro tx-oper-status?             enumeration 
    +--ro actual-transmitted-level?   power 
    +--ro actual-received-level?      power 
    +--ro actual-tx-cm?               identityref 
    +--ro actual-snir?                decimal64 
    +--ro actual-xpi?                 decimal64 {xpic}? 
    +--ro capabilities 
       +--ro min-tx-frequency?             uint32 
       +--ro max-tx-frequency?             uint32 
       +--ro min-rx-frequency?             uint32 
       +--ro max-rx-frequency?             uint32 
       +--ro available-min-output-power?   power 
       +--ro available-max-output-power?   power 
       +--ro available-min-acm?            identityref 
       +--ro available-max-acm?            identityref 
  augment /if:interfaces-state/if:interface/if:statistics: 
    +--ro bbe?        yang:counter32 
    +--ro es?         yang:counter32 
    +--ro ses?        yang:counter32 
    +--ro uas?        yang:counter32 
    +--ro min-rltm?   power 
    +--ro max-rltm?   power 
    +--ro min-tltm?   power 
    +--ro max-tltm?   power  
 
Ahlberg, et al.     Expires October 22, 2017      [Page 5] 


Internet-Draft    Microwave YANG Model          April 2017 

4. YANG Module 

   <CODE BEGINS> file "ietf-microwave-radio-link.yang" 

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

  import ietf-interfaces { 
    prefix if; 
  } 

  import iana-if-type { 
    prefix ianaift; 
  }
  
  organization 
    "IETF CCAMP Working Group"; 
  contact 
    "jonas.ahlberg@ericsson.com 
     amy.yemin@huawei.com 
     Xi.Li@neclab.eu 
     cjbc@it.uc3m.es 
     k-kawada@ah.jp.nec.com"; 

  description 
    "This is a module for the entities in a generic 
     microwave system.";  
  
  revision 2016-12-22 { 
    description 
      "Draft revision covering a complete scope for  
      configuration and state data for radio link  
      interfaces."; 
      
      reference ""; 
  } 
  
Ahlberg, et al.     Expires October 22, 2017      [Page 6] 


Internet-Draft    Microwave YANG Model          April 2017 

  revision 2016-10-29 { 
    description 
      "Draft revision."; 
    reference ""; 
  }
  
  /* 
  * Features 
  */ 

  feature xpic { 
    description 
      "Indicates that the device supports XPIC."; 
  } 

        
  feature mimo { 
    description 
      "Indicates that the device supports MIMO."; 
  } 

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

  /* 
  * Interface identities 
  */ 

  identity radio-link-terminal { 
    base ianaift:iana-interface-type; 
    description 
      "Interface identity for a radio link terminal."; 
  } 
  
  identity carrier-termination { 
    base ianaift:iana-interface-type; 
    description 
      "Interface identity for a carrier termination."; 
  }
  
 /* 
  * Radio-link-terminal mode identities 
  */ 
 
Ahlberg, et al.     Expires October 22, 2017      [Page 7] 


Internet-Draft    Microwave YANG Model          April 2017 
 
  identity rlt-mode { 
    description 
      "A description of the mode in which the radio  
      link terminal is configured. The format is X  
      plus Y. X represent the number of bonded  
      carrier terminations. Y represent the number  
      of protecting carrier terminations.";   
  }        

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

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

  identity two-plus-zero { 
    base rlt-mode; 
    description 
      "2 bonded carrier terminations."; 
  }
  
  /* 
  * Coding and modulation identities 
  */ 

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

  identity half-bpsk-strong { 
    base coding-modulation; 
    description 
    "Half BPSK strong coding and modulation scheme."; 
  }
         
Ahlberg, et al.     Expires October 22, 2017      [Page 8] 


Internet-Draft    Microwave YANG Model          April 2017 
    
  identity half-bpsk { 
    base coding-modulation; 
    description 
      "Half BPSK coding and modulation scheme."; 
  }

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

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

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

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

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

  identity qam-4-strong {
    base coding-modulation;
    description
      "4 QAM strong coding and modulation scheme.";
  }
        
  identity qam-4 {
    base coding-modulation;
    description
      "4 QAM coding and modulation scheme.";
  }  
Ahlberg, et al.     Expires October 22, 2017      [Page 9] 


Internet-Draft    Microwave YANG Model          April 2017 
    
  identity qam-4-light {
    base coding-modulation;
    description
      "4 QAM light coding and modulation scheme.";
  }
        
  identity qam-16-strong {
    base coding-modulation;
    description
      "16 QAM strong coding and modulation scheme.";
  }
        
  identity qam-16 {
    base coding-modulation;
    description
      "16 QAM coding and modulation scheme.";
  }
        
  identity qam-16-light {
    base coding-modulation;
    description
      "16 QAM light coding and modulation scheme.";
  }

  identity qam-32-strong {
    base coding-modulation;
    description
      "32 QAM strong coding and modulation scheme.";
  }
        
  identity qam-32 {
    base coding-modulation;
    description
      "32 QAM coding and modulation scheme.";
  }
        
  identity qam-32-light {
    base coding-modulation;
    description
      "32 QAM light coding and modulation scheme.";
  }
        
  identity qam-64-strong {
    base coding-modulation;
    description
      "64 QAM strong coding and modulation scheme.";
  }       
Ahlberg, et al.     Expires October 22, 2017     [Page 10] 


Internet-Draft    Microwave YANG Model          April 2017
    
  identity qam-64 {
    base coding-modulation;
    description
      "64 QAM coding and modulation scheme.";
  }
        
  identity qam-64-light {
    base coding-modulation;
    description
      "64 QAM light coding and modulation scheme.";
  }
        
  identity qam-128-strong {
    base coding-modulation;
    description
      "128 QAM strong coding and modulation scheme.";
  }
        
  identity qam-128 {
    base coding-modulation;
    description
      "128 QAM coding and modulation scheme.";
  }

  identity qam-128-light {
    base coding-modulation;
    description
      "128 QAM light coding and modulation scheme.";
  }
        
  identity qam-256-strong {
    base coding-modulation;
    description
      "256 QAM strong coding and modulation scheme.";
  }
        
  identity qam-256 {
    base coding-modulation;
    description
      "256 QAM coding and modulation scheme.";
  }
        
  identity qam-256-light {
    base coding-modulation;
    description
      "256 QAM light coding and modulation scheme.";
  }        
Ahlberg, et al.     Expires October 22, 2017     [Page 11] 


Internet-Draft    Microwave YANG Model          April 2017 
    
  identity qam-512-strong {
    base coding-modulation;
    description
      "512 QAM strong coding and modulation scheme.";
  }
        
  identity qam-512 {
    base coding-modulation;
    description
      "512 QAM coding and modulation scheme.";
  }
        
  identity qam-512-light {
    base coding-modulation;
    description
      "512 QAM light coding and modulation scheme.";
  }

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

Ahlberg, et al.     Expires October 22, 2017     [Page 12] 


Internet-Draft    Microwave YANG Model          April 2017 
            
  identity qam-2048-light {
    base coding-modulation;
    description
      "2048 QAM light coding and modulation scheme.";
  }
        
  identity qam-4096-strong {
    base coding-modulation;
    description
      "4096 QAM strong coding and modulation scheme.";
  }
        
  identity qam-4096 {
    base coding-modulation;
    description
      "4096 QAM coding and modulation scheme.";
  }

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

  /*
   * Protection architecture type identities
  */
  identity protection-architecture-type {
    description
      "protection architecture type";
  }

  identity one-plus-one-type {
    base protection-architecture-type;
    description
      "One carrier termination and
      one protecting carrier termination.";
  }
        
  identity one-to-n-type { 
    base protection-architecture-type; 
    description 
      "One carrier termination protecting 
       n other carrier terminations."; 
  } 
Ahlberg, et al.     Expires October 22, 2017     [Page 13] 


Internet-Draft    Microwave YANG Model          April 2017 
    
  /*
   * Protection states identities
   */
        
  identity protection-states {
    description
     "Identities describing the status of the protection,
     in a group of carrier terminations configured in 
     a radio link 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-external-commands identities
   */          

  identity protection-external-commands{
    description
      "Protection external commands for trouble shooting 
      purpose.";
  }
        
  identity manual-switch{
    base protection-external-commands;
    description
      "A switch action initiated by an operator command. 
      It switches normal traffic signal to the protection 
      transport entity.";
  }
        
Ahlberg, et al.     Expires October 22, 2017     [Page 14] 


Internet-Draft    Microwave YANG Model          April 2017 
  /* 
  * 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.";
  }
        
  /*
   * Typedefs
   */
  typedef power {
    type decimal64 {
      fraction-digits 1;
    }
    description 
      "Type used for power values, selected and measured.";
  }
                
  /* 
  * Radio Link Terminal (RLT) - Configuration data nodes 
  */        
  augment "/if:interfaces/if:interface" {
    when "if:type = 'mrl:radio-link-terminal'";
    description
      "Addition of data nodes for radio link terminal to 
       the standard Interface data model, for interfaces of
       the type 'radio-link-terminal'.";

Ahlberg, et al.     Expires October 22, 2017     [Page 15] 


Internet-Draft    Microwave YANG Model          April 2017 
    
    leaf id {
      type string;
      default ""; 
      description
        "ID of the radio link terminal. Used by far-end when
         checking that it's connected to the correct RLT.";
    } 
        
    leaf mode {
      type identityref {
        base 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 represent the number of bonded carrier terminations.
         Y represent the number of protecting carrier 
         terminations.";
    }
        
    leaf-list carrier-terminations {
      type if:interface-ref;
      must "/if:interfaces/if:interface[if:name = current()]"
         + "/if:type = 'mrl:carrier-termination'" {
        description        
          "The type of interface must be 
           'carrier-termination'.";
      }
      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:radio-link-protection-group/mrl:name";
      }
      description
        "A list of references to the carrier termination
         groups configured for radio link protection in this 
         radio link terminal.";
    }
 
Ahlberg, et al.     Expires October 22, 2017     [Page 16] 


Internet-Draft    Microwave YANG Model          April 2017 

    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.";
    }
        
    leaf mimo-group {
      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.";
    }
        
    list tdm-connections {
      if-feature tdm;
      key "tdm-type";
      description 
       "A list stating the number of TDM connections of a 
       specified tdm-type that is supported by the RLT.";  
      leaf tdm-type {
        type identityref {
          base 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.";
      }
    }
  }
 
Ahlberg, et al.     Expires October 22, 2017     [Page 17] 


Internet-Draft    Microwave YANG Model          April 2017   

  /*
   * Carrier Termination - Configuration data nodes
   */
     
  augment "/if:interfaces/if:interface" {
    when "if:type = 'mrl:carrier-termination'";
    description 
      "Addition of data nodes for carrier termination to  
      the standard Interface data model, for interfaces  
      of the type 'carrier-termination'."; 
    leaf carrier-id {
      type string;
      default "A";
      description
        "ID of the carrier. (e.g. A, B, C or D)
         Used in XPIC & 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.
         Defaulted when not MIMO or XPIC.";
    }
        
    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-frequency {
      type uint32;
      units "kHz";
      mandatory true;
      description
        "Selected transmitter frequency.";
    }

Ahlberg, et al.     Expires October 22, 2017     [Page 18] 


Internet-Draft    Microwave YANG Model          April 2017 
    
    leaf rx-frequency {
      type uint32;
      units "kHz";
      description
        "Selected receiver frequency.
         Mandatory and writeable when rx-frequency-config=true.
         Otherwise read-only and calculated from tx-frequency 
         and duplex-distance.";
    }
        
    leaf rx-frequency-config {
      type boolean;
      default "true";
      description 
        "Enable (true) or disable (false) direct  
         configuration of rx-frequency and instead  
         using a defined duplex distance."; 
    }  

    leaf duplex-distance {
      when "../rx-frequency-config = 'false'";
      type uint32;
      units "kHz";
      mandatory true;
      description
        "Distance between Tx & Rx frequencies.
         Used to calaculate rx-frequency when 
         rx-frequency-config=false.";
    }
        
    leaf channel-separation {
      type decimal64 {
        fraction-digits 1;
      }
      units "MHz";
      mandatory true;
      description
        "The amount of bandwidth allocated to a carrier.";
    }   
        
    leaf polarization {
      type enumeration {
        enum "horizontal" {
          description "Horizontal polarization.";
        }
Ahlberg, et al.     Expires October 22, 2017     [Page 19] 


Internet-Draft    Microwave YANG Model          April 2017 
        enum "vertical" {
          description "Vertical polarization.";
        }
        enum "not-specified" {
          description "Polarization not specified.";
        }
      }
      default "not-specified";
      description
        "Polarization - A textual description for info only.";
    }
        
    leaf power-mode {
      type enumeration {    
        enum rtpc {
          description "Remote Transmit Power Control (RTPC).";
        }
        enum atpc {
          description "Automatic Transmit Power Contro 
                       (ATPC).";
        }
      }
      mandatory true;
      description
        "A choice of Remote Transmit Power Control (RTPC)
         or Automatic Transmit Power Control (ATPC).";
    }
        
    leaf selected-output-power {
      type power {
        range "-99..40";
      }
      units "dBm";
      mandatory true;
      description
        "Selected output power in RTPC mode and selected 
        maximum selected maximum output power in ATPC mode. 
        Minimum ouput power in ATPC mode is the same as the
        system capability, available-min-output-power."; 
    } 

    leaf atpc-lower-threshold {
      when "../power-mode = 'atpc'";
      type power {
        range "-99..-30";
      }
      units "dBm";
Ahlberg, et al.     Expires October 22, 2017     [Page 20] 


Internet-Draft    Microwave YANG Model          April 2017 
      mandatory true;
      description
        "The lower threshold for the input power at far-end used in
        the ATPC mode.";
    }
        
    leaf atpc-upper-threshold {
      when "../power-mode = 'atpc'";
      type power {
        range "-99..-30";
      }
      units "dBm";
      mandatory true;
      description
        "The upper threshold for the input power  
         at far-end used in the ATPC mode."; 
    }      

    leaf coding-modulation-mode {
      type enumeration {
        enum fixed {
          description "Fixed coding/modulation."; 
        }
        enum adaptive {
          description "Adaptive coding/modulation.";
        }
      }
      mandatory true;
      description
        "A selection of fixed or 
         adaptive coding/modulation mode.";
    }
        
    leaf selected-cm {
      when "../coding-modulation-mode = 'fixed'";
      type identityref {
        base coding-modulation;        
      }
      mandatory true;
      description
        "Selected fixed coding/modulation.";
    }
 
Ahlberg, et al.     Expires October 22, 2017     [Page 21] 


Internet-Draft    Microwave YANG Model          April 2017 
    leaf selected-min-acm {
      when "../coding-modulation-mode = 'adaptive'";
      type identityref {
        base coding-modulation;
      }
      mandatory true;
      description
        "Selected minimum coding/modulation.
         Adaptive coding/modulation shall not go
         below this value.";
    }

    leaf selected-max-acm {
      when "../coding-modulation-mode = 'adaptive'";
      type identityref {
        base coding-modulation;
      }    
      mandatory true;
      description
        "Selected maximum coding/modulation.
         Adaptive coding/modulation shall not go
         above this value.";
    }
         
    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."; 
    } 

Ahlberg, et al.     Expires October 22, 2017     [Page 22] 


Internet-Draft    Microwave YANG Model          April 2017 
    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 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..-30";
        }
        units "dBm";
        default "-99";
        description
          "Specification of at which received power level an alarm
          should be raised.";
      }
         
      leaf transmitted-level-alarm-threshold {
        type power {
          range "-99..40";
        }
        units "dBm";
        default "-99";
        description 
          "An alarm is sent when the transmitted power level 
           is below the specified threshold."; 
      } 

Ahlberg, et al.     Expires October 22, 2017     [Page 23] 


Internet-Draft    Microwave YANG Model          April 2017 
      leaf ber-alarm-threshold {
        type enumeration {
          enum "10e-9" {
            description "Threshold at 10e-9.";
          }
          enum "10e-8" {
            description "Threshold at 10e-8.";
          }
          enum "10e-7" {
            description "Threshold at 10e-7.";
          }
          enum "10e-6" {
            description "Threshold at 10e-6.";
          }
          enum "10e-5" {
            description "Threshold at 10e-5.";
          }
          enum "10e-4" {
            description "Threshold at 10e-4.";
          }     
          enum "10e-3" {
            description "Threshold at 10e-3.";
          }
          enum "10e-2" {
            description "Threshold at 10e-2.";
          }
          enum "10e-1" {
            description "Threshold at 10e-1.";
          }
        }
        default "10e-6";
        description
          "Specification of at which BER an alarm should 
           be raised.";
      }
    }
  }
         
  /*
   * Radio Link Terminal - Operational state data nodes
   * Currently nothing in addition to the general
   * interface-state model.
   */
   
  /*
   * Carrier Termination - Operational state data nodes
   */
   
Ahlberg, et al.     Expires October 22, 2017     [Page 24] 


Internet-Draft    Microwave YANG Model          April 2017  
  augment "/if:interfaces-state/if:interface" {
    when "if:type = 'mrl:carrier-termination'";
    description
      "Addition of state data nodes for carrier termination to 
       the standard Interface state data model, for interfaces 
       of the type 'carrier-termination'.";
         
    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.";
        }
      }
      description
        "Shows the operative status of the transmitter.";
    }    

    leaf actual-transmitted-level { 
        type power { 
          range "-99..40"; 
        } 
      units "dBm";
      description
        "Actual transmitted power level (0.1 dBm resolution).";
    }
         
    leaf actual-received-level {
      type power {
        range "-99..-20";
      }
      units "dBm";
      description
        "Actual received power level (0.1 dBm resolution).";
    } 
        
    leaf actual-tx-cm {
      type identityref {
         base coding-modulation;
      }
      description
        "Actual coding/modulation in transmitting direction.";
    }
Ahlberg, et al.     Expires October 22, 2017     [Page 25] 


Internet-Draft    Microwave YANG Model          April 2017           
         
    leaf actual-snir {
      type decimal64 {
        fraction-digits 1;
        range "0..99";
      }
      units "dB";
      description
        "Actual signal to noise plus interference ratio.
         (0.1 dB resolution).";
    }
         
    leaf actual-xpi {
      if-feature xpic;
      type decimal64 {
        fraction-digits 1; 
        range "0..99";
      }
      units "dB";
      description
        "The actual carrier to cross-polar interference.
         Only valid if XPIC is enabled. (0.1 dB resolution).";
    }
         
    container capabilities {
      description
        "Capabilities of the 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."; 
      }

Ahlberg, et al.     Expires October 22, 2017     [Page 26] 


Internet-Draft    Microwave YANG Model          April 2017 
      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 available-min-output-power {
        type power; 
        units "dBm";
        description
          "The minimum output power supported.";
      }    

      leaf available-max-output-power {
        type power;
        units "dBm";
        description
          "The maximum output power supported.";
      }
         
      leaf available-min-acm {
        type identityref {
          base coding-modulation;
        }
        description
          "Minimum coding-modulation possible to use.";
      }
         
      leaf available-max-acm {
        type identityref {
          base coding-modulation;
        }
        description
          "Maximum coding-modulation possible to use.";
      }
    }
  } 

Ahlberg, et al.     Expires October 22, 2017     [Page 27] 


Internet-Draft    Microwave YANG Model          April 2017 
  augment "/if:interfaces-state/if:interface/if:statistics" {
    when "../if:type = 'mrl:carrier-termination'";
    description
      "Addition of state data nodes in the container statistics
       for carrier terminations to the standard Interface data 
       model, for interfaces of the type 'carrier-termination'.";
         
    leaf bbe {
      type yang:counter32;
      units "number of block errors";
      description
        "Number of Background Block Errors (BBE) during the
        interval. A BBE is an errored block not occurring as
        part of an SES.";
    }
         
    leaf es {
      type yang:counter32;
      units "seconds";
      description    
      "Number of Errored Seconds (ES) since last  
       reset. An ES is a one-second period with  
       one or more errored blocks or at least one  
       defect."; 
      } 
         
    leaf ses {
      type yang:counter32;
      units "seconds";
      description
        "Number of Severely Errored Seconds (SES) during the
         interval. SES is a one-second period which contains
         equal or more than 30% errored blocks or at least
         one defect. SES is a subset of ES.";
    }
         
    leaf uas {
      type yang:counter32;
      units "seconds";
      description
        "Number of Unavailable Seconds (UAS), that is, the
         total time that the node has been unavailable during
         a fixed measurement interval.";
    }

Ahlberg, et al.     Expires October 22, 2017     [Page 28] 


Internet-Draft    Microwave YANG Model          April 2017 
    leaf min-rltm {
      type power {
        range "-99..-20";
      }
      units "dBm";
      description
        "Minimum received power level since last reset.";
    }
         
    leaf max-rltm {
      type power {
        range "-99..-20";
      }
      units "dBm";
      description
        "Maximum received power level since last reset.";
    }
         
    leaf min-tltm {
      type power {
        range "-99..40";    
      }
      units "dBm";
      description
        "Minimum transmitted power level since last reset.";
    }
         
    leaf max-tltm {
      type power {
        range "-99..40";
      }
      units "dBm";
      description
        "Maximum transmitted power level since last reset.";
    }
  }
         
  /*
   * Radio Link Protection Groups - Configuration data nodes
   */

  container radio-link-protection-groups {
    description
      "Configuration of radio link protected groups  
      (1+1) of carrier terminations in a radio link.  
      More than one protected group per radio-link-terminal
      is allowed."; 

Ahlberg, et al.     Expires October 22, 2017     [Page 29] 


Internet-Draft    Microwave YANG Model          April 2017 
    list radio-link-protection-group {
      key "name";
      description
      "List of protected groups of carrier terminations
      in a radio link.";
             
      leaf name {
        type string;
        description
          "Name used for identification of the radio
           link protection group";
      }
         
      leaf protection-architecture-type { 
        type identityref{ 
          base protection-architecture-type; 
        } 
        default "one-plus-one-type"; 
        description 
          "The type of protection architecture  
          used, e.g. one carrier termination  
          protecting one carrier termination."; 
      }   
          
      leaf protection-operation-type { 
        type enumeration { 
          enum "non-revertive" { 
            description 
              "In non revertive operation, the  
              traffic does not return to the  
              working carrier termination if the  
              switch requests are terminated. "; 
              } 
          enum "revertive" { 
            description 
              "In revertive operation, the  
              traffic always returns to (or  
              remains on) the working carrier  
              termination if the switch requests  
              are terminated. "; 
            } 
          } 
          default "non-revertive"; 
          description  
            "The type of protection operation, i.e.  
            revertive or non-revertive operation."; 
          } 

Ahlberg, et al.     Expires October 22, 2017     [Page 30] 


Internet-Draft    Microwave YANG Model          April 2017 
      leaf-list working-entity  { 
        when "../protection-operation-type =  'revertive'"; 
        type if:interface-ref; 
        must "/if:interfaces/if:interface[if:name = current()]" 
           + "/if:type = 'mrl:carrier-termination'" { 
           description 
             "The type of a working-entity must be  
             'carrier-termination'."; 
           } 
           min-elements 1; 
           description 
           "The carrier terminations over which the  
           traffic normally should be transported  
           over when there is no need to use the  
           protecting carrier termination."; 
        } 
                                
      leaf revertive-wait-to-restore { 
        when "../protection-operation-type = 'revertive'"; 
        type uint16; 
        units "seconds"; 
        default "0"; 
        description 
          "The time to wait before switching back  
          to the working carrier termination if  
          protection-operation-type is revertive."; 
        } 
                                
      leaf-list radio-link-protection-members { 
        type if:interface-ref; 
        must "/if:interfaces/if:interface[if:name = current()]" 
          + "/if:type = 'mrl:carrier-termination'" { 
          description 
            "The type of a protection member must  
            be 'carrier-termination'."; 
          } 
          min-elements 2; 
          description 
            "Association to a group of carrier  
            terminations configured for radio link  
            protection and used in the radio link terminal."; 
        } 

Ahlberg, et al.     Expires October 22, 2017     [Page 31] 


Internet-Draft    Microwave YANG Model          April 2017 
      action protection-external-commands { 
        input { 
          leaf protection-external-command { 
            type identityref { 
              base protection-external-commands; 
            }
            description 
              "Execution of protection external
               commands for trouble shooting purpose.";    
          } 
        } 
      } 
    } 
} 
         
  /* 
  * Radio Link Protection - Operational state data nodes 
  */         
  container radio-link-protection-groups-state {     
    config false; 
    description 
      "State data for radio link protected groups  
      of carrier terminations in a radio link.";    
      list radio-link-protection-group { 
        key "name"; 
        description 
          "List of protected groups of carrier  
          terminations in a radio link."; 
         
      leaf name { 
        type string; 
        description 
          "Name used for identification of the  
           radio link protection group."; 
      } 
         
      leaf protection-status { 
        type identityref { 
          base protection-states; 
        } 
        description 
          "Status of the protection, in a group of  
          carrier terminations configured in a  
          radio link protection mode."; 
        } 
    } 
  }  

Ahlberg, et al.     Expires October 22, 2017     [Page 32] 


Internet-Draft    Microwave YANG Model          April 2017 
  /* 
  * XPIC & MIMO - Configuration data nodes 
  */ 

  container xpic-pairs { 
    if-feature xpic; 
      description 
        "Configuration of carrier termination pairs 
        for operation in XPIC mode."; 
         
    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 xpic-members { 
        type if:interface-ref; 
        must "/if:interfaces/if:interface[if:name = current()]" 
          + "/if:type = 'mrl:carrier-termination'" { 
          description 
            "The type of a xpic-member must be  
            'carrier-termination'."; 
          } 
          min-elements 2; 
          max-elements 2; 
          description 
            "Association to XPIC pairs used in the  
            radio link terminal."; 
           } 
         } 
  }

Ahlberg, et al.     Expires October 22, 2017     [Page 33] 


Internet-Draft    Microwave YANG Model          April 2017 
  container mimo-groups { 
    if-feature mimo; 
    description 
      "Configuration of carrier terminations 
      for operation in MIMO mode."; 
         
      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 mimo-members { 
        type if:interface-ref; 
        must "/if:interfaces/if:interface[if:name = current()]" 
           + "/if:type = 'mrl:carrier-termination'" { 
           description 
             "The type of a mimo-member must be  
             'carrier-termination'."; 
           } 
           min-elements 2; 
           description 
             "Association to a MIMO group if used in  
             the radio link terminal."; 

        } 
      } 
    }         
} 
<CODE ENDS> 

Ahlberg, et al.     Expires October 22, 2017     [Page 34] 


Internet-Draft    Microwave YANG Model          April 2017     

5. Security Considerations 

   The YANG module defined in this memo is designed to be 
   accessed via the NETCONF protocol [RFC6241].  The lowest 
   NETCONF layer is the secure transport layer and the 
   mandatory-to-implement secure transport is SSH 
   [RFC6242].  The NETCONF access control model [RFC6536] 
   provides the means to restrict access for particular 
   NETCONF users to a pre-configured subset of all 
   available NETCONF protocol operations and content. 

   There are a number of data nodes defined in the YANG 
   module which 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. 

   The security considerations of [RFC7223] also apply to 
   this document. 

6. IANA Considerations 

   TBD. 
   
7. References 

7.1. Normative References 

   [RFC7223] Bjorklund M., "A YANG Data Model for Interface 
            Management", RFC 7223, DOI 10.17487/RFC7223, 
            May 2014, <http://www.rfc-
            editor.org/info/rfc7223>. 

7.2. Informative References 

   [draft-ietf-ccamp-microwave-framework-00]  
            Ahlberg J., et al., " A framework for 
            Management and Control of microwave and 
            millimeter wave interface parameters ", draft-
            ietf-ccamp-microwave-framework-00 (work in 
            progress), December 2016.  
 
Ahlberg, et al.     Expires October 22, 2017     [Page 35] 


Internet-Draft    Microwave YANG Model          April 2017 
   [I-D.ahlberg-ccamp-microwave-radio-link]  
            Ahlberg J., Carlson J., Lund H., Olausson T., 
            Ye M., and Vaupotic M., "Microwave Radio Link 
            YANG Data Models", draft-ahlberg-ccamp-
            microwave-radio-link-01 (work in progress), 
            May 2016. 

   [ONF-model]  
            "Microwave Modeling - ONF Wireless Transport 
            Group", May 2016. 

   [RFC6241] Enns, R., Bjorklund, M., Schoenwaelder, J., 
            and A.Bierman, "Network Configuration Protocol 
            (NETCONF)",RFC 6241, June 2011. 

   [RFC6242] Wasserman, M., "Using the NETCONF Protocol 
            over SecureShell (SSH)", RFC 6242, June 2011. 

   [RFC6536] Bierman, A. and M. Bjorklund, "Network 
            ConfigurationProtocol (NETCONF) Access Control 
            Model", RFC 6536,March 2012. 
    

 
Ahlberg, et al.     Expires October 22, 2017     [Page 36] 


Internet-Draft    Microwave YANG Model          April 2017

Authors' Addresses 

   Jonas Ahlberg 
   Ericsson AB 
   Lindholmspiren 11 
   Goeteborg 417 56 
   Sweden 
    
   Email: jonas.ahlberg@ericsson.com 
 

   Ye Min 
   Huawei Technologies Co., Ltd. 
   No.1899, Xiyuan Avenue 
   Chengdu 611731  
   P.R.China 
    
   Email: amy.yemin@huawei.com 
 

   Xi Li 
   NEC Laboratories Europe 
   Kurfursten-Anlage 36 
   69115 Heidelberg 
   Germany 
    
   Email: Xi.Li@neclab.eu 
    

   Koji Kawada 
   NEC Corporation 
   1753, Shimonumabe Nakahara-ku 
   Kawasaki, Kanagawa 211-8666 
   Japan 
    
   Email: k-kawada@ah.jp.nec.com 
    

   Carlos J. Bernardos 
   Universidad Carlos III de Madrid 
   Av. Universidad, 30 
   Leganes, Madrid  28911 
   Spain 
    
   Email: cjbc@it.uc3m.es 
     
 

         

 

Ahlberg, et al.     Expires October 22, 2017     [Page 36]