idnits 2.17.1 draft-ietf-ccamp-layer0-types-09.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 date (December 29, 2020) is 1207 days in the past. Is this intentional? Checking references for intended status: Proposed Standard ---------------------------------------------------------------------------- (See RFCs 3967 and 4897 for information about using normative references to lower-maturity documents in RFCs) == Missing Reference: 'RFCXXXX' is mentioned on line 112, but not defined == Unused Reference: 'RFC4203' is defined on line 865, but no explicit reference was found in the text == Unused Reference: 'RFC7699' is defined on line 897, but no explicit reference was found in the text == Unused Reference: 'ITU-Tg6942' is defined on line 948, but no explicit reference was found in the text == Unused Reference: 'ITU-Tg709' is defined on line 953, but no explicit reference was found in the text -- Possible downref: Non-RFC (?) normative reference: ref. 'ITU-Tg6982' ** Downref: Normative reference to an Informational RFC: RFC 6163 ** Downref: Normative reference to an Informational RFC: RFC 7698 Summary: 2 errors (**), 0 flaws (~~), 6 warnings (==), 2 comments (--). Run idnits with the --verbose option for more detailed information about the items above. -------------------------------------------------------------------------------- 2 CCAMP Working Group H. Zheng 3 Internet-Draft Huawei Technologies 4 Intended status: Standards Track Y. Lee 5 Expires: July 2, 2021 Samsung 6 A. Guo 7 Futurewei 8 V. Lopez 9 Telefonica 10 D. King 11 University of Lancaster 12 December 29, 2020 14 A YANG Data Model for Layer 0 Types 15 draft-ietf-ccamp-layer0-types-09 17 Abstract 19 This document defines a collection of common data types and groupings 20 in the YANG data modeling language. These derived common types and 21 groupings are intended to be imported by modules that model Layer 0 22 optical Traffic Engineering (TE) configuration and state capabilities 23 such as Wavelength Switched Optical Networks (WSONs) and Flexi-grid 24 Dense Wavelength Division Multiplexing (DWDM) Networks. 26 Status of This Memo 28 This Internet-Draft is submitted in full conformance with the 29 provisions of BCP 78 and BCP 79. 31 Internet-Drafts are working documents of the Internet Engineering 32 Task Force (IETF). Note that other groups may also distribute 33 working documents as Internet-Drafts. The list of current Internet- 34 Drafts is at https://datatracker.ietf.org/drafts/current/. 36 Internet-Drafts are draft documents valid for a maximum of six months 37 and may be updated, replaced, or obsoleted by other documents at any 38 time. It is inappropriate to use Internet-Drafts as reference 39 material or to cite them other than as "work in progress." 41 This Internet-Draft will expire on July 2, 2021. 43 Copyright Notice 45 Copyright (c) 2020 IETF Trust and the persons identified as the 46 document authors. All rights reserved. 48 This document is subject to BCP 78 and the IETF Trust's Legal 49 Provisions Relating to IETF Documents 50 (https://trustee.ietf.org/license-info) in effect on the date of 51 publication of this document. Please review these documents 52 carefully, as they describe your rights and restrictions with respect 53 to this document. Code Components extracted from this document must 54 include Simplified BSD License text as described in Section 4.e of 55 the Trust Legal Provisions and are provided without warranty as 56 described in the Simplified BSD License. 58 Table of Contents 60 1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . 2 61 1.1. Terminology and Notations . . . . . . . . . . . . . . . . 3 62 1.2. Prefix in Data Node Names . . . . . . . . . . . . . . . . 3 63 2. Layer 0 Types Module Contents . . . . . . . . . . . . . . . . 3 64 3. YANG Code for Layer 0 Types . . . . . . . . . . . . . . . . . 5 65 4. Security Considerations . . . . . . . . . . . . . . . . . . . 17 66 5. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 18 67 6. Acknowledgements . . . . . . . . . . . . . . . . . . . . . . 18 68 7. Contributors . . . . . . . . . . . . . . . . . . . . . . . . 18 69 8. References . . . . . . . . . . . . . . . . . . . . . . . . . 19 70 8.1. Normative References . . . . . . . . . . . . . . . . . . 19 71 8.2. Informative References . . . . . . . . . . . . . . . . . 20 72 Authors' Addresses . . . . . . . . . . . . . . . . . . . . . . . 21 74 1. Introduction 76 YANG [RFC7950] is a data modeling language used to model 77 configuration data, state data, Remote Procedure Calls, and 78 notifications for network management protocols such as NETCONF 79 [RFC6241]. The YANG language supports a small set of built-in data 80 types and provides mechanisms to derive other types from the built-in 81 types. 83 This document introduces a collection of common data types derived 84 from the built-in YANG data types. The derived types and groupings 85 are designed to be the common types applicable for modeling Traffic 86 Engineering (TE) features as well as non-TE features (e.g., physical 87 network configuration aspect) for Layer 0 optical networks in 88 model(s) defined outside of this document. The applicability of 89 Layer 0 types specified in this document include Wavelength Switched 90 Optical Networks (WSONs) [RFC6163] and [ITU-Tg6982], and Flexi-grid 91 Dense Wavelength Division Multiplexing (DWDM) Networks [RFC7698] and 92 [ITU-Tg6941] . 94 1.1. Terminology and Notations 96 Refer to [RFC7446] and [RFC7581] for the key terms used in this 97 document, and the terminology for describing YANG data models can be 98 found in [RFC7950]. 100 The YANG data model in this document conforms to the Network 101 Management Datastore Architecture defined in [RFC8342]. 103 1.2. Prefix in Data Node Names 105 In this document, names of data nodes and other data model objects 106 are prefixed using the standard prefix associated with the 107 corresponding YANG imported modules. 109 +-------------+---------------------------+----------------------+ 110 | Prefix | YANG module | Reference | 111 +-------------+---------------------------+----------------------+ 112 | l0-types | ietf-layer0-types | [RFCXXXX] | 113 +-------------+---------------------------+----------------------+ 115 Note: The RFC Editor will replace XXXX with the number assigned to 116 the RFC once this document becomes an RFC. 118 YANG module ietf-layer0-types (defined in Section 3) references 119 [RFC6163], [RFC6205], and [RFC7698]. 121 2. Layer 0 Types Module Contents 123 This document defines YANG module for common Layer 0 types, ietf- 124 layer0-types. This module is used for WSON and Flexi-grid DWDM 125 networks. The ietf-layer0-types module contains the following YANG 126 reusable types and groupings: 128 l0-grid-type: 130 A base YANG identity for the grid type as defined in [RFC6163] and 131 [RFC7698]. 133 dwdm-ch-spc-type: 135 A base YANG identity for the DWDM channel spacing type as defined in 136 [RFC6205]. 138 cwdm-ch-spc-type: 140 A base YANG identity for the CWDM channel spacing type as defined in 141 [RFC6205]. 143 wson-label-start-end: 145 WSON label range was defined in [RFC6205], and the generic topology 146 model defines the label-start/label-end in [RFC8795]. This grouping 147 shows the WSON-specific label-start and label-end information. 149 wson-label-hop: 151 WSON label range was defined in [RFC6205], and the generic topology 152 model defines the label-hop in [RFC8795]. This grouping shows the 153 WSON-specific label-hop information. 155 l0-label-range-info: 157 A YANG grouping that defines the layer 0 label range information 158 applicable for both WSON per priority level as defined in [RFC6205]. 159 This grouping is used in the flexi-grid DWDM by adding more flexi- 160 grid-specific parameters. 162 wson-label-step: 164 A YANG grouping that defines label steps for WSON as defined in 165 [RFC8776]. 167 flexi-grid-label-start-end: 169 Flexi-grid label range was defined in [RFC7698], and the generic 170 topology model defines the label-start/label-end in [RFC8795]. This 171 grouping shows the flexi-grid-specific label-start and label-end 172 information. 174 flexi-grid-label-hop: 176 Flexi-grid label range was defined in [RFC7698], and the generic 177 topology model defines the label-hop in [RFC8795]. This grouping 178 shows the WSON-specific label-hop information. 180 flexi-grid-label-range-info: 182 A YANG grouping that defines flexi-grid label range information and 183 per priority level as defined in [RFC7698] and [RFC8363]. 185 flexi-grid-label-step: 187 A YANG grouping that defines flexi-grid label steps as defined in 188 [RFC8776]. 190 3. YANG Code for Layer 0 Types 192 file "ietf-layer0-types@2020-12-29.yang" 193 module ietf-layer0-types { 194 yang-version 1.1; 195 namespace "urn:ietf:params:xml:ns:yang:ietf-layer0-types"; 197 prefix "l0-types"; 199 organization 200 "IETF CCAMP Working Group"; 201 contact 202 "WG Web: 203 WG List: 205 Editor: Haomian Zheng 206 208 Editor: Young Lee 209 211 Editor: Aihua Guo 212 214 Editor: Victor Lopez 215 217 Editor: Daniel King 218 "; 220 description 221 "This module defines Optical Layer 0 types. This module 222 provides groupings that can be applicable to Layer 0 223 Fixed Optical Networks (e.g., CWDM (Coarse Wavelength 224 Division Multiplexing) and DWDM (Dense Wavelength Division 225 Multiplexing)) and Flexi-grid Optical Networks. 227 Copyright (c) 2020 IETF Trust and the persons identified 228 as authors of the code. All rights reserved. 230 Redistribution and use in source and binary forms, with 231 or without modification, is permitted pursuant to, and 232 subject to the license terms contained in, the Simplified 233 BSD License set forth in Section 4.c of the IETF Trust's 234 Legal Provisions Relating to IETF Documents 235 (http://trustee.ietf.org/license-info). 237 This version of this YANG module is part of RFC XXXX; see 238 the RFC itself for full legal notices."; 240 revision "2020-12-29" { 241 description 242 "Initial Version"; 243 reference 244 "RFC XXXX: A YANG Data Model for Layer 0 Types"; 245 } 247 typedef dwdm-n { 248 type int16; 249 description 250 "The given value 'N' is used to determine the nominal central 251 frequency. 253 The nominal central frequency, 'f' is defined by: 254 f = 193100.000 GHz + N x channel-spacing (measured in GHz), 256 where 193100.000 GHz (193.100000 THz) is the ITU-T 'anchor 257 frequency' for transmission over the C band; and where 258 'channel-spacing' is defined by the dwdm-ch-spc-type."; 259 reference 260 "RFC6205: Generalized Labels for Lambda-Switch-Capable (LSC) 261 Label Switching Routers, 262 ITU-T G.694.1 (02/2012): Spectral grids for WDM applications: 263 DWDM frequency grid"; 264 } 266 typedef cwdm-n { 267 type int16; 268 description 269 "The given value 'N' is used to determine the nominal central 270 wavelength. 272 The nominal central wavelength is defined by: 273 Wavelength = 1471 nm + N x channel-spacing (measured in nm) 275 where 1471 nm is the ITU-T 'anchor wavelength' for 276 transmission over the C band; and where 'channel-spacing' is 277 defined by the cwdm-ch-spc-type."; 278 reference 279 "RFC6205: Generalized Labels for Lambda-Switch-Capable (LSC) 280 Label Switching Routers, 281 ITU-T G.694.2 (12/2003): Spectral grids for WDM applications: 283 CWDM wavelength grid"; 284 } 286 typedef flexi-n { 287 type int16; 288 description 289 "The given value 'N' is used to determine the nominal central 290 frequency. 292 The nominal central frequency, 'f' is defined by, 293 f = 193100.000 GHz + N x channel-spacing (measured in GHz), 295 where 193100.000 GHz (193.100000 THz) is the ITU-T 'anchor 296 frequency' for transmission over the C band; and where 297 'channel-spacing' is defined by the flexi-ch-spc-type. 299 Note that the term 'channel-spacing' can be alternated by the 300 term 'nominal central frequency granularity' defined in 301 clause 7 of ITU-T G.694.1."; 302 reference 303 "RFC7698: Framework and Requirements for GMPLS-Based Control 304 of Flexi-Grid Dense Wavelength Division Multiplexing (DWDM) 305 Networks. 306 ITU-T G.694.1 (02/2012): Spectral grids for WDM applications: 307 DWDM frequency grid"; 308 } 310 typedef flexi-m { 311 type uint16; 312 description 313 "The given value 'M' is used to determine the slot width. 315 A slot width is defined by: 316 slot width = M x SWG (measured in GHz), 318 where SWG is defined by the flexi-slot-width-granularity."; 319 reference 320 "RFC7698: Framework and Requirements for GMPLS-Based Control 321 of Flexi-Grid Dense Wavelength Division Multiplexing (DWDM) 322 Networks. 323 ITU-T G.694.1 (02/2012): Spectral grids for WDM applications: 324 DWDM frequency grid"; 325 } 327 identity l0-grid-type { 328 description 329 "Layer 0 grid type"; 330 reference 331 "RFC6163:Framework for GMPLS and Path Computation Element 332 (PCE) Control of Wavelength Switched Optical Networks (WSONs), 333 ITU-T G.694.1 (02/2012): Spectral grids for WDM applications: 334 DWDM frequency grid, 335 ITU-T G.694.2 (12/2003): Spectral grids for WDM applications: 336 CWDM wavelength grid"; 337 } 339 identity flexi-grid-dwdm { 340 base l0-grid-type; 341 description 342 "Flexi-grid"; 343 reference 344 "RFC7698: Framework and Requirements for GMPLS-Based Control 345 of Flexi-Grid Dense Wavelength Division Multiplexing (DWDM) 346 Networks, 347 ITU-T G.694.1 (02/2012): Spectral grids for WDM applications: 348 DWDM frequency grid"; 349 } 351 identity wson-grid-dwdm { 352 base l0-grid-type; 353 description 354 "DWDM grid"; 355 reference 356 "RFC6163:Framework for GMPLS and Path Computation Element 357 (PCE) Control of Wavelength Switched Optical Networks (WSONs), 358 ITU-T G.694.1 (02/2012): Spectral grids for WDM applications: 359 DWDM frequency grid"; 360 } 362 identity wson-grid-cwdm { 363 base l0-grid-type; 364 description 365 "CWDM grid"; 366 reference 367 "RFC6205: Generalized Labels for Lambda-Switch-Capable (LSC) 368 Label Switching Routers, 369 ITU-T G.694.2 (12/2003): Spectral grids for WDM applications: 370 CWDM wavelength grid"; 371 } 373 identity dwdm-ch-spc-type { 374 description 375 "DWDM channel spacing type"; 376 reference 377 "RFC6205: Generalized Labels for Lambda-Switch-Capable (LSC) 378 Label Switching Routers, 379 ITU-T G.694.1 (02/2012): Spectral grids for WDM applications: 380 DWDM frequency grid"; 381 } 383 identity dwdm-100ghz { 384 base dwdm-ch-spc-type; 385 description 386 "100GHz channel spacing"; 387 } 389 identity dwdm-50ghz { 390 base dwdm-ch-spc-type; 391 description 392 "50GHz channel spacing"; 393 } 395 identity dwdm-25ghz { 396 base dwdm-ch-spc-type; 397 description 398 "25GHz channel spacing"; 399 } 401 identity dwdm-12p5ghz { 402 base dwdm-ch-spc-type; 403 description 404 "12.5GHz channel spacing"; 405 } 407 identity flexi-ch-spc-type { 408 description 409 "Flexi-grid channel spacing type"; 410 reference 411 "RFC7698: Framework and Requirements for GMPLS-Based Control 412 of Flexi-Grid Dense Wavelength Division Multiplexing (DWDM) 413 Networks 414 ITU-T G.694.1 (02/2012): Spectral grids for WDM applications: 415 DWDM frequency grid"; 416 } 418 identity flexi-ch-spc-6p25ghz { 419 base flexi-ch-spc-type; 420 description 421 "6.25GHz channel spacing"; 422 } 424 identity flexi-slot-width-granularity { 425 description 426 "Flexi-grid slot width granularity"; 428 } 430 identity flexi-swg-12p5ghz { 431 base flexi-slot-width-granularity; 432 description 433 "12.5GHz slot width granularity"; 434 } 436 identity cwdm-ch-spc-type { 437 description 438 "CWDM channel spacing type"; 439 reference 440 "RFC6205: Generalized Labels for Lambda-Switch-Capable (LSC) 441 Label Switching Routers, 442 ITU-T G.694.2 (12/2003): Spectral grids for WDM applications: 443 CWDM wavelength grid"; 444 } 446 identity cwdm-20nm { 447 base cwdm-ch-spc-type; 448 description 449 "20nm channel spacing"; 450 } 452 /* Groupings. */ 454 grouping wson-label-start-end { 455 description 456 "The WSON label-start or label-end used to specify WSON label 457 range."; 458 choice grid-type { 459 description 460 "Label for DWDM or CWDM grid"; 461 case dwdm { 462 leaf dwdm-n { 463 when 'derived-from-or-self(../../../grid-type, 464 "wson-grid-dwdm")' 465 { 466 description 467 "Valid only when grid type is DWDM."; 468 } 469 type l0-types:dwdm-n; 470 description 471 "The central frequency of DWDM."; 472 reference 473 "RFC6205: Generalized Labels for Lambda-Switch-Capable 474 (LSC) Label Switching Routers"; 475 } 477 } 478 case cwdm { 479 leaf cwdm-n { 480 when 'derived-from-or-self(../../../grid-type, 481 "wson-grid-cwdm")' 482 { 483 description 484 "Valid only when grid type is CWDM."; 485 } 486 type l0-types:cwdm-n; 487 description 488 "Channel wavelength computing input."; 489 reference 490 "RFC6205: Generalized Labels for Lambda-Switch-Capable 491 (LSC) Label Switching Routers"; 492 } 493 } 494 } 495 reference 496 "RFC6205: Generalized Labels for Lambda-Switch-Capable (LSC) 497 Label Switching Routers"; 498 } 500 grouping wson-label-hop { 501 description 502 "Generic label hop information for WSON"; 503 choice grid-type { 504 description 505 "Label for DWDM or CWDM grid"; 506 case dwdm { 507 choice single-or-super-channel { 508 description "single or super channel"; 509 case single { 510 leaf dwdm-n { 511 type l0-types:dwdm-n; 512 description 513 "The given value 'N' is used to determine the 514 nominal central frequency."; 515 } 516 } 517 case super { 518 leaf-list subcarrier-dwdm-n { 519 type l0-types:dwdm-n; 520 description 521 "The given values 'N' are used to determine the 522 nominal central frequency for each subcarrier 523 channels."; 524 reference 525 "ITU-T Recommendation G.694.1: Spectral grids for 526 WDM applications: DWDM frequency grid"; 527 } 528 } 529 } 530 } 531 case cwdm { 532 leaf cwdm-n { 533 type l0-types:cwdm-n; 534 description 535 "The given value 'N' is used to determine the nominal 536 central wavelength."; 537 reference 538 "RFC6205: Generalized Labels for Lambda-Switch-Capable 539 (LSC) Label Switching Routers"; 540 } 541 } 542 } 543 reference 544 "RFC6205: Generalized Labels for Lambda-Switch-Capable (LSC) 545 Label Switching Routers"; 546 } 548 grouping l0-label-range-info { 549 description 550 "Information about layer 0 label range."; 551 leaf grid-type { 552 type identityref { 553 base l0-grid-type; 554 } 555 description "Grid type"; 556 } 557 leaf priority { 558 type uint8; 559 description 560 "Priority in Interface Switching Capability Descriptor 561 (ISCD)."; 562 reference 563 "RFC4203: OSPF Extensions in Support of Generalized 564 Multi-Protocol Label Switching (GMPLS)."; 565 } 566 reference 567 "RFC6205: Generalized Labels for Lambda-Switch-Capable (LSC) 568 Label Switching Routers"; 569 } 571 grouping wson-label-step { 572 description "Label step information for WSON"; 573 choice l0-grid-type { 574 description 575 "Grid type: DWDM, CWDM, etc."; 576 case dwdm { 577 leaf wson-dwdm-channel-spacing { 578 when 'derived-from-or-self(../../grid-type, 579 "wson-grid-dwdm")' 580 { 581 description 582 "Valid only when grid type is DWDM."; 583 } 584 type identityref { 585 base dwdm-ch-spc-type; 586 } 587 description 588 "Label-step is the channel-spacing (GHz), e.g., 100.000, 589 50.000, 25.000, or 12.500 GHz for DWDM"; 590 reference 591 "RFC6205: Generalized Labels for Lambda-Switch-Capable 592 (LSC) Label Switching Routers"; 593 } 594 } 595 case cwdm { 596 leaf wson-cwdm-channel-spacing { 597 when 'derived-from-or-self(../../grid-type, 598 "wson-grid-cwdm")' 599 { 600 description 601 "Valid only when grid type is CWDM."; 602 } 603 type identityref { 604 base cwdm-ch-spc-type; 605 } 606 description 607 "Label-step is the channel-spacing (nm), i.e., 20 nm 608 for CWDM, which is the only value defined for CWDM"; 609 reference 610 "RFC6205: Generalized Labels for Lambda-Switch-Capable 611 (LSC) Label Switching Routers"; 612 } 613 } 614 } 615 reference 616 "RFC6205: Generalized Labels for Lambda-Switch-Capable (LSC) 617 Label Switching Routers, 618 ITU-T G.694.2 (12/2003): Spectral grids for WDM applications: 619 CWDM wavelength grid"; 620 } 621 grouping flexi-grid-label-start-end { 622 description 623 "The Flexi-grid label-start or label-end used to specify 624 Flexi-grid label range."; 625 leaf flexi-n { 626 type l0-types:flexi-n; 627 description 628 "The given value 'N' is used to determine the nominal 629 central frequency."; 630 } 631 reference 632 "RFC7698: Framework and Requirements for GMPLS-Based Control 633 of Flexi-Grid Dense Wavelength Division Multiplexing (DWDM) 634 Networks"; 635 } 637 grouping flexi-grid-frequency-slot { 638 description "Flexi-grid frequency slot grouping."; 639 uses flexi-grid-label-start-end; 640 leaf flexi-m { 641 type l0-types:flexi-m; 642 description 643 "The given value 'M' is used to determine the slot width."; 644 } 645 reference 646 "RFC7698: Framework and Requirements for GMPLS-Based Control 647 of Flexi-Grid Dense Wavelength Division Multiplexing (DWDM) 648 Networks"; 649 } 651 grouping flexi-grid-label-hop { 652 description 653 "Generic label hop information for Flexi-grid"; 655 choice single-or-super-channel { 656 description "single or super channel"; 657 case single { 658 uses flexi-grid-frequency-slot; 659 } 660 case super { 661 list subcarrier-flexi-n { 662 key flexi-n; 663 uses flexi-grid-frequency-slot; 664 description 665 "List of subcarrier channels for flexi-grid super 666 channel."; 667 } 668 } 670 } 671 reference 672 "RFC7698: Framework and Requirements for GMPLS-Based Control 673 of Flexi-Grid Dense Wavelength Division Multiplexing (DWDM) 674 Networks"; 675 } 677 grouping flexi-grid-label-range-info { 678 description 679 "Flexi-grid-specific label range related information"; 680 uses l0-label-range-info; 681 container flexi-grid { 682 description "flexi-grid definition"; 683 leaf slot-width-granularity { 684 type identityref { 685 base flexi-slot-width-granularity; 686 } 687 default flexi-swg-12p5ghz; 688 description 689 "Minimum space between slot widths. Default is 12.500 690 GHz"; 691 reference 692 "RFC7698: Framework and Requirements for GMPLS-Based 693 Control of Flexi-Grid Dense Wavelength Division 694 Multiplexing (DWDM) Networks"; 695 } 696 leaf min-slot-width-factor { 697 type uint16 { 698 range "1..max"; 699 } 700 default 1; 701 description 702 "A multiplier of the slot width granularity, indicating 703 the minimum slot width supported by an optical port. 705 Minimum slot width is calculated by: 706 Minimum slot width (GHz) = 707 min-slot-width-factor * slot-width-granularity."; 708 reference 709 "RFC8363: GMPLS OSPF-TE Extensions in Support of Flexi- 710 Grid Dense Wavelength Division Multiplexing (DWDM) 711 Networks"; 712 } 714 leaf max-slot-width-factor { 715 type uint16 { 716 range "1..max"; 717 } 718 must '. >= min-slot-width-factor' { 719 error-message 720 "Maximum slot width must be greater than or equal to 721 minimum slot width."; 722 } 723 description 724 "A multiplier of the slot width granularity, indicating 725 the maximum slot width supported by an optical port. 727 Maximum slot width is calculated by: 728 Maximum slot width (GHz) = 729 max-slot-width-factor * slot-width-granularity 731 If specified, maximum slot width must be greater than or 732 equal to minimum slot width.If not specified, maximum 733 slot width is equal to minimum slot width."; 734 reference 735 "RFC8363: GMPLS OSPF-TE Extensions in Support of Flexi- 736 Grid Dense Wavelength Division Multiplexing (DWDM) 737 Networks"; 738 } 739 } 740 } 742 grouping flexi-grid-label-step { 743 description "Label step information for flexi-grid"; 744 leaf flexi-grid-channel-spacing { 745 type identityref { 746 base flexi-ch-spc-type; 747 } 748 default flexi-ch-spc-6p25ghz; 749 description 750 "Label-step is the nominal central frequency granularity 751 (GHz), e.g., 6.25 GHz"; 752 reference 753 "RFC7699: Generalized Labels for the Flexi-Grid in Lambda 754 Switch Capable (LSC) Label Switching Routers"; 755 } 756 leaf flexi-n-step { 757 type uint8; 758 description 759 "This attribute defines the multiplier for the supported 760 values of 'N'. 762 For example, given a grid with a nominal central frequency 763 granularity of 6.25 GHz, the granularity of the supported 764 values of the nominal central frequency could be 12.5 GHz. 765 In this case, the values of flexi-n should be even and this 766 constraint is reported by setting the flexi-n-step to 2. 768 This attribute is also known as central frequency 769 granularity in RFC8363."; 770 reference 771 "RFC8363: GMPLS OSPF-TE Extensions in Support of Flexi-Grid 772 Dense Wavelength Division Multiplexing (DWDM) Networks"; 773 } 774 } 775 } 777 779 4. Security Considerations 781 The YANG module specified in this document defines a schema for data 782 that is designed to be accessed via network management protocols such 783 as NETCONF [RFC6241] or RESTCONF [RFC8040]. The lowest NETCONF layer 784 is the secure transport layer, and the mandatory-to-implement secure 785 transport is Secure Shell (SSH) [RFC6242]. The lowest RESTCONF layer 786 is HTTPS, and the mandatory-to-implement secure transport is TLS 787 [RFC8446]. 789 The NETCONF access control model [RFC8341] provides the means to 790 restrict access for particular NETCONF users to a preconfigured 791 subset of all available NETCONF protocol operations and content. The 792 NETCONF Protocol over Secure Shell (SSH) [RFC6242] describes a method 793 for invoking and running NETCONF within a Secure Shell (SSH) session 794 as an SSH subsystem. The NETCONF access control model [RFC8341] 795 provides the means to restrict access for particular NETCONF or 796 RESTCONF users to a preconfigured subset of all available NETCONF or 797 RESTCONF protocol operations and content. 799 The objects in this YANG module are common data types and groupings. 800 No object in this module can be read or written to. These 801 definitions can be imported and used by other layer 0 specific 802 modules. It is critical to consider how imported definitions will be 803 utilized and accessible via RPC operations, as the resultant schema 804 will have data nodes that can be writable, or readable, and will have 805 a significant effect on the network operations if used incorrectly or 806 maliciously. All of this consideration belongs in the document that 807 defines the modules that import from this YANG module. Therefore, it 808 is important to manage access to resultant data nodes that are 809 considered sensitive or vulnerable in some network environments. 811 The security considerations spelled out in the YANG 1.1 specification 812 [RFC7950] apply for this document as well. 814 5. IANA Considerations 816 It is proposed to IANA to assign new URIs from the "IETF XML 817 Registry" [RFC3688] as follows: 819 URI: urn:ietf:params:xml:ns:yang:ietf-layer0-types 820 Registrant Contact: The IESG 821 XML: N/A; the requested URI is an XML namespace. 823 This document registers following YANG modules in the YANG Module 824 Names registry [RFC7950]. 826 name: ietf-layer0-types 827 namespace: urn:ietf:params:xml:ns:yang:ietf-layer0-types 828 prefix: l0-types 829 reference: RFC XXXX(TBD) 831 6. Acknowledgements 833 The authors and the working group give their sincere thanks for 834 Robert Wilton for the YANG doctor review, and Tom Petch for his 835 comments during the model and document development. 837 7. Contributors 839 Dhruv Dhody 840 Huawei 841 Email: dhruv.ietf@gmail.com 843 Bin Yeong Yoon 844 ETRI 845 Email: byyun@etri.re.kr 847 Ricard Vilalta 848 CTTC 849 Email: ricard.vilalta@cttc.es 851 Italo Busi 852 Huawei 853 Email: Italo.Busi@huawei.com 855 8. References 857 8.1. Normative References 859 [ITU-Tg6982] 860 International Telecommunication Union, "Amplified 861 multichannel dense wavelength division multiplexing 862 applications with single channel optical interfaces", 863 ITU-T G.698.2, November 2018. 865 [RFC4203] Kompella, K., Ed. and Y. Rekhter, Ed., "OSPF Extensions in 866 Support of Generalized Multi-Protocol Label Switching 867 (GMPLS)", RFC 4203, DOI 10.17487/RFC4203, October 2005, 868 . 870 [RFC6163] Lee, Y., Ed., Bernstein, G., Ed., and W. Imajuku, 871 "Framework for GMPLS and Path Computation Element (PCE) 872 Control of Wavelength Switched Optical Networks (WSONs)", 873 RFC 6163, DOI 10.17487/RFC6163, April 2011, 874 . 876 [RFC6205] Otani, T., Ed. and D. Li, Ed., "Generalized Labels for 877 Lambda-Switch-Capable (LSC) Label Switching Routers", 878 RFC 6205, DOI 10.17487/RFC6205, March 2011, 879 . 881 [RFC6241] Enns, R., Ed., Bjorklund, M., Ed., Schoenwaelder, J., Ed., 882 and A. Bierman, Ed., "Network Configuration Protocol 883 (NETCONF)", RFC 6241, DOI 10.17487/RFC6241, June 2011, 884 . 886 [RFC6242] Wasserman, M., "Using the NETCONF Protocol over Secure 887 Shell (SSH)", RFC 6242, DOI 10.17487/RFC6242, June 2011, 888 . 890 [RFC7698] Gonzalez de Dios, O., Ed., Casellas, R., Ed., Zhang, F., 891 Fu, X., Ceccarelli, D., and I. Hussain, "Framework and 892 Requirements for GMPLS-Based Control of Flexi-Grid Dense 893 Wavelength Division Multiplexing (DWDM) Networks", 894 RFC 7698, DOI 10.17487/RFC7698, November 2015, 895 . 897 [RFC7699] Farrel, A., King, D., Li, Y., and F. Zhang, "Generalized 898 Labels for the Flexi-Grid in Lambda Switch Capable (LSC) 899 Label Switching Routers", RFC 7699, DOI 10.17487/RFC7699, 900 November 2015, . 902 [RFC7950] Bjorklund, M., Ed., "The YANG 1.1 Data Modeling Language", 903 RFC 7950, DOI 10.17487/RFC7950, August 2016, 904 . 906 [RFC8040] Bierman, A., Bjorklund, M., and K. Watsen, "RESTCONF 907 Protocol", RFC 8040, DOI 10.17487/RFC8040, January 2017, 908 . 910 [RFC8341] Bierman, A. and M. Bjorklund, "Network Configuration 911 Access Control Model", STD 91, RFC 8341, 912 DOI 10.17487/RFC8341, March 2018, 913 . 915 [RFC8342] Bjorklund, M., Schoenwaelder, J., Shafer, P., Watsen, K., 916 and R. Wilton, "Network Management Datastore Architecture 917 (NMDA)", RFC 8342, DOI 10.17487/RFC8342, March 2018, 918 . 920 [RFC8363] Zhang, X., Zheng, H., Casellas, R., Gonzalez de Dios, O., 921 and D. Ceccarelli, "GMPLS OSPF-TE Extensions in Support of 922 Flexi-Grid Dense Wavelength Division Multiplexing (DWDM) 923 Networks", RFC 8363, DOI 10.17487/RFC8363, May 2018, 924 . 926 [RFC8446] Rescorla, E., "The Transport Layer Security (TLS) Protocol 927 Version 1.3", RFC 8446, DOI 10.17487/RFC8446, August 2018, 928 . 930 [RFC8776] Saad, T., Gandhi, R., Liu, X., Beeram, V., and I. Bryskin, 931 "Common YANG Data Types for Traffic Engineering", 932 RFC 8776, DOI 10.17487/RFC8776, June 2020, 933 . 935 [RFC8795] Liu, X., Bryskin, I., Beeram, V., Saad, T., Shah, H., and 936 O. Gonzalez de Dios, "YANG Data Model for Traffic 937 Engineering (TE) Topologies", RFC 8795, 938 DOI 10.17487/RFC8795, August 2020, 939 . 941 8.2. Informative References 943 [ITU-Tg6941] 944 International Telecommunication Union, "Spectral grids for 945 WDM applications: DWDM frequency grid", ITU-T G.694.1, 946 February 2012. 948 [ITU-Tg6942] 949 International Telecommunication Union, "Spectral grids for 950 WDM applications: CWDM wavelength grid", ITU-T G.694.2, 951 December 2003. 953 [ITU-Tg709] 954 International Telecommunication Union, "Interfaces for the 955 optical transport network", ITU-T G.709, June 2016. 957 [RFC3688] Mealling, M., "The IETF XML Registry", BCP 81, RFC 3688, 958 DOI 10.17487/RFC3688, January 2004, 959 . 961 [RFC7446] Lee, Y., Ed., Bernstein, G., Ed., Li, D., and W. Imajuku, 962 "Routing and Wavelength Assignment Information Model for 963 Wavelength Switched Optical Networks", RFC 7446, 964 DOI 10.17487/RFC7446, February 2015, 965 . 967 [RFC7581] Bernstein, G., Ed., Lee, Y., Ed., Li, D., Imajuku, W., and 968 J. Han, "Routing and Wavelength Assignment Information 969 Encoding for Wavelength Switched Optical Networks", 970 RFC 7581, DOI 10.17487/RFC7581, June 2015, 971 . 973 Authors' Addresses 975 Haomian Zheng 976 Huawei Technologies 977 H1, Huawei Xiliu Beipo Village, Songshan Lake 978 Dongguan, Guangdong 523808 979 China 981 Email: zhenghaomian@huawei.com 983 Young Lee 984 Samsung 985 South Korea 987 Email: younglee.tx@gmail.com 989 Aihua Guo 990 Futurewei 992 Email: aihuaguo.ietf@gmail.com 993 Victor Lopez 994 Telefonica 996 Email: victor.lopezalvarez@telefonica.com 998 Daniel King 999 University of Lancaster 1001 Email: d.king@lancaster.ac.uk