From 4ea0d72820c77dda655b050f762b73bd21144a9e Mon Sep 17 00:00:00 2001 From: italobusi Date: Fri, 7 Jul 2023 19:50:37 +0200 Subject: [PATCH] Added changes from https://github.com/ietf-ccamp-wg/ietf-ccamp-layer0-types-ext-RFC9093-bis/commit/d4308b39420b63203a1a2234d1c76a3153387af5 and https://github.com/ietf-ccamp-wg/ietf-ccamp-layer0-types-ext-RFC9093-bis/commit/3a61c2b773ed0e32b106cc86bd8c48f6fe8c19b1 Co-authored-by: sergio belotti --- draft-ietf-ccamp-rfc9093-bis.md | 16 +- draft-ietf-ccamp-rfc9093-bis.txt | 1216 ++++++++----- draft-ietf-ccamp-rfc9093-bis.xml | 2839 ------------------------------ ietf-layer0-types.yang | 18 +- 4 files changed, 771 insertions(+), 3318 deletions(-) delete mode 100644 draft-ietf-ccamp-rfc9093-bis.xml diff --git a/draft-ietf-ccamp-rfc9093-bis.md b/draft-ietf-ccamp-rfc9093-bis.md index db06bc2..30cfa23 100644 --- a/draft-ietf-ccamp-rfc9093-bis.md +++ b/draft-ietf-ccamp-rfc9093-bis.md @@ -214,14 +214,16 @@ Please replace XXXX with the RFC number assigned to this document. wson-label-step: > A YANG grouping that defines label steps for WSON as defined in - {{!RFC8776}}. + {{!I-D.ietf-teas-rfc8776-update}}. flexi-grid-label-start-end: - > The flexi-grid label range was defined in {{!RFC7698}}, and the - generic topology model defines the label-start/label-end in - {{!RFC8795}}. This grouping shows the flexi-grid-specific label- - start and label-end information. + > The flexi-grid label range was defined in {{!RFC7698}}, and the + generic topology model defines the label-start/label-end in + {{!RFC8795}}. This grouping shows the flexi-grid-specific label- + start and label-end information which is used to describe the range of available nominal central frequencies. + + > As described in section 3.1 of {{!RFC8363}}, the range of available nominal central frequencies are advertised for m=1, which means that for an available central frequency n, the frequency slot from central frequency n-1 to central frequency n+1 is available. flexi-grid-label-hop: @@ -237,7 +239,7 @@ Please replace XXXX with the RFC number assigned to this document. flexi-grid-label-step: > A YANG grouping that defines flexi-grid label steps as defined in - {{!RFC8776}}. + {{!I-D.ietf-teas-rfc8776-update}}. transceiver-capabilities: @@ -282,7 +284,7 @@ Please replace XXXX with the RFC number assigned to this document. {::include ./ietf-layer0-types.yang} ~~~~ {: #fig-te-yang title="Layer 0 Types YANG module" -sourcecode-markers="true" sourcecode-name="ietf-layer0-types@2023-03-07.yang"} +sourcecode-markers="true" sourcecode-name="ietf-layer0-types@2023-07-07.yang"} # Security Considerations diff --git a/draft-ietf-ccamp-rfc9093-bis.txt b/draft-ietf-ccamp-rfc9093-bis.txt index 3df6ec8..408f155 100644 --- a/draft-ietf-ccamp-rfc9093-bis.txt +++ b/draft-ietf-ccamp-rfc9093-bis.txt @@ -6,7 +6,7 @@ CCAMP Working Group S. Belotti, Ed. Internet-Draft Nokia Obsoletes: 9093 (if approved) I. Busi, Ed. Intended status: Standards Track Huawei -Expires: 13 September 2023 D. Beller, Ed. +Expires: 8 January 2024 D. Beller, Ed. Nokia H. Zheng Huawei @@ -16,7 +16,7 @@ Expires: 13 September 2023 D. Beller, Ed. Futurewei Technologies D. King University of Lancaster - 12 March 2023 + 7 July 2023 A YANG Data Model for Layer 0 Types @@ -48,14 +48,14 @@ Status of This Memo time. It is inappropriate to use Internet-Drafts as reference material or to cite them other than as "work in progress." - This Internet-Draft will expire on 13 September 2023. + This Internet-Draft will expire on 8 January 2024. -Belotti, et al. Expires 13 September 2023 [Page 1] +Belotti, et al. Expires 8 January 2024 [Page 1] -Internet-Draft Yang for Layer 0 Types March 2023 +Internet-Draft Yang for Layer 0 Types July 2023 Copyright Notice @@ -79,15 +79,15 @@ Table of Contents 1.2. Prefix in Data Node Names . . . . . . . . . . . . . . . . 3 2. Layer 0 Types Module Contents . . . . . . . . . . . . . . . . 4 3. YANG Module for Layer 0 Types . . . . . . . . . . . . . . . . 6 - 4. Security Considerations . . . . . . . . . . . . . . . . . . . 41 - 5. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 42 - 6. References . . . . . . . . . . . . . . . . . . . . . . . . . 42 - 6.1. Normative References . . . . . . . . . . . . . . . . . . 42 - 6.2. Informative References . . . . . . . . . . . . . . . . . 44 - Appendix A. Changes from RFC 9093 . . . . . . . . . . . . . . . 45 - Acknowledgments . . . . . . . . . . . . . . . . . . . . . . . . . 45 - Contributors . . . . . . . . . . . . . . . . . . . . . . . . . . 46 - Authors' Addresses . . . . . . . . . . . . . . . . . . . . . . . 46 + 4. Security Considerations . . . . . . . . . . . . . . . . . . . 46 + 5. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 47 + 6. References . . . . . . . . . . . . . . . . . . . . . . . . . 47 + 6.1. Normative References . . . . . . . . . . . . . . . . . . 47 + 6.2. Informative References . . . . . . . . . . . . . . . . . 49 + Appendix A. Changes from RFC 9093 . . . . . . . . . . . . . . . 50 + Acknowledgments . . . . . . . . . . . . . . . . . . . . . . . . . 50 + Contributors . . . . . . . . . . . . . . . . . . . . . . . . . . 50 + Authors' Addresses . . . . . . . . . . . . . . . . . . . . . . . 51 1. Introduction @@ -109,9 +109,9 @@ Table of Contents -Belotti, et al. Expires 13 September 2023 [Page 2] +Belotti, et al. Expires 8 January 2024 [Page 2] -Internet-Draft Yang for Layer 0 Types March 2023 +Internet-Draft Yang for Layer 0 Types July 2023 This document introduces a collection of common data types derived @@ -165,9 +165,9 @@ Internet-Draft Yang for Layer 0 Types March 2023 -Belotti, et al. Expires 13 September 2023 [Page 3] +Belotti, et al. Expires 8 January 2024 [Page 3] -Internet-Draft Yang for Layer 0 Types March 2023 +Internet-Draft Yang for Layer 0 Types July 2023 The YANG module "ietf-layer0-types" (defined in Section 3) references @@ -221,20 +221,26 @@ Internet-Draft Yang for Layer 0 Types March 2023 -Belotti, et al. Expires 13 September 2023 [Page 4] +Belotti, et al. Expires 8 January 2024 [Page 4] -Internet-Draft Yang for Layer 0 Types March 2023 +Internet-Draft Yang for Layer 0 Types July 2023 A YANG grouping that defines label steps for WSON as defined in - [RFC8776]. + [I-D.ietf-teas-rfc8776-update]. flexi-grid-label-start-end: The flexi-grid label range was defined in [RFC7698], and the generic topology model defines the label-start/label-end in [RFC8795]. This grouping shows the flexi-grid-specific label- - start and label-end information. + start and label-end information which is used to describe the + range of available nominal central frequencies. + + As described in section 3.1 of [RFC8363], the range of available + nominal central frequencies are advertised for m=1, which means + that for an available central frequency n, the frequency slot from + central frequency n-1 to central frequency n+1 is available. flexi-grid-label-hop: @@ -250,7 +256,7 @@ Internet-Draft Yang for Layer 0 Types March 2023 flexi-grid-label-step: A YANG grouping that defines flexi-grid label steps as defined in - [RFC8776]. + [I-D.ietf-teas-rfc8776-update]. transceiver-capabilities: @@ -269,19 +275,18 @@ Internet-Draft Yang for Layer 0 Types March 2023 common-explicit-mode: - a YANG grouping to define the list of attributes related to - optical impairments limits in case of transceiver explicit mode. - This grouping should be the same used in - [I-D.ietf-ccamp-dwdm-if-param-yang]. - - -Belotti, et al. Expires 13 September 2023 [Page 5] +Belotti, et al. Expires 8 January 2024 [Page 5] -Internet-Draft Yang for Layer 0 Types March 2023 +Internet-Draft Yang for Layer 0 Types July 2023 + a YANG grouping to define the list of attributes related to + optical impairments limits in case of transceiver explicit mode. + This grouping should be the same used in + [I-D.ietf-ccamp-dwdm-if-param-yang]. + common-organizational-explicit-mode: a YANG grouping to define the common capabilities attributes limit @@ -297,7 +302,7 @@ Internet-Draft Yang for Layer 0 Types March 2023 3. YANG Module for Layer 0 Types - file "ietf-layer0-types@2023-03-07.yang" + file "ietf-layer0-types@2023-07-07.yang" module ietf-layer0-types { yang-version 1.1; namespace "urn:ietf:params:xml:ns:yang:ietf-layer0-types"; @@ -325,18 +330,18 @@ Internet-Draft Yang for Layer 0 Types March 2023 provides groupings that can be applicable to Layer 0 Fixed Optical Networks (e.g., CWDM (Coarse Wavelength Division Multiplexing) and DWDM (Dense Wavelength Division - Multiplexing)) and flexi-grid optical networks. - Copyright (c) 2023 IETF Trust and the persons identified - as authors of the code. All rights reserved. +Belotti, et al. Expires 8 January 2024 [Page 6] + +Internet-Draft Yang for Layer 0 Types July 2023 -Belotti, et al. Expires 13 September 2023 [Page 6] - -Internet-Draft Yang for Layer 0 Types March 2023 + Multiplexing)) and flexi-grid optical networks. + Copyright (c) 2023 IETF Trust and the persons identified + as authors of the code. All rights reserved. Redistribution and use in source and binary forms, with or without modification, is permitted pursuant to, and @@ -359,7 +364,7 @@ Internet-Draft Yang for Layer 0 Types March 2023 // replace the revision date with the module publication date // the format is (year-month-day) - revision 2023-03-07 { + revision 2023-07-07 { description "To be updated"; reference @@ -381,19 +386,19 @@ Internet-Draft Yang for Layer 0 Types March 2023 "Layer 0 grid type"; reference "RFC 6163: Framework for GMPLS and Path Computation Element - (PCE) Control of Wavelength Switched Optical Networks (WSONs), - ITU-T G.694.1 (10/2020): Spectral grids for WDM applications: - DWDM frequency grid, - ITU-T G.694.2 (12/2003): Spectral grids for WDM applications: - CWDM wavelength grid"; -Belotti, et al. Expires 13 September 2023 [Page 7] +Belotti, et al. Expires 8 January 2024 [Page 7] -Internet-Draft Yang for Layer 0 Types March 2023 +Internet-Draft Yang for Layer 0 Types July 2023 + (PCE) Control of Wavelength Switched Optical Networks (WSONs), + ITU-T G.694.1 (10/2020): Spectral grids for WDM applications: + DWDM frequency grid, + ITU-T G.694.2 (12/2003): Spectral grids for WDM applications: + CWDM wavelength grid"; } identity flexi-grid-dwdm { @@ -437,19 +442,19 @@ Internet-Draft Yang for Layer 0 Types March 2023 "RFC 6205: Generalized Labels for Lambda-Switch-Capable (LSC) Label Switching Routers, ITU-T G.694.1 (10/2020): Spectral grids for WDM applications: - DWDM frequency grid"; - } - - identity dwdm-100ghz { - base dwdm-ch-spc-type; -Belotti, et al. Expires 13 September 2023 [Page 8] +Belotti, et al. Expires 8 January 2024 [Page 8] -Internet-Draft Yang for Layer 0 Types March 2023 +Internet-Draft Yang for Layer 0 Types July 2023 + DWDM frequency grid"; + } + + identity dwdm-100ghz { + base dwdm-ch-spc-type; description "100 GHz channel spacing"; } @@ -494,18 +499,17 @@ Internet-Draft Yang for Layer 0 Types March 2023 "Flexi-grid slot width granularity"; } - identity flexi-swg-12p5ghz { - base flexi-slot-width-granularity; - description - "12.5 GHz slot width granularity"; - -Belotti, et al. Expires 13 September 2023 [Page 9] +Belotti, et al. Expires 8 January 2024 [Page 9] -Internet-Draft Yang for Layer 0 Types March 2023 +Internet-Draft Yang for Layer 0 Types July 2023 + identity flexi-swg-12p5ghz { + base flexi-slot-width-granularity; + description + "12.5 GHz slot width granularity"; } identity cwdm-ch-spc-type { @@ -550,29 +554,22 @@ Internet-Draft Yang for Layer 0 Types March 2023 identity QAM8 { base modulation; description - "8QAM (8 symbols Quadrature Amplitude Modulation)"; - } - - identity DP-QAM8 { -Belotti, et al. Expires 13 September 2023 [Page 10] +Belotti, et al. Expires 8 January 2024 [Page 10] -Internet-Draft Yang for Layer 0 Types March 2023 +Internet-Draft Yang for Layer 0 Types July 2023 - base modulation; - description - "DP-QAM8 (8 symbols Dual Polarization Quadrature Amplitude - Modulation)"; + "8QAM (8 symbols Quadrature Amplitude Modulation)"; } - identity DC-DP-QAM8 { + identity DP-QAM8 { base modulation; description - "DC DP-QAM8 (8 symbols Dual Carrier Dual Polarization - Quadrature Amplitude Modulation)"; + "DP-QAM8 (8 symbols Dual Polarization Quadrature Amplitude + Modulation)"; } identity QAM16 { @@ -588,13 +585,6 @@ Internet-Draft Yang for Layer 0 Types March 2023 Modulation)"; } - identity DC-DP-QAM16 { - base modulation; - description - "DC DP-QAM16 (16 symbols Dual Carrier Dual Polarization - Quadrature Amplitude Modulation)"; - } - identity QAM32 { base modulation; description @@ -610,14 +600,6 @@ Internet-Draft Yang for Layer 0 Types March 2023 identity QAM64 { base modulation; - - - -Belotti, et al. Expires 13 September 2023 [Page 11] - -Internet-Draft Yang for Layer 0 Types March 2023 - - description "QAM64 (64 symbols Quadrature Amplitude Modulation)"; } @@ -629,6 +611,13 @@ Internet-Draft Yang for Layer 0 Types March 2023 Modulation)"; } + + +Belotti, et al. Expires 8 January 2024 [Page 11] + +Internet-Draft Yang for Layer 0 Types July 2023 + + identity fec-type { description "Base identity from which specific FEC @@ -638,13 +627,21 @@ Internet-Draft Yang for Layer 0 Types March 2023 identity g-fec { base fec-type; description - "G-FEC (Generic-FEC)"; + "Generic Forward Error Correction (G-FEC)."; + reference + "ITU-T G.975 v2.0 (10/2000): Forward error correction for + submarine systems."; } - identity e-fec { + + identity super-fec { base fec-type; description - "E-FEC (Enhanced-FEC)"; + "Super Forward Error Correction (S-FEC)."; + reference + "ITU-T G.975.1 v1.2 (07/2013): Forward error correction for + high bit-rate DWDM submarine systems."; } + identity no-fec { base fec-type; description @@ -665,48 +662,141 @@ Internet-Draft Yang for Layer 0 Types March 2023 identity golay { base fec-type; - description "Golay error correction"; + description "Golay error correction"; + } + + identity sc-fec { -Belotti, et al. Expires 13 September 2023 [Page 12] +Belotti, et al. Expires 8 January 2024 [Page 12] -Internet-Draft Yang for Layer 0 Types March 2023 +Internet-Draft Yang for Layer 0 Types July 2023 - } - - identity line-coding { + base fec-type; description - "base line-coding class"; + "Staircase Forward Error Correction (SC-FEC)."; reference - "ITU-T G.698.2-201811 section 7"; + "Annex A of ITU-T G.709.2 v1.1 (09/2020):OTU4 long-reach + interface."; } - identity line-coding-NRZ-2p5G { - base line-coding; + identity o-fec { + base fec-type; description - "ITU-T G.698.2-201811 section 7 table 8-1"; - } + "Open Forward Error Correction (O-FEC) which reuses the Bose, + Chaudhuri and Hocquenghem (BCH) FEC."; + reference + "Clause 16.4.4 of ITU-T G.709.3 v2.1 (11/2022): Flexible OTN + long-reach interfaces; - identity line-coding-NRZ-OTU1 { - base line-coding; - description - "ITU-T G.698.2-201811 section 7 table 8-2"; + Annex E of ITU-T G.709.3 v2.1 (11/2022): Flexible OTN + long-reach interfaces."; } - identity line-coding-NRZ-10G { - base line-coding; + identity c-fec { + base fec-type; description - "ITU-T G.698.2-201811 section 7 table 8-3/8-5"; + "Concatenated FEC (C-FEC) that combines an outer Staircase + Forward Error Correction (SC-FEC) code and an inner + double-extended SD-FEC (128,119) Hamming code. + + More details are provided in clause 15/G.709.3 where it is + called DSH instead of concatenated FEC."; + reference + "Annex A of ITU-T G.709.2 v1.1 (09/2020):OTU4 long-reach + interface; + + Annex D of ITU-T G.709.3 v2.1 (11/2022): Flexible OTN + long-reach interfaces; + + Clause 15 of ITU-T G.709.3 v2.1 (11/2022): Flexible OTN + long-reach interfaces."; } - identity line-coding-NRZ-OTU2 { - base line-coding; + identity line-coding { description - "ITU-T G.698.2-201811 section 7 table 8-4/8-6"; + "Base identity to defined the bit rate/line coding of optical + tributary signals."; + reference + "Section 7.1.2 of ITU-T G.698.2 v3.0 (11/2018)."; } + + +Belotti, et al. Expires 8 January 2024 [Page 13] + +Internet-Draft Yang for Layer 0 Types July 2023 + + + identity line-coding-NRZ-2p5G { + base line-coding; + description + "The non return to zero (NRZ) bit rate/line coding used by + the optical tributary signal class NRZ 2.5G"; + reference + "Section 3.2.6 of ITU-T G.959.1 v8.0 (07/2018)."; + } + + identity line-coding-NRZ-OTU1 { + base line-coding; + description + "The non return to zero (NRZ) bit rate/line coding used by + the Optical channel Transport Unit order 1 (OTU1) optical + tributary signals"; + reference + "Section 7.2.1.2 of ITU-T G.959.1 v8.0 (07/2018)."; + } + + identity line-coding-NRZ-10G { + description + "The non return to zero (NRZ) bit rate/line coding used by + the optical tributary signal class NRZ 10G"; + reference + "Section 3.2.7 of ITU-T G.959.1 v8.0 (07/2018)."; + } + + identity line-coding-NRZ-OTU2 { + base line-coding; + description + "The non return to zero (NRZ) bit rate/line coding used by + the Optical channel Transport Unit order 2 (OTU2) optical + tributary signals"; + reference + "Section 7.2.1.2 of ITU-T G.959.1 v8.0 (07/2018)."; + } + + identity line-coding-OTL4.4-SC { + base line-coding; + description + "The bit rate/line coding used by optical tributary + signals carrying a 100G Optical Transport Unit order 4 + (OTU4) with Staircase Forward Error Correction (SC FEC) + from a group of four Optical Transport Lanes (OTL)."; + reference + "Section 3.2.1 of ITU-T G.698.2 v3.0 (11/2018)."; + } + + + + +Belotti, et al. Expires 8 January 2024 [Page 14] + +Internet-Draft Yang for Layer 0 Types July 2023 + + + identity line-coding-FOIC1.4-SC { + base line-coding; + description + "The bit rate/line coding used by optical tributary signals + carrying a FlexO Interface of order C1 with 4 lanes + (FOIC1.1) with Staircase Forward Error Correction + (SC FEC)."; + reference + "Section 3.2.1 of ITU-T G.698.2 v3.0 (11/2018)."; + } + identity wavelength-assignment { description "Wavelength selection base"; @@ -723,13 +813,6 @@ Internet-Draft Yang for Layer 0 Types March 2023 the available wavelength with the lowest index"; } - - -Belotti, et al. Expires 13 September 2023 [Page 13] - -Internet-Draft Yang for Layer 0 Types March 2023 - - identity random-wavelength-assignment { base wavelength-assignment; description @@ -752,6 +835,13 @@ Internet-Draft Yang for Layer 0 Types March 2023 "ITU-T G.709: Interfaces for the Optical Transport Network"; } + + +Belotti, et al. Expires 8 January 2024 [Page 15] + +Internet-Draft Yang for Layer 0 Types July 2023 + + identity term-phys { base term-type; description @@ -778,14 +868,6 @@ Internet-Draft Yang for Layer 0 Types March 2023 identity otu-type { description - - - -Belotti, et al. Expires 13 September 2023 [Page 14] - -Internet-Draft Yang for Layer 0 Types March 2023 - - "Base identity from which specific OTU identities are derived"; reference "ITU-T G.709: Interfaces for the Optical Transport Network"; @@ -809,6 +891,13 @@ Internet-Draft Yang for Layer 0 Types March 2023 "OTU1f (11.27 Gb/s)"; } + + +Belotti, et al. Expires 8 January 2024 [Page 16] + +Internet-Draft Yang for Layer 0 Types July 2023 + + identity OTU2 { base otu-type; description @@ -834,14 +923,6 @@ Internet-Draft Yang for Layer 0 Types March 2023 } identity OTU3e1 { - - - -Belotti, et al. Expires 13 September 2023 [Page 15] - -Internet-Draft Yang for Layer 0 Types March 2023 - - base otu-type; description "OTU3e1 (44.57 Gb/s)"; @@ -865,6 +946,14 @@ Internet-Draft Yang for Layer 0 Types March 2023 "OTUCn (n x 105.25 Gb/s)"; } + + + +Belotti, et al. Expires 8 January 2024 [Page 17] + +Internet-Draft Yang for Layer 0 Types July 2023 + + identity type-power-mode { description "power equalization mode used within the @@ -883,6 +972,18 @@ Internet-Draft Yang for Layer 0 Types March 2023 "all elements must use power (dBm)"; } + identity operational-mode { + description + "Base identity to be used when defining organization/vendor + specific modes"; + reference + "Section 2.5.2 of RFC YYYY: A YANG Data Model for Optical + Impairment-aware Topology."; + } + // RFC Ed.: replace YYYY with actual RFC number and remove + // this note after draft-ietf-ccamp-optical-impairment-topology-yang + // is published as an RFC + /* * Typedefs */ @@ -890,14 +991,6 @@ Internet-Draft Yang for Layer 0 Types March 2023 typedef dwdm-n { type int16; description - - - -Belotti, et al. Expires 13 September 2023 [Page 16] - -Internet-Draft Yang for Layer 0 Types March 2023 - - "The given value 'N' is used to determine the nominal central frequency. @@ -909,6 +1002,14 @@ Internet-Draft Yang for Layer 0 Types March 2023 'channel spacing' is defined by the dwdm-ch-spc-type."; reference "RFC6205: Generalized Labels for Lambda-Switch-Capable (LSC) + + + +Belotti, et al. Expires 8 January 2024 [Page 18] + +Internet-Draft Yang for Layer 0 Types July 2023 + + Label Switching Routers, ITU-T G.694.1 (10/2020): Spectral grids for WDM applications: DWDM frequency grid"; @@ -946,14 +1047,6 @@ Internet-Draft Yang for Layer 0 Types March 2023 frequency' for transmission over the DWDM grid, and where 'channel spacing' is defined by the flexi-ch-spc-type. - - - -Belotti, et al. Expires 13 September 2023 [Page 17] - -Internet-Draft Yang for Layer 0 Types March 2023 - - Note that the term 'channel spacing' can be substituted by the term 'nominal central frequency granularity' defined in clause 8 of ITU-T G.694.1."; @@ -965,6 +1058,14 @@ Internet-Draft Yang for Layer 0 Types March 2023 DWDM frequency grid"; } + + + +Belotti, et al. Expires 8 January 2024 [Page 19] + +Internet-Draft Yang for Layer 0 Types July 2023 + + typedef flexi-m { type uint16; description @@ -982,19 +1083,6 @@ Internet-Draft Yang for Layer 0 Types March 2023 DWDM frequency grid"; } - typedef operational-mode { - type string; - description - "Organization/vendor specific mode that guarantees - interoperability."; - // RFC Ed.: replace YYYY with actual RFC number and remove - // this note after draft-ietf-ccamp-optical-impairment-topology-yang - // is published as an RFC - reference - "Section 2.5.2 of RFC YYYY: A YANG Data Model for Optical - Impairment-aware Topology."; - } - typedef standard-mode { type string; description @@ -1002,14 +1090,6 @@ Internet-Draft Yang for Layer 0 Types March 2023 interoperability. It must be an string with the following format: B-DScW-ytz(v) where all these attributes - - - -Belotti, et al. Expires 13 September 2023 [Page 18] - -Internet-Draft Yang for Layer 0 Types March 2023 - - are conformant to the ITU-T recomendation"; reference "ITU-T G.698.2 (11/2018)"; @@ -1021,15 +1101,41 @@ Internet-Draft Yang for Layer 0 Types March 2023 "vendor/organization identifier that uses a private mode out of already defined in G.698.2 ITU-T application-code"; reference - "RFC7581: Routing and Wavelength Assignment Information - Encoding for Wavelength Switched Optical Networks"; + "Section 2.5.2 of RFC YYYY: A YANG Data Model for Optical + Impairment-aware Topology."; } + // RFC Ed.: replace YYYY with actual RFC number and remove + // this note after draft-ietf-ccamp-optical-impairment-topology-yang + // is published as an RFC + + typedef operational-mode { + type identityref { + base operational-mode; + } + description + "Organization/vendor specific mode that guarantees + + + +Belotti, et al. Expires 8 January 2024 [Page 20] + +Internet-Draft Yang for Layer 0 Types July 2023 + + + interoperability."; + reference + "Section 2.5.2 of RFC YYYY: A YANG Data Model for Optical + Impairment-aware Topology."; + } + // RFC Ed.: replace YYYY with actual RFC number and remove + // this note after draft-ietf-ccamp-optical-impairment-topology-yang + // is published as an RFC typedef frequency-thz { type decimal64 { fraction-digits 9; } - units THz; + units "THz"; description "The DWDM frequency in THz, e.g., 193.112500000"; } @@ -1037,7 +1143,7 @@ Internet-Draft Yang for Layer 0 Types March 2023 type decimal64 { fraction-digits 6; } - units GHz; + units "GHz"; description "The DWDM frequency in GHz, e.g., 193112.500000"; } @@ -1059,18 +1165,19 @@ Internet-Draft Yang for Layer 0 Types March 2023 resolution bandwidth"; } - - -Belotti, et al. Expires 13 September 2023 [Page 19] - -Internet-Draft Yang for Layer 0 Types March 2023 - - typedef snr-or-null { type union { type snr; type empty; } + + + +Belotti, et al. Expires 8 January 2024 [Page 21] + +Internet-Draft Yang for Layer 0 Types July 2023 + + description "(Optical) Signal to Noise Ratio measured over 0.1 nm resolution bandwidth, when known, or an empty value when @@ -1114,46 +1221,75 @@ Internet-Draft Yang for Layer 0 Types March 2023 typedef decimal-2-digits-or-null { type union { type decimal-2-digits; + type empty; + } + description + "A decimal64 value with two digits, when the value is known or + an empty value when the value is not known."; -Belotti, et al. Expires 13 September 2023 [Page 20] +Belotti, et al. Expires 8 January 2024 [Page 22] -Internet-Draft Yang for Layer 0 Types March 2023 +Internet-Draft Yang for Layer 0 Types July 2023 + } + + typedef gain-in-db { + type decimal-2-digits { + range "0..max"; + } + units "dB"; + description + "The gain in dB."; + } + + typedef gain-in-db-or-null { + type union { + type gain-in-db; type empty; } description - "A decimal64 value with two digits, when the value is know or - an empty value when the value is not known."; + "The gain in dB, when it is known or an empty + value when the power gain/loss is not known."; } - typedef power-in-db { - type decimal-2-digits; - units dB; + typedef loss-in-db { + type decimal-2-digits { + range "0..max"; + } + units "dB"; description - "The power in dB."; + "The power attenuation in dB."; } - typedef power-in-db-or-null { + typedef loss-in-db-or-null { type union { - type power-in-db; + type loss-in-db; type empty; } description - "The power in dB, when it is known or an empty value when the - power is not known."; + "The power attenuation in dB, when it is known or an empty + value when the loss is not known."; } typedef power-in-dbm { type decimal-2-digits; - units dBm; + units "dBm"; description "The power in dBm."; } typedef power-in-dbm-or-null { + + + +Belotti, et al. Expires 8 January 2024 [Page 23] + +Internet-Draft Yang for Layer 0 Types July 2023 + + type union { type power-in-dbm; type empty; @@ -1163,21 +1299,56 @@ Internet-Draft Yang for Layer 0 Types March 2023 power is not known."; } + typedef decimal-5-digits { + type decimal64 { + fraction-digits 5; + } + description + "A decimal64 value with five digits."; + } + + typedef decimal-5-digits-or-null { + type union { + type decimal-5-digits; + type empty; + } + description + "A decimal64 value with five digits, when the value is known + or an empty value when the value is not known."; + } + + typedef decimal-16-digits { + type decimal64 { + fraction-digits 16; + } + description + "A decimal64 value with sixteen digits."; + } + + typedef decimal-16-digits-or-null { + type union { + type decimal-5-digits; + type empty; + } + description + "A decimal64 value with sixteen digits, when the value is + known or an empty value when the value is not known."; + } + /* * Groupings */ - grouping wson-label-start-end { - description - "The WSON label-start or label-end used to specify WSON label - -Belotti, et al. Expires 13 September 2023 [Page 21] +Belotti, et al. Expires 8 January 2024 [Page 24] -Internet-Draft Yang for Layer 0 Types March 2023 +Internet-Draft Yang for Layer 0 Types July 2023 + grouping wson-label-start-end { + description + "The WSON label-start or label-end used to specify WSON label range."; choice grid-type { description @@ -1223,17 +1394,17 @@ Internet-Draft Yang for Layer 0 Types March 2023 "Generic label-hop information for WSON"; choice grid-type { description - "Label for DWDM or CWDM grid"; - case dwdm { - choice single-or-super-channel { -Belotti, et al. Expires 13 September 2023 [Page 22] +Belotti, et al. Expires 8 January 2024 [Page 25] -Internet-Draft Yang for Layer 0 Types March 2023 +Internet-Draft Yang for Layer 0 Types July 2023 + "Label for DWDM or CWDM grid"; + case dwdm { + choice single-or-super-channel { description "single or super channel"; case single { @@ -1279,17 +1450,17 @@ Internet-Draft Yang for Layer 0 Types March 2023 description "Information about Layer 0 label range."; leaf grid-type { - type identityref { - base l0-grid-type; - } -Belotti, et al. Expires 13 September 2023 [Page 23] +Belotti, et al. Expires 8 January 2024 [Page 26] -Internet-Draft Yang for Layer 0 Types March 2023 +Internet-Draft Yang for Layer 0 Types July 2023 + type identityref { + base l0-grid-type; + } description "Grid type"; } @@ -1335,17 +1506,17 @@ Internet-Draft Yang for Layer 0 Types March 2023 leaf wson-cwdm-channel-spacing { when "derived-from-or-self(../../grid-type, \"wson-grid-cwdm\")" { - description - "Valid only when grid type is CWDM."; - } -Belotti, et al. Expires 13 September 2023 [Page 24] +Belotti, et al. Expires 8 January 2024 [Page 27] -Internet-Draft Yang for Layer 0 Types March 2023 +Internet-Draft Yang for Layer 0 Types July 2023 + description + "Valid only when grid type is CWDM."; + } type identityref { base cwdm-ch-spc-type; } @@ -1373,15 +1544,32 @@ Internet-Draft Yang for Layer 0 Types March 2023 type l0-types:flexi-n; description "The given value 'N' is used to determine the nominal - central frequency."; + central frequency. + + As described in section 3.1 of RFC 8363, the range of + available nominal central frequencies are advertised for + m=1, which means that for an available central frequency n, + the frequency slot from central frequency n-1 to central + frequency n+1 is available."; } reference "RFC 7698: Framework and Requirements for GMPLS-Based Control - of Flexi-Grid Dense Wavelength Division Multiplexing (DWDM) - Networks"; + of Flexi-Grid Dense Wavelength Division Multiplexing (DWDM) + Networks; + + RFC 8363: GMPLS OSPF-TE Extensions in Support of Flexi-Grid + Dense Wavelength Division Multiplexing (DWDM) Networks"; } grouping flexi-grid-frequency-slot { + + + +Belotti, et al. Expires 8 January 2024 [Page 28] + +Internet-Draft Yang for Layer 0 Types July 2023 + + description "Flexi-grid frequency slot grouping."; uses flexi-grid-label-start-end; @@ -1394,14 +1582,6 @@ Internet-Draft Yang for Layer 0 Types March 2023 "RFC 7698: Framework and Requirements for GMPLS-Based Control of Flexi-Grid Dense Wavelength Division Multiplexing (DWDM) Networks"; - - - -Belotti, et al. Expires 13 September 2023 [Page 25] - -Internet-Draft Yang for Layer 0 Types March 2023 - - } grouping flexi-grid-label-hop { @@ -1438,6 +1618,14 @@ Internet-Draft Yang for Layer 0 Types March 2023 "flexi-grid definition"; leaf slot-width-granularity { type identityref { + + + +Belotti, et al. Expires 8 January 2024 [Page 29] + +Internet-Draft Yang for Layer 0 Types July 2023 + + base flexi-slot-width-granularity; } default "flexi-swg-12p5ghz"; @@ -1450,14 +1638,6 @@ Internet-Draft Yang for Layer 0 Types March 2023 Multiplexing (DWDM) Networks"; } leaf min-slot-width-factor { - - - -Belotti, et al. Expires 13 September 2023 [Page 26] - -Internet-Draft Yang for Layer 0 Types March 2023 - - type uint16 { range "1..max"; } @@ -1494,6 +1674,14 @@ Internet-Draft Yang for Layer 0 Types March 2023 If specified, maximum slot width must be greater than or equal to minimum slot width. If not specified, maximum + + + +Belotti, et al. Expires 8 January 2024 [Page 30] + +Internet-Draft Yang for Layer 0 Types July 2023 + + slot width is equal to minimum slot width."; reference "RFC 8363: GMPLS OSPF-TE Extensions in Support of Flexi- @@ -1506,14 +1694,6 @@ Internet-Draft Yang for Layer 0 Types March 2023 grouping flexi-grid-label-step { description "Label step information for flexi-grid"; - - - -Belotti, et al. Expires 13 September 2023 [Page 27] - -Internet-Draft Yang for Layer 0 Types March 2023 - - leaf flexi-grid-channel-spacing { type identityref { base flexi-ch-spc-type; @@ -1551,6 +1731,13 @@ Internet-Draft Yang for Layer 0 Types March 2023 It is a transponder attribute not transceiver */ + + +Belotti, et al. Expires 8 January 2024 [Page 31] + +Internet-Draft Yang for Layer 0 Types July 2023 + + /* leaf multiplexing-cap { type uint32; config false; @@ -1562,15 +1749,11 @@ Internet-Draft Yang for Layer 0 Types March 2023 grouping transceiver-mode { description "This grouping is intended to be used for reporting the + information of a transceiver's mode. - - -Belotti, et al. Expires 13 September 2023 [Page 28] - -Internet-Draft Yang for Layer 0 Types March 2023 - - - information of a transceiver's mode."; + The compatible-modes container shall be augmented with the + proper leafrefs when used: see for example the + transceiver-capabilities grouping below."; choice mode { mandatory true; description @@ -1578,69 +1761,42 @@ Internet-Draft Yang for Layer 0 Types March 2023 mode, an organizational mode or an explicit mode."; case G.698.2 { uses standard-mode; + uses common-standard-organizational-mode; } case organizational-mode { container organizational-mode { description "The set of attributes for an organizational mode"; uses organizational-mode; + uses common-standard-organizational-mode; uses common-organizational-explicit-mode; } // container organizational-mode } case explicit-mode { container explicit-mode { - description - "The set of attributes for an explicit mode"; - container supported-modes { + description + "The set of attributes for an explicit mode"; + uses common-explicit-mode; + uses common-organizational-explicit-mode; + container compatible-modes { description "Container for all the standard and organizational modes supported by the transceiver's explicit mode."; - leaf-list supported-application-codes { - type leafref { - path "../../../mode-id"; - } - must "../../../../" - + "supported-mode[mode-id=current()]/" - + "standard-mode" { - description - "The pointer is only for application codes - supported by transceiver."; - } - description - "List of pointers to the application codes - supported by the transceiver's explicit mode."; - } - leaf-list supported-organizational-modes { - type leafref { - path "../../../mode-id"; - } - must "../../../../" - + "supported-mode[mode-id=current()]/" - + "organizational-mode" { + } // container compatible-modes + } // container explicit-mode + } // end of case explicit-mode -Belotti, et al. Expires 13 September 2023 [Page 29] +Belotti, et al. Expires 8 January 2024 [Page 32] -Internet-Draft Yang for Layer 0 Types March 2023 +Internet-Draft Yang for Layer 0 Types July 2023 - description - "The pointer is only for organizational modes - supported by transceiver."; - } - description - "List of pointers to the organizational modes - supported by the transceiver's explicit mode."; - } - } // container supported-modes - uses common-explicit-mode; - uses common-organizational-explicit-mode; - } // container explicit-mode - } // end of case explicit-mode } // end of choice } + grouping transceiver-capabilities { description "This grouping is intended to be used for reporting the @@ -1662,9 +1818,54 @@ Internet-Draft Yang for Layer 0 Types March 2023 type string { length "1..255"; } - description "ID for the supported transceiver's mode."; + description "ID for the supported transceiver's mode."; + } + uses transceiver-mode { + augment "mode/explicit-mode/explicit-mode/" + + "compatible-modes" { + description + "Augments the compatible modes with the proper + leafrefs."; + leaf-list supported-application-codes { + type leafref { + path "../../../mode-id"; + } + must "../../../../" + + "supported-mode[mode-id=current()]/" + + "standard-mode" { + description + "The pointer is only for application codes + supported by transceiver."; + } + description + "List of pointers to the application codes + supported by the transceiver's explicit mode."; + } + leaf-list supported-organizational-modes { + + + +Belotti, et al. Expires 8 January 2024 [Page 33] + +Internet-Draft Yang for Layer 0 Types July 2023 + + + type leafref { + path "../../../mode-id"; + } + must "../../../../" + + "supported-mode[mode-id=current()]/" + + "organizational-mode" { + description + "The pointer is only for organizational modes + supported by transceiver."; + } + description + "List of pointers to the organizational modes + supported by the transceiver's explicit mode."; + } + } } - uses transceiver-mode; } // list supported-modes } // container supported-modes } // grouping transceiver-capabilities @@ -1674,14 +1875,6 @@ Internet-Draft Yang for Layer 0 Types March 2023 "ITU-T G.698.2 standard mode that guarantees interoperability. It must be an string with the following format: B-DScW-ytz(v) where all these attributes are conformant - - - -Belotti, et al. Expires 13 September 2023 [Page 30] - -Internet-Draft Yang for Layer 0 Types March 2023 - - to the ITU-T recomendation"; leaf standard-mode { @@ -1705,10 +1898,18 @@ Internet-Draft Yang for Layer 0 Types March 2023 application identifiers (AI) supported by the transponder"; } leaf organization-identifier { + + + +Belotti, et al. Expires 8 January 2024 [Page 34] + +Internet-Draft Yang for Layer 0 Types July 2023 + + type organization-identifier; config false; description - "organization identifier that uses organizational + "organization identifier that uses organizational mode"; } } @@ -1730,16 +1931,9 @@ Internet-Draft Yang for Layer 0 Types March 2023 config false; mandatory true; description - - - -Belotti, et al. Expires 13 September 2023 [Page 31] - -Internet-Draft Yang for Layer 0 Types March 2023 - - - "OSNR penalty associated with the related optical - impairment at the receiver."; + "The OSNR penalty associated with the related optical + impairment at the receiver, when the value is known or an + empty value when the value is not known."; } } @@ -1760,6 +1954,14 @@ Internet-Draft Yang for Layer 0 Types March 2023 } config false; description + + + +Belotti, et al. Expires 8 January 2024 [Page 35] + +Internet-Draft Yang for Layer 0 Types July 2023 + + "Bit rate/line coding of the optical tributary signal."; reference "ITU-T G.698.2 section 7.1.2"; @@ -1772,44 +1974,34 @@ Internet-Draft Yang for Layer 0 Types March 2023 "The gross bitrate (e.g., 100, 200) of the optical tributary signal."; } - leaf max-polarization-mode-dispersion { - type decimal64 { - fraction-digits 2; - range "0..max"; - } + leaf max-diff-group-delay { + type uint32; units "ps"; config false; description - "Maximum acceptable accumulated polarization mode - dispersion on the receiver"; + "Maximum Differential group delay of this mode for this + lane"; } leaf max-chromatic-dispersion { type decimal64 { fraction-digits 2; - - - -Belotti, et al. Expires 13 September 2023 [Page 32] - -Internet-Draft Yang for Layer 0 Types March 2023 - - range "0..max"; } units "ps/nm"; config false; description - "Maximum acceptable accumulated chromatic dispersion - on the receiver"; + "Maximum acceptable accumulated chromatic dispersion (CD) + on the receiver"; } - list chromatic-dispersion-penalty { + list cd-penalty { config false; description "Optional penalty associated with a given accumulated - chromatic dispersion (CD) value. - This list of pair cd and penalty can be used to - sample the function penalty = f(CD)."; - leaf chromatic-dispersion { + chromatic dispersion (CD) value. + + This list of pair cd and penalty values can be used to + sample the function penalty = f(CD)."; + leaf cd-value { type union { type decimal64 { fraction-digits 2; @@ -1818,20 +2010,42 @@ Internet-Draft Yang for Layer 0 Types March 2023 type empty; } units "ps/nm"; + + + +Belotti, et al. Expires 8 January 2024 [Page 36] + +Internet-Draft Yang for Layer 0 Types July 2023 + + config false; mandatory true; - description "Chromatic dispersion"; + description + "The Chromatic Dispersion (CD), when the value is known + or an empty value when the value is not known."; } uses penalty-value; } - list polarization-dispersion-penalty { + leaf max-polarization-mode-dispersion { + type decimal64 { + fraction-digits 2; + range "0..max"; + } + units "ps"; + config false; + description + "Maximum acceptable accumulated polarization mode + dispersion (PMD) on the receiver"; + } + list pmd-penalty { config false; description "Optional penalty associated with a given accumulated - polarization mode dispersion(PMD) value. - This list of pair pmd and penalty can be used to - sample the function penalty = f(PMD)."; - leaf polarization-mode-dispersion { + polarization mode dispersion (PMD) value. + + This list of pair pmd and penalty can be used to + sample the function penalty = f(PMD)."; + leaf pmd-value { type union { type decimal64 { fraction-digits 2; @@ -1842,34 +2056,38 @@ Internet-Draft Yang for Layer 0 Types March 2023 units "ps"; config false; mandatory true; + description + "The Polarization Mode Dispersion (PMD), when the value + is known or an empty value when the value is not known."; + } + uses penalty-value; + } + leaf max-polarization-dependant-loss { + type loss-in-db-or-null; + config false; + mandatory true; -Belotti, et al. Expires 13 September 2023 [Page 33] +Belotti, et al. Expires 8 January 2024 [Page 37] -Internet-Draft Yang for Layer 0 Types March 2023 +Internet-Draft Yang for Layer 0 Types July 2023 - description "Polarization mode dispersion"; - } - uses penalty-value; - } - leaf max-diff-group-delay { - type uint32; - units "ps"; - config false; - description "Maximum Differential group delay of this mode - for this lane"; + description + "Maximum acceptable accumulated accumulated polarization + dependent loss (PDL) on the receiver"; } - list max-pol-dependent-loss-penalty { + list pdl-penalty { config false; description - "Optional penalty associated with the maximum acceptable - accumulated polarization dependent loss. - This list of pair pdl and penalty can be used to - sample the function pdl = f(penalty)."; - leaf max-polarization-dependent-loss { - type power-in-db-or-null; + "Optional penalty associated with a given accumulated + polarization dependent loss (PDL) value. + + This list of pair pdl and penalty values can be used to + sample the function PDL = f(penalty)."; + leaf pdl-value { + type loss-in-db-or-null; config false; mandatory true; description @@ -1898,20 +2116,20 @@ Internet-Draft Yang for Layer 0 Types March 2023 level of bit-errors post-FEC needs to be expected"; } leaf rx-ref-channel-power { - - - -Belotti, et al. Expires 13 September 2023 [Page 34] - -Internet-Draft Yang for Layer 0 Types March 2023 - - type dbm-t; config false; description "The channel power used as reference for defining penalties and min-OSNR"; } + + + +Belotti, et al. Expires 8 January 2024 [Page 38] + +Internet-Draft Yang for Layer 0 Types July 2023 + + list rx-channel-power-penalty { config false; description @@ -1919,7 +2137,7 @@ Internet-Draft Yang for Layer 0 Types March 2023 lower than rx-ref-channel-power. This list of pair power and penalty can be used to sample the function penalty = f(rx-channel-power)."; - leaf rx-channel-power { + leaf rx-channel-power-value { type union { type dbm-t; type empty; @@ -1927,7 +2145,9 @@ Internet-Draft Yang for Layer 0 Types March 2023 units "dBm"; config false; mandatory true; - description "Received Power"; + description + "The Received Power, when the value is known or an empty + value when the value is not known."; } uses penalty-value; } @@ -1939,7 +2159,7 @@ Internet-Draft Yang for Layer 0 Types March 2023 } leaf available-baud-rate { type uint32; - units Bd; + units "Bd"; config false; description "Baud-rate the specific transceiver in @@ -1954,18 +2174,18 @@ Internet-Draft Yang for Layer 0 Types March 2023 per second in a digitally modulated signal or a line code"; } + leaf roll-off { + type decimal64 { + fraction-digits 4; + range "0..1"; -Belotti, et al. Expires 13 September 2023 [Page 35] +Belotti, et al. Expires 8 January 2024 [Page 39] -Internet-Draft Yang for Layer 0 Types March 2023 +Internet-Draft Yang for Layer 0 Types July 2023 - leaf roll-off { - type decimal64 { - fraction-digits 4; - range "0..1"; } config false; description @@ -2010,18 +2230,18 @@ Internet-Draft Yang for Layer 0 Types March 2023 fraction-digits 8; range "0..max"; } + config false; + description + "Threshold on the BER, for which FEC + is able to correct errors"; -Belotti, et al. Expires 13 September 2023 [Page 36] +Belotti, et al. Expires 8 January 2024 [Page 40] -Internet-Draft Yang for Layer 0 Types March 2023 +Internet-Draft Yang for Layer 0 Types July 2023 - config false; - description - "Threshold on the BER, for which FEC - is able to correct errors"; } leaf in-band-osnr { type snr; @@ -2054,7 +2274,8 @@ Internet-Draft Yang for Layer 0 Types March 2023 "OIF-400ZR-01.0: Implementation Agreement 400ZR"; } leaf tx-polarization-power-difference { - type power-in-db; + type decimal-2-digits; + units "dB"; config false; description "The transmitter polarization dependent power difference @@ -2066,17 +2287,17 @@ Internet-Draft Yang for Layer 0 Types March 2023 leaf polarization-skew { type decimal64 { fraction-digits 2; + } + units "ps"; + config false; -Belotti, et al. Expires 13 September 2023 [Page 37] +Belotti, et al. Expires 8 January 2024 [Page 41] -Internet-Draft Yang for Layer 0 Types March 2023 +Internet-Draft Yang for Layer 0 Types July 2023 - } - units "ps"; - config false; description "The X-Y skew, included as a fixed value in the receiver polarization mode dispersion (PMD) tolerance limits."; @@ -2085,6 +2306,27 @@ Internet-Draft Yang for Layer 0 Types March 2023 } } // grouping common-explicit-mode + grouping common-standard-organizational-mode { + description + "Common attributes used by standard and organizational + modes."; + + leaf-list line-coding-bitrate { + type identityref { + base line-coding; + } + config false; + description + "The list of the bit rate/line coding of the optical + tributary signal supported by the transceiver. + + Reporting this list is optional when the standard or + organization mode supports only one bit rate/line coding."; + reference + "ITU-T G.698.2 section 7.1.2"; + } + } // grouping common-standard-organizational-mode + grouping common-organizational-explicit-mode { description "Common capability attributes limit range in case of operational mode and explicit mode. @@ -2092,7 +2334,6 @@ Internet-Draft Yang for Layer 0 Types March 2023 case of application codes"; /* transmitter tuning range (f_tx-min, f_tx-max) */ - leaf min-central-frequency { type frequency-thz; config false; @@ -2105,6 +2346,14 @@ Internet-Draft Yang for Layer 0 Types March 2023 config false; description "This parameter indicates the maximum frequency for the + + + +Belotti, et al. Expires 8 January 2024 [Page 42] + +Internet-Draft Yang for Layer 0 Types July 2023 + + transmitter tuning range."; } @@ -2122,14 +2371,6 @@ Internet-Draft Yang for Layer 0 Types March 2023 type dbm-t; config false; description "The minimum output power of this interface"; - - - -Belotti, et al. Expires 13 September 2023 [Page 38] - -Internet-Draft Yang for Layer 0 Types March 2023 - - } leaf tx-channel-power-max { type dbm-t; @@ -2161,39 +2402,52 @@ Internet-Draft Yang for Layer 0 Types March 2023 /* This grouping represent the list of configured parameters */ /* values independent of operational mode */ + + + +Belotti, et al. Expires 8 January 2024 [Page 43] + +Internet-Draft Yang for Layer 0 Types July 2023 + + grouping common-transceiver-configured-param { description "Capability of an optical transceiver"; - leaf tx-channel-power { - type union { - type dbm-t; - type empty; - } - description "The current channel transmit power"; - } - leaf rx-channel-power { - type union { - type dbm-t; - type empty; + leaf line-coding-bitrate { + type identityref { + base line-coding; } config false; - description "The current channel received power "; - - - -Belotti, et al. Expires 13 September 2023 [Page 39] - -Internet-Draft Yang for Layer 0 Types March 2023 + description + "Bit rate/line coding of the optical tributary signal. + Reporting this attribute is optional when the configured + mode supports only one bit rate/line coding."; + reference + "ITU-T G.698.2 section 7.1.2"; + } + leaf tx-channel-power { + type power-in-dbm-or-null; + description + "The current channel transmit power, when the value is + known or an empty value when the value is not known. + The empty value MUST NOT be used when this attribute is + configured."; + } + leaf rx-channel-power { + type power-in-dbm-or-null; + config false; + description + "The current channel received power, when the value is + known or an empty value when the value is not known."; } leaf rx-total-power { - type union { - type dbm-t; - type empty; - } + type power-in-dbm-or-null; config false; - description "Current total received power"; + description + "The current total received power, when the value is known + or an empty value when the value is not known."; } } // grouping for configured attributes out of mode @@ -2204,6 +2458,14 @@ Internet-Draft Yang for Layer 0 Types March 2023 type boolean; description "Bit stuffing enabled/disabled."; + + + +Belotti, et al. Expires 8 January 2024 [Page 44] + +Internet-Draft Yang for Layer 0 Types July 2023 + + } leaf wavelength-assignment { type identityref { @@ -2234,14 +2496,6 @@ Internet-Draft Yang for Layer 0 Types March 2023 "The upper frequency must be greater than the lower frequency."; } - - - -Belotti, et al. Expires 13 September 2023 [Page 40] - -Internet-Draft Yang for Layer 0 Types March 2023 - - mandatory true; description "The upper frequency boundary of the @@ -2260,6 +2514,14 @@ Internet-Draft Yang for Layer 0 Types March 2023 default 0; description "An additional margin to be added to the OSNR-min of the + + + +Belotti, et al. Expires 8 January 2024 [Page 45] + +Internet-Draft Yang for Layer 0 Types July 2023 + + transceiver when checking the estimated received Generalized SNR (GSNR)."; } @@ -2291,13 +2553,6 @@ Internet-Draft Yang for Layer 0 Types March 2023 is HTTPS, and the mandatory-to-implement secure transport is TLS [RFC8446]. - - -Belotti, et al. Expires 13 September 2023 [Page 41] - -Internet-Draft Yang for Layer 0 Types March 2023 - - The Network Configuration Access Control Model (NACM) [RFC8341] provides the means to restrict access for particular NETCONF or RESTCONF users to a preconfigured subset of all available NETCONF or @@ -2306,6 +2561,23 @@ Internet-Draft Yang for Layer 0 Types March 2023 invoking and running NETCONF within a Secure Shell (SSH) session as an SSH subsystem. + + + + + + + + + + + + +Belotti, et al. Expires 8 January 2024 [Page 46] + +Internet-Draft Yang for Layer 0 Types July 2023 + + The objects in this YANG module are common data types and groupings. No object in this module can be read or written to. These definitions can be imported and used by other Layer 0 specific @@ -2345,13 +2617,21 @@ Internet-Draft Yang for Layer 0 Types March 2023 6.1. Normative References + [I-D.ietf-teas-rfc8776-update] + Busi, I., Guo, A., Liu, X., Saad, T., Beeram, V. P., and + I. Bryskin, "Common YANG Data Types for Traffic + Engineering", Work in Progress, Internet-Draft, draft- + ietf-teas-rfc8776-update-04, 27 June 2023, + . + -Belotti, et al. Expires 13 September 2023 [Page 42] +Belotti, et al. Expires 8 January 2024 [Page 47] -Internet-Draft Yang for Layer 0 Types March 2023 +Internet-Draft Yang for Layer 0 Types July 2023 [ITU-T_G.698.2] @@ -2405,9 +2685,9 @@ Internet-Draft Yang for Layer 0 Types March 2023 -Belotti, et al. Expires 13 September 2023 [Page 43] +Belotti, et al. Expires 8 January 2024 [Page 48] -Internet-Draft Yang for Layer 0 Types March 2023 +Internet-Draft Yang for Layer 0 Types July 2023 [RFC7950] Bjorklund, M., Ed., "The YANG 1.1 Data Modeling Language", @@ -2442,11 +2722,6 @@ Internet-Draft Yang for Layer 0 Types March 2023 Version 1.3", RFC 8446, DOI 10.17487/RFC8446, August 2018, . - [RFC8776] Saad, T., Gandhi, R., Liu, X., Beeram, V., and I. Bryskin, - "Common YANG Data Types for Traffic Engineering", - RFC 8776, DOI 10.17487/RFC8776, June 2020, - . - [RFC8795] Liu, X., Bryskin, I., Beeram, V., Saad, T., Shah, H., and O. Gonzalez de Dios, "YANG Data Model for Traffic Engineering (TE) Topologies", RFC 8795, @@ -2458,20 +2733,19 @@ Internet-Draft Yang for Layer 0 Types March 2023 [I-D.ietf-ccamp-dwdm-if-param-yang] Galimberti, G., Kunze, R., Hiremagalur, D., and G. Grammel, "A YANG model to manage the optical interface + parameters for an external transponder in a WDM network", + Work in Progress, Internet-Draft, draft-ietf-ccamp-dwdm- + if-param-yang-09, 13 March 2023, + . -Belotti, et al. Expires 13 September 2023 [Page 44] +Belotti, et al. Expires 8 January 2024 [Page 49] -Internet-Draft Yang for Layer 0 Types March 2023 +Internet-Draft Yang for Layer 0 Types July 2023 - parameters for an external transponder in a WDM network", - Work in Progress, Internet-Draft, draft-ietf-ccamp-dwdm- - if-param-yang-08, 24 October 2022, - . - [ITU-T_G.694.1] ITU-T Recommendation G.694.1, "Spectral grids for WDM applications: DWDM frequency grid", ITU-T G.694.1 , @@ -2515,13 +2789,6 @@ Acknowledgments This document was prepared using kramdown. - - -Belotti, et al. Expires 13 September 2023 [Page 45] - -Internet-Draft Yang for Layer 0 Types March 2023 - - Contributors Gabriele Galimberti @@ -2529,6 +2796,12 @@ Contributors Email: ggalimbe@cisco.com + +Belotti, et al. Expires 8 January 2024 [Page 50] + +Internet-Draft Yang for Layer 0 Types July 2023 + + Enrico Griseri Nokia Email: Enrico.Griseri@nokia.com @@ -2571,16 +2844,18 @@ Authors' Addresses Email: italo.busi@huawei.com + Dieter Beller (editor) + Nokia + Email: dieter.beller@nokia.com -Belotti, et al. Expires 13 September 2023 [Page 46] - -Internet-Draft Yang for Layer 0 Types March 2023 - Dieter Beller (editor) - Nokia - Email: dieter.beller@nokia.com + + +Belotti, et al. Expires 8 January 2024 [Page 51] + +Internet-Draft Yang for Layer 0 Types July 2023 Haomian Zheng @@ -2629,4 +2904,9 @@ Internet-Draft Yang for Layer 0 Types March 2023 -Belotti, et al. Expires 13 September 2023 [Page 47] + + + + + +Belotti, et al. Expires 8 January 2024 [Page 52] diff --git a/draft-ietf-ccamp-rfc9093-bis.xml b/draft-ietf-ccamp-rfc9093-bis.xml deleted file mode 100644 index 27e106a..0000000 --- a/draft-ietf-ccamp-rfc9093-bis.xml +++ /dev/null @@ -1,2839 +0,0 @@ - - - - - - - - - - -]> - - - - - - A YANG Data Model for Layer 0 Types - - - Nokia -
- sergio.belotti@nokia.com -
- - - Huawei -
- italo.busi@huawei.com -
- - - Nokia -
- dieter.beller@nokia.com -
- - - Huawei -
- zhenghaomian@huawei.com -
- - - Orange -
- esther.lerouzic@orange.com -
- - - Futurewei Technologies -
- aihuaguo.ietf@gmail.com -
- - - University of Lancaster -
- d.king@lancaster.ac.uk -
- - - - - - CCAMP Working Group - - - - - -This document defines a collection of common data types and groupings - in the YANG data modeling language. These derived common types and - groupings are intended to be imported by modules that model Layer 0 - optical Traffic Engineering (TE) configuration and state capabilities - such as Wavelength Switched Optical Networks (WSONs) and flexi-grid - Dense Wavelength Division Multiplexing (DWDM) networks. - -This document obsoletes RFC 9093. - - - - - - - - - - - - -
Introduction - -YANG is a data modeling language used to model - configuration data, state data, Remote Procedure Calls, and - notifications for network management protocols such as the Network - Configuration Protocol (NETCONF) . The YANG language - supports a small set of built-in data types and provides mechanisms - to derive other types from the built-in types. - -This document introduces a collection of common data types derived - from the built-in YANG data types. The derived types and groupings - are designed to be the common types applicable for modeling Traffic - Engineering (TE) features as well as non-TE features (e.g., physical - network configuration aspects) for Layer 0 optical networks in - model(s) defined outside of this document. The applicability of - Layer 0 types specified in this document includes Wavelength Switched - Optical Networks (WSONs) and flexi-grid Dense - Wavelength Division Multiplexing (DWDM) networks - . - -This document adds new type definitions to the YANG modules and - obsoletes . For further details, see the revision - statements of the YANG module in or the summary in - . - -The YANG data model in this document conforms to the Network - Management Datastore Architecture defined in . - -
Terminology and Notations - -Refer to and for the key terms used in this - document, and the terminology for describing YANG data models can be - found in . - -The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL -NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "NOT RECOMMENDED", -"MAY", and "OPTIONAL" in this document are to be interpreted as -described in BCP 14 when, and only when, they -appear in all capitals, as shown here. - -
-
Prefix in Data Node Names - -In this document, names of data nodes and other data model objects - are prefixed using the standard prefix associated with the - corresponding YANG imported modules. - - - Prefix - YANG module - Reference - l0-types - ietf-layer0-types - RFC XXXX - - -RFC Editor Note: -Please replace XXXX with the RFC number assigned to this document. - -The YANG module "ietf-layer0-types" (defined in ) references - , , , , , , - , and . - -
-
-
Layer 0 Types Module Contents - -This document defines a YANG module for common Layer 0 types, ietf- - layer0-types. This module is used for WSON and flexi-grid DWDM - networks. The "ietf-layer0-types" module contains the following YANG - reusable types and groupings: - -l0-grid-type: - -
  • - A base YANG identity for the grid type as defined in and - . -
