idnits 2.17.1 draft-ietf-ccamp-dwdm-if-param-yang-02.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 499 has weird spacing: '... leaf tca-t...' == Line 503 has weird spacing: '... leaf min-t...' == Line 508 has weird spacing: '... leaf max-t...' == Line 532 has weird spacing: '... leaf pre-f...' == Line 536 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 (November 4, 2019) is 1625 days in the past. Is this intentional? Checking references for intended status: Experimental ---------------------------------------------------------------------------- == Missing Reference: 'RFC6241' is mentioned on line 851, but not defined == Missing Reference: 'RFC6242' is mentioned on line 853, but not defined == Missing Reference: 'RFC6536' is mentioned on line 853, but not defined ** Obsolete undefined reference: RFC 6536 (Obsoleted by RFC 8341) == Missing Reference: 'RFC3688' is mentioned on line 861, but not defined == Missing Reference: 'RFC6020' is mentioned on line 875, but not defined == Unused Reference: 'ITU.G694.1' is defined on line 930, but no explicit reference was found in the text == Unused Reference: 'ITU.G709' is defined on line 941, but no explicit reference was found in the text == Unused Reference: 'ITU.G7710' is defined on line 946, but no explicit reference was found in the text == Unused Reference: 'ITU.G798' is defined on line 951, but no explicit reference was found in the text == Unused Reference: 'ITU.G8201' is defined on line 957, but no explicit reference was found in the text == Unused Reference: 'ITU.G826' is defined on line 963, but no explicit reference was found in the text == Unused Reference: 'ITU.G872' is defined on line 969, but no explicit reference was found in the text == Unused Reference: 'ITU.G874' is defined on line 974, but no explicit reference was found in the text == Unused Reference: 'ITU.G959.1' is defined on line 985, but no explicit reference was found in the text == Unused Reference: 'RFC2578' is defined on line 995, but no explicit reference was found in the text == Unused Reference: 'RFC2579' is defined on line 1001, but no explicit reference was found in the text == Unused Reference: 'RFC2580' is defined on line 1006, but no explicit reference was found in the text == Unused Reference: 'RFC2863' is defined on line 1011, but no explicit reference was found in the text == Unused Reference: 'RFC3591' is defined on line 1015, but no explicit reference was found in the text == Unused Reference: 'RFC6205' is defined on line 1020, but no explicit reference was found in the text == Unused Reference: 'RFC2629' is defined on line 1027, but no explicit reference was found in the text == Unused Reference: 'RFC4054' is defined on line 1037, but no explicit reference was found in the text == Unused Reference: 'RFC4181' is defined on line 1042, 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: May 7, 2020 Deutsche Telekom 6 D. Hiremagalur, Ed. 7 G. Grammel, Ed. 8 Juniper 9 November 4, 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-02 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 May 7, 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 . . . . . . . . . . . . . . . . . . . 19 87 8. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 19 88 9. Acknowledgements . . . . . . . . . . . . . . . . . . . . . . 19 89 10. Contributors . . . . . . . . . . . . . . . . . . . . . . . . 19 90 11. References . . . . . . . . . . . . . . . . . . . . . . . . . 21 91 11.1. Normative References . . . . . . . . . . . . . . . . . . 21 92 11.2. Informative References . . . . . . . . . . . . . . . . . 23 93 Appendix A. Change Log . . . . . . . . . . . . . . . . . . . . . 23 94 Appendix B. Open Issues . . . . . . . . . . . . . . . . . . . . 23 95 Authors' Addresses . . . . . . . . . . . . . . . . . . . . . . . 23 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 draft-ietf-ccamp-dwdm-if-param-yang-02 { 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-11-04" { 370 description 371 "Revision 1.4"; 372 reference 373 ""; 374 } 376 revision "2019-07-08" { 377 description 378 "Revision 1.3"; 379 reference 380 ""; 381 } 382 revision "2018-10-22" { 383 description 384 "Revision 1.2"; 385 reference 386 ""; 387 } 388 revision "2018-03-06" { 389 description 390 "Revision 1.1"; 391 reference 392 ""; 393 } 394 revision "2017-03-06" { 395 description 396 "Revision 1.0"; 397 reference 398 ""; 399 } 400 revision "2016-03-17" { 401 description 402 "Initial revision."; 403 reference 404 ""; 405 } 407 typedef dbm-t { 408 type decimal64 { 409 fraction-digits 2; 410 range "-50..-30 | -10..5 | 10000000"; 411 } 412 description " 413 Amplifier Power in dBm"; 414 } 415 typedef opt-if-och-tca-types { 416 type enumeration { 417 enum max-laser-linewdt { 418 description "The maximum laser linewidth"; 419 } 420 enum min-tx-power-tca { 421 description "The min tx power TCA"; 422 } 423 enum max-tx-power-tca { 424 description "The min tx power TCA"; 425 } 426 enum min-rx-power-tca{ 427 description "The min tx power TCA"; 428 } 429 enum max-rx-power-tca{ 430 description "The min tx power TCA"; 431 } 432 enum max-pol-power-diff-tca{ 433 description "The power difference between polarization TCA"; 434 } 435 enum max-pol-skew-diff-tca{ 436 description "The skew between the two polarization TCA"; 437 } 438 enum min-frequency-offset-tca{ 439 description "Min Frequency offset TCA"; 440 } 441 enum max-frequency-offset-tca{ 442 description "Max Frequency offset TCA"; 443 } 444 enum min-osnr-tca{ 445 description "Min OSNR TCA"; 446 } 447 enum max-osnr-tca{ 448 description "Max OSNR TCA"; 449 } 450 enum min-laser-temperature-tca{ 451 description "The min tx power TCA"; 452 } 453 enum max-laser-temperature-tca{ 454 description "Temperature TCA"; 455 } 456 enum min-fec-ber-tca{ 457 description "Min Pre Fec BER TCA"; 458 } 459 enum max-fec-ber-tca{ 460 description "Max Pre Fec BER TCA"; 461 } 462 enum min-q-tca{ 463 description "Min Q TCA"; 464 } 465 enum max-q-tca { 466 description "Max Q TCA"; 467 } 468 } 469 description "The different types of TCA's"; 470 } 472 grouping opt-if-och-power { 473 description "Interface optical Power"; 475 leaf channel-output-power { 476 type int32; 477 units ".01dbm"; 478 description "The output power for this interface in .01 dBm. 479 The setting of the output power is optional"; 480 } 482 leaf channel-input-power { 483 type int32; 484 units ".01dbm"; 485 config false; 486 description "The current channel input power of this interface"; 487 } 489 leaf total-input-power { 490 type int32; 491 units ".01dbm"; 492 config false; 493 description "The total input power of this interface"; 494 } 495 } 497 grouping opt-if-och-tca-thresholds { 498 description "Thresholds for TCA's"; 499 leaf tca-type { 500 type opt-if-och-tca-types; 501 description "type of the TCA eg TX Power"; 502 } 503 leaf min-threshold { 504 type int32; 505 description "A TCA is generated if the variable is less than 506 this value"; 507 } 508 leaf max-threshold { 509 type int32; 510 description "A TCA is generated if the variable is more than 511 this value"; 512 } 513 } 515 grouping opt-if-och-fec { 516 description "FEC info"; 517 leaf fec-info { 518 type string { length "1..255"; } 519 config false; 520 description "FEC Type - eg GFEC"; 521 } 522 leaf fec-bitrate { 523 type string { length "1..255"; } 524 config false; 525 description "FEC Overhead rate "; 526 } 527 leaf fec-gain { 528 type string { length "1..255"; } 529 config false; 530 description "FEC Overhead rate "; 531 } 532 leaf pre-fec-ber-mantissa-threshold { 533 type uint32; 534 description "Mantissa of the FEC BER threshold"; 535 } 536 leaf pre-fec-ber-exponent-threshold { 537 type int32; 538 description "Exponent of the FEC BER threshold"; 539 } 540 } 542 grouping opt-if-och-central-frequency { 543 description "Interface Central Frequency"; 544 leaf central-frequency { 545 type uint32; 546 description "This parameter indicates the frequency of this 547 interface "; 548 } 549 } 551 grouping opt-if-och-modulation-params { 552 description "Optical modulation parameters for the lane"; 554 leaf modulation-format { 555 type string { length "1..255"; } 556 config false; 557 description "Modulation format for this mode"; 558 } 559 leaf baud-rate { 560 type uint32; 561 description "Baud-rate or symbol rate"; 562 } 563 leaf bits-per-symbol { 564 type uint32; 565 description "This parameter the bits per symbol for this mode"; 566 } 567 leaf num-symbols-in-alphabet { 568 type uint32; 569 description "This parameter the bits per symbol for this mode"; 570 } 571 leaf symbols-index { 572 type uint32; 573 description "This parameter is the symbol index this mode"; 574 } 575 } 577 grouping opt-if-och-lane-param { 578 description "Optical parameters for the lane"; 580 leaf number-of-lanes { 581 type uint32; 582 config false; 583 description "Number of optical lanes of this interface"; 584 } 585 leaf min-laser-temperature { 586 type int32; 587 units ".01C"; 588 config false; 589 description "Minimum Laser Temperature of this mode for this 590 lane"; 591 } 592 leaf max-laser-temperature { 593 type int32; 594 units ".01C"; 595 config false; 596 description "Maximum Laser Temperature of this mode for this 597 lane"; 598 } 599 leaf max-total-rx-optical-power { 600 type dbm-t; 601 config false; 602 description "Maximum rx optical power of this mode for this 603 lane"; 604 } 605 leaf max-chromatic-dispersion { 606 type int32; 607 config false; 608 description "Maximum chromatic dispersion of this mode for this 609 lane"; 610 } 611 leaf max-diff-group-delay { 612 type int32; 613 config false; 614 description "Maximum Differential group delay of this mode for 615 this lane"; 616 } 617 uses opt-if-och-modulation-params; 618 } 620 grouping opt-if-och-tca-list { 621 description "List of TCA's"; 622 leaf number-of-tcas-supported { 623 type uint32; 624 description "Number of TCAs supported by this interface"; 625 } 626 list mode-list { 627 key "tca-type"; 628 description "List of the TCAs"; 629 uses opt-if-och-tca-thresholds; 630 } 631 } 633 grouping opt-if-och-fec-tca-thresholds { 634 description "Pre FEC BER Thresholds for TCA's"; 635 leaf min-fec-ber-mantissa-threshold { 636 type uint32; 637 description "Min Mantissa of the FEC BER threshold"; 638 } 639 leaf min-fec-ber-exponent-threshold { 640 type int32; 641 description "Min Exponent of the FEC BER threshold"; 642 } 643 leaf max-fec-ber-mantissa-threshold { 644 type uint32; 645 description "Max Mantissa of the FEC BER threshold"; 646 } 647 leaf max-fec-ber-exponent-threshold { 648 type int32; 649 description "Max Exponent of the FEC BER threshold"; 650 } 651 } 653 grouping opt-if-och-mode-params { 654 description "OCh mode parameters"; 656 leaf mode-id { 657 type string { length "1..255"; } 658 description "ID for the OCh mode template"; 659 } 660 leaf min-osnr-margin { 661 type int32; 662 units "dB"; 663 config false; 664 description "OSNR margin to FEC threshold"; 665 } 666 leaf q-margin { 667 type int32; 668 units "dB"; 669 config false; 670 description "Q-Factor margin to FEC threshold"; 671 } 672 uses opt-if-och-central-frequency; 673 uses opt-if-och-power; 674 uses opt-if-och-fec-tca-thresholds; 675 uses opt-if-och-tca-list; 676 } 678 grouping opt-if-och-statistics { 679 description "OCh statistics"; 680 leaf cur-osnr { 681 type int32; 682 units "dB"; 683 config false; 684 description "OSNR margin to FEC threshold"; 685 } 686 leaf cur-q-factor { 687 type int32; 688 units "dB"; 689 config false; 690 description "Q-Factor of the interface"; 691 } 692 leaf uncorrected-words { 693 type uint64; 694 config false; 695 description "Post-FEC errored words"; 696 } 697 leaf pre-fec-ber-mantissa { 698 type uint32; 699 config false; 700 description "Pre-FEC errored words mantissa"; 701 } 702 leaf pre-fec-ber-exponent { 703 type int32; 704 config false; 705 description "Pre-FEC errored words exponent"; 706 } 707 } 708 grouping opt-if-och-mode { 709 description "OCh mode template"; 711 leaf mode-id { 712 type string { length "1..255"; } 713 config false; 714 description "ID for the OCh mode template"; 715 } 716 leaf application-identifier { 717 type uint32; 718 config false; 719 description "This parameter indicates the application identifier 720 according to G.698.2"; 721 } 722 leaf min-central-frequency { 723 type uint32; 724 config false; 725 description "This parameter indicates the minimum frequency for 726 this template"; 727 } 728 leaf max-central-frequency { 729 type uint32; 730 config false; 731 description "This parameter indicates the minimum frequency for 732 this template"; 733 } 734 leaf min-channel-input-power { 735 type dbm-t; 736 config false; 737 description "The minimum input power of this interface"; 738 } 739 leaf max-channel-input-power { 740 type dbm-t; 741 config false; 742 description "The maximum input power of this interface"; 743 } 744 leaf min-channel-output-power { 745 type dbm-t; 746 config false; 747 description "The minimum output power of this interface"; 748 } 749 leaf max-channel-output-power { 750 type dbm-t; 751 config false; 752 description "The maximum output power of this interface"; 753 } 754 leaf osnr-margin { 755 type int32; 756 units "dB"; 757 config false; 758 description "OSNR margin to FEC threshold"; 759 } 760 leaf q-margin { 761 type int32; 762 units "dB"; 763 config false; 764 description "Q-Factor margin to FEC threshold"; 765 } 766 uses opt-if-och-fec; 767 uses opt-if-och-lane-param; 768 } 770 grouping opt-if-och-mode-list { 771 description "List of Mode list group"; 773 leaf number-of-modes-supported { 774 type uint32; 775 description "Number of modes supported by this interface"; 776 } 777 list mode-list { 778 key "mode-id"; 779 description "List of the modes"; 780 uses opt-if-och-mode; 781 } 782 } 784 notification opt-if-och-central-frequency-change { 785 description "A change of Central Frequency has been detected"; 787 leaf "if-name" { 788 type leafref { path "/if:interfaces/if:interface/if:name"; } 789 description "Interface name"; 790 } 791 container new-opt-if-och-central-frequency { 792 description "The new Central Frequency of the interface"; 793 uses opt-if-och-central-frequency; 794 } 795 } 797 notification opt-if-och-mode-change { 798 description "A change of Mode Template has been detected"; 800 leaf "if-name" { 801 type leafref { path "/if:interfaces/if:interface/if:name"; } 802 description "Interface name"; 803 } 804 leaf mode-id { 805 type string { length "1..255"; } 806 description "ID for the OCh mode template"; 807 } 808 } 810 notification opt-if-och-min-tca { 811 description "A min output TCA notification"; 813 leaf "if-name" { 814 type leafref { path "/if:interfaces/if:interface/if:name"; } 815 description "Interface name"; 816 } 817 leaf tca-type { 818 type opt-if-och-tca-types; 819 description "Type of TCA for eg min tx power TCA"; 820 } 821 } 823 augment "/if:interfaces/if:interface" { 824 description "Parameters for an optical interface"; 826 container optIfOChRsSs { 827 description "RsSs path configuration for an interface"; 829 container if-current-mode { 830 description "Current mode template of the interface"; 831 uses opt-if-och-mode; 832 } 833 container if-supported-mode { 834 config false; 835 description "Supported mode list of this interface"; 836 uses opt-if-och-mode-list; 837 } 838 container current-opt-if-och-mode-params { 839 description "Current parameters of this interface"; 840 uses opt-if-och-mode-params; 841 uses opt-if-och-statistics; 842 } 843 } 844 } 845 } 847 848 7. Security Considerations 850 The YANG module defined in this memo is designed to be accessed via 851 the NETCONF protocol [RFC6241]. he lowest NETCONF layer is the secure 852 transport layer and the mandatory-to-implement secure transport is 853 SSH [RFC6242]. The NETCONF access control model [RFC6536] provides 854 the means to restrict access for particular NETCONF users to a pre- 855 configured subset of all available NETCONF protocol operation and 856 content. 858 8. IANA Considerations 860 This document registers a URI in the IETF XML registry [RFC3688]. 861 Following the format in [RFC3688], the following registration is 862 requested to be made: 864 URI: urn:ietf:params:xml:ns:yang:ietf-interfaces:ietf-ext-xponder- 865 wdm-if 867 Registrant Contact: The IESG. 869 XML: N/A, the requested URI is an XML namespace. 871 This document registers a YANG module in the YANG Module Names 872 registry [RFC6020]. 874 This document registers a YANG module in the YANG Module Names 875 registry [RFC6020]. 877 prefix: ietf-ext-xponder-wdm-if reference: RFC XXXX 879 9. Acknowledgements 881 10. Contributors 882 Dean Bogdanovic 883 Westford 884 U.S.A. 885 email ivandean@gmail.com 887 Bernd Zeuner 888 Deutsche Telekom 889 Darmstadt 890 Germany 891 email B.Zeuner@telekom.de 893 Massimiliano Salsi 894 Juniper Networks 895 1133 Innovation Way 896 Sunnyvale, CA, 94089 897 U.S.A. 898 +1 408936847 899 email msalsi@google.com 901 Arnold Mattheus 902 Deutsche Telekom 903 Darmstadt 904 Germany 905 email a.mattheus@telekom.de 907 Manuel Paul 908 Deutsche Telekom 909 Berlin 910 Germany 911 email Manuel.Paul@telekom.de 913 Walid Wakim 914 Cisco 915 9501 Technology Blvd 916 ROSEMONT, ILLINOIS 60018 917 UNITED STATES 918 email wwakim@cisco.com 920 Kam Lam 921 Nokia 922 USA 923 +1 732 331 3476 924 kam.lam@nokia.com 926 11. References 928 11.1. Normative References 930 [ITU.G694.1] 931 International Telecommunications Union, "Spectral grids 932 for WDM applications: DWDM frequency grid", 933 ITU-T Recommendation G.694.1, February 2012. 935 [ITU.G698.2] 936 International Telecommunications Union, "Amplified 937 multichannel dense wavelength division multiplexing 938 applications with single channel optical interfaces", 939 ITU-T Recommendation G.698.2, November 2009. 941 [ITU.G709] 942 International Telecommunications Union, "Interface for the 943 Optical Transport Network (OTN)", ITU-T Recommendation 944 G.709, June 2016. 946 [ITU.G7710] 947 International Telecommunications Union, "Common equipment 948 management function requirements", ITU-T Recommendation 949 G.7710, August 2017. 951 [ITU.G798] 952 International Telecommunications Union, "Characteristics 953 of optical transport network hierarchy equipment 954 functional blocks", ITU-T Recommendation G.798, Devember 955 2017. 957 [ITU.G8201] 958 International Telecommunications Union, "Error performance 959 parameters and objectives for multi-operator international 960 paths within the Optical Transport Network (OTN)", 961 ITU-T Recommendation G.8201, April 2011. 963 [ITU.G826] 964 International Telecommunications Union, "End-to-end error 965 performance parameters and objectives for international, 966 constant bit-rate digital paths and connections", 967 ITU-T Recommendation G.826, December 2002. 969 [ITU.G872] 970 International Telecommunications Union, "Architecture of 971 optical transport networks", ITU-T Recommendation G.872, 972 January 2017. 974 [ITU.G874] 975 International Telecommunications Union, "Management 976 aspects of optical transport network elements", 977 ITU-T Recommendation G.874, July 2010. 979 [ITU.G874.1] 980 International Telecommunications Union, "Optical transport 981 network (OTN): Protocol-neutral management information 982 model for the network element view", ITU-T Recommendation 983 G.874.1, November 2016. 985 [ITU.G959.1] 986 International Telecommunications Union, "Optical transport 987 network physical layer interfaces", ITU-T Recommendation 988 G.959.1, November 2009. 990 [RFC2119] Bradner, S., "Key words for use in RFCs to Indicate 991 Requirement Levels", BCP 14, RFC 2119, 992 DOI 10.17487/RFC2119, March 1997, 993 . 995 [RFC2578] McCloghrie, K., Ed., Perkins, D., Ed., and J. 996 Schoenwaelder, Ed., "Structure of Management Information 997 Version 2 (SMIv2)", STD 58, RFC 2578, 998 DOI 10.17487/RFC2578, April 1999, 999 . 1001 [RFC2579] McCloghrie, K., Ed., Perkins, D., Ed., and J. 1002 Schoenwaelder, Ed., "Textual Conventions for SMIv2", 1003 STD 58, RFC 2579, DOI 10.17487/RFC2579, April 1999, 1004 . 1006 [RFC2580] McCloghrie, K., Ed., Perkins, D., Ed., and J. 1007 Schoenwaelder, Ed., "Conformance Statements for SMIv2", 1008 STD 58, RFC 2580, DOI 10.17487/RFC2580, April 1999, 1009 . 1011 [RFC2863] McCloghrie, K. and F. Kastenholz, "The Interfaces Group 1012 MIB", RFC 2863, DOI 10.17487/RFC2863, June 2000, 1013 . 1015 [RFC3591] Lam, H-K., Stewart, M., and A. Huynh, "Definitions of 1016 Managed Objects for the Optical Interface Type", RFC 3591, 1017 DOI 10.17487/RFC3591, September 2003, 1018 . 1020 [RFC6205] Otani, T., Ed. and D. Li, Ed., "Generalized Labels for 1021 Lambda-Switch-Capable (LSC) Label Switching Routers", 1022 RFC 6205, DOI 10.17487/RFC6205, March 2011, 1023 . 1025 11.2. Informative References 1027 [RFC2629] Rose, M., "Writing I-Ds and RFCs using XML", RFC 2629, 1028 DOI 10.17487/RFC2629, June 1999, 1029 . 1031 [RFC3410] Case, J., Mundy, R., Partain, D., and B. Stewart, 1032 "Introduction and Applicability Statements for Internet- 1033 Standard Management Framework", RFC 3410, 1034 DOI 10.17487/RFC3410, December 2002, 1035 . 1037 [RFC4054] Strand, J., Ed. and A. Chiu, Ed., "Impairments and Other 1038 Constraints on Optical Layer Routing", RFC 4054, 1039 DOI 10.17487/RFC4054, May 2005, 1040 . 1042 [RFC4181] Heard, C., Ed., "Guidelines for Authors and Reviewers of 1043 MIB Documents", BCP 111, RFC 4181, DOI 10.17487/RFC4181, 1044 September 2005, . 1046 Appendix A. Change Log 1048 This optional section should be removed before the internet draft is 1049 submitted to the IESG for publication as an RFC. 1051 Note to RFC Editor: please remove this appendix before publication as 1052 an RFC. 1054 Appendix B. Open Issues 1056 Note to RFC Editor: please remove this appendix before publication as 1057 an RFC. 1059 Authors' Addresses 1060 Gabriele Galimberti (editor) 1061 Cisco 1062 Via Santa Maria Molgora, 48 c 1063 20871 - Vimercate 1064 Italy 1066 Phone: +390392091462 1067 Email: ggalimbe@cisco.com 1069 Ruediger Kunze 1070 Deutsche Telekom 1071 Winterfeldtstr. 21-27 1072 10781 Berlin 1073 Germany 1075 Phone: +491702275321 1076 Email: RKunze@telekom.de 1078 Dharini Hiremagalur (editor) 1079 Juniper 1080 1133 Innovation Way 1081 Sunnyvale - 94089 California 1082 USA 1084 Email: dharinih@juniper.net 1086 Gert Grammel (editor) 1087 Juniper 1088 Oskar-Schlemmer Str. 15 1089 80807 Muenchen 1090 Germany 1092 Phone: +49 1725186386 1093 Email: ggrammel@juniper.net