openconfig-terminal-device-properties

openconfig-version: 0.1.1

Description

Module to extend OpenConfig terminal device's operational modes' data. It supports operational modes for one Optical Channel, with a single OTSi. The operational mode includes key attributes such modulation format, symbol rate, nominal central frequency (NFC) tunability constraints (grid, min/max NCF), FEC gain, minimum and maximum output power of the transmitter or minimum OSNR at the receiver as well as the spectrum width of the OTSi (OTSiMC). It also includes (optional) aspects such as filter characterization, CD and DGD tolerance.

Imports

openconfig-extensions
openconfig-transport-types
openconfig-terminal-device-property-types

Data elements

/
operational-modes

description:
Indicates the transceiver's list of supported operational modes and its associated transmission features

nodetype: container (ro)

/operational-modes/
mode-descriptor

description:
List of operational modes supported by the platform. The operational mode provides a platform-defined summary of information such as symbol rate, modulation, pulse shaping, etc.

nodetype: list (ro)

list keys: [mode-id]

/operational-modes/mode-descriptor/
mode-id

description:
Reference to mode-id

nodetype: leaf (list key) (ro)

type: leafref

  • path reference: ../state/mode-id

/operational-modes/mode-descriptor/
state

description:
Static features or properties which characterize the operational mode.

nodetype: container (ro)

/operational-modes/mode-descriptor/state/
mode-id

description:
Two-octet encoding of the vendor-defined operational mode

nodetype: leaf (ro)

type: uint16

/operational-modes/mode-descriptor/state/
mode-type

description:
Indicates whether the transceiver's mode is a standard mode, an organizational mode or an explicit mode.

nodetype: leaf (ro)

type: identityref

  • base: oc-opt-term-prop-types:TRANSCEIVER_MODE_TYPE

/operational-modes/mode-descriptor/
G.698.2

description:
ITU-T G.698.2 (11/18) 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 G.698.2 (11/18) recommendation.

nodetype: container (ro)

/operational-modes/mode-descriptor/G.698.2/
state

description:
Operational-mode standard mode state top container.

nodetype: container (ro)

/operational-modes/mode-descriptor/G.698.2/state/
standard-mode

description:
G.698.2 (11/18) standard mode

nodetype: leaf (ro)

type: oc-opt-term-prop-types:standard-mode

/operational-modes/mode-descriptor/
explicit-mode

description:
Explicit definition of the operational-mode. Typically this is used for non-standard/proprietary modes defined by the terminal-device vendor and it is self-described by the capabilities included in the subtree underneath.

nodetype: container (ro)

/operational-modes/mode-descriptor/explicit-mode/
operational-mode-capabilities

description:
Set of attributes which characterizes the operational-mode for optimal optical-channel transmission and receiver functions. This attributes are intending to describe all the relevant data used during the network planning phase, to estimate the physical-impairment tolerances which can be introduced by the DWDM optical path, while assuring optimal transmission function.

nodetype: container (ro)

/operational-modes/mode-descriptor/explicit-mode/operational-mode-capabilities/
state

description:
Operational-mode explicit mode capabilities state container.

nodetype: container (ro)

/operational-modes/mode-descriptor/explicit-mode/operational-mode-capabilities/state/
modulation-format

description:
Optical modulation format associated to the mode. The modulation format associated to the optical signal.

nodetype: leaf (ro)

type: union

    type: string

    type: oc-opt-term-prop-types:modulation-format

/operational-modes/mode-descriptor/explicit-mode/operational-mode-capabilities/state/
bit-rate

description:
Rounded bit rate of the tributary signal delivered by the optical channel associated to the specific operational mode. Exact bit rate will be refined by protocol selection at the associated tributary logical channel.

nodetype: leaf (ro)

type: oc-opt-term-prop-types:bit-rate

/operational-modes/mode-descriptor/explicit-mode/operational-mode-capabilities/state/
baud-rate

description:
Baud-rate or symbol rate.

nodetype: leaf (ro)

type: decimal64

units: Bd

/operational-modes/mode-descriptor/explicit-mode/operational-mode-capabilities/state/
optical-channel-spectrum-width

description:
Spectrum width of the optical channel associated to this operational mode, calculated as the baud-rate*(1+roll-off).

nodetype: leaf (ro)

type: decimal64

units: GHz

/operational-modes/mode-descriptor/explicit-mode/operational-mode-capabilities/state/
min-tx-osnr

description:
Minimum in-band transmitter OSNR measured at 0.1nm@193.6Thz, considering the maximum transceiver inserted noise.

nodetype: leaf (ro)

type: decimal64

units: dB

/operational-modes/mode-descriptor/explicit-mode/operational-mode-capabilities/state/
min-rx-osnr

