blob: 2fda7abfd2c4794bec086e47d4b1a9f9a35f9051 [file] [log] [blame]
Chip Boling6e27b352020-02-14 09:10:01 -06001/*
2 * Copyright (c) 2018 - present. Boling Consulting Solutions (bcsw.net)
Andrea Campanella7167ebb2020-02-24 09:56:38 +01003 * Copyright 2020-present Open Networking Foundation
4
Chip Boling6e27b352020-02-14 09:10:01 -06005 * Licensed under the Apache License, Version 2.0 (the "License");
6 * you may not use this file except in compliance with the License.
7 * You may obtain a copy of the License at
Andrea Campanella7167ebb2020-02-24 09:56:38 +01008
Chip Boling6e27b352020-02-14 09:10:01 -06009 * http://www.apache.org/licenses/LICENSE-2.0
Andrea Campanella7167ebb2020-02-24 09:56:38 +010010
Chip Boling6e27b352020-02-14 09:10:01 -060011 * Unless required by applicable law or agreed to in writing, software
12 * distributed under the License is distributed on an "AS IS" BASIS,
13 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14 * See the License for the specific language governing permissions and
15 * limitations under the License.
16 */
Chip Boling34ebcb62021-02-02 12:13:58 -060017/*
Chip Boling6e27b352020-02-14 09:10:01 -060018 * NOTE: This file was generated, manual edits will be overwritten!
19 *
20 * Generated by 'goCodeGenerator.py':
21 * https://github.com/cboling/OMCI-parser/README.md
22 */
23
24package generated
25
26import "github.com/deckarep/golang-set"
27
28// MulticastGemInterworkingTerminationPointClassID is the 16-bit ID for the OMCI
29// Managed entity Multicast GEM interworking termination point
30const MulticastGemInterworkingTerminationPointClassID ClassID = ClassID(281)
31
32var multicastgeminterworkingterminationpointBME *ManagedEntityDefinition
33
34// MulticastGemInterworkingTerminationPoint (class ID #281)
35// An instance of this ME represents a point in a G-PON ONU where a multicast service interworks
36// with the GEM layer. At this point, a multicast bit stream is reconstructed from GEM packets.
37//
38// Instances of this ME are created and deleted by the OLT.
39//
40// Multicast interworking GEM modes of operation
41//
42// The default multicast operation of the PON is where all the multicast content streams are
43// carried in one PON layer connection (GEM port). This connection is then specified in the first
44// entry of the IPv4 or IPv6 multicast address table, as the case may be. This single entry also
45// specifies an all-inclusive IP multicast destination address (DA) range (e.g., 224.0.0.0 to
46// 239.255.255.255 in the case of IPv4). The ONU then filters the traffic based on either Ethernet
47// MAC addresses or IP addresses. The associated GEM port network CTP ME specifies the GEM port-ID
48// that supports all multicast connections.
49//
50// In the default multicast operation, all multicast content streams are placed in one PON layer
51// connection (GEM port). The OLT sets up a completely conventional model, a pointer from the
52// multicast GEM IW termination to a GEM port network CTP. The OLT configures the GEM port-ID of
53// the GEM port network CTP into the appropriate multicast address table attribute(s), along with
54// the other table fields that specify the range of IP multicast DAs. The ONU accepts the entire
55// multicast stream through the designated GEM port, then filters the traffic based on either the
56// Ethernet MAC address or IP DA.
57//
58// An optional multicast configuration supports separate multicast streams carried over separate
59// PON layer connections, i.e., on separate GEM ports. This permits the ONU to filter multicast
60// streams at the GEM level, which is efficient in hardware, while ignoring other multicast streams
61// that may be of interest to other ONUs on the PON.
62//
63// After configuring the explicit model for the first multicast GEM port, the OLT supports multiple
64// multicast GEM ports by then configuring additional entries into the multicast address table(s),
65// entries with different GEM port-IDs. The OMCI model is defined such that these ports are
66// implicitly grouped together and served by the single explicit GEM port network CTP. No
67// additional GEM network CTPs need be created or linked for the additional GEM ports.
68//
69// Several multicast GEM IW TPs can exist, each linked to separate bridge ports or mappers to serve
70// different communities of interest in a complex ONU.
71//
72// Discovery of multicast support
73//
74// The OLT uses the multicast GEM IW TP entity as the means to discover the ONU's multicast
75// capability. This entity is mandatory if multicast is supported by the ONU. If the OLT attempts
76// to create this entity on an ONU that does not support multicast, the create command fails. The
77// create or set command also fails if the OLT attempts to exploit optional features that the ONU
78// does not support, e.g., in attempting to write a multicast address table with more than a single
79// entry or to create multiple multicast GEM IW TPs.
80//
81// This ME is defined by a similarity to the unicast GEM IW TP, and a number of its attributes are
82// not meaningful in a multicast context. These attributes are set to 0 and not used, as indicated
83// in the following.
84//
85// Relationships
86// An instance of this ME exists for each occurrence of transformation of GEM packets into a
87// multicast data stream.
88//
89// Attributes
90// Managed Entity Id
91// Managed entity ID: This attribute uniquely identifies each instance of this ME. The value 0xFFFF
92// is reserved. (R, setbycreate) (mandatory) (2-bytes)
93//
94// Gem Port Network Ctp Connectivity Pointer
95// GEM port network CTP connectivity pointer: This attribute points to an instance of the GEM port
96// network CTP that is associated with this multicast GEM IW TP. (R,-W, setbycreate) (mandatory)
97// (2-bytes)
98//
99// Interworking Option
100// (R,-W, setbycreate) (mandatory) (1-byte)
101//
102// Service Profile Pointer
103// Service profile pointer: This attribute is set to 0 and not used. For backward compatibility, it
104// may also be set to point to a MAC bridge service profile or IEEE 802.1p mapper service profile.
105// (R,-W, setbycreate) (mandatory) (2-bytes)
106//
107// Not Used 1
108// Not used 1: This attribute is set to 0 and not used. (R,-W, setbycreate) (mandatory) (2-bytes)
109//
110// Pptp Counter
111// PPTP counter: This attribute represents the number of instances of PPTP MEs associated with this
112// instance of the multicast GEM IW TP. This attribute conveys no information that is not available
113// elsewhere; it may be set to 0xFF and not used. (R) (optional) (1-byte)
114//
115// Operational State
116// Operational state: This attribute indicates whether the ME is capable of performing its
117// function. Valid values are enabled (0) and disabled (1). (R) (optional) (1-byte)
118//
119// Gal Profile Pointer
120// GAL profile pointer: This attribute is set to 0 and not used. For backward compatibility, it may
121// also be set to point to a GAL Ethernet profile. (R,-W, setbycreate) (mandatory) (2-bytes)
122//
123// Not Used 2
124// Not used 2: This attribute is set to 0 and not used. (R,-W, setbycreate) (mandatory) (1-byte)
125//
126// Ipv4 Multicast Address Table
127// IPv4 multicast address table: This attribute maps IP multicast addresses to PON layer addresses.
128// Each entry contains the following.
129//
130// Ipv6 Multicast Address Table
131// (R,-W) (optional) (24N bytes, where N is the number of entries in the list.)
132//
133type MulticastGemInterworkingTerminationPoint struct {
134 ManagedEntityDefinition
135 Attributes AttributeValueMap
136}
137
138func init() {
139 multicastgeminterworkingterminationpointBME = &ManagedEntityDefinition{
140 Name: "MulticastGemInterworkingTerminationPoint",
141 ClassID: 281,
142 MessageTypes: mapset.NewSetWith(
143 Create,
144 Delete,
145 Get,
146 GetNext,
147 Set,
Chip Boling2d51f052021-02-09 09:04:15 -0600148 SetTable,
Chip Boling6e27b352020-02-14 09:10:01 -0600149 ),
150 AllowedAttributeMask: 0xffc0,
151 AttributeDefinitions: AttributeDefinitionMap{
152 0: Uint16Field("ManagedEntityId", PointerAttributeType, 0x0000, 0, mapset.NewSetWith(Read, SetByCreate), false, false, false, 0),
153 1: Uint16Field("GemPortNetworkCtpConnectivityPointer", PointerAttributeType, 0x8000, 0, mapset.NewSetWith(Read, SetByCreate, Write), false, false, false, 1),
154 2: ByteField("InterworkingOption", EnumerationAttributeType, 0x4000, 0, mapset.NewSetWith(Read, SetByCreate, Write), false, false, false, 2),
155 3: Uint16Field("ServiceProfilePointer", PointerAttributeType, 0x2000, 0, mapset.NewSetWith(Read, SetByCreate, Write), false, false, false, 3),
156 4: Uint16Field("NotUsed1", UnsignedIntegerAttributeType, 0x1000, 0, mapset.NewSetWith(Read, SetByCreate, Write), false, false, false, 4),
157 5: ByteField("PptpCounter", UnsignedIntegerAttributeType, 0x0800, 255, mapset.NewSetWith(Read), false, true, false, 5),
158 6: ByteField("OperationalState", EnumerationAttributeType, 0x0400, 0, mapset.NewSetWith(Read), true, true, false, 6),
159 7: Uint16Field("GalProfilePointer", PointerAttributeType, 0x0200, 0, mapset.NewSetWith(Read, SetByCreate, Write), false, false, false, 7),
160 8: ByteField("NotUsed2", UnsignedIntegerAttributeType, 0x0100, 0, mapset.NewSetWith(Read, SetByCreate, Write), false, false, false, 8),
161 9: TableField("Ipv4MulticastAddressTable", TableAttributeType, 0x0080, TableInfo{nil, 12}, mapset.NewSetWith(Read, Write), false, false, false, 9),
162 10: TableField("Ipv6MulticastAddressTable", TableAttributeType, 0x0040, TableInfo{nil, 24}, mapset.NewSetWith(Read, Write), false, true, false, 10),
163 },
164 Access: CreatedByOlt,
165 Support: UnknownSupport,
Chip Boling34ebcb62021-02-02 12:13:58 -0600166 Alarms: AlarmMap{
167 0: "Deprecated",
168 },
Chip Boling6e27b352020-02-14 09:10:01 -0600169 }
170}
171
172// NewMulticastGemInterworkingTerminationPoint (class ID 281) creates the basic
173// Managed Entity definition that is used to validate an ME of this type that
174// is received from or transmitted to the OMCC.
175func NewMulticastGemInterworkingTerminationPoint(params ...ParamData) (*ManagedEntity, OmciErrors) {
176 return NewManagedEntity(*multicastgeminterworkingterminationpointBME, params...)
177}