- -dwdm-ch-spc-type: - -
  • - A base YANG identity for the DWDM channel-spacing type as defined - in . -
- -cwdm-ch-spc-type: - -
  • - A base YANG identity for the Coarse Wavelength Division - Multiplexing (CWDM) channel-spacing type as defined in . -
- -wson-label-start-end: - -
  • - The WSON label range was defined in , and the generic - topology model defines the label-start/label-end in . - This grouping shows the WSON-specific label-start and label-end - information. -
- -wson-label-hop: - -
  • - The WSON label range was defined in , and the generic - topology model defines the label-hop in . This grouping - shows the WSON-specific label-hop information. -
- -l0-label-range-info: - -
  • - A YANG grouping that defines the Layer 0 label range information - applicable for WSON as defined in . This grouping is - used in the flexi-grid DWDM by adding more flexi-grid-specific - parameters. -
- -wson-label-step: - -
  • - A YANG grouping that defines label steps for WSON as defined in - . -
- -flexi-grid-label-start-end: - -
  • - The flexi-grid label range was defined in , and the - generic topology model defines the label-start/label-end in - . This grouping shows the flexi-grid-specific label- - start and label-end information. -
- -flexi-grid-label-hop: - -
  • - The flexi-grid label range was defined in , and the - generic topology model defines the label-hop in . This - grouping shows the WSON-specific label-hop information. -
