Gitiles
Code Review Sign In
gerrit.opencord.org / voltha-protos / 31a356cbdbfaf843933f79f0aa6de7580c8caf7e
commit31a356cbdbfaf843933f79f0aa6de7580c8caf7e[log] [tgz]
authorGirish Gowdra <girish@opennetworking.org>Fri May 14 15:56:04 2021 -0700
committerGirish Gowdra <girish@opennetworking.org>Fri May 14 15:57:58 2021 -0700
treeba3422b1992e567fe51625c574a1fbfa23667b61
parentda19b455a0f2108d2b5b46ed69a05e184ce4fcce [diff]
VOL-4077: Add onu-id and uni-id in PacketIndication message
- The openolt-agent application shall pass this information
  for PacketIndication message arriving from the PON port.

Change-Id: I940c8e6dd14228fe5b3528a0f2fdb51f5a40c5b5
4 files changed
tree: ba3422b1992e567fe51625c574a1fbfa23667b61
  1. .gitignore
  2. .gitreview
  3. CODE_OF_CONDUCT.md
  4. MANIFEST.in
  5. Makefile
  6. README.md
  7. VERSION
  8. go.mod
  9. go.sum
  10. go/
  11. protos/
  12. protoset.go
  13. python/
  14. setup.py
  15. test/
  16. tox.ini
  17. voltha.pb
README.md

voltha-protos

Protobuf files used by VOLTHA.

Currently this is used to generate both Golang and Python protobufs and gRPC stubs.

The testing process is dependent on specific versions of the protobuf tools, so make sure to use the versions of protoc and protoc-gen-go specified below.

Protobuf definition files are located in protos/voltha_protos directory. This directory hierarchy and import scheme is required to allow the python code generated by the gRPC compiler to have the correct import paths.

NOTE: The protos/google/api directory has files copied from the Google APIs, and is only included for initial compilation of the VOLTHA protobuf files - these API's should be installed independently via either the python googleapis-common-protos package or the golang go-genproto repo.

Go Environment

Get the voltha-protos repository:

mkdir -p ~/source
cd ~/source
git clone https://gerrit.opencord.org/voltha-protos
cd voltha-protos

Setting up the Go environment

After installing Go on a Mac or Linux environment, the GOPATH environment variable needs be set. These instructions assume it's ~/go.

Create a symbolic link in the $GOPATH/src tree to the voltha-go repository:

mkdir -p $GOPATH/src/github.com/opencord
ln -s ~/source/voltha-protos $GOPATH/src/github.com/opencord/voltha-protos

Go Dependencies

Install Dependencies

Checkout and go install correct version of protoc-gen-go:

GIT_TAG="v1.3.1"
go get -d -u github.com/golang/protobuf/protoc-gen-go
git -C "$(go env GOPATH)"/src/github.com/golang/protobuf checkout $GIT_TAG
go install github.com/golang/protobuf/protoc-gen-go

Building locally

Install the protobuf compiler (protoc) 3.7.0 either manually or via the Makefile target (if on Linux amd64). Then build the python and golang stubs:

cd $GOPATH/src/github.com/opencord/voltha-protos
make install-protoc
make build

use dist/*.tar.gz for local python imports use go/ for local go imports

Using voltha-protos in your project

Python

Installation from Pypi:

pip install voltha-protos

or from a local build:

pip install ~/source/voltha-protos/dist/*.tar.gz

To use it within your code (for example)

from voltha_protos import voltha_pb2

Go

go get github.com/opencord/voltha-protos
cd $GOPATH/github.com/opencord/voltha-protos
make build

Protos are importable from github.com/opencord/voltha-protos/v2/go/<packagename>

To use the libraries, import protos with the root path github.com/opencord/voltha-protos/v2/go/

Testing

make test will run tests for all languages.