generated/vdsl2lineconfigurationextensions2.go

/*
 * Copyright (c) 2018 - present.  Boling Consulting Solutions (bcsw.net)
 * Copyright 2020-present Open Networking Foundation

 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at

 * http://www.apache.org/licenses/LICENSE-2.0

 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */
 /*
 * NOTE: This file was generated, manual edits will be overwritten!
 *
 * Generated by 'goCodeGenerator.py':
 *              https://github.com/cboling/OMCI-parser/README.md
 */

package generated

import "github.com/deckarep/golang-set"

// Vdsl2LineConfigurationExtensions2ClassID is the 16-bit ID for the OMCI
// Managed entity VDSL2 line configuration extensions 2
const Vdsl2LineConfigurationExtensions2ClassID ClassID = ClassID(323)

var vdsl2lineconfigurationextensions2BME *ManagedEntityDefinition

// Vdsl2LineConfigurationExtensions2 (class ID #323)
//	This ME extends the xDSL line configuration MEs. The ME name was chosen because its attributes
//	were initially unique to ITU-T G.993.2 VDSL2. Due to continuing standards development, two of
//	the attributes (FEXT and NEXT TXREFVNds) are also used in [ITUT-G.992.3] and [ITUT-G.992.5].
//	This ME therefore pertains to the latter Recommendations as well as to [ITU-T-G.993.2].
//
//	The attributes of this ME are further defined in [ITU-T G.997.1].
//
//	An instance of this ME is created and deleted by the OLT.
//
//	Relationships
//		An instance of this ME may be associated with zero or more instances of the PPTP xDSL UNI part
//		1.////		The overall xDSL line configuration profile is modelled in several parts, all of which are
//		associated together through a common ME ID. (The client PPTP xDSL UNI part 1 has a single
//		pointer, which refers to the entire set of line configuration parts.)
//
//	Attributes
//		Managed Entity Id
//			Managed entity ID: This attribute uniquely identifies each instance of this ME. All xDSL and
//			VDSL2 line configuration profiles and extensions that pertain to a given PPTP xDSL must share a
//			common ME ID. (R, setbycreate) (mandatory) (2-bytes)
//
//		Sos Time Downstream
//			SOS time downstream: The SOS-TIME-ds attribute is used in the specification of receiver
//			initiated SOS (see clause 13.4.3 of [ITUT G.993.2]). If the attribute value is not zero, the
//			standard SOS triggering criteria are enabled, and the value specifies the duration of the window
//			used in the standard SOS triggering criteria in the downstream direction. The special value zero
//			indicates that the standard SOS triggering criteria are disabled, i.e., vendor-discretionary
//			values may be used instead of the values configured in the MIB for the following parameters:
//			SOS-NTONES-ds, SOS-CRC-ds, SOS-TIME-ds. The valid range of non-zero values is from 1..255,
//			specifying 64-ms to 16320 ms in steps of 64-ms. (R,-W, setbycreate) (optional) (1-byte)
//
//		Sos Time Upstream
//			SOS time upstream: The SOS-TIME-us attribute is used in the specification of receiver initiated
//			SOS (see clause 13.4.3 of [ITUT G.993.2]). If the attribute value is not zero, the standard SOS
//			triggering criteria are enabled, and the value specifies the duration of the window used in the
//			standard SOS triggering criteria in the upstream direction. The special value zero indicates
//			that the standard SOS triggering criteria are disabled, i.e., vendor-discretionary values may be
//			used instead of the values configured in the MIB for the following parameters: SOS-NTONES-us,
//			SOS-CRC-us, SOS-TIME-us. The valid range of non-zero values is from 1..255, specifying 64-ms to
//			16320-ms in steps of 64-ms. (R,-W, setbycreate) (optional) (1-byte)
//
//		Sos Degraded Tones Threshold Downstream
//			SOS degraded tones threshold downstream: The SOS-NTONES-ds attribute is the minimum percentage
//			of tones in the downstream medley set that must be degraded in order to arm the first
//			subcondition of the standard SOS triggering criteria in the downstream direction. The valid
//			range of values is from 1 to 100% in steps of 1. Use of the special value 0 is described in
//			clause 13.4.3.2 of [ITUT G.993.2]. (R,-W, setbycreate) (optional) (1-byte)
//
//		Sos Degraded Tones Threshold Upstream
//			SOS degraded tones threshold upstream: The SOS-NTONES-us attribute is the minimum percentage of
//			tones in the upstream medley set that must be degraded in order to arm the first subcondition of
//			the standard SOS triggering criteria in the upstream direction. The valid range of values is
//			from 1 to 100% in steps of 1. Use of the special value 0 is described in clause 13.4.3.2 of
//			[ITUT-G.993.2]. (R,-W, setbycreate) (optional) (1-byte)
//
//		Sos Crc Threshold Downstream
//			SOS CRC threshold downstream: The SOS-CRC-ds attribute is the minimum number of normalized CRC
//			anomalies received in SOS-TIME-ds seconds in order to arm the second sub-condition of the
//			standard SOS triggering criteria (see clause 13.4.3.2 of [ITU T G.993.2]) in the downstream
//			direction. The valid range of SOS-CRC values is 0.02 to (216-1)*0.02, in steps of 0.02. The
//			value-0 specifies that the ONU uses its internal default. (R, W, set-by-create) (optional) (2
//			bytes)
//
//		Sos Crc Threshold Upstream
//			SOS CRC threshold upstream: The SOS-CRC-us attribute is the minimum number of normalized CRC
//			anomalies received in SOS-TIME-us seconds in order to arm the second sub-condition of the
//			standard SOS triggering criteria (see clause 13.4.3.2 of [ITU T G.993.2]) in the upstream
//			direction. The valid range of SOS-CRC values is 0.02 to (216-1)*0.02, in steps of 0.02. The
//			value-0 specifies that the ONU uses its internal default. (R, W, set-by-create) (optional) (2
//			bytes)
//
//		Max Sos Downstream
//			MAX SOS downstream: The MAX-SOS-ds attribute is used in deactivation. If the number of
//			successful SOS procedures in the downstream direction performed within a 120-s interval exceeds
//			MAX-SOS-ds, the modem goes to state L3. See clause 12.1.4 of [ITUT G.993.2] for details. The
//			valid range of values is 1 to 15, with the special value 0 as described in clause 12.1 of [ITUT
//			G.993.2]. (R,-W, setbycreate) (optional) (1-byte)
//
//		Max Sos Upstream
//			MAX SOS upstream: The MAX-SOS-us attribute is used in deactivation. If the number of successful
//			SOS procedures in the upstream direction performed within a 120-s interval exceeds MAX-SOS-us,
//			the modem goes to state L3. See clause 12.1.4 of [ITUT G.993.2] for details. The valid range of
//			values is 1 to 15, with the special value 0 as described in clause 12.1 of [ITUT G.993.2].
//			(R,-W, setbycreate) (optional) (1-byte)
//
//		Snr Max Offset Downstream
//			SNR max offset downstream: The SNRMOFFSET-ROC-ds attribute is the SNR margin offset for the ROC
//			in the downstream direction. The attribute is used in the specification of the channel
//			initialization policy (see clause 12.3.7.1 of [ITUT G.993.2]). The valid range of SNR margin
//			offset values is from 0..31-dB in 0.1-dB steps. (R,-W, setbycreate) (optional) (2-bytes)
//
//		Snr Max Offset Upstream
//			SNR max offset upstream: The SNRMOFFSET-ROC-us attribute is the SNR margin offset for the ROC in
//			the upstream direction. The attribute is used in the specification of the channel initialization
//			policy (see clause-12.3.7.1 of [ITUT G.993.2]). The valid range of SNR margin offset values is
//			from 0..31-dB in 0.1-dB steps. (R,-W, setbycreate) (optional) (2-bytes)
//
//		Roc Minimum Impulse Noise Protection Downstream
//			ROC minimum impulse noise protection downstream: The INPMIN-ROC-ds attribute specifies the
//			minimum INP to apply on the ROC in the downstream direction expressed in multiples of equivalent
//			4k DMT, xDSL (DMT) symbol length. The minimum INP is an integer ranging from 0 to 8. (R,-W,
//			setbycreate) (optional) (1-byte)
//
//		Roc Minimum Impulse Noise Protection Upstream
//			ROC minimum impulse noise protection upstream: The INPMIN-ROC-us attribute specifies the minimum
//			impulse noise protection to apply on the ROC in the upstream direction expressed in multiples of
//			equivalent 4k DMT symbol length. The minimum INP is an integer ranging from 0 to 8. (R,-W,
//			setbycreate) (optional) (1-byte)
//
//		Fext Downstream Transmitter Referred Virtual Noise Table
//			FEXT downstream transmitter referred virtual noise table: The FEXT TXREFVNds attribute is the
//			downstream transmitter referred virtual noise specified for FEXTR duration in Annex C of [ITUT
//			G.992.3] (ADSL2) and Annex C of [ITUT G.992.5] (ADSL2plus). The syntax of this attribute is the
//			same as that of the TXREFVNds table attribute of the VDSL2 line configuration extensions ME.
//			(R,-W) (mandatory for Annex-C of [ITUT-G.992.3] and Annex-C of [ITUT-G.992.5]) (3-*-N bytes,
//			where N is the number of breakpoints)
//
//		Next Downstream Transmitter Referred Virtual Noise Table
//			NEXT downstream transmitter referred virtual noise table: The NEXT TXREFVNds attribute is the
//			downstream transmitter referred virtual noise specified for NEXTR duration in Annex C of [ITUT
//			G.992.3] (ADSL2) and Annex C of [ITUT G.992.5] (ADSL2plus). The syntax of this attribute is the
//			same as that of the TXREFVNds table attribute of the VDSL2 line configuration extensions ME.
//			(R,-W) (mandatory for Annex-C of [ITUT-G.992.3] and Annex-C of [ITUT-G.992.5]) (3-*-N bytes,
//			where N is the number of breakpoints)
//
type Vdsl2LineConfigurationExtensions2 struct {
	ManagedEntityDefinition
	Attributes AttributeValueMap
}

