idnits 2.17.1 draft-dharini-ccamp-dwdm-if-param-yang-04.txt: Checking boilerplate required by RFC 5378 and the IETF Trust (see https://trustee.ietf.org/license-info): ---------------------------------------------------------------------------- No issues found here. Checking nits according to https://www.ietf.org/id-info/1id-guidelines.txt: ---------------------------------------------------------------------------- No issues found here. Checking nits according to https://www.ietf.org/id-info/checklist : ---------------------------------------------------------------------------- ** The abstract seems to contain references ([ITU.G698.2]), which it shouldn't. Please replace those with straight textual mentions of the documents in question. Miscellaneous warnings: ---------------------------------------------------------------------------- == The copyright year in the IETF Trust and authors Copyright Line does not match the current year == Line 488 has weird spacing: '... leaf tca-t...' == Line 492 has weird spacing: '... leaf min-t...' == Line 498 has weird spacing: '... leaf max-t...' == Line 531 has weird spacing: '... leaf fec-b...' == Line 536 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 1, 2018) is 2249 days in the past. Is this intentional? Checking references for intended status: Experimental ---------------------------------------------------------------------------- == Missing Reference: 'RFC6241' is mentioned on line 953, but not defined == Missing Reference: 'RFC6242' is mentioned on line 955, but not defined == Missing Reference: 'RFC6536' is mentioned on line 955, but not defined ** Obsolete undefined reference: RFC 6536 (Obsoleted by RFC 8341) == Missing Reference: 'RFC3688' is mentioned on line 963, but not defined == Missing Reference: 'RFC6020' is mentioned on line 977, but not defined == Unused Reference: 'ITU.G694.1' is defined on line 1032, but no explicit reference was found in the text == Unused Reference: 'ITU.G709' is defined on line 1043, but no explicit reference was found in the text == Unused Reference: 'ITU.G7710' is defined on line 1048, but no explicit reference was found in the text == Unused Reference: 'ITU.G798' is defined on line 1053, but no explicit reference was found in the text == Unused Reference: 'ITU.G8201' is defined on line 1059, but no explicit reference was found in the text == Unused Reference: 'ITU.G826' is defined on line 1065, but no explicit reference was found in the text == Unused Reference: 'ITU.G872' is defined on line 1071, but no explicit reference was found in the text == Unused Reference: 'ITU.G874' is defined on line 1076, but no explicit reference was found in the text == Unused Reference: 'ITU.G959.1' is defined on line 1087, but no explicit reference was found in the text == Unused Reference: 'RFC2578' is defined on line 1097, but no explicit reference was found in the text == Unused Reference: 'RFC2579' is defined on line 1103, but no explicit reference was found in the text == Unused Reference: 'RFC2580' is defined on line 1108, but no explicit reference was found in the text == Unused Reference: 'RFC2863' is defined on line 1113, but no explicit reference was found in the text == Unused Reference: 'RFC3591' is defined on line 1117, but no explicit reference was found in the text == Unused Reference: 'RFC6205' is defined on line 1122, but no explicit reference was found in the text == Unused Reference: 'I-D.ietf-ccamp-dwdm-if-mng-ctrl-fwk' is defined on line 1129, but no explicit reference was found in the text == Unused Reference: 'RFC2629' is defined on line 1135, but no explicit reference was found in the text == Unused Reference: 'RFC4054' is defined on line 1145, but no explicit reference was found in the text == Unused Reference: 'RFC4181' is defined on line 1150, 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: September 2, 2018 Deutsche Telekom 6 D. Hiremagalur, Ed. 7 G. Grammel, Ed. 8 Juniper 9 March 1, 2018 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-04 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. 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 https://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 September 2, 2018. 51 Copyright Notice 53 Copyright (c) 2018 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 (https://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 . . . . . . . . . . . . . . . . . . . . . . 21 83 10. Contributors . . . . . . . . . . . . . . . . . . . . . . . . 21 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 RFC7698 and draft-many-coherent- 105 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)."; 379 revision "2018-03-06" { 380 description 381 "Revision 1.1"; 382 reference 383 ""; 384 } 386 revision "2017-03-06" { 387 description 388 "Revision 1.0"; 389 reference 390 ""; 391 } 392 revision "2016-03-17" { 393 description 394 "Initial revision."; 395 reference 396 ""; 397 } 399 typedef dbm-t { 400 type decimal64 { 401 fraction-digits 2; 402 range "-50..-30 | -10..5 | 10000000"; 403 } 404 description " 405 Amplifier Power in dBm "; 406 } 407 typedef opt-if-och-tca-types { 409 type enumeration { 410 enum max-laser-linewdt { 411 description " The maximum laser linewidth"; 412 } 413 enum min-tx-power-tca { 414 description " The min tx power tca"; 415 } 416 enum max-tx-power-tca { 417 description " The min tx power tca"; 418 } 419 enum min-rx-power-tca{ 420 description " The min tx power tca"; 421 } 422 enum max-rx-power-tca{ 423 description " The min tx power tca"; 424 } 425 enum max-pol-power-diff-tca{ 426 description " The power diff. between polariz. tca"; 427 } 428 enum max-pol-skew-diff-tca{ 429 description " The Skew between the two polariz. tca"; 430 } 431 enum min-frequency-offset-tca{ 432 description " Min Frequency offset tca"; 433 } 434 enum max-frequency-offset-tca{ 435 description " Max Frequency offset tca"; 436 } 437 enum min-osnr-tca{ 438 description " Min OSNR tca"; 439 } 440 enum max-osnr-tca{ 441 description " Max OSNR tca"; 442 } 443 enum min-laser-temperature-tca{ 444 description " The min tx power tca"; 445 } 446 enum max-laser-temperature-tca{ 447 description " Temperature tca"; 448 } 449 enum min-fec-ber-tca{ 450 description " Min Pre Fec BER tca"; 451 } 452 enum max-fec-ber-tca{ 453 description " Max Pre Fec BER tca"; 454 } 455 enum min-q-tca{ 456 description "Min Q tca"; 457 } 458 enum max-q-tca { 459 description "Max Q tca"; 460 } 461 } 462 description " The different types of TCA's"; 463 } 465 grouping opt-if-och-power { 466 description "Interface optical Power"; 467 leaf output-power { 468 type int32; 469 units ".01dbm"; 470 description "The output power for this interface 471 in .01 dBm. 473 The setting of the output power is 474 optional"; 475 } 477 leaf input-power { 478 type int32; 479 units ".01dbm"; 480 config false; 481 description "The current input power of this 482 interface"; 483 } 484 } 486 grouping opt-if-och-tca-thresholds { 487 description "Thresholds for TCA's"; 488 leaf tca-type { 489 type opt-if-och-tca-types; 490 description "type of the TCA eg TX Power"; 491 } 492 leaf min-threshold { 493 type int32; 494 description " A TCA is generated if the variable is 495 less than this value"; 497 } 498 leaf max-threshold { 499 type int32; 500 description " A TCA is generated if the variable is 501 more than this value"; 502 } 503 } 505 grouping opt-if-och-fec { 506 description "Fec info"; 507 leaf fec-info { 508 type string { 509 length "1..255"; 510 } 511 config false; 512 description 513 "Fec Type - eg GFEC"; 514 } 515 leaf fec-bitrate { 516 type string { 517 length "1..255"; 518 } 519 config false; 520 description 521 "Fec Overhead rate "; 522 } 523 leaf fec-gain { 524 type string { 525 length "1..255"; 526 } 527 config false; 528 description 529 "Fec Overhead rate "; 530 } 531 leaf fec-ber-mantissa-threshold { 532 type uint32; 533 description " Mantissa of the FEC BER threshold"; 535 } 536 leaf 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 547 of this interface "; 548 } 549 } 551 grouping opt-if-och-constellation { 552 description "Optical constellation parameters"; 553 leaf i-center { 554 type int32; 555 units ".0001"; 556 config false; 557 description "The In-phase coordinate of the selected 558 constellation symbol for this mode"; 559 } 560 leaf q-center { 561 type int32; 562 units ".0001"; 563 config false; 564 description "The Quadrature coordinate of the selected 565 constellation symbol for this mode"; 566 } 567 leaf i-noise-variance { 568 type int32; 569 units ".001"; 570 config false; 571 description "The Variance of the in-phase noise 572 component for this mode"; 573 } 574 leaf q-noise-variance { 575 type int32; 576 units ".001"; 577 config false; 578 description "The Variance of the quadrature noise 579 component for this mode"; 580 } 581 leaf a-noise-variance { 582 type int32; 583 units ".001"; 584 config false; 585 description "The Variance of the radial noise 586 component for this mode"; 587 } 588 leaf p-noise-variance { 589 type int32; 590 units ".001"; 591 config false; 592 description "The Variance of the phase noise 593 component for this mode"; 594 } 595 } 597 grouping opt-if-och-modulation-params { 598 description "Optical modulation parameters for the lane"; 599 leaf modulation-format { 600 type string { 601 length "1..255"; 602 } 603 config false; 604 description 605 "Modulation format for this mode"; 606 } 607 leaf bits-per-symbol { 608 type uint32; 609 description " This parameter the bits per symbol for 610 this mode."; 612 } 613 leaf num-symbols-in-alphabet { 614 type uint32; 615 description " This parameter the bits per symbol for 616 this mode."; 618 } 619 leaf symbols-index { 620 type uint32; 621 description " This parameter is the symbol index this 622 mode."; 624 } 625 uses opt-if-och-constellation; 627 } 629 grouping opt-if-och-lane-param { 630 description "Optical parameters for the lane"; 631 leaf number-of-lanes { 632 type uint32; 633 config false; 634 description 635 "Number of optical lanes of this interface"; 636 } 637 leaf min-laser-temperature { 638 type int32; 639 units ".01C"; 640 config false; 641 description 642 "Minimum Laser Temperature of this mode for 643 this interface"; 644 } 645 leaf max-laser-temperature { 646 type int32; 647 units ".01C"; 648 config false; 649 description 650 "Maximum Laser Temperature of this mode for 651 this interface"; 652 } 653 leaf min-rx-optical-power { 654 type dbm-t; 655 config false; 656 description 657 "Minimum rx optical power of this mode for 658 this interface"; 659 } 660 leaf max-rx-optical-power { 661 type dbm-t; 662 config false; 663 description 664 "Maximum rx optical power of this mode for 665 this interface"; 667 } 668 leaf min-chromatic-dispersion { 669 type int32; 670 config false; 671 description 672 "Minimum chromatic dispersion of this mode 673 for this interface"; 674 } 675 leaf max-chromatic-dispersion { 676 type int32; 677 config false; 678 description 679 "Maximum chromatic dispersion of this 680 mode for this interface"; 681 } 682 leaf min-diff-group-delay { 683 type int32; 684 config false; 685 description 686 "Minimum Differential group delay of this 687 mode for this interface"; 688 } 689 leaf max-diff-group-delay { 690 type int32; 691 config false; 692 description 693 "Maximum Differential group delay of this 694 mode for this interface"; 695 } 696 uses opt-if-och-modulation-params; 697 } 699 grouping opt-if-och-tca-list { 700 description "List of TCA's."; 701 leaf number-of-tcas-supported { 702 type uint32; 703 description "Number of tcas 704 supported by this interface"; 705 } 706 list mode-list { 707 key "tca-type"; 708 description "List of the tcas"; 709 uses opt-if-och-tca-thresholds; 710 } 711 } 712 grouping opt-if-och-fec-tca-thresholds { 713 description "Pre FEC BER Thresholds for TCA's"; 714 leaf min-fec-ber-mantissa-threshold { 715 type uint32; 716 description " Min Mantissa of the FEC BER threshold"; 718 } 719 leaf min-fec-ber-exponent-threshold { 720 type int32; 721 description " Min Exponent of the FEC BER threshold"; 723 } 724 leaf max-fec-ber-mantissa-threshold { 725 type uint32; 726 description " Max Mantissa of the FEC BER threshold"; 728 } 729 leaf max-fec-ber-exponent-threshold { 730 type int32; 731 description " Max Exponent of the FEC BER threshold"; 733 } 734 } 736 grouping opt-if-och-mode-params { 737 description "OCh mode parameters."; 738 leaf mode-id { 739 type string { 740 length "1..255"; 741 } 742 description 743 "Id for the OCh mode template"; 744 } 745 leaf osnr-margin { 746 type int32; 747 units "dB"; 748 config false; 749 description " OSNR margin to FEC threshold"; 750 } 751 leaf q-margin { 752 type int32; 753 units "dB"; 754 config false; 755 description " Q-Factor margin to FEC threshold"; 756 } 757 uses opt-if-och-central-frequency; 758 uses opt-if-och-power; 759 uses opt-if-och-fec-tca-thresholds; 760 uses opt-if-och-tca-list; 762 } 764 grouping opt-if-och-statistics { 765 description "OCh statistics."; 766 leaf cur-osnr { 767 type int32; 768 units "dB"; 769 config false; 770 description " OSNR margin to FEC threshold"; 771 } 772 leaf cur-q-factor { 773 type int32; 774 units "dB"; 775 config false; 776 description " Q-Factor of the interface"; 777 } 778 leaf uncorrected-words { 779 type uint64; 780 config false; 781 description " Post FEC errored words"; 782 } 783 leaf fec-ber-mantissa { 784 type uint32; 785 config false; 786 description " Pre fec FEC errored words mantissa"; 787 } 788 leaf fec-ber-exponent { 789 type int32; 790 config false; 791 description " Pre fec FEC errored words exponent"; 792 } 793 } 795 grouping opt-if-och-mode { 796 description "OCh mode template."; 797 leaf mode-id { 798 type string { 799 length "1..255"; 800 } 801 config false; 802 description 803 "Id for the OCh mode template"; 804 } 805 leaf min-central-frequency { 806 type uint32; 807 config false; 808 description "This parameter indicates the minimum 809 frequency for this template "; 810 } 811 leaf max-central-frequency { 812 type uint32; 813 config false; 814 description "This parameter indicates the minimum 815 frequency for this template "; 816 } 817 leaf min-input-power { 818 type dbm-t; 819 config false; 820 description "The minimum input power of this 821 interface"; 822 } 823 leaf max-input-power { 824 type dbm-t; 825 config false; 826 description "The maximum input power of this 827 interface"; 828 } 829 leaf min-output-power { 830 type dbm-t; 831 config false; 832 description "The minimum output power of this 833 interface"; 834 } 835 leaf max-output-power { 836 type dbm-t; 837 config false; 838 description "The maximum output power of this 839 interface"; 840 } 841 leaf osnr-margin { 842 type int32; 843 units "dB"; 844 config false; 845 description "OSNR margin to FEC threshold"; 846 } 847 leaf q-margin { 848 type int32; 849 units "dB"; 850 config false; 851 description "Q-Factor margin to FEC threshold"; 852 } 853 uses opt-if-och-fec; 854 uses opt-if-och-lane-param; 856 } 858 grouping opt-if-och-mode-list { 859 description "List of Mode list group."; 860 leaf number-of-modes-supported { 861 type uint32; 862 description "Number of modes 863 supported by this interface"; 864 } 865 list mode-list { 866 key "mode-id"; 867 description "List of the modes "; 868 uses opt-if-och-mode; 869 } 870 } 872 notification opt-if-och-central-frequency-change { 873 description "A change of Central Frequency has been 874 detected."; 875 leaf "if-name" { 876 type leafref { 877 path "/if:interfaces/if:interface/if:name"; 878 } 879 description "Interface name"; 880 } 881 container new-opt-if-och-central-frequency { 882 description "The new Central Frequency of the 883 interface"; 884 uses opt-if-och-central-frequency; 885 } 886 } 888 notification opt-if-och-mode-change { 889 description "A change of Mode Template has been 890 detected."; 891 leaf "if-name" { 892 type leafref { 893 path "/if:interfaces/if:interface/if:name"; 894 } 895 description "Interface name"; 896 } 897 leaf mode-id { 898 type string { 899 length "1..255"; 901 } 902 description "Id for the OCh mode template"; 903 } 905 } 907 notification opt-if-och-min-tca { 908 description "A min output TCA notification."; 909 leaf "if-name" { 910 type leafref { 911 path "/if:interfaces/if:interface/if:name"; 912 } 913 description "Interface name"; 914 } 915 leaf tca-type { 916 type opt-if-och-tca-types; 917 description "Type of TCA for eg min tx power TCA"; 918 } 919 } 921 augment "/if:interfaces/if:interface" { 922 description "Parameters for an optical interface"; 923 container optIfOChRsSs { 924 description "RsSs path configuration for an interface"; 925 container if-current-mode { 926 description "Current mode template of the 927 interface"; 928 uses opt-if-och-mode; 929 } 931 container if-supported-mode { 932 config false; 933 description "Supported mode list of 934 this interface"; 935 uses opt-if-och-mode-list; 936 } 937 container current-opt-if-och-mode-params { 938 description "Current parameters of 939 this interface"; 940 uses opt-if-och-mode-params; 941 uses opt-if-och-statistics; 942 } 944 } 945 } 946 } 948 950 7. Security Considerations 952 The YANG module defined in this memo is designed to be accessed via 953 the NETCONF protocol [RFC6241]. he lowest NETCONF layer is the secure 954 transport layer and the mandatory-to-implement secure transport is 955 SSH [RFC6242]. The NETCONF access control model [RFC6536] provides 956 the means to restrict access for particular NETCONF users to a pre- 957 configured subset of all available NETCONF protocol operation and 958 content. 960 8. IANA Considerations 962 This document registers a URI in the IETF XML registry [RFC3688]. 963 Following the format in [RFC3688], the following registration is 964 requested to be made: 966 URI: urn:ietf:params:xml:ns:yang:ietf-interfaces:ietf-ext-xponder- 967 wdm-if 969 Registrant Contact: The IESG. 971 XML: N/A, the requested URI is an XML namespace. 973 This document registers a YANG module in the YANG Module Names 974 registry [RFC6020]. 976 This document registers a YANG module in the YANG Module Names 977 registry [RFC6020]. 979 prefix: ietf-ext-xponder-wdm-if reference: RFC XXXX 981 9. Acknowledgements 983 10. Contributors 984 Dean Bogdanovic 985 Westford 986 U.S.A. 987 email ivandean@gmail.com 989 Bernd Zeuner 990 Deutsche Telekom 991 Darmstadt 992 Germany 993 email B.Zeuner@telekom.de 995 Massimiliano Salsi 996 Juniper Networks 997 1133 Innovation Way 998 Sunnyvale, CA, 94089 999 U.S.A. 1000 +1 408936847 1001 email msalsi@juniper.net 1003 Arnold Mattheus 1004 Deutsche Telekom 1005 Darmstadt 1006 Germany 1007 email a.mattheus@telekom.de 1009 Manuel Paul 1010 Deutsche Telekom 1011 Berlin 1012 Germany 1013 email Manuel.Paul@telekom.de 1015 Walid Wakim 1016 Cisco 1017 9501 Technology Blvd 1018 ROSEMONT, ILLINOIS 60018 1019 UNITED STATES 1020 email wwakim@cisco.com 1022 Kam Lam 1023 Nokia 1024 USA 1025 +1 732 331 3476 1026 kam.lam@nokia.com 1028 11. References 1030 11.1. Normative References 1032 [ITU.G694.1] 1033 International Telecommunications Union, "Spectral grids 1034 for WDM applications: DWDM frequency grid", 1035 ITU-T Recommendation G.694.1, June 2002. 1037 [ITU.G698.2] 1038 International Telecommunications Union, "Amplified 1039 multichannel dense wavelength division multiplexing 1040 applications with single channel optical interfaces", 1041 ITU-T Recommendation G.698.2, November 2009. 1043 [ITU.G709] 1044 International Telecommunications Union, "Interface for the 1045 Optical Transport Network (OTN)", ITU-T Recommendation 1046 G.709, March 2003. 1048 [ITU.G7710] 1049 International Telecommunications Union, "Common equipment 1050 management function requirements", ITU-T Recommendation 1051 G.7710, May 2008. 1053 [ITU.G798] 1054 International Telecommunications Union, "Characteristics 1055 of optical transport network hierarchy equipment 1056 functional blocks", ITU-T Recommendation G.798, October 1057 2010. 1059 [ITU.G8201] 1060 International Telecommunications Union, "Error performance 1061 parameters and objectives for multi-operator international 1062 paths within the Optical Transport Network (OTN)", 1063 ITU-T Recommendation G.8201, April 2011. 1065 [ITU.G826] 1066 International Telecommunications Union, "End-to-end error 1067 performance parameters and objectives for international, 1068 constant bit-rate digital paths and connections", 1069 ITU-T Recommendation G.826, November 2009. 1071 [ITU.G872] 1072 International Telecommunications Union, "Architecture of 1073 optical transport networks", ITU-T Recommendation G.872, 1074 November 2001. 1076 [ITU.G874] 1077 International Telecommunications Union, "Management 1078 aspects of optical transport network elements", 1079 ITU-T Recommendation G.874, July 2010. 1081 [ITU.G874.1] 1082 International Telecommunications Union, "Optical transport 1083 network (OTN): Protocol-neutral management information 1084 model for the network element view", ITU-T Recommendation 1085 G.874.1, January 2002. 1087 [ITU.G959.1] 1088 International Telecommunications Union, "Optical transport 1089 network physical layer interfaces", ITU-T Recommendation 1090 G.959.1, November 2009. 1092 [RFC2119] Bradner, S., "Key words for use in RFCs to Indicate 1093 Requirement Levels", BCP 14, RFC 2119, 1094 DOI 10.17487/RFC2119, March 1997, 1095 . 1097 [RFC2578] McCloghrie, K., Ed., Perkins, D., Ed., and J. 1098 Schoenwaelder, Ed., "Structure of Management Information 1099 Version 2 (SMIv2)", STD 58, RFC 2578, 1100 DOI 10.17487/RFC2578, April 1999, 1101 . 1103 [RFC2579] McCloghrie, K., Ed., Perkins, D., Ed., and J. 1104 Schoenwaelder, Ed., "Textual Conventions for SMIv2", 1105 STD 58, RFC 2579, DOI 10.17487/RFC2579, April 1999, 1106 . 1108 [RFC2580] McCloghrie, K., Ed., Perkins, D., Ed., and J. 1109 Schoenwaelder, Ed., "Conformance Statements for SMIv2", 1110 STD 58, RFC 2580, DOI 10.17487/RFC2580, April 1999, 1111 . 1113 [RFC2863] McCloghrie, K. and F. Kastenholz, "The Interfaces Group 1114 MIB", RFC 2863, DOI 10.17487/RFC2863, June 2000, 1115 . 1117 [RFC3591] Lam, H-K., Stewart, M., and A. Huynh, "Definitions of 1118 Managed Objects for the Optical Interface Type", RFC 3591, 1119 DOI 10.17487/RFC3591, September 2003, 1120 . 1122 [RFC6205] Otani, T., Ed. and D. Li, Ed., "Generalized Labels for 1123 Lambda-Switch-Capable (LSC) Label Switching Routers", 1124 RFC 6205, DOI 10.17487/RFC6205, March 2011, 1125 . 1127 11.2. Informative References 1129 [I-D.ietf-ccamp-dwdm-if-mng-ctrl-fwk] 1130 Kunze, R., Grammel, G., Beller, D., and G. Galimberti, "A 1131 framework for Management and Control of DWDM optical 1132 interface parameters", draft-ietf-ccamp-dwdm-if-mng-ctrl- 1133 fwk-00 (work in progress), April 2016. 1135 [RFC2629] Rose, M., "Writing I-Ds and RFCs using XML", RFC 2629, 1136 DOI 10.17487/RFC2629, June 1999, 1137 . 1139 [RFC3410] Case, J., Mundy, R., Partain, D., and B. Stewart, 1140 "Introduction and Applicability Statements for Internet- 1141 Standard Management Framework", RFC 3410, 1142 DOI 10.17487/RFC3410, December 2002, 1143 . 1145 [RFC4054] Strand, J., Ed. and A. Chiu, Ed., "Impairments and Other 1146 Constraints on Optical Layer Routing", RFC 4054, 1147 DOI 10.17487/RFC4054, May 2005, 1148 . 1150 [RFC4181] Heard, C., Ed., "Guidelines for Authors and Reviewers of 1151 MIB Documents", BCP 111, RFC 4181, DOI 10.17487/RFC4181, 1152 September 2005, . 1154 Appendix A. Change Log 1156 This optional section should be removed before the internet draft is 1157 submitted to the IESG for publication as an RFC. 1159 Note to RFC Editor: please remove this appendix before publication as 1160 an RFC. 1162 Appendix B. Open Issues 1164 Note to RFC Editor: please remove this appendix before publication as 1165 an RFC. 1167 Authors' Addresses 1169 Gabriele Galimberti (editor) 1170 Cisco 1171 Via Santa Maria Molgora, 48 c 1172 20871 - Vimercate 1173 Italy 1175 Phone: +390392091462 1176 Email: ggalimbe@cisco.com 1178 Ruediger Kunze 1179 Deutsche Telekom 1180 Winterfeldtstr. 21-27 1181 10781 Berlin 1182 Germany 1184 Phone: +491702275321 1185 Email: RKunze@telekom.de 1187 Dharini Hiremagalur (editor) 1188 Juniper 1189 1133 Innovation Way 1190 Sunnyvale - 94089 California 1191 USA 1193 Email: dharinih@juniper.net 1195 Gert Grammel (editor) 1196 Juniper 1197 Oskar-Schlemmer Str. 15 1198 80807 Muenchen 1199 Germany 1201 Phone: +49 1725186386 1202 Email: ggrammel@juniper.net