generated/xdslchanneldownstreamstatusdata.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"

// XdslChannelDownstreamStatusDataClassID is the 16-bit ID for the OMCI
// Managed entity xDSL channel downstream status data
const XdslChannelDownstreamStatusDataClassID = ClassID(102) // 0x0066

var xdslchanneldownstreamstatusdataBME *ManagedEntityDefinition

// XdslChannelDownstreamStatusData (Class ID: #102 / 0x0066)
//	This ME contains downstream channel status data for an xDSL UNI. The ONU automatically creates
//	or deletes instances of this ME upon the creation or deletion of a PPTP xDSL UNI part 1.
//
//	NOTE - [ITU-T G.997.1] specifies that bit rate attributes have a granularity of 1000-bit/s. If
//	ITU-T G.997.1 compliance is required, the ONU should only report values with this granularity.
//
//	Relationships
//		One or more instances of this ME are associated with an instance of an xDSL UNI.
//
//	Attributes
//		Managed Entity Id
//			This attribute uniquely identifies each instance of this ME. The two MSBs of the first byte are
//			the bearer channel ID. Excluding the first 2-bits of the first byte, the remaining part of the
//			ME ID is identical to that of this ME's parent PPTP xDSL UNI part 1. (R) (mandatory) (2-bytes)
//
//		Actual Interleaving Delay
//			This attribute is the actual one-way interleaving delay introduced by the PMS-TC between the
//			alpha and beta reference points, excluding delay in the L1 and L2 states. In the L1 and L2
//			states, the attribute contains the interleaving delay in the previous L0 state. For ADSL, this
//			attribute is derived from the S and D attributes as cap(S*D)/4 ms, where S is the number of
//			symbols per codeword, D is the interleaving depth and cap() denotes rounding to the next higher
//			integer. For [ITU-T G.993.2], this attribute is computed according to the formula in clause 9.7
//			of [ITUT-G.993.2]. The actual interleaving delay is coded in milliseconds, rounded to the
//			nearest millisecond. (R) (mandatory) (1-byte)
//
//		Actual Data Rate
//			This parameter reports the actual net data rate of the bearer channel, excluding the rate in the
//			L1 and L2 states. In the L1 or L2 state, the parameter contains the net data rate in the
//			previous L0 state. The data rate is coded in bits per second. (R) (mandatory) (4-bytes)
//
//		Previous Data Rate
//			This parameter reports the previous net data rate of the bearer channel just before the latest
//			rate change event occurred, excluding transitions between the L0 state and the L1 or L2 states.
//			A rate change can occur at a power management state transition, e.g., at full or short
//			initialization, fast retrain or power down, or at a dynamic rate adaptation. The rate is coded
//			in bits per second (R) (mandatory) (4-bytes)
//
//		Actual Impulse Noise Protection
//			The ACTINP attribute reports the actual INP on the bearer channel in the L0 state. In the L1 or
//			L2 state, the attribute contains the INP in the previous L0 state. The value of this attribute
//			is a number of DMT symbols, with a granularity of 0.1 symbols. Its range is from 0 (0.0 symbols)
//			to 254 (25.4 symbols). The special value 255 indicates an ACTINP higher than 25.4. (R) (optional
//			for [ITU-T G.992.1], mandatory for other xDSL Recommendations that support this attribute)
//			(1-byte)
//
//		Actual Size Of Reed_Solomon Codeword
//			Actual size of Reed-Solomon codeword: The NFEC attribute reports the actual Reed-Solomon
//			codeword size used in the latency path in which the bearer channel is transported. The value is
//			coded in bytes, and ranges from 0..255. (R) (mandatory for ITUT-G.993.2 VDSL2, optional for
//			others) (1-byte)
//
//		Actual Number Of Reed_Solomon Redundancy Bytes
//			Actual number of Reed-Solomon redundancy bytes: The RFEC attribute reports the actual number of
//			Reed-Solomon redundancy bytes per codeword used in the latency path in which the bearer channel
//			is transported. The value is coded in bytes, and ranges from 0..16. The value 0 indicates no
//			Reed-Solomon coding. (R) (mandatory for ITUT-G.993.2 VDSL2, optional for others) (1-byte)
//
//		Actual Number Of Bits Per Symbol
//			The LSYMB attribute reports the actual number of bits per symbol assigned to the latency path in
//			which the bearer channel is transported, excluding trellis overhead. The value is coded in bits,
//			and ranges from 0..65535. (R) (mandatory for [TU-T G.993.2 VDSL2, optional for others) (2-bytes)
//
//		Actual Interleaving Depth
//			The INTLVDEPTH attribute reports the actual depth of the interleaver used in the latency path in
//			which the bearer channel is transported. The value ranges from 1..4096 in steps of 1. The value
//			1 indicates no interleaving. (R) (mandatory for ITU-T G.993.2 VDSL2, optional for others)
//			(2-bytes)
//
//		Actual Interleaving Block Length
//			The INTLVBLOCK attribute reports the actual block length of the interleaver used in the latency
//			path in which the bearer channel is transported. The value ranges from 4..255 in steps of 1. (R)
//			(mandatory for ITU-T G.993.2 VDSL2, undefined for others) (1-byte)
//
//		Actual Latency Path
//			The LPATH attribute reports the index of the actual latency path in which the bearer channel is
//			transported. Valid values are 0..3. In [ITUT-G.992.1], the fast path is mapped to latency index
//			0; the interleaved path to index 1. (R) (mandatory for ITU-T G.993.2 VDSL2, optional for others)
//			(1-byte)
//
//		Actual Impulse Noise Protection Against Repetitive Electrical Impulse Noise Actinp_Rein
//			Actual impulse noise protection against repetitive electrical impulse noise (ACTINP_REIN): If
//			retransmission is used in a given transmit direction, this parameter reports the actual INP
//			against REIN on the bearer channel. The INP of this attribute is equal to the integer value
//			multiplied by 0.1 symbols. Valid values and usage are given in clause 7.5.2.9 of [ITU-T G.997.1]
//			(R) (optional) (1-byte)
//
type XdslChannelDownstreamStatusData struct {
	ManagedEntityDefinition
	Attributes AttributeValueMap
}

