idnits 2.17.1 draft-ietf-ccamp-dwdm-if-param-yang-04.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 : ---------------------------------------------------------------------------- ** The abstract seems to contain references ([ITU.G698.2]), which it shouldn't. Please replace those with straight textual mentions of the documents in question. Miscellaneous warnings: ---------------------------------------------------------------------------- == The copyright year in the IETF Trust and authors Copyright Line does not match the current year == Line 514 has weird spacing: '... leaf tca-t...' == Line 518 has weird spacing: '... leaf min-t...' == Line 523 has weird spacing: '... leaf max-t...' == Line 548 has weird spacing: '... leaf pre-f...' == Line 552 has weird spacing: '... leaf pre-f...' == (20 more instances...) == The document doesn't use any RFC 2119 keywords, yet seems to have RFC 2119 boilerplate text. -- The document date (May 9, 2020) is 1442 days in the past. Is this intentional? Checking references for intended status: Experimental ---------------------------------------------------------------------------- == Missing Reference: 'RFC6241' is mentioned on line 871, but not defined == Missing Reference: 'RFC6242' is mentioned on line 873, but not defined == Missing Reference: 'RFC6536' is mentioned on line 873, but not defined ** Obsolete undefined reference: RFC 6536 (Obsoleted by RFC 8341) == Missing Reference: 'RFC3688' is mentioned on line 881, but not defined == Missing Reference: 'RFC6020' is mentioned on line 895, but not defined == Unused Reference: 'ITU.G694.1' is defined on line 958, but no explicit reference was found in the text == Unused Reference: 'ITU.G709' is defined on line 969, but no explicit reference was found in the text == Unused Reference: 'ITU.G7710' is defined on line 974, but no explicit reference was found in the text == Unused Reference: 'ITU.G798' is defined on line 979, but no explicit reference was found in the text == Unused Reference: 'ITU.G8201' is defined on line 985, but no explicit reference was found in the text == Unused Reference: 'ITU.G826' is defined on line 991, but no explicit reference was found in the text == Unused Reference: 'ITU.G872' is defined on line 997, but no explicit reference was found in the text == Unused Reference: 'ITU.G874' is defined on line 1002, but no explicit reference was found in the text == Unused Reference: 'ITU.G959.1' is defined on line 1013, but no explicit reference was found in the text == Unused Reference: 'RFC2578' is defined on line 1023, but no explicit reference was found in the text == Unused Reference: 'RFC2579' is defined on line 1029, but no explicit reference was found in the text == Unused Reference: 'RFC2580' is defined on line 1034, but no explicit reference was found in the text == Unused Reference: 'RFC2863' is defined on line 1039, but no explicit reference was found in the text == Unused Reference: 'RFC3591' is defined on line 1043, but no explicit reference was found in the text == Unused Reference: 'RFC6205' is defined on line 1048, but no explicit reference was found in the text == Unused Reference: 'RFC2629' is defined on line 1055, but no explicit reference was found in the text == Unused Reference: 'RFC4054' is defined on line 1065, but no explicit reference was found in the text == Unused Reference: 'RFC4181' is defined on line 1070, but no explicit reference was found in the text -- Obsolete informational reference (is this intentional?): RFC 2629 (Obsoleted by RFC 7749) Summary: 2 errors (**), 0 flaws (~~), 31 warnings (==), 2 comments (--). Run idnits with the --verbose option for more detailed information about the items above. -------------------------------------------------------------------------------- 2 Internet Engineering Task Force G. Galimberti, Ed. 3 Internet-Draft Cisco 4 Intended status: Experimental R. Kunze 5 Expires: November 10, 2020 A. Burk 6 Deutsche Telekom 7 D. Hiremagalur, Ed. 8 G. Grammel, Ed. 9 Juniper 10 May 9, 2020 12 A YANG model to manage the optical interface parameters for an external 13 transponder in a WDM network 14 draft-ietf-ccamp-dwdm-if-param-yang-04 16 Abstract 18 This memo defines a Yang model related to the Optical Transceiver 19 parameters characterising coherent 100G and above interfaces. 100G 20 and above Transceivers support coherent modulation, multiple 21 modulation formats, multiple FEC codes including some not yet 22 specified (or by in phase of specification by) ITU-T G.698.2 23 [ITU.G698.2] or any other ITU-T recommendation. More context about 24 the state of the Coherent transceivers is described in draft-many- 25 coherent-DWDM-if-control. Use cases are described in RFC7698. 27 The Yang model defined in this memo can be used for Optical 28 Parameters monitoring and/or configuration of the endpoints of a 29 multi-vendor IaDI optical link. The use of this model does not 30 guarantee interworking of transceivers over a DWDM. Optical path 31 feasibility and interoperability has to be determined by means 32 outside the scope of this document. The purpose of this model is to 33 program interface parameters to consistently configure the mode of 34 operation of transceivers. 36 Copyright Notice 38 Copyright (c) 2014 IETF Trust and the persons identified as the 39 document authors. All rights reserved. 41 Status of This Memo 43 This Internet-Draft is submitted in full conformance with the 44 provisions of BCP 78 and BCP 79. 46 Internet-Drafts are working documents of the Internet Engineering 47 Task Force (IETF). Note that other groups may also distribute 48 working documents as Internet-Drafts. The list of current Internet- 49 Drafts is at https://datatracker.ietf.org/drafts/current/. 51 Internet-Drafts are draft documents valid for a maximum of six months 52 and may be updated, replaced, or obsoleted by other documents at any 53 time. It is inappropriate to use Internet-Drafts as reference 54 material or to cite them other than as "work in progress." 56 This Internet-Draft will expire on November 10, 2020. 58 Copyright Notice 60 Copyright (c) 2020 IETF Trust and the persons identified as the 61 document authors. All rights reserved. 63 This document is subject to BCP 78 and the IETF Trust's Legal 64 Provisions Relating to IETF Documents 65 (https://trustee.ietf.org/license-info) in effect on the date of 66 publication of this document. Please review these documents 67 carefully, as they describe your rights and restrictions with respect 68 to this document. Code Components extracted from this document must 69 include Simplified BSD License text as described in Section 4.e of 70 the Trust Legal Provisions and are provided without warranty as 71 described in the Simplified BSD License. 73 Table of Contents 75 1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . 3 76 2. The Internet-Standard Management Framework . . . . . . . . . 3 77 3. Conventions . . . . . . . . . . . . . . . . . . . . . . . . . 4 78 4. Overview . . . . . . . . . . . . . . . . . . . . . . . . . . 4 79 4.1. Optical Parameters Description . . . . . . . . . . . . . 5 80 4.1.1. Parameters at Ss . . . . . . . . . . . . . . . . . . 5 81 4.1.2. Interface at point Rs . . . . . . . . . . . . . . . . 5 82 4.2. Use Cases . . . . . . . . . . . . . . . . . . . . . . . . 5 83 4.3. Optical Interface for external transponder in a WDM 84 network . . . . . . . . . . . . . . . . . . . . . . . . . 5 85 5. Structure of the Yang Module . . . . . . . . . . . . . . . . 7 86 6. Yang Module . . . . . . . . . . . . . . . . . . . . . . . . . 8 87 7. Security Considerations . . . . . . . . . . . . . . . . . . . 19 88 8. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 19 89 9. Acknowledgements . . . . . . . . . . . . . . . . . . . . . . 20 90 10. Contributors . . . . . . . . . . . . . . . . . . . . . . . . 20 91 11. References . . . . . . . . . . . . . . . . . . . . . . . . . 21 92 11.1. Normative References . . . . . . . . . . . . . . . . . . 21 93 11.2. Informative References . . . . . . . . . . . . . . . . . 23 94 Appendix A. Change Log . . . . . . . . . . . . . . . . . . . . . 23 95 Appendix B. Open Issues . . . . . . . . . . . . . . . . . . . . 23 96 Appendix C. Applicability examples . . . . . . . . . . . . . . . 24 97 Authors' Addresses . . . . . . . . . . . . . . . . . . . . . . . 24 99 1. Introduction 101 This memo defines a Yang model that translates and obsolete the SNMP 102 mib module defined in draft-galikunze-ccamp-dwdm-if-snmp-mib for 103 managing single channel optical interface parameters of DWDM 104 applications, using the approach specified in G.698.2. This model 105 supports parameters to characterize coherent transceivers found in 106 current implementations to specify the mode of operation. As 107 application identifiers like those specified in ITU-T G.874.1 108 [ITU.G874.1] are not available we use mode templates instead. A mode 109 template describes transceiver characteristics in detail and can be 110 identified by a mode-id. 112 This draft refers and supports the RFC7698 and draft-many-coherent- 113 DWDM-if-control. 115 The YANG model describing and extending the optical parameters allows 116 different vendors and operators to retrieve, provision and exchange 117 information across the multi-vendor IaDI interfaces in an abstract 118 manner. 120 The they concept introduced by this YANG model is the notion of a 121 mode. A mode is a combination of parameters or parameter ranges that 122 is supported by a transceiver. As an example, operating a device in 123 QPSK mode may use a different FEC and requires less OSNR to reach the 124 FEC limit than the same transceiver operating in QAM16 mode. Given 125 the number of parameters and their possible combinations it is 126 important for vendors to be able to qualify a set of combinations 127 which is the basis to define a mode. The YANG model furthermore 128 provides means to selecting one mode as current-mode from that pre- 129 defined list of modes supported by the transceiver module. Once 130 selected, current-opt-if-och-mode-params provide the means to 131 configure specific parameters at run time and retrieve actual 132 parameters from the module. For example, the frequency is a 133 parameter that can be set within min/max boundaries set by the 134 current mode. Laser Temperature however is a ro parameter available 135 at run-time that can be checked against the mode boundaries and may 136 trigger an event. 138 2. The Internet-Standard Management Framework 140 For a detailed overview of the documents that describe the current 141 Internet-Standard Management Framework, please refer to section 7 of 142 RFC 3410 [RFC3410]. 144 This memo specifies a Yang model for optical interfaces. 146 3. Conventions 148 The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", 149 "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this 150 document are to be interpreted as described in RFC 2119 [RFC2119] In 151 the description of OIDs the convention: Set (S) Get (G) and Trap (T) 152 conventions will describe the action allowed by the parameter. 154 4. Overview 156 Figure 1 shows a set of reference points, for single-channel 157 connection between transmitters (Tx) and receivers (Rx). Here the 158 DWDM network elements include an OM and an OD (which are used as a 159 pair with the opposing element), one or more optical amplifiers and 160 may also include one or more OADMs. 162 +-------------------------------------------------+ 163 Ss | DWDM Network Elements | Rs 164 +--+ | | | \ / | | | +--+ 165 Tx L1--|->| \ +------+ +------+ / |--|-->Rx L1 166 +---+ | | | | | +------+ | | | | | +--+ 167 +---+ | | | | | | | | | | | | +--+ 168 Tx L2--|->| OM |-->|------|->|ROADM |--|------|->| OD |--|-->Rx L2 169 +---+ | | | | | | | | | | | | +--+ 170 +---+ | | | | | +------+ | | | | | +--+ 171 Tx L3--|->| / | DWDM | | ^ | DWDM | \ |--|-->Rx L3 172 +---+ | | / | Link +----|--|----+ Link | \ | | +--+ 173 +-----------+ | | +----------+ 174 +--+ +--+ 175 | | 176 Rs v | Ss 177 +-----+ +-----+ 178 |RxLx | |TxLx | 179 +-----+ +-----+ 180 Ss = reference point at the DWDM network element tributary output 181 Rs = reference point at the DWDM network element tributary input 182 Lx = Lambda x 183 OM = Optical Mux 184 OD = Optical Demux 185 ROADM = Reconfigurable Optical Add Drop Mux 187 from Fig. 5.1/G.698.2 189 Figure 1: External transponder in WDM netwoks 191 4.1. Optical Parameters Description 193 The link between the external transponders through a WDM network 194 media channels are managed at the edges, i.e. at the transmitters 195 (Tx) and receivers (Rx) attached to the S and R reference points 196 respectively. 198 Definitions of the optical parameters are provided below to increase 199 the readability of the document. 201 4.1.1. Parameters at Ss 203 output-power: 204 The mean launched power at Ss is the average power (in dBm) of a 205 pseudo-random data sequence coupled into the DWDM link. 207 central frequency: 208 This parameter indicates the Central frequency value that Ss and 209 Rs will be set to work (in THz) 211 4.1.2. Interface at point Rs 213 input-power: 214 The average received power (in dBm) at point Rs. 216 Curr-OSNR: 217 Current Optical Signal to Noise Ratio (OSNR) estimated at Rx 218 Transceiver port. 220 Curr-q-factor: 221 "Q" factor estimated at Rx Transceiver port. 223 4.2. Use Cases 225 The use cases are described in draft-ietf-ccamp-dwdm-if-mng-ctrl-fwk 227 4.3. Optical Interface for external transponder in a WDM network 229 The ietf-ext-xponder-wdm-if is an augment to the ietf-interface. It 230 allows the user to set the operating mode of transceivers as well as 231 other operational parameters. The module provides also treshold 232 settings and notifications to supervise measured parameters and 233 notify the client. 235 module: ietf-ext-xponder-wdm-if 236 augment /if:interfaces/if:interface: 237 +--rw optIfOChRsSs 238 +--rw if-current-mode 239 | +--ro mode-id? string 240 | +--ro application-identifier? uint32 241 | +--ro min-central-frequency? layer0-types:frequency-thz 242 | +--ro max-central-frequency? layer0-types:frequency-thz 243 | +--ro min-channel-input-power? dbm-t 244 | +--ro max-channel-input-power? dbm-t 245 | +--ro min-channel-output-power? dbm-t 246 | +--ro max-channel-output-power? dbm-t 247 | +--ro osnr-margin? int32 248 | +--ro q-margin? int32 249 | +--ro fec-info? string 250 | +--ro fec-bitrate? string 251 | +--ro fec-gain? string 252 | +--rw pre-fec-ber-mantissa-threshold? uint32 253 | +--rw pre-fec-ber-exponent-threshold? int32 254 | +--ro number-of-lanes? uint32 255 | +--ro min-laser-temperature? int32 256 | +--ro max-laser-temperature? int32 257 | +--ro max-total-rx-optical-power? dbm-t 258 | +--ro max-chromatic-dispersion? int32 259 | +--ro max-diff-group-delay? int32 260 | +--ro modulation-format? string 261 | +--rw baud-rate? uint32 262 | +--rw bits-per-symbol? uint32 263 | +--rw num-symbols-in-alphabet? uint32 264 | +--rw symbols-index? uint32 265 +--ro if-supported-mode 266 | +--ro number-of-modes-supported? uint32 267 | +--ro mode-list* [mode-id] 268 | +--ro mode-id string 269 | +--ro application-identifier? uint32 270 | +--ro min-central-frequency? layer0-types:frequency-thz 271 | +--ro max-central-frequency? layer0-types:frequency-thz 272 | +--ro min-channel-input-power? dbm-t 273 | +--ro max-channel-input-power? dbm-t 274 | +--ro min-channel-output-power? dbm-t 275 | +--ro max-channel-output-power? dbm-t 276 | +--ro osnr-margin? int32 277 | +--ro q-margin? int32 278 | +--ro fec-info? string 279 | +--ro fec-bitrate? string 280 | +--ro fec-gain? string 281 | +--ro pre-fec-ber-mantissa-threshold? uint32 282 | +--ro pre-fec-ber-exponent-threshold? int32 283 | +--ro number-of-lanes? uint32 284 | +--ro min-laser-temperature? int32 285 | +--ro max-laser-temperature? int32 286 | +--ro max-total-rx-optical-power? dbm-t 287 | +--ro max-chromatic-dispersion? int32 288 | +--ro max-diff-group-delay? int32 289 | +--ro modulation-format? string 290 | +--ro baud-rate? uint32 291 | +--ro bits-per-symbol? uint32 292 | +--ro num-symbols-in-alphabet? uint32 293 | +--ro symbols-index? uint32 294 +--rw current-opt-if-och-mode-params 295 +--rw mode-id? string 296 +--ro min-osnr-margin? int32 297 +--ro q-margin? int32 298 +--rw central-frequency? layer0-types:frequency-thz 299 +--rw channel-output-power? dbm-t 300 +--ro channel-input-power? dbm-t 301 +--ro total-input-power? dbm-t 302 +--rw min-fec-ber-mantissa-threshold? uint32 303 +--rw min-fec-ber-exponent-threshold? int32 304 +--rw max-fec-ber-mantissa-threshold? uint32 305 +--rw max-fec-ber-exponent-threshold? int32 306 +--rw number-of-tcas-supported? uint32 307 +--rw mode-list* [tca-type] 308 | +--rw tca-type opt-if-och-tca-types 309 | +--rw min-threshold? int32 310 | +--rw max-threshold? int32 311 +--ro cur-osnr? int32 312 +--ro cur-q-factor? int32 313 +--ro uncorrected-words? uint64 314 +--ro pre-fec-ber-mantissa? uint32 315 +--ro pre-fec-ber-exponent? int32 317 notifications: 318 +---n opt-if-och-central-frequency-change 319 | +--ro if-name? -> /if:interfaces/interface/name 320 | +--ro new-opt-if-och-central-frequency 321 | +--ro central-frequency? layer0-types:frequency-thz 322 +---n opt-if-och-mode-change 323 | +--ro if-name? -> /if:interfaces/interface/name 324 | +--ro mode-id? string 325 +---n opt-if-och-min-tca 326 +--ro if-name? -> /if:interfaces/interface/name 327 +--ro tca-type? opt-if-och-tca-types 329 5. Structure of the Yang Module 331 ietf-ext-xponder-wdm-if is a top level model for the support of this 332 feature. 334 6. Yang Module 336 The ietf-ext-xponder-wdm-if is defined as an extension to ietf 337 interfaces. 339 file "ietf-ext-xponder-wdm-if.yang" 341 module ietf-ext-xponder-wdm-if { 342 namespace "urn:ietf:params:xml:ns:yang:ietf-ext-xponder-wdm-if"; 343 prefix ietf-ext-xponder-wdm-if; 345 import ietf-interfaces { 346 prefix if; 347 } 349 import ietf-layer0-types { 350 prefix "layer0-types"; 351 } 353 organization 354 "IETF CCAMP 355 Working Group"; 357 contact 358 "WG Web: 359 WG List: 361 Editor: Dharini Hiremagalur 362 "; 364 description 365 "This module contains a collection of YANG definitions for 366 configuring Optical interfaces. 368 Copyright (c) 2016 IETF Trust and the persons identified 369 as 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 373 subject to the license terms contained in, the Simplified 374 BSD License set forth in Section 4.c of the IETF Trust's 375 Legal Provisions Relating to IETF Documents 376 (http://trustee.ietf.org/license-info)."; 378 revision "2020-03-09" { 379 description 380 "Revision 1.5"; 381 reference 382 ""; 383 } 385 revision "2019-11-04" { 386 description 387 "Revision 1.4"; 388 reference 389 ""; 390 } 392 revision "2019-07-08" { 393 description 394 "Revision 1.3"; 395 reference 396 ""; 397 } 398 revision "2018-10-22" { 399 description 400 "Revision 1.2"; 401 reference 402 ""; 403 } 404 revision "2018-03-06" { 405 description 406 "Revision 1.1"; 407 reference 408 ""; 409 } 410 revision "2017-03-06" { 411 description 412 "Revision 1.0"; 413 reference 414 ""; 415 } 416 revision "2016-03-17" { 417 description 418 "Initial revision."; 419 reference 420 ""; 421 } 423 typedef dbm-t { 424 type int32; 425 units ".01dbm"; 427 description " 428 Amplifiers and Transceivers Power in dBm"; 429 } 431 typedef opt-if-och-tca-types { 432 type enumeration { 433 enum max-laser-linewdt { 434 description "The maximum laser linewidth"; 435 } 436 enum min-tx-power-tca { 437 description "The min tx power TCA"; 438 } 439 enum max-tx-power-tca { 440 description "The min tx power TCA"; 441 } 442 enum min-rx-power-tca{ 443 description "The min tx power TCA"; 444 } 445 enum max-rx-power-tca{ 446 description "The min tx power TCA"; 447 } 448 enum max-pol-power-diff-tca{ 449 description "The power difference between polarization 450 TCA"; 451 } 452 enum max-pol-skew-diff-tca{ 453 description "The skew between the two polarization TCA"; 454 } 455 enum min-frequency-offset-tca{ 456 description "Min Frequency offset TCA"; 457 } 458 enum max-frequency-offset-tca{ 459 description "Max Frequency offset TCA"; 460 } 461 enum min-osnr-tca{ 462 description "Min OSNR TCA"; 463 } 464 enum max-osnr-tca{ 465 description "Max OSNR TCA"; 466 } 467 enum min-laser-temperature-tca{ 468 description "The min tx power TCA"; 469 } 470 enum max-laser-temperature-tca{ 471 description "Temperature TCA"; 472 } 473 enum min-fec-ber-tca{ 474 description "Min Pre Fec BER TCA"; 475 } 476 enum max-fec-ber-tca{ 477 description "Max Pre Fec BER TCA"; 478 } 479 enum min-q-tca{ 480 description "Min Q TCA"; 481 } 482 enum max-q-tca { 483 description "Max Q TCA"; 484 } 485 } 486 description "The different types of TCA's"; 487 } 489 grouping opt-if-och-power { 490 description "Interface optical Power"; 492 leaf channel-output-power { 493 type dbm-t; 494 description "The output power for this interface in .01 dBm. 495 The setting of the output power is optional"; 496 } 498 leaf channel-input-power { 499 type dbm-t; 500 config false; 501 description "The current channel input power of this 502 interface"; 503 } 505 leaf total-input-power { 506 type dbm-t; 507 config false; 508 description "The total input power of this interface"; 509 } 510 } 512 grouping opt-if-och-tca-thresholds { 513 description "Thresholds for TCA's"; 514 leaf tca-type { 515 type opt-if-och-tca-types; 516 description "type of the TCA eg TX Power"; 517 } 518 leaf min-threshold { 519 type int32; 520 description "A TCA is generated if the variable is less than 521 this value"; 522 } 523 leaf max-threshold { 524 type int32; 525 description "A TCA is generated if the variable is more than 526 this value"; 527 } 528 } 530 grouping opt-if-och-fec { 531 description "FEC info"; 533 leaf fec-info { 534 type string { length "1..255"; } 535 config false; 536 description "FEC Type - eg GFEC"; 537 } 538 leaf fec-bitrate { 539 type string { length "1..255"; } 540 config false; 541 description "FEC Overhead rate "; 542 } 543 leaf fec-gain { 544 type string { length "1..255"; } 545 config false; 546 description "FEC Overhead rate "; 547 } 548 leaf pre-fec-ber-mantissa-threshold { 549 type uint32; 550 description "Mantissa of the FEC BER threshold"; 551 } 552 leaf pre-fec-ber-exponent-threshold { 553 type int32; 554 description "Exponent of the FEC BER threshold"; 555 } 556 } 558 grouping opt-if-och-central-frequency { 559 description "Interface Central Frequency"; 560 leaf central-frequency { 561 type layer0-types:frequency-thz; 562 description "This parameter indicates the frequency of this 563 interface "; 564 } 565 } 566 grouping opt-if-och-modulation-params { 567 description "Optical modulation parameters for the lane"; 569 leaf modulation-format { 570 type string { length "1..255"; } 571 config false; 572 description "Modulation format for this mode"; 573 } 574 leaf baud-rate { 575 type uint32; 576 description "Baud-rate or symbol rate"; 577 } 578 leaf bits-per-symbol { 579 type uint32; 580 description "This parameter the bits per symbol for this 581 mode"; 582 } 583 leaf num-symbols-in-alphabet { 584 type uint32; 585 description "This parameter the bits per symbol for this 586 mode"; 587 } 588 leaf symbols-index { 589 type uint32; 590 description "This parameter is the symbol index this mode"; 591 } 592 } 594 grouping opt-if-och-lane-param { 595 description "Optical parameters for the lane"; 597 leaf number-of-lanes { 598 type uint32; 599 config false; 600 description "Number of optical lanes of this interface"; 601 } 602 leaf min-laser-temperature { 603 type int32; 604 units ".01C"; 605 config false; 606 description "Minimum Laser Temperature of this mode for 607 this lane"; 608 } 609 leaf max-laser-temperature { 610 type int32; 611 units ".01C"; 612 config false; 613 description "Maximum Laser Temperature of this mode for 614 this lane"; 615 } 616 leaf max-total-rx-optical-power { 617 type dbm-t; 618 config false; 619 description "Maximum rx optical power of this mode for this 620 lane"; 621 } 622 leaf max-chromatic-dispersion { 623 type int32; 624 config false; 625 description "Maximum chromatic dispersion of this mode for 626 this lane"; 627 } 628 leaf max-diff-group-delay { 629 type int32; 630 config false; 631 description "Maximum Differential group delay of this mode 632 for this lane"; 633 } 634 uses opt-if-och-modulation-params; 635 } 637 grouping opt-if-och-tca-list { 638 description "List of TCA's"; 639 leaf number-of-tcas-supported { 640 type uint32; 641 description "Number of TCAs supported by this interface"; 642 } 643 list mode-list { 644 key "tca-type"; 645 description "List of the TCAs"; 646 uses opt-if-och-tca-thresholds; 647 } 648 } 650 grouping opt-if-och-fec-tca-thresholds { 651 description "Pre FEC BER Thresholds for TCA's"; 652 leaf min-fec-ber-mantissa-threshold { 653 type uint32; 654 description "Min Mantissa of the FEC BER threshold"; 655 } 656 leaf min-fec-ber-exponent-threshold { 657 type int32; 658 description "Min Exponent of the FEC BER threshold"; 659 } 660 leaf max-fec-ber-mantissa-threshold { 661 type uint32; 662 description "Max Mantissa of the FEC BER threshold"; 663 } 664 leaf max-fec-ber-exponent-threshold { 665 type int32; 666 description "Max Exponent of the FEC BER threshold"; 667 } 668 } 670 grouping opt-if-och-mode-params { 671 description "OCh mode parameters"; 672 leaf mode-id { 673 type string { length "1..255"; } 674 description "ID for the OCh mode template"; 675 } 676 leaf min-osnr-margin { 677 type int32; 678 units "dB"; 679 config false; 680 description "OSNR margin to FEC threshold"; 681 } 682 leaf q-margin { 683 type int32; 684 units "dB"; 685 config false; 686 description "Q-Factor margin to FEC threshold"; 687 } 688 uses opt-if-och-central-frequency; 689 uses opt-if-och-power; 690 uses opt-if-och-fec-tca-thresholds; 691 uses opt-if-och-tca-list; 692 } 694 grouping opt-if-och-statistics { 695 description "OCh statistics"; 696 leaf cur-osnr { 697 type int32; 698 units "dB"; 699 config false; 700 description "OSNR margin to FEC threshold"; 701 } 702 leaf cur-q-factor { 703 type int32; 704 units "dB"; 705 config false; 706 description "Q-Factor of the interface"; 707 } 708 leaf uncorrected-words { 709 type uint64; 710 config false; 711 description "Post-FEC errored words"; 712 } 713 leaf pre-fec-ber-mantissa { 714 type uint32; 715 config false; 716 description "Pre-FEC errored words mantissa"; 717 } 718 leaf pre-fec-ber-exponent { 719 type int32; 720 config false; 721 description "Pre-FEC errored words exponent"; 722 } 723 } 725 grouping opt-if-och-mode { 726 description "OCh mode template"; 728 leaf mode-id { 729 type string { length "1..255"; } 730 config false; 731 description "ID for the OCh mode template"; 732 } 733 leaf application-identifier { 734 type uint32; 735 config false; 736 description "This parameter indicates the application 737 identifier according to G.698.2"; 738 } 740 leaf min-central-frequency { 741 type layer0-types:frequency-thz; 742 config false; 743 description 744 "his parameter indicates the minimum frequency for 745 this template"; 746 } 747 leaf max-central-frequency { 748 type layer0-types:frequency-thz; 749 config false; 750 description "This parameter indicates the minimum frequency 751 for this template"; 752 } 753 leaf min-channel-input-power { 754 type dbm-t; 755 config false; 756 description "The minimum input power of this interface"; 758 } 759 leaf max-channel-input-power { 760 type dbm-t; 761 config false; 762 description "The maximum input power of this interface"; 763 } 764 leaf min-channel-output-power { 765 type dbm-t; 766 config false; 767 description "The minimum output power of this interface"; 768 } 769 leaf max-channel-output-power { 770 type dbm-t; 771 config false; 772 description "The maximum output power of this interface"; 773 } 774 leaf osnr-margin { 775 type int32; 776 units "dB"; 777 config false; 778 description "OSNR margin to FEC threshold"; 779 } 780 leaf q-margin { 781 type int32; 782 units "dB"; 783 config false; 784 description "Q-Factor margin to FEC threshold"; 785 } 786 uses opt-if-och-fec; 787 uses opt-if-och-lane-param; 788 } 790 grouping opt-if-och-mode-list { 791 description "List of Mode list group"; 793 leaf number-of-modes-supported { 794 type uint32; 795 description "Number of modes supported by this interface"; 796 } 797 list mode-list { 798 key "mode-id"; 799 description "List of the modes"; 800 uses opt-if-och-mode; 801 } 802 } 804 notification opt-if-och-central-frequency-change { 805 description "A change of Central Frequency has been detected"; 806 leaf "if-name" { 807 type leafref { path "/if:interfaces/if:interface/if:name"; } 808 description "Interface name"; 809 } 810 container new-opt-if-och-central-frequency { 811 description "The new Central Frequency of the interface"; 812 uses opt-if-och-central-frequency; 813 } 814 } 816 notification opt-if-och-mode-change { 817 description "A change of Mode Template has been detected"; 819 leaf "if-name" { 820 type leafref { path "/if:interfaces/if:interface/if:name"; } 821 description "Interface name"; 822 } 823 leaf mode-id { 824 type string { length "1..255"; } 825 description "ID for the OCh mode template"; 826 } 827 } 829 notification opt-if-och-min-tca { 830 description "A min output TCA notification"; 832 leaf "if-name" { 833 type leafref { path "/if:interfaces/if:interface/if:name"; } 834 description "Interface name"; 835 } 836 leaf tca-type { 837 type opt-if-och-tca-types; 838 description "Type of TCA for eg min tx power TCA"; 839 } 840 } 842 augment "/if:interfaces/if:interface" { 843 description "Parameters for an optical interface"; 845 container optIfOChRsSs { 846 description "RsSs path configuration for an interface"; 848 container if-current-mode { 849 description "Current mode template of the interface"; 850 uses opt-if-och-mode; 851 } 852 container if-supported-mode { 853 config false; 854 description "Supported mode list of this interface"; 855 uses opt-if-och-mode-list; 856 } 857 container current-opt-if-och-mode-params { 858 description "Current parameters of this interface"; 859 uses opt-if-och-mode-params; 860 uses opt-if-och-statistics; 861 } 862 } 863 } 864 } 866 868 7. Security Considerations 870 The YANG module defined in this memo is designed to be accessed via 871 the NETCONF protocol [RFC6241]. he lowest NETCONF layer is the secure 872 transport layer and the mandatory-to-implement secure transport is 873 SSH [RFC6242]. The NETCONF access control model [RFC6536] provides 874 the means to restrict access for particular NETCONF users to a pre- 875 configured subset of all available NETCONF protocol operation and 876 content. 878 8. IANA Considerations 880 This document registers a URI in the IETF XML registry [RFC3688]. 881 Following the format in [RFC3688], the following registration is 882 requested to be made: 884 URI: urn:ietf:params:xml:ns:yang:ietf-interfaces:ietf-ext-xponder- 885 wdm-if 887 Registrant Contact: The IESG. 889 XML: N/A, the requested URI is an XML namespace. 891 This document registers a YANG module in the YANG Module Names 892 registry [RFC6020]. 894 This document registers a YANG module in the YANG Module Names 895 registry [RFC6020]. 897 prefix: ietf-ext-xponder-wdm-if reference: RFC XXXX 899 9. Acknowledgements 901 10. Contributors 903 Dean Bogdanovic 904 Westford 905 U.S.A. 906 email ivandean@gmail.com 908 Bernd Zeuner 909 Deutsche Telekom 910 Darmstadt 911 Germany 912 email B.Zeuner@telekom.de 914 Massimiliano Salsi 915 Juniper Networks 916 1133 Innovation Way 917 Sunnyvale, CA, 94089 918 U.S.A. 919 +1 408936847 920 email msalsi@google.com 922 Arnold Mattheus 923 Deutsche Telekom 924 Darmstadt 925 Germany 926 email a.mattheus@telekom.de 928 Manuel Paul 929 Deutsche Telekom 930 Berlin 931 Germany 932 email Manuel.Paul@telekom.de 934 Walid Wakim 935 Cisco 936 9501 Technology Blvd 937 ROSEMONT, ILLINOIS 60018 938 UNITED STATES 939 email wwakim@cisco.com 941 Kam Lam 942 Nokia 943 USA 944 +1 732 331 3476 945 kam.lam@nokia.com 947 Sergio Belotti 948 Nokia 949 Via Energy Park 950 20871 Vimercate (MB) 951 Italy 952 Sergio.belotti@nokia.com 954 11. References 956 11.1. Normative References 958 [ITU.G694.1] 959 International Telecommunications Union, "Spectral grids 960 for WDM applications: DWDM frequency grid", 961 ITU-T Recommendation G.694.1, February 2012. 963 [ITU.G698.2] 964 International Telecommunications Union, "Amplified 965 multichannel dense wavelength division multiplexing 966 applications with single channel optical interfaces", 967 ITU-T Recommendation G.698.2, November 2009. 969 [ITU.G709] 970 International Telecommunications Union, "Interface for the 971 Optical Transport Network (OTN)", ITU-T Recommendation 972 G.709, June 2016. 974 [ITU.G7710] 975 International Telecommunications Union, "Common equipment 976 management function requirements", ITU-T Recommendation 977 G.7710, August 2017. 979 [ITU.G798] 980 International Telecommunications Union, "Characteristics 981 of optical transport network hierarchy equipment 982 functional blocks", ITU-T Recommendation G.798, Devember 983 2017. 985 [ITU.G8201] 986 International Telecommunications Union, "Error performance 987 parameters and objectives for multi-operator international 988 paths within the Optical Transport Network (OTN)", 989 ITU-T Recommendation G.8201, April 2011. 991 [ITU.G826] 992 International Telecommunications Union, "End-to-end error 993 performance parameters and objectives for international, 994 constant bit-rate digital paths and connections", 995 ITU-T Recommendation G.826, December 2002. 997 [ITU.G872] 998 International Telecommunications Union, "Architecture of 999 optical transport networks", ITU-T Recommendation G.872, 1000 January 2017. 1002 [ITU.G874] 1003 International Telecommunications Union, "Management 1004 aspects of optical transport network elements", 1005 ITU-T Recommendation G.874, July 2010. 1007 [ITU.G874.1] 1008 International Telecommunications Union, "Optical transport 1009 network (OTN): Protocol-neutral management information 1010 model for the network element view", ITU-T Recommendation 1011 G.874.1, November 2016. 1013 [ITU.G959.1] 1014 International Telecommunications Union, "Optical transport 1015 network physical layer interfaces", ITU-T Recommendation 1016 G.959.1, November 2009. 1018 [RFC2119] Bradner, S., "Key words for use in RFCs to Indicate 1019 Requirement Levels", BCP 14, RFC 2119, 1020 DOI 10.17487/RFC2119, March 1997, 1021 . 1023 [RFC2578] McCloghrie, K., Ed., Perkins, D., Ed., and J. 1024 Schoenwaelder, Ed., "Structure of Management Information 1025 Version 2 (SMIv2)", STD 58, RFC 2578, 1026 DOI 10.17487/RFC2578, April 1999, 1027 . 1029 [RFC2579] McCloghrie, K., Ed., Perkins, D., Ed., and J. 1030 Schoenwaelder, Ed., "Textual Conventions for SMIv2", 1031 STD 58, RFC 2579, DOI 10.17487/RFC2579, April 1999, 1032 . 1034 [RFC2580] McCloghrie, K., Ed., Perkins, D., Ed., and J. 1035 Schoenwaelder, Ed., "Conformance Statements for SMIv2", 1036 STD 58, RFC 2580, DOI 10.17487/RFC2580, April 1999, 1037 . 1039 [RFC2863] McCloghrie, K. and F. Kastenholz, "The Interfaces Group 1040 MIB", RFC 2863, DOI 10.17487/RFC2863, June 2000, 1041 . 1043 [RFC3591] Lam, H-K., Stewart, M., and A. Huynh, "Definitions of 1044 Managed Objects for the Optical Interface Type", RFC 3591, 1045 DOI 10.17487/RFC3591, September 2003, 1046 . 1048 [RFC6205] Otani, T., Ed. and D. Li, Ed., "Generalized Labels for 1049 Lambda-Switch-Capable (LSC) Label Switching Routers", 1050 RFC 6205, DOI 10.17487/RFC6205, March 2011, 1051 . 1053 11.2. Informative References 1055 [RFC2629] Rose, M., "Writing I-Ds and RFCs using XML", RFC 2629, 1056 DOI 10.17487/RFC2629, June 1999, 1057 . 1059 [RFC3410] Case, J., Mundy, R., Partain, D., and B. Stewart, 1060 "Introduction and Applicability Statements for Internet- 1061 Standard Management Framework", RFC 3410, 1062 DOI 10.17487/RFC3410, December 2002, 1063 . 1065 [RFC4054] Strand, J., Ed. and A. Chiu, Ed., "Impairments and Other 1066 Constraints on Optical Layer Routing", RFC 4054, 1067 DOI 10.17487/RFC4054, May 2005, 1068 . 1070 [RFC4181] Heard, C., Ed., "Guidelines for Authors and Reviewers of 1071 MIB Documents", BCP 111, RFC 4181, DOI 10.17487/RFC4181, 1072 September 2005, . 1074 Appendix A. Change Log 1076 This optional section should be removed before the internet draft is 1077 submitted to the IESG for publication as an RFC. 1079 Note to RFC Editor: please remove this appendix before publication as 1080 an RFC. 1082 Appendix B. Open Issues 1084 Note to RFC Editor: please remove this appendix before publication as 1085 an RFC. 1087 Appendix C. Applicability examples 1089 As an examample here below is the way and OpenROADM compliant 1090 equipment could be managed using the Yang models described in thei 1091 draft. 1093 In OpenROADM MSA there is a limited number of DWDM interfaces 1094 supported. Basically only the 100G Staircase FEC and 400G oFEC are 1095 supported and these two kind of interfaces can be easily summarized 1096 with the "mode-id" and the "application-identifier" strings. 1098 the models below are enough to identify the interface and few working 1099 parameters: 1101 module: ietf-ext-xponder-wdm-if 1102 augment /if:interfaces/if:interface: 1103 +--rw optIfOChRsSs 1104 +--rw if-current-mode 1105 | +--ro mode-id? string 1106 | +--ro application-identifier? string 1107 . 1108 . 1109 . 1110 +--rw current-opt-if-och-mode-params 1111 +--rw mode-id? string 1112 +--rw central-frequency? frequency-thz 1113 +--rw channel-output-power? dbm-t 1114 +--ro channel-input-power? dbm-t 1115 . 1116 . 1117 . 1118 +--ro cur-osnr? int32 1119 +--ro cur-q-factor? int32 1120 +--ro uncorrected-words? uint64 1121 +--ro pre-fec-ber-mantissa? uint32 1122 +--ro pre-fec-ber-exponent? int32 1124 Authors' Addresses 1126 Gabriele Galimberti (editor) 1127 Cisco 1128 Via Santa Maria Molgora, 48 c 1129 20871 - Vimercate 1130 Italy 1132 Phone: +390392091462 1133 Email: ggalimbe@cisco.com 1134 Ruediger Kunze 1135 Deutsche Telekom 1136 Winterfeldtstr. 21-27 1137 10781 Berlin 1138 Germany 1140 Phone: +491702275321 1141 Email: RKunze@telekom.de 1143 Andreas Burk 1144 Deutsche Telekom 1145 Germany 1147 Phone: +49 1148 Email: andreas.burk@telekom.de 1150 Dharini Hiremagalur (editor) 1151 Juniper 1152 1133 Innovation Way 1153 Sunnyvale - 94089 California 1154 USA 1156 Email: dharinih@juniper.net 1158 Gert Grammel (editor) 1159 Juniper 1160 Oskar-Schlemmer Str. 15 1161 80807 Muenchen 1162 Germany 1164 Phone: +49 1725186386 1165 Email: ggrammel@juniper.net