idnits 2.17.1 draft-galimbe-ccamp-iv-yang-12.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 : ---------------------------------------------------------------------------- No issues found here. Miscellaneous warnings: ---------------------------------------------------------------------------- == The copyright year in the IETF Trust and authors Copyright Line does not match the current year == The document doesn't use any RFC 2119 keywords, yet seems to have RFC 2119 boilerplate text. -- The document date (July 1, 2021) is 1029 days in the past. Is this intentional? Checking references for intended status: Informational ---------------------------------------------------------------------------- == Missing Reference: 'RFC6566' is mentioned on line 160, but not defined == Missing Reference: 'ITU.G680' is mentioned on line 159, but not defined == Missing Reference: 'RFC6241' is mentioned on line 909, but not defined == Missing Reference: 'RFC6242' is mentioned on line 911, but not defined == Missing Reference: 'RFC6536' is mentioned on line 911, but not defined ** Obsolete undefined reference: RFC 6536 (Obsoleted by RFC 8341) == Missing Reference: 'RFC3688' is mentioned on line 919, but not defined == Missing Reference: 'RFC6020' is mentioned on line 933, but not defined == Unused Reference: 'ITU.G694.1' is defined on line 976, but no explicit reference was found in the text == Unused Reference: 'ITU.G709' is defined on line 987, but no explicit reference was found in the text == Unused Reference: 'ITU.G7710' is defined on line 992, but no explicit reference was found in the text == Unused Reference: 'ITU.G798' is defined on line 997, but no explicit reference was found in the text == Unused Reference: 'ITU.G8201' is defined on line 1003, but no explicit reference was found in the text == Unused Reference: 'ITU.G826' is defined on line 1009, but no explicit reference was found in the text == Unused Reference: 'ITU.G872' is defined on line 1015, but no explicit reference was found in the text == Unused Reference: 'ITU.G874' is defined on line 1020, but no explicit reference was found in the text == Unused Reference: 'ITU.G874.1' is defined on line 1025, but no explicit reference was found in the text == Unused Reference: 'ITU.G959.1' is defined on line 1031, but no explicit reference was found in the text == Unused Reference: 'RFC2578' is defined on line 1041, but no explicit reference was found in the text == Unused Reference: 'RFC2579' is defined on line 1047, but no explicit reference was found in the text == Unused Reference: 'RFC2580' is defined on line 1052, but no explicit reference was found in the text == Unused Reference: 'RFC2863' is defined on line 1057, but no explicit reference was found in the text == Unused Reference: 'RFC3591' is defined on line 1061, but no explicit reference was found in the text == Unused Reference: 'RFC6205' is defined on line 1066, but no explicit reference was found in the text == Unused Reference: 'RFC2629' is defined on line 1073, but no explicit reference was found in the text == Unused Reference: 'RFC4054' is defined on line 1083, but no explicit reference was found in the text == Unused Reference: 'RFC4181' is defined on line 1088, but no explicit reference was found in the text -- Obsolete informational reference (is this intentional?): RFC 2629 (Obsoleted by RFC 7749) Summary: 1 error (**), 0 flaws (~~), 28 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: Informational R. Kunze, Ed. 5 Expires: January 2, 2022 Deutsche Telekom 6 D. Hiremagalur, Ed. 7 G. Grammel, Ed. 8 Juniper 9 July 1, 2021 11 A YANG model to manage the optical parameters for in a WDM network 12 draft-galimbe-ccamp-iv-yang-12 14 Abstract 16 This memo defines a Yang model that translate the information model 17 to support Impairment-Aware (IA) Routing and Wavelength Assignment 18 (RWA) functionality. The information model is defined in draft-ietf- 19 ccamp-wson-iv-info and draft-martinelli-ccamp-wson-iv-encode. This 20 document defines proper encoding and extend to the models defined in 21 draft-lee-ccamp-wson-yang tu support Impairment-Aware (IA) Routing 22 and Wavelength Assignment (RWA) functions 24 The Yang model defined in this memo can be used for Optical 25 Parameters monitoring and/or configuration of the multivendor 26 Endpoints and ROADMs. The use of this model does not guarantee 27 interworking of transceivers over a DWDM. Optical path feasibility 28 and interoperability has to be determined by means outside the scope 29 of this document. The purpose of this model is to program interface 30 parameters to consistently configure the mode of operation of 31 transceivers. 33 Copyright Notice 35 Copyright (c) 2014 IETF Trust and the persons identified as the 36 document authors. All rights reserved. 38 Status of This Memo 40 This Internet-Draft is submitted in full conformance with the 41 provisions of BCP 78 and BCP 79. 43 Internet-Drafts are working documents of the Internet Engineering 44 Task Force (IETF). Note that other groups may also distribute 45 working documents as Internet-Drafts. The list of current Internet- 46 Drafts is at https://datatracker.ietf.org/drafts/current/. 48 Internet-Drafts are draft documents valid for a maximum of six months 49 and may be updated, replaced, or obsoleted by other documents at any 50 time. It is inappropriate to use Internet-Drafts as reference 51 material or to cite them other than as "work in progress." 53 This Internet-Draft will expire on January 2, 2022. 55 Copyright Notice 57 Copyright (c) 2021 IETF Trust and the persons identified as the 58 document authors. All rights reserved. 60 This document is subject to BCP 78 and the IETF Trust's Legal 61 Provisions Relating to IETF Documents 62 (https://trustee.ietf.org/license-info) in effect on the date of 63 publication of this document. Please review these documents 64 carefully, as they describe your rights and restrictions with respect 65 to this document. Code Components extracted from this document must 66 include Simplified BSD License text as described in Section 4.e of 67 the Trust Legal Provisions and are provided without warranty as 68 described in the Simplified BSD License. 70 Table of Contents 72 1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . 3 73 2. The Internet-Standard Management Framework . . . . . . . . . 3 74 3. Conventions . . . . . . . . . . . . . . . . . . . . . . . . . 4 75 4. Definition . . . . . . . . . . . . . . . . . . . . . . . . . 4 76 5. Applicability . . . . . . . . . . . . . . . . . . . . . . . . 4 77 6. Properties . . . . . . . . . . . . . . . . . . . . . . . . . 4 78 7. Overview . . . . . . . . . . . . . . . . . . . . . . . . . . 4 79 7.1. Optical Parameters Description . . . . . . . . . . . . . 5 80 7.1.1. Optical path from point Ss to Rs . . . . . . . . . . 6 81 7.1.2. Rs and Ss Configuration . . . . . . . . . . . . . . . 7 82 7.1.3. Table of Application Codes . . . . . . . . . . . . . 7 83 7.2. Use Cases . . . . . . . . . . . . . . . . . . . . . . . . 7 84 7.3. Optical Parameters for impairment validation in a WDM 85 network . . . . . . . . . . . . . . . . . . . . . . . . . 7 86 8. Structure of the Yang Module . . . . . . . . . . . . . . . . 8 87 9. Yang Module . . . . . . . . . . . . . . . . . . . . . . . . . 9 88 10. Security Considerations . . . . . . . . . . . . . . . . . . . 20 89 11. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 20 90 12. Acknowledgements . . . . . . . . . . . . . . . . . . . . . . 21 91 13. Contributors . . . . . . . . . . . . . . . . . . . . . . . . 21 92 14. References . . . . . . . . . . . . . . . . . . . . . . . . . 22 93 14.1. Normative References . . . . . . . . . . . . . . . . . . 22 94 14.2. Informative References . . . . . . . . . . . . . . . . . 24 95 Appendix A. Change Log . . . . . . . . . . . . . . . . . . . . . 24 96 Appendix B. Open Issues . . . . . . . . . . . . . . . . . . . . 24 97 Authors' Addresses . . . . . . . . . . . . . . . . . . . . . . . 24 99 1. Introduction 101 This memo defines a Yang model that translates the existing mib 102 module defined in draft-ietf-ccamp-wson-iv-info and draft-martinelli- 103 ccamp-wson-iv-encode to provide the network impairment information to 104 an SDN controller. One of the key SDN controller features is to 105 support multivendor network and support the service calculation and 106 deployment in multilayer topologies, for the DWDM layer it is 107 fundamental that the SDN controller is aware of the optical 108 impairments to verify the feasibility of new circuits before their 109 provisioning. Although SDN controller will not apply exhaustive and 110 accurate algorithms and the optical channel feasibility verification 111 may have a degree of unreliability this function can work on a 112 multivendor common set of parameter and algorithms to ensure the 113 operator the best change to set a circuit. This document follows the 114 same impairment definition and applicability of draft-ietf-ccamp- 115 wson-iv-info. 117 The optical impairments related to the DWDM Transceiver are described 118 by draft draft-dharini-ccamp-if-param-yang. Applications are defined 119 in G.698.2 [ITU.G698.2] using optical interface parameters at the 120 single-channel connection points between optical transmitters and the 121 optical multiplexer, as well as between optical receivers and the 122 optical demultiplexer in the DWDM system. This Recommendation uses a 123 methodology which explicitly specify the details of the optical 124 network between reference point Ss and Rs, e.g., the passive and 125 active elements or details of the design. 127 The building of a yang model describing the optical parameters allows 128 the different vendors and operator to retrieve, provision and 129 exchange information across multi-vendor domains in a standardized 130 way. In addition to the parameters specified in ITU recommendations 131 the Yang models support also the "vendor specific parameters". 133 2. The Internet-Standard Management Framework 135 For a detailed overview of the documents that describe the current 136 Internet-Standard Management Framework, please refer to section 7 of 137 RFC 3410 [RFC3410]. 139 This memo specifies a Yang model for optical interfaces. 141 3. Conventions 143 The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", 144 "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this 145 document are to be interpreted as described in RFC 2119 [RFC2119] In 146 the description of OIDs the convention: Set (S) Get (G) and Trap (T) 147 conventions will describe the action allowed by the parameter. 149 4. Definition 151 For a detailed definition this draft refers to draft-ietf-ccamp-wson- 152 iv-info. 154 5. Applicability 156 This document targets at Scenario C defined in [RFC6566] section 157 4.1.1. as approximate impairment estimation. The Approximate 158 concept refer to the fact that this Information Model covers 159 information mainly provided by [ITU.G680] Computational Model. 160 Although the [RFC6566] provides no or little approximation the 161 parameters described in this draft can be applied to the algorithms 162 verifying the circuit feasibility in the new coherent non compensated 163 DWDM networks In this case the impairments verification can reach a 164 good reliability and accuracy. This draft does not address 165 computational matters but provides all the information suitable to 166 cover most of the full coherent network algorithms, not being 167 exhaustive the information can give a acceptable or even good 168 approximation in term of connection feasibility. This may not be 169 true for legacy compensated network. 171 6. Properties 173 For the signal properties this traft refers the draft-ietf-ccamp- 174 wson-iv-info Ch.2.3 with some extension of the parameters. 176 7. Overview 177 Figure 1 shows a set of reference points, for single-channel 178 connection between transmitters (Tx) and receivers (Rx). Here the 179 DWDM network elements include an OM and an OD (which are used as a 180 pair with the opposing element), one or more optical amplifiers and 181 may also include one or more OADMs. 183 +-------------------------------------------------+ 184 Ss | DWDM Network | Rs 185 +--+ | | | \ / | | | +--+ 186 Tx L1--|->| \ / |--|-->Rx L1 187 +---+ | | | +------+ | | | +--+ 188 +---+ | | | | | | | | +--+ 189 Tx L2--|->| OM |------------>|ROADM |-- -------->| OD |--|-->Rx L2 190 +---+ | | | DWDM | | DWDM | | | +--+ 191 +---+ | | | Link +------+ Link | | | +--+ 192 Tx L3--|->| / | ^ \ |--|-->Rx L3 193 +---+ | | / | | \ | | +--+ 194 +-----------------------|--|----------------------+ 195 +--+ +--+ 196 | | 197 Rs v | Ss 198 +-----+ +-----+ 199 |RxLx | |TxLx | 200 +-----+ +-----+ 201 Ss = reference point at the DWDM network element tributary output 202 Rs = reference point at the DWDM network element tributary input 203 Lx = Lambda x 204 OM = Optical Mux 205 OD = Optical Demux 206 ROADM = Reconfigurable Optical Add Drop Mux 208 from Fig. 5.1/G.698.2 210 Figure 1: External transponder in WDM netwoks 212 7.1. Optical Parameters Description 214 The link between the external transponders through a WDM network 215 media channels are managed at the edges, i.e. at the transmitters 216 (Tx) and receivers (Rx) attached to the S and R reference points 217 respectively. The set of parameters that could be managed are 218 defined by the "application code" notation 220 The definitions of the optical parameters are provided below to 221 increase the readability of the document, where the definition is 222 ended by (R) the parameter can be retrieve with a read, when (W) it 223 can be provisioned by a write, (R,W) can be either read or written. 225 7.1.1. Optical path from point Ss to Rs 227 The following parameters for the optical path from point S and R are 228 defined in G.698.2 [ITU.G698.2]. 230 Maximum and minimum (residual) chromatic dispersion: 231 These parameters define the maximum and minimum value of the 232 optical path "end to end chromatic dispersion" (in ps/nm) that the 233 system shall be able to tolerate. (R) 235 Minimum optical return loss at Ss: 236 These parameter defines minimum optical return loss (in dB) of the 237 cable plant at the source reference point (Ss), including any 238 connectors (R) 240 Maximum discrete reflectance between Ss and Rs: 241 Optical reflectance is defined to be the ratio of the reflected 242 optical power present at a point, to the optical power incident to 243 that point. Control of reflections is discussed extensively in 244 ITU-T Rec. G.957 (R) 246 Maximum differential group delay: 247 Differential group delay (DGD) is the time difference between the 248 fractions of a pulse that are transmitted in the two principal 249 states of polarization of an optical signal. For distances 250 greater than several kilometers, and assuming random (strong) 251 polarization mode coupling, DGD in a fiber can be statistically 252 modelled as having a Maxwellian distribution. (R) 254 Maximum polarization dependent loss: 255 The polarization dependent loss (PDL) is the difference (in dB) 256 between the maximum and minimum values of the channel insertion 257 loss (or gain) of the black link from point SS to RS due to a 258 variation of the state of polarization (SOP) over all SOPs. (R) 260 Maximum inter-channel crosstalk: 261 Inter-channel crosstalk is defined as the ratio of total power in 262 all of the disturbing channels to that in the wanted channel, 263 where the wanted and disturbing channels are at different 264 wavelengths. The parameter specifies the isolation of a link 265 conforming to the "black link" approach such that under the worst- 266 case operating conditions the inter-channel crosstalk at any 267 reference point RS is less than the maximum inter-channel 268 crosstalk value (R) 270 Maximum interferometric crosstalk: 271 This parameter places a requirement on the isolation of a link 272 conforming to the "black link" approach such that under the worst 273 case operating conditions the interferometric crosstalk at any 274 reference point RS is less than the maximum interferometric 275 crosstalk value. (R) 277 Maximum optical path OSNR penalty: 278 The optical path OSNR penalty is defined as the difference between 279 the Lowest OSNR at Rs and Lowest OSNR at Ss that meets the BER 280 requirement (R) 282 Maximum ripple: 283 Although is defined in G.698.2 (R). 285 7.1.2. Rs and Ss Configuration 287 For the Rs and Ss configuration this draft refers the draft-dharini- 288 ccamp-dwdm-if-param-yang while for the Rs-Ss extended parameters for 289 coherent transmission interfaces refer to draft-dharini-ccamp-dwdm- 290 if-param-yang 292 7.1.3. Table of Application Codes 294 For Application Codes configuration this draft refers the draft- 295 dharini-ccamp-dwdm-if-param-yang 297 7.2. Use Cases 299 The use cases are described in draft-ietf-ccamp-dwdm-if-mng-ctrl-fwk 301 7.3. Optical Parameters for impairment validation in a WDM network 303 The ietf-opt-parameters-wdm is an augment to the ????. It allows the 304 user to get and set the application Optical Parameters of a DWDM 305 network. 307 module: ietf-opt-parameters-wdm 308 augment /if:interfaces/if:interface: 309 +--rw optical-transport 310 | +--rw attenuator-value? attenuator-t 311 | +--rw offset? decimal64 312 | +--rw channel-power-ref? decimal64 313 | +--rw tilt-calibration? tilt-t 314 +--rw opwr-threshold-warning 315 | +--rw opwr-min? dbm-t 316 | +--rw opwr-min-clear? dbm-t 317 | +--rw opwr-max? dbm-t 318 +--rw gain-degrade-alarm 319 | +--rw gain-degrade-low? dbm-t 320 | +--rw gain-degrade-high? dbm-t 321 +--rw power-degrade-high-alarm 322 | +--rw gain-degrade-high? dbm-t 323 +--rw power-degrade-low-alarm 324 | +--ro power-degrade-low? dbm-t 325 +--rw noise 326 | +--rw noise? decimal64 327 +--rw 328 | +--rw noise? decimal64 329 +--rw chromatic-dispersion 330 | +--rw noise-sigma? decimal64 331 +--rw chromatic-dispersion-slope 332 | +--rw chromatic-dispersion-slope? decimal64 333 +--rw pmd 334 | +--rw pmd? decimal64 335 +--rw pdl 336 | +--rw pdl? decimal64 337 +--rw drop-power 338 | +--rw drop-power? decimal64 339 +--rw drop-power-sigma 340 | +--rw noise? decimal64 341 +--rw ripple 342 | +--rw drop-power-sigma? decimal64 343 +--ro ch-noise-figure 344 | +--ro ch-noise-figure* [ch-noise-fig] 345 | +--ro ch-noise-fig ch-noise-figure-point 346 | +--ro input-to-output? decimal64 347 | +--ro input-to-drop? decimal64 348 | +--ro add-to-output? decimal64 349 +--rw dgd 350 | +--rw dgd? decimal64 351 +--ro ch-isolation 352 | +--ro ch-isolation* [ch-isolat] 353 | +--ro ch-isolat ch-isolation-cross 354 | +--ro ad-ch-isol? decimal64 355 | +--ro no-ad-ch-iso? decimal64 356 +--rw ch-extinction 357 +--rw cer? decimal64 359 8. Structure of the Yang Module 361 ietf-opt-parameters-wdm is a top level model for the support of this 362 feature. 364 9. Yang Module 366 The ietf-opt-parameters-wdm is defined as an extension to ietf 367 interfaces ????. 369 file "ietf-opt-parameters-wdm.yang" 371 module ietf-opt-parameters-wdm { 372 namespace "urn:ietf:params:xml:ns:yang:ietf-opt-parameters-wdm"; 373 prefix iietf-opt-parameters-wdm; 375 import ietf-interfaces { 376 prefix if; 377 } 379 import iana-if-type { 380 prefix ianaift; 381 } 383 organization 384 "IETF CCAMP 385 Working Group"; 387 contact 388 "WG Web: 389 WG List: 391 Editor: Gabriele Galimberti 392 "; 394 description 395 "This module contains a collection of YANG definitions for 396 collecting and configuring Optical Parameters 397 in Optical Networks and calculate the circuit feasibility. 399 Copyright (c) 2016 IETF Trust and the persons identified 400 as authors of the code. All rights reserved. 402 Redistribution and use in source and binary forms, with or 403 without modification, is permitted pursuant to, and 404 subject to the license terms contained in, the Simplified 405 BSD License set forth in Section 4.c of the IETF Trust's 406 Legal Provisions Relating to IETF Documents 407 (http://trustee.ietf.org/license-info)."; 409 revision "2021-06-28" { 410 description 411 "Revision 1.3"; 412 reference 413 ""; 414 } 416 revision "2020-03-13" { 417 description 418 "Revision 1.2"; 419 reference 420 ""; 421 } 423 revision "2018-10-22" { 424 description 425 "Revision 1.1"; 426 reference 427 ""; 428 } 430 revision "2018-03-06" { 431 description 432 "Revision 1.0"; 433 reference 434 ""; 435 } 437 revision "2016-10-30" { 438 description 439 "Initial revision."; 440 reference 441 "RFC XXXX: A YANG Data Model for Optical Paramenters 442 of DWDM Networks 443 "; 444 } 446 typedef tilt-t { 447 type decimal64 { 448 fraction-digits 2; 449 range "-5..5"; 450 } 451 description "Tilt Type"; 453 } 455 typedef signal-output-power-t { 456 type decimal64 { 457 fraction-digits 2; 458 range "-10..30"; 459 } 460 description " 461 Amplifier Power provisioning "; 462 } 464 typedef active-channel-t { 465 type union { 466 type uint8 { 467 range "0..200"; 468 } 469 } 470 description " 471 Number of channels active on a span - and on an amplifier"; 472 } 474 typedef dbm-t { 475 type decimal64 { 476 fraction-digits 2; 477 range "-50..-30 | -10..5 | 10000000"; 478 } 479 description " 480 Amplifier Power in dBm "; 481 } 483 typedef attenuator-t { 484 type decimal64 { 485 fraction-digits 2; 486 range "-15..-5"; 487 } 488 description " 489 Attenuation value (attenuator) applied after the Amplifier"; 490 } 492 typedef ch-noise-figure-point { 493 type decimal64 { 494 fraction-digits 2; 495 range "-15..-5"; 496 } 497 description " 498 Amplifier noise figure of point power"; 499 } 500 typedef ch-isolation-cross { 501 type decimal64 { 502 fraction-digits 2; 503 range "-15..-5"; 504 } 505 description " 506 cross channel isolation value"; 507 } 509 grouping opwr-threshold-warning-grp { 510 description " 511 Minimum Optical Power threshold 512 - this is used to rise Power alarm "; 514 leaf opwr-min { 515 type dbm-t; 516 units "dBm"; 517 default -1; 518 description "Minimum Power Value"; 519 } 521 leaf opwr-min-clear { 522 type dbm-t; 523 units "dBm"; 524 default -1; 525 description "threshold to clear Minimum Power value Alarm"; 526 } 528 leaf opwr-max { 529 type dbm-t; 530 units "dBm"; 531 default 1; 532 description " 533 Maximum Optical Power threshold 534 - this is used to rise Power alarm "; 535 } 536 } 538 grouping gain-degrade-alarm-grp { 539 description " 540 Low Optical Power gain threshold 541 - this is used to rise Power alarm "; 543 leaf gain-degrade-low { 544 type dbm-t; 545 units "dBm"; 546 default -1; 547 description "Low Gain Degrade Value"; 549 } 551 leaf gain-degrade-high { 552 type dbm-t; 553 units "dBm"; 554 default 1; 555 description " 556 High Optical Power gain threshold 557 - this is used to rise Power alarm "; 558 } 559 } 561 grouping power-degrade-high-alarm-grp { 562 description " 563 High Optical Power gain alarm "; 565 leaf gain-degrade-high { 566 type dbm-t; 567 units "dBm"; 568 default 1; 569 description "Low Gain Degrade Value"; 570 } 571 } 573 grouping power-degrade-low-alarm-grp { 574 description " 575 Low Optical Power gain alarm "; 577 leaf power-degrade-low { 578 type dbm-t; 579 units "dBm"; 580 default -1; 581 config false; 582 description "High Gain Degrade Value"; 583 } 584 } 586 grouping noise-grp { 587 description "Noise feasibility"; 588 leaf noise { 589 type decimal64 { 590 fraction-digits 2; 591 } 592 units "dB"; 593 description "Noise feasibility - reference ITU-T G.680 594 OSNR added to the signal by the OMS. The noise is intended 595 per channel and is independent of the number of active 596 channels in OMS"; 597 } 598 } 600 grouping noise-sigma-grp { 601 description "Noise sigma feasibility"; 602 leaf noise-sigma { 603 type decimal64 { 604 fraction-digits 2; 605 } 606 units "dB"; 607 description "Noise Sigma feasibility - accuracy of the 608 OSNR added to 609 the signal by the OMS"; 610 } 611 } 613 grouping chromatic-dispersion-grp { 614 description "Chromatic Dispersion"; 615 leaf chromatic-dispersion { 616 type decimal64 { 617 fraction-digits 2; 618 } 619 units "ps/nm"; 620 description "Chromatic Dispersion (CD) related to the OMS"; 621 } 622 } 624 grouping chromatic-dispersion-slope-grp { 625 description "Chromatic Dispersion slope"; 626 leaf chromatic-dispersion-slope { 627 type decimal64 { 628 fraction-digits 2; 629 } 630 units "ps/nm^2"; 631 description "Chromatic Dispersion (CD) Slope related to 632 the OMS"; 633 } 634 } 636 grouping pmd-grp { 637 description "Polarization Mode Dispersion"; 638 leaf pmd { 639 type decimal64 { 640 fraction-digits 2; 641 } 642 units "ps"; 643 description "Polarization Mode Dispersion (PMD) related 644 to OMS"; 645 } 646 } 648 grouping pdl-grp { 649 description "Polarization Dependent Loss"; 650 leaf pdl { 651 type decimal64 { 652 fraction-digits 2; 653 } 654 units "dB"; 655 description "Polarization Dependent Loss (PDL) related to 656 the OMS"; 657 } 658 } 660 grouping drop-power-grp { 661 description "Drop power at DWDM if RX feasibility"; 662 leaf drop-power { 663 type decimal64 { 664 fraction-digits 2; 665 } 666 units "dBm"; 667 description "Drop Power value at the DWDM Transceiver RX 668 side"; 669 } 670 } 672 grouping drop-power-sigma-grp { 673 description "Drop power sigma at DWDM if RX feasibility "; 674 leaf drop-power-sigma { 675 type decimal64 { 676 fraction-digits 2; 677 } 678 units "db"; 679 description "Drop Power Sigma value at the DWDM Transceiver 680 RX side"; 681 } 682 } 684 grouping ripple-grp { 685 description "Channel Ripple"; 686 leaf ripple { 687 type decimal64 { 688 fraction-digits 2; 689 } 690 units "db"; 691 description "Channel Ripple"; 692 } 693 } 695 grouping ch-noise-figure-grp { 696 list ch-noise-figure { 697 key "ch-noise-fig"; 698 description "Channel signal-spontaneous noise figure"; 700 leaf ch-noise-fig { 701 type ch-noise-figure-point; 702 description "Channel signal-spontaneous noise 703 figure point"; 704 } 706 leaf input-to-output { 707 type decimal64 { 708 fraction-digits 2; 709 } 710 units "dB"; 711 description "from input port to output port"; 712 } 714 leaf input-to-drop { 715 type decimal64 { 716 fraction-digits 2; 717 } 718 units "dB"; 719 description "from input port to drop port"; 720 } 722 leaf add-to-output { 723 type decimal64 { 724 fraction-digits 2; 725 } 726 units "dB"; 727 description "from add port to output port"; 728 } 729 } 730 description "Channel signal-spontaneous noise figure"; 731 } 733 grouping dgd-grp { 734 description "Differential Group Delay"; 735 leaf dgd { 736 type decimal64 { 737 fraction-digits 2; 738 } 739 units "db"; 740 description "differential group delay"; 741 } 742 } 744 grouping ch-isolation-grp { 745 list ch-isolation { 746 key "ch-isolat"; 747 description "adjacent and not adjacent channel isolation"; 749 leaf ch-isolat { 750 type ch-isolation-cross; 751 description "channel isolation from adjacent"; 752 } 754 leaf ad-ch-isol { 755 type decimal64 { 756 fraction-digits 2; 757 } 758 units "dB"; 759 description "adjecent channel isolation"; 760 } 762 leaf no-ad-ch-iso { 763 type decimal64 { 764 fraction-digits 2; 765 } 766 units "dB"; 767 description "non adjecent channel isolation"; 768 } 769 } 770 description "djacent and not adjacent channel isolation"; 771 } 773 grouping ch-extinction-grp { 774 description "Channel Extinsion"; 775 leaf cer { 776 type decimal64 { 777 fraction-digits 2; 778 } 779 units "db"; 780 description "channel extinction"; 781 } 782 } 784 grouping att-coefficient-grp { 785 description "Attenuation coefficient (for a fibre segment)"; 786 leaf att { 787 type decimal64 { 788 fraction-digits 2; 789 } 790 units "db"; 791 description "Attenuation coefficient (for a fibre segment)"; 792 } 793 } 795 augment "/if:interfaces/if:interface" { 796 when "if:type = 'ianaift:opticalTransport'" { 797 description "Specific optical-transport Interface Data"; 798 } 799 description "Specific optical-transport Interface Data"; 800 container optical-transport { 801 description "Specific optical-transport Data"; 803 leaf attenuator-value { 804 type attenuator-t; 805 description "External attenuator value "; 806 } 808 leaf offset { 809 type decimal64 { 810 fraction-digits 2; 811 range "-30..30"; 812 } 813 description "Raman and power amplifiers offset"; 814 } 816 leaf channel-power-ref { 817 type decimal64 { 818 fraction-digits 2; 819 range "-10..15"; 820 } 821 description "Optical power per channel"; 822 } 824 leaf tilt-calibration { 825 type tilt-t; 826 description "Amplifier Tilt tuning"; 827 } 828 } 829 container opwr-threshold-warning { 830 description "Optical power threshold warning"; 831 uses opwr-threshold-warning-grp; 832 } 833 container gain-degrade-alarm { 834 description "Gain degrade alarm"; 835 uses gain-degrade-alarm-grp; 836 } 837 container power-degrade-high-alarm { 838 description "Power degrade high aparm"; 839 uses power-degrade-high-alarm-grp; 840 } 841 container power-degrade-low-alarm { 842 description "Power degrade low alarm"; 843 uses power-degrade-low-alarm-grp; 844 } 845 container noise { 846 description "Channel Noise feasibility"; 847 uses noise-grp; 848 } 849 container noise-sigma { 850 description "Channel Noise sigma feasibility"; 851 uses noise-grp; 852 } 853 container chromatic-dispersion { 854 description "Chromatic Dispersion"; 855 uses noise-sigma-grp; 856 } 857 container chromatic-dispersion-slope { 858 description "Chromatic Dispersion slope"; 859 uses chromatic-dispersion-slope-grp; 860 } 861 container pmd { 862 description "Polarization Mode Dispersion"; 863 uses pmd-grp; 864 } 865 container pdl { 866 description "Polarization Dependent Loss"; 867 uses pdl-grp; 868 } 869 container drop-power { 870 description "Drop power at DWDM if RX feasibility"; 871 uses drop-power-grp; 872 } 873 container drop-power-sigma { 874 description "Drop power sigma at DWDM if RX feasibility"; 875 uses noise-grp; 876 } 877 container ripple { 878 description "Channel Ripple"; 879 uses drop-power-sigma-grp; 880 } 881 container ch-noise-figure { 882 config false; 883 description "Channel signal-spontaneous noise figure"; 884 uses ch-noise-figure-grp; 885 } 886 container dgd { 887 description "Differential Group Delay"; 888 uses dgd-grp; 889 } 890 container ch-isolation { 891 config false; 892 description "adjacent and not adjacent channel isolation"; 893 uses ch-isolation-grp; 894 } 895 container ch-extinction { 896 description "Channel Extinsion"; 897 uses ch-extinction-grp; 898 } 900 } 901 } 902 } 904 906 10. Security Considerations 908 The YANG module defined in this memo is designed to be accessed via 909 the NETCONF protocol [RFC6241]. he lowest NETCONF layer is the secure 910 transport layer and the mandatory-to-implement secure transport is 911 SSH [RFC6242]. The NETCONF access control model [RFC6536] provides 912 the means to restrict access for particular NETCONF users to a pre- 913 configured subset of all available NETCONF protocol operation and 914 content. 916 11. IANA Considerations 918 This document registers a URI in the IETF XML registry [RFC3688]. 919 Following the format in [RFC3688], the following registration is 920 requested to be made: 922 URI: urn:ietf:params:xml:ns:yang:ietf-interfaces:ietf-ext-xponder- 923 wdm-if 925 Registrant Contact: The IESG. 927 XML: N/A, the requested URI is an XML namespace. 929 This document registers a YANG module in the YANG Module Names 930 registry [RFC6020]. 932 This document registers a YANG module in the YANG Module Names 933 registry [RFC6020]. 935 prefix: ietf-ext-xponder-wdm-if reference: RFC XXXX 937 12. Acknowledgements 939 Marco Cardani. 941 13. Contributors 943 Dean Bogdanovic 945 Westford 946 U.S.A. 947 email 949 Walid Wakim 950 Cisco 951 9501 Technology Blvd 952 ROSEMONT, ILLINOIS 60018 953 UNITED STATES 954 email wwakim@cisco.com 956 Marco Cardani 957 Cisco 958 vis S.Maria Molgora, 48c 959 20871 - Vimercate 960 Monza Brianza 961 Italy 962 email mcardani@cisco.com 964 Giovanni Martinelli 965 Cisco 966 vis S.Maria Molgora, 48c 967 20871 - Vimercate 968 Monza Brianza 969 Italy 970 email giomarti@cisco.com 972 14. References 974 14.1. Normative References 976 [ITU.G694.1] 977 International Telecommunications Union, "Spectral grids 978 for WDM applications: DWDM frequency grid", 979 ITU-T Recommendation G.694.1, February 2012. 981 [ITU.G698.2] 982 International Telecommunications Union, "Amplified 983 multichannel dense wavelength division multiplexing 984 applications with single channel optical interfaces", 985 ITU-T Recommendation G.698.2, November 2009. 987 [ITU.G709] 988 International Telecommunications Union, "Interface for the 989 Optical Transport Network (OTN)", ITU-T Recommendation 990 G.709, June 2016. 992 [ITU.G7710] 993 International Telecommunications Union, "Common equipment 994 management function requirements", ITU-T Recommendation 995 G.7710, August 2017. 997 [ITU.G798] 998 International Telecommunications Union, "Characteristics 999 of optical transport network hierarchy equipment 1000 functional blocks", ITU-T Recommendation G.798, December 1001 2017. 1003 [ITU.G8201] 1004 International Telecommunications Union, "Error performance 1005 parameters and objectives for multi-operator international 1006 paths within the Optical Transport Network (OTN)", 1007 ITU-T Recommendation G.8201, April 2011. 1009 [ITU.G826] 1010 International Telecommunications Union, "End-to-end error 1011 performance parameters and objectives for international, 1012 constant bit-rate digital paths and connections", 1013 ITU-T Recommendation G.826, December 2002. 1015 [ITU.G872] 1016 International Telecommunications Union, "Architecture of 1017 optical transport networks", ITU-T Recommendation G.872, 1018 January 2017. 1020 [ITU.G874] 1021 International Telecommunications Union, "Management 1022 aspects of optical transport network elements", 1023 ITU-T Recommendation G.874, August 2017. 1025 [ITU.G874.1] 1026 International Telecommunications Union, "Optical transport 1027 network (OTN): Protocol-neutral management information 1028 model for the network element view", ITU-T Recommendation 1029 G.874.1, November 2016. 1031 [ITU.G959.1] 1032 International Telecommunications Union, "Optical transport 1033 network physical layer interfaces", ITU-T Recommendation 1034 G.959.1, July 2018. 1036 [RFC2119] Bradner, S., "Key words for use in RFCs to Indicate 1037 Requirement Levels", BCP 14, RFC 2119, 1038 DOI 10.17487/RFC2119, March 1997, 1039 . 1041 [RFC2578] McCloghrie, K., Ed., Perkins, D., Ed., and J. 1042 Schoenwaelder, Ed., "Structure of Management Information 1043 Version 2 (SMIv2)", STD 58, RFC 2578, 1044 DOI 10.17487/RFC2578, April 1999, 1045 . 1047 [RFC2579] McCloghrie, K., Ed., Perkins, D., Ed., and J. 1048 Schoenwaelder, Ed., "Textual Conventions for SMIv2", 1049 STD 58, RFC 2579, DOI 10.17487/RFC2579, April 1999, 1050 . 1052 [RFC2580] McCloghrie, K., Ed., Perkins, D., Ed., and J. 1053 Schoenwaelder, Ed., "Conformance Statements for SMIv2", 1054 STD 58, RFC 2580, DOI 10.17487/RFC2580, April 1999, 1055 . 1057 [RFC2863] McCloghrie, K. and F. Kastenholz, "The Interfaces Group 1058 MIB", RFC 2863, DOI 10.17487/RFC2863, June 2000, 1059 . 1061 [RFC3591] Lam, H-K., Stewart, M., and A. Huynh, "Definitions of 1062 Managed Objects for the Optical Interface Type", RFC 3591, 1063 DOI 10.17487/RFC3591, September 2003, 1064 . 1066 [RFC6205] Otani, T., Ed. and D. Li, Ed., "Generalized Labels for 1067 Lambda-Switch-Capable (LSC) Label Switching Routers", 1068 RFC 6205, DOI 10.17487/RFC6205, March 2011, 1069 . 1071 14.2. Informative References 1073 [RFC2629] Rose, M., "Writing I-Ds and RFCs using XML", RFC 2629, 1074 DOI 10.17487/RFC2629, June 1999, 1075 . 1077 [RFC3410] Case, J., Mundy, R., Partain, D., and B. Stewart, 1078 "Introduction and Applicability Statements for Internet- 1079 Standard Management Framework", RFC 3410, 1080 DOI 10.17487/RFC3410, December 2002, 1081 . 1083 [RFC4054] Strand, J., Ed. and A. Chiu, Ed., "Impairments and Other 1084 Constraints on Optical Layer Routing", RFC 4054, 1085 DOI 10.17487/RFC4054, May 2005, 1086 . 1088 [RFC4181] Heard, C., Ed., "Guidelines for Authors and Reviewers of 1089 MIB Documents", BCP 111, RFC 4181, DOI 10.17487/RFC4181, 1090 September 2005, . 1092 Appendix A. Change Log 1094 This optional section should be removed before the internet draft is 1095 submitted to the IESG for publication as an RFC. 1097 Note to RFC Editor: please remove this appendix before publication as 1098 an RFC. 1100 Appendix B. Open Issues 1102 Note to RFC Editor: please remove this appendix before publication as 1103 an RFC. 1105 Authors' Addresses 1106 Gabriele Galimberti (editor) 1107 Cisco 1108 Via Santa Maria Molgora, 48 c 1109 20871 - Vimercate 1110 Italy 1112 Phone: +390392091462 1113 Email: ggalimbe@cisco.com 1115 Ruediger Kunze (editor) 1116 Deutsche Telekom 1117 Winterfeldtstr. 21-27 1118 10781 Berlin 1119 Germany 1121 Phone: +491702275321 1122 Email: RKunze@telekom.de 1124 Dharini Hiremagalur (editor) 1125 Juniper 1126 1194 N Mathilda Avenue 1127 Sunnyvale - 94089 California 1128 USA 1130 Email: dharinih@juniper.net 1132 Gert Grammel (editor) 1133 Juniper 1134 Oskar-Schlemmer Str. 15 1135 80807 Muenchen 1136 Germany 1138 Phone: +49 1725186386 1139 Email: ggrammel@juniper.net