description:
Minimum back-to-back OSNR measured over 0.1nm@193.6Thz or 12.5GHz noise resolution bandwidth at the min-input-power. If received OSNR at min-input-power is lower than this value, an increased level of bit-errors post-FEC needs to be expected.

nodetype: leaf (ro)

type: decimal64

units: dB

/operational-modes/mode-descriptor/explicit-mode/operational-mode-capabilities/state/
min-input-power

description:
Minimum value required input power in dBm of an optical channel at the receiver (Rx) according to the given min-rx-osnr value. If the input-power is lower it is expected to introduce an OSNR penalty.

nodetype: leaf (ro)

type: decimal64

units: dBm

/operational-modes/mode-descriptor/explicit-mode/operational-mode-capabilities/state/
max-input-power

description:
Maximum tolerated input power in dBm at the receiver (Rx) of the coherence transceiver, which if exceeded can cause an overload.

nodetype: leaf (ro)

type: decimal64

units: dBm

/operational-modes/mode-descriptor/explicit-mode/operational-mode-capabilities/state/
max-chromatic-dispersion

description:
Maximum chromatic-dispersion, accumulated value, supported by the optical channel associated to the associated transmission mode (operational model), expressed in picoseconds / nanometer (ps/nm).

nodetype: leaf (ro)

type: decimal64

units: ps-nm

/operational-modes/mode-descriptor/explicit-mode/operational-mode-capabilities/state/
max-differential-group-delay

description:
Maximum differential-group-delay, absolute value, supported by the optical channel associated to the associated tranmission mode (operational model), expressed in picoseconds (ps).

nodetype: leaf (ro)

type: decimal64

units: ps

/operational-modes/mode-descriptor/explicit-mode/operational-mode-capabilities/state/
max-polarization-dependent-loss

description:
Maximum polarization-dependent-loss accumulated value, supported by the optical channel associated to the associated transmission mode (operational model), expressed in decibels (dB)

nodetype: leaf (ro)

type: decimal64

units: dB

/operational-modes/mode-descriptor/explicit-mode/operational-mode-capabilities/
fec

description:
The Forward Error Coding (FEC) coding schema used, including the name, overhead, pre-fec-ber threshold and gain properties.

nodetype: container (ro)

/operational-modes/mode-descriptor/explicit-mode/operational-mode-capabilities/fec/
state

description:
FEC state attributes top container.

nodetype: container (ro)

/operational-modes/mode-descriptor/explicit-mode/operational-mode-capabilities/fec/state/
fec-coding

description:
Forward error correction (FEC) coding schema used in the transmission mode. Type union of string (for proprietary codes) and a set of standard codes encoded as identity references

nodetype: leaf (ro)

type: union

    type: string

    type: oc-opt-term-prop-types:fec-coding

/operational-modes/mode-descriptor/explicit-mode/operational-mode-capabilities/fec/state/
coding-overhead

description:
Coding overhead rate in %.

nodetype: leaf (ro)

type: decimal64

/operational-modes/mode-descriptor/explicit-mode/operational-mode-capabilities/fec/state/
coding-gain

description:
Net coding gain (NCG) in dB units at 10E-15 bit error rate. It may vary depending on the modulation format used in the associated transmission mode (operational-mode).

nodetype: leaf (ro)

type: decimal64

default: 0.00

units: dB

/operational-modes/mode-descriptor/explicit-mode/operational-mode-capabilities/fec/state/
pre-fec-ber-threshold

description:
Threshold on the PRE-FEC-BER, for which FEC code is able to correct errors.

nodetype: leaf (ro)

type: decimal64

units: bit-errors-per-second

/operational-modes/mode-descriptor/explicit-mode/operational-mode-capabilities/
penalties

description:
Enconsing list's container.

nodetype: container (ro)

/operational-modes/mode-descriptor/explicit-mode/operational-mode-capabilities/penalties/
penalty

description:
Penalties includes contributions from different impairments including cd, pmd, low RX Power, pdl,... - For parameter values below lowest up-to-boundary value, the penalty is 0. - For parameter values between lowest and highest up-to-boundary values, penalty could be linearly interpolated. - For parameter values above highest up-to-boundary value, the penalty is the one included within penalty-value attribute associated to the highest up-to-boundary

nodetype: list (ro)

list keys: [parameter-and-unit] [up-to-boundary]

/operational-modes/mode-descriptor/explicit-mode/operational-mode-capabilities/penalties/penalty/
parameter-and-unit

description:
Impairment and unit leading to the penalty (i.e., cd-ps)

nodetype: leaf (list key) (ro)

type: leafref

  • path reference: ../state/parameter-and-unit

/operational-modes/mode-descriptor/explicit-mode/operational-mode-capabilities/penalties/penalty/
up-to-boundary

description:
defines the upper (for positive values) and lower (for negative values) limit for which the penalty value is valid.

nodetype: leaf (list key) (ro)

