idnits 2.17.1 draft-ahlberg-ccamp-microwave-radio-link-01.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 : ---------------------------------------------------------------------------- ** There are 62 instances of too long lines in the document, the longest one being 33 characters in excess of 72. 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 (May 10, 2016) is 2901 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) ** Obsolete normative reference: RFC 7223 (Obsoleted by RFC 8343) -- Obsolete informational reference (is this intentional?): RFC 6536 (Obsoleted by RFC 8341) Summary: 2 errors (**), 0 flaws (~~), 2 warnings (==), 2 comments (--). Run idnits with the --verbose option for more detailed information about the items above. -------------------------------------------------------------------------------- 2 CCAMP J. Ahlberg 3 Internet-Draft J-O. Carlson 4 Intended status: Standards Track H-A. Lund 5 Expires: November 11, 2016 T. Olausson 6 Ericsson AB 7 M. Ye 8 Huawei Technologies Co. 9 M. Vaupotic 10 Aviat Networks 11 May 10, 2016 13 Microwave Radio Link YANG Data Models 14 draft-ahlberg-ccamp-microwave-radio-link-01 16 Abstract 18 YANG model for managing microwave radio link functionality. 20 Status of This Memo 22 This Internet-Draft is submitted in full conformance with the 23 provisions of BCP 78 and BCP 79. 25 Internet-Drafts are working documents of the Internet Engineering 26 Task Force (IETF). Note that other groups may also distribute 27 working documents as Internet-Drafts. The list of current Internet- 28 Drafts is at http://datatracker.ietf.org/drafts/current/. 30 Internet-Drafts are draft documents valid for a maximum of six months 31 and may be updated, replaced, or obsoleted by other documents at any 32 time. It is inappropriate to use Internet-Drafts as reference 33 material or to cite them other than as "work in progress." 35 This Internet-Draft will expire on November 11, 2016. 37 Copyright Notice 39 Copyright (c) 2016 IETF Trust and the persons identified as the 40 document authors. All rights reserved. 42 This document is subject to BCP 78 and the IETF Trust's Legal 43 Provisions Relating to IETF Documents 44 (http://trustee.ietf.org/license-info) in effect on the date of 45 publication of this document. Please review these documents 46 carefully, as they describe your rights and restrictions with respect 47 to this document. Code Components extracted from this document must 48 include Simplified BSD License text as described in Section 4.e of 49 the Trust Legal Provisions and are provided without warranty as 50 described in the Simplified BSD License. 52 Table of Contents 54 1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . 2 55 1.1. Terminology . . . . . . . . . . . . . . . . . . . . . . . 2 56 1.2. Tree Diagrams . . . . . . . . . . . . . . . . . . . . . . 3 57 2. Objectives . . . . . . . . . . . . . . . . . . . . . . . . . 3 58 3. Microwave Model . . . . . . . . . . . . . . . . . . . . . . . 3 59 4. Microwave Module . . . . . . . . . . . . . . . . . . . . . . 6 60 5. Acknowledgements . . . . . . . . . . . . . . . . . . . . . . 41 61 6. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 41 62 7. Security Considerations . . . . . . . . . . . . . . . . . . . 41 63 8. References . . . . . . . . . . . . . . . . . . . . . . . . . 41 64 8.1. Normative References . . . . . . . . . . . . . . . . . . 41 65 8.2. Informative References . . . . . . . . . . . . . . . . . 42 66 Authors' Addresses . . . . . . . . . . . . . . . . . . . . . . . 42 68 1. Introduction 70 The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", 71 "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this 72 document are to be interpreted as described in [RFC2119]. 74 This document is being discussed within the microwave community. 76 This document defines a YANG RFC 6020 [RFC6020] module for managing 77 the radio link functionality of a microwave node. The YANG module is 78 augmenting RFC 7223 [RFC7223] in order to model a microwave link and 79 interface in analogy with most other data links in a router or 80 switch. 82 In summary, the YANG module defined in this internet draft is: 83 microwave-radio-link (should be renamed to something like: if- 84 microwave-radio-link) - Defines the model for basic configuration of 85 a microwave radio link. 87 1.1. Terminology 89 The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", 90 "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this 91 document are to be interpreted as described in RFC 2119 [RFC2119]. 93 Other definitions to clarify.... 95 1.2. Tree Diagrams 97 A simplified graphical representation of the data model is used in 98 this document. The meaning of the symbols in these diagrams is as 99 follows: 101 o Brackets "[" and "]" enclose list keys. 103 o Abbreviations before data node names: "rw" means configuration 104 (read-write), and "ro" means state data (read-only). 106 o Symbols after data node names: "?" means an optional node, "!" 107 means a presence container, and "*" denotes a list or leaf-list. 109 o Parentheses enclose choice and case nodes, and case nodes are also 110 marked with a colon (":"). 112 o Ellipsis ("...") stands for contents of subtrees that are not 113 shown. 115 2. Objectives 117 The aim of of the YANG models contained in this draft is to provide 118 the model that is required to implement the basic radio link 119 management of microwave devices. 121 This model may be augmented by vendor specific YANG modules in order 122 to manage product specific functionality. 124 However, the intention is that it should not be necessary to have any 125 vendor specific extensions to the YANG model defined in this document 126 to implement standard microwave radio link connectivity. 128 3. Microwave Model 130 The microwave radio link model provides the parameters for managing 131 the radio link part of a microwave node. 133 The "microwave-radio-link" YANG module has the following structure: 135 module: microwave-radio-link 136 +--rw radio-link-protection-pairs 137 | +--rw radio-link-protection-pair* [name] 138 | +--rw name string 139 | +--rw protection-switch-mode? enumeration 140 | +--rw revertive-preferred-tx? if:interface-ref 141 | +--rw revertive-wait-to-restore? uint16 142 | +--rw radio-link-protection-members* if:interface-ref 143 +--ro radio-link-protection-pairs-state 144 | +--ro radio-link-protection-pair* [name] 145 | +--ro name string 146 | +--ro protection-status? enumeration 147 | +--ro actual-wait-to-restore? uint16 148 +--rw xpic-pairs {xpic}? 149 | +--rw xpic-pair* [name] 150 | +--rw name string 151 | +--rw enabled? boolean 152 | +--rw xpic-members* if:interface-ref 153 +--rw mimo-groups {mimo}? 154 +--rw mimo-group* [name] 155 +--rw name string 156 +--rw enabled? boolean 157 +--rw mimo-members* if:interface-ref 158 augment /if:interfaces/if:interface: 159 +--rw id? string 160 +--rw mode? identityref 161 +--rw expected-far-end-id? string 162 +--rw far-end-id-check? boolean 163 +--rw carrier-terminations* if:interface-ref 164 +--rw rlp-pairs* -> /radio-link-protection-pairs/radio-link-protection-pair/name 165 +--rw xpic-pairs* -> /xpic-pairs/xpic-pair/name {xpic}? 166 +--rw mimo-group? -> /mimo-groups/mimo-group/name {mimo}? 167 augment /if:interfaces/if:interface: 168 +--rw carrier-id? string 169 +--rw tx-admin-status? enumeration 170 +--rw tx-frequency? uint32 171 +--rw rx-frequency? uint32 172 +--rw duplex-distance? uint32 173 +--rw duplex-config? boolean 174 +--rw polarization? enumeration 175 +--rw power-mode? enumeration 176 +--rw selected-output-power? power 177 +--rw selected-min-output-power? power 178 +--rw selected-max-output-power? power 179 +--rw target-input-power-far-end? power 180 +--rw reference-sec? identityref 181 +--rw coding-modulation-mode? enumeration 182 +--rw selected-cm? identityref 183 +--rw selected-min-acm? identityref 184 +--rw selected-max-acm? identityref 185 +--rw if-loop? boolean 186 +--rw rf-loop? boolean 187 +--rw ct-performance-thresholds 188 +--rw input-power-alarm-threshold? power 189 +--rw output-power-alarm-threshold? power 190 +--rw ber-alarm-threshold? enumeration 191 +--rw rl-1-threshold-level? power 192 +--rw rlts-1-15min-set-alarm-threshold? uint16 193 +--rw rlts-1-15min-reset-alarm-threshold? uint16 194 +--rw rlts-1-24h-set-alarm-threshold? uint32 195 +--rw tl-1-threshold-level? power 196 +--rw tlts-1-15min-set-alarm-threshold? power 197 +--rw tlts-1-15min-reset-alarm-threshold? power 198 +--rw tlts-1-24h-set-alarm-threshold? uint32 199 +--rw es-15min-set-alarm-threshold? uint16 200 +--rw es-15min-reset-alarm-threshold? uint16 201 +--rw es-24h-set-alarm-threshold? uint32 202 +--rw ses-15min-set-alarm-threshold? uint16 203 +--rw ses-15min-reset-alarm-threshold? uint16 204 +--rw ses-24h-set-alarm-threshold? uint32 205 +--rw bbe-15min-set-alarm-threshold? uint32 206 +--rw bbe-15min-reset-alarm-threshold? uint32 207 +--rw bbe-24h-set-alarm-threshold? uint32 208 +--rw acm-15min-set-alarm-threshold? uint16 209 +--rw acm-15min-reset-alarm-threshold? uint16 210 +--rw acm-24h-set-alarm-threshold? uint32 211 augment /if:interfaces-state/if:interface: 212 +--ro tx-oper-status? enumeration 213 +--ro actual-ouput-power? power 214 +--ro actual-input-power? power 215 +--ro actual-tx-cm? identityref 216 +--ro actual-rx-cm? identityref 217 +--ro selected-min-speed? yang:gauge64 218 +--ro selected-max-speed? yang:gauge64 219 +--ro xpic-status? enumeration {xpic}? 220 +--ro mimo-status? enumeration {mimo}? 221 +--ro actual-snir? decimal64 222 +--ro actual-xpi? decimal64 {xpic}? 223 +--ro actual-si? decimal64 {mimo}? 224 +--ro capabilities 225 +--ro min-tx-frequency? uint32 226 +--ro max-tx-frequency? uint32 227 +--ro min-rx-frequency? uint32 228 +--ro max-rx-frequency? uint32 229 +--ro duplex-type? enumeration 230 +--ro channel-separation? decimal64 231 +--ro available-min-output-power? power 232 +--ro available-max-output-power? power 233 +--ro available-min-acm? identityref 234 +--ro available-max-acm? identityref 235 +--ro available-min-speed? yang:gauge64 236 +--ro available-max-speed? yang:gauge64 237 augment /if:interfaces-state/if:interface/if:statistics: 238 +--ro min-rltm? power 239 +--ro max-rltm? power 240 +--ro min-tltm? power 241 +--ro max-tltm? power 242 augment /if:interfaces-state/if:interface/if:statistics: 243 +--ro bbe? yang:counter32 244 +--ro es? yang:counter32 245 +--ro ses? yang:counter32 246 +--ro uas? yang:counter32 247 +--ro bber? decimal64 248 +--ro esr? decimal64 249 +--ro sesr? decimal64 251 4. Microwave Module 253 This YANG module augments the interfaces defined in RFC 7223 254 [RFC7223]. 256 file "microwave-radio-link.yang" 257 module microwave-radio-link { 258 namespace "urn:ietf:params:xml:ns:yang:microwave-radio-link"; 259 prefix mrl; 261 import ietf-yang-types { 262 prefix yang; 263 } 264 import ietf-interfaces { 265 prefix if; 266 } 267 import iana-if-type { 268 prefix ianaift; 269 } 271 organization 272 "IETF CCAMP Working Group"; 273 contact 274 "jonas.ahlberg@ericsson.com 275 amy.yemin@huawei.com 276 jan-olof.carlson@ericsson.com 277 Marko.Vaupotic@Aviatnet.com 278 thomas.olausson@ericsson.com"; 280 description 281 "This is a module for the entities in 282 a generic microwave system."; 284 revision 2016-05-10 { 285 description 286 "Draft revision."; 287 reference ""; 288 } 290 revision 2016-05-10 { 291 description 292 "2nd draft revision."; 293 reference ""; 294 } 295 revision 2016-03-11 { 296 description 297 "Draft revision."; 298 reference ""; 299 } 301 /* 302 * Features 303 */ 305 feature xpic { 306 description 307 "Indicates that the device supports XPIC."; 308 } 310 feature mimo { 311 description 312 "Indicates that the device supports MIMO."; 313 } 315 /* 316 * Interface identities 317 */ 319 identity radio-link-terminal { 320 base ianaift:iana-interface-type; 321 description 322 "Interface identity for a radio link terminal."; 323 } 325 identity carrier-termination { 326 base ianaift:iana-interface-type; 327 description 328 "Interface identity for a carrier termination."; 329 } 331 /* 332 * Radio-link-terminal mode identities 333 */ 335 identity rlt-mode { 336 description 337 "A description of the mode in which the radio link 338 terminal is configured. The format is X plus Y. 339 X represent the number of bonded carrier terminations. 340 Y represent the number of protecting carrier 341 terminations."; 342 } 344 identity one-plus-zero { 345 base rlt-mode; 346 description 347 "1 carrier termination only."; 348 } 350 identity one-plus-one { 351 base rlt-mode; 352 description 353 "1 carrier termination 354 and 1 protecting carrier termination."; 355 } 357 identity two-plus-zero { 358 base rlt-mode; 359 description 360 "2 bonded carrier terminations."; 361 } 363 identity two-plus-one { 364 base rlt-mode; 365 description 366 "2 bonded carrier terminations and 367 one protecting carrier termination."; 368 } 370 /* 371 * Coding and modulation identities 372 */ 374 identity coding-modulation { 375 description 376 "The coding and modulation schemes."; 377 } 379 identity half-bpsk-strong { 380 base coding-modulation; 381 description 382 "Half BPSK strong coding and modulation scheme."; 384 } 386 identity half-bpsk { 387 base coding-modulation; 388 description 389 "Half BPSK coding and modulation scheme."; 390 } 392 identity half-bpsk-light { 393 base coding-modulation; 394 description 395 "Half BPSK light coding and modulation scheme."; 396 } 398 identity bpsk-strong { 399 base coding-modulation; 400 description 401 "BPSK strong coding and modulation scheme."; 402 } 404 identity bpsk { 405 base coding-modulation; 406 description 407 "BPSK coding and modulation scheme."; 408 } 410 identity bpsk-light { 411 base coding-modulation; 412 description 413 "BPSK light coding and modulation scheme."; 414 } 416 identity qpsk { 417 base coding-modulation; 418 description 419 "QPSK coding and modulation scheme."; 420 } 422 identity qam-4-strong { 423 base coding-modulation; 424 description 425 "4 QAM strong coding and modulation scheme."; 426 } 428 identity qam-4 { 429 base coding-modulation; 430 description 431 "4 QAM coding and modulation scheme."; 433 } 435 identity qam-4-light { 436 base coding-modulation; 437 description 438 "4 QAM light coding and modulation scheme."; 439 } 441 identity qam-16-strong { 442 base coding-modulation; 443 description 444 "16 QAM strong coding and modulation scheme."; 445 } 447 identity qam-16 { 448 base coding-modulation; 449 description 450 "16 QAM coding and modulation scheme."; 451 } 453 identity qam-16-light { 454 base coding-modulation; 455 description 456 "16 QAM light coding and modulation scheme."; 457 } 459 identity qam-32-strong { 460 base coding-modulation; 461 description 462 "32 QAM strong coding and modulation scheme."; 463 } 465 identity qam-32 { 466 base coding-modulation; 467 description 468 "32 QAM coding and modulation scheme."; 469 } 471 identity qam-32-light { 472 base coding-modulation; 473 description 474 "32 QAM light coding and modulation scheme."; 475 } 477 identity qam-64-strong { 478 base coding-modulation; 479 description 480 "64 QAM strong coding and modulation scheme."; 482 } 484 identity qam-64 { 485 base coding-modulation; 486 description 487 "64 QAM coding and modulation scheme."; 488 } 490 identity qam-64-light { 491 base coding-modulation; 492 description 493 "64 QAM light coding and modulation scheme."; 494 } 496 identity qam-128-strong { 497 base coding-modulation; 498 description 499 "128 QAM strong coding and modulation scheme."; 500 } 502 identity qam-128 { 503 base coding-modulation; 504 description 505 "128 QAM coding and modulation scheme."; 506 } 508 identity qam-128-light { 509 base coding-modulation; 510 description 511 "128 QAM light coding and modulation scheme."; 512 } 514 identity qam-256-strong { 515 base coding-modulation; 516 description 517 "256 QAM strong coding and modulation scheme."; 518 } 520 identity qam-256 { 521 base coding-modulation; 522 description 523 "256 QAM coding and modulation scheme."; 524 } 526 identity qam-256-light { 527 base coding-modulation; 528 description 529 "256 QAM light coding and modulation scheme."; 531 } 533 identity qam-512-strong { 534 base coding-modulation; 535 description 536 "512 QAM strong coding and modulation scheme."; 537 } 539 identity qam-512 { 540 base coding-modulation; 541 description 542 "512 QAM coding and modulation scheme."; 543 } 545 identity qam-512-light { 546 base coding-modulation; 547 description 548 "512 QAM light coding and modulation scheme."; 549 } 551 identity qam-1024-strong { 552 base coding-modulation; 553 description 554 "1024 QAM strong coding and modulation scheme."; 555 } 557 identity qam-1024 { 558 base coding-modulation; 559 description 560 "1024 QAM coding and modulation scheme."; 561 } 563 identity qam-1024-light { 564 base coding-modulation; 565 description 566 "1024 QAM light coding and modulation scheme."; 567 } 569 identity qam-2048-strong { 570 base coding-modulation; 571 description 572 "2048 QAM strong coding and modulation scheme."; 573 } 575 identity qam-2048 { 576 base coding-modulation; 577 description 578 "2048 QAM coding and modulation scheme."; 580 } 582 identity qam-2048-light { 583 base coding-modulation; 584 description 585 "2048 QAM light coding and modulation scheme."; 586 } 588 identity qam-4096-strong { 589 base coding-modulation; 590 description 591 "4096 QAM strong coding and modulation scheme."; 592 } 594 identity qam-4096 { 595 base coding-modulation; 596 description 597 "4096 QAM coding and modulation scheme."; 598 } 600 identity qam-4096-light { 601 base coding-modulation; 602 description 603 "4096 QAM light coding and modulation scheme."; 604 } 606 /* 607 * Spectrum Efficiency Class identities 608 */ 610 identity spectrum-efficiency-class { 611 description 612 "Spectrum Efficiency Class (SEC)."; 613 } 615 identity class-1 { 616 base spectrum-efficiency-class; 617 description 618 "Spectrum Efficiency Class 1."; 619 } 621 identity class-2 { 622 base spectrum-efficiency-class; 623 description 624 "Spectrum Efficiency Class 2."; 625 } 627 identity class-3 { 628 base spectrum-efficiency-class; 629 description 630 "Spectrum Efficiency Class 3."; 631 } 633 identity class-4l { 634 base spectrum-efficiency-class; 635 description 636 "Spectrum Efficiency Class 4l."; 637 } 639 identity class-4h { 640 base spectrum-efficiency-class; 641 description 642 "Spectrum Efficiency Class 4h."; 643 } 645 identity class-5l { 646 base spectrum-efficiency-class; 647 description 648 "Spectrum Efficiency Class 5l."; 649 } 651 identity class-5la { 652 base spectrum-efficiency-class; 653 description 654 "Spectrum Efficiency Class 5la."; 655 } 657 identity class-5lb { 658 base spectrum-efficiency-class; 659 description 660 "Spectrum Efficiency Class 5lb."; 661 } 663 identity class-5h { 664 base spectrum-efficiency-class; 665 description 666 "Spectrum Efficiency Class 5h."; 667 } 669 identity class-5ha { 670 base spectrum-efficiency-class; 671 description 672 "Spectrum Efficiency Class 5ha."; 673 } 675 identity class-5hb { 676 base spectrum-efficiency-class; 677 description 678 "Spectrum Efficiency Class 5hb."; 679 } 681 identity class-6l { 682 base spectrum-efficiency-class; 683 description 684 "Spectrum Efficiency Class 6l."; 685 } 687 identity class-6la { 688 base spectrum-efficiency-class; 689 description 690 "Spectrum Efficiency Class 6la."; 691 } 693 identity class-6lb { 694 base spectrum-efficiency-class; 695 description 696 "Spectrum Efficiency Class 6lb."; 697 } 699 identity class-6h { 700 base spectrum-efficiency-class; 701 description 702 "Spectrum Efficiency Class 6h."; 703 } 705 identity class-6ha { 706 base spectrum-efficiency-class; 707 description 708 "Spectrum Efficiency Class 6ha."; 709 } 711 identity class-6hb { 712 base spectrum-efficiency-class; 713 description 714 "Spectrum Efficiency Class 6hb."; 715 } 717 identity class-7 { 718 base spectrum-efficiency-class; 719 description 720 "Spectrum Efficiency Class 7."; 721 } 723 identity class-7a { 724 base spectrum-efficiency-class; 725 description 726 "Spectrum Efficiency Class 7a."; 727 } 729 identity class-7b { 730 base spectrum-efficiency-class; 731 description 732 "Spectrum Efficiency Class 7b."; 733 } 735 identity class-8 { 736 base spectrum-efficiency-class; 737 description 738 "Spectrum Efficiency Class 8."; 739 } 741 identity class-8a { 742 base spectrum-efficiency-class; 743 description 744 "Spectrum Efficiency Class 8a."; 745 } 747 identity class-8b { 748 base spectrum-efficiency-class; 749 description 750 "Spectrum Efficiency Class 8b."; 751 } 753 /* 754 * Typedefs 755 */ 757 typedef power { 758 type decimal64 { 759 fraction-digits 1; 760 } 761 description 762 "Type used for power values, selected and measured."; 763 } 765 /* 766 * G.826 stats grouping 767 */ 768 grouping g826-stats { 770 description 771 "G.826 statistics operational data "; 772 leaf bbe { 773 type yang:counter32; 774 units "number of block errors"; 775 description 776 "Number of Background Block Errors (BBE) during the 777 interval. A BBE is an errored block not occurring as 778 part of an SES."; 779 } 781 leaf es { 782 type yang:counter32; 783 units "seconds"; 784 description 785 "Number of Errored Seconds (ES) since last reset. 786 An ES is a one-second period with one or more errored 787 blocks or at least one defect."; 788 } 790 leaf ses { 791 type yang:counter32; 792 units "seconds"; 793 description 794 "Number of Severely Errored Seconds (SES) during the 795 interval. SES is a one-second period which contains 796 equal or more than 30% errored blocks or at least 797 one defect. SES is a subset of ES."; 798 } 800 leaf uas { 801 type yang:counter32; 802 units "seconds"; 803 description 804 "Number of Unavailable Seconds (UAS), that is, the 805 total time that the node has been unavailable during 806 a fixed measurement interval."; 807 } 809 leaf bber { 810 type decimal64 { 811 fraction-digits 18; 812 } 813 units "ratio"; 814 description 815 "Background Block Error (BBER) ratio, that is, the 816 ratio of errored blocks to total blocks during a fixed 817 measurement interval. BBER does not include any blocks 818 during SES and Unavailable Time."; 819 } 820 leaf esr { 821 type decimal64 { 822 fraction-digits 18; 823 } 824 units "ratio"; 825 description 826 "Errored Seconds (ESR) ratio, that is, the ratio of 827 Errored Seconds to Available Time during a fixed 828 measurement interval."; 829 } 831 leaf sesr { 832 type decimal64 { 833 fraction-digits 18; 834 } 835 units "ratio"; 836 description 837 "Severely Errored Seconds Ratio (SESR), that is, the 838 ratio of SES to total seconds in Available Time during 839 a fixed measurement interval."; 840 } 841 } 843 /* 844 * Radio Link Terminal (RLT) - Configuration data nodes 845 */ 847 augment "/if:interfaces/if:interface" { 848 when "if:type = 'mrl:radio-link-terminal'"; 849 description 850 "Addition of data nodes for radio link terminal to 851 the standard Interface data model, for interfaces of 852 the type 'radio-link-terminal'."; 853 leaf id { 854 type string; 855 default ""; 856 description 857 "ID of the radio link terminal. Used by far-end when 858 checking that it's connected to the correct RLT."; 859 } 860 leaf mode { 861 type identityref { 862 base rlt-mode; 863 } 864 default "one-plus-zero"; 865 description 866 "A description of the mode in which the radio link 867 terminal is configured. The format is X plus Y. 869 X represent the number of bonded carrier terminations. 870 Y represent the number of protecting carrier 871 terminations."; 872 } 873 leaf expected-far-end-id { 874 type string; 875 default ""; 876 description 877 "Expected ID of the radio link terminal at far-end."; 878 } 879 leaf far-end-id-check { 880 type boolean; 881 default "false"; 882 description 883 "Enable(true)/disable(false) check of the ID of the 884 radio link terminal at far-end. When true, the system 885 verifies that far-end radio link terminal ID is equal to 886 the expected. If ok then the radio link terminal status 887 is UP. If not ok, then the status is stated as DOWN."; 888 } 889 leaf-list carrier-terminations { 890 type if:interface-ref; 891 must "/if:interfaces/if:interface[if:name = current()]" 892 + "/if:type = 'carrier-termination'" { 893 description 894 "The type of interface must be 895 'carrier-termination'."; 896 } 897 description 898 "A list of references to carrier terminations 899 included in the radio link terminal."; 900 } 901 leaf-list rlp-pairs { 902 type leafref { 903 path "/mrl:radio-link-protection-pairs/" 904 + "mrl:radio-link-protection-pair/mrl:name"; 905 } 906 description 907 "A list of references to the carrier termination 908 pairs configured for radio link protection in this 909 radio link terminal."; 910 } 911 leaf-list xpic-pairs { 912 if-feature xpic; 913 type leafref { 914 path "/mrl:xpic-pairs/mrl:xpic-pair/mrl:name"; 915 } 916 description 917 "A list of references to the XPIC pairs used in this 918 radio link terminal. One pair can be used by two 919 terminals."; 920 } 921 leaf mimo-group { 922 if-feature mimo; 923 type leafref { 924 path "/mrl:mimo-groups/mrl:mimo-group/mrl:name"; 925 } 926 description 927 "A reference to the MIMO group used in this 928 radio link terminal. One group can be used by more 929 than one terminal."; 930 } 931 } 933 /* 934 * Carrier Termination - Configuration data nodes 935 */ 937 augment "/if:interfaces/if:interface" { 938 when "if:type = 'mrl:carrier-termination'"; 939 description 940 "Addition of data nodes for carrier termination to the 941 standard Interface data model, for interfaces of the type 942 'carrier-termination'."; 943 leaf carrier-id { 944 type string; 945 default "A"; 946 description 947 "ID of the carrier. (e.g. A, B, C or D) 948 Used in XPIC & MIMO configurations to check that the 949 carrier termination is connected to the correct far-end 950 carrier termination. Should be the same carrier ID on 951 both sides of the hop. 952 Defaulted when not MIMO or XPIC."; 953 } 955 leaf tx-admin-status { 956 type enumeration { 957 enum "off" { 958 description "Transmitter is disabled."; 959 } 960 enum "on" { 961 description "Transmitter is enabled."; 962 } 963 } 964 description 965 "The adminstrative status of the transmitter. 966 Disables (off) or enables (on) the transmitter. 967 Only applicable when the interface is enabled 968 (interface:enabled = true) otherwise it's always 969 disabled."; 970 } 971 leaf tx-frequency { 972 type uint32; 973 units "kHz"; 974 default "0"; 975 description 976 "Selected transmitter frequency."; 977 } 978 leaf rx-frequency { 979 type uint32; 980 units "kHz"; 981 default "0"; 982 description 983 "Selected receiver frequency. 984 Only writeable when duplex-config=disabled and 985 duplex-type=variable."; 986 } 987 leaf duplex-distance { 988 type uint32; 989 units "kHz"; 990 default "0"; 991 description 992 "Distance between Tx & Rx frequencies. 993 Only writeable when duplex-config=true and 994 duplex-type=variable."; 995 } 996 leaf duplex-config { 997 type boolean; 998 default "false"; 999 description 1000 "Enable (true) or disable (false) configuration of 1001 rxFrequency using a defined duplex distance."; 1002 } 1003 leaf polarization { 1004 type enumeration { 1005 enum "horizontal" { 1006 description "Horizontal polarization."; 1007 } 1008 enum "vertical" { 1009 description "Vertical polarization."; 1010 } 1011 enum "not-specified" { 1012 description "Polarization not specified."; 1014 } 1015 } 1016 default "not-specified"; 1017 description 1018 "Polarization - A textual description for info only."; 1019 } 1021 leaf power-mode { 1022 type enumeration { 1023 enum rtpc { 1024 description "Remote Transmit Power Control (RTPC)."; 1025 } 1026 enum atpc { 1027 description "Automatic Transmit Power Control (ATPC)."; 1028 } 1029 } 1030 description 1031 "A choice of Remote Transmit Power Control (RTPC) 1032 or Automatic Transmit Power Control (ATPC)."; 1033 } 1035 leaf selected-output-power { 1036 when "../power-mode = 'rtpc'"; 1037 type power { 1038 range "-99..40"; 1039 } 1040 units "dBm"; 1041 description 1042 "Selected output power in RTPC mode."; 1043 } 1045 leaf selected-min-output-power { 1046 when "../power-mode = 'atpc'"; 1047 type power { 1048 range "-99..40"; 1049 } 1050 units "dBm"; 1051 description 1052 "Selected minimum output power in 1053 ATPC mode."; 1054 } 1055 leaf selected-max-output-power { 1056 when "../power-mode = 'atpc'"; 1057 type power { 1058 range "-99..40"; 1059 } 1060 units "dBm"; 1061 description 1062 "Selected maximum output power in 1063 ATPC mode."; 1064 } 1065 leaf target-input-power-far-end { 1066 when "../power-mode = 'atpc'"; 1067 type power { 1068 range "-99..-30"; 1069 } 1070 units "dBm"; 1071 description 1072 "The wanted received input power at far-end, 1073 when running ATPC."; 1074 } 1076 leaf reference-sec { 1077 type identityref { 1078 base spectrum-efficiency-class; 1079 } 1080 description 1081 "Each modulation is compliant to a Spectrum Efficiency 1082 Class (SEC). When running Adaptive Coding/Modulation, 1083 one SEC has to be selected for all the coding/ 1084 modulations between selected-min-acm and 1085 selected-max-acm. This parameter is called Reference 1086 SEC. This setting might affect 1087 available-max-output-power, in order to fulfill 1088 spectrum requirements."; 1089 } 1091 leaf coding-modulation-mode { 1092 type enumeration { 1093 enum fixed { 1094 description "Fixed coding/modulation."; 1095 } 1096 enum adaptive { 1097 description "Adaptive coding/modulation."; 1098 } 1099 } 1100 description 1101 "A selection of fixed or 1102 adaptive coding/modulation mode."; 1103 } 1105 leaf selected-cm { 1106 when "../coding-modulation-mode = 'fixed'"; 1107 type identityref { 1108 base coding-modulation; 1109 } 1110 description 1111 "Selected fixed coding/modulation."; 1112 } 1114 leaf selected-min-acm { 1115 when "../coding-modulation-mode = 'adaptive'"; 1116 type identityref { 1117 base coding-modulation; 1118 } 1119 description 1120 "Selected minimum coding/modulation. 1121 Adaptive coding/modulation shall not go 1122 below this value."; 1123 } 1125 leaf selected-max-acm { 1126 when "../coding-modulation-mode = 'adaptive'"; 1127 type identityref { 1128 base coding-modulation; 1129 } 1130 description 1131 "Selected maximum coding/modulation. 1132 Adaptive coding/modulation shall not go 1133 above this value."; 1134 } 1136 leaf if-loop { 1137 type boolean; 1138 default "false"; 1139 description 1140 "Enable (true) or disable (false) the IF loop, 1141 which loops the signal back to the client side 1142 (not the radio side)."; 1143 } 1144 leaf rf-loop { 1145 type boolean; 1146 default "false"; 1147 description 1148 "Enable (true) or disable (false) the RF loop, 1149 which loops the signal back to the client side 1150 (not the radio side)."; 1151 } 1152 container ct-performance-thresholds { 1153 description 1154 "Specification of thresholds for when alarms should 1155 be sent and cleared for various performance counters."; 1156 leaf input-power-alarm-threshold { 1157 type power { 1158 range "-99..-30"; 1159 } 1160 units "dBm"; 1161 default "-93"; 1162 description 1163 "Specification of at which input power an alarm should 1164 be raised."; 1165 } 1166 leaf output-power-alarm-threshold { 1167 type power { 1168 range "-99..40"; 1169 } 1170 units "dBm"; 1171 description 1172 "An alarm is sent when the actual output power is 1173 below the specified threshold."; 1174 } 1175 leaf ber-alarm-threshold { 1176 type enumeration { 1177 enum "10e-9" { 1178 description "Threshold at 10e-9."; 1179 } 1180 enum "10e-8" { 1181 description "Threshold at 10e-8."; 1182 } 1183 enum "10e-7" { 1184 description "Threshold at 10e-7."; 1185 } 1186 enum "10e-6" { 1187 description "Threshold at 10e-6."; 1188 } 1189 enum "10e-5" { 1190 description "Threshold at 10e-5."; 1191 } 1192 enum "10e-4" { 1193 description "Threshold at 10e-4."; 1194 } 1195 enum "10e-3" { 1196 description "Threshold at 10e-3."; 1197 } 1198 enum "10e-2" { 1199 description "Threshold at 10e-2."; 1200 } 1201 enum "10e-1" { 1202 description "Threshold at 10e-1."; 1203 } 1204 } 1205 default "10e-6"; 1206 description 1207 "Specification of at which BER an alarm should 1208 be raised."; 1209 } 1210 leaf rl-1-threshold-level { 1211 type power { 1212 range "-99..40"; 1213 } 1214 units "dBm"; 1215 description 1216 "Specifies the threshold level for Received Level 1. 1217 When the received level (input power) is below this 1218 level the Received Level Threshold Seconds 1 (RLTS1) 1219 is counted."; 1220 } 1221 leaf rlts-1-15min-set-alarm-threshold { 1222 type uint16 { 1223 range "1..900"; 1224 } 1225 units "seconds"; 1226 description 1227 "Specifies the threshold value in seconds for RLTS1. 1228 An alarm is send as soon as the received level has 1229 been below the Received Level 1 threshold for the 1230 number of seconds configured in this threshold 1231 during a 15 minutes interval."; 1232 } 1233 leaf rlts-1-15min-reset-alarm-threshold { 1234 type uint16 { 1235 range "1..900"; 1236 } 1237 units "seconds"; 1238 description 1239 "Specifies the threshold value in seconds for RLTS1. 1240 An alarm clearing is sent when the received level 1241 has been below the RLTS1 threshold less seconds than 1242 indicated by this threshold for a 15 minutes 1243 interval."; 1244 } 1245 leaf rlts-1-24h-set-alarm-threshold { 1246 type uint32 { 1247 range "1..86400"; 1248 } 1249 units "seconds"; 1250 description 1251 "Specifies the threshold value in seconds for RLTS1. 1252 An alarm is send as soon as the received level has 1253 been below the Received Level 1 threshold for the 1254 number of seconds configured in this threshold 1255 during a 24 hours interval. 1256 The alarm is cleared after the next 24 hours if 1257 the threshold is not crossed."; 1258 } 1259 leaf tl-1-threshold-level { 1260 type power { 1261 range "-100..35"; 1262 } 1263 units "dBm"; 1264 description 1265 "Specifies the threshold level for Transmitted 1266 Level 1. When the transmitted level (output power) 1267 is above this level the Transmitted Level Threshold 1268 Seconds 1 (TLTS1) is counted."; 1269 } 1270 leaf tlts-1-15min-set-alarm-threshold { 1271 type power { 1272 range "1..900"; 1273 } 1274 units "seconds"; 1275 description 1276 "Specifies the threshold value in seconds for TLTS1. 1277 An alarm is send as soon as the transmitted level 1278 has been above the Transmitted Level 1 threshold 1279 for the number of seconds configured in this 1280 threshold during a 15 minutes interval."; 1281 } 1282 leaf tlts-1-15min-reset-alarm-threshold { 1283 type power { 1284 range "1..900"; 1285 } 1286 units "seconds"; 1287 description 1288 "Specifies the threshold value in seconds for TLTS1. 1289 An alarm clearing is sent when the transmitted level 1290 has been above the TLTS1 threshold less seconds than 1291 indicated by this threshold for a 15 minutes 1292 interval."; 1293 } 1294 leaf tlts-1-24h-set-alarm-threshold { 1295 type uint32 { 1296 range "1..86400"; 1297 } 1298 units "seconds"; 1299 description 1300 "Specifies the threshold value in seconds for TLTS1. 1301 An alarm is send as soon as the transmitted level 1302 has been above the Transmitted Level 1 threshold for 1303 the number of seconds configured in this threshold 1304 during a 24 hours interval. 1305 The alarm is cleared after the next 24 hours if 1306 the threshold is not crossed."; 1307 } 1308 leaf es-15min-set-alarm-threshold { 1309 type uint16 { 1310 range "1..900"; 1311 } 1312 units "seconds"; 1313 description 1314 "An alarm is sent when the number of Errored Seconds 1315 (es) exceeds the specified threshold in a 1316 15 minutes interval."; 1317 } 1318 leaf es-15min-reset-alarm-threshold { 1319 type uint16 { 1320 range "1..900"; 1321 } 1322 units "seconds"; 1323 description 1324 "An alarm clearing is sent when the the number of 1325 Errored Seconds (es) has been below the specified 1326 threshold in a 15 minutes interval."; 1327 } 1328 leaf es-24h-set-alarm-threshold { 1329 type uint32 { 1330 range "1..86400"; 1331 } 1332 units "seconds"; 1333 description 1334 "An alarm is sent when the number of Errored Seconds 1335 (es) exceeds the specified threshold in a 1336 24 hours interval. 1337 The alarm is cleared after the next 24 hours if 1338 the threshold is not crossed."; 1339 } 1340 leaf ses-15min-set-alarm-threshold { 1341 type uint16 { 1342 range "1..900"; 1343 } 1344 units "seconds"; 1345 description 1346 "An alarm is sent when the number of Severely 1347 Errored Seconds (ses) exceeds the specified 1348 threshold in a 15 minutes interval."; 1349 } 1350 leaf ses-15min-reset-alarm-threshold { 1351 type uint16 { 1352 range "1..900"; 1353 } 1354 units "seconds"; 1355 description 1356 "An alarm clearing is sent when the the number of 1357 Severely Errored Seconds (ses) has been below the 1358 specified threshold in a 15 minutes interval."; 1359 } 1360 leaf ses-24h-set-alarm-threshold { 1361 type uint32 { 1362 range "1..86400"; 1363 } 1364 units "seconds"; 1365 description 1366 "An alarm is sent when the number of Severely 1367 Errored Seconds (ses) exceeds the specified 1368 threshold in a 24 hours interval. 1369 The alarm is cleared after the next 24 hours if 1370 the threshold is not crossed."; 1371 } 1372 leaf bbe-15min-set-alarm-threshold { 1373 type uint32; 1374 units "number of block errors"; 1375 description 1376 "An alarm is sent when the number of Background 1377 Block Errors (bbe) exceeds the specified threshold 1378 in a 15 minutes interval."; 1379 } 1380 leaf bbe-15min-reset-alarm-threshold { 1381 type uint32; 1382 units "number of block errors"; 1383 description 1384 "An alarm clearing is sent when the the number of 1385 Background Block Errors (bbe) has been below the 1386 specified threshold in a 15 minutes interval."; 1387 } 1388 leaf bbe-24h-set-alarm-threshold { 1389 type uint32; 1390 units "number of block errors"; 1391 description 1392 "An alarm is sent when the number of Background 1393 Block Errors (bbe) exceeds the specified threshold 1394 in a 24 hours interval. 1395 The alarm is cleared after the next 24 hours if 1396 the threshold is not crossed."; 1397 } 1398 leaf acm-15min-set-alarm-threshold { 1399 type uint16 { 1400 range "1..900"; 1401 } 1402 units "seconds"; 1403 description 1404 "An alarm is sent when time in minimum coding & 1405 modulation (selected-min-acm) exceeds the specified 1406 threshold in a 15 minutes interval."; 1407 } 1408 leaf acm-15min-reset-alarm-threshold { 1409 type uint16 { 1410 range "1..900"; 1411 } 1412 units "seconds"; 1413 description 1414 "An alarm clearing is sent when the the time in 1415 minimum coding & modulation (selected-min-acm) 1416 has been below the specified threshold in a 15 minutes 1417 interval."; 1418 } 1419 leaf acm-24h-set-alarm-threshold { 1420 type uint32 { 1421 range "1..86400"; 1422 } 1423 units "seconds"; 1424 description 1425 "An alarm is sent when time in minimum coding & 1426 modulation (selected-min-acm) exceeds the specified 1427 threshold in a 24 hours interval. 1428 The alarm is cleared after the next 24 hours if 1429 the threshold is not crossed."; 1430 } 1431 } 1432 } 1434 /* 1435 * Carrier Termination - Operational state data nodes 1436 */ 1438 augment "/if:interfaces-state/if:interface" { 1439 when "if:type = 'mrl:carrier-termination'"; 1440 description 1441 "Addition of state data nodes for carrier termination to 1442 the standard Interface state data model, for interfaces of 1443 the type 'carrier-termination'."; 1444 leaf tx-oper-status { 1445 type enumeration { 1446 enum "off" { 1447 description "Transmitter is off."; 1448 } 1449 enum "on" { 1450 description "Transmitter is on."; 1451 } 1452 enum "standby" { 1453 description "Transmitter is in standby."; 1454 } 1455 } 1456 description 1457 "Shows the operative status of the transmitter."; 1458 } 1459 leaf actual-ouput-power { 1460 type power { 1461 range "-99..40"; 1462 } 1463 units "dBm"; 1464 description 1465 "Actual transmitted output power (0.1 dBm resolution)."; 1466 } 1467 leaf actual-input-power { 1468 type power { 1469 range "-99..-20"; 1470 } 1471 units "dBm"; 1472 description 1473 "Actual input power (0.1 dBm resolution)."; 1474 } 1475 leaf actual-tx-cm { 1476 type identityref { 1477 base coding-modulation; 1478 } 1479 description 1480 "Actual coding/modulation in transmitting direction."; 1481 } 1482 leaf actual-rx-cm { 1483 type identityref { 1484 base coding-modulation; 1485 } 1486 description 1487 "Actual coding/modulation in receiving direction."; 1488 } 1489 leaf selected-min-speed { 1490 type yang:gauge64; 1491 units "bit/s"; 1492 description 1493 "Selected minimum speed, derived from selected-min-acm 1494 (adaptive) or selected-cm (fixed)."; 1495 } 1496 leaf selected-max-speed { 1497 type yang:gauge64; 1498 units "bit/s"; 1499 description 1500 "Selected maximum speed, derived from selected-max-acm 1501 (adaptive) or selected-cm (fixed)."; 1502 } 1503 leaf xpic-status { 1504 if-feature xpic; 1505 type enumeration { 1506 enum "locked" { 1507 description "XPIC status is locked."; 1508 } 1509 enum "unlocked" { 1510 description "XPIC status is unlocked."; 1511 } 1512 enum "na" { 1513 description "XPIC status is not applicable."; 1514 } 1515 } 1516 description 1517 "Status of the XPIC. Only valid if XPIC is enabled."; 1518 } 1519 leaf mimo-status { 1520 if-feature mimo; 1521 type enumeration { 1522 enum "locked" { 1523 description "MIMO status is locked."; 1524 } 1525 enum "unlocked" { 1526 description "MIMO status is unlocked."; 1527 } 1528 enum "na" { 1529 description "MIMO status is not applicable."; 1530 } 1531 } 1532 description 1533 "Status of the MIMO. Only valid if MIMO is enabled."; 1534 } 1535 leaf actual-snir { 1536 type decimal64 { 1537 fraction-digits 1; 1538 range "0..99"; 1539 } 1540 units "dB"; 1541 description 1542 "Actual signal to noise plus interference ratio. 1543 (0.1 dB resolution)."; 1544 } 1545 leaf actual-xpi { 1546 if-feature xpic; 1547 type decimal64 { 1548 fraction-digits 1; 1549 range "0..99"; 1550 } 1551 units "dBc"; 1552 description 1553 "The actual carrier to cross-polar interference. 1554 Only valid if XPIC is enabled. (0.1 dBc resolution)."; 1555 } 1556 leaf actual-si { 1557 if-feature mimo; 1558 type decimal64 { 1559 fraction-digits 1; 1560 range "-99..99"; 1561 } 1562 units "dBc"; 1563 description 1564 "Actual MIMO Spatial Interference. 1565 Only valid if MIMO is enabled. (0.1 dBc resolution)."; 1566 } 1567 container capabilities { 1568 description 1569 "Capabilities of the the installed equipment and 1570 some selected configurations."; 1571 leaf min-tx-frequency { 1572 type uint32; 1573 units "kHz"; 1574 description 1575 "Minimum Tx frequency possible to use."; 1576 } 1577 leaf max-tx-frequency { 1578 type uint32; 1579 units "kHz"; 1580 description 1581 "Maximum Tx frequency possible to use."; 1582 } 1583 leaf min-rx-frequency { 1584 type uint32; 1585 units "kHz"; 1586 description 1587 "Minimum Rx frequency possible to use."; 1588 } 1589 leaf max-rx-frequency { 1590 type uint32; 1591 units "kHz"; 1592 description 1593 "Maximum Tx frequency possible to use."; 1594 } 1595 leaf duplex-type { 1596 type enumeration { 1597 enum "fixed" { 1598 description "Duplex distance is fixed."; 1599 } 1600 enum "variable" { 1601 description "Duplex distance is variable."; 1602 } 1603 } 1604 description 1605 "The duplex type is given by the equipment used. 1606 It can be a fixed duplex distance or a variable 1607 distance which can be configured by selecting 1608 rx-frequency or duplex-distance."; 1609 } 1610 leaf channel-separation { 1611 type decimal64 { 1612 fraction-digits 1; 1613 } 1614 units "MHz"; 1615 description 1616 "The amount of bandwidth allocated to a carrier."; 1617 } 1618 leaf available-min-output-power { 1619 type power; 1620 units "dBm"; 1621 description 1622 "The minimum output power supported."; 1623 } 1624 leaf available-max-output-power { 1625 type power; 1626 units "dBm"; 1627 description 1628 "The maximum output power supported."; 1629 } 1630 leaf available-min-acm { 1631 type identityref { 1632 base coding-modulation; 1633 } 1634 description 1635 "Minimum coding-modulation possible to use."; 1636 } 1637 leaf available-max-acm { 1638 type identityref { 1639 base coding-modulation; 1640 } 1641 description 1642 "Maximum coding-modulation possible to use."; 1643 } 1644 leaf available-min-speed { 1645 type yang:gauge64; 1646 units "bit/s"; 1647 description 1648 "Minimum speed that can be supported given 1649 by the available-min-acm."; 1650 } 1651 leaf available-max-speed { 1652 type yang:gauge64; 1653 units "bit/s"; 1654 description 1655 "Maximum speed that can be supported given 1656 by the available-max-acm."; 1657 } 1658 } 1659 } 1661 augment "/if:interfaces-state/if:interface/if:statistics" { 1662 when "../if:type = 'mrl:carrier-termination'"; 1663 description 1664 "Addition of state data nodes in the container statistics 1665 for carrier terminations to the standard Interface data 1666 model, for interfaces of the type 'carrier-termination'."; 1668 leaf min-rltm { 1669 type power { 1670 range "-99..-20"; 1671 } 1672 units "dBm"; 1673 description 1674 "Minimum input power since last reset."; 1675 } 1676 leaf max-rltm { 1677 type power { 1678 range "-99..-20"; 1679 } 1680 units "dBm"; 1681 description 1682 "Maximum input power since last reset."; 1683 } 1685 leaf min-tltm { 1686 type power { 1687 range "-99..40"; 1688 } 1689 units "dBm"; 1690 description 1691 "Minimum output power since last reset."; 1692 } 1693 leaf max-tltm { 1694 type power { 1695 range "-99..40"; 1696 } 1697 units "dBm"; 1698 description 1699 "Maximum output power since last reset."; 1700 } 1701 } 1703 augment "/if:interfaces-state/if:interface/if:statistics" { 1704 when "(../if:type = 'mrl:carrier-termination') or 1705 (../if:type = 'mrl:radio-link-terminal')"; 1706 description 1707 "Addition of G.826 statsistics in the container statistics 1708 of the standard Interface state data model."; 1710 uses g826-stats; 1711 } 1713 /* 1714 * Radio Link Protection Pairs - Configuration data nodes 1715 */ 1717 container radio-link-protection-pairs { 1718 description 1719 "Configuration of radio link protected pairs (1+1) of 1720 carrier terminations in a radio link. More than one 1721 protected pair per radio-link-terminal is allowed."; 1722 list radio-link-protection-pair { 1723 key "name"; 1724 description 1725 "List of protected pairs of carrier terminations 1726 in a radio link."; 1727 leaf name { 1728 type string; 1729 description 1730 "Name used for identification of the radio 1731 link protection pair"; 1732 } 1733 leaf protection-switch-mode { 1734 type enumeration { 1735 enum "manual" { 1736 description 1737 "Automatic switching is disabled and 1738 operator can select Tx manually."; 1739 } 1740 enum "auto" { 1741 description 1742 "System automatically switches from the degraded 1743 to the other receiver(Rx) or transmitter (Tx)."; 1744 } 1745 enum "auto-and-revertive" { 1746 description 1747 "Makes it possible to manually set the preferred Tx."; 1748 } 1749 } 1750 default "auto"; 1751 description 1752 "The mode in which the switching mechanism is 1753 configured. 1754 Auto - System automatically switches from the 1755 degraded to the other receiver(Rx) or transmitter (Tx). 1756 Manual - Automatic switching is disabled and 1757 operator can select Tx manually. 1758 Auto & Revertive - makes it possible to manually 1759 set the preferred Tx."; 1760 } 1761 leaf revertive-preferred-tx { 1762 type if:interface-ref; 1763 must "/if:interfaces/if:interface[if:name = current()]" 1764 + "/if:type = 'carrier-termination'" { 1765 description 1766 "The type of a preferred-tx must be 1767 'carrier-termination'."; 1768 } 1769 description 1770 "Association to the preferred carrier 1771 termination in revertive protection mode."; 1772 } 1773 leaf revertive-wait-to-restore { 1774 type uint16; 1775 units "seconds"; 1776 default "0"; 1777 description 1778 "The time to wait before switching back to the 1779 preferred Tx in Auto & Revertive mode."; 1780 } 1781 leaf-list radio-link-protection-members { 1782 type if:interface-ref; 1783 must "/if:interfaces/if:interface[if:name = current()]" 1784 + "/if:type = 'carrier-termination'" { 1785 description 1786 "The type of a protection member must be 1787 'carrier-termination'."; 1788 } 1789 min-elements 2; 1790 max-elements "2"; 1791 description 1792 "Association to a pair of carrier terminations 1793 configured for radio link protection and used in 1794 the radio link terminal."; 1795 } 1796 } 1797 } 1799 /* 1800 * Radio Link Protection Pairs - Configuration state data nodes 1801 */ 1803 container radio-link-protection-pairs-state { 1804 config false; 1805 description 1806 "State data for radio link protected pairs (1+1) of 1807 carrier terminations in a radio link."; 1808 list radio-link-protection-pair { 1809 key "name"; 1810 description 1811 "List of protected pairs of carrier terminations 1812 in a radio link."; 1813 leaf name { 1814 type string; 1815 description 1816 "Name used for identification of the radio 1817 link protection pair."; 1818 } 1819 leaf protection-status { 1820 type enumeration { 1821 enum "unprotected" { 1822 description "Not protected"; 1823 } 1824 enum "protected" { 1825 description "Protected"; 1826 } 1827 enum "unable-to-protect" { 1828 description "Unable to protect"; 1829 } 1831 } 1832 description 1833 "Status of the protection, in a pair of carrier 1834 terminations configured in a radio link protection 1835 mode."; 1836 } 1837 leaf actual-wait-to-restore { 1838 when "/radio-link-protection-pairs/" 1839 + "radio-link-protection-pair[name = current()]" 1840 + "/protection-switch-mode = 'auto-and-revertive'"; 1841 type uint16; 1842 units "seconds"; 1843 description 1844 "The actual time to wait before switching back to the 1845 preferred Tx in Auto & Revertive mode."; 1846 } 1847 } 1848 } 1850 /* 1851 * XPIC & MIMO groups - Configuration data nodes 1852 */ 1854 container xpic-pairs { 1855 if-feature xpic; 1856 description 1857 "Configuration of carrier termination pairs 1858 for operation in XPIC mode."; 1859 list xpic-pair { 1860 key "name"; 1861 description 1862 "List of carrier termination pairs in XPIC mode."; 1863 leaf name { 1864 type string; 1865 description 1866 "Name used for identification of the XPIC pair."; 1867 } 1868 leaf enabled { 1869 type boolean; 1870 default "false"; 1871 description 1872 "Enable(true)/disable(false) XPIC"; 1873 } 1874 leaf-list xpic-members { 1875 type if:interface-ref; 1876 must "/if:interfaces/if:interface[if:name = current()]" 1877 + "/if:type = 'carrier-termination'" { 1878 description 1879 "The type of a xpic-member must be 1880 'carrier-termination'."; 1881 } 1882 min-elements 2; 1883 max-elements "2"; 1884 description 1885 "Association to XPIC pairs used in the radio link 1886 terminal."; 1887 } 1888 } 1889 } 1890 container mimo-groups { 1891 if-feature mimo; 1892 description 1893 "Configuration of carrier terminations 1894 for operation in MIMO mode."; 1895 list mimo-group { 1896 key "name"; 1897 description 1898 "List of carrier terminations in MIMO mode."; 1899 leaf name { 1900 type string; 1901 description 1902 "Name used for identification of the MIMO group."; 1903 } 1904 leaf enabled { 1905 type boolean; 1906 default "false"; 1907 description 1908 "Enable(true)/disable(false) MIMO"; 1909 } 1910 leaf-list mimo-members { 1911 type if:interface-ref; 1912 must "/if:interfaces/if:interface[if:name = current()]" 1913 + "/if:type = 'carrier-termination'" { 1914 description 1915 "The type of a mimo-member must be 1916 'carrier-termination'."; 1917 } 1918 min-elements 2; 1919 description 1920 "Association to a MIMO group if used in the radio 1921 link terminal."; 1922 } 1923 } 1924 } 1925 } 1926 1927 5. Acknowledgements 1929 6. IANA Considerations 1931 This document defines a new YANG module and the authors politely 1932 request that IANA assigns unique names to the YANG module file 1933 contained within this draft, and also appropriate URIs in the "IETF 1934 XML Registry". 1936 7. Security Considerations 1938 The YANG module defined in this memo is designed to be accessed via 1939 the NETCONF protocol RFC 6241 [RFC6241]. The lowest NETCONF layer is 1940 the secure transport layer and the mandatory to implement secure 1941 transport is SSH RFC 6242 [RFC6242]. The NETCONF access control 1942 model RFC 6536 [RFC6536] provides the means to restrict access for 1943 particular NETCONF users to a pre-configured subset of all available 1944 NETCONF protocol operations and content. 1946 There are a number of data nodes defined in this YANG module which 1947 are writable/creatable/deletable (i.e. config true, which is the 1948 default). These data nodes may be considered sensitive or vulnerable 1949 in some network environments. Write operations (e.g. edit-config) to 1950 these data nodes without proper protection can have a negative effect 1951 on network operations. These are the subtrees and data nodes and 1952 their sensitivity/vulnerability: 1954 8. References 1956 8.1. Normative References 1958 [RFC2119] Bradner, S., "Key words for use in RFCs to Indicate 1959 Requirement Levels", BCP 14, RFC 2119, 1960 DOI 10.17487/RFC2119, March 1997, 1961 . 1963 [RFC6020] Bjorklund, M., Ed., "YANG - A Data Modeling Language for 1964 the Network Configuration Protocol (NETCONF)", RFC 6020, 1965 DOI 10.17487/RFC6020, October 2010, 1966 . 1968 [RFC7223] Bjorklund, M., "A YANG Data Model for Interface 1969 Management", RFC 7223, DOI 10.17487/RFC7223, May 2014, 1970 . 1972 8.2. Informative References 1974 [RFC6241] Enns, R., Ed., Bjorklund, M., Ed., Schoenwaelder, J., Ed., 1975 and A. Bierman, Ed., "Network Configuration Protocol 1976 (NETCONF)", RFC 6241, DOI 10.17487/RFC6241, June 2011, 1977 . 1979 [RFC6242] Wasserman, M., "Using the NETCONF Protocol over Secure 1980 Shell (SSH)", RFC 6242, DOI 10.17487/RFC6242, June 2011, 1981 . 1983 [RFC6536] Bierman, A. and M. Bjorklund, "Network Configuration 1984 Protocol (NETCONF) Access Control Model", RFC 6536, 1985 DOI 10.17487/RFC6536, March 2012, 1986 . 1988 Authors' Addresses 1990 Jonas Ahlberg 1991 Ericsson AB 1992 Sweden 1994 Email: jonas.ahlberg@ericsson.com 1996 Jan-Olof Carlson 1997 Ericsson AB 1998 Sweden 2000 Email: jan-olof.carlson@ericsson.com 2002 Hans-Ake Lund 2003 Ericsson AB 2004 Sweden 2006 Email: hans-ake.lund@ericsson.com 2008 Thomas Olausson 2009 Ericsson AB 2010 Sweden 2012 Email: thomas.olausson@ericsson.com 2013 Min Ye 2014 Huawei Technologies Co. 2015 P.R.China 2017 Email: amy.yemin@huawei.com 2019 Marko Vaupotic 2020 Aviat Networks 2021 Slovenia 2023 Email: Marko.Vaupotic@Aviatnet.com