blob: eff1cd53b7a860c075a4b5eac40af10ed989463f [file] [log] [blame]
Holger Hildebrandt4b5e73f2021-08-19 06:51:21 +00001/*
Joey Armstrong89c812c2024-01-12 19:00:20 -05002 * Copyright 2020-2024 Open Networking Foundation (ONF) and the ONF Contributors
Holger Hildebrandt4b5e73f2021-08-19 06:51:21 +00003 *
4 * Licensed under the Apache License, Version 2.0 (the "License");
5 * you may not use this file except in compliance with the License.
6 * You may obtain a copy of the License at
7 *
8 * http://www.apache.org/licenses/LICENSE-2.0
9 *
10 * Unless required by applicable law or agreed to in writing, software
11 * distributed under the License is distributed on an "AS IS" BASIS,
12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 * See the License for the specific language governing permissions and
14 * limitations under the License.
15 */
16
praneeth nalmas5a0a5502022-12-23 15:57:00 +053017// Package common provides global definitions
Holger Hildebrandt4b5e73f2021-08-19 06:51:21 +000018package common
19
20import (
21 "context"
Girish Gowdraf7d82d02022-04-26 16:18:35 -070022 "sync"
Holger Hildebrandt4b5e73f2021-08-19 06:51:21 +000023 "time"
24
Holger Hildebrandt94688c72021-12-17 12:13:02 +000025 me "github.com/opencord/omci-lib-go/v2/generated"
Holger Hildebrandt4b5e73f2021-08-19 06:51:21 +000026 "github.com/opencord/voltha-lib-go/v7/pkg/db"
27 "github.com/opencord/voltha-lib-go/v7/pkg/events/eventif"
28 "github.com/opencord/voltha-openonu-adapter-go/internal/pkg/devdb"
praneeth nalmas5a0a5502022-12-23 15:57:00 +053029 "github.com/opencord/voltha-protos/v5/go/extension"
khenaidoo42dcdfd2021-10-19 17:34:12 -040030 ia "github.com/opencord/voltha-protos/v5/go/inter_adapter"
Holger Hildebrandt4b5e73f2021-08-19 06:51:21 +000031 "github.com/opencord/voltha-protos/v5/go/openolt"
32 "github.com/opencord/voltha-protos/v5/go/voltha"
33)
34
35// IopenONUAC interface to openONUAC
36type IopenONUAC interface {
37 GetSupportedFsms() *OmciDeviceFsms
38 LockMutexMibTemplateGenerated()
39 UnlockMutexMibTemplateGenerated()
40 GetMibTemplatesGenerated(string) (bool, bool)
41 SetMibTemplatesGenerated(string, bool)
42 RLockMutexDeviceHandlersMap()
43 RUnlockMutexDeviceHandlersMap()
44 GetDeviceHandler(string) (IdeviceHandler, bool)
45}
46
47// IdeviceHandler interface to deviceHandler
48type IdeviceHandler interface {
49 GetDeviceID() string
50 GetLogicalDeviceID() string
51 GetDevice() *voltha.Device
52 GetDeviceType() string
53 GetProxyAddressID() string
54 GetProxyAddressType() string
55 GetProxyAddress() *voltha.Device_ProxyAddress
56 GetEventProxy() eventif.EventProxy
57 GetOmciTimeout() int
58 GetAlarmAuditInterval() time.Duration
59 GetDlToOnuTimeout4M() time.Duration
60 GetUniEntityMap() *OnuUniPortMap
61 GetUniPortMask() int
62 GetPonPortNumber() *uint32
63 GetOnuIndication() *openolt.OnuIndication
64 GetUniVlanConfigFsm(uint8) IuniVlanConfigFsm
Holger Hildebrandt9afc1582021-11-30 16:10:19 +000065 GetTechProfileInstanceFromParentAdapter(context.Context, uint8, string) (*ia.TechProfileDownloadMessage, error)
Holger Hildebrandtc572e622022-06-22 09:19:17 +000066 GetExtendedOmciSupportEnabled() bool
Holger Hildebrandt4b5e73f2021-08-19 06:51:21 +000067
68 GetDeviceReasonString() string
mpagenkoe4782082021-11-25 12:04:26 +000069 ReasonUpdate(context.Context, uint8, bool) error
Holger Hildebrandt4b5e73f2021-08-19 06:51:21 +000070
71 GetCollectorIsRunning() bool
Girish Gowdraf7d82d02022-04-26 16:18:35 -070072 StartCollector(context.Context, *sync.WaitGroup)
Holger Hildebrandt4b5e73f2021-08-19 06:51:21 +000073 InitPmConfigs()
74 GetPmConfigs() *voltha.PmConfigs
75 GetMetricsEnabled() bool
76 GetOnuMetricsManager() IonuMetricsManager
77 GetOnuAlarmManager() IonuAlarmManager
78 GetOnuTP() IonuUniTechProf
79
80 GetAlarmManagerIsRunning(context.Context) bool
81 StartAlarmManager(context.Context)
82
Girish Gowdrae95687a2021-09-08 16:30:58 -070083 GetFlowMonitoringIsRunning(uniID uint8) bool
84
Holger Hildebrandt4b5e73f2021-08-19 06:51:21 +000085 CheckAuditStartCondition(context.Context, UsedOmciConfigFsms) bool
86
87 RemoveOnuUpgradeFsm(context.Context, *voltha.ImageState)
88 DeviceProcStatusUpdate(context.Context, OnuDeviceEvent)
89
90 SetReadyForOmciConfig(bool)
91 IsReadyForOmciConfig() bool
Holger Hildebrandt2b107642022-12-09 07:56:23 +000092 IsOltAvailable() bool
Holger Hildebrandt4b5e73f2021-08-19 06:51:21 +000093
94 StorePersistentData(context.Context) error
95 StorePersUniFlowConfig(context.Context, uint8, *[]UniVlanFlowParams, bool) error
96
97 StartReconciling(context.Context, bool)
Holger Hildebrandt4b5e73f2021-08-19 06:51:21 +000098 IsReconciling() bool
99 IsSkipOnuConfigReconciling() bool
Holger Hildebrandt9afc1582021-11-30 16:10:19 +0000100 SetReconcilingReasonUpdate(bool)
101 IsReconcilingReasonUpdate() bool
Holger Hildebrandt4b5e73f2021-08-19 06:51:21 +0000102 PrepareReconcilingWithActiveAdapter(context.Context)
Holger Hildebrandtb314f442021-11-24 12:03:10 +0000103 ReconcileDeviceTechProf(context.Context) bool
Holger Hildebrandt4b5e73f2021-08-19 06:51:21 +0000104 ReconcileDeviceFlowConfig(context.Context)
mpagenko101ac942021-11-16 15:01:29 +0000105 GetReconcileExpiryVlanConfigAbort() time.Duration
106 SendChUniVlanConfigFinished(value uint16)
Holger Hildebrandt4b5e73f2021-08-19 06:51:21 +0000107
108 VerifyUniVlanConfigRequest(context.Context, *OnuUniPort, uint8)
109 VerifyVlanConfigRequest(context.Context, uint8, uint8)
110 AddAllUniPorts(context.Context)
111 RemoveVlanFilterFsm(context.Context, *OnuUniPort)
112
113 EnableUniPortStateUpdate(context.Context)
114 DisableUniPortStateUpdate(context.Context)
115
116 SetBackend(context.Context, string) *db.Backend
117 GetBackendPathPrefix() string
118
119 RLockMutexDeletionInProgressFlag()
120 RUnlockMutexDeletionInProgressFlag()
121 GetDeletionInProgress() bool
122
khenaidoo42dcdfd2021-10-19 17:34:12 -0400123 SendOMCIRequest(context.Context, string, *ia.OmciMessage) error
kesavand011d5162021-11-25 19:21:06 +0530124 SendOnuSwSectionsOfWindow(context.Context, string, *ia.OmciMessages) error
125
Holger Hildebrandt4b5e73f2021-08-19 06:51:21 +0000126 CreatePortInCore(context.Context, *voltha.Port) error
Girish Gowdrae95687a2021-09-08 16:30:58 -0700127
128 PerOnuFlowHandlerRoutine(uniID uint8)
Praneeth Kumar Nalmasaacc6122024-04-09 22:55:49 +0530129 GetDeviceDeleteCommChan(context.Context) chan bool
Holger Hildebrandt4b5e73f2021-08-19 06:51:21 +0000130}
131
132// IonuDeviceEntry interface to onuDeviceEntry
133type IonuDeviceEntry interface {
134 GetDevOmciCC() *OmciCC
135 GetOnuDB() *devdb.OnuDeviceDB
136 GetPersSerialNumber() string
137 GetPersVendorID() string
Holger Hildebrandt6a001d02022-06-15 08:32:48 +0000138 GetPersVersion() string
Holger Hildebrandt4b5e73f2021-08-19 06:51:21 +0000139 GetPersEquipmentID() string
Holger Hildebrandt0edf5b02022-05-04 14:19:43 +0000140 GetPersIsExtOmciSupported() bool
Holger Hildebrandt4b5e73f2021-08-19 06:51:21 +0000141
142 GetMibUploadFsmCommChan() chan Message
143 GetMibDownloadFsmCommChan() chan Message
144
145 GetOmciRebootMsgRevChan() chan Message
146 WaitForRebootResponse(context.Context, chan Message) error
147
148 IncrementMibDataSync(context.Context)
149
150 GetActiveImageMeID(context.Context) (uint16, error)
Holger Hildebrandtfdb4bba2022-03-10 12:12:59 +0000151 HandleSwImageIndications(context.Context, uint16, me.AttributeValueMap) bool
Holger Hildebrandt4b5e73f2021-08-19 06:51:21 +0000152 GetPersActiveSwVersion() string
153 SetPersActiveSwVersion(string)
154 GetActiveImageVersion(context.Context) string
155 ModifySwImageInactiveVersion(context.Context, string)
156 ModifySwImageActiveCommit(context.Context, uint8)
157
158 AllocateFreeTcont(context.Context, uint16) (uint16, bool, error)
159 FreeTcont(context.Context, uint16)
Holger Hildebrandtc56febd2022-02-09 13:23:30 +0000160
161 SendOnuDeviceEvent(context.Context, string, string)
Holger Hildebrandt4b5e73f2021-08-19 06:51:21 +0000162}
163
164// IonuMetricsManager interface to onuMetricsManager
165type IonuMetricsManager interface {
166 AddGemPortForPerfMonitoring(context.Context, uint16)
167 RemoveGemPortForPerfMonitoring(context.Context, uint16)
168}
169
170// IonuAlarmManager interface to onuAlarmManager
171type IonuAlarmManager interface {
172 HandleOmciAlarmNotificationMessage(context.Context, OmciMessage)
173 ResetAlarmUploadCounters()
174 GetAlarmMgrEventChannel() chan Message
175 GetAlarmUploadSeqNo() uint16
176 IncrementAlarmUploadSeqNo()
praneeth nalmas5a0a5502022-12-23 15:57:00 +0530177 GetOnuActiveAlarms(ctx context.Context) *extension.SingleGetValueResponse
Holger Hildebrandt4b5e73f2021-08-19 06:51:21 +0000178}
179
180// IonuUniTechProf interface to onuUniTechProf
181type IonuUniTechProf interface {
182 GetAllBidirectionalGemPortIDsForOnu() []uint16
Holger Hildebrandt5ba6c132022-10-06 13:53:14 +0000183 GetNumberOfConfiguredUsGemPorts(ctx context.Context) int
Holger Hildebrandt4b5e73f2021-08-19 06:51:21 +0000184 SetProfileToDelete(uint8, uint8, bool)
185}
186
187// IuniVlanConfigFsm interface to uniVlanConfigFsm
188type IuniVlanConfigFsm interface {
Holger Hildebrandtc192bc42021-10-28 14:38:31 +0000189 IsFlowRemovePending(context.Context, chan<- bool) bool
Holger Hildebrandt4b5e73f2021-08-19 06:51:21 +0000190}
Joey Armstrong2283faa2023-06-22 17:53:59 -0400191
192// [EOF]