type: leafref

  • path reference: ../state/up-to-boundary

/operational-modes/mode-descriptor/explicit-mode/operational-mode-capabilities/penalties/penalty/
state

description:
Penalties list element's state attributes top container.

nodetype: container (ro)

/operational-modes/mode-descriptor/explicit-mode/operational-mode-capabilities/penalties/penalty/state/
parameter-and-unit

description:
Impairment and unit leading to the penalty (i.e., cd-ps)

nodetype: leaf (ro)

type: oc-opt-term-prop-types:impairment-type

/operational-modes/mode-descriptor/explicit-mode/operational-mode-capabilities/penalties/penalty/state/
up-to-boundary

description:
defines the upper (for positive values) and lower (for negative values) limit for which the penalty value is valid.

nodetype: leaf (ro)

type: decimal64

/operational-modes/mode-descriptor/explicit-mode/operational-mode-capabilities/penalties/penalty/state/
penalty-value

description:
OSNR penalty associated to the given values, expressed in dB.

nodetype: leaf (ro)

type: decimal64

units: dB

/operational-modes/mode-descriptor/explicit-mode/operational-mode-capabilities/
filter

description:
This container includes information which characterises the filter at transceiver transmission for the given operational-mode.

nodetype: container (ro)

/operational-modes/mode-descriptor/explicit-mode/operational-mode-capabilities/filter/
state

description:
Filter's state attributes top container.

nodetype: container (ro)

/operational-modes/mode-descriptor/explicit-mode/operational-mode-capabilities/filter/state/
pulse-shaping-type

description:
Pulse/spectral shaping type such as Raised-cosine (RC), root-raised-cosine (RRC) and OFF. The attribute allows other pulse-shaping types to be encoded as strings.

nodetype: leaf (ro)

type: union

    type: string

    type: oc-opt-term-prop-types:pulse-shaping-type

/operational-modes/mode-descriptor/explicit-mode/operational-mode-capabilities/filter/state/
roll-off

description:
Decimal fraction between 0 and 1. Roll-off parameter (𝛽) of the TX pulse shaping filter. This assumes a raised-cosine filter

nodetype: leaf (ro)

type: decimal64

/operational-modes/mode-descriptor/explicit-mode/
optical-channel-config-value-constraints

description:
Set of constraints of the configuration attributes of the optical-channel associated to the selected operational-mode.

nodetype: container (ro)

/operational-modes/mode-descriptor/explicit-mode/optical-channel-config-value-constraints/
state

description:
Operational-mode explicit mode config value constrains state top container.

nodetype: container (ro)

/operational-modes/mode-descriptor/explicit-mode/optical-channel-config-value-constraints/state/
min-central-frequency

description:
The lowest configurable central frequency in MHz.

nodetype: leaf (ro)

type: oc-opt-types:frequency-type

/operational-modes/mode-descriptor/explicit-mode/optical-channel-config-value-constraints/state/
max-central-frequency

description:
The highest configurable central frequency in MHz.

nodetype: leaf (ro)

type: oc-opt-types:frequency-type

/operational-modes/mode-descriptor/explicit-mode/optical-channel-config-value-constraints/state/
grid-type

description:
Frequency ITU-T G.694.1 (10/2020) grid specification attribute.

nodetype: leaf (ro)

type: oc-opt-term-prop-types:grid-type

/operational-modes/mode-descriptor/explicit-mode/optical-channel-config-value-constraints/state/
adjustment-granularity

description:
Adjustment granularity in Gigahertz. As per ITU-T G.694.1 (10/2020), it is used to calculate nominal central frequency of an optical channel. It defines the minimum granularity supporting by the optical channel's central frequency setting.

nodetype: leaf (ro)

type: oc-opt-term-prop-types:adjustment-granularity

/operational-modes/mode-descriptor/explicit-mode/optical-channel-config-value-constraints/state/
min-channel-spacing

description:
Minimum recommended spectrum spacing between the central frequency of two adjacent optical channels of the same mode. In case of two adjacent optical channels with different operational-modes, it is up to the path computation engine to determine the minimum distance between the central frequencies of these two optical channels.

nodetype: leaf (ro)

type: decimal64

units: GHz

/operational-modes/mode-descriptor/explicit-mode/optical-channel-config-value-constraints/state/
min-output-power

description:
Minimum target output optical power level of the optical channel, configurable according to the optical transceiver mode properties, expressed in increments of 0.01 dBm (decibel-milliwats)

nodetype: leaf (ro)

type: decimal64

units: dBm

/operational-modes/mode-descriptor/explicit-mode/optical-channel-config-value-constraints/state/
max-output-power

description:
Maximum target output optical power level of the optical channel, configurable according to the optical transceiver mode properties, expressed in increments of 0.01 dBm (decibel-milliwatts)

nodetype: leaf (ro)

type: decimal64

units: dBm