func init() {
	vdsl2lineconfigurationextensions2BME = &ManagedEntityDefinition{
		Name:    "Vdsl2LineConfigurationExtensions2",
		ClassID: 323,
		MessageTypes: mapset.NewSetWith(
			Create,
			Delete,
			Get,
			GetNext,
			Set,
		),
		AllowedAttributeMask: 0xfffc,
		AttributeDefinitions: AttributeDefinitionMap{
			0:  Uint16Field("ManagedEntityId", PointerAttributeType, 0x0000, 0, mapset.NewSetWith(Read, SetByCreate), false, false, false, 0),
			1:  ByteField("SosTimeDownstream", UnsignedIntegerAttributeType, 0x8000, 0, mapset.NewSetWith(Read, SetByCreate, Write), false, true, false, 1),
			2:  ByteField("SosTimeUpstream", UnsignedIntegerAttributeType, 0x4000, 0, mapset.NewSetWith(Read, SetByCreate, Write), false, true, false, 2),
			3:  ByteField("SosDegradedTonesThresholdDownstream", UnsignedIntegerAttributeType, 0x2000, 0, mapset.NewSetWith(Read, SetByCreate, Write), false, true, false, 3),
			4:  ByteField("SosDegradedTonesThresholdUpstream", UnsignedIntegerAttributeType, 0x1000, 0, mapset.NewSetWith(Read, SetByCreate, Write), false, true, false, 4),
			5:  Uint16Field("SosCrcThresholdDownstream", UnsignedIntegerAttributeType, 0x0800, 0, mapset.NewSetWith(Read, SetByCreate, Write), false, true, false, 5),
			6:  Uint16Field("SosCrcThresholdUpstream", UnsignedIntegerAttributeType, 0x0400, 0, mapset.NewSetWith(Read, SetByCreate, Write), false, true, false, 6),
			7:  ByteField("MaxSosDownstream", UnsignedIntegerAttributeType, 0x0200, 0, mapset.NewSetWith(Read, SetByCreate, Write), false, true, false, 7),
			8:  ByteField("MaxSosUpstream", UnsignedIntegerAttributeType, 0x0100, 0, mapset.NewSetWith(Read, SetByCreate, Write), false, true, false, 8),
			9:  Uint16Field("SnrMaxOffsetDownstream", UnsignedIntegerAttributeType, 0x0080, 0, mapset.NewSetWith(Read, SetByCreate, Write), false, true, false, 9),
			10: Uint16Field("SnrMaxOffsetUpstream", UnsignedIntegerAttributeType, 0x0040, 0, mapset.NewSetWith(Read, SetByCreate, Write), false, true, false, 10),
			11: ByteField("RocMinimumImpulseNoiseProtectionDownstream", UnsignedIntegerAttributeType, 0x0020, 0, mapset.NewSetWith(Read, SetByCreate, Write), false, true, false, 11),
			12: ByteField("RocMinimumImpulseNoiseProtectionUpstream", UnsignedIntegerAttributeType, 0x0010, 0, mapset.NewSetWith(Read, SetByCreate, Write), false, true, false, 12),
			13: TableField("FextDownstreamTransmitterReferredVirtualNoiseTable", TableAttributeType, 0x0008, TableInfo{nil, 3}, mapset.NewSetWith(Read, Write), false, false, false, 13),
			14: TableField("NextDownstreamTransmitterReferredVirtualNoiseTable", TableAttributeType, 0x0004, TableInfo{nil, 3}, mapset.NewSetWith(Read, Write), false, false, false, 14),
		},
		Access:  CreatedByOlt,
		Support: UnknownSupport,
	}
}

// NewVdsl2LineConfigurationExtensions2 (class ID 323) creates the basic
// Managed Entity definition that is used to validate an ME of this type that
// is received from or transmitted to the OMCC.
func NewVdsl2LineConfigurationExtensions2(params ...ParamData) (*ManagedEntity, OmciErrors) {
	return NewManagedEntity(*vdsl2lineconfigurationextensions2BME, params...)
}