idnits 2.17.1 draft-ietf-ccamp-mw-yang-11.txt: Checking boilerplate required by RFC 5378 and the IETF Trust (see https://trustee.ietf.org/license-info): ---------------------------------------------------------------------------- No issues found here. Checking nits according to https://www.ietf.org/id-info/1id-guidelines.txt: ---------------------------------------------------------------------------- No issues found here. Checking nits according to https://www.ietf.org/id-info/checklist : ---------------------------------------------------------------------------- No issues found here. Miscellaneous warnings: ---------------------------------------------------------------------------- == The copyright year in the IETF Trust and authors Copyright Line does not match the current year == The document doesn't use any RFC 2119 keywords, yet seems to have RFC 2119 boilerplate text. -- The document date (November 06, 2018) is 1970 days in the past. Is this intentional? Checking references for intended status: Proposed Standard ---------------------------------------------------------------------------- (See RFCs 3967 and 4897 for information about using normative references to lower-maturity documents in RFCs) No issues found here. Summary: 0 errors (**), 0 flaws (~~), 2 warnings (==), 1 comment (--). Run idnits with the --verbose option for more detailed information about the items above. -------------------------------------------------------------------------------- 2 CCAMP Working Group J. Ahlberg 3 Internet-Draft Ericsson AB 4 Intended status: Standards Track M. Ye 5 Expires: May 10, 2019 Huawei Technologies 6 X. Li 7 NEC Laboratories Europe 8 D. Spreafico 9 Nokia - IT 10 M. Vaupotic 11 Aviat Networks 12 November 06, 2018 14 A YANG Data Model for Microwave Radio Link 15 draft-ietf-ccamp-mw-yang-11 17 Abstract 19 This document defines a YANG data model for control and management of 20 the radio link interfaces, and their connectivity to packet 21 (typically Ethernet) interfaces in a microwave/millimeter wave node. 22 The data nodes for management of the interface protection 23 functionality is broken out into a separate and generic YANG data 24 model in order to make it available also for other interface types. 26 RFC Ed. Note 28 // RFC Ed.: replace all XXXX throughout the document with actual RFC 29 numbers and remove this note 31 Status of This Memo 33 This Internet-Draft is submitted in full conformance with the 34 provisions of BCP 78 and BCP 79. 36 Internet-Drafts are working documents of the Internet Engineering 37 Task Force (IETF). Note that other groups may also distribute 38 working documents as Internet-Drafts. The list of current Internet- 39 Drafts is at https://datatracker.ietf.org/drafts/current/. 41 Internet-Drafts are draft documents valid for a maximum of six months 42 and may be updated, replaced, or obsoleted by other documents at any 43 time. It is inappropriate to use Internet-Drafts as reference 44 material or to cite them other than as "work in progress." 46 This Internet-Draft will expire on May 10, 2019. 48 Copyright Notice 50 Copyright (c) 2018 IETF Trust and the persons identified as the 51 document authors. All rights reserved. 53 This document is subject to BCP 78 and the IETF Trust's Legal 54 Provisions Relating to IETF Documents 55 (https://trustee.ietf.org/license-info) in effect on the date of 56 publication of this document. Please review these documents 57 carefully, as they describe your rights and restrictions with respect 58 to this document. Code Components extracted from this document must 59 include Simplified BSD License text as described in Section 4.e of 60 the Trust Legal Provisions and are provided without warranty as 61 described in the Simplified BSD License. 63 Table of Contents 65 1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . 2 66 1.1. Terminology and Definitions . . . . . . . . . . . . . . . 3 67 1.2. Tree Structure . . . . . . . . . . . . . . . . . . . . . 4 68 2. Requirements Language . . . . . . . . . . . . . . . . . . . . 4 69 3. Microwave Radio Link YANG Data Model . . . . . . . . . . . . 5 70 3.1. YANG Tree . . . . . . . . . . . . . . . . . . . . . . . . 5 71 3.2. Explanation of the Microwave Data Model . . . . . . . . . 7 72 4. Microwave Radio Link YANG Module . . . . . . . . . . . . . . 7 73 5. Interface Protection YANG Module . . . . . . . . . . . . . . 27 74 6. Microwave Types YANG Module . . . . . . . . . . . . . . . . . 33 75 7. Security Considerations . . . . . . . . . . . . . . . . . . . 40 76 8. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 42 77 9. References . . . . . . . . . . . . . . . . . . . . . . . . . 43 78 9.1. Normative References . . . . . . . . . . . . . . . . . . 43 79 9.2. Informative References . . . . . . . . . . . . . . . . . 44 80 Appendix A. Example: 1+0 and 2+0 configuration instances . . . . 46 81 A.1. 1+0 instance . . . . . . . . . . . . . . . . . . . . . . 46 82 A.2. 2+0 instance . . . . . . . . . . . . . . . . . . . . . . 47 83 A.3. 2+0 XPIC instance . . . . . . . . . . . . . . . . . . . . 49 84 Appendix B. Contributors . . . . . . . . . . . . . . . . . . . . 50 85 Authors' Addresses . . . . . . . . . . . . . . . . . . . . . . . 51 87 1. Introduction 89 This document defines a YANG data model for management and control of 90 the radio link interface(s) and the relationship to packet (typically 91 Ethernet) and/or TDM interfaces in a microwave/millimeter wave node. 92 ETSI EN 302 217 series defines the characteristics and requirements 93 of microwave/millimeter wave equipment and antennas. Especially ETSI 94 EN 302 217-2 [EN302217-2] specifies the essential parameters for the 95 systems operating from 1.4GHz to 86GHz. The data model includes 96 configuration and state data according to the new Network Management 97 Datastore Architecture [RFC8342]. 99 The design of the data model follows the framework for management and 100 control of microwave and millimeter wave interface parameters defined 101 in [RFC8432]. This framework identifies the need and the scope of 102 the YANG data model, the use cases and requirements that the model 103 needs to support. Moreover, it provides a detailed gap analysis to 104 identify the missing parameters and functionalities of the existing 105 and established models to support the specified use cases and 106 requirements, and based on that recommends how the gaps should be 107 filled with the development of the new model. According to the 108 conclusion of the gap analysis, the structure of the data model is 109 based on the structure defined in 110 [I-D.ahlberg-ccamp-microwave-radio-link] and it augments [RFC8343] to 111 align with the same structure for management of the packet 112 interfaces. More specifically, the model will include interface 113 layering to manage the capacity provided by a radio link terminal for 114 the associated Ethernet and TDM interfaces, using the principles for 115 interface layering described in [RFC8343] as a basis. 117 The data nodes for management of the interface protection 118 functionality is broken out into a separate and generic YANG data 119 module in order to make it available also for other interface types. 121 The designed YANG data model uses established microwave equipment and 122 radio standards, such as ETSI EN 302 217-2, and the IETF: Radio Link 123 Model [I-D.ahlberg-ccamp-microwave-radio-link] and the ONF: Microwave 124 Modeling [ONF-model] as the basis for the definition of the detailed 125 leafs/parameters, and proposes new ones to cover identified gaps 126 which are analyzed in [RFC8432]. 128 1.1. Terminology and Definitions 130 The following terms are used in this document: 132 Carrier Termination (CT) is an interface for the capacity provided 133 over the air by a single carrier. It is typically defined by its 134 transmitting and receiving frequencies. 136 Radio Link Terminal (RLT) is an interface providing packet capacity 137 and/or TDM capacity to the associated Ethernet and/or TDM interfaces 138 in a node and used for setting up a transport service over a 139 microwave/millimeter wave link. 141 The following acronyms are used in this document: 143 ACM Adaptive Coding Modulation 144 ATPC Automatic Transmit Power Control 146 BBE Background Block Errors 148 BER Bit Error Ratio 150 BPSK Binary Phase-Shift Keying 152 CM Coding Modulation 154 CT Carrier Termination 156 ES Errored Seconds 158 IF Intermediate Frequency 160 MIMO Multiple-Input Multiple-Output 162 RF Radio Frequency 164 RLT Radio Link Terminal 166 QAM Quadrature Amplitude Modulation 168 QPSK Quadrature Phase-Shift Keying 170 RTPC Remote Transmit Power Control 172 SES Severely Errored Seconds 174 TDM Time-Division Multiplexing 176 UAS Unavailable Seconds 178 XPIC Cross Polarization Interference Cancellation 180 1.2. Tree Structure 182 A simplified graphical representation of the data model is used in 183 chapter 3.1 of this this document. The meaning of the symbols in 184 these diagrams is defined in [RFC8340]. 186 2. Requirements Language 188 The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", 189 "SHOULD", "SHOULD NOT", "RECOMMENDED", "NOT RECOMMENDED", "MAY", and 190 "OPTIONAL" in this document are to be interpreted as described in BCP 191 14 [RFC2119] [RFC8174] when, and only when, they appear in all 192 capitals, as shown here. 194 3. Microwave Radio Link YANG Data Model 196 3.1. YANG Tree 198 module: ietf-microwave-radio-link 199 +--rw radio-link-protection-groups 200 | +--rw protection-group* [name] 201 | +--rw name string 202 | +--rw protection-architecture-type? identityref 203 | +--rw members* if:interface-ref 204 | +--rw operation-type? enumeration 205 | +--rw working-entity* if:interface-ref 206 | +--rw revertive-wait-to-restore? uint16 207 | +--rw hold-off-timer? uint16 208 | +--ro status? identityref 209 | +---x manual-switch-working 210 | +---x manual-switch-protection 211 | +---x forced-switch 212 | +---x lockout-of-protection 213 | +---x freeze 214 | +---x exercise 215 | +---x clear 216 +--rw xpic-pairs {xpic}? 217 | +--rw xpic-pair* [name] 218 | +--rw name string 219 | +--rw enabled? boolean 220 | +--rw members* if:interface-ref 221 +--rw mimo-groups {mimo}? 222 +--rw mimo-group* [name] 223 +--rw name string 224 +--rw enabled? boolean 225 +--rw members* if:interface-ref 226 augment /if:interfaces/if:interface: 227 +--rw id? string 228 +--rw mode identityref 229 +--rw carrier-terminations* if:interface-ref 230 +--rw rlp-groups* 231 | -> /radio-link-protection-groups/protection-group/name 232 +--rw xpic-pairs* -> /xpic-pairs/xpic-pair/name 233 | {xpic}? 234 +--rw mimo-groups* -> /mimo-groups/mimo-group/name 235 | {mimo}? 236 +--rw tdm-connections* [tdm-type] {tdm}? 237 +--rw tdm-type identityref 238 +--rw tdm-connections uint16 239 augment /if:interfaces/if:interface: 240 +--rw carrier-id? string 241 +--rw tx-enabled? boolean 242 +--ro tx-oper-status? enumeration 243 +--rw tx-frequency uint32 244 +--rw (freq-or-distance) 245 | +--:(rx-frequency) 246 | | +--rw rx-frequency? uint32 247 | +--:(duplex-distance) 248 | +--rw duplex-distance? int32 249 +--ro actual-rx-frequency? uint32 250 +--ro actual-duplex-distance? uint32 251 +--rw channel-separation uint32 252 +--rw polarization? enumeration 253 +--rw (power-mode) 254 | +--:(rtpc) 255 | | +--rw rtpc 256 | | +--rw maximum-nominal-power power 257 | +--:(atpc) 258 | +--rw atpc 259 | +--rw maximum-nominal-power power 260 | +--rw atpc-lower-threshold power 261 | +--rw atpc-upper-threshold power 262 +--ro actual-transmitted-level? power 263 +--ro actual-received-level? power 264 +--rw (coding-modulation-mode) 265 | +--:(single) 266 | | +--rw single 267 | | +--rw selected-cm identityref 268 | +--:(adaptive) 269 | +--rw adaptive 270 | +--rw selected-min-acm identityref 271 | +--rw selected-max-acm identityref 272 +--ro actual-tx-cm? identityref 273 +--ro actual-snir? decimal64 274 +--ro actual-xpi? decimal64 {xpic}? 275 +--rw ct-performance-thresholds 276 | +--rw received-level-alarm-threshold? power 277 | +--rw transmitted-level-alarm-threshold? power 278 | +--rw ber-alarm-threshold? enumeration 279 +--rw if-loop? enumeration 280 +--rw rf-loop? enumeration 281 +--ro capabilities 282 | +--ro min-tx-frequency? uint32 283 | +--ro max-tx-frequency? uint32 284 | +--ro min-rx-frequency? uint32 285 | +--ro max-rx-frequency? uint32 286 | +--ro minimum-power? power 287 | +--ro maximum-available-power? power 288 | +--ro available-min-acm? identityref 289 | +--ro available-max-acm? identityref 290 +--ro error-performance-statistics 291 | +--ro bbe? yang:counter32 292 | +--ro es? yang:counter32 293 | +--ro ses? yang:counter32 294 | +--ro uas? yang:counter32 295 +--ro radio-performance-statistics 296 +--ro min-rltm? power 297 +--ro max-rltm? power 298 +--ro min-tltm? power 299 +--ro max-tltm? power 301 3.2. Explanation of the Microwave Data Model 303 The leafs in the Interface Management Module augmented by Radio Link 304 Terminal (RLT) and Carrier Termination (CT) are not always 305 applicable. 307 "/interfaces/interface/enabled" is not applicable for RLT. Enable 308 and disable of an interface is done in the constituent CTs. 310 The packet related measurements "in-octets", "in-unicast-pkts", "in- 311 broadcast-pkts", "in-multicast-pkts", "in-discards", "in-errors", 312 "in-unknown-protos", "out-octets", "out-unicast-pkts", "out- 313 broadcast-pkts", "out-multicast-pkts", "out-discards", "out-errors" 314 are not within the scope of the microwave radio link domain and 315 therefore not applicable for RLT and CT. 317 4. Microwave Radio Link YANG Module 319 This module imports typedefs and modules from [RFC6991], [RFC8343] 320 and [RFC7224], and it references [TR102311], [EN302217-1], 321 [EN301129], and [G.826]. 323 file "ietf-microwave-radio-link@2018-11-06.yang" 325 module ietf-microwave-radio-link { 326 yang-version 1.1; 327 namespace "urn:ietf:params:xml:ns:yang:ietf-microwave-radio-link"; 328 prefix mrl; 330 import ietf-yang-types { 331 prefix yang; 332 reference "RFC 6991"; 333 } 335 import ietf-interfaces { 336 prefix if; 337 reference "RFC 8343"; 338 } 340 import ietf-interface-protection { 341 prefix ifprot; 342 reference "RFC XXXX"; 343 } 345 import ietf-microwave-types { 346 prefix mw-types; 347 reference "RFC XXXX"; 348 } 350 organization 351 "Internet Engineering Task Force (IETF) CCAMP WG"; 353 contact 354 "WG List: 356 ID-draft editors: 357 // RFC Ed.: replace ID-draft editors with Editors and remove 358 // this note 359 Jonas Ahlberg (jonas.ahlberg@ericsson.com); 360 Min Ye (amy.yemin@huawei.com); 361 Xi Li (Xi.Li@neclab.eu); 362 Daniela Spreafico (daniela.spreafico@nokia.com) 363 Marko Vaupotic (Marko.Vaupotic@aviatnet.com)"; 365 description 366 "This is a module for the entities in 367 a generic microwave system. 369 Copyright (c) 2018 IETF Trust and the persons identified as 370 authors of the code. All rights reserved. 371 Redistribution and use in source and binary forms, with or 372 without modification, is permitted pursuant to, and subject 373 to the license terms contained in, the Simplified BSD License 374 set forth in Section 4.c of the IETF Trust's Legal Provisions 375 Relating to IETF Documents 376 (http://trustee.ietf.org/license-info). 378 This version of this YANG module is part of RFC XXXX; see 379 the RFC itself for full legal notices. 381 Copyright (c) 2018 IETF Trust and the persons identified as 382 authors of the code. All rights reserved."; 384 revision 2018-11-06 { 385 description "Initial revision."; 386 reference "RFC XXXX: A YANG Data Model for Microwave Radio Link"; 387 } 389 /* 390 * Features 391 */ 393 feature xpic { 394 description 395 "Indicates that the device supports XPIC."; 396 reference "ETSI TR 102 311"; 397 } 399 feature mimo { 400 description 401 "Indicates that the device supports MIMO."; 402 reference "ETSI TR 102 311"; 403 } 405 feature tdm { 406 description 407 "Indicates that the device supports TDM."; 408 } 410 /* 411 * Typedefs 412 */ 414 typedef power { 415 type decimal64 { 416 fraction-digits 1; 417 } 418 description 419 "Type used for power values, selected and measured."; 420 } 422 /* 423 * Radio Link Terminal (RLT) 424 */ 426 augment "/if:interfaces/if:interface" { 427 when "derived-from-or-self(if:type," 428 + "'mw-types:radio-link-terminal')"; 430 description 431 "Addition of data nodes for radio link terminal to 432 the standard Interface data model, for interfaces of 433 the type 'radio-link-terminal'."; 435 leaf id { 436 type string; 437 description 438 "Descriptive identity of the radio link terminal used by 439 far-end RLT to check that it's connected to the correct 440 near-end RLT. Does not need to be configured if this check 441 is not used."; 442 } 444 leaf mode { 445 type identityref { 446 base mw-types:rlt-mode; 447 } 448 mandatory true; 449 description 450 "A description of the mode in which the radio link 451 terminal is configured. The format is X plus Y. 452 X represent the number of bonded carrier terminations. 453 Y represent the number of protecting carrier 454 terminations."; 455 } 457 leaf-list carrier-terminations { 458 type if:interface-ref; 459 must "derived-from-or-self(/if:interfaces/if:interface" 460 + "[if:name = current()]" 461 + "/if:type, 'mw-types:carrier-termination')" { 462 description 463 "The type of interface must be 464 'carrier-termination'."; 465 } 466 min-elements 1; 467 description 468 "A list of references to carrier terminations 469 included in the radio link terminal."; 470 } 472 leaf-list rlp-groups { 473 type leafref { 474 path "/mrl:radio-link-protection-groups/" 475 + "mrl:protection-group/mrl:name"; 476 } 477 description 478 "A list of references to the carrier termination 479 groups configured for radio link protection in this 480 radio link terminal."; 481 } 483 leaf-list xpic-pairs { 484 if-feature xpic; 485 type leafref { 486 path "/mrl:xpic-pairs/mrl:xpic-pair/mrl:name"; 487 } 489 description 490 "A list of references to the XPIC pairs used in this 491 radio link terminal. One pair can be used by two 492 terminals."; 493 reference "ETSI TR 102 311"; 494 } 496 leaf-list mimo-groups { 497 if-feature mimo; 498 type leafref { 499 path "/mrl:mimo-groups/mrl:mimo-group/mrl:name"; 500 } 501 description 502 "A reference to the MIMO group used in this 503 radio link terminal. One group can be used by more 504 than one terminal."; 505 reference "ETSI TR 102 311"; 506 } 508 list tdm-connections { 509 if-feature tdm; 510 key "tdm-type"; 511 description 512 "A list stating the number of active TDM connections 513 of a specified tdm-type that is configured to be 514 supported by the RLT."; 515 leaf tdm-type { 516 type identityref { 517 base mw-types:tdm-type; 518 } 519 description 520 "The type of TDM connection, which also indicates 521 the supported capacity."; 522 } 523 leaf tdm-connections { 524 type uint16; 525 mandatory true; 526 description 527 "Number of connections of the specified type."; 528 } 529 } 530 } 532 /* 533 * Carrier Termination 534 */ 536 augment "/if:interfaces/if:interface" { 537 when "derived-from-or-self(if:type," 538 + "'mw-types:carrier-termination')"; 540 description 541 "Addition of data nodes for carrier termination to 542 the standard Interface data model, for interfaces 543 of the type 'carrier-termination'."; 545 leaf carrier-id { 546 type string; 547 default "A"; 548 description 549 "ID of the carrier. (e.g. A, B, C or D) 550 Used in XPIC & MIMO configurations to check that 551 the carrier termination is connected to the correct 552 far-end carrier termination. Should be the same 553 carrier ID on both sides of the hop. 554 Left as default value when MIMO and XPIC are not in use."; 555 } 557 leaf tx-enabled { 558 type boolean; 559 default "false"; 560 description 561 "Disables (false) or enables (true) the transmitter. 562 Only applicable when the interface is enabled 563 (interface:enabled = true) otherwise it's always 564 disabled."; 565 } 567 leaf tx-oper-status { 568 type enumeration { 569 enum "off" { 570 description "Transmitter is off."; 571 } 572 enum "on" { 573 description "Transmitter is on."; 575 } 576 enum "standby" { 577 description "Transmitter is in standby."; 578 } 579 } 580 config false; 581 description 582 "Shows the operative status of the transmitter."; 583 } 585 leaf tx-frequency { 586 type uint32; 587 units "kHz"; 588 mandatory true; 589 description 590 "Selected transmitter frequency."; 591 } 593 choice freq-or-distance { 594 leaf rx-frequency { 595 type uint32; 596 units "kHz"; 597 description 598 "Selected receiver frequency."; 599 } 600 leaf duplex-distance { 601 type int32; 602 units "kHz"; 603 description 604 "Distance between transmitter and receiver frequencies."; 605 } 606 mandatory true; 607 description 608 "A choice to configure rx-frequency directly or by computing 609 it as duplex-distance subtracted from tx-frequency." ; 610 } 612 leaf actual-rx-frequency { 613 type uint32; 614 units "kHz"; 615 config false; 616 description 617 "Computed receiver frequency."; 618 } 620 leaf actual-duplex-distance { 621 type uint32; 622 units "kHz"; 623 config false; 624 description 625 "Computed distance between Tx & Rx frequencies."; 626 } 628 leaf channel-separation { 629 type uint32; 630 units "kHz"; 631 mandatory true; 632 description 633 "The amount of bandwidth allocated to a carrier. The distance 634 between adjacent channels in a radio frequency channels 635 arrangement"; 636 reference "ETSI EN 302 217-1"; 637 } 639 leaf polarization { 640 type enumeration { 641 enum "horizontal" { 642 description "Horizontal polarization."; 643 } 644 enum "vertical" { 645 description "Vertical polarization."; 646 } 647 enum "not-specified" { 648 description "Polarization not specified."; 649 } 650 } 652 default "not-specified"; 653 description 654 "Polarization - A textual description for info only."; 655 } 657 choice power-mode { 658 container rtpc { 659 description 660 "Remote Transmit Power Control (RTPC)."; 661 reference "ETSI EN 302 217-1"; 662 leaf maximum-nominal-power { 663 type power { 664 range "-99..99"; 665 } 666 units "dBm"; 667 mandatory true; 668 description 669 "Selected output power."; 670 reference "ETSI EN 302 217-1"; 672 } 673 } 674 container atpc { 675 description 676 "Automatic Transmit Power Control (ATPC)."; 677 reference "ETSI EN 302 217-1"; 679 leaf maximum-nominal-power { 680 type power { 681 range "-99..99"; 682 } 683 units "dBm"; 684 mandatory true; 685 description 686 "Selected maximum output power. Minimum output 687 power is the same as the system capability, 688 available-min-output-power."; 689 reference "ETSI EN 302 217-1"; 690 } 692 leaf atpc-lower-threshold { 693 type power { 694 range "-99..-20"; 695 } 696 units "dBm"; 697 must "current() <= ../atpc-upper-threshold"; 698 mandatory true; 699 description 700 "The lower threshold for the input power at far-end 701 used in the ATPC mode."; 702 reference "ETSI EN 302 217-1"; 703 } 705 leaf atpc-upper-threshold { 706 type power { 707 range "-99..-20"; 708 } 709 units "dBm"; 710 mandatory true; 711 description 712 "The upper threshold for the input power at far-end 713 used in the ATPC mode."; 714 reference "ETSI EN 302 217-1"; 715 } 716 } 717 mandatory true; 718 description 719 "A choice of Remote Transmit Power Control (RTPC) 720 or Automatic Transmit Power Control (ATPC)."; 721 } 723 leaf actual-transmitted-level { 724 type power { 725 range "-99..99"; 726 } 727 units "dBm"; 728 config false; 729 description 730 "Actual transmitted power level (0.1 dBm resolution)."; 731 reference "ETSI EN 301 129"; 732 } 734 leaf actual-received-level { 735 type power { 736 range "-99..-20"; 737 } 738 units "dBm"; 739 config false; 740 description 741 "Actual received power level (0.1 dBm resolution)."; 742 reference "ETSI EN 301 129"; 743 } 745 choice coding-modulation-mode { 746 container single { 747 description "A single modulation order only."; 748 reference "ETSI EN 302 217-1"; 750 leaf selected-cm { 751 type identityref { 752 base mw-types:coding-modulation; 753 } 754 mandatory true; 755 description 756 "Selected the single coding/modulation."; 757 } 758 } 760 container adaptive { 761 description "Adaptive coding/modulation."; 762 reference "ETSI EN 302 217-1"; 764 leaf selected-min-acm { 765 type identityref { 766 base mw-types:coding-modulation; 767 } 768 mandatory true; 769 description 770 "Selected minimum coding/modulation. 771 Adaptive coding/modulation shall not go 772 below this value."; 773 } 775 leaf selected-max-acm { 776 type identityref { 777 base mw-types:coding-modulation; 778 } 779 mandatory true; 780 description 781 "Selected maximum coding/modulation. 782 Adaptive coding/modulation shall not go 783 above this value."; 784 } 785 } 786 mandatory true; 787 description 788 "A selection of single or 789 adaptive coding/modulation mode."; 790 } 792 leaf actual-tx-cm { 793 type identityref { 794 base mw-types:coding-modulation; 795 } 796 config false; 797 description 798 "Actual coding/modulation in transmitting direction."; 799 } 801 leaf actual-snir { 802 type decimal64 { 803 fraction-digits 1; 804 range "0..99"; 805 } 806 units "dB"; 807 config false; 808 description 809 "Actual signal to noise plus interference ratio. 810 (0.1 dB resolution)."; 811 } 813 leaf actual-xpi { 814 if-feature xpic; 815 type decimal64 { 816 fraction-digits 1; 817 range "0..99"; 818 } 819 units "dB"; 820 config false; 821 description 822 "The actual carrier to cross-polar interference. 823 Only valid if XPIC is enabled. (0.1 dB resolution)."; 824 reference "ETSI TR 102 311"; 825 } 827 container ct-performance-thresholds { 828 description 829 "Specification of thresholds for when alarms should 830 be sent and cleared for various performance counters."; 832 leaf received-level-alarm-threshold { 833 type power { 834 range "-99..-20"; 835 } 836 units "dBm"; 837 default "-99"; 838 description 839 "An alarm is sent when the received power level is 840 below the specified threshold."; 841 reference "ETSI EN 301 129"; 842 } 844 leaf transmitted-level-alarm-threshold { 845 type power { 846 range "-99..99"; 847 } 848 units "dBm"; 849 default "-99"; 850 description 851 "An alarm is sent when the transmitted power level 852 is below the specified threshold."; 853 reference "ETSI EN 301 129"; 854 } 856 leaf ber-alarm-threshold { 857 type enumeration { 858 enum "1e-9" { 859 description "Threshold at 1e-9 (10^-9)."; 860 } 861 enum "1e-8" { 862 description "Threshold at 1e-8 (10^-8)."; 863 } 864 enum "1e-7" { 865 description "Threshold at 1e-7 (10^-7)."; 866 } 867 enum "1e-6" { 868 description "Threshold at 1e-6 (10^-6)."; 869 } 870 enum "1e-5" { 871 description "Threshold at 1e-5 (10^-5)."; 872 } 873 enum "1e-4" { 874 description "Threshold at 1e-4 (10^-4)."; 875 } 876 enum "1e-3" { 877 description "Threshold at 1e-3 (10^-3)."; 878 } 879 enum "1e-2" { 880 description "Threshold at 1e-2 (10^-2)."; 881 } 882 enum "1e-1" { 883 description "Threshold at 1e-1 (10^-1)."; 884 } 885 } 886 default "1e-6"; 887 description 888 "Specification of at which BER an alarm should 889 be raised."; 890 reference "ETSI EN 302 217-1"; 891 } 892 } 894 leaf if-loop { 895 type enumeration { 896 enum disabled { 897 description "Disables the IF Loop."; 898 } 899 enum client { 900 description 901 "Loops the signal back to the client side."; 902 } 903 enum radio { 904 description 905 "Loops the signal back to the radio side."; 906 } 907 } 908 default "disabled"; 909 description 910 "Enable (client/radio) or disable (disabled) 911 the IF loop, which loops the signal back to 912 the client side or the radio side."; 913 } 915 leaf rf-loop { 916 type enumeration { 917 enum disabled { 918 description "Disables the RF Loop."; 919 } 920 enum client { 921 description 922 "Loops the signal back to the client side."; 923 } 924 enum radio { 925 description 926 "Loops the signal back to the radio side."; 927 } 928 } 929 default "disabled"; 930 description 931 "Enable (client/radio) or disable (disabled) 932 the RF loop, which loops the signal back to 933 the client side or the radio side."; 934 } 936 container capabilities { 937 config false; 938 description 939 "Capabilities of the installed equipment and 940 some selected configurations."; 942 leaf min-tx-frequency { 943 type uint32; 944 units "kHz"; 945 description 946 "Minimum Tx frequency possible to use."; 947 } 949 leaf max-tx-frequency { 950 type uint32; 951 units "kHz"; 952 description 953 "Maximum Tx frequency possible to use."; 954 } 956 leaf min-rx-frequency { 957 type uint32; 958 units "kHz"; 959 description 960 "Minimum Rx frequency possible to use."; 961 } 963 leaf max-rx-frequency { 964 type uint32; 965 units "kHz"; 966 description 967 "Maximum Tx frequency possible to use."; 968 } 970 leaf minimum-power { 971 type power; 972 units "dBm"; 973 description 974 "The minimum output power supported."; 975 reference "ETSI EN 302 217-1"; 976 } 978 leaf maximum-available-power { 979 type power; 980 units "dBm"; 981 description 982 "The maximum output power supported."; 983 reference "ETSI EN 302 217-1"; 984 } 986 leaf available-min-acm { 987 type identityref { 988 base mw-types:coding-modulation; 989 } 990 description 991 "Minimum coding-modulation possible to use."; 992 } 994 leaf available-max-acm { 995 type identityref { 996 base mw-types:coding-modulation; 997 } 998 description 999 "Maximum coding-modulation possible to use."; 1000 } 1001 } 1003 container error-performance-statistics { 1004 config false; 1005 description 1006 "ITU-T G.826 error performance statistics relevant for 1007 a microwave/millimeter wave carrier."; 1009 leaf bbe { 1010 type yang:counter32; 1011 units "number of block errors"; 1012 description 1013 "Number of Background Block Errors (BBE). A BBE is an 1014 errored block not occurring as part of an SES. 1015 Discontinuities in the value of this counter can occur 1016 at re-initialization of the management system and at 1017 other times as indicated by the value of 1018 'discontinuity-time' in ietf-interfaces."; 1019 reference "ITU-T G.826"; 1020 } 1022 leaf es { 1023 type yang:counter32; 1024 units "seconds"; 1025 description 1026 "Number of Errored Seconds (ES). 1027 An ES is a one-second period with one or more errored 1028 blocks or at least one defect. 1029 Discontinuities in the value of this counter can occur 1030 at re-initialization of the management system and at 1031 other times as indicated by the value of 1032 'discontinuity-time' in ietf-interfaces."; 1033 reference "ITU-T G.826"; 1034 } 1036 leaf ses { 1037 type yang:counter32; 1038 units "seconds"; 1039 description 1040 "Number of Severely Errored Seconds (SES). 1041 SES is a one-second period which contains 1042 equal or more than 30% errored blocks or at least 1043 one defect. SES is a subset of ES. 1044 Discontinuities in the value of this counter can occur 1045 at re-initialization of the management system and at 1046 other times as indicated by the value of 1047 'discontinuity-time' in ietf-interfaces."; 1048 reference "ITU-T G.826"; 1049 } 1051 leaf uas { 1052 type yang:counter32; 1053 units "seconds"; 1054 description 1055 "Number of Unavailable Seconds (UAS), that is, the 1056 total time that the node has been unavailable. 1058 Discontinuities in the value of this counter can occur 1059 at re-initialization of the management system and at 1060 other times as indicated by the value of 1061 'discontinuity-time' in ietf-interfaces."; 1062 reference "ITU-T G.826"; 1063 } 1064 } 1066 container radio-performance-statistics { 1067 config false; 1068 description 1069 "ETSI EN 301 129 radio physical interface statistics relevant 1070 for a carrier termination."; 1072 leaf min-rltm { 1073 type power { 1074 range "-99..-20"; 1075 } 1076 units "dBm"; 1077 description 1078 "Minimum received power level. 1079 Discontinuities in the value of this counter can occur 1080 at re-initialization of the management system and at 1081 other times as indicated by the value of 1082 'discontinuity-time' in ietf-interfaces."; 1083 reference "ETSI EN 301 129"; 1084 } 1086 leaf max-rltm { 1087 type power { 1088 range "-99..-20"; 1089 } 1090 units "dBm"; 1091 description 1092 "Maximum received power level. 1093 Discontinuities in the value of this counter can occur 1094 at re-initialization of the management system and at 1095 other times as indicated by the value of 1096 'discontinuity-time' in ietf-interfaces."; 1097 reference "ETSI EN 301 129"; 1098 } 1100 leaf min-tltm { 1101 type power { 1102 range "-99..99"; 1103 } 1104 units "dBm"; 1105 description 1106 "Minimum transmitted power level. 1107 Discontinuities in the value of this counter can occur 1108 at re-initialization of the management system and at 1109 other times as indicated by the value of 1110 'discontinuity-time' in ietf-interfaces."; 1111 reference "ETSI EN 301 129"; 1112 } 1114 leaf max-tltm { 1115 type power { 1116 range "-99..99"; 1117 } 1118 units "dBm"; 1119 description 1120 "Maximum transmitted power level. 1121 Discontinuities in the value of this counter can occur 1122 at re-initialization of the management system and at 1123 other times as indicated by the value of 1124 'discontinuity-time' in ietf-interfaces."; 1125 reference "ETSI EN 301 129"; 1126 } 1127 } 1128 } 1130 /* 1131 * Radio Link Protection Groups 1132 */ 1134 container radio-link-protection-groups { 1135 description 1136 "Configuration of radio link protected groups (1+1) of 1137 carrier terminations in a radio link. More than one 1138 protected group per radio-link-terminal is allowed."; 1140 uses ifprot:protection-groups { 1142 refine protection-group/members { 1143 must "derived-from-or-self(/if:interfaces/if:interface" 1144 + "[if:name = current()]" 1145 + "/if:type, 'mw-types:carrier-termination')" { 1146 description 1147 "The type of a protection member must be 1148 'carrier-termination'."; 1149 } 1150 } 1152 refine protection-group/working-entity { 1153 must "derived-from-or-self(/if:interfaces/if:interface" 1154 + "[if:name = current()]" 1155 + "/if:type, 'mw-types:carrier-termination')" { 1156 description 1157 "The type of a working-entity must be 1158 'carrier-termination'."; 1159 } 1160 } 1161 } 1162 } 1164 /* 1165 * XPIC & MIMO groups - Configuration data nodes 1166 */ 1168 container xpic-pairs { 1169 if-feature xpic; 1170 description 1171 "Configuration of carrier termination pairs 1172 for operation in XPIC mode."; 1173 reference "ETSI TR 102 311"; 1175 list xpic-pair { 1176 key "name"; 1177 description 1178 "List of carrier termination pairs in XPIC mode."; 1180 leaf name { 1181 type string; 1182 description 1183 "Name used for identification of the XPIC pair."; 1184 } 1186 leaf enabled { 1187 type boolean; 1188 default "false"; 1189 description 1190 "Enable(true)/disable(false) XPIC"; 1191 } 1193 leaf-list members { 1194 type if:interface-ref; 1195 must "derived-from-or-self(/if:interfaces/if:interface" 1196 + "[if:name = current()]" 1197 + "/if:type, 'mw-types:carrier-termination')" { 1198 description 1199 "The type of a member must be 'carrier-termination'."; 1200 } 1201 min-elements 2; 1202 max-elements 2; 1203 description 1204 "Association to XPIC pairs used in the radio link 1205 terminal."; 1206 } 1207 } 1208 } 1210 container mimo-groups { 1211 if-feature mimo; 1212 description 1213 "Configuration of carrier terminations 1214 for operation in MIMO mode."; 1215 reference "ETSI TR 102 311"; 1217 list mimo-group { 1218 key "name"; 1219 description 1220 "List of carrier terminations in MIMO mode."; 1222 leaf name { 1223 type string; 1224 description 1225 "Name used for identification of the MIMO group."; 1226 } 1228 leaf enabled { 1229 type boolean; 1230 default "false"; 1231 description 1232 "Enable(true)/disable(false) MIMO"; 1233 } 1235 leaf-list members { 1236 type if:interface-ref; 1237 must "derived-from-or-self(/if:interfaces/if:interface" 1238 + "[if:name = current()]" 1239 + "/if:type, 'mw-types:carrier-termination')" { 1240 description 1241 "The type of a member must be 'carrier-termination'."; 1242 } 1244 min-elements 2; 1245 description 1246 "Association to a MIMO group if used in the radio 1247 link terminal."; 1248 } 1249 } 1251 } 1252 } 1254 1256 5. Interface Protection YANG Module 1258 The data nodes for management of the interface protection 1259 functionality is broken out from the Microwave Radio Link Module into 1260 a separate and generic YANG data module in order to make it available 1261 also for other interface types. 1263 This module imports modules from [RFC8343], and it references 1264 [G.808.1]. 1266 file "ietf-interface-protection@2018-11-06.yang" 1268 module ietf-interface-protection { 1269 yang-version 1.1; 1270 namespace "urn:ietf:params:xml:ns:yang:ietf-interface-protection"; 1271 prefix ifprot; 1273 import ietf-interfaces { 1274 prefix if; 1275 reference "RFC8343"; 1276 } 1278 organization 1279 "Internet Engineering Task Force (IETF) CCAMP WG"; 1280 contact 1281 "WG List: 1283 ID-draft editors: 1284 Jonas Ahlberg (jonas.ahlberg@ericsson.com); 1285 Min Ye (amy.yemin@huawei.com); 1286 Xi Li (Xi.Li@neclab.eu); 1287 Daniela Spreafico (daniela.spreafico@nokia.com) 1288 Marko Vaupotic (Marko.Vaupotic@aviatnet.com)"; 1290 description 1291 "This is a module for the entities in 1292 a generic interface protection mechanism. 1294 Copyright (c) 2018 IETF Trust and the persons identified as 1295 authors of the code. All rights reserved. 1297 Redistribution and use in source and binary forms, with or 1298 without modification, is permitted pursuant to, and subject 1299 to the license terms contained in, the Simplified BSD License 1300 set forth in Section 4.c of the IETF Trust's Legal Provisions 1301 Relating to IETF Documents 1302 (http://trustee.ietf.org/license-info). 1304 This version of this YANG module is part of RFC XXXX; see 1305 the RFC itself for full legal notices. 1307 Copyright (c) 2018 IETF Trust and the persons identified as 1308 authors of the code. All rights reserved."; 1310 revision 2018-11-06 { 1311 description "Initial revision."; 1312 reference "RFC XXXX: A YANG Data Model for Microwave Radio Link"; 1313 } 1315 /* 1316 * Protection architecture type identities 1317 */ 1319 identity protection-architecture-type { 1320 description 1321 "protection architecture type"; 1322 reference "ITU-T G.808.1"; 1323 } 1325 identity one-plus-one-type { 1326 base protection-architecture-type; 1327 description 1328 "1+1, One interface protects 1329 another one interface."; 1330 reference "ITU-T G.808.1"; 1331 } 1333 identity one-to-n-type { 1334 base protection-architecture-type; 1335 description 1336 "1:N, One interface protects 1337 n other interfaces."; 1338 reference "ITU-T G.808.1"; 1339 } 1341 /* 1342 * Protection states identities 1343 */ 1345 identity protection-states { 1346 description 1347 "Identities describing the status of the protection, 1348 in a group of interfaces configured in 1349 a protection mode."; 1350 } 1352 identity unprotected { 1353 base protection-states; 1354 description "Not protected"; 1355 } 1357 identity protected { 1358 base protection-states; 1359 description "Protected"; 1360 } 1362 identity unable-to-protect { 1363 base protection-states; 1364 description "Unable to protect"; 1365 } 1367 /* 1368 * Protection Groups 1369 */ 1371 grouping protection-groups { 1372 description 1373 "Configuration of protected groups (1+1) of interfaces 1374 providing protection for each other. More than one protected 1375 group per higher-layer-interface is allowed."; 1377 list protection-group { 1378 key "name"; 1379 description 1380 "List of protected groups of interfaces 1381 in a higher-layer-interface."; 1383 leaf name { 1384 type string; 1385 description 1386 "Name used for identification of the protection group"; 1387 } 1389 leaf protection-architecture-type { 1390 type identityref { 1391 base protection-architecture-type; 1392 } 1393 default "ifprot:one-plus-one-type"; 1394 description 1395 "The type of protection architecture used, e.g. one 1396 interface protecting one or several other interfaces."; 1397 reference "ITU-T G.808.1"; 1398 } 1400 leaf-list members { 1401 type if:interface-ref; 1402 min-elements 2; 1403 description 1404 "Association to a group of interfaces configured for 1405 protection and used by a higher-layer-interface."; 1406 } 1408 leaf operation-type { 1409 type enumeration { 1410 enum "non-revertive" { 1411 description 1412 "In non revertive operation, the traffic does not 1413 return to the working interface if the switch requests 1414 are terminated."; 1415 reference "ITU-T G.808.1"; 1416 } 1417 enum "revertive" { 1418 description 1419 "In revertive operation, the traffic always 1420 returns to (or remains on) the working interface 1421 if the switch requests are terminated."; 1422 reference "ITU-T G.808.1"; 1423 } 1424 } 1425 default "non-revertive"; 1426 description 1427 "The type of protection operation, i.e. revertive 1428 or non-revertive operation."; 1429 } 1431 leaf-list working-entity { 1432 when "../operation-type = 'revertive'"; 1433 type if:interface-ref; 1434 min-elements 1; 1435 description 1436 "The interfaces over which the traffic normally should 1437 be transported over when there is no need to use the 1438 protecting interface."; 1439 } 1440 leaf revertive-wait-to-restore { 1441 when "../operation-type = 'revertive'"; 1442 type uint16; 1443 units "seconds"; 1444 default "0"; 1445 description 1446 "The time to wait before switching back to the working 1447 interface if operation-type is revertive."; 1448 reference "ITU-T G.808.1"; 1449 } 1451 leaf hold-off-timer { 1452 type uint16; 1453 units "milliseconds"; 1454 default "0"; 1455 description 1456 "Time interval after the detection of a fault and its 1457 confirmation as a condition requiring the protection 1458 switching procedure."; 1459 reference "ITU-T G.808.1"; 1460 } 1462 leaf status { 1463 type identityref { 1464 base protection-states; 1465 } 1466 config false; 1467 description 1468 "Status of the protection, in a group of interfaces 1469 configured in a protection mode."; 1470 reference "ITU-T G.808.1"; 1471 } 1473 action manual-switch-working { 1474 description 1475 "A switch action initiated by an operator command. 1476 It switches normal traffic signal to the working 1477 transport entity."; 1478 reference "ITU-T G.808.1"; 1479 } 1481 action manual-switch-protection { 1482 description 1483 "A switch action initiated by an operator command. 1484 It switches normal traffic signal to the protection 1485 transport entity."; 1486 reference "ITU-T G.808.1"; 1487 } 1488 action forced-switch { 1489 description 1490 "A switch action initiated by an operator command. 1491 It switches normal traffic signal to the protection 1492 transport entity and forces it to remain on that 1493 entity even when criteria for switching back to 1494 the original entity are fulfilled."; 1495 reference "ITU-T G.808.1"; 1496 } 1498 action lockout-of-protection { 1499 description 1500 "A switch action temporarily disables access to the 1501 protection transport entity for all signals."; 1502 reference "ITU-T G.808.1"; 1503 } 1505 action freeze { 1506 description 1507 "A switch action temporarily prevents any switch action 1508 to be taken and, as such, freezes the current state. 1509 Until the freeze is cleared, additional near-end external 1510 commands are rejected and fault condition changes and 1511 received APS messages are ignored.."; 1512 reference "ITU-T G.808.1"; 1513 } 1515 action exercise { 1516 description 1517 "A switch action to test if the APS communication is 1518 operating correctly. It is lower priority than any 'real' 1519 switch request.."; 1520 reference "ITU-T G.808.1"; 1521 } 1523 action clear { 1524 description 1525 "An action clears all switch commands."; 1526 reference "ITU-T G.808.1"; 1527 } 1528 } 1529 } 1530 } 1532 1534 6. Microwave Types YANG Module 1536 This module defines a collection of common data types using the YANG 1537 data modeling language. These common types are designed to be 1538 imported by other modules defined in the microwave area. 1540 file "ietf-microwave-types@2018-11-06.yang" 1542 module ietf-microwave-types { 1543 yang-version 1.1; 1544 namespace "urn:ietf:params:xml:ns:yang:ietf-microwave-types"; 1545 prefix mw-types; 1547 import iana-if-type { 1548 prefix ianaift; 1549 reference "RFC 7224"; 1550 } 1552 organization 1553 "Internet Engineering Task Force (IETF) CCAMP WG"; 1554 contact 1555 "WG List: 1557 ID-draft editors: 1558 Jonas Ahlberg (jonas.ahlberg@ericsson.com); 1559 Min Ye (amy.yemin@huawei.com); 1560 Xi Li (Xi.Li@neclab.eu); 1561 Daniela Spreafico (daniela.spreafico@nokia.com) 1562 Marko Vaupotic (Marko.Vaupotic@aviatnet.com)"; 1564 description 1565 "This module contains a collection of YANG data types 1566 considered generally useful for microwave interfaces. 1568 Copyright (c) 2018 IETF Trust and the persons identified as 1569 authors of the code. All rights reserved. 1571 Redistribution and use in source and binary forms, with or 1572 without modification, is permitted pursuant to, and subject 1573 to the license terms contained in, the Simplified BSD License 1574 set forth in Section 4.c of the IETF Trust's Legal Provisions 1575 Relating to IETF Documents 1576 (http://trustee.ietf.org/license-info). 1578 This version of this YANG module is part of RFC XXXX; see 1579 the RFC itself for full legal notices. 1581 Copyright (c) 2018 IETF Trust and the persons identified as 1582 authors of the code. All rights reserved."; 1584 revision 2018-11-06 { 1585 description "Initial revision."; 1586 reference "RFC XXXX: A YANG Data Model for Microwave Radio Link"; 1587 } 1589 /* 1590 * Interface identities 1591 */ 1593 identity radio-link-terminal { 1594 base ianaift:iana-interface-type; 1595 description 1596 "Interface identity for a radio link terminal."; 1597 } 1599 identity carrier-termination { 1600 base ianaift:iana-interface-type; 1601 description 1602 "Interface identity for a carrier termination."; 1603 } 1605 /* 1606 * Radio-link-terminal mode identities 1607 */ 1609 identity rlt-mode { 1610 description 1611 "A description of the mode in which the radio link 1612 terminal is configured. The format is X plus Y. 1613 X represent the number of bonded carrier terminations. 1614 Y represent the number of protecting carrier 1615 terminations."; 1616 } 1618 identity one-plus-zero { 1619 base rlt-mode; 1620 description 1621 "1 carrier termination only."; 1622 } 1624 identity one-plus-one { 1625 base rlt-mode; 1626 description 1627 "1 carrier termination 1628 and 1 protecting carrier termination."; 1630 } 1632 identity two-plus-zero { 1633 base rlt-mode; 1634 description 1635 "2 bonded carrier terminations."; 1636 } 1638 /* 1639 * Coding and modulation identities 1640 */ 1642 identity coding-modulation { 1643 description 1644 "The coding and modulation schemes."; 1645 } 1647 identity half-bpsk { 1648 base coding-modulation; 1649 description 1650 "Half BPSK coding and modulation scheme."; 1651 } 1653 identity half-bpsk-strong { 1654 base half-bpsk; 1655 description 1656 "Half BPSK strong coding and modulation scheme."; 1657 } 1659 identity half-bpsk-light { 1660 base half-bpsk; 1661 description 1662 "Half BPSK light coding and modulation scheme."; 1663 } 1665 identity bpsk { 1666 base coding-modulation; 1667 description 1668 "BPSK coding and modulation scheme."; 1669 } 1671 identity bpsk-strong { 1672 base bpsk; 1673 description 1674 "BPSK strong coding and modulation scheme."; 1675 } 1677 identity bpsk-light { 1678 base bpsk; 1679 description 1680 "BPSK light coding and modulation scheme."; 1681 } 1683 identity qpsk { 1684 base coding-modulation; 1685 description 1686 "QPSK coding and modulation scheme."; 1687 } 1689 identity qam-4 { 1690 base coding-modulation; 1691 description 1692 "4 QAM coding and modulation scheme."; 1693 } 1695 identity qam-4-strong { 1696 base qam-4; 1697 description 1698 "4 QAM strong coding and modulation scheme."; 1699 } 1701 identity qam-4-light { 1702 base qam-4; 1703 description 1704 "4 QAM light coding and modulation scheme."; 1705 } 1707 identity qam-16 { 1708 base coding-modulation; 1709 description 1710 "16 QAM coding and modulation scheme."; 1711 } 1713 identity qam-16-strong { 1714 base qam-16; 1715 description 1716 "16 QAM strong coding and modulation scheme."; 1717 } 1719 identity qam-16-light { 1720 base qam-16; 1721 description 1722 "16 QAM light coding and modulation scheme."; 1723 } 1725 identity qam-32 { 1726 base coding-modulation; 1727 description 1728 "32 QAM coding and modulation scheme."; 1729 } 1731 identity qam-32-strong { 1732 base qam-32; 1733 description 1734 "32 QAM strong coding and modulation scheme."; 1735 } 1737 identity qam-32-light { 1738 base qam-32; 1739 description 1740 "32 QAM light coding and modulation scheme."; 1741 } 1743 identity qam-64 { 1744 base coding-modulation; 1745 description 1746 "64 QAM coding and modulation scheme."; 1747 } 1749 identity qam-64-strong { 1750 base qam-64; 1751 description 1752 "64 QAM strong coding and modulation scheme."; 1753 } 1755 identity qam-64-light { 1756 base qam-64; 1757 description 1758 "64 QAM light coding and modulation scheme."; 1759 } 1761 identity qam-128 { 1762 base coding-modulation; 1763 description 1764 "128 QAM coding and modulation scheme."; 1765 } 1767 identity qam-128-strong { 1768 base qam-128; 1769 description 1770 "128 QAM strong coding and modulation scheme."; 1771 } 1773 identity qam-128-light { 1774 base qam-128; 1775 description 1776 "128 QAM light coding and modulation scheme."; 1777 } 1779 identity qam-256 { 1780 base coding-modulation; 1781 description 1782 "256 QAM coding and modulation scheme."; 1783 } 1785 identity qam-256-strong { 1786 base qam-256; 1787 description 1788 "256 QAM strong coding and modulation scheme."; 1789 } 1791 identity qam-256-light { 1792 base qam-256; 1793 description 1794 "256 QAM light coding and modulation scheme."; 1795 } 1797 identity qam-512 { 1798 base coding-modulation; 1799 description 1800 "512 QAM coding and modulation scheme."; 1801 } 1803 identity qam-512-strong { 1804 base qam-512; 1805 description 1806 "512 QAM strong coding and modulation scheme."; 1807 } 1809 identity qam-512-light { 1810 base qam-512; 1811 description 1812 "512 QAM light coding and modulation scheme."; 1813 } 1815 identity qam-1024 { 1816 base coding-modulation; 1817 description 1818 "1024 QAM coding and modulation scheme."; 1819 } 1821 identity qam-1024-strong { 1822 base qam-1024; 1823 description 1824 "1024 QAM strong coding and modulation scheme."; 1825 } 1827 identity qam-1024-light { 1828 base qam-1024; 1829 description 1830 "1024 QAM light coding and modulation scheme."; 1831 } 1833 identity qam-2048 { 1834 base coding-modulation; 1835 description 1836 "2048 QAM coding and modulation scheme."; 1837 } 1839 identity qam-2048-strong { 1840 base qam-2048; 1841 description 1842 "2048 QAM strong coding and modulation scheme."; 1843 } 1845 identity qam-2048-light { 1846 base qam-2048; 1847 description 1848 "2048 QAM light coding and modulation scheme."; 1849 } 1851 identity qam-4096 { 1852 base coding-modulation; 1853 description 1854 "4096 QAM coding and modulation scheme."; 1855 } 1857 identity qam-4096-strong { 1858 base qam-4096; 1859 description 1860 "4096 QAM strong coding and modulation scheme."; 1861 } 1863 identity qam-4096-light { 1864 base qam-4096; 1865 description 1866 "4096 QAM light coding and modulation scheme."; 1867 } 1869 /* 1870 * TDM-type identities 1871 */ 1873 identity tdm-type { 1874 description 1875 "A description of the type of TDM connection, 1876 also indicating the supported capacity of the 1877 connection."; 1878 } 1880 identity E1 { 1881 base tdm-type; 1882 description 1883 "E1 connection, 2.048 Mbit/s."; 1884 } 1886 identity STM-1 { 1887 base tdm-type; 1888 description 1889 "STM-1 connection, 155.52 Mbit/s."; 1890 } 1891 } 1893 1895 7. Security Considerations 1897 The YANG modules specified in this document define schemas for data 1898 that is designed to be accessed via network management protocols such 1899 as NETCONF [RFC6241] or RESTCONF [RFC8040]. The lowest NETCONF layer 1900 is the secure transport layer, and the mandatory-to-implement secure 1901 transport is Secure Shell (SSH) [RFC6242]. The lowest RESTCONF layer 1902 is HTTPS, and the mandatory-to-implement secure transport is TLS 1903 [RFC8446]. 1905 The NETCONF access control model [RFC8341] provides the means to 1906 restrict access for particular NETCONF or RESTCONF users to a 1907 preconfigured subset of all available NETCONF or RESTCONF protocol 1908 operations and content. 1910 There are a number of data nodes defined in these YANG modules that 1911 are writable/creatable/deletable (i.e., config true, which is the 1912 default). These data nodes may be considered sensitive or vulnerable 1913 in some network environments. Write operations (e.g., edit-config) 1914 to these data nodes without proper protection can have a negative 1915 effect on network operations. These are the subtrees and data nodes 1916 and their sensitivity/vulnerability: 1918 Interfaces of type radio-link-terminal: 1920 /if:interfaces/if:interface/mode, 1921 /if:interfaces/if:interface/carrier-terminations, 1922 /if:interfaces/if:interface/rlp-groups, 1923 /if:interfaces/if:interface/xpic-pairs, 1924 /if:interfaces/if:interface/mimo-groups, and 1925 /if:interfaces/if:interface/tdm-connections: 1927 These data nodes represent the configuration of the radio-link- 1928 terminal and they need to match the configuration of the radio-link- 1929 terminal on the other side of the radio link. Unauthorized access to 1930 these data nodes could interrupt the ability to forward traffic. 1932 Interfaces of type carrier-termination: 1934 /if:interfaces/if:interface/carrier-id, 1935 /if:interfaces/if:interface/tx-enabled, 1936 /if:interfaces/if:interface/tx-frequency, 1937 /if:interfaces/if:interface/rx-frequency, 1938 /if:interfaces/if:interface/duplex-distance, 1939 /if:interfaces/if:interface/channel-separation, 1940 /if:interfaces/if:interface/rtpc/maximum-nominal-power, 1941 /if:interfaces/if:interface/atpc/maximum-nominal-power, 1942 /if:interfaces/if:interface/atpc/atpc-lower-threshold, 1943 /if:interfaces/if:interface/atpc/atpc-upper-threshold, 1944 /if:interfaces/if:interface/single/selected-cm, 1945 /if:interfaces/if:interface/adaptive/selected-min-acm, 1946 /if:interfaces/if:interface/adaptive/selected-max-acm, 1947 /if:interfaces/if:interface/if-loop, and 1948 /if:interfaces/if:interface/rf-loop: 1950 These data nodes represent the configuration of the carrier- 1951 termination and they need to match the configuration of the carrier- 1952 termination on the other side of the carrier. Unauthorized access to 1953 these data nodes could interrupt the ability to forward traffic. 1955 Radio link protection: 1957 /radio-link-protection-groups/protection-group: 1959 This data node represents the configuration of the protection of 1960 carrier terminations. Unauthorized access to this data node could 1961 interrupt the ability to forward traffic or remove the ability to 1962 perform a necessary protection switch. 1964 XPIC: 1966 /xpic-pairs: 1968 This data node represents the XPIC configuration of a pair carriers. 1969 Unauthorized access to this data node could interrupt the ability to 1970 forward traffic. 1972 MIMO: 1974 /mimo-groups: 1976 This data node represents the MIMO configuration of multiple 1977 carriers. Unauthorized access to this data node could interrupt the 1978 ability to forward traffic. 1980 The security considerations of [RFC8343] also apply to this document. 1982 8. IANA Considerations 1984 It is proposed that IANA should assign new URIs from the "IETF XML 1985 Registry" [RFC3688] as follows: 1987 URI: urn:ietf:params:xml:ns:yang:ietf-microwave-radio-link 1988 Registrant Contact: The IESG 1989 XML: N/A; the requested URI is an XML namespace. 1991 URI: urn:ietf:params:xml:ns:yang:ietf-interface-protection 1992 Registrant Contact: The IESG 1993 XML: N/A; the requested URI is an XML namespace. 1995 URI: urn:ietf:params:xml:ns:yang:ietf-microwave-types 1996 Registrant Contact: The IESG 1997 XML: N/A; the requested URI is an XML namespace. 1999 It is proposed that IANA should record YANG module names in the "YANG 2000 Module Names" registry [RFC6020] as follows: 2002 Name: ietf-microwave-radio-link 2003 Maintained by IANA?: N 2004 Namespace: urn:ietf:params:xml:ns:yang:ietf-microwave-radio-link 2005 Prefix: mrl 2006 Reference: RFC XXXX 2008 Name: ietf-interface-protection 2009 Maintained by IANA?: N 2010 Namespace: urn:ietf:params:xml:ns:yang:ietf-interface-protection 2011 Prefix: ifprot 2012 Reference: RFC XXXX 2014 Name: ietf-microwave-types 2015 Maintained by IANA?: N 2016 Namespace: urn:ietf:params:xml:ns:yang:ietf-microwave-types 2017 Prefix: mw-types 2018 Reference: RFC XXXX 2020 9. References 2022 9.1. Normative References 2024 [RFC2119] Bradner, S., "Key words for use in RFCs to Indicate 2025 Requirement Levels", BCP 14, RFC 2119, 2026 DOI 10.17487/RFC2119, March 1997, 2027 . 2029 [RFC3688] Mealling, M., "The IETF XML Registry", BCP 81, RFC 3688, 2030 DOI 10.17487/RFC3688, January 2004, 2031 . 2033 [RFC6020] Bjorklund, M., Ed., "YANG - A Data Modeling Language for 2034 the Network Configuration Protocol (NETCONF)", RFC 6020, 2035 DOI 10.17487/RFC6020, October 2010, 2036 . 2038 [RFC6241] Enns, R., Ed., Bjorklund, M., Ed., Schoenwaelder, J., Ed., 2039 and A. Bierman, Ed., "Network Configuration Protocol 2040 (NETCONF)", RFC 6241, DOI 10.17487/RFC6241, June 2011, 2041 . 2043 [RFC6242] Wasserman, M., "Using the NETCONF Protocol over Secure 2044 Shell (SSH)", RFC 6242, DOI 10.17487/RFC6242, June 2011, 2045 . 2047 [RFC6991] Schoenwaelder, J., Ed., "Common YANG Data Types", 2048 RFC 6991, DOI 10.17487/RFC6991, July 2013, 2049 . 2051 [RFC7224] Bjorklund, M., "IANA Interface Type YANG Module", 2052 RFC 7224, DOI 10.17487/RFC7224, May 2014, 2053 . 2055 [RFC8040] Bierman, A., Bjorklund, M., and K. Watsen, "RESTCONF 2056 Protocol", RFC 8040, DOI 10.17487/RFC8040, January 2017, 2057 . 2059 [RFC8174] Leiba, B., "Ambiguity of Uppercase vs Lowercase in RFC 2060 2119 Key Words", BCP 14, RFC 8174, DOI 10.17487/RFC8174, 2061 May 2017, . 2063 [RFC8341] Bierman, A. and M. Bjorklund, "Network Configuration 2064 Access Control Model", STD 91, RFC 8341, 2065 DOI 10.17487/RFC8341, March 2018, 2066 . 2068 [RFC8343] Bjorklund, M., "A YANG Data Model for Interface 2069 Management", RFC 8343, DOI 10.17487/RFC8343, March 2018, 2070 . 2072 [RFC8446] Rescorla, E., "The Transport Layer Security (TLS) Protocol 2073 Version 1.3", RFC 8446, DOI 10.17487/RFC8446, August 2018, 2074 . 2076 9.2. Informative References 2078 [EN301129] 2079 "Transmission and Multiplexing (TM); Digital Radio Relay 2080 Systems (DRRS); Synchronous Digital Hierarchy (SDH); 2081 System performance monitoring parameters of SDH DRRS", EN 2082 301 129 V1.1.2 , May 1995. 2084 [EN302217-1] 2085 "Fixed Radio Systems; Characteristics and requirements for 2086 point-to-point equipment and antennas; Part 1: Overview, 2087 common characteristics and system-dependent requirements", 2088 EN 302 217-1 V3.0.5 , June 2016. 2090 [EN302217-2] 2091 "Fixed Radio Systems; Characteristics and requirements for 2092 point to-point equipment and antennas; Part 2: Digital 2093 systems operating in frequency bands from 1 GHz to 86 GHz; 2094 Harmonised Standard covering the essential requirements of 2095 article 3.2 of Directive 2014/53/EU", EN 302 217-2 2096 V3.1.1 , May 2017. 2098 [G.808.1] "SERIES G: TRANSMISSION SYSTEMS AND MEDIA, DIGITAL SYSTEMS 2099 AND NETWORKS; Digital networks ; General aspects Generic 2100 protection switching ; Linear trail and subnetwork 2101 protection", ITU-T Rec. G.808.1 , May 2014. 2103 [G.826] "SERIES G: TRANSMISSION SYSTEMS AND MEDIA, DIGITAL SYSTEMS 2104 AND NETWORKS; Digital networks ; Quality and availability 2105 targets End-to-end error performance parameters and 2106 objectives for international, constant bit-rate digital 2107 paths and connections", ITU-T Rec. G.826 , December 2002. 2109 [I-D.ahlberg-ccamp-microwave-radio-link] 2110 Ahlberg, J., Carlson, J., Lund, H., Olausson, T., Ye, M., 2111 and M. Vaupotic, "Microwave Radio Link YANG Data Models", 2112 draft-ahlberg-ccamp-microwave-radio-link-01 (work in 2113 progress), May 2016. 2115 [ONF-model] 2116 "Microwave Information Model", version 1.0 , December 2117 2016, 2118 . 2122 [RFC8340] Bjorklund, M. and L. Berger, Ed., "YANG Tree Diagrams", 2123 BCP 215, RFC 8340, DOI 10.17487/RFC8340, March 2018, 2124 . 2126 [RFC8342] Bjorklund, M., Schoenwaelder, J., Shafer, P., Watsen, K., 2127 and R. Wilton, "Network Management Datastore Architecture 2128 (NMDA)", RFC 8342, DOI 10.17487/RFC8342, March 2018, 2129 . 2131 [RFC8432] Ahlberg, J., Ed., Ye, M., Ed., Li, X., Contreras, LM., and 2132 CJ. Bernardos, "A Framework for Management and Control of 2133 Microwave and Millimeter Wave Interface Parameters", 2134 RFC 8432, DOI 10.17487/RFC8432, October 2018, 2135 . 2137 [TR102311] 2138 "Fixed Radio Systems; Point-to-point equipment; Specific 2139 aspects of the spatial frequency reuse method", ETSI TR 2140 102 311 V1.2.1 , November 2015. 2142 Appendix A. Example: 1+0 and 2+0 configuration instances 2144 This section gives simple examples of 1+0 and 2+0 instance using the 2145 YANG module defined in this draft. The examples are not intended as 2146 a complete module for 1+0 and 2+0 configuration. 2148 A.1. 1+0 instance 2150 /--------- Radio Link ---------\ 2151 Near End Far End 2153 +---------------+ +---------------+ 2154 | Radio Link | | Radio Link | 2155 | Terminal A | | Terminal B | 2156 | | | | 2157 | | | | 2158 | +-----------+ | | +-----------+ | 2159 | | | | Carrier A | | | | 2160 | | Carrier | |<--------->| | Carrier | | 2161 | |Termination| | | |Termination| | 2162 | | 1 | | | | 1 | | 2163 | +-----------+ | | +-----------+ | 2164 | | | | 2165 | | | | 2166 +---------------+ +---------------+ 2168 \--- Microwave Node ---/ \--- Microwave Node ---/ 2169 Figure A-1 1+0 example 2171 Figure A-1 shows a 1+0 example. The following instance 2172 shows the 1+0 configuration of Near End node. 2174 "interface": [ 2175 { 2176 "name": "RLT-A", 2177 "description": "Radio Link Terminal A", 2178 "type": "mrl:radio-link-terminal", 2179 "id": "RLT-A", 2180 "mode": "one-plus-zero", 2181 "carrier-terminations": [ 2182 "RLT-A:CT-1" 2183 ], 2184 "tdm-connections": [ 2185 "tdm-type": "E1", 2186 "tdm-connections": "4" 2187 ] 2188 }, 2190 { 2191 "name": "RLT-A:CT-1", 2192 "description": "Carrier Termination 1", 2193 "type": "mrl:carrier-termination", 2194 "carrier-id": "A", 2195 "tx-enabled": true, 2196 "tx-frequency": 10728000, 2197 "duplex-distance": 644000, 2198 "channel-separation": 28, 2199 "polarization": not-specified, 2200 "rtpc": { 2201 "maximum-nominal-power": 20 2202 }, 2203 "single": { 2204 "selected-cm": "qam-512" 2205 } 2206 } 2207 ] 2209 A.2. 2+0 instance 2211 Figure A-2 shows a 2+0 example. 2213 /--------- Radio Link ---------\ 2214 Near End Far End 2216 +---------------+ +---------------+ 2217 | Radio Link | | Radio Link | 2218 | Terminal A | | Terminal B | 2219 | | | | 2220 | | | | 2221 | +-----------+ | | +-----------+ | 2222 | | | | Carrier A | | | | 2223 | | Carrier | |<--------->| | Carrier | | 2224 | |Termination| | | |Termination| | 2225 | | 1 | | | | 1 | | 2226 | +-----------+ | | +-----------+ | 2227 | | | | 2228 | +-----------+ | | +-----------+ | 2229 | | | | Carrier B | | | | 2230 | | Carrier | |<--------->| | Carrier | | 2231 | |Termination| | | |Termination| | 2232 | | 2 | | | | 2 | | 2233 | +-----------+ | | +-----------+ | 2234 | | | | 2235 +---------------+ +---------------+ 2237 \--- Microwave Node ---/ \--- Microwave Node ---/ 2238 Figure A-2 2+0 example 2240 The following instance shows the 2+0 configuration of 2241 Near End node. 2243 "interface": [ 2244 { 2245 "name": "RLT-A", 2246 "description": "Radio Link Terminal A", 2247 "type": "mrl:radio-link-terminal", 2248 "id": "RLT-A", 2249 "mode": "two-plus-zero", 2250 "carrier-terminations": [ 2251 "RLT-A:CT-1", 2252 "RLT-A:CT-2" 2253 ], 2254 "tdm-connections": [ 2255 "tdm-type": "E1", 2256 "tdm-connections": "4" 2257 ] 2258 }, 2260 { 2261 "name": "RLT-A:CT-1", 2262 "description": "Carrier Termination 1", 2263 "type": "mrl:carrier-termination", 2264 "carrier-id": "A", 2265 "tx-enabled": true, 2266 "tx-frequency": 10728000, 2267 "duplex-distance": 644000, 2268 "channel-separation": 28, 2269 "polarization": not-specified, 2270 "rtpc": { 2271 "maximum-nominal-power": 20 2272 }, 2273 "single": { 2274 "selected-cm": "qam-512" 2275 } 2276 }, 2277 { 2278 "name": "RLT-A:CT-2", 2279 "description": "Carrier Termination 2", 2280 "type": "mrl:carrier-termination", 2281 "carrier-id": "B", 2282 "tx-enabled": true, 2283 "tx-oper-status": on, 2284 "tx-frequency": 10618000, 2285 "duplex-distance": 644000, 2286 "channel-separation": 28, 2287 "polarization": not-specified, 2288 "rtpc": { 2289 "maximum-nominal-power": 20 2290 }, 2291 "single": { 2292 "selected-cm": "qam-512" 2293 } 2294 } 2295 ] 2297 A.3. 2+0 XPIC instance 2299 The following instance shows the XPIC configuration of 2300 Near End node. 2302 "interface": [ 2303 { 2304 "name": "RLT-A", 2305 "description": "Radio Link Terminal A", 2306 "type": "mrl:radio-link-terminal", 2307 "id": "RLT-A", 2308 "mode": "two-plus-zero", 2309 "carrier-terminations": [ 2310 "RLT-A:CT-1", 2311 "RLT-A:CT-2" 2312 ], 2313 "xpic-pairs": [ 2314 "RLT-A:CT-1", 2315 "RLT-A:CT-2" 2316 ], 2317 "tdm-connections": [ 2318 "tdm-type": "E1", 2319 "tdm-connections": "4" 2320 ] 2321 }, 2323 { 2324 "name": "RLT-A:CT-1", 2325 "description": "Carrier Termination 1", 2326 "type": "mrl:carrier-termination", 2327 "carrier-id": "A", 2328 "tx-enabled": true, 2329 "tx-frequency": 10728000, 2330 "duplex-distance": 644000, 2331 "channel-separation": 28, 2332 "polarization": not-specified, 2333 "rtpc": { 2334 "maximum-nominal-power": 20 2335 }, 2336 "single": { 2337 "selected-cm": "qam-512" 2338 } 2339 }, 2341 { 2342 "name": "RLT-A:CT-2", 2343 "description": "Carrier Termination 2", 2344 "type": "mrl:carrier-termination", 2345 "carrier-id": "B", 2346 "tx-enabled": true, 2347 "tx-oper-status": on, 2348 "tx-frequency": 10618000, 2349 "duplex-distance": 644000, 2350 "channel-separation": 28, 2351 "polarization": not-specified, 2352 "rtpc": { 2353 "maximum-nominal-power": 20 2354 }, 2355 "single": { 2356 "selected-cm": "qam-512" 2357 } 2358 } 2359 ] 2361 Appendix B. Contributors 2362 Koji Kawada 2363 NEC Corporation 2364 1753, Shimonumabe Nakahara-ku 2365 Kawasaki, Kanagawa 211-8666 2366 Japan 2368 Email: k-kawada@ah.jp.nec.com 2370 Carlos J. Bernardos 2371 Universidad Carlos III de Madrid 2372 Av. Universidad, 30 2373 Leganes, Madrid 28911 2374 Spain 2376 Email: cjbc@it.uc3m.es 2378 Authors' Addresses 2380 Jonas Ahlberg 2381 Ericsson AB 2382 Lindholmspiren 11 2383 Goteborg 417 56 2384 Sweden 2386 Email: jonas.ahlberg@ericsson.com 2388 Ye Min 2389 Huawei Technologies 2390 No.1899, Xiyuan Avenue 2391 Chengdu 611731 2392 P.R.China 2394 Email: amy.yemin@huawei.com 2396 Xi Li 2397 NEC Laboratories Europe 2398 Kurfursten-Anlage 36 2399 Heidelberg 69115 2400 Germany 2402 Email: Xi.Li@neclab.eu 2403 Daniela Spreafico 2404 Nokia - IT 2405 Via Energy Park, 14 2406 Vimercate (MI) 20871 2407 Italy 2409 Email: daniela.spreafico@nokia.com 2411 Marko Vaupotic 2412 Aviat Networks 2413 Motnica 9 2414 Trzin-Ljubljana 1236 2415 Slovenia 2417 Email: Marko.Vaupotic@Aviatnet.com