idnits 2.17.1 draft-galimbe-ccamp-iv-yang-10.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 (March 13, 2020) is 1505 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 904, but not defined == Missing Reference: 'RFC6242' is mentioned on line 906, but not defined == Missing Reference: 'RFC6536' is mentioned on line 906, but not defined ** Obsolete undefined reference: RFC 6536 (Obsoleted by RFC 8341) == Missing Reference: 'RFC3688' is mentioned on line 914, but not defined == Missing Reference: 'RFC6020' is mentioned on line 928, but not defined == Unused Reference: 'ITU.G694.1' is defined on line 971, but no explicit reference was found in the text == Unused Reference: 'ITU.G709' is defined on line 982, but no explicit reference was found in the text == Unused Reference: 'ITU.G7710' is defined on line 987, but no explicit reference was found in the text == Unused Reference: 'ITU.G798' is defined on line 992, but no explicit reference was found in the text == Unused Reference: 'ITU.G8201' is defined on line 998, but no explicit reference was found in the text == Unused Reference: 'ITU.G826' is defined on line 1004, but no explicit reference was found in the text == Unused Reference: 'ITU.G872' is defined on line 1010, but no explicit reference was found in the text == Unused Reference: 'ITU.G874' is defined on line 1015, but no explicit reference was found in the text == Unused Reference: 'ITU.G874.1' is defined on line 1020, but no explicit reference was found in the text == Unused Reference: 'ITU.G959.1' is defined on line 1026, but no explicit reference was found in the text == Unused Reference: 'RFC2578' is defined on line 1036, but no explicit reference was found in the text == Unused Reference: 'RFC2579' is defined on line 1042, but no explicit reference was found in the text == Unused Reference: 'RFC2580' is defined on line 1047, but no explicit reference was found in the text == Unused Reference: 'RFC2863' is defined on line 1052, but no explicit reference was found in the text == Unused Reference: 'RFC3591' is defined on line 1056, but no explicit reference was found in the text == Unused Reference: 'RFC6205' is defined on line 1061, but no explicit reference was found in the text == Unused Reference: 'RFC2629' is defined on line 1068, but no explicit reference was found in the text == Unused Reference: 'RFC4054' is defined on line 1078, but no explicit reference was found in the text == Unused Reference: 'RFC4181' is defined on line 1083, 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: September 14, 2020 Deutsche Telekom 6 D. Hiremagalur, Ed. 7 G. Grammel, Ed. 8 Juniper 9 March 13, 2020 11 A YANG model to manage the optical parameters for in a WDM network 12 draft-galimbe-ccamp-iv-yang-10 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 September 14, 2020. 55 Copyright Notice 57 Copyright (c) 2020 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 . . . . . . . . . . . . . . . . . . . . . . . . . 21 93 14.1. Normative References . . . . . . . . . . . . . . . . . . 21 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 noise-sigma 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 "2020-03-13" { 410 description 411 "Revision 1.2"; 412 reference 413 ""; 414 } 416 revision "2018-10-22" { 417 description 418 "Revision 1.1"; 419 reference 420 ""; 421 } 423 revision "2018-03-06" { 424 description 425 "Revision 1.0"; 426 reference 427 ""; 428 } 430 revision "2016-10-30" { 431 description 432 "Initial revision."; 433 reference 434 "RFC XXXX: A YANG Data Model for Optical Paramenters 435 of DWDM Networks 436 "; 437 } 439 typedef tilt-t { 440 type decimal64 { 441 fraction-digits 2; 442 range "-5..5"; 443 } 444 description "Tilt Type"; 445 } 447 typedef signal-output-power-t { 448 type decimal64 { 449 fraction-digits 2; 450 range "-10..30"; 452 } 453 description " 454 Amplifier Power provisioning "; 455 } 457 typedef active-channel-t { 458 type union { 459 type uint8 { 460 range "0..200"; 461 } 462 } 463 description " 464 Number of channels active on a span - and on an amplifier"; 465 } 467 typedef dbm-t { 468 type decimal64 { 469 fraction-digits 2; 470 range "-50..-30 | -10..5 | 10000000"; 471 } 472 description " 473 Amplifier Power in dBm "; 474 } 476 typedef attenuator-t { 477 type decimal64 { 478 fraction-digits 2; 479 range "-15..-5"; 480 } 481 description " 482 Attenuation value (attenuator) applied after the Amplifier"; 483 } 485 typedef ch-noise-figure-point { 486 type decimal64 { 487 fraction-digits 2; 488 range "-15..-5"; 489 } 490 description " 491 Amplifier noise figure of point power"; 492 } 494 typedef ch-isolation-cross { 495 type decimal64 { 496 fraction-digits 2; 497 range "-15..-5"; 498 } 499 description " 500 cross channel isolation value"; 501 } 503 grouping opwr-threshold-warning-grp { 504 description " 505 Minimum Optical Power threshold 506 - this is used to rise Power alarm "; 508 leaf opwr-min { 509 type dbm-t; 510 units "dBm"; 511 default -1; 512 description "Minimum Power Value"; 513 } 515 leaf opwr-min-clear { 516 type dbm-t; 517 units "dBm"; 518 default -1; 519 description "threshold to clear Minimum Power value Alarm"; 520 } 522 leaf opwr-max { 523 type dbm-t; 524 units "dBm"; 525 default 1; 526 description " 527 Maximum Optical Power threshold 528 - this is used to rise Power alarm "; 529 } 530 } 532 grouping gain-degrade-alarm-grp { 533 description " 534 Low Optical Power gain threshold 535 - this is used to rise Power alarm "; 537 leaf gain-degrade-low { 538 type dbm-t; 539 units "dBm"; 540 default -1; 541 description "Low Gain Degrade Value"; 542 } 544 leaf gain-degrade-high { 545 type dbm-t; 546 units "dBm"; 547 default 1; 548 description " 549 High Optical Power gain threshold 550 - this is used to rise Power alarm "; 551 } 552 } 554 grouping power-degrade-high-alarm-grp { 555 description " 556 High Optical Power gain alarm "; 558 leaf gain-degrade-high { 559 type dbm-t; 560 units "dBm"; 561 default 1; 562 description "Low Gain Degrade Value"; 563 } 564 } 566 grouping power-degrade-low-alarm-grp { 567 description " 568 Low Optical Power gain alarm "; 570 leaf power-degrade-low { 571 type dbm-t; 572 units "dBm"; 573 default -1; 574 config false; 575 description "High Gain Degrade Value"; 576 } 577 } 579 grouping noise-grp { 580 description "Noise feasibility"; 581 leaf noise { 582 type decimal64 { 583 fraction-digits 2; 584 } 585 units "dB"; 586 description "Noise feasibility - reference ITU-T G.680 587 OSNR added to the signal by the OMS. The noise is intended 588 per channel and is independent of the number of active 589 channels in OMS"; 590 } 591 } 593 grouping noise-sigma-grp { 594 description "Noise sigma feasibility"; 595 leaf noise-sigma { 596 type decimal64 { 597 fraction-digits 2; 598 } 599 units "dB"; 600 description "Noise Sigma feasibility - accuracy of the 601 OSNR added to 602 the signal by the OMS"; 603 } 604 } 606 grouping chromatic-dispersion-grp { 607 description "Chromatic Dispersion"; 608 leaf chromatic-dispersion { 609 type decimal64 { 610 fraction-digits 2; 611 } 612 units "ps/nm"; 613 description "Chromatic Dispersion (CD) related to the OMS"; 614 } 615 } 617 grouping chromatic-dispersion-slope-grp { 618 description "Chromatic Dispersion slope"; 619 leaf chromatic-dispersion-slope { 620 type decimal64 { 621 fraction-digits 2; 622 } 623 units "ps/nm^2"; 624 description "Chromatic Dispersion (CD) Slope related to 625 the OMS"; 626 } 627 } 629 grouping pmd-grp { 630 description "Polarization Mode Dispersion"; 631 leaf pmd { 632 type decimal64 { 633 fraction-digits 2; 634 } 635 units "ps"; 636 description "Polarization Mode Dispersion (PMD) related 637 to OMS"; 638 } 639 } 641 grouping pdl-grp { 642 description "Polarization Dependent Loss"; 643 leaf pdl { 644 type decimal64 { 645 fraction-digits 2; 646 } 647 units "dB"; 648 description "Polarization Dependent Loss (PDL) related to 649 the OMS"; 650 } 651 } 653 grouping drop-power-grp { 654 description "Drop power at DWDM if RX feasibility"; 655 leaf drop-power { 656 type decimal64 { 657 fraction-digits 2; 658 } 659 units "dBm"; 660 description "Drop Power value at the DWDM Transceiver RX 661 side"; 662 } 663 } 665 grouping drop-power-sigma-grp { 666 description "Drop power sigma at DWDM if RX feasibility "; 667 leaf drop-power-sigma { 668 type decimal64 { 669 fraction-digits 2; 670 } 671 units "db"; 672 description "Drop Power Sigma value at the DWDM Transceiver 673 RX side"; 674 } 675 } 677 grouping ripple-grp { 678 description "Channel Ripple"; 679 leaf ripple { 680 type decimal64 { 681 fraction-digits 2; 682 } 683 units "db"; 684 description "Channel Ripple"; 685 } 686 } 688 grouping ch-noise-figure-grp { 689 list ch-noise-figure { 690 key "ch-noise-fig"; 691 description "Channel signal-spontaneous noise figure"; 693 leaf ch-noise-fig { 694 type ch-noise-figure-point; 695 description "Channel signal-spontaneous noise 696 figure point"; 697 } 699 leaf input-to-output { 700 type decimal64 { 701 fraction-digits 2; 702 } 703 units "dB"; 704 description "from input port to output port"; 705 } 707 leaf input-to-drop { 708 type decimal64 { 709 fraction-digits 2; 710 } 711 units "dB"; 712 description "from input port to drop port"; 713 } 715 leaf add-to-output { 716 type decimal64 { 717 fraction-digits 2; 718 } 719 units "dB"; 720 description "from add port to output port"; 721 } 722 } 723 description "Channel signal-spontaneous noise figure"; 724 } 726 grouping dgd-grp { 727 description "Differential Group Delay"; 728 leaf dgd { 729 type decimal64 { 730 fraction-digits 2; 731 } 732 units "db"; 733 description "differential group delay"; 734 } 735 } 737 grouping ch-isolation-grp { 738 list ch-isolation { 739 key "ch-isolat"; 740 description "adjacent and not adjacent channel isolation"; 742 leaf ch-isolat { 743 type ch-isolation-cross; 744 description "channel isolation from adjacent"; 745 } 747 leaf ad-ch-isol { 748 type decimal64 { 749 fraction-digits 2; 750 } 751 units "dB"; 752 description "adjecent channel isolation"; 753 } 755 leaf no-ad-ch-iso { 756 type decimal64 { 757 fraction-digits 2; 758 } 759 units "dB"; 760 description "non adjecent channel isolation"; 761 } 762 } 763 description "djacent and not adjacent channel isolation"; 764 } 766 grouping ch-extinction-grp { 767 description "Channel Extinsion"; 768 leaf cer { 769 type decimal64 { 770 fraction-digits 2; 771 } 772 units "db"; 773 description "channel extinction"; 774 } 775 } 777 grouping att-coefficient-grp { 778 description "Attenuation coefficient (for a fibre segment)"; 779 leaf att { 780 type decimal64 { 781 fraction-digits 2; 782 } 783 units "db"; 784 description "Attenuation coefficient (for a fibre segment)"; 785 } 787 } 789 augment "/if:interfaces/if:interface" { 790 when "if:type = 'ianaift:opticalTransport'" { 791 description "Specific optical-transport Interface Data"; 792 } 793 description "Specific optical-transport Interface Data"; 794 container optical-transport { 795 description "Specific optical-transport Data"; 797 leaf attenuator-value { 798 type attenuator-t; 799 description "External attenuator value "; 800 } 802 leaf offset { 803 type decimal64 { 804 fraction-digits 2; 805 range "-30..30"; 806 } 807 description "Raman and power amplifiers offset"; 808 } 810 leaf channel-power-ref { 811 type decimal64 { 812 fraction-digits 2; 813 range "-10..15"; 814 } 815 description "Optical power per channel"; 816 } 818 leaf tilt-calibration { 819 type tilt-t; 820 description "Amplifier Tilt tuning"; 821 } 822 } 823 container opwr-threshold-warning { 824 description "Optical power threshold warning"; 825 uses opwr-threshold-warning-grp; 826 } 827 container gain-degrade-alarm { 828 description "Gain degrade alarm"; 829 uses gain-degrade-alarm-grp; 830 } 831 container power-degrade-high-alarm { 832 description "Power degrade high aparm"; 833 uses power-degrade-high-alarm-grp; 834 } 835 container power-degrade-low-alarm { 836 description "Power degrade low alarm"; 837 uses power-degrade-low-alarm-grp; 838 } 839 container noise { 840 description "Channel Noise feasibility"; 841 uses noise-grp; 842 } 843 container noise-sigma { 844 description "Channel Noise sigma feasibility"; 845 uses noise-grp; 846 } 847 container chromatic-dispersion { 848 description "Chromatic Dispersion"; 849 uses noise-sigma-grp; 850 } 851 container chromatic-dispersion-slope { 852 description "Chromatic Dispersion slope"; 853 uses chromatic-dispersion-slope-grp; 854 } 855 container pmd { 856 description "Polarization Mode Dispersion"; 857 uses pmd-grp; 858 } 859 container pdl { 860 description "Polarization Dependent Loss"; 861 uses pdl-grp; 862 } 863 container drop-power { 864 description "Drop power at DWDM if RX feasibility"; 865 uses drop-power-grp; 866 } 867 container drop-power-sigma { 868 description "Drop power sigma at DWDM if RX feasibility"; 869 uses noise-grp; 870 } 871 container ripple { 872 description "Channel Ripple"; 873 uses drop-power-sigma-grp; 874 } 875 container ch-noise-figure { 876 config false; 877 description "Channel signal-spontaneous noise figure"; 878 uses ch-noise-figure-grp; 879 } 880 container dgd { 881 description "Differential Group Delay"; 883 uses dgd-grp; 884 } 885 container ch-isolation { 886 config false; 887 description "adjacent and not adjacent channel isolation"; 888 uses ch-isolation-grp; 889 } 890 container ch-extinction { 891 description "Channel Extinsion"; 892 uses ch-extinction-grp; 893 } 895 } 896 } 897 } 899 901 10. Security Considerations 903 The YANG module defined in this memo is designed to be accessed via 904 the NETCONF protocol [RFC6241]. he lowest NETCONF layer is the secure 905 transport layer and the mandatory-to-implement secure transport is 906 SSH [RFC6242]. The NETCONF access control model [RFC6536] provides 907 the means to restrict access for particular NETCONF users to a pre- 908 configured subset of all available NETCONF protocol operation and 909 content. 911 11. IANA Considerations 913 This document registers a URI in the IETF XML registry [RFC3688]. 914 Following the format in [RFC3688], the following registration is 915 requested to be made: 917 URI: urn:ietf:params:xml:ns:yang:ietf-interfaces:ietf-ext-xponder- 918 wdm-if 920 Registrant Contact: The IESG. 922 XML: N/A, the requested URI is an XML namespace. 924 This document registers a YANG module in the YANG Module Names 925 registry [RFC6020]. 927 This document registers a YANG module in the YANG Module Names 928 registry [RFC6020]. 930 prefix: ietf-ext-xponder-wdm-if reference: RFC XXXX 932 12. Acknowledgements 934 Marco Cardani. 936 13. Contributors 938 Dean Bogdanovic 940 Westford 941 U.S.A. 942 email 944 Walid Wakim 945 Cisco 946 9501 Technology Blvd 947 ROSEMONT, ILLINOIS 60018 948 UNITED STATES 949 email wwakim@cisco.com 951 Marco Cardani 952 Cisco 953 vis S.Maria Molgora, 48c 954 20871 - Vimercate 955 Monza Brianza 956 Italy 957 email mcardani@cisco.com 959 Giovanni Martinelli 960 Cisco 961 vis S.Maria Molgora, 48c 962 20871 - Vimercate 963 Monza Brianza 964 Italy 965 email giomarti@cisco.com 967 14. References 969 14.1. Normative References 971 [ITU.G694.1] 972 International Telecommunications Union, "Spectral grids 973 for WDM applications: DWDM frequency grid", 974 ITU-T Recommendation G.694.1, February 2012. 976 [ITU.G698.2] 977 International Telecommunications Union, "Amplified 978 multichannel dense wavelength division multiplexing 979 applications with single channel optical interfaces", 980 ITU-T Recommendation G.698.2, November 2009. 982 [ITU.G709] 983 International Telecommunications Union, "Interface for the 984 Optical Transport Network (OTN)", ITU-T Recommendation 985 G.709, June 2016. 987 [ITU.G7710] 988 International Telecommunications Union, "Common equipment 989 management function requirements", ITU-T Recommendation 990 G.7710, August 2017. 992 [ITU.G798] 993 International Telecommunications Union, "Characteristics 994 of optical transport network hierarchy equipment 995 functional blocks", ITU-T Recommendation G.798, December 996 2017. 998 [ITU.G8201] 999 International Telecommunications Union, "Error performance 1000 parameters and objectives for multi-operator international 1001 paths within the Optical Transport Network (OTN)", 1002 ITU-T Recommendation G.8201, April 2011. 1004 [ITU.G826] 1005 International Telecommunications Union, "End-to-end error 1006 performance parameters and objectives for international, 1007 constant bit-rate digital paths and connections", 1008 ITU-T Recommendation G.826, December 2002. 1010 [ITU.G872] 1011 International Telecommunications Union, "Architecture of 1012 optical transport networks", ITU-T Recommendation G.872, 1013 January 2017. 1015 [ITU.G874] 1016 International Telecommunications Union, "Management 1017 aspects of optical transport network elements", 1018 ITU-T Recommendation G.874, August 2017. 1020 [ITU.G874.1] 1021 International Telecommunications Union, "Optical transport 1022 network (OTN): Protocol-neutral management information 1023 model for the network element view", ITU-T Recommendation 1024 G.874.1, November 2016. 1026 [ITU.G959.1] 1027 International Telecommunications Union, "Optical transport 1028 network physical layer interfaces", ITU-T Recommendation 1029 G.959.1, July 2018. 1031 [RFC2119] Bradner, S., "Key words for use in RFCs to Indicate 1032 Requirement Levels", BCP 14, RFC 2119, 1033 DOI 10.17487/RFC2119, March 1997, 1034 . 1036 [RFC2578] McCloghrie, K., Ed., Perkins, D., Ed., and J. 1037 Schoenwaelder, Ed., "Structure of Management Information 1038 Version 2 (SMIv2)", STD 58, RFC 2578, 1039 DOI 10.17487/RFC2578, April 1999, 1040 . 1042 [RFC2579] McCloghrie, K., Ed., Perkins, D., Ed., and J. 1043 Schoenwaelder, Ed., "Textual Conventions for SMIv2", 1044 STD 58, RFC 2579, DOI 10.17487/RFC2579, April 1999, 1045 . 1047 [RFC2580] McCloghrie, K., Ed., Perkins, D., Ed., and J. 1048 Schoenwaelder, Ed., "Conformance Statements for SMIv2", 1049 STD 58, RFC 2580, DOI 10.17487/RFC2580, April 1999, 1050 . 1052 [RFC2863] McCloghrie, K. and F. Kastenholz, "The Interfaces Group 1053 MIB", RFC 2863, DOI 10.17487/RFC2863, June 2000, 1054 . 1056 [RFC3591] Lam, H-K., Stewart, M., and A. Huynh, "Definitions of 1057 Managed Objects for the Optical Interface Type", RFC 3591, 1058 DOI 10.17487/RFC3591, September 2003, 1059 . 1061 [RFC6205] Otani, T., Ed. and D. Li, Ed., "Generalized Labels for 1062 Lambda-Switch-Capable (LSC) Label Switching Routers", 1063 RFC 6205, DOI 10.17487/RFC6205, March 2011, 1064 . 1066 14.2. Informative References 1068 [RFC2629] Rose, M., "Writing I-Ds and RFCs using XML", RFC 2629, 1069 DOI 10.17487/RFC2629, June 1999, 1070 . 1072 [RFC3410] Case, J., Mundy, R., Partain, D., and B. Stewart, 1073 "Introduction and Applicability Statements for Internet- 1074 Standard Management Framework", RFC 3410, 1075 DOI 10.17487/RFC3410, December 2002, 1076 . 1078 [RFC4054] Strand, J., Ed. and A. Chiu, Ed., "Impairments and Other 1079 Constraints on Optical Layer Routing", RFC 4054, 1080 DOI 10.17487/RFC4054, May 2005, 1081 . 1083 [RFC4181] Heard, C., Ed., "Guidelines for Authors and Reviewers of 1084 MIB Documents", BCP 111, RFC 4181, DOI 10.17487/RFC4181, 1085 September 2005, . 1087 Appendix A. Change Log 1089 This optional section should be removed before the internet draft is 1090 submitted to the IESG for publication as an RFC. 1092 Note to RFC Editor: please remove this appendix before publication as 1093 an RFC. 1095 Appendix B. Open Issues 1097 Note to RFC Editor: please remove this appendix before publication as 1098 an RFC. 1100 Authors' Addresses 1102 Gabriele Galimberti (editor) 1103 Cisco 1104 Via Santa Maria Molgora, 48 c 1105 20871 - Vimercate 1106 Italy 1108 Phone: +390392091462 1109 Email: ggalimbe@cisco.com 1110 Ruediger Kunze (editor) 1111 Deutsche Telekom 1112 Winterfeldtstr. 21-27 1113 10781 Berlin 1114 Germany 1116 Phone: +491702275321 1117 Email: RKunze@telekom.de 1119 Dharini Hiremagalur (editor) 1120 Juniper 1121 1194 N Mathilda Avenue 1122 Sunnyvale - 94089 California 1123 USA 1125 Email: dharinih@juniper.net 1127 Gert Grammel (editor) 1128 Juniper 1129 Oskar-Schlemmer Str. 15 1130 80807 Muenchen 1131 Germany 1133 Phone: +49 1725186386 1134 Email: ggrammel@juniper.net