< draft-ietf-ccamp-dwdm-if-param-yang-00.txt   draft-ietf-ccamp-dwdm-if-param-yang-01.txt >
Internet Engineering Task Force G. Galimberti, Ed. Internet Engineering Task Force G. Galimberti, Ed.
Internet-Draft Cisco Internet-Draft Cisco
Intended status: Experimental R. Kunze Intended status: Experimental R. Kunze
Expires: September 27, 2019 Deutsche Telekom Expires: January 9, 2020 Deutsche Telekom
D. Hiremagalur, Ed. D. Hiremagalur, Ed.
G. Grammel, Ed. G. Grammel, Ed.
Juniper Juniper
March 26, 2019 July 8, 2019
A YANG model to manage the optical interface parameters for an external A YANG model to manage the optical interface parameters for an external
transponder in a WDM network transponder in a WDM network
draft-ietf-ccamp-dwdm-if-param-yang-00 draft-ietf-ccamp-dwdm-if-param-yang-01
Abstract Abstract
This memo defines a Yang model related to the Optical Transceiver This memo defines a Yang model related to the Optical Transceiver
parameters characterising coherent 100G and above interfaces. 100G parameters characterising coherent 100G and above interfaces. 100G
and above Transceivers support coherent modulation, multiple and above Transceivers support coherent modulation, multiple
modulation formats, multiple FEC codes including some not yet modulation formats, multiple FEC codes including some not yet
specified (or by in phase of specification by) ITU-T G.698.2 specified (or by in phase of specification by) ITU-T G.698.2
[ITU.G698.2] or any other ITU-T recommendation. More context about [ITU.G698.2] or any other ITU-T recommendation. More context about
the state of the Coherent transceivers is described in draft-many- the state of the Coherent transceivers is described in draft-many-
skipping to change at page 2, line 10 skipping to change at page 2, line 10
Internet-Drafts are working documents of the Internet Engineering Internet-Drafts are working documents of the Internet Engineering
Task Force (IETF). Note that other groups may also distribute Task Force (IETF). Note that other groups may also distribute
working documents as Internet-Drafts. The list of current Internet- working documents as Internet-Drafts. The list of current Internet-
Drafts is at https://datatracker.ietf.org/drafts/current/. Drafts is at https://datatracker.ietf.org/drafts/current/.
Internet-Drafts are draft documents valid for a maximum of six months Internet-Drafts are draft documents valid for a maximum of six months
and may be updated, replaced, or obsoleted by other documents at any and may be updated, replaced, or obsoleted by other documents at any
time. It is inappropriate to use Internet-Drafts as reference time. It is inappropriate to use Internet-Drafts as reference
material or to cite them other than as "work in progress." material or to cite them other than as "work in progress."
This Internet-Draft will expire on September 27, 2019. This Internet-Draft will expire on January 9, 2020.
Copyright Notice Copyright Notice
Copyright (c) 2019 IETF Trust and the persons identified as the Copyright (c) 2019 IETF Trust and the persons identified as the
document authors. All rights reserved. document authors. All rights reserved.
This document is subject to BCP 78 and the IETF Trust's Legal This document is subject to BCP 78 and the IETF Trust's Legal
Provisions Relating to IETF Documents Provisions Relating to IETF Documents
(https://trustee.ietf.org/license-info) in effect on the date of (https://trustee.ietf.org/license-info) in effect on the date of
publication of this document. Please review these documents publication of this document. Please review these documents
skipping to change at page 2, line 40 skipping to change at page 2, line 40
2. The Internet-Standard Management Framework . . . . . . . . . 3 2. The Internet-Standard Management Framework . . . . . . . . . 3
3. Conventions . . . . . . . . . . . . . . . . . . . . . . . . . 4 3. Conventions . . . . . . . . . . . . . . . . . . . . . . . . . 4
4. Overview . . . . . . . . . . . . . . . . . . . . . . . . . . 4 4. Overview . . . . . . . . . . . . . . . . . . . . . . . . . . 4
4.1. Optical Parameters Description . . . . . . . . . . . . . 5 4.1. Optical Parameters Description . . . . . . . . . . . . . 5
4.1.1. Parameters at Ss . . . . . . . . . . . . . . . . . . 5 4.1.1. Parameters at Ss . . . . . . . . . . . . . . . . . . 5
4.1.2. Interface at point Rs . . . . . . . . . . . . . . . . 5 4.1.2. Interface at point Rs . . . . . . . . . . . . . . . . 5
4.2. Use Cases . . . . . . . . . . . . . . . . . . . . . . . . 5 4.2. Use Cases . . . . . . . . . . . . . . . . . . . . . . . . 5
4.3. Optical Interface for external transponder in a WDM 4.3. Optical Interface for external transponder in a WDM
network . . . . . . . . . . . . . . . . . . . . . . . . . 5 network . . . . . . . . . . . . . . . . . . . . . . . . . 5
5. Structure of the Yang Module . . . . . . . . . . . . . . . . 7 5. Structure of the Yang Module . . . . . . . . . . . . . . . . 7
6. Yang Module . . . . . . . . . . . . . . . . . . . . . . . . . 7 6. Yang Module . . . . . . . . . . . . . . . . . . . . . . . . . 8
7. Security Considerations . . . . . . . . . . . . . . . . . . . 19 7. Security Considerations . . . . . . . . . . . . . . . . . . . 20
8. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 20 8. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 20
9. Acknowledgements . . . . . . . . . . . . . . . . . . . . . . 20 9. Acknowledgements . . . . . . . . . . . . . . . . . . . . . . 21
10. Contributors . . . . . . . . . . . . . . . . . . . . . . . . 20 10. Contributors . . . . . . . . . . . . . . . . . . . . . . . . 21
11. References . . . . . . . . . . . . . . . . . . . . . . . . . 22 11. References . . . . . . . . . . . . . . . . . . . . . . . . . 22
11.1. Normative References . . . . . . . . . . . . . . . . . . 22 11.1. Normative References . . . . . . . . . . . . . . . . . . 22
11.2. Informative References . . . . . . . . . . . . . . . . . 24 11.2. Informative References . . . . . . . . . . . . . . . . . 24
Appendix A. Change Log . . . . . . . . . . . . . . . . . . . . . 24 Appendix A. Change Log . . . . . . . . . . . . . . . . . . . . . 24
Appendix B. Open Issues . . . . . . . . . . . . . . . . . . . . 24 Appendix B. Open Issues . . . . . . . . . . . . . . . . . . . . 24
Authors' Addresses . . . . . . . . . . . . . . . . . . . . . . . 25 Authors' Addresses . . . . . . . . . . . . . . . . . . . . . . . 25
1. Introduction 1. Introduction
This memo defines a Yang model that translates and obsolete the SNMP This memo defines a Yang model that translates and obsolete the SNMP
mib module defined in draft-galikunze-ccamp-dwdm-if-snmp-mib for mib module defined in draft-galikunze-ccamp-dwdm-if-snmp-mib for
managing single channel optical interface parameters of DWDM managing single channel optical interface parameters of DWDM
applications, using the approach specified in G.698.2. This model applications, using the approach specified in G.698.2. This model
supports parameters to characterize coherent transceivers found in supports parameters to characterize coherent transceivers found in
current implementations to specify the mode of operation. As current implementations to specify the mode of operation. As
application identifiers like those specified in ITU-T G.874.1 application identifiers like those specified in ITU-T G.874.1
[ITU.G874.1] are not avaiable we use mode templates instead. A mode [ITU.G874.1] are not available we use mode templates instead. A mode
template describes transceiver characteristics in detail and can be template describes transceiver characteristics in detail and can be
identified by a mode-id. identified by a mode-id.
This draft refers and supports the RFC7698 and draft-many-coherent- This draft refers and supports the RFC7698 and draft-many-coherent-
DWDM-if-control. DWDM-if-control.
The YANG model describing and extending the optical parameters allows The YANG model describing and extending the optical parameters allows
different vendors and operators to retrieve, provision and exchange different vendors and operators to retrieve, provision and exchange
information across the multi-vendor IaDI interfaces in an abstract information across the multi-vendor IaDI interfaces in an abstract
manner. manner.
skipping to change at page 6, line 5 skipping to change at page 6, line 5
allows the user to set the operating mode of transceivers as well as allows the user to set the operating mode of transceivers as well as
other operational parameters. The module provides also treshold other operational parameters. The module provides also treshold
settings and notifications to supervise measured parameters and settings and notifications to supervise measured parameters and
notify the client. notify the client.
module: ietf-ext-xponder-wdm-if module: ietf-ext-xponder-wdm-if
augment /if:interfaces/if:interface: augment /if:interfaces/if:interface:
+--rw optIfOChRsSs +--rw optIfOChRsSs
+--rw if-current-mode +--rw if-current-mode
| +--ro mode-id? string | +--ro mode-id? string
| +--ro application-identifer? string | +--ro application-identifier? string
| +--ro min-central-frequency? uint32 | +--ro min-central-frequency? uint32
| +--ro max-central-frequency? uint32 | +--ro max-central-frequency? uint32
| +--ro min-input-power? dbm-t | +--ro min-input-power? dbm-t
| +--ro max-input-power? dbm-t | +--ro max-input-power? dbm-t
| +--ro min-output-power? dbm-t | +--ro min-output-power? dbm-t
| +--ro max-output-power? dbm-t | +--ro max-output-power? dbm-t
| +--ro min-osnr-margin? int32 | +--ro min-osnr-margin? int32
| +--ro min-q-margin? int32 | +--ro min-q-margin? int32
| +--ro fec-info? string | +--ro fec-info? string
| +--ro fec-bitrate? string | +--ro fec-bitrate? string
skipping to change at page 6, line 36 skipping to change at page 6, line 36
| +--ro bits-per-symbol? uint32 | +--ro bits-per-symbol? uint32
| +--ro num-symbols-in-alphabet? uint32 | +--ro num-symbols-in-alphabet? uint32
| +--ro symbols-index? uint32 | +--ro symbols-index? uint32
+--ro if-supported-mode +--ro if-supported-mode
| +--ro number-of-modes-supported? uint32 | +--ro number-of-modes-supported? uint32
| +--ro mode-list* [mode-id] | +--ro mode-list* [mode-id]
| +--ro mode-id? string | +--ro mode-id? string
| +--ro application-identifer? string | +--ro application-identifer? string
| +--ro min-central-frequency? uint32 | +--ro min-central-frequency? uint32
| +--ro max-central-frequency? uint32 | +--ro max-central-frequency? uint32
| +--ro min-input-power? dbm-t | +--ro min-channel-input-power? dbm-t
| +--ro max-input-power? dbm-t | +--ro max-channel-input-power? dbm-t
| +--ro min-output-power? dbm-t | +--ro min-channel-output-power? dbm-t
| +--ro max-output-power? dbm-t | +--ro max-channel-output-power? dbm-t
| +--ro min-osnr-margin? int32 | +--ro min-osnr-margin? int32
| +--ro min-q-margin? int32 | +--ro min-q-margin? int32
| +--ro fec-info? string | +--ro fec-info? string
| +--ro fec-bitrate? string | +--ro fec-bitrate? string
| +--ro fec-gain? string | +--ro fec-gain? string
| +--ro fec-ber-mantissa-threshold? uint32 | +--ro pre-fec-ber-mantissa-threshold? uint32
| +--ro fec-ber-exponent-threshold? int32 | +--ro pre-fec-ber-exponent-threshold? int32
| +--ro number-of-lanes? uint32 | +--ro number-of-lanes? uint32
| +--ro min-laser-temperature? int32 | +--ro min-laser-temperature? int32
| +--ro max-laser-temperature? int32 | +--ro max-laser-temperature? int32
| +--ro max-total-rx-optical-power? dbm-t | +--ro max-total-rx-optical-power? dbm-t
| +--ro max-chromatic-dispersion? int32 | +--ro max-chromatic-dispersion? int32
| +--ro max-diff-group-delay? int32 | +--ro max-diff-group-delay? int32
| +--ro modulation-format? string | +--ro modulation-format? string
| +--ro baud-rate? string
| +--ro bits-per-symbol? uint32 | +--ro bits-per-symbol? uint32
| +--ro num-symbols-in-alphabet? uint32 | +--ro num-symbols-in-alphabet? uint32
| +--ro symbols-index? uint32 | +--ro symbols-index? uint32
+--rw current-opt-if-och-mode-params +--rw current-opt-if-och-mode-params
+--rw mode-id? string +--rw mode-id? string
+--rw central-frequency? uint32 +--rw central-frequency? uint32
+--rw output-power? int32 +--rw channel-output-power? int32
+--ro input-power? int32 +--ro channel-input-power? int32
+--ro total-input-power? int32
+--rw min-fec-ber-mantissa-threshold? uint32 +--rw min-fec-ber-mantissa-threshold? uint32
+--rw min-fec-ber-exponent-threshold? int32 +--rw min-fec-ber-exponent-threshold? int32
+--rw max-fec-ber-mantissa-threshold? uint32 +--rw max-fec-ber-mantissa-threshold? uint32
+--rw max-fec-ber-exponent-threshold? int32 +--rw max-fec-ber-exponent-threshold? int32
+--rw number-of-tcas-supported? uint32 +--rw number-of-tcas-supported? uint32
+--rw mode-list* [tca-type] +--rw mode-list* [tca-type]
| +--rw tca-type opt-if-och-tca-types | +--rw tca-type opt-if-och-tca-types
| +--rw min-threshold? int32 | +--rw min-threshold? int32
| +--rw max-threshold? int32 | +--rw max-threshold? int32
+--ro cur-osnr? int32 +--ro cur-osnr? int32
+--ro cur-q-factor? int32 +--ro cur-q-factor? int32
+--ro uncorrected-words? uint64 +--ro uncorrected-words? uint64
+--ro fec-ber-mantissa? uint32 +--ro pre-fec-ber-mantissa? uint32
+--ro fec-ber-exponent? int32 +--ro pre-fec-ber-exponent? int32
notifications: notifications:
+---n opt-if-och-central-frequency-change +---n opt-if-och-central-frequency-change
| +--ro if-name? -> /if:interfaces/interface/name | +--ro if-name? -> /if:interfaces/interface/name
| +--ro new-opt-if-och-central-frequency | +--ro new-opt-if-och-central-frequency
| +--ro central-frequency? uint32 | +--ro central-frequency? uint32
+---n opt-if-och-mode-change +---n opt-if-och-mode-change
| +--ro if-name? -> /if:interfaces/interface/name | +--ro if-name? -> /if:interfaces/interface/name
| +--ro mode-id? string | +--ro mode-id? string
+---n opt-if-och-min-tca +---n opt-if-och-min-tca
skipping to change at page 8, line 40 skipping to change at page 8, line 45
Copyright (c) 2016 IETF Trust and the persons identified Copyright (c) 2016 IETF Trust and the persons identified
as authors of the code. All rights reserved. as authors of the code. All rights reserved.
Redistribution and use in source and binary forms, with or Redistribution and use in source and binary forms, with or
without modification, is permitted pursuant to, and without modification, is permitted pursuant to, and
subject to the license terms contained in, the Simplified subject to the license terms contained in, the Simplified
BSD License set forth in Section 4.c of the IETF Trust's BSD License set forth in Section 4.c of the IETF Trust's
Legal Provisions Relating to IETF Documents Legal Provisions Relating to IETF Documents
(http://trustee.ietf.org/license-info)."; (http://trustee.ietf.org/license-info).";
revision "2019-07-08" {
description
"Revision 1.2";
reference
"";
revision "2018-10-22" { revision "2018-10-22" {
description description
"Revision 1.2"; "Revision 1.2";
reference reference
""; "";
} }
revision "2018-03-06" { revision "2018-03-06" {
description description
"Revision 1.1"; "Revision 1.1";
skipping to change at page 10, line 39 skipping to change at page 11, line 4
} }
enum min-q-tca{ enum min-q-tca{
description "Min Q tca"; description "Min Q tca";
} }
enum max-q-tca { enum max-q-tca {
description "Max Q tca"; description "Max Q tca";
} }
} }
description " The different types of TCA's"; description " The different types of TCA's";
} }
grouping opt-if-och-power { grouping opt-if-och-power {
description "Interface optical Power"; description "Interface optical Power";
leaf output-power { leaf channel-output-power {
type int32; type int32;
units ".01dbm"; units ".01dbm";
description "The output power for this interface description "The output power for this interface
in .01 dBm. in .01 dBm.
The setting of the output power is The setting of the output power is
optional"; optional";
} }
leaf input-power { leaf channel-input-power {
type int32; type int32;
units ".01dbm"; units ".01dbm";
config false; config false;
description "The current input power of this description "The current channel input power of this
interface";
}
leaf total-input-power {
type int32;
units ".01dbm";
config false;
description "The total input power of this
interface"; interface";
} }
} }
grouping opt-if-och-tca-thresholds { grouping opt-if-och-tca-thresholds {
description "Thresholds for TCA's"; description "Thresholds for TCA's";
leaf tca-type { leaf tca-type {
type opt-if-och-tca-types; type opt-if-och-tca-types;
description "type of the TCA eg TX Power"; description "type of the TCA eg TX Power";
} }
skipping to change at page 12, line 4 skipping to change at page 12, line 23
type string { type string {
length "1..255"; length "1..255";
} }
config false; config false;
description description
"Fec Overhead rate "; "Fec Overhead rate ";
} }
leaf fec-gain { leaf fec-gain {
type string { type string {
length "1..255"; length "1..255";
} }
config false; config false;
description description
"Fec Overhead rate "; "Fec Overhead rate ";
} }
leaf fec-ber-mantissa-threshold { leaf pre-fec-ber-mantissa-threshold {
type uint32; type uint32;
description " Mantissa of the FEC BER threshold"; description " Mantissa of the FEC BER threshold";
} }
leaf fec-ber-exponent-threshold { leaf pre-fec-ber-exponent-threshold {
type int32; type int32;
description " Exponent of the FEC BER threshold"; description " Exponent of the FEC BER threshold";
} }
} }
grouping opt-if-och-central-frequency { grouping opt-if-och-central-frequency {
description "Interface Central Frequency"; description "Interface Central Frequency";
leaf central-frequency { leaf central-frequency {
type uint32; type uint32;
description " This parameter indicates the frequency description " This parameter indicates the frequency
skipping to change at page 12, line 42 skipping to change at page 13, line 13
grouping opt-if-och-modulation-params { grouping opt-if-och-modulation-params {
description "Optical modulation parameters for the lane"; description "Optical modulation parameters for the lane";
leaf modulation-format { leaf modulation-format {
type string { type string {
length "1..255"; length "1..255";
} }
config false; config false;
description description
"Modulation format for this mode"; "Modulation format for this mode";
} }
leaf baud-rate {
type uinte32
description
"Baud-rate or symbol rate";
}
leaf bits-per-symbol { leaf bits-per-symbol {
type uint32; type uint32;
description " This parameter the bits per symbol for description " This parameter the bits per symbol for
this mode."; this mode.";
} }
leaf num-symbols-in-alphabet { leaf num-symbols-in-alphabet {
type uint32; type uint32;
description " This parameter the bits per symbol for description " This parameter the bits per symbol for
this mode."; this mode.";
skipping to change at page 15, line 4 skipping to change at page 15, line 30
type uint32; type uint32;
description " Max Mantissa of the FEC BER threshold"; description " Max Mantissa of the FEC BER threshold";
} }
leaf max-fec-ber-exponent-threshold { leaf max-fec-ber-exponent-threshold {
type int32; type int32;
description " Max Exponent of the FEC BER threshold"; description " Max Exponent of the FEC BER threshold";
} }
} }
grouping opt-if-och-mode-params { grouping opt-if-och-mode-params {
description "OCh mode parameters."; description "OCh mode parameters.";
leaf mode-id { leaf mode-id {
type string { type string {
length "1..255"; length "1..255";
} }
description description
"Id for the OCh mode template"; "Id for the OCh mode template";
} }
leaf osnr-margin { leaf min-osnr-margin {
type int32; type int32;
units "dB"; units "dB";
config false; config false;
description " OSNR margin to FEC threshold"; description " OSNR margin to FEC threshold";
} }
leaf q-margin { leaf q-margin {
type int32; type int32;
units "dB"; units "dB";
config false; config false;
description " Q-Factor margin to FEC threshold"; description " Q-Factor margin to FEC threshold";
skipping to change at page 15, line 51 skipping to change at page 16, line 31
type int32; type int32;
units "dB"; units "dB";
config false; config false;
description " Q-Factor of the interface"; description " Q-Factor of the interface";
} }
leaf uncorrected-words { leaf uncorrected-words {
type uint64; type uint64;
config false; config false;
description " Post FEC errored words"; description " Post FEC errored words";
} }
leaf fec-ber-mantissa { leaf pre-fec-ber-mantissa {
type uint32; type uint32;
config false; config false;
description " Pre fec FEC errored words mantissa"; description " Pre fec FEC errored words mantissa";
} }
leaf fec-ber-exponent { leaf pre-fec-ber-exponent {
type int32; type int32;
config false; config false;
description " Pre fec FEC errored words exponent"; description " Pre fec FEC errored words exponent";
} }
} }
grouping opt-if-och-mode { grouping opt-if-och-mode {
description "OCh mode template."; description "OCh mode template.";
leaf mode-id { leaf mode-id {
type string { type string {
skipping to change at page 16, line 44 skipping to change at page 17, line 23
config false; config false;
description "This parameter indicates the minimum description "This parameter indicates the minimum
frequency for this template "; frequency for this template ";
} }
leaf max-central-frequency { leaf max-central-frequency {
type uint32; type uint32;
config false; config false;
description "This parameter indicates the minimum description "This parameter indicates the minimum
frequency for this template "; frequency for this template ";
} }
leaf min-input-power { leaf min-channel-input-power {
type dbm-t; type dbm-t;
config false; config false;
description "The minimum input power of this description "The minimum input power of this
interface"; interface";
} }
leaf max-input-power { leaf max-channel-input-power {
type dbm-t; type dbm-t;
config false; config false;
description "The maximum input power of this description "The maximum input power of this
interface"; interface";
} }
leaf min-output-power { leaf min-channel-output-power {
type dbm-t; type dbm-t;
config false; config false;
description "The minimum output power of this description "The minimum output power of this
interface"; interface";
} }
leaf max-output-power { leaf max-channel-output-power {
type dbm-t; type dbm-t;
config false; config false;
description "The maximum output power of this description "The maximum output power of this
interface"; interface";
} }
leaf osnr-margin { leaf osnr-margin {
type int32; type int32;
units "dB"; units "dB";
config false; config false;
description "OSNR margin to FEC threshold"; description "OSNR margin to FEC threshold";
 End of changes. 30 change blocks. 
34 lines changed or deleted 53 lines changed or added

This html diff was produced by rfcdiff 1.47. The latest version is available from http://tools.ietf.org/tools/rfcdiff/