idnits 2.17.1 draft-ietf-ccamp-layer0-types-03.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 (November 28, 2019) is 1583 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 113, but not defined == Outdated reference: A later version (-13) exists of draft-ietf-teas-yang-te-types-12 Summary: 0 errors (**), 0 flaws (~~), 3 warnings (==), 1 comment (--). 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: May 31, 2020 SKKU 6 A. Guo 7 Futurewei 8 V. Lopez 9 Telefonica 10 D. King 11 University of Lancaster 12 November 28, 2019 14 A YANG Data Model for Layer 0 Types 15 draft-ietf-ccamp-layer0-types-03 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 May 31, 2020. 43 Copyright Notice 45 Copyright (c) 2019 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. Overview . . . . . . . . . . . . . . . . . . . . . . . . . . 3 64 2.1. Layer 0 Types Module Contents . . . . . . . . . . . . . . 3 65 3. YANG Code for Layer0 Types . . . . . . . . . . . . . . . . . 6 66 4. Security Considerations . . . . . . . . . . . . . . . . . . . 22 67 5. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 23 68 6. Acknowledgements . . . . . . . . . . . . . . . . . . . . . . 23 69 7. Contributors . . . . . . . . . . . . . . . . . . . . . . . . 24 70 8. References . . . . . . . . . . . . . . . . . . . . . . . . . 24 71 8.1. Normative References . . . . . . . . . . . . . . . . . . 24 72 8.2. Informative References . . . . . . . . . . . . . . . . . 25 73 Authors' Addresses . . . . . . . . . . . . . . . . . . . . . . . 26 75 1. Introduction 77 YANG [RFC6020] and [RFC7950] is a data modeling language used to 78 model configuration data, state data, Remote Procedure Calls, and 79 notifications for network management protocols such as NETCONF 80 [RFC6241]. The YANG language supports a small set of built-in data 81 types and provides mechanisms to derive other types from the built-in 82 types. 84 This document introduces a collection of common data types derived 85 from the built-in YANG data types. The derived types and groupings 86 are designed to be the common types applicable for modeling Traffic 87 Engineering (TE) features as well as non-TE features (e.g., physical 88 network configuration aspect) for Layer 0 optical networks in 89 model(s) defined outside of this document. The applicability of 90 Layer 0 types specified in this document include Wavelength Switched 91 Optical Networks (WSONs) [RFC6163] and [ITU-Tg6982], and Flexi-grid 92 Dense Wavelength Division Multiplexing (DWDM) Networks [RFC7698] and 93 [ITU-Tg6941] . 95 1.1. Terminology and Notations 97 Refer to [RFC7446] and [RFC7581] for the key terms used in this 98 document, and the terminology for describing YANG data models can be 99 found in [RFC7950]. 101 The YANG data model in this document conforms to the Network 102 Management Datastore Architecture defined in [RFC8342]. 104 1.2. Prefix in Data Node Names 106 In this document, names of data nodes and other data model objects 107 are prefixed using the standard prefix associated with the 108 corresponding YANG imported modules. 110 +-------------+---------------------------+----------------------+ 111 | Prefix | YANG module | Reference | 112 +-------------+---------------------------+----------------------+ 113 | layer0-types| ietf-layer0-types | [RFCXXXX] | 114 +-------------+---------------------------+----------------------+ 116 Note: The RFC Editor will replace XXXX with the number assigned to 117 the RFC once this document becomes an RFC. 119 YANG module ietf-layer0-types (defined in Section 3) references 120 [RFC6163], [RFC7205], and [RFC7698]. 122 2. Overview 124 This document defines YANG module for common Layer 0 types, ietf- 125 layer0-types. This module is used for WSON and Flexi-grid DWDM 126 networks. 128 2.1. Layer 0 Types Module Contents 130 The ietf-layer0-types module contains the following YANG reusable 131 types and groupings: 133 Operational-mode: 135 A type that represents operational mode as defined in [ITU-Tg6982]. 137 layer0-node-type: 139 A base YANG identity for supported node type as defined in [RFC6163]. 141 wavelength-assignment: 143 A base YANG identity for allocated wavelength assignment type as 144 defined in [RFC6163]. 146 layer0-grid-type: 148 A base YANG identity for the grid type as defined in [RFC6163] and 149 [RFC7698]. 151 term-type: 153 A base YANG identity for the supported termination type as defined in 154 [ITU-Tg709]. 156 layer0-bandwidth-type: 158 A base YANG identity for the layer0 bandwidth type as defined in 159 [ITU-Tg709]. 161 dwdm-ch-spc-type: 163 A base YANG identity for the DWDM channel spacing type as defined in 164 [RFC6205]. 166 cwdm-ch-spc-type: 168 A base YANG identity for the CWDM channel spacing type as defined in 169 [RFC6205]. 171 FEC-type: 173 A base YANG identity for the FEC type as defined in [ITU-Tg709]. 175 wson-path-bandwidth: 177 A YANG grouping that defines the WSON path bandwidth attributes as 178 defined in [RFC6163]. 180 wson-link-bandwidth: 182 A YANG grouping that defines WSON link bandwidth attributes as 183 defined in [RFC6163]. 185 wson-label-start-end: 187 A YANG grouping that defines the label-start and label-end for WSON 188 as defined in [RFC6205]. 190 wson-label-hop: 192 A YANG grouping that defines the label hop for WSON as defined in 193 [RFC6205]. 195 layer0-label-range-info: 197 A YANG grouping that defines the layer 0 label range information 198 applicable for both WSON per priority level as defined in [RFC6205]. 199 This grouping is used in the flexi-grid DWDM by adding more flexi- 200 grid-specific parameters. 202 wson-label-step: 204 A YANG grouping that defines label steps for WSON as defined in 205 [I-D.ietf-teas-yang-te-types]. 207 flexi-grid-node-attributes: 209 A YANG grouping that defines flexi-grid node attributes as defined in 210 [RFC7698]. 212 flexi-grid-path-bandwidth: 214 A YANG grouping that defines flexi-grid path bandwidth attributes as 215 defined in [RFC7698]. 217 flexi-grid-link-bandwidth: 219 A YANG grouping that defines flexi-grid link bandwidth attributes as 220 defined in [RFC7698]. 222 flexi-grid-label-start-end: 224 A YANG grouping that defines the label-start and label-end for flexi- 225 grid as defined in [RFC7698]. 227 flexi-grid-channel: 229 A YANG grouping that defines flexi-grid channel as defined in 230 [RFC7698]. 232 flexi-grid-label-hop: 234 A YANG grouping that defines the label hop for both single channel 235 and multiple carriers in flexi-grid DWDM, as defined in [RFC7698]. 237 flexi-grid-label-range-info: 239 A YANG grouping that defines flexi-grid label range information and 240 per priority level as defined in [RFC7698] and [RFC8363]. 242 flexi-grid-label-step: 244 A YANG grouping that defines flexi-grid label steps as defined in 245 [I-D.ietf-teas-yang-te-types]. 247 3. YANG Code for Layer0 Types 249 file "ietf-layer0-types@2019-11-28.yang" 250 module ietf-layer0-types { 251 namespace "urn:ietf:params:xml:ns:yang:ietf-layer0-types"; 252 prefix "layer0-types"; 254 organization 255 "IETF CCAMP Working Group"; 256 contact 257 "WG Web: 258 WG List: 260 Editor: Haomian Zheng 261 263 Editor: Young Lee 264 266 Editor: Aihua Guo 267 269 Editor: Victor Lopez 270 272 Editor: Daniel King 273 "; 275 description 276 "This module defines Optical Layer 0 types. This module 277 provides groupings that can be applicable to Layer 0 278 Fixed Optical Networks (e.g., CWDM (Coarse Wavelength 279 Division Multiplexing) and DWDM (Dense Wavelength Division 280 Multiplexing)) and Flexi-grid Optical Networks. 282 Copyright (c) 2019 IETF Trust and the persons identified 283 as authors of the code. All rights reserved. 285 Redistribution and use in source and binary forms, with 286 or without modification, is permitted pursuant to, and 287 subject to the license terms contained in, the Simplified 288 BSD License set forth in Section 4.c of the IETF Trust's 289 Legal Provisions Relating to IETF Documents 290 (http://trustee.ietf.org/license-info). 292 This version of this YANG module is part of RFC XXXX; see 293 the RFC itself for full legal notices."; 295 revision "2019-11-28" { 296 description 297 "Initial Version"; 298 reference 299 "RFC XXXX: A YANG Data Model for Layer 0 Types"; 300 } 302 typedef operational-mode { 303 type string; 304 description 305 "Vendor-specific mode that guarantees interoperability. 306 It must be an string with the following format: 307 B-DScW-ytz(v) where all these attributes are conforming 308 to the ITU-T recommendation"; 309 reference "ITU-T G.698.2 (11/2018) Section 5.3"; 310 } 312 typedef frequency-thz { 313 type decimal64 { 314 fraction-digits 6; 315 } 316 units THz; 317 description 318 "The DWDM frequency in THz, e.g., 193.112500"; 319 reference 320 "RFC6205: Generalized Labels for 321 Lambda-Switch-Capable (LSC) Label Switching Routers"; 322 } 324 typedef frequency-ghz { 325 type decimal64 { 326 fraction-digits 3; 327 } 328 units GHz; 329 description 330 "The DWDM frequency in GHz, e.g., 193112.500"; 331 reference 332 "RFC6205: Generalized Labels for 333 Lambda-Switch-Capable (LSC) Label Switching Routers"; 335 } 337 typedef dwdm-n 338 { 339 type int16; 340 description 341 "The given value 'N' is used to determine the nominal 342 central frequency. 344 The nominal central frequency, 'f' is defined by, 345 f = 193100.000 GHz + N x 12.500 GHz, 346 where 193100.000 GHz (193.100000 THz) is the ITU-T 'anchor 347 frequency' for transmission over the C band. "; 348 reference 349 "RFC6205: Generalized Labels for 350 Lambda-Switch-Capable (LSC) Label Switching Routers"; 351 } 353 typedef cwdm-n 354 { 355 type int16; 356 description 357 "The given value 'N' is used to compute the channel 358 wavelength as per the formula: 359 Wavelength (nm) = 1471 + N x 20 "; 360 reference 361 "RFC6205: Generalized Labels for 362 Lambda-Switch-Capable (LSC) Label Switching Routers"; 363 } 365 typedef flexi-n 366 { 367 type int16; 368 description 369 "The given value 'N' is used to determine the nominal 370 central frequency. 372 The nominal central frequency, 'f' is defined by, 373 f = 193100.000 GHz + N x 6.250 GHz, 374 where 193100.000 GHz (193.100000 THz) is the ITU-T 'anchor 375 frequency' for transmission over the C band. "; 376 reference 377 "RFC7698: Framework and Requirements for GMPLS-Based Control 378 of Flexi-Grid Dense Wavelength Division Multiplexing (DWDM) 379 Networks"; 380 } 382 identity layer0-node-type { 383 description 384 "layer0 node type."; 385 reference 386 "RFC6163:Framework for GMPLS and Path Computation Element 387 (PCE) Control of Wavelength Switched Optical Networks (WSONs)"; 388 } 390 identity flexi-grid-node { 391 base layer0-node-type; 392 description 393 "Flexi-grid node"; 394 } 396 identity wson-node-foadm { 397 base layer0-node-type; 398 description 399 "Fixed OADM (Optical Add-Drop Multiplexer) node"; 400 } 402 identity wson-node-roadm { 403 base layer0-node-type; 404 description 405 "ROADM (Reconfigurable Optical Add-Drop Multiplexer) 406 or OXC (Optical Cross Connect) node"; 407 } 409 identity wson-node-ila { 410 base layer0-node-type; 411 description 412 "ILA (In-Line Amplifier) node"; 413 } 415 identity wavelength-assignment { 416 description 417 "Wavelength selection base"; 418 reference 419 "RFC6163:Framework for GMPLS and Path Computation Element 420 (PCE) Control of Wavelength Switched Optical Networks (WSONs)"; 421 } 423 identity unspecified-wavelength-assignment { 424 base wavelength-assignment; 425 description 426 "No method specified"; 427 } 429 identity first-fit-wavelength-assignment { 430 base wavelength-assignment; 431 description 432 "All the available wavelengths are numbered, 433 and this WA (Wavelength Assignment) method chooses 434 the available wavelength with the lowest index"; 435 } 437 identity random-wavelength-assignment { 438 base wavelength-assignment; 439 description 440 "This WA method chooses an available 441 wavelength randomly"; 442 } 444 identity least-loaded-wavelength-assignment { 445 base wavelength-assignment; 446 description 447 "This WA method selects the wavelength that 448 has the largest residual capacity on the most loaded 449 link along the route (in multi-fiber networks)"; 450 } 452 identity layer0-grid-type { 453 description 454 "Layer 0 grid type"; 455 reference 456 "RFC6163:Framework for GMPLS and Path Computation Element 457 (PCE) Control of Wavelength Switched Optical Networks (WSONs)"; 458 } 460 identity flexi-grid-dwdm { 461 base layer0-grid-type; 462 description 463 "Flexi-grid"; 464 reference 465 "RFC7698: Framework and Requirements for GMPLS-Based Control 466 of Flexi-Grid Dense Wavelength Division Multiplexing (DWDM) 467 Networks"; 468 } 470 identity wson-grid-dwdm { 471 base layer0-grid-type; 472 description 473 "DWDM grid"; 474 } 476 identity wson-grid-cwdm { 477 base layer0-grid-type; 478 description 479 "CWDM grid"; 480 } 482 identity term-type { 483 description 484 "Termination type"; 485 reference 486 "ITU-T G.709: Interfaces for the Optical Transport Network"; 487 } 489 identity term-phys { 490 base term-type; 491 description 492 "Physical layer termination"; 493 } 495 identity term-otu { 496 base term-type; 497 description 498 "OTU (Optical Transport Unit) termination"; 499 } 501 identity term-odu { 502 base term-type; 503 description 504 "ODU (Optical Data Unit) termination"; 505 } 507 identity term-opu { 508 base term-type; 509 description 510 "OPU (Optical Payload Unit) termination"; 511 } 513 identity term-section { 514 base term-type; 515 description 516 "Section layer termination"; 517 } 519 identity layer0-bandwidth-type { 520 description 521 "Bandwidth type carried by a single wavelength channel"; 522 reference 523 "ITU-T G.709: Interfaces for the Optical Transport Network"; 524 } 526 identity bw-otu1 { 527 base layer0-bandwidth-type; 528 description 529 "OTU1 (2.66G)"; 530 } 532 identity bw-otu1e { 533 base layer0-bandwidth-type; 534 description 535 "OTU1e (11.04G)"; 536 } 538 identity bw-otu1f { 539 base layer0-bandwidth-type; 540 description 541 "OTU1f (11.27G)"; 542 } 544 identity bw-otu2 { 545 base layer0-bandwidth-type; 546 description 547 "OTU2 (10.70G)"; 548 } 550 identity bw-otu2e { 551 base layer0-bandwidth-type; 552 description 553 "OTU2e (11.09G)"; 554 } 556 identity bw-otu2f { 557 base layer0-bandwidth-type; 558 description 559 "OTU2f (11.31G)"; 560 } 562 identity bw-otu3 { 563 base layer0-bandwidth-type; 564 description 565 "OTU3 (43.01G)"; 566 } 568 identity bw-otu3e1 { 569 base layer0-bandwidth-type; 570 description 571 "OTU3e1 (44.57G)"; 572 } 574 identity bw-otu3e2 { 575 base layer0-bandwidth-type; 576 description 577 "OTU3e2 (44.58G)"; 578 } 580 identity bw-otu4 { 581 base layer0-bandwidth-type; 582 description 583 "OTU4 (111.80G)"; 584 } 586 identity bw-otucn { 587 base layer0-bandwidth-type; 588 description 589 "OTUCn (beyond 100G)"; 590 } 592 identity dwdm-ch-spc-type { 593 description 594 "DWDM channel spacing type"; 595 reference 596 "RFC6205: Generalized Labels for 597 Lambda-Switch-Capable (LSC) Label Switching Routers"; 598 } 600 identity dwdm-100ghz { 601 base dwdm-ch-spc-type; 602 description 603 "100GHz channel spacing"; 604 } 606 identity dwdm-50ghz { 607 base dwdm-ch-spc-type; 608 description 609 "50GHz channel spacing"; 610 } 612 identity dwdm-25ghz { 613 base dwdm-ch-spc-type; 614 description 615 "25GHz channel spacing"; 616 } 618 identity dwdm-12p5ghz { 619 base dwdm-ch-spc-type; 620 description 621 "12.5GHz channel spacing"; 622 } 623 identity flexi-ch-spc-type { 624 description 625 "Flexi-grid channel spacing type"; 626 reference 627 "RFC7698: Framework and Requirements for GMPLS-Based Control 628 of Flexi-Grid Dense Wavelength Division Multiplexing (DWDM) 629 Networks"; 630 } 632 identity flexi-ch-spc-6p25ghz { 633 base flexi-ch-spc-type; 634 description 635 "6.25GHz channel spacing"; 636 } 638 identity flexi-slot-width-granularity { 639 description 640 "Flexi-grid slot width granularity"; 641 } 643 identity flexi-swg-12p5ghz { 644 base flexi-slot-width-granularity; 645 description 646 "12.5GHz slot width granularity"; 647 } 649 identity cwdm-ch-spc-type { 650 description 651 "CWDM channel spacing type"; 652 reference 653 "RFC6205: Generalized Labels for 654 Lambda-Switch-Capable (LSC) Label Switching Routers"; 655 } 657 identity cwdm-20nm { 658 base cwdm-ch-spc-type; 659 description 660 "20nm channel spacing"; 661 } 663 identity fec-type { 664 description 665 "FEC (Forward Error Correction) type"; 666 reference 667 "ITU-T G.709: Interfaces for the Optical Transport Network"; 668 } 670 identity g-fec { 671 base fec-type; 672 description 673 "G-FEC (Generic-FEC)"; 674 } 675 identity e-fec { 676 base fec-type; 677 description 678 "E-FEC (Enhanced-FEC)"; 679 } 680 identity no-fec { 681 base fec-type; 682 description 683 "No FEC"; 684 } 686 /* Groupings. */ 687 grouping wson-path-bandwidth { 688 description 689 "WSON (Wavelength Switched Optical Network) 690 path bandwidth attributes"; 691 leaf bandwidth-type { 692 type identityref { 693 base layer0-bandwidth-type; 694 } 695 description "WSON bandwidth type"; 696 } 697 reference 698 "RFC6163:Framework for GMPLS and Path Computation Element 699 (PCE) Control of Wavelength Switched Optical Networks (WSONs)"; 700 } 702 grouping wson-link-bandwidth { 703 description 704 "WSON link bandwidth attributes"; 705 leaf-list supported-bandwidth-list { 706 type identityref { 707 base layer0-bandwidth-type; 708 } 709 description "WSON bandwidth type"; 710 } 711 reference 712 "RFC6163:Framework for GMPLS and Path Computation Element 713 (PCE) Control of Wavelength Switched Optical Networks (WSONs)"; 714 } 716 grouping wson-label-start-end { 717 description 718 "The WSON label-start or label-end used to 719 specify WSON label range."; 720 choice grid-type { 721 description 722 "Label for DWDM or CWDM grid"; 723 case dwdm { 724 leaf dwdm-n { 725 type layer0-types:dwdm-n; 726 description 727 "The central frequency of DWDM. "; 728 reference 729 "RFC6205: Generalized Labels for 730 Lambda-Switch-Capable (LSC) Label Switching Routers"; 731 } 732 } 733 case cwdm { 734 leaf cwdm-n { 735 type layer0-types:cwdm-n; 736 description 737 "Channel wavelength computing input. "; 738 reference 739 "RFC6205: Generalized Labels for 740 ambda-Switch-Capable (LSC) Label Switching Routers"; 741 } 742 } 743 } 744 reference 745 "RFC6205: Generalized Labels for 746 Lambda-Switch-Capable (LSC) Label Switching Routers"; 747 } 749 grouping wson-label-hop { 750 description 751 "Generic label hop information for WSON"; 752 choice grid-type { 753 description 754 "Label for DWDM or CWDM grid"; 755 case dwdm { 756 choice single-or-super-channel { 757 description "single or super channel"; 758 case single { 759 leaf dwdm-n { 760 type layer0-types:dwdm-n; 761 description 762 "The central frequency of DWDM. "; 763 } 764 } 765 case super { 766 leaf-list subcarrier-dwdm-n { 767 type layer0-types:dwdm-n; 768 description 769 "List of center frequencies for each subcarrier 770 channels."; 771 reference 772 "ITU-T Recommendation G.694.1: Spectral girds for 773 WDM applications: DWDM frequency grid"; 775 } 776 } 777 } 779 } 780 case cwdm { 781 leaf cwdm-n { 782 type layer0-types:cwdm-n; 783 description 784 "Channel wavelength computing input. "; 785 reference 786 "RFC6205: Generalized Labels for 787 Lambda-Switch-Capable (LSC) Label Switching Routers"; 788 } 789 } 790 } 791 reference 792 "RFC6205: Generalized Labels for 793 Lambda-Switch-Capable (LSC) Label Switching Routers"; 794 } 796 grouping layer0-label-range-info { 797 description 798 "Information for layer0 label range."; 800 leaf grid-type { 801 type identityref { 802 base layer0-grid-type; 803 } 804 description "Grid type"; 805 } 806 leaf priority { 807 type uint8; 808 description "Priority"; 809 } 810 reference 811 "RFC6205: Generalized Labels for 812 Lambda-Switch-Capable (LSC) Label Switching Routers"; 813 } 814 grouping wson-label-step { 815 description "Label step information for WSON"; 816 choice layer0-grid-type { 817 description 818 "Grid type: DWDM, CWDM, etc."; 819 case dwdm { 820 leaf wson-dwdm { 821 type identityref { 822 base dwdm-ch-spc-type; 823 } 824 description 825 "Label-step is the channel-spacing (GHz), e.g., 826 100.000, 50.000, 25.000, or 12.500 GHz for DWDM"; 827 reference 828 "RFC6205: Generalized Labels for 829 Lambda-Switch-Capable (LSC) Label Switching Routers"; 830 } 831 } 832 case cwdm { 833 leaf wson-cwdm { 834 type identityref { 835 base cwdm-ch-spc-type; 836 } 837 description 838 "label-step is the channel-spacing (nm), i.e., 20 nm 839 for CWDM, which is the only value defined for CWDM"; 840 reference 841 "RFC6205: Generalized Labels for 842 Lambda-Switch-Capable (LSC) Label Switching Routers"; 843 } 844 } 845 } 846 reference 847 "RFC6205: Generalized Labels for 848 Lambda-Switch-Capable (LSC) Label Switching Routers"; 849 } 851 grouping flexi-grid-node-attributes { 852 description "Flexi-grid node attributes"; 853 container flexi-grid-node { 854 description "Flexi-grid node attrtibutes"; 855 leaf node-type { 856 type identityref { 857 base layer0-node-type; 858 } 859 description "Flexi-grid node type"; 860 } 861 } 862 reference 863 "RFC7698: Framework and Requirements for GMPLS-Based Control 864 of Flexi-Grid Dense Wavelength Division Multiplexing (DWDM) 865 Networks"; 866 } 868 grouping flexi-grid-path-bandwidth { 869 description "Flexi-grid path bandwidth attributes"; 870 leaf bandwidth-type { 871 type identityref { 872 base layer0-bandwidth-type; 873 } 874 description "Flexi-grid bandwidth type"; 875 } 876 reference 877 "RFC7698: Framework and Requirements for GMPLS-Based Control 878 of Flexi-Grid Dense Wavelength Division Multiplexing (DWDM) 879 Networks"; 880 } 882 grouping flexi-grid-link-bandwidth { 883 description "flexi-grid link bandwidth attributes"; 884 leaf-list supported-bandwidth-list { 885 type identityref { 886 base layer0-bandwidth-type; 887 } 888 description "Flexi-grid bandwidth type"; 889 } 890 reference 891 "RFC7698: Framework and Requirements for GMPLS-Based Control 892 of Flexi-Grid Dense Wavelength Division Multiplexing (DWDM) 893 Networks"; 894 } 896 grouping flexi-grid-label-start-end { 897 description 898 "Label-start and Label-end information for Flexi-grid."; 899 leaf flexi-n { 900 type int16; 901 description 902 "The central frequency in Flexi-grid."; 903 } 904 reference 905 "RFC7698: Framework and Requirements for GMPLS-Based Control 906 of Flexi-Grid Dense Wavelength Division Multiplexing (DWDM) 907 Networks"; 908 } 909 grouping flexi-grid-channel { 910 description "Flexi-grid channel grouping."; 912 uses flexi-grid-label-start-end; 914 leaf flexi-m { 915 type uint16 { 916 range "1..max"; 917 } 918 description 919 "M is used to determine the slot width. A slot width is 920 constrained to be M x SWG (that is, M x 12.500 GHz), 921 where M is a positive integer."; 923 } 924 reference 925 "RFC7698: Framework and Requirements for GMPLS-Based Control 926 of Flexi-Grid Dense Wavelength Division Multiplexing (DWDM) 927 Networks"; 928 } 929 grouping flexi-grid-label-hop { 930 description "Flexi-grid path label."; 931 choice single-or-super-channel { 932 description "single of super channel"; 933 case single { 934 uses flexi-grid-channel; 935 } 936 case super { 937 list subcarrier-flexi-n { 938 key flexi-n; 939 uses flexi-grid-channel; 940 description 941 "List of subcarrier channels for flexi-grid 942 super channel."; 943 } 944 } 945 } 946 reference 947 "RFC7698: Framework and Requirements for GMPLS-Based Control 948 of Flexi-Grid Dense Wavelength Division Multiplexing (DWDM) 949 Networks"; 950 } 952 grouping flexi-grid-label-range-info { 953 description 954 "Info of Flexi-grid-specific label range"; 955 uses layer0-label-range-info; 956 container flexi-grid { 957 description "flexi-grid definition"; 958 leaf nominal-central-frequency-granularity { 959 type identityref { 960 base flexi-ch-spc-type; 961 } 962 default flexi-ch-spc-6p25ghz; 963 description 964 "It is the spacing between allowed nominal central 965 frequencies. Default is 6.250 GHz"; 966 reference 967 "RFC7698: Framework and Requirements for GMPLS-Based Control 968 of Flexi-Grid Dense Wavelength Division Multiplexing (DWDM) 969 Networks"; 970 } 972 leaf slot-width-granularity { 973 type identityref { 974 base flexi-slot-width-granularity; 975 } 976 default flexi-swg-12p5ghz; 977 description 978 "Minimum space between slot widths. Default is 979 12.500 GHz"; 980 reference 981 "RFC7698: Framework and Requirements for GMPLS-Based Control 982 of Flexi-Grid Dense Wavelength Division Multiplexing (DWDM) 983 Networks"; 984 } 986 leaf min-slot-width-factor { 987 type uint16 { 988 range "1..max"; 989 } 990 default 1; 991 description 992 "Minimum slot width is calculated by: 993 Minimum slot width (GHz) = 994 min-slot-width-factor * slot-width-granularity"; 995 reference 996 "RFC8363: GMPLS OSPF-TE Extensions in Support of Flexi-Grid 997 Dense Wavelength Division Multiplexing (DWDM) Networks"; 998 } 1000 leaf max-slot-width-factor { 1001 type uint16 { 1002 range "1..max"; 1003 } 1004 description 1005 "Maximum slot width is calculated by: 1006 Maximum slot width (GHz) = 1007 max-slot-width-factor * slot-width-granularity"; 1008 reference 1009 "RFC8363: GMPLS OSPF-TE Extensions in Support of Flexi-Grid 1010 Dense Wavelength Division Multiplexing (DWDM) Networks"; 1011 } 1013 } 1014 } 1016 grouping flexi-grid-label-step { 1017 description "Label step information for flexi-grid"; 1018 leaf flex { 1019 type identityref { 1020 base flexi-ch-spc-type; 1021 } 1022 default flexi-ch-spc-6p25ghz; 1023 description 1024 "Label-step is the nominal central frequency 1025 granularity (GHz), e.g., 6.25 GHz"; 1026 } 1027 reference 1028 "RFC7698: Framework and Requirements for GMPLS-Based Control 1029 of Flexi-Grid Dense Wavelength Division Multiplexing (DWDM) 1030 Networks"; 1031 } 1032 } 1033 1035 4. Security Considerations 1037 The YANG module specified in this document defines a schema for data 1038 that is designed to be accessed via network management protocols such 1039 as NETCONF [RFC6241] or RESTCONF [RFC8040]. The lowest NETCONF layer 1040 is the secure transport layer, and the mandatory-to-implement secure 1041 transport is Secure Shell (SSH) [RFC6242]. The lowest RESTCONF layer 1042 is HTTPS, and the mandatory-to-implement secure transport is TLS 1043 [RFC8446]. 1045 The NETCONF access control model [RFC8341] provides the means to 1046 restrict access for particular NETCONF users to a preconfigured 1047 subset of all available NETCONF protocol operations and content. The 1048 NETCONF Protocol over Secure Shell (SSH) [RFC6242] describes a method 1049 for invoking and running NETCONF within a Secure Shell (SSH) session 1050 as an SSH subsystem. The NETCONF access control model [RFC8341] 1051 provides the means to restrict access for particular NETCONF or 1052 RESTCONF users to a preconfigured subset of all available NETCONF or 1053 RESTCONF protocol operations and content. 1055 The YANG module in this document defines optical layer0 type 1056 definitions (i.e., typedef, identity and grouping statements) in YANG 1057 data modeling language to be imported and used by other layer 0 1058 specific modules. When imported and used, the resultant schema will 1059 have data nodes that can be writable, or readable. The access to 1060 such data nodes may be considered sensitive or vulnerable in some 1061 network environments. Write operations (e.g., edit-config) to these 1062 data nodes without proper protection can have a negative effect on 1063 network operations. 1065 The security considerations spelled out in the YANG 1.1 specification 1066 [RFC7950] apply for this document as well. 1068 5. IANA Considerations 1070 It is proposed that IANA should assign new URIs from the "IETF XML 1071 Registry" [RFC3688] as follows: 1073 URI: urn:ietf:params:xml:ns:yang:ietf-layer0-types 1074 Registrant Contact: The IESG 1075 XML: N/A; the requested URI is an XML namespace. 1077 This document registers following YANG modules in the YANG Module 1078 Names registry [RFC7950]. 1080 name: ietf-layer0-types 1081 namespace: urn:ietf:params:xml:ns:yang:ietf-layer0-types 1082 prefix: layer0-types 1083 reference: RFC XXXX(TBD) 1085 6. Acknowledgements 1087 The authors and the working group give their sincere thanks for 1088 Robert Wilton for the YANG doctor review, and Tom Petch for his 1089 comments during the model and document development. 1091 7. Contributors 1093 Dhruv Dhody 1094 Huawei 1095 Email: dhruv.ietf@gmail.com 1097 Bin Yeong Yoon 1098 ETRI 1099 Email: byyun@etri.re.kr 1101 Ricard Vilalta 1102 CTTC 1103 Email: ricard.vilalta@cttc.es 1105 Italo Busi 1106 Huawei 1107 Email: Italo.Busi@huawei.com 1109 8. References 1111 8.1. Normative References 1113 [RFC6020] Bjorklund, M., Ed., "YANG - A Data Modeling Language for 1114 the Network Configuration Protocol (NETCONF)", RFC 6020, 1115 DOI 10.17487/RFC6020, October 2010, 1116 . 1118 [RFC6241] Enns, R., Ed., Bjorklund, M., Ed., Schoenwaelder, J., Ed., 1119 and A. Bierman, Ed., "Network Configuration Protocol 1120 (NETCONF)", RFC 6241, DOI 10.17487/RFC6241, June 2011, 1121 . 1123 [RFC6242] Wasserman, M., "Using the NETCONF Protocol over Secure 1124 Shell (SSH)", RFC 6242, DOI 10.17487/RFC6242, June 2011, 1125 . 1127 [RFC7950] Bjorklund, M., Ed., "The YANG 1.1 Data Modeling Language", 1128 RFC 7950, DOI 10.17487/RFC7950, August 2016, 1129 . 1131 [RFC8040] Bierman, A., Bjorklund, M., and K. Watsen, "RESTCONF 1132 Protocol", RFC 8040, DOI 10.17487/RFC8040, January 2017, 1133 . 1135 [RFC8341] Bierman, A. and M. Bjorklund, "Network Configuration 1136 Access Control Model", STD 91, RFC 8341, 1137 DOI 10.17487/RFC8341, March 2018, 1138 . 1140 [RFC8342] Bjorklund, M., Schoenwaelder, J., Shafer, P., Watsen, K., 1141 and R. Wilton, "Network Management Datastore Architecture 1142 (NMDA)", RFC 8342, DOI 10.17487/RFC8342, March 2018, 1143 . 1145 [RFC8446] Rescorla, E., "The Transport Layer Security (TLS) Protocol 1146 Version 1.3", RFC 8446, DOI 10.17487/RFC8446, August 2018, 1147 . 1149 8.2. Informative References 1151 [I-D.ietf-teas-yang-te-types] 1152 Saad, T., Gandhi, R., Liu, X., Beeram, V., and I. Bryskin, 1153 "Traffic Engineering Common YANG Types", draft-ietf-teas- 1154 yang-te-types-12 (work in progress), November 2019. 1156 [ITU-Tg6941] 1157 International Telecommunication Union, "Spectral grids for 1158 WDM applications: DWDM frequency grid", ITU-T G.694.1, 1159 February 2012. 1161 [ITU-Tg6982] 1162 International Telecommunication Union, "Amplified 1163 multichannel dense wavelength division multiplexing 1164 applications with single channel optical interfaces", 1165 ITU-T G.698.2, November 2018. 1167 [ITU-Tg709] 1168 International Telecommunication Union, "Interfaces for the 1169 optical transport network", ITU-T G.709, June 2016. 1171 [RFC3688] Mealling, M., "The IETF XML Registry", BCP 81, RFC 3688, 1172 DOI 10.17487/RFC3688, January 2004, 1173 . 1175 [RFC6163] Lee, Y., Ed., Bernstein, G., Ed., and W. Imajuku, 1176 "Framework for GMPLS and Path Computation Element (PCE) 1177 Control of Wavelength Switched Optical Networks (WSONs)", 1178 RFC 6163, DOI 10.17487/RFC6163, April 2011, 1179 . 1181 [RFC6205] Otani, T., Ed. and D. Li, Ed., "Generalized Labels for 1182 Lambda-Switch-Capable (LSC) Label Switching Routers", 1183 RFC 6205, DOI 10.17487/RFC6205, March 2011, 1184 . 1186 [RFC7205] Romanow, A., Botzko, S., Duckworth, M., and R. Even, Ed., 1187 "Use Cases for Telepresence Multistreams", RFC 7205, 1188 DOI 10.17487/RFC7205, April 2014, 1189 . 1191 [RFC7446] Lee, Y., Ed., Bernstein, G., Ed., Li, D., and W. Imajuku, 1192 "Routing and Wavelength Assignment Information Model for 1193 Wavelength Switched Optical Networks", RFC 7446, 1194 DOI 10.17487/RFC7446, February 2015, 1195 . 1197 [RFC7581] Bernstein, G., Ed., Lee, Y., Ed., Li, D., Imajuku, W., and 1198 J. Han, "Routing and Wavelength Assignment Information 1199 Encoding for Wavelength Switched Optical Networks", 1200 RFC 7581, DOI 10.17487/RFC7581, June 2015, 1201 . 1203 [RFC7698] Gonzalez de Dios, O., Ed., Casellas, R., Ed., Zhang, F., 1204 Fu, X., Ceccarelli, D., and I. Hussain, "Framework and 1205 Requirements for GMPLS-Based Control of Flexi-Grid Dense 1206 Wavelength Division Multiplexing (DWDM) Networks", 1207 RFC 7698, DOI 10.17487/RFC7698, November 2015, 1208 . 1210 [RFC8363] Zhang, X., Zheng, H., Casellas, R., Gonzalez de Dios, O., 1211 and D. Ceccarelli, "GMPLS OSPF-TE Extensions in Support of 1212 Flexi-Grid Dense Wavelength Division Multiplexing (DWDM) 1213 Networks", RFC 8363, DOI 10.17487/RFC8363, May 2018, 1214 . 1216 Authors' Addresses 1218 Haomian Zheng 1219 Huawei Technologies 1220 H1-1-A043S Huawei Industrial Base, Songshanhu 1221 Dongguan, Guangdong 523808 1222 China 1224 Email: zhenghaomian@huawei.com 1226 Young Lee 1227 SKKU 1228 Sung Kyun Kwan University 1229 Seoul 1230 South Korea 1232 Email: younglee.tx@gmail.com 1233 Aihua Guo 1234 Futurewei 1236 Email: aihuaguo@futurewei.com 1238 Victor Lopez 1239 Telefonica 1241 Email: victor.lopezalvarez@telefonica.com 1243 Daniel King 1244 University of Lancaster 1246 Email: d.king@lancaster.ac.uk