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