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