voltha/voltha-netconf

VOLTHA

什么是VOLTHA？

VOLTHA旨在为传统及下一代接入网络设备提供一层抽象层，以实现控制与管理功能。其初始焦点为PON技术（GPON、EPON、NG PON 2），最终目标覆盖其他接入技术（xDSL、Docsis、G.FAST、专用以太网、固定无线）。

核心概念

• 网络即交换机：将一组连接的接入网络设备抽象为可编程流设备（L2/L3/L4交换机），例如：
  • PON作为交换机
  • PON+接入回传作为交换机
  • xDSL服务作为交换机
• 虚拟化演进：支持多种接入技术与设备（传统、完全虚拟化及中间形态），可运行于设备、中心机房通用服务器或数据中心。
• 统一OAM抽象：提供与厂商、技术无关的统一设备管理能力，包括服务生命周期、设备生命周期（发现、升级）、系统监控、告警、故障排查、安全等。
• 云/DevOps现代化桥梁：将抽象的网络功能视为软件服务，可像云环境中其他软件组件（如容器）一样管理。

为什么选择VOLTHA？

接入网络领域的控制与管理存在碎片化问题：每种接入技术有独立协议，厂商对标准的解读/扩展各异，且这些差异渗透到服务提供商的集中式OSS系统，导致效率低下。VOLTHA通过将差异限制在接入层本地、向OSS上层隐藏差异，逐步实现同一接入技术的厂商设备提供一致接口、跨技术更高协同的目标。

如何使用VOLTHA？

当前处于开发早期阶段，可参考BUILD.md文件了解构建、运行、测试等操作。

如何贡献？

欢迎各类大小贡献：小修改与bug修复可直接提交PR；大型工作建议先与现有开发者沟通，确保方案符合VOLTHA理念。

贡献单元测试

1. 按OpenCord WIKI安装开发环境。
2. 在Shell环境执行：

bash
source env.sh;             # 加载环境设置并创建虚拟环境
make utest-with-coverage;  # 执行带覆盖率报告的单元测试

核心单元测试

核心模块的新单元测试需基于https://nose.readthedocs.io/en/latest/%E6%A1%86%E6%9E%B6%E7%BC%96%E5%86%99%EF%BC%8C%E5%AD%98%E6%94%BE%E4%BA%8E%60/tests/utest/`目录。

适配器单元测试

每个适配器的单元测试通过其目录下的test.mk子Makefile识别。例如：

Makefile
# voltha/adapters/my_new_adapter/test.mk
.PHONY: test
test:
   @echo "测试我的新适配器"
   @./my_test_harness

VOLTHA测试框架会执行子Makefile中的第一个目标作为单元测试函数，支持多种测试框架（pytest、unittest、tox）或语言（Go、Rust、PHP）。若需上报覆盖率，测试工具需生成https://www.ibm.com/support/knowledgecenter/en/SSUFAU_1.0.0/com.ibm.rsar.analysis.codereview.cobol.doc/topics/cac_useresults_junit.html%E6%A0%BC%E5%BC%8F%E6%8A%A5%E5%91%8A%EF%BC%8C%E6%96%87%E4%BB%B6%E5%91%BD%E5%90%8D%E4%B8%BA%60junit-report.xml%60%EF%BC%88Jenkins%E4%BB%BB%E5%8A%A1%E5%B0%86%E8%87%AA%E5%8A%A8%E8%AF%86%E5%88%AB%EF%BC%89%E3%80%82