// Attribute name constants

const XdslChannelDownstreamStatusData_ActualInterleavingDelay = "ActualInterleavingDelay"
const XdslChannelDownstreamStatusData_ActualDataRate = "ActualDataRate"
const XdslChannelDownstreamStatusData_PreviousDataRate = "PreviousDataRate"
const XdslChannelDownstreamStatusData_ActualImpulseNoiseProtection = "ActualImpulseNoiseProtection"
const XdslChannelDownstreamStatusData_ActualSizeOfReedSolomonCodeword = "ActualSizeOfReedSolomonCodeword"
const XdslChannelDownstreamStatusData_ActualNumberOfReedSolomonRedundancyBytes = "ActualNumberOfReedSolomonRedundancyBytes"
const XdslChannelDownstreamStatusData_ActualNumberOfBitsPerSymbol = "ActualNumberOfBitsPerSymbol"
const XdslChannelDownstreamStatusData_ActualInterleavingDepth = "ActualInterleavingDepth"
const XdslChannelDownstreamStatusData_ActualInterleavingBlockLength = "ActualInterleavingBlockLength"
const XdslChannelDownstreamStatusData_ActualLatencyPath = "ActualLatencyPath"
const XdslChannelDownstreamStatusData_ActualImpulseNoiseProtectionAgainstRepetitiveElectricalImpulseNoiseActinpRein = "ActualImpulseNoiseProtectionAgainstRepetitiveElectricalImpulseNoiseActinpRein"

func init() {
	xdslchanneldownstreamstatusdataBME = &ManagedEntityDefinition{
		Name:    "XdslChannelDownstreamStatusData",
		ClassID: XdslChannelDownstreamStatusDataClassID,
		MessageTypes: mapset.NewSetWith(
			Get,
		),
		AllowedAttributeMask: 0xffe0,
		AttributeDefinitions: AttributeDefinitionMap{
			0:  Uint16Field(ManagedEntityID, PointerAttributeType, 0x0000, 0, mapset.NewSetWith(Read), false, false, false, 0),
			1:  ByteField(XdslChannelDownstreamStatusData_ActualInterleavingDelay, UnsignedIntegerAttributeType, 0x8000, 0, mapset.NewSetWith(Read), false, false, false, 1),
			2:  Uint32Field(XdslChannelDownstreamStatusData_ActualDataRate, UnsignedIntegerAttributeType, 0x4000, 0, mapset.NewSetWith(Read), false, false, false, 2),
			3:  Uint32Field(XdslChannelDownstreamStatusData_PreviousDataRate, UnsignedIntegerAttributeType, 0x2000, 0, mapset.NewSetWith(Read), false, false, false, 3),
			4:  ByteField(XdslChannelDownstreamStatusData_ActualImpulseNoiseProtection, UnsignedIntegerAttributeType, 0x1000, 0, mapset.NewSetWith(Read), false, false, false, 4),
			5:  ByteField(XdslChannelDownstreamStatusData_ActualSizeOfReedSolomonCodeword, UnsignedIntegerAttributeType, 0x0800, 0, mapset.NewSetWith(Read), false, false, false, 5),
			6:  ByteField(XdslChannelDownstreamStatusData_ActualNumberOfReedSolomonRedundancyBytes, UnsignedIntegerAttributeType, 0x0400, 0, mapset.NewSetWith(Read), false, false, false, 6),
			7:  Uint16Field(XdslChannelDownstreamStatusData_ActualNumberOfBitsPerSymbol, UnsignedIntegerAttributeType, 0x0200, 0, mapset.NewSetWith(Read), false, false, false, 7),
			8:  Uint16Field(XdslChannelDownstreamStatusData_ActualInterleavingDepth, UnsignedIntegerAttributeType, 0x0100, 0, mapset.NewSetWith(Read), false, false, false, 8),
			9:  ByteField(XdslChannelDownstreamStatusData_ActualInterleavingBlockLength, UnsignedIntegerAttributeType, 0x0080, 0, mapset.NewSetWith(Read), false, false, false, 9),
			10: ByteField(XdslChannelDownstreamStatusData_ActualLatencyPath, UnsignedIntegerAttributeType, 0x0040, 0, mapset.NewSetWith(Read), false, false, false, 10),
			11: ByteField(XdslChannelDownstreamStatusData_ActualImpulseNoiseProtectionAgainstRepetitiveElectricalImpulseNoiseActinpRein, UnsignedIntegerAttributeType, 0x0020, 0, mapset.NewSetWith(Read), false, true, false, 11),
		},
		Access:  CreatedByOnu,
		Support: UnknownSupport,
	}
}

// NewXdslChannelDownstreamStatusData (class ID 102) 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 NewXdslChannelDownstreamStatusData(params ...ParamData) (*ManagedEntity, OmciErrors) {
	return NewManagedEntity(*xdslchanneldownstreamstatusdataBME, params...)
}