pyvoltha-min 2.4.0

VOLTHA Python OLT Device Adapter support libraries

PyVOLTHA-min is an updated pyVOLTHA package that provides a collection of python 3.x libraries used to create an VOLTHA OLT device adapter focused on the VOLTHA v2.4 release and beyond.

As some adapters (including the OpenONU) have required to be moved to the Go language, there is was not as much maintenance performed on the pyVOLTHA package.

The goal for this package is to begin to deprecate and remove old VOLTHA 1.x features and focus on a minimal set of updated imports that can be supported in Python 3.6 with the hopes to transition to later versions of python. In addition, effort to remove any GPL or other restrictive package requirements is also highly desired.

The current plan for version numbering is:

Version	Notes
< 1.0.0	Pre-release. As version numbers increase, more imports will have been upgraded to current and unused imports/requirements removed
2.0.0	Initial pre-release for VOLTHA v2.4 support several unused or stale libraries (consul…) will be marked as being deprecated, but will remain for some backwards compatibility and may be untested
2.4.0	VOLTHA v2.4 release. Deprecated classes removed so that further cleanup of unused imports so that some work can be performed in planning for python 3.7 support

Installation instruction

pip install pyvoltha-min

Release Notes

v2.4.0 (2020-11-29)

• Initial v2.4 release

v2.0.9 (2020-10-28)

• Lowered log message level for twisted-etcd-store success calls.

v2.0.8 (2020-10-22)

• For async/twisted ETCD client, differentiate between a cancelled async request and true failure

• Start method for PM metrics will check to for an existing running LoopingCall before attempting to start the loop (which would assert otherwise if already running)

v2.0.7 (2020-10-13)

• Added support for Device Event serialization to support HA reconciliation after a container restart

v2.0.6 (2020-10-12)

• Check to not stop looping call in stats if not running. Prevents an assert

• EtcStore errback should return the reason, not raise an assert

• Additional work on logger level and components in preparation for v2.5+ support

• Update to reported KPI Metrics to better match what OpenOLT supports in v2.4

• Allow None to be passed as key to TwistedEtcdStore operations to select the base client path and allow a timeout when initializing the etcd client.

v2.0.5 (2020-10-06)

• Fix bad check on OperStatus type. Always passed in as an int

• Fix log keyword bug, should not use ‘event’ in call

• Disable GEM Port statistics until we are ready for them

v2.0.4 (2020-10-05)

• Deprecation of HeartBeat Event, now called OLT Indication

• Correct subcategory for OLT LOS Event (was ONU, should be OLT)

• Corrected Device Events for OLT LOS, OLT Port Down, OLT Down, Dying Gasp, and PON Interface Down events for the OLT (VOLTHA v2.x format)

• A small amount of pylint cleanup and python 3 updates

• Call to etcd callback needs to be placed onto reactor thread

v2.0.3 (2020-09-30)

• Call to etcd callback needs to be placed onto reactor thread

v2.0.2 (2020-09-28)

• Default KPI subcategory is now OLT and can be set with a kwargs if needed for some other type

• Moved to latest version of protobuf module

• Added golang-equivalent Endpoint Manager in effort to determine endpoint of a device for interadapter-messages. Turns out there is a flaw in the design and is reliant upon use of a specific golang 3rd party hashing algorythm which may not be available to a python program. Discussions on the VOLTHA slack channel have been started and a JIRA may be issued in the near future.

• Added ‘list’ function for ectd library

v2.0.1 (2020-09-24)

• Move etcd/kafka address values to be similar to what OpenOLT uses

• Small amount of ‘assert’ cleanup flagged by bandit

v2.0.0 (2020-09-20)

• Pre-release with all but Alarms/Events and logging up to date with v2.4 release of VOLTHA

• Much refactoring of python 2.7 code with movement toward at least python 3.5 and later supported

• Dropped import of __future__ and six (to some extent)

• Removed simple ONU-only device events related to OMCI

• Dropped transitions, pcapy, and scapy imports (no longer required)

• Added missing ‘child_device_lost’ IAdapter RPC as well as a few other IAdapter and inter-adapter API bit rot cleaned up