idnits 2.17.1 draft-ietf-ccamp-dwdm-if-param-yang-00.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 484 has weird spacing: '... leaf tca-t...' == Line 488 has weird spacing: '... leaf min-t...' == Line 494 has weird spacing: '... leaf max-t...' == Line 528 has weird spacing: '... leaf fec-b...' == Line 533 has weird spacing: '... leaf fec-b...' == (20 more instances...) == The document doesn't use any RFC 2119 keywords, yet seems to have RFC 2119 boilerplate text. -- The document date (March 26, 2019) is 1857 days in the past. Is this intentional? Checking references for intended status: Experimental ---------------------------------------------------------------------------- == Missing Reference: 'RFC6241' is mentioned on line 889, but not defined == Missing Reference: 'RFC6242' is mentioned on line 891, but not defined == Missing Reference: 'RFC6536' is mentioned on line 891, but not defined ** Obsolete undefined reference: RFC 6536 (Obsoleted by RFC 8341) == Missing Reference: 'RFC3688' is mentioned on line 899, but not defined == Missing Reference: 'RFC6020' is mentioned on line 913, but not defined == Unused Reference: 'ITU.G694.1' is defined on line 968, but no explicit reference was found in the text == Unused Reference: 'ITU.G709' is defined on line 979, but no explicit reference was found in the text == Unused Reference: 'ITU.G7710' is defined on line 984, but no explicit reference was found in the text == Unused Reference: 'ITU.G798' is defined on line 989, but no explicit reference was found in the text == Unused Reference: 'ITU.G8201' is defined on line 995, but no explicit reference was found in the text == Unused Reference: 'ITU.G826' is defined on line 1001, but no explicit reference was found in the text == Unused Reference: 'ITU.G872' is defined on line 1007, but no explicit reference was found in the text == Unused Reference: 'ITU.G874' is defined on line 1012, but no explicit reference was found in the text == Unused Reference: 'ITU.G959.1' is defined on line 1023, but no explicit reference was found in the text == Unused Reference: 'RFC2578' is defined on line 1033, but no explicit reference was found in the text == Unused Reference: 'RFC2579' is defined on line 1039, but no explicit reference was found in the text == Unused Reference: 'RFC2580' is defined on line 1044, but no explicit reference was found in the text == Unused Reference: 'RFC2863' is defined on line 1049, but no explicit reference was found in the text == Unused Reference: 'RFC3591' is defined on line 1053, but no explicit reference was found in the text == Unused Reference: 'RFC6205' is defined on line 1058, but no explicit reference was found in the text == Unused Reference: 'I-D.ietf-ccamp-dwdm-if-mng-ctrl-fwk' is defined on line 1065, but no explicit reference was found in the text == Unused Reference: 'RFC2629' is defined on line 1071, but no explicit reference was found in the text == Unused Reference: 'RFC4054' is defined on line 1081, but no explicit reference was found in the text == Unused Reference: 'RFC4181' is defined on line 1086, 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: September 27, 2019 Deutsche Telekom 6 D. Hiremagalur, Ed. 7 G. Grammel, Ed. 8 Juniper 9 March 26, 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-00 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 September 27, 2019. 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 . . . . . . . . . . . . . . . . . . . . . . . . . 7 86 7. Security Considerations . . . . . . . . . . . . . . . . . . . 19 87 8. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 20 88 9. Acknowledgements . . . . . . . . . . . . . . . . . . . . . . 20 89 10. Contributors . . . . . . . . . . . . . . . . . . . . . . . . 20 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 avaiable 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-identifer? 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-input-power? dbm-t 270 | +--ro max-input-power? dbm-t 271 | +--ro min-output-power? dbm-t 272 | +--ro max-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 fec-ber-mantissa-threshold? uint32 279 | +--ro 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 bits-per-symbol? uint32 288 | +--ro num-symbols-in-alphabet? uint32 289 | +--ro symbols-index? uint32 290 +--rw current-opt-if-och-mode-params 291 +--rw mode-id? string 292 +--rw central-frequency? uint32 293 +--rw output-power? int32 294 +--ro input-power? int32 295 +--rw min-fec-ber-mantissa-threshold? uint32 296 +--rw min-fec-ber-exponent-threshold? int32 297 +--rw max-fec-ber-mantissa-threshold? uint32 298 +--rw max-fec-ber-exponent-threshold? int32 299 +--rw number-of-tcas-supported? uint32 300 +--rw mode-list* [tca-type] 301 | +--rw tca-type opt-if-och-tca-types 302 | +--rw min-threshold? int32 303 | +--rw max-threshold? int32 304 +--ro cur-osnr? int32 305 +--ro cur-q-factor? int32 306 +--ro uncorrected-words? uint64 307 +--ro fec-ber-mantissa? uint32 308 +--ro fec-ber-exponent? int32 310 notifications: 311 +---n opt-if-och-central-frequency-change 312 | +--ro if-name? -> /if:interfaces/interface/name 313 | +--ro new-opt-if-och-central-frequency 314 | +--ro central-frequency? uint32 315 +---n opt-if-och-mode-change 316 | +--ro if-name? -> /if:interfaces/interface/name 317 | +--ro mode-id? string 318 +---n opt-if-och-min-tca 319 +--ro if-name? -> /if:interfaces/interface/name 320 +--ro tca-type? opt-if-och-tca-types 322 5. Structure of the Yang Module 324 ietf-ext-xponder-wdm-if is a top level model for the support of this 325 feature. 327 6. Yang Module 329 The ietf-ext-xponder-wdm-if is defined as an extension to ietf 330 interfaces. 332 file "ietf-ext-xponder-wdm-if.yang" 334 module ietf-ext-xponder-wdm-if { 335 namespace "urn:ietf:params:xml:ns:yang:ietf-ext-xponder-wdm-if"; 336 prefix ietf-ext-xponder-wdm-if; 338 import ietf-interfaces { 339 prefix if; 340 } 342 organization 343 "IETF CCAMP 344 Working Group"; 346 contact 347 "WG Web: 348 WG List: 350 Editor: Dharini Hiremagalur 351 "; 353 description 354 "This module contains a collection of YANG definitions for 355 configuring Optical interfaces. 357 Copyright (c) 2016 IETF Trust and the persons identified 358 as authors of the code. All rights reserved. 360 Redistribution and use in source and binary forms, with or 361 without modification, is permitted pursuant to, and 362 subject to the license terms contained in, the Simplified 363 BSD License set forth in Section 4.c of the IETF Trust's 364 Legal Provisions Relating to IETF Documents 365 (http://trustee.ietf.org/license-info)."; 367 revision "2018-10-22" { 368 description 369 "Revision 1.2"; 370 reference 371 ""; 372 } 374 revision "2018-03-06" { 375 description 376 "Revision 1.1"; 377 reference 378 ""; 380 } 382 revision "2017-03-06" { 383 description 384 "Revision 1.0"; 385 reference 386 ""; 387 } 388 revision "2016-03-17" { 389 description 390 "Initial revision."; 391 reference 392 ""; 393 } 395 typedef dbm-t { 396 type decimal64 { 397 fraction-digits 2; 398 range "-50..-30 | -10..5 | 10000000"; 399 } 400 description " 401 Amplifier Power in dBm "; 402 } 403 typedef opt-if-och-tca-types { 405 type enumeration { 406 enum max-laser-linewdt { 407 description " The maximum laser linewidth"; 408 } 409 enum min-tx-power-tca { 410 description " The min tx power tca"; 411 } 412 enum max-tx-power-tca { 413 description " The min tx power tca"; 414 } 415 enum min-rx-power-tca{ 416 description " The min tx power tca"; 417 } 418 enum max-rx-power-tca{ 419 description " The min tx power tca"; 420 } 421 enum max-pol-power-diff-tca{ 422 description " The power diff. between polariz. tca"; 423 } 424 enum max-pol-skew-diff-tca{ 425 description " The Skew between the two polariz. tca"; 427 } 428 enum min-frequency-offset-tca{ 429 description " Min Frequency offset tca"; 430 } 431 enum max-frequency-offset-tca{ 432 description " Max Frequency offset tca"; 433 } 434 enum min-osnr-tca{ 435 description " Min OSNR tca"; 436 } 437 enum max-osnr-tca{ 438 description " Max OSNR tca"; 439 } 440 enum min-laser-temperature-tca{ 441 description " The min tx power tca"; 442 } 443 enum max-laser-temperature-tca{ 444 description " Temperature tca"; 445 } 446 enum min-fec-ber-tca{ 447 description " Min Pre Fec BER tca"; 448 } 449 enum max-fec-ber-tca{ 450 description " Max Pre Fec BER tca"; 451 } 452 enum min-q-tca{ 453 description "Min Q tca"; 454 } 455 enum max-q-tca { 456 description "Max Q tca"; 457 } 458 } 459 description " The different types of TCA's"; 460 } 462 grouping opt-if-och-power { 463 description "Interface optical Power"; 464 leaf output-power { 465 type int32; 466 units ".01dbm"; 467 description "The output power for this interface 468 in .01 dBm. 469 The setting of the output power is 470 optional"; 471 } 473 leaf input-power { 474 type int32; 475 units ".01dbm"; 476 config false; 477 description "The current input power of this 478 interface"; 479 } 480 } 482 grouping opt-if-och-tca-thresholds { 483 description "Thresholds for TCA's"; 484 leaf tca-type { 485 type opt-if-och-tca-types; 486 description "type of the TCA eg TX Power"; 487 } 488 leaf min-threshold { 489 type int32; 490 description " A TCA is generated if the variable is 491 less than this value"; 493 } 494 leaf max-threshold { 495 type int32; 496 description " A TCA is generated if the variable is 497 more than this value"; 498 } 499 } 501 grouping opt-if-och-fec { 502 description "Fec info"; 503 leaf fec-info { 504 type string { 505 length "1..255"; 506 } 507 config false; 508 description 509 "Fec Type - eg GFEC"; 510 } 511 leaf fec-bitrate { 512 type string { 513 length "1..255"; 514 } 515 config false; 516 description 517 "Fec Overhead rate "; 518 } 519 leaf fec-gain { 520 type string { 521 length "1..255"; 523 } 524 config false; 525 description 526 "Fec Overhead rate "; 527 } 528 leaf fec-ber-mantissa-threshold { 529 type uint32; 530 description " Mantissa of the FEC BER threshold"; 532 } 533 leaf fec-ber-exponent-threshold { 534 type int32; 535 description " Exponent of the FEC BER threshold"; 536 } 537 } 539 grouping opt-if-och-central-frequency { 540 description "Interface Central Frequency"; 541 leaf central-frequency { 542 type uint32; 543 description " This parameter indicates the frequency 544 of this interface "; 545 } 546 } 548 } 550 grouping opt-if-och-modulation-params { 551 description "Optical modulation parameters for the lane"; 552 leaf modulation-format { 553 type string { 554 length "1..255"; 555 } 556 config false; 557 description 558 "Modulation format for this mode"; 559 } 560 leaf bits-per-symbol { 561 type uint32; 562 description " This parameter the bits per symbol for 563 this mode."; 565 } 566 leaf num-symbols-in-alphabet { 567 type uint32; 568 description " This parameter the bits per symbol for 569 this mode."; 571 } 572 leaf symbols-index { 573 type uint32; 574 description " This parameter is the symbol index this 575 mode."; 577 } 579 grouping opt-if-och-lane-param { 580 description "Optical parameters for the lane"; 581 leaf number-of-lanes { 582 type uint32; 583 config false; 584 description 585 "Number of optical lanes of this interface"; 586 } 587 leaf min-laser-temperature { 588 type int32; 589 units ".01C"; 590 config false; 591 description 592 "Minimum Laser Temperature of this mode for 593 this interface"; 594 } 595 leaf max-laser-temperature { 596 type int32; 597 units ".01C"; 598 config false; 599 description 600 "Maximum Laser Temperature of this mode for 601 this interface"; 602 } 603 leaf max-total-rx-optical-power { 604 type dbm-t; 605 config false; 606 description 607 "Maximum rx optical power of this mode for 608 this interface"; 609 } 610 leaf max-chromatic-dispersion { 611 type int32; 612 config false; 613 description 614 "Maximum chromatic dispersion of this 615 mode for this interface"; 616 } 617 leaf max-diff-group-delay { 618 type int32; 619 config false; 620 description 621 "Maximum Differential group delay of this 622 mode for this interface"; 623 } 624 uses opt-if-och-modulation-params; 625 } 627 grouping opt-if-och-tca-list { 628 description "List of TCA's."; 629 leaf number-of-tcas-supported { 630 type uint32; 631 description "Number of tcas 632 supported by this interface"; 633 } 634 list mode-list { 635 key "tca-type"; 636 description "List of the tcas"; 637 uses opt-if-och-tca-thresholds; 638 } 639 } 641 grouping opt-if-och-fec-tca-thresholds { 642 description "Pre FEC BER Thresholds for TCA's"; 643 leaf min-fec-ber-mantissa-threshold { 644 type uint32; 645 description " Min Mantissa of the FEC BER threshold"; 647 } 648 leaf min-fec-ber-exponent-threshold { 649 type int32; 650 description " Min Exponent of the FEC BER threshold"; 652 } 653 leaf max-fec-ber-mantissa-threshold { 654 type uint32; 655 description " Max Mantissa of the FEC BER threshold"; 657 } 658 leaf max-fec-ber-exponent-threshold { 659 type int32; 660 description " Max Exponent of the FEC BER threshold"; 662 } 663 } 664 grouping opt-if-och-mode-params { 665 description "OCh mode parameters."; 666 leaf mode-id { 667 type string { 668 length "1..255"; 669 } 670 description 671 "Id for the OCh mode template"; 672 } 673 leaf osnr-margin { 674 type int32; 675 units "dB"; 676 config false; 677 description " OSNR margin to FEC threshold"; 678 } 679 leaf q-margin { 680 type int32; 681 units "dB"; 682 config false; 683 description " Q-Factor margin to FEC threshold"; 684 } 685 uses opt-if-och-central-frequency; 686 uses opt-if-och-power; 687 uses opt-if-och-fec-tca-thresholds; 688 uses opt-if-och-tca-list; 690 } 692 grouping opt-if-och-statistics { 693 description "OCh statistics."; 694 leaf cur-osnr { 695 type int32; 696 units "dB"; 697 config false; 698 description " OSNR margin to FEC threshold"; 699 } 700 leaf cur-q-factor { 701 type int32; 702 units "dB"; 703 config false; 704 description " Q-Factor of the interface"; 705 } 706 leaf uncorrected-words { 707 type uint64; 708 config false; 709 description " Post FEC errored words"; 710 } 711 leaf fec-ber-mantissa { 712 type uint32; 713 config false; 714 description " Pre fec FEC errored words mantissa"; 715 } 716 leaf fec-ber-exponent { 717 type int32; 718 config false; 719 description " Pre fec FEC errored words exponent"; 720 } 721 } 723 grouping opt-if-och-mode { 724 description "OCh mode template."; 725 leaf mode-id { 726 type string { 727 length "1..255"; 728 } 729 config false; 730 description 731 "Id for the OCh mode template"; 732 } 733 leaf application-identifier { 734 type uint32; 735 config false; 736 description "This parameter indicates the 737 application identifier according 738 toG.698.2"; 739 } 740 leaf min-central-frequency { 741 type uint32; 742 config false; 743 description "This parameter indicates the minimum 744 frequency for this template "; 745 } 746 leaf max-central-frequency { 747 type uint32; 748 config false; 749 description "This parameter indicates the minimum 750 frequency for this template "; 751 } 752 leaf min-input-power { 753 type dbm-t; 754 config false; 755 description "The minimum input power of this 756 interface"; 757 } 758 leaf max-input-power { 759 type dbm-t; 760 config false; 761 description "The maximum input power of this 762 interface"; 763 } 764 leaf min-output-power { 765 type dbm-t; 766 config false; 767 description "The minimum output power of this 768 interface"; 769 } 770 leaf max-output-power { 771 type dbm-t; 772 config false; 773 description "The maximum output power of this 774 interface"; 775 } 776 leaf osnr-margin { 777 type int32; 778 units "dB"; 779 config false; 780 description "OSNR margin to FEC threshold"; 781 } 782 leaf q-margin { 783 type int32; 784 units "dB"; 785 config false; 786 description "Q-Factor margin to FEC threshold"; 787 } 788 uses opt-if-och-fec; 789 uses opt-if-och-lane-param; 791 } 793 grouping opt-if-och-mode-list { 794 description "List of Mode list group."; 795 leaf number-of-modes-supported { 796 type uint32; 797 description "Number of modes 798 supported by this interface"; 799 } 800 list mode-list { 801 key "mode-id"; 802 description "List of the modes "; 803 uses opt-if-och-mode; 804 } 806 } 808 notification opt-if-och-central-frequency-change { 809 description "A change of Central Frequency has been 810 detected."; 811 leaf "if-name" { 812 type leafref { 813 path "/if:interfaces/if:interface/if:name"; 814 } 815 description "Interface name"; 816 } 817 container new-opt-if-och-central-frequency { 818 description "The new Central Frequency of the 819 interface"; 820 uses opt-if-och-central-frequency; 821 } 822 } 824 notification opt-if-och-mode-change { 825 description "A change of Mode Template has been 826 detected."; 827 leaf "if-name" { 828 type leafref { 829 path "/if:interfaces/if:interface/if:name"; 830 } 831 description "Interface name"; 832 } 833 leaf mode-id { 834 type string { 835 length "1..255"; 836 } 837 description "Id for the OCh mode template"; 838 } 840 } 842 notification opt-if-och-min-tca { 843 description "A min output TCA notification."; 844 leaf "if-name" { 845 type leafref { 846 path "/if:interfaces/if:interface/if:name"; 847 } 848 description "Interface name"; 849 } 850 leaf tca-type { 851 type opt-if-och-tca-types; 852 description "Type of TCA for eg min tx power TCA"; 854 } 855 } 857 augment "/if:interfaces/if:interface" { 858 description "Parameters for an optical interface"; 859 container optIfOChRsSs { 860 description "RsSs path configuration for an interface"; 861 container if-current-mode { 862 description "Current mode template of the 863 interface"; 864 uses opt-if-och-mode; 865 } 867 container if-supported-mode { 868 config false; 869 description "Supported mode list of 870 this interface"; 871 uses opt-if-och-mode-list; 872 } 873 container current-opt-if-och-mode-params { 874 description "Current parameters of 875 this interface"; 876 uses opt-if-och-mode-params; 877 uses opt-if-och-statistics; 878 } 880 } 881 } 882 } 884 886 7. Security Considerations 888 The YANG module defined in this memo is designed to be accessed via 889 the NETCONF protocol [RFC6241]. he lowest NETCONF layer is the secure 890 transport layer and the mandatory-to-implement secure transport is 891 SSH [RFC6242]. The NETCONF access control model [RFC6536] provides 892 the means to restrict access for particular NETCONF users to a pre- 893 configured subset of all available NETCONF protocol operation and 894 content. 896 8. IANA Considerations 898 This document registers a URI in the IETF XML registry [RFC3688]. 899 Following the format in [RFC3688], the following registration is 900 requested to be made: 902 URI: urn:ietf:params:xml:ns:yang:ietf-interfaces:ietf-ext-xponder- 903 wdm-if 905 Registrant Contact: The IESG. 907 XML: N/A, the requested URI is an XML namespace. 909 This document registers a YANG module in the YANG Module Names 910 registry [RFC6020]. 912 This document registers a YANG module in the YANG Module Names 913 registry [RFC6020]. 915 prefix: ietf-ext-xponder-wdm-if reference: RFC XXXX 917 9. Acknowledgements 919 10. Contributors 920 Dean Bogdanovic 921 Westford 922 U.S.A. 923 email ivandean@gmail.com 925 Bernd Zeuner 926 Deutsche Telekom 927 Darmstadt 928 Germany 929 email B.Zeuner@telekom.de 931 Massimiliano Salsi 932 Juniper Networks 933 1133 Innovation Way 934 Sunnyvale, CA, 94089 935 U.S.A. 936 +1 408936847 937 email msalsi@google.com 939 Arnold Mattheus 940 Deutsche Telekom 941 Darmstadt 942 Germany 943 email a.mattheus@telekom.de 945 Manuel Paul 946 Deutsche Telekom 947 Berlin 948 Germany 949 email Manuel.Paul@telekom.de 951 Walid Wakim 952 Cisco 953 9501 Technology Blvd 954 ROSEMONT, ILLINOIS 60018 955 UNITED STATES 956 email wwakim@cisco.com 958 Kam Lam 959 Nokia 960 USA 961 +1 732 331 3476 962 kam.lam@nokia.com 964 11. References 966 11.1. Normative References 968 [ITU.G694.1] 969 International Telecommunications Union, "Spectral grids 970 for WDM applications: DWDM frequency grid", 971 ITU-T Recommendation G.694.1, February 2012. 973 [ITU.G698.2] 974 International Telecommunications Union, "Amplified 975 multichannel dense wavelength division multiplexing 976 applications with single channel optical interfaces", 977 ITU-T Recommendation G.698.2, November 2009. 979 [ITU.G709] 980 International Telecommunications Union, "Interface for the 981 Optical Transport Network (OTN)", ITU-T Recommendation 982 G.709, June 2016. 984 [ITU.G7710] 985 International Telecommunications Union, "Common equipment 986 management function requirements", ITU-T Recommendation 987 G.7710, August 2017. 989 [ITU.G798] 990 International Telecommunications Union, "Characteristics 991 of optical transport network hierarchy equipment 992 functional blocks", ITU-T Recommendation G.798, Devember 993 2017. 995 [ITU.G8201] 996 International Telecommunications Union, "Error performance 997 parameters and objectives for multi-operator international 998 paths within the Optical Transport Network (OTN)", 999 ITU-T Recommendation G.8201, April 2011. 1001 [ITU.G826] 1002 International Telecommunications Union, "End-to-end error 1003 performance parameters and objectives for international, 1004 constant bit-rate digital paths and connections", 1005 ITU-T Recommendation G.826, December 2002. 1007 [ITU.G872] 1008 International Telecommunications Union, "Architecture of 1009 optical transport networks", ITU-T Recommendation G.872, 1010 January 2017. 1012 [ITU.G874] 1013 International Telecommunications Union, "Management 1014 aspects of optical transport network elements", 1015 ITU-T Recommendation G.874, July 2010. 1017 [ITU.G874.1] 1018 International Telecommunications Union, "Optical transport 1019 network (OTN): Protocol-neutral management information 1020 model for the network element view", ITU-T Recommendation 1021 G.874.1, November 2016. 1023 [ITU.G959.1] 1024 International Telecommunications Union, "Optical transport 1025 network physical layer interfaces", ITU-T Recommendation 1026 G.959.1, November 2009. 1028 [RFC2119] Bradner, S., "Key words for use in RFCs to Indicate 1029 Requirement Levels", BCP 14, RFC 2119, 1030 DOI 10.17487/RFC2119, March 1997, 1031 . 1033 [RFC2578] McCloghrie, K., Ed., Perkins, D., Ed., and J. 1034 Schoenwaelder, Ed., "Structure of Management Information 1035 Version 2 (SMIv2)", STD 58, RFC 2578, 1036 DOI 10.17487/RFC2578, April 1999, 1037 . 1039 [RFC2579] McCloghrie, K., Ed., Perkins, D., Ed., and J. 1040 Schoenwaelder, Ed., "Textual Conventions for SMIv2", 1041 STD 58, RFC 2579, DOI 10.17487/RFC2579, April 1999, 1042 . 1044 [RFC2580] McCloghrie, K., Ed., Perkins, D., Ed., and J. 1045 Schoenwaelder, Ed., "Conformance Statements for SMIv2", 1046 STD 58, RFC 2580, DOI 10.17487/RFC2580, April 1999, 1047 . 1049 [RFC2863] McCloghrie, K. and F. Kastenholz, "The Interfaces Group 1050 MIB", RFC 2863, DOI 10.17487/RFC2863, June 2000, 1051 . 1053 [RFC3591] Lam, H-K., Stewart, M., and A. Huynh, "Definitions of 1054 Managed Objects for the Optical Interface Type", RFC 3591, 1055 DOI 10.17487/RFC3591, September 2003, 1056 . 1058 [RFC6205] Otani, T., Ed. and D. Li, Ed., "Generalized Labels for 1059 Lambda-Switch-Capable (LSC) Label Switching Routers", 1060 RFC 6205, DOI 10.17487/RFC6205, March 2011, 1061 . 1063 11.2. Informative References 1065 [I-D.ietf-ccamp-dwdm-if-mng-ctrl-fwk] 1066 Kunze, R., Grammel, G., Beller, D., Galimberti, G., and J. 1067 Meuric, "A framework for Management and Control of DWDM 1068 optical interface parameters", draft-ietf-ccamp-dwdm-if- 1069 mng-ctrl-fwk-11 (work in progress), June 2018. 1071 [RFC2629] Rose, M., "Writing I-Ds and RFCs using XML", RFC 2629, 1072 DOI 10.17487/RFC2629, June 1999, 1073 . 1075 [RFC3410] Case, J., Mundy, R., Partain, D., and B. Stewart, 1076 "Introduction and Applicability Statements for Internet- 1077 Standard Management Framework", RFC 3410, 1078 DOI 10.17487/RFC3410, December 2002, 1079 . 1081 [RFC4054] Strand, J., Ed. and A. Chiu, Ed., "Impairments and Other 1082 Constraints on Optical Layer Routing", RFC 4054, 1083 DOI 10.17487/RFC4054, May 2005, 1084 . 1086 [RFC4181] Heard, C., Ed., "Guidelines for Authors and Reviewers of 1087 MIB Documents", BCP 111, RFC 4181, DOI 10.17487/RFC4181, 1088 September 2005, . 1090 Appendix A. Change Log 1092 This optional section should be removed before the internet draft is 1093 submitted to the IESG for publication as an RFC. 1095 Note to RFC Editor: please remove this appendix before publication as 1096 an RFC. 1098 Appendix B. Open Issues 1100 Note to RFC Editor: please remove this appendix before publication as 1101 an RFC. 1103 Authors' Addresses 1105 Gabriele Galimberti (editor) 1106 Cisco 1107 Via Santa Maria Molgora, 48 c 1108 20871 - Vimercate 1109 Italy 1111 Phone: +390392091462 1112 Email: ggalimbe@cisco.com 1114 Ruediger Kunze 1115 Deutsche Telekom 1116 Winterfeldtstr. 21-27 1117 10781 Berlin 1118 Germany 1120 Phone: +491702275321 1121 Email: RKunze@telekom.de 1123 Dharini Hiremagalur (editor) 1124 Juniper 1125 1133 Innovation Way 1126 Sunnyvale - 94089 California 1127 USA 1129 Email: dharinih@juniper.net 1131 Gert Grammel (editor) 1132 Juniper 1133 Oskar-Schlemmer Str. 15 1134 80807 Muenchen 1135 Germany 1137 Phone: +49 1725186386 1138 Email: ggrammel@juniper.net