The OpenOLT agent runs on white box Optical Line Terminals (OLTs) and provides a gRPC-based management and control interface to OLTs.
The OpenOLT agent is used by VOLTHA through the OpenOLT adapter.
OpenOLT agent uses Broadcom's BAL (Broadband Access Layer) software for Maple/Qumran chipsets based OLT such as the EdgeCore/Accton ASFVOLT16.
+---------------------------------+
| VOLTHA |
| |
| +------------------+ |
| | OpenOLT adapter | |
+-------+--------+---------+------+
|
OpenOLT gRPC API |
|
+--------------------- ---------------+
| | |
| +------------------+ |
| | OpenOLT agent | |
| +--------+---------+ |
| | |
| Vendor specific | (e.g. Broadcom |
| API | BAL API |
| | |
| +------------------+ |
| | Vendor SoC/FPGA | |
| |(e.g Maple/Qumran)| |
| +------------------+ |
| |
| White box OLT |
+-------------------------------------+
A list of tested devices and optics can be found in the CORD hardware requirements guide, in the R-CORD access equipment and optics section.
Accton/Edgecore makes available pre-built debian packages of OpenOLT agent to their customers. Contact your Accton/Edgecore representative for more information.
The pre-built debian packages have been tested on this specific version of OpenNetworkingLinux (ONL).
More info on how to install ONL can be found on the official ONL website.
Copy the debian package to the OLT. For example:
scp openolt.deb root@10.6.0.201:~/.
Install the openolt.deb package using dpkg:
dpkg -i openolt.deb
Rebooting the OLT (after the installation) will start bal_core_dist and openolt as init.d services:
Rebooting the OLT will start the bal_core_dist and openolt services:
reboot
The services can also be stopped/started manually:
service bal_core_dist stop
service openolt stop
service bal_core_dist start
service openolt start
Check the status of the services:
service bal_core_dist status
service openolt status
Running the bal_core_dist and/or openolt services in the forground is useful for development and debugging. Make sure to first stop the services if they are running in background.
Open a terminal and run the Broadcom BAL software (bal_core_dist):
cd /broadcom
./bal_core_dist -C :55001
The bal_core_dist
executable, when run in foreground, presents the CLI for Broadcom's BAL - Broadband Access Layer which is useful for debugging.
While the first executable still runs (even in background), open another terminal and run openolt:
cd /broadcom
./openolt -C 127.0.0.1:55001
NOTE: the two executables will remain open in the terminals, unless they are put in background.
At the VOLTHA CLI, preprovision and enable the OLT:
(voltha) preprovision_olt -t openolt -H YOUR_OLT_MGMT_IP:9191
(voltha) enable
- 9191 is the TCP port that the OpenOLT agent uses for its gRPC channel
- In the commands above, you can either use the loopback IP address (127.0.0.1) or substitute all its occurrences with the management IP of your OLT
Currently, OpenOLT supports Broadcom's BAL API, version 2.6.0.1.
The following proprietary source code is required to build the OpenOLT agent.
SW-BCM68620_<BAL_VER>.zip
- Broadcom BAL source and Maple SDKsdk-all-<SDK_VER>.tar.gz
- Broadcom Qumran SDKACCTON_BAL_<BAL_VER>-<ACCTON_VER>.patch
- Accton/Edgecore's patchOPENOLT_BAL_<BAL_VER>.patch
- A patch to Broadcom software to allow compilation with C++ based openolt
The versions currently supported by the OpenOLT agent are:
- SW-BCM68620_2_6_0_1.zip
- sdk-all-6.5.7.tar.gz
- ACCTON_BAL_2.6.0.1-V201804301043.patch
- OPENOLT_BAL_2.6.0.1.patch
NOTE: the repository does not contain the above four source packages. These are needed to build the OpenOLT agent executable. Contact Broadcom to access the source packages.
OpenOLT agent builds on Ubuntu 14.04 LTS.
Clone the openolt repository either from GitHub or from OpenCORD Gerrit:
git clone git@github.com:opencord/openolt.git
or
git clone https://gerrit.opencord.org/openolt
Copy the Broadcom source and patch files to the openolt/download directory:
cd openolt/download
cp SW-BCM68620_2_6_0_1.zip sdk-all-6.5.7.tar.gz ACCTON_BAL_2.6.0.1-V201804301043.patch OPENOLT_BAL_2.6.0.1.patch ./download
Run Autoconfig to generate the appropriate makefile scaffolding for the desired target
cd openolt
./configure
Run make prereq to install the package dependencies. This is usually a one-time thing, unless there is a change in the dependencies.
make OPENOLTDEVICE=asfvolt16 prereq
Run make. This can take a while to complete the first time, since it builds ONL and the Broadcom SDKs. Following runs will be much faster, as they only build the OpenOLT agent source.
make OPENOLTDEVICE=asfvolt16
If the build process succeeds, libraries and executables will be created in the openolt/build directory.
Optionally, build the debian package that will be installed on the OLT.
make OPENOLTDEVICE=asfvolt16 deb
If the build process succeeds, the openolt.deb package will be created as well in the openolt/build directory.
To cleanup the repository and start the build procedure again, run:
make OPENOLTDEVICE=asfvolt16 clean-all
The information here may be specific to specific OLT and ONU hardware such as Edgecore ASFVOLT16 OLT and Broadcom based ONUs.
Auto-negotiation on the NNI (uplink) interfaces is not tested. By default, the OpenOLT agent sets the speed of the NNI interfaces to 100G. To downgrade the network interface speed to 40G, add the following lines at the end of the qax.soc (/broadcom/qax.soc) configuration file. A restart of the bal_core_dist and openolt executables is required after the change.
port ce128 sp=40000
This change can also be made at run-time from the CLI of the bal_core_dist:
d/s/shell
port ce128 speed=40000
(It is safe to ignore the error msgs.)
The firmware on the ONU is likely not setup to forward 802.1x on the linux bridge. Drop down to the shell in the Broadcom ONU's console and configure the Linux bridge to forward 802.1x.
> sh
# echo 8 > /sys/class/net/bronu513/bridge/group_fwd_mask
Version 1.6 of VOLTHA has a known issue where the ONU is only able to pass EAPOL packets from a specific LAN port (e.g. LAN port 1 on ALPHA ONUs)
LAN port packet counters:
bs /b/e port/index=lan{0,1,2,3,4,5,6}
WAN port packt counters:
bs /b/e port/index=wan0
Following is an example of retrieving the interface description for PON intf_id 0 (TODO: document PON interface numbering for Edgecore OLT).
ACC.0>b/t clear=no object=interface intf_id=0 intf_type=pon
[-- API Start: bcmbal_stat_get --]
[-- API Message Data --]
object: interface - BAL interface object
get stat: response: OK
key:
intf_id=0
intf_type=pon
data:
rx_bytes=18473516
rx_packets=176416
rx_ucast_packets=30627
rx_mcast_packets=2230
rx_bcast_packets=143559
rx_error_packets=0
rx_unknown_protos=0
rx_crc_errors=0
bip_errors=0
tx_bytes=5261350
tx_packets=39164
tx_ucast_packets=30583
tx_mcast_packets=0
tx_bcast_packets=8581
tx_error_packets=0
[-- API Complete: 0 (OK) --]
Following command retrieves NNI intf_id 0:
ACC.0>b/t clear=no object=interface intf_id=0 intf_type=nniCollecting statistics
[-- API Start: bcmbal_stat_get --]
[-- API Message Data --]
object: interface - BAL interface object
get stat: response: OK
key:
intf_id=0
intf_type=nni
data:
rx_bytes=8588348
rx_packets=69774
rx_ucast_packets=61189
rx_mcast_packets=0
rx_bcast_packets=8585
rx_error_packets=0
rx_unknown_protos=0
tx_bytes=35354878
tx_packets=347167
tx_ucast_packets=61274
tx_mcast_packets=4447
tx_bcast_packets=281446
tx_error_packets=0
[-- API Complete: 0 (OK) --]
In the bal_core_dist CLI:
> ~, Debug/, Maple/, Board/, Cld/, Transport/, Logger/, Quit
> Debug
.../Debug> Rsc_mgr/, Mac_util/, Switch/, sLeep, sHow_config, os/
> Mac_util
.../Mac_util> Print_flows, pRint_flows_for_gem, prInt_flows_for_alloc_id, Epon_helper
> Print_flow