- -flexi-grid-label-range-info: - -
  • - A YANG grouping that defines flexi-grid label range information as - defined in and . -
- -flexi-grid-label-step: - -
  • - A YANG grouping that defines flexi-grid label steps as defined in - . -
- -transceiver-capabilities: - -
  • - a YANG grouping to define the transceiver capabilities (also called - "modes") needed to determine optical signal compatibility. -
- -standard-mode: - -
  • - a YANG grouping for ITU-T G.698.2 standard mode that guarantees - interoperability. -
- -organizational-mode: - -
  • - a YANG grouping to define transponder operational mode supported by - organizations or vendors. -
- -common-explicit-mode: - -
  • - a YANG grouping to define the list of attributes related to optical - impairments limits in case of transceiver explicit mode. This - grouping should be the same used in - . -
- -common-organizational-explicit-mode: - -
  • - a YANG grouping to define the common capabilities attributes limit - range in case of operational mode and explicit mode. Also this - grouping should be used in . -
- -cd-pmd-penalty: - -
  • - a YANG grouping to define the triplet used as entries in the list - optional penalty associated with a given accumulated CD and PMD. - This list of triplet cd, pmd, penalty can be used to sample the - function penalty = f(CD, PMD). -
- -
-
YANG Module for Layer 0 Types - -
- WG List: - - Editor: Dieter Beller - - - Editor: Sergio Belotti - - - Editor: Italo Busi - - - Editor: Haomian Zheng - "; - description - "This module defines Optical Layer 0 types. This module - provides groupings that can be applicable to Layer 0 - Fixed Optical Networks (e.g., CWDM (Coarse Wavelength - Division Multiplexing) and DWDM (Dense Wavelength Division - Multiplexing)) and flexi-grid optical networks. - - Copyright (c) 2023 IETF Trust and the persons identified - as authors of the code. All rights reserved. - - Redistribution and use in source and binary forms, with - or without modification, is permitted pursuant to, and - subject to the license terms contained in, the Revised - BSD License set forth in Section 4.c of the IETF Trust's - Legal Provisions Relating to IETF Documents - (https://trustee.ietf.org/license-info). - - This version of this YANG module is part of RFC XXXX; see - the RFC itself for full legal notices. - - The key words 'MUST', 'MUST NOT', 'REQUIRED', 'SHALL', 'SHALL - NOT', 'SHOULD', 'SHOULD NOT', 'RECOMMENDED', 'NOT RECOMMENDED', - 'MAY', and 'OPTIONAL' in this document are to be interpreted as - described in BCP 14 (RFC 2119) (RFC 8174) when, and only when, - they appear in all capitals, as shown here."; - -// RFC Ed.: replace XXXX with actual RFC number and remove -// this note - -// replace the revision date with the module publication date -// the format is (year-month-day) - revision 2023-03-07 { - description - "To be updated"; - reference - "RFC XXXX: A YANG Data Model for Layer 0 Types"; - } - revision 2021-08-13 { - description - "Initial version"; - reference - "RFC 9093: A YANG Data Model for Layer 0 Types"; - } - -/* - * Identities - */ - - identity l0-grid-type { - description - "Layer 0 grid type"; - reference - "RFC 6163: Framework for GMPLS and Path Computation Element - (PCE) Control of Wavelength Switched Optical Networks (WSONs), - ITU-T G.694.1 (10/2020): Spectral grids for WDM applications: - DWDM frequency grid, - ITU-T G.694.2 (12/2003): Spectral grids for WDM applications: - CWDM wavelength grid"; - } - - identity flexi-grid-dwdm { - base l0-grid-type; - description - "Flexi-grid"; - reference - "RFC 7698: Framework and Requirements for GMPLS-Based Control - of Flexi-Grid Dense Wavelength Division Multiplexing (DWDM) - Networks, - ITU-T G.694.1 (10/2020): Spectral grids for WDM applications: - DWDM frequency grid"; - } - - identity wson-grid-dwdm { - base l0-grid-type; - description - "DWDM grid"; - reference - "RFC 6163:Framework for GMPLS and Path Computation Element - (PCE) Control of Wavelength Switched Optical Networks (WSONs), - ITU-T G.694.1 (10/2020): Spectral grids for WDM applications: - DWDM frequency grid"; - } - - identity wson-grid-cwdm { - base l0-grid-type; - description - "CWDM grid"; - reference - "RFC 6205: Generalized Labels for Lambda-Switch-Capable (LSC) - Label Switching Routers, - ITU-T G.694.2 (12/2003): Spectral grids for WDM applications: - CWDM wavelength grid"; - } - - identity dwdm-ch-spc-type { - description - "DWDM channel-spacing type"; - reference - "RFC 6205: Generalized Labels for Lambda-Switch-Capable (LSC) - Label Switching Routers, - ITU-T G.694.1 (10/2020): Spectral grids for WDM applications: - DWDM frequency grid"; - } - - identity dwdm-100ghz { - base dwdm-ch-spc-type; - description - "100 GHz channel spacing"; - } - - identity dwdm-50ghz { - base dwdm-ch-spc-type; - description - "50 GHz channel spacing"; - } - - identity dwdm-25ghz { - base dwdm-ch-spc-type; - description - "25 GHz channel spacing"; - } - - identity dwdm-12p5ghz { - base dwdm-ch-spc-type; - description - "12.5 GHz channel spacing"; - } - - identity flexi-ch-spc-type { - description - "Flexi-grid channel-spacing type"; - reference - "RFC 7698: Framework and Requirements for GMPLS-Based Control - of Flexi-Grid Dense Wavelength Division Multiplexing (DWDM) - Networks, - ITU-T G.694.1 (10/2020): Spectral grids for WDM applications: - DWDM frequency grid"; - } - - identity flexi-ch-spc-6p25ghz { - base flexi-ch-spc-type; - description - "6.25 GHz channel spacing"; - } - - identity flexi-slot-width-granularity { - description - "Flexi-grid slot width granularity"; - } - - identity flexi-swg-12p5ghz { - base flexi-slot-width-granularity; - description - "12.5 GHz slot width granularity"; - } - - identity cwdm-ch-spc-type { - description - "CWDM channel-spacing type"; - reference - "RFC 6205: Generalized Labels for Lambda-Switch-Capable (LSC) - Label Switching Routers, - ITU-T G.694.2 (12/2003): Spectral grids for WDM applications: - CWDM wavelength grid"; - } - - identity cwdm-20nm { - base cwdm-ch-spc-type; - description - "20nm channel spacing"; - } - - identity modulation { - description "base identity for modulation type"; - } - - identity DPSK { - base modulation; - description - "DPSK (Differential Phase Shift Keying) modulation"; - } - - identity QPSK { - base modulation; - description - "QPSK (Quadrature Phase Shift Keying) modulation"; - } - - identity DP-QPSK { - base modulation; - description - "DP-QPSK (Dual Polarization Quadrature - Phase Shift Keying) modulation"; - } - - identity QAM8 { - base modulation; - description - "8QAM (8 symbols Quadrature Amplitude Modulation)"; - } - - identity DP-QAM8 { - base modulation; - description - "DP-QAM8 (8 symbols Dual Polarization Quadrature Amplitude - Modulation)"; - } - - identity DC-DP-QAM8 { - base modulation; - description - "DC DP-QAM8 (8 symbols Dual Carrier Dual Polarization - Quadrature Amplitude Modulation)"; - } - - identity QAM16 { - base modulation; - description - "QAM16 (16 symbols Quadrature Amplitude Modulation)"; - } - - identity DP-QAM16 { - base modulation; - description - "DP-QAM16 (16 symbols Dual Polarization Quadrature Amplitude - Modulation)"; - } - - identity DC-DP-QAM16 { - base modulation; - description - "DC DP-QAM16 (16 symbols Dual Carrier Dual Polarization - Quadrature Amplitude Modulation)"; - } - - identity QAM32 { - base modulation; - description - "QAM32 (32 symbols Quadrature Amplitude Modulation)"; - } - - identity DP-QAM32 { - base modulation; - description - "DP-QAM32 (32 symbols Dual Polarization Quadrature Amplitude - Modulation)"; - } - - identity QAM64 { - base modulation; - description - "QAM64 (64 symbols Quadrature Amplitude Modulation)"; - } - - identity DP-QAM64 { - base modulation; - description - "DP-QAM64 (64 symbols Dual Polarization Quadrature Amplitude - Modulation)"; - } - - identity fec-type { - description - "Base identity from which specific FEC - (Forward Error Correction) type identities are derived."; - } - - identity g-fec { - base fec-type; - description - "G-FEC (Generic-FEC)"; - } - identity e-fec { - base fec-type; - description - "E-FEC (Enhanced-FEC)"; - } - identity no-fec { - base fec-type; - description - "No FEC"; - } - - identity reed-solomon { - base fec-type; - description - "Reed-Solomon error correction"; - } - - identity hamming-code { - base fec-type; - description - "Hamming Code error correction"; - } - - identity golay { - base fec-type; - description "Golay error correction"; - } - - identity line-coding { - description - "base line-coding class"; - reference - "ITU-T G.698.2-201811 section 7"; - } - - identity line-coding-NRZ-2p5G { - base line-coding; - description - "ITU-T G.698.2-201811 section 7 table 8-1"; - } - - identity line-coding-NRZ-OTU1 { - base line-coding; - description - "ITU-T G.698.2-201811 section 7 table 8-2"; - } - - identity line-coding-NRZ-10G { - base line-coding; - description - "ITU-T G.698.2-201811 section 7 table 8-3/8-5"; - } - - identity line-coding-NRZ-OTU2 { - base line-coding; - description - "ITU-T G.698.2-201811 section 7 table 8-4/8-6"; - } - - identity wavelength-assignment { - description - "Wavelength selection base"; - reference - "RFC6163:Framework for GMPLS and Path Computation Element - (PCE) Control of Wavelength Switched Optical Networks (WSONs)"; - } - - identity first-fit-wavelength-assignment { - base wavelength-assignment; - description - "All the available wavelengths are numbered, - and this WA (Wavelength Assignment) method chooses - the available wavelength with the lowest index"; - } - - identity random-wavelength-assignment { - base wavelength-assignment; - description - "This WA method chooses an available - wavelength randomly"; - } - - identity least-loaded-wavelength-assignment { - base wavelength-assignment; - description - "This WA method selects the wavelength that - has the largest residual capacity on the most loaded - link along the route (in multi-fiber networks)"; - } - - identity term-type { - description - "Termination type"; - reference - "ITU-T G.709: Interfaces for the Optical Transport Network"; - } - - identity term-phys { - base term-type; - description - "Physical layer termination"; - } - - identity term-otu { - base term-type; - description - "OTU (Optical Transport Unit) termination"; - } - - identity term-odu { - base term-type; - description - "ODU (Optical Data Unit) termination"; - } - - identity term-opu { - base term-type; - description - "OPU (Optical Payload Unit) termination"; - } - - identity otu-type { - description - "Base identity from which specific OTU identities are derived"; - reference - "ITU-T G.709: Interfaces for the Optical Transport Network"; - } - - identity OTU1 { - base otu-type; - description - "OTU1 (2.66 Gb/s)"; - } - - identity OTU1e { - base otu-type; - description - "OTU1e (11.04 Gb/s)"; - } - - identity OTU1f { - base otu-type; - description - "OTU1f (11.27 Gb/s)"; - } - - identity OTU2 { - base otu-type; - description - "OTU2 (10.70 Gb/s)"; - } - - identity OTU2e { - base otu-type; - description - "OTU2e (11.09 Gb/s)"; - } - - identity OTU2f { - base otu-type; - description - "OTU2f (11.31G)"; - } - - identity OTU3 { - base otu-type; - description - "OTU3 (43.01 Gb/s)"; - } - - identity OTU3e1 { - base otu-type; - description - "OTU3e1 (44.57 Gb/s)"; - } - - identity OTU3e2 { - base otu-type; - description - "OTU3e2 (44.58 Gb/s)"; - } - - identity OTU4 { - base otu-type; - description - "OTU4 (111.80 Gb/s)"; - } - - identity OTUCn { - base otu-type; - description - "OTUCn (n x 105.25 Gb/s)"; - } - - identity type-power-mode { - description - "power equalization mode used within the - OMS and its elements"; - } - - identity power-spectral-density { - base type-power-mode; - description - "all elements must use power spectral density (W/Hz)"; - } - - identity carrier-power { - base type-power-mode; - description - "all elements must use power (dBm)"; - } - -/* - * Typedefs - */ - - typedef dwdm-n { - type int16; - description - "The given value 'N' is used to determine the nominal central - frequency. - - The nominal central frequency, 'f', is defined by: - f = 193100.000 GHz + N x channel spacing (measured in GHz), - - where 193100.000 GHz (193.100000 THz) is the ITU-T 'anchor - frequency' for transmission over the DWDM grid, and where - 'channel spacing' is defined by the dwdm-ch-spc-type."; - reference - "RFC6205: Generalized Labels for Lambda-Switch-Capable (LSC) - Label Switching Routers, - ITU-T G.694.1 (10/2020): Spectral grids for WDM applications: - DWDM frequency grid"; - } - - typedef cwdm-n { - type int16; - description - "The given value 'N' is used to determine the nominal central - wavelength. - - The nominal central wavelength is defined by: - Wavelength = 1471 nm + N x channel spacing (measured in nm) - - where 1471 nm is the conventional 'anchor wavelength' for - transmission over the CWDM grid, and where 'channel spacing' - is defined by the cwdm-ch-spc-type."; - reference - "RFC 6205: Generalized Labels for Lambda-Switch-Capable (LSC) - Label Switching Routers, - ITU-T G.694.2 (12/2003): Spectral grids for WDM applications: - CWDM wavelength grid"; - } - - typedef flexi-n { - type int16; - description - "The given value 'N' is used to determine the nominal central - frequency. - - The nominal central frequency, 'f', is defined by: - f = 193100.000 GHz + N x channel spacing (measured in GHz), - - where 193100.000 GHz (193.100000 THz) is the ITU-T 'anchor - frequency' for transmission over the DWDM grid, and where - 'channel spacing' is defined by the flexi-ch-spc-type. - - Note that the term 'channel spacing' can be substituted by the - term 'nominal central frequency granularity' defined in - clause 8 of ITU-T G.694.1."; - reference - "RFC 7698: Framework and Requirements for GMPLS-Based Control - of Flexi-Grid Dense Wavelength Division Multiplexing (DWDM) - Networks, - ITU-T G.694.1 (10/2020): Spectral grids for WDM applications: - DWDM frequency grid"; - } - - typedef flexi-m { - type uint16; - description - "The given value 'M' is used to determine the slot width. - - A slot width is defined by: - slot width = M x SWG (measured in GHz), - - where SWG is defined by the flexi-slot-width-granularity."; - reference - "RFC 7698: Framework and Requirements for GMPLS-Based Control - of Flexi-Grid Dense Wavelength Division Multiplexing (DWDM) - Networks. - ITU-T G.694.1 (10/2020): Spectral grids for WDM applications: - DWDM frequency grid"; - } - - typedef operational-mode { - type string; - description - "Organization/vendor specific mode that guarantees - interoperability."; -// RFC Ed.: replace YYYY with actual RFC number and remove -// this note after draft-ietf-ccamp-optical-impairment-topology-yang -// is published as an RFC - reference - "Section 2.5.2 of RFC YYYY: A YANG Data Model for Optical - Impairment-aware Topology."; - } - - typedef standard-mode { - type string; - description - "ITU-T G.698.2 standard mode that guarantees - interoperability. - It must be an string with the following format: - B-DScW-ytz(v) where all these attributes - are conformant - to the ITU-T recomendation"; - reference "ITU-T G.698.2 (11/2018)"; - } - - typedef organization-identifier { - type string; - description - "vendor/organization identifier that uses a private mode - out of already defined in G.698.2 ITU-T application-code"; - reference - "RFC7581: Routing and Wavelength Assignment Information - Encoding for Wavelength Switched Optical Networks"; - } - - typedef frequency-thz { - type decimal64 { - fraction-digits 9; - } - units THz; - description - "The DWDM frequency in THz, e.g., 193.112500000"; - } - typedef frequency-ghz { - type decimal64 { - fraction-digits 6; - } - units GHz; - description - "The DWDM frequency in GHz, e.g., 193112.500000"; - } - - typedef dbm-t { - type int32; - units ".01dbm"; - description - "Amplifiers and Transceivers Power in dBm."; - } - - typedef snr { - type decimal64 { - fraction-digits 2; - } - units "dB@0.1nm"; - description - "(Optical) Signal to Noise Ratio measured over 0.1 nm - resolution bandwidth"; - } - - typedef snr-or-null { - type union { - type snr; - type empty; - } - description - "(Optical) Signal to Noise Ratio measured over 0.1 nm - resolution bandwidth, when known, or an empty value when - unknown."; - } - - typedef fiber-type { - type enumeration { - enum G.652 { - description "G.652 Standard Singlemode Fiber"; - } - enum G.654 { - description "G.654 Cutoff Shifted Fiber"; - } - enum G.653 { - description "G.653 Dispersion Shifted Fiber"; - } - enum G.655 { - description "G.655 Non-Zero Dispersion Shifted Fiber"; - } - enum G.656 { - description "G.656 Non-Zero Dispersion for Wideband - Optical Transport"; - } - enum G.657 { - description "G.657 Bend-Insensitive Fiber"; - } - } - description - "ITU-T based fiber-types"; - } - - typedef decimal-2-digits { - type decimal64 { - fraction-digits 2; - } - description - "A decimal64 value with two digits."; - } - - typedef decimal-2-digits-or-null { - type union { - type decimal-2-digits; - type empty; - } - description - "A decimal64 value with two digits, when the value is know or - an empty value when the value is not known."; - } - - typedef power-in-db { - type decimal-2-digits; - units dB; - description - "The power in dB."; - } - - typedef power-in-db-or-null { - type union { - type power-in-db; - type empty; - } - description - "The power in dB, when it is known or an empty value when the - power is not known."; - } - - typedef power-in-dbm { - type decimal-2-digits; - units dBm; - description - "The power in dBm."; - } - - typedef power-in-dbm-or-null { - type union { - type power-in-dbm; - type empty; - } - description - "The power in dBm, when it is known or an empty value when the - power is not known."; - } - -/* - * Groupings - */ - - grouping wson-label-start-end { - description - "The WSON label-start or label-end used to specify WSON label - range."; - choice grid-type { - description - "Label for DWDM or CWDM grid"; - case dwdm { - leaf dwdm-n { - when "derived-from-or-self(../../../grid-type, - \"wson-grid-dwdm\")" { - description - "Valid only when grid type is DWDM."; - } - type l0-types:dwdm-n; - description - "The central frequency of DWDM."; - reference - "RFC 6205: Generalized Labels for Lambda-Switch-Capable - (LSC) Label Switching Routers"; - } - } - case cwdm { - leaf cwdm-n { - when "derived-from-or-self(../../../grid-type, - \"wson-grid-cwdm\")" { - description - "Valid only when grid type is CWDM."; - } - type l0-types:cwdm-n; - description - "Channel wavelength computing input."; - reference - "RFC 6205: Generalized Labels for Lambda-Switch-Capable - (LSC) Label Switching Routers"; - } - } - } - reference - "RFC 6205: Generalized Labels for Lambda-Switch-Capable (LSC) - Label Switching Routers"; - } - - grouping wson-label-hop { - description - "Generic label-hop information for WSON"; - choice grid-type { - description - "Label for DWDM or CWDM grid"; - case dwdm { - choice single-or-super-channel { - description - "single or super channel"; - case single { - leaf dwdm-n { - type l0-types:dwdm-n; - description - "The given value 'N' is used to determine the - nominal central frequency."; - } - } - case super { - leaf-list subcarrier-dwdm-n { - type l0-types:dwdm-n; - description - "The given values 'N' are used to determine the - nominal central frequency for each subcarrier - channel."; - reference - "ITU-T Recommendation G.694.1: Spectral grids for - WDM applications: DWDM frequency grid"; - } - } - } - } - case cwdm { - leaf cwdm-n { - type l0-types:cwdm-n; - description - "The given value 'N' is used to determine the nominal - central wavelength."; - reference - "RFC 6205: Generalized Labels for Lambda-Switch-Capable - (LSC) Label Switching Routers"; - } - } - } - reference - "RFC 6205: Generalized Labels for Lambda-Switch-Capable (LSC) - Label Switching Routers"; - } - - grouping l0-label-range-info { - description - "Information about Layer 0 label range."; - leaf grid-type { - type identityref { - base l0-grid-type; - } - description - "Grid type"; - } - leaf priority { - type uint8; - description - "Priority in Interface Switching Capability Descriptor - (ISCD)."; - reference - "RFC 4203: OSPF Extensions in Support of Generalized - Multi-Protocol Label Switching (GMPLS)"; - } - reference - "RFC 6205: Generalized Labels for Lambda-Switch-Capable (LSC) - Label Switching Routers"; - } - - grouping wson-label-step { - description - "Label step information for WSON"; - choice l0-grid-type { - description - "Grid type: DWDM, CWDM, etc."; - case dwdm { - leaf wson-dwdm-channel-spacing { - when "derived-from-or-self(../../grid-type, - \"wson-grid-dwdm\")" { - description - "Valid only when grid type is DWDM."; - } - type identityref { - base dwdm-ch-spc-type; - } - description - "Label-step is the channel spacing (GHz), e.g., 100.000, - 50.000, 25.000, or 12.500 GHz for DWDM."; - reference - "RFC 6205: Generalized Labels for Lambda-Switch-Capable - (LSC) Label Switching Routers"; - } - } - case cwdm { - leaf wson-cwdm-channel-spacing { - when "derived-from-or-self(../../grid-type, - \"wson-grid-cwdm\")" { - description - "Valid only when grid type is CWDM."; - } - type identityref { - base cwdm-ch-spc-type; - } - description - "Label-step is the channel spacing (nm), i.e., 20 nm - for CWDM, which is the only value defined for CWDM."; - reference - "RFC 6205: Generalized Labels for Lambda-Switch-Capable - (LSC) Label Switching Routers"; - } - } - } - reference - "RFC 6205: Generalized Labels for Lambda-Switch-Capable (LSC) - Label Switching Routers, - ITU-T G.694.2 (12/2003): Spectral grids for WDM applications: - CWDM wavelength grid"; - } - - grouping flexi-grid-label-start-end { - description - "The flexi-grid label-start or label-end used to specify - flexi-grid label range."; - leaf flexi-n { - type l0-types:flexi-n; - description - "The given value 'N' is used to determine the nominal - central frequency."; - } - reference - "RFC 7698: Framework and Requirements for GMPLS-Based Control - of Flexi-Grid Dense Wavelength Division Multiplexing (DWDM) - Networks"; - } - - grouping flexi-grid-frequency-slot { - description - "Flexi-grid frequency slot grouping."; - uses flexi-grid-label-start-end; - leaf flexi-m { - type l0-types:flexi-m; - description - "The given value 'M' is used to determine the slot width."; - } - reference - "RFC 7698: Framework and Requirements for GMPLS-Based Control - of Flexi-Grid Dense Wavelength Division Multiplexing (DWDM) - Networks"; - } - - grouping flexi-grid-label-hop { - description - "Generic label-hop information for flexi-grid"; - choice single-or-super-channel { - description - "single or super channel"; - case single { - uses flexi-grid-frequency-slot; - } - case super { - list subcarrier-flexi-n { - key "flexi-n"; - uses flexi-grid-frequency-slot; - description - "List of subcarrier channels for flexi-grid super - channel."; - } - } - } - reference - "RFC 7698: Framework and Requirements for GMPLS-Based Control - of Flexi-Grid Dense Wavelength Division Multiplexing (DWDM) - Networks"; - } - - grouping flexi-grid-label-range-info { - description - "Flexi-grid-specific label range related information"; - uses l0-label-range-info; - container flexi-grid { - description - "flexi-grid definition"; - leaf slot-width-granularity { - type identityref { - base flexi-slot-width-granularity; - } - default "flexi-swg-12p5ghz"; - description - "Minimum space between slot widths. Default is 12.500 - GHz."; - reference - "RFC 7698: Framework and Requirements for GMPLS-Based - Control of Flexi-Grid Dense Wavelength Division - Multiplexing (DWDM) Networks"; - } - leaf min-slot-width-factor { - type uint16 { - range "1..max"; - } - default "1"; - description - "A multiplier of the slot width granularity, indicating - the minimum slot width supported by an optical port. - - Minimum slot width is calculated by: - Minimum slot width (GHz) = - min-slot-width-factor * slot-width-granularity."; - reference - "RFC 8363: GMPLS OSPF-TE Extensions in Support of Flexi- - Grid Dense Wavelength Division Multiplexing (DWDM) - Networks"; - } - - leaf max-slot-width-factor { - type uint16 { - range "1..max"; - } - must '. >= ../min-slot-width-factor' { - error-message - "Maximum slot width must be greater than or equal to - minimum slot width."; - } - description - "A multiplier of the slot width granularity, indicating - the maximum slot width supported by an optical port. - - Maximum slot width is calculated by: - Maximum slot width (GHz) = - max-slot-width-factor * slot-width-granularity - - If specified, maximum slot width must be greater than or - equal to minimum slot width. If not specified, maximum - slot width is equal to minimum slot width."; - reference - "RFC 8363: GMPLS OSPF-TE Extensions in Support of Flexi- - Grid Dense Wavelength Division Multiplexing (DWDM) - Networks"; - } - } - } - - grouping flexi-grid-label-step { - description - "Label step information for flexi-grid"; - leaf flexi-grid-channel-spacing { - type identityref { - base flexi-ch-spc-type; - } - default "flexi-ch-spc-6p25ghz"; - description - "Label-step is the nominal central frequency granularity - (GHz), e.g., 6.25 GHz."; - reference - "RFC 7699: Generalized Labels for the Flexi-Grid in Lambda - Switch Capable (LSC) Label Switching Routers"; - } - leaf flexi-n-step { - type uint8; - description - "This attribute defines the multiplier for the supported - values of 'N'. - - For example, given a grid with a nominal central frequency - granularity of 6.25 GHz, the granularity of the supported - values of the nominal central frequency could be 12.5 GHz. - In this case, the values of flexi-n should be even and this - constraint is reported by setting the flexi-n-step to 2. - - This attribute is also known as central frequency - granularity in RFC 8363."; - reference - "RFC 8363: GMPLS OSPF-TE Extensions in Support of Flexi-Grid - Dense Wavelength Division Multiplexing (DWDM) Networks"; - } - } - - /* supported inverse multiplexing capabilities such as - max. OTSiG:OTSi cardinality - It is a transponder attribute not transceiver - */ - - /* leaf multiplexing-cap { - type uint32; - config false; - description "supported inverse multiplexing capabilities - such as max. OTSiG:OTSi cardinality"; - } - */ - - grouping transceiver-mode { - description - "This grouping is intended to be used for reporting the - information of a transceiver's mode."; - choice mode { - mandatory true; - description - "Indicates whether the transceiver's mode is a standard - mode, an organizational mode or an explicit mode."; - case G.698.2 { - uses standard-mode; - } - case organizational-mode { - container organizational-mode { - description - "The set of attributes for an organizational mode"; - uses organizational-mode; - uses common-organizational-explicit-mode; - } // container organizational-mode - } - case explicit-mode { - container explicit-mode { - description - "The set of attributes for an explicit mode"; - container supported-modes { - description - "Container for all the standard and organizational - modes supported by the transceiver's explicit - mode."; - leaf-list supported-application-codes { - type leafref { - path "../../../mode-id"; - } - must "../../../../" - + "supported-mode[mode-id=current()]/" - + "standard-mode" { - description - "The pointer is only for application codes - supported by transceiver."; - } - description - "List of pointers to the application codes - supported by the transceiver's explicit mode."; - } - leaf-list supported-organizational-modes { - type leafref { - path "../../../mode-id"; - } - must "../../../../" - + "supported-mode[mode-id=current()]/" - + "organizational-mode" { - description - "The pointer is only for organizational modes - supported by transceiver."; - } - description - "List of pointers to the organizational modes - supported by the transceiver's explicit mode."; - } - } // container supported-modes - uses common-explicit-mode; - uses common-organizational-explicit-mode; - } // container explicit-mode - } // end of case explicit-mode - } // end of choice - } - grouping transceiver-capabilities { - description - "This grouping is intended to be used for reporting the - capabilities of a transceiver."; - - container supported-modes { - presence - "When present, it indicates that the modes supported by a - transceiver are reported."; - description - "The top level container for the list supported - transceiver's modes."; - list supported-mode { - key "mode-id"; - config false; - min-elements 1; - description "The list of supported transceiver's modes."; - leaf mode-id { - type string { - length "1..255"; - } - description "ID for the supported transceiver's mode."; - } - uses transceiver-mode; - } // list supported-modes - } // container supported-modes - } // grouping transceiver-capabilities - - grouping standard-mode { - description - "ITU-T G.698.2 standard mode that guarantees interoperability. - It must be an string with the following format: - B-DScW-ytz(v) where all these attributes are conformant - to the ITU-T recomendation"; - - leaf standard-mode { - type standard-mode; - config false; - description - "G.698.2 standard mode"; - } - } - - grouping organizational-mode { - description - "Transponder operational mode supported by organizations or - vendor"; - - leaf operational-mode { - type operational-mode; - config false; - description - "configured organization- or vendor-specific - application identifiers (AI) supported by the transponder"; - } - leaf organization-identifier { - type organization-identifier; - config false; - description - "organization identifier that uses organizational - mode"; - } - } - - grouping penalty-value { - description - "A common definition of the penalty value used for describing - multiple penalty types (.e.g, CD, PMD, PDL)."; - - leaf penalty-value { - type union { - type decimal64 { - fraction-digits 2; - range "0..max"; - } - type empty; - } - units "dB"; - config false; - mandatory true; - description - "OSNR penalty associated with the related optical - impairment at the receiver."; - } - } - -/* - * This grouping represent the list of attributes related to - * optical impairment limits for explicit mode - * (min OSNR, max PMD, max CD, max PDL, Q-factor limit, etc.) - * In case of standard and operational mode the attributes are - * implicit - */ - - grouping common-explicit-mode { - description "Attributes capabilities related to - explicit mode of an optical transceiver"; - leaf line-coding-bitrate { - type identityref { - base line-coding; - } - config false; - description - "Bit rate/line coding of the optical tributary signal."; - reference - "ITU-T G.698.2 section 7.1.2"; - } - leaf bitrate { - type uint16; - units "Gbit/sec"; - config false; - description - "The gross bitrate (e.g., 100, 200) of the optical tributary - signal."; - } - leaf max-polarization-mode-dispersion { - type decimal64 { - fraction-digits 2; - range "0..max"; - } - units "ps"; - config false; - description - "Maximum acceptable accumulated polarization mode - dispersion on the receiver"; - } - leaf max-chromatic-dispersion { - type decimal64 { - fraction-digits 2; - range "0..max"; - } - units "ps/nm"; - config false; - description - "Maximum acceptable accumulated chromatic dispersion - on the receiver"; - } - list chromatic-dispersion-penalty { - config false; - description - "Optional penalty associated with a given accumulated - chromatic dispersion (CD) value. - This list of pair cd and penalty can be used to - sample the function penalty = f(CD)."; - leaf chromatic-dispersion { - type union { - type decimal64 { - fraction-digits 2; - range "0..max"; - } - type empty; - } - units "ps/nm"; - config false; - mandatory true; - description "Chromatic dispersion"; - } - uses penalty-value; - } - list polarization-dispersion-penalty { - config false; - description - "Optional penalty associated with a given accumulated - polarization mode dispersion(PMD) value. - This list of pair pmd and penalty can be used to - sample the function penalty = f(PMD)."; - leaf polarization-mode-dispersion { - type union { - type decimal64 { - fraction-digits 2; - range "0..max"; - } - type empty; - } - units "ps"; - config false; - mandatory true; - description "Polarization mode dispersion"; - } - uses penalty-value; - } - leaf max-diff-group-delay { - type uint32; - units "ps"; - config false; - description "Maximum Differential group delay of this mode - for this lane"; - } - list max-pol-dependent-loss-penalty { - config false; - description - "Optional penalty associated with the maximum acceptable - accumulated polarization dependent loss. - This list of pair pdl and penalty can be used to - sample the function pdl = f(penalty)."; - leaf max-polarization-dependent-loss { - type power-in-db-or-null; - config false; - mandatory true; - description - "Maximum acceptable accumulated polarization dependent - loss."; - } - uses penalty-value; - } - leaf available-modulation-type { - type identityref { - base modulation; - } - config false; - description - "Modulation type the specific transceiver in the list - can support"; - } - leaf min-OSNR { - type snr; - units "dBm"; - config false; - description - "min OSNR measured over 0.1 nm resolution bandwidth: - if received OSNR at Rx-power reference point - (rx-ref-channel-power) is lower than MIN-OSNR, an increased - level of bit-errors post-FEC needs to be expected"; - } - leaf rx-ref-channel-power { - type dbm-t; - config false; - description - "The channel power used as reference for defining penalties - and min-OSNR"; - } - list rx-channel-power-penalty { - config false; - description - "Optional penalty associated with a received power - lower than rx-ref-channel-power. - This list of pair power and penalty can be used to - sample the function penalty = f(rx-channel-power)."; - leaf rx-channel-power { - type union { - type dbm-t; - type empty; - } - units "dBm"; - config false; - mandatory true; - description "Received Power"; - } - uses penalty-value; - } - leaf min-Q-factor { - type int32; - units "dB"; - config false; - description "min Qfactor at FEC threshold"; - } - leaf available-baud-rate { - type uint32; - units Bd; - config false; - description - "Baud-rate the specific transceiver in - the list can support. - Baud-rate is the unit for - symbol rate or modulation rate - in symbols per second or - pulses per second. - It is the number of distinct symbol - changes (signal events) made to the - transmission medium - per second in a digitally - modulated signal or a line code"; - } - leaf roll-off { - type decimal64 { - fraction-digits 4; - range "0..1"; - } - config false; - description - "the roll-off factor (beta with values from 0 to 1) - identifies how the real signal shape exceed - the baud rate. If=0 it is exactly matching - the baud rate.If=1 the signal exceeds the - 50% of the baud rate at each side."; - } - leaf min-carrier-spacing { - type frequency-ghz; - config false; - description - "This attribute specifies the minimum nominal difference - between the carrier frequencies of two homogeneous OTSis - (which have the same optical characteristics but the central - frequencies) such that if they are placed next to each other - the interference due to spectrum overlap between them can be - considered negligible. - - In case of heterogeneous OTSi it is up to path computation - engine to determine the minimum distance between the carrier - frequency of the two adjacent OTSi."; - } - leaf available-fec-type { - type identityref { - base fec-type; - } - config false; - description "Available FEC"; - } - leaf fec-code-rate { - type decimal64 { - fraction-digits 8; - range "0..max"; - } - config false; - description "FEC-code-rate"; - } - leaf fec-threshold { - type decimal64 { - fraction-digits 8; - range "0..max"; - } - config false; - description - "Threshold on the BER, for which FEC - is able to correct errors"; - } - leaf in-band-osnr { - type snr; - config false; - description - "The OSNR defined within the bandwidth of the transmit - spectral excursion (i.e., between the nominal central - frequency of the channel and the -3.0dB points of the - transmitter spectrum furthest from the nominal central - frequency) measured at reference point Ss. - - The in-band OSNR is referenced to an optical bandwidth of - 0.1nm @ 193.7 THz or 12.5 GHz."; - reference - "OIF-400ZR-01.0: Implementation Agreement 400ZR"; - } - leaf out-of-band-osnr { - type snr; - config false; - description - "The ratio of the peak transmitter power to the integrated - power outside the transmitter spectral excursion. - - The spectral resolution of the measurement shall be better - than the maximum spectral width of the peak. - - The out-of-band OSNR is referenced to an optical bandwidth - of 0.1nm @ 193.7 THz or 12.5 GHz"; - reference - "OIF-400ZR-01.0: Implementation Agreement 400ZR"; - } - leaf tx-polarization-power-difference { - type power-in-db; - config false; - description - "The transmitter polarization dependent power difference - defined as the power difference between X and Y - polarizations"; - reference - "OIF-400ZR-01.0: Implementation Agreement 400ZR"; - } - leaf polarization-skew { - type decimal64 { - fraction-digits 2; - } - units "ps"; - config false; - description - "The X-Y skew, included as a fixed value in the receiver - polarization mode dispersion (PMD) tolerance limits."; - reference - "OIF-400ZR-01.0: Implementation Agreement 400ZR"; - } - } // grouping common-explicit-mode - - grouping common-organizational-explicit-mode { - description "Common capability attributes limit range - in case of operational mode and explicit mode. - These attributes are supported separately in - case of application codes"; - -/* transmitter tuning range (f_tx-min, f_tx-max) */ - - leaf min-central-frequency { - type frequency-thz; - config false; - description - "This parameter indicates the minimum frequency for the - transmitter tuning range."; - } - leaf max-central-frequency { - type frequency-thz; - config false; - description - "This parameter indicates the maximum frequency for the - transmitter tuning range."; - } - - leaf transceiver-tunability { - type frequency-ghz; - config false; - description - "This parameter indicates the transmitter frequency fine - tuning steps e.g 3.125GHz or 0.001GHz."; - } - -/* supported transmitter power range [p_tx-min, p_tx_max] */ - - leaf tx-channel-power-min { - type dbm-t; - config false; - description "The minimum output power of this interface"; - } - leaf tx-channel-power-max { - type dbm-t; - config false; - description "The maximum output power of this interface"; - } - -/* supported receiver power range [p_rx-min, p_rx_max] */ - - leaf rx-channel-power-min { - type dbm-t; - config false; - description "The minimum input power of this interface"; - } - leaf rx-channel-power-max { - type dbm-t; - config false; - description "The maximum input power of this interface"; - } - - leaf rx-total-power-max { - type dbm-t; - config false; - description "Maximum rx optical power for - all the channels"; - } - } // grouping common-organizational-explicit-mode - -/* This grouping represent the list of configured parameters */ -/* values independent of operational mode */ - - grouping common-transceiver-configured-param { - description "Capability of an optical transceiver"; - - leaf tx-channel-power { - type union { - type dbm-t; - type empty; - } - description "The current channel transmit power"; - } - leaf rx-channel-power { - type union { - type dbm-t; - type empty; - } - config false; - description "The current channel received power "; - } - leaf rx-total-power { - type union { - type dbm-t; - type empty; - } - config false; - description "Current total received power"; - } - } // grouping for configured attributes out of mode - - grouping l0-tunnel-attributes { - description - "Parameters for Layer0 (WSON or Flexi-Grid) Tunnels."; - leaf bit-stuffing { - type boolean; - description - "Bit stuffing enabled/disabled."; - } - leaf wavelength-assignment { - type identityref { - base wavelength-assignment; - } - description "Wavelength Allocation Method"; - } - } - - grouping frequency-range { - description - "This grouping defines the lower and upper bounds of a - frequency range (e.g., a band). - - This grouping SHOULD NOT be used to define a frequency slot, - which SHOULD be defined using the n and m values instead."; - leaf lower-frequency { - type frequency-thz; - mandatory true; - description - "The lower frequency boundary of the - frequency range."; - } - leaf upper-frequency { - type frequency-thz; - must '. > ../lower-frequency' { - error-message - "The upper frequency must be greater than the lower - frequency."; - } - mandatory true; - description - "The upper frequency boundary of the - frequency range."; - } - } - - grouping l0-path-constraints { - description - "Common attribute for Layer 0 path constraints to be used by - Layer 0 computation."; - leaf gsnr-margin { - type snr { - range 0..max; - } - default 0; - description - "An additional margin to be added to the OSNR-min of the - transceiver when checking the estimated received Generalized - SNR (GSNR)."; - } - } - - grouping l0-path-properties { - description - "Common attribute for reporting the Layer 0 computed path - properties."; - leaf estimated-gsnr { - type snr; - config false; - description - "The estimate received GSNR for the computed path."; - } - } -} -]]>
- -
-
Security Considerations - -The YANG module specified in this document defines a schema for data - that is designed to be accessed via network management protocols such - as NETCONF or RESTCONF . The lowest NETCONF layer - is the secure transport layer, and the mandatory-to-implement secure - transport is Secure Shell (SSH) . The lowest RESTCONF layer - is HTTPS, and the mandatory-to-implement secure transport is TLS - . - -The Network Configuration Access Control Model (NACM) - provides the means to restrict access for particular NETCONF or - RESTCONF users to a preconfigured subset of all available NETCONF or - RESTCONF protocol operations and content. The NETCONF protocol over - Secure Shell (SSH) specification describes a method for - invoking and running NETCONF within a Secure Shell (SSH) session as - an SSH subsystem. - -The objects in this YANG module are common data types and groupings. - No object in this module can be read or written to. These - definitions can be imported and used by other Layer 0 specific - modules. It is critical to consider how imported definitions will be - utilized and accessible via RPC operations, as the resultant schema - will have data nodes that can be writable, or readable, and will have - a significant effect on the network operations if used incorrectly or - maliciously. All of these considerations belong in the document that - defines the modules that import from this YANG module. Therefore, it - is important to manage access to resultant data nodes that are - considered sensitive or vulnerable in some network environments. - -The security considerations spelled out in the YANG 1.1 specification - apply for this document as well. - -
-
IANA Considerations - -For the following URI in the "IETF XML Registry" , IANA has updated the reference field to refer to this document: - -
- -This document also adds an updated YANG module to the "YANG Module -Names" registry : - -
- -RFC Editor Note: Please replace XXXX with the RFC number assigned to this document. - -
- - - - - - - - - - - - Amplified multichannel dense wavelength division multiplexing applications with single channel optical interfaces - - ITU-T Recommendation G.698.2 - - - - - - - - - - - -The YANG 1.1 Data Modeling Language - - -YANG is a data modeling language used to model configuration data, state data, Remote Procedure Calls, and notifications for network management protocols. This document describes the syntax and semantics of version 1.1 of the YANG language. YANG version 1.1 is a maintenance release of the YANG language, addressing ambiguities and defects in the original specification. There are a small number of backward incompatibilities from YANG version 1. This document also specifies the YANG mappings to the Network Configuration Protocol (NETCONF). - - - - - - - - - -Network Configuration Protocol (NETCONF) - - - - - -The Network Configuration Protocol (NETCONF) defined in this document provides mechanisms to install, manipulate, and delete the configuration of network devices. It uses an Extensible Markup Language (XML)-based data encoding for the configuration data as well as the protocol messages. The NETCONF protocol operations are realized as remote procedure calls (RPCs). This document obsoletes RFC 4741. [STANDARDS-TRACK] - - - - - - - - - -Framework for GMPLS and Path Computation Element (PCE) Control of Wavelength Switched Optical Networks (WSONs) - - - - -This document provides a framework for applying Generalized Multi-Protocol Label Switching (GMPLS) and the Path Computation Element (PCE) architecture to the control of Wavelength Switched Optical Networks (WSONs). In particular, it examines Routing and Wavelength Assignment (RWA) of optical paths.This document focuses on topological elements and path selection constraints that are common across different WSON environments; as such, it does not address optical impairments in any depth. This document is not an Internet Standards Track specification; it is published for informational purposes. - - - - - - - - - -Framework and Requirements for GMPLS-Based Control of Flexi-Grid Dense Wavelength Division Multiplexing (DWDM) Networks - - - - - - - -To allow efficient allocation of optical spectral bandwidth for systems that have high bit-rates, the International Telecommunication Union Telecommunication Standardization Sector (ITU-T) has extended its Recommendations G.694.1 and G.872 to include a new Dense Wavelength Division Multiplexing (DWDM) grid by defining a set of nominal central frequencies, channel spacings, and the concept of the "frequency slot". In such an environment, a data-plane connection is switched based on allocated, variable-sized frequency ranges within the optical spectrum, creating what is known as a flexible grid (flexi-grid).Given the specific characteristics of flexi-grid optical networks and their associated technology, this document defines a framework and the associated control-plane requirements for the application of the existing GMPLS architecture and control-plane protocols to the control of flexi-grid DWDM networks. The actual extensions to the GMPLS protocols will be defined in companion documents. - - - - - - - - - -Network Management Datastore Architecture (NMDA) - - - - - - -Datastores are a fundamental concept binding the data models written in the YANG data modeling language to network management protocols such as the Network Configuration Protocol (NETCONF) and RESTCONF. This document defines an architectural framework for datastores based on the experience gained with the initial simpler model, addressing requirements that were not well supported in the initial model. This document updates RFC 7950. - - - - - - - - - -Key words for use in RFCs to Indicate Requirement Levels - - -In many standards track documents several words are used to signify the requirements in the specification. These words are often capitalized. This document defines these words as they should be interpreted in IETF documents. This document specifies an Internet Best Current Practices for the Internet Community, and requests discussion and suggestions for improvements. - - - - - - - - - - -Ambiguity of Uppercase vs Lowercase in RFC 2119 Key Words - - -RFC 2119 specifies common key words that may be used in protocol specifications. This document aims to reduce the ambiguity by clarifying that only UPPERCASE usage of the key words have the defined special meanings. - - - - - - - - - - -OSPF Extensions in Support of Generalized Multi-Protocol Label Switching (GMPLS) - - - -This document specifies encoding of extensions to the OSPF routing protocol in support of Generalized Multi-Protocol Label Switching (GMPLS). [STANDARDS-TRACK] - - - - - - - - - -Generalized Labels for Lambda-Switch-Capable (LSC) Label Switching Routers - - - -Technology in the optical domain is constantly evolving, and, as a consequence, new equipment providing lambda switching capability has been developed and is currently being deployed.Generalized MPLS (GMPLS) is a family of protocols that can be used to operate networks built from a range of technologies including wavelength (or lambda) switching. For this purpose, GMPLS defined a wavelength label as only having significance between two neighbors. Global wavelength semantics are not considered.In order to facilitate interoperability in a network composed of next generation lambda-switch-capable equipment, this document defines a standard lambda label format that is compliant with the Dense Wavelength Division Multiplexing (DWDM) and Coarse Wavelength Division Multiplexing (CWDM) grids defined by the International Telecommunication Union Telecommunication Standardization Sector. The label format defined in this document can be used in GMPLS signaling and routing protocols. [STANDARDS-TRACK] - - - - - - - - - -Generalized Labels for the Flexi-Grid in Lambda Switch Capable (LSC) Label Switching Routers - - - - - -GMPLS supports the description of optical switching by identifying entries in fixed lists of switchable wavelengths (called grids) through the encoding of lambda labels. Work within the ITU-T Study Group 15 has defined a finer-granularity grid, and the facility to flexibly select different widths of spectrum from the grid. This document defines a new GMPLS lambda label format to support this flexi-grid.This document updates RFCs 3471 and 6205 by introducing a new label format. - - - - - - - - - -GMPLS OSPF-TE Extensions in Support of Flexi-Grid Dense Wavelength Division Multiplexing (DWDM) Networks - - - - - - -The International Telecommunication Union Telecommunication standardization sector (ITU-T) has extended its Recommendations G.694.1 and G.872 to include a new Dense Wavelength Division Multiplexing (DWDM) grid by defining channel spacings, a set of nominal central frequencies, and the concept of the "frequency slot". Corresponding techniques for data-plane connections are known as "flexi-grid".Based on the characteristics of flexi-grid defined in G.694.1 and in RFCs 7698 and 7699, this document describes the Open Shortest Path First - Traffic Engineering (OSPF-TE) extensions in support of GMPLS control of networks that include devices that use the new flexible optical grid. - - - - - - - - - -YANG Data Model for Traffic Engineering (TE) Topologies - - - - - - - -This document defines a YANG data model for representing, retrieving, and manipulating Traffic Engineering (TE) Topologies. The model serves as a base model that other technology-specific TE topology models can augment. - - - - - - - - - -Common YANG Data Types for Traffic Engineering - - - - - - -This document defines a collection of common data types and groupings in YANG data modeling language. These derived common types and groupings are intended to be imported by modules that model Traffic Engineering (TE) configuration and state capabilities. - - - - - - - - - -RESTCONF Protocol - - - - -This document describes an HTTP-based protocol that provides a programmatic interface for accessing data defined in YANG, using the datastore concepts defined in the Network Configuration Protocol (NETCONF). - - - - - - - - - -Using the NETCONF Protocol over Secure Shell (SSH) - - -This document describes a method for invoking and running the Network Configuration Protocol (NETCONF) within a Secure Shell (SSH) session as an SSH subsystem. This document obsoletes RFC 4742. [STANDARDS-TRACK] - - - - - - - - - -The Transport Layer Security (TLS) Protocol Version 1.3 - - -This document specifies version 1.3 of the Transport Layer Security (TLS) protocol. TLS allows client/server applications to communicate over the Internet in a way that is designed to prevent eavesdropping, tampering, and message forgery.This document updates RFCs 5705 and 6066, and obsoletes RFCs 5077, 5246, and 6961. This document also specifies new requirements for TLS 1.2 implementations. - - - - - - - - - -Network Configuration Access Control Model - - - -The standardization of network configuration interfaces for use with the Network Configuration Protocol (NETCONF) or the RESTCONF protocol requires a structured and secure operating environment that promotes human usability and multi-vendor interoperability. There is a need for standard mechanisms to restrict NETCONF or RESTCONF protocol access for particular users to a preconfigured subset of all available NETCONF or RESTCONF protocol operations and content. This document defines such an access control model.This document obsoletes RFC 6536. - - - - - - - - - - - - - - - - Spectral grids for WDM applications: DWDM frequency grid - - ITU-T Recommendation G.694.1 - - - - - - - - Spectral grids for WDM applications: CWDM wavelength grid - - ITU-T Recommendation G.694.2 - - - - - - - - - - - -A YANG Data Model for Layer 0 Types - - - - - - -This document defines a collection of common data types and groupings in the YANG data modeling language. These derived common types and groupings are intended to be imported by modules that model Layer 0 optical Traffic Engineering (TE) configuration and state capabilities such as Wavelength Switched Optical Networks (WSONs) and flexi-grid Dense Wavelength Division Multiplexing (DWDM) networks. - - - - - - - - - -Routing and Wavelength Assignment Information Model for Wavelength Switched Optical Networks - - - - - -This document provides a model of information needed by the Routing and Wavelength Assignment (RWA) process in Wavelength Switched Optical Networks (WSONs). The purpose of the information described in this model is to facilitate constrained optical path computation in WSONs. This model takes into account compatibility constraints between WSON signal attributes and network elements but does not include constraints due to optical impairments. Aspects of this information that may be of use to other technologies utilizing a GMPLS control plane are discussed. - - - - - - - - - -Routing and Wavelength Assignment Information Encoding for Wavelength Switched Optical Networks - - - - - - -A Wavelength Switched Optical Network (WSON) requires certain key information fields be made available to facilitate path computation and the establishment of Label Switched Paths (LSPs). The information model described in "Routing and Wavelength Assignment Information Model for Wavelength Switched Optical Networks" (RFC 7446) shows what information is required at specific points in the WSON. Part of the WSON information model contains aspects that may be of general applicability to other technologies, while other parts are specific to WSONs.This document provides efficient, protocol-agnostic encodings for the WSON-specific information fields. It is intended that protocol- specific documents will reference this memo to describe how information is carried for specific uses. Such encodings can be used to extend GMPLS signaling and routing protocols. In addition, these encodings could be used by other mechanisms to convey this same information to a Path Computation Element (PCE). - - - - - - - - - A YANG model to manage the optical interface parameters for an external transponder in a WDM network - - Cisco - - - Deutsche Telekom - - - Juniper - - - Juniper - - - - This memo defines a Yang model related to the Optical Transceiver - parameters characterising coherent 100G and above interfaces. 100G - and above Transceivers support coherent modulation, multiple - modulation formats, multiple FEC codes including some not yet - specified (or by in phase of specification by) ITU-T G.698.2 or any - other ITU-T recommendation. Use cases are described in RFC7698. - - The Yang model defined in this memo can be used for Optical - Parameters monitoring and/or configuration of the endpoints of a - multi-vendor IaDI optical link. The use of this model does not - guarantee interworking of transceivers over a DWDM. Optical path - feasibility and interoperability has to be determined by tools and - algorithms outside the scope of this document. The purpose of this - model is to program interface parameters to consistently configure - the mode of operation of transceivers. - - - - - - - - - - - - -The IETF XML Registry - - -This document describes an IANA maintained registry for IETF standards which use Extensible Markup Language (XML) related items such as Namespaces, Document Type Declarations (DTDs), Schemas, and Resource Description Framework (RDF) Schemas. - - - - - - - - - - - - -
Changes from RFC 9093 - -To be added in a future revision of this draft. - -
-
Acknowledgments - -The authors and the working group give their sincere thanks to Robert - Wilton for the YANG doctor review and Tom Petch for his comments - during the model and document development. - -This document was prepared using kramdown. - -
- -
- Contributors - - Cisco -
- ggalimbe@cisco.com -
- - - Nokia -
- Enrico.Griseri@nokia.com -
- - - Huawei -
- dhruv.ietf@gmail.com -
- - - ETRI -
- byyun@etri.re.kr -
- - - CTTC -
- ricard.vilalta@cttc.es -
- - - Samsung -
- younglee.tx@gmail.com -
- - - Nokia -
- victor.lopez@nokia.com -
- -
- - - - - - - diff --git a/ietf-layer0-types.yang b/ietf-layer0-types.yang index ab7d43e..8986d82 100644 --- a/ietf-layer0-types.yang +++ b/ietf-layer0-types.yang @@ -1069,12 +1069,21 @@ module ietf-layer0-types { type l0-types:flexi-n; description "The given value 'N' is used to determine the nominal - central frequency."; + central frequency. + + As described in section 3.1 of RFC 8363, the range of + available nominal central frequencies are advertised for + m=1, which means that for an available central frequency n, + the frequency slot from central frequency n-1 to central + frequency n+1 is available."; } reference "RFC 7698: Framework and Requirements for GMPLS-Based Control - of Flexi-Grid Dense Wavelength Division Multiplexing (DWDM) - Networks"; + of Flexi-Grid Dense Wavelength Division Multiplexing (DWDM) + Networks; + + RFC 8363: GMPLS OSPF-TE Extensions in Support of Flexi-Grid + Dense Wavelength Division Multiplexing (DWDM) Networks"; } grouping flexi-grid-frequency-slot { @@ -1518,7 +1527,8 @@ module ietf-layer0-types { list pdl-penalty { config false; description - "Optional penalty associated with a given accumulated polarization dependent loss (PDL) value. + "Optional penalty associated with a given accumulated + polarization dependent loss (PDL) value. This list of pair pdl and penalty values can be used to sample the function PDL = f(penalty).";