voltha/voltha-bbsim

废弃通知

本仓库已被弃用，建议使用完全重写的版本，开发地址：https://github.com/opencord/bbsim

1. 概述与功能

BBSim（宽带模拟器）是一款软件模拟器，用于模拟OLT和ONU通过OpenOLT适配器向VOLTHA/ONOS发送的控制消息响应（如OLTInd、DHCP、EAPOL、OpenOMCI消息等）。该模拟器运行在Docker容器中，模拟连接多个ONU的OLT设备。可用于VOLTHA、DHCP L2中继（https://github.com/opencord/dhcpl2relay%EF%BC%89%E5%92%8CONOS%E4%B8%8A%E7%9A%84AAA%EF%BC%88https://github.com/opencord/aaa%EF%BC%89%E5%BA%94%E7%94%A8%E7%9A%84%E5%8F%AF%E6%89%A9%E5%B1%95%E6%80%A7%E6%B5%8B%E8%AF%95%E3%80%82%E4%B8%8EPONsim%E7%9A%84%E5%8C%BA%E5%88%AB%E5%9C%A8%E4%BA%8E%EF%BC%8CBBSim%E4%B8%93%E6%B3%A8%E4%BA%8E%E6%8E%A7%E5%88%B6%E6%B6%88%E6%81%AF%E6%A8%A1%E6%8B%9F%EF%BC%8C%E8%80%8C%E9%9D%9EPONsim%E9%92%88%E5%AF%B9%E7%9A%84%E6%95%B0%E6%8D%AE%E8%B7%AF%E5%BE%84%E6%B5%81%E9%87%8F%E3%80%82

                 +--------------------------------------------------+
                 |                      VOLTHA Core                 |
                 +--------------------------------------------------+
                 +--------------------------------------------------+
                 |                     OpenOLT Adapter              |
                 +------------------------^-------------------------+
                 +------------------------|-------------------------+
                 |Container---------------|-----------------------+ |
                 |        |BBSim          |                       | |
                 |        |  +------------v---------------------+ | |
                 |        |  |          gRPC Server             | | |
                 |        |  +------------^---------------------+ | |
                 |+------+|  +------------|---------------------+ | |
                 ||      ||  |CoreServer  |                     | | |
                 ||DHCP  ||  | +----------v-------------------+ | | |
                 ||Server <--->|         MainPktLoop          | | | |
                 ||      ||  | +---^--------^-------------^---+ | | |
                 |+------+|  +-----|--------|-------------|-----+ | |
                 |        |  +-----v---++---v-----++------v-----+ | |
                 |        |  |OMCI     ||EAPOL    || DHCP       | | |
                 |        |  |Responder||Responder|| Responder  | | |
                 |        |  +---------++---------++------------+ | |
                 |        +---------------------------------------+ |
                 +--------------------------------------------------+

2. 构建、运行BBSim及VOLTHA-CLI命令

※ 若要测试AAA/DHCP，需先配置SADIS（参考第3节）。

# 构建并运行Docker容器
git clone https://github.com/opencord/voltha-bbsim
cd voltha-bbsim
make docker
docker run -it --rm --privileged=true --expose=50060 --network=compose_default voltha/voltha-bbsim ./bbsim -n 16

# 之后在VOLTHA-CLI中执行以下命令
(voltha) health
{
    "state": "HEALTHY"
}
(voltha) preprovision_olt -t openolt -H <BBSim Docker容器IP>
success (device id = <deviceid>)
(voltha) enable
enabling <deviceid>
waiting for device to be enabled...
success (device id = <deviceid>)
(voltha) devices
## 可查看设备列表（OLT/ONUs）##

3. ONOS应用端配置（VOLTHA 1.7，ONOS1.13.9.rc4）

运行BBSim前需为AAA/DHCPL2Relay应用配置参数，需在.netconf文件中设置：1. BBSim分配的设备ID（如of:******）；2. BBSim ONU实例设备ID对应的c/sTag和技术配置文件。（关于ONOS中的NETCONF支持，请参考[]

    "org.opencord.dhcpl2relay" : {
           "dhcpl2relay" : {
               "dhcpServerConnectPoints" : [ "<device id assigned to BBSim>/65536" ],
               "useOltUplinkForServerPktInOut" : true
           }
    },

    ....
    
    "org.opencord.sadis" : {
        "sadis" : {
              "entries":[
              {
                "id" : "BBSIMOLT000",
                "hardwareIdentifier" : "de:ad:be:ef:ba:11",
                "uplinkPort" : 65536
              },
        //BBSim生成每个ONU的设备ID和c/stag，从BBSM00000100、900开始递增1。
        //以下是配置2个ONU的示例：
       {"id" : "BBSM00000100", "cTag" : 900, "sTag" : 900, "nasPortId" : "BBSM00000100", "technologyProfileId" : 64,  "upstreamBandwidthProfile":"High-Speed-Internet", "downstreamBandwidthProfile":"User1-Specific"},
       {"id" : "BBSM00000101", "cTag" : 901, "sTag" : 901, "nasPortId" : "BBSM00000101", "technologyProfileId" : 64,  "upstreamBandwidthProfile":"High-Speed-Internet", "downstreamBandwidthProfile":"User1-Specific"},

      ......

4. CLI选项

Usage of ./bbsim:
  -H string
      IP地址:端口（默认 ":50060"）
  -aw int
      EAPOL流条目安装后激活WPA supplicants的等待时间（秒）（默认 2）
  -d string
      调试级别（TRACE DEBUG INFO WARN ERROR）（默认 "DEBUG"）
  -dw int
      DHCP流条目安装后激活DHCP客户端的等待时间（秒）（默认 2）
  -i int
      PON-IF端口数量（默认 1）
  -id int
      OLT-ID
  -k string
      Kafka broker
  -m string
      模拟模式（default, aaa, both (aaa & dhcp)）（默认 "default"）
  -n int
      每个PON-IF端口的ONU数量（默认 1）
  -s string
      DHCP服务器IP地址（默认 "182.21.0.128"）
  -v int
      每个发现指示的间隔，格式为单位+后缀，如'10ms'、'1s'或'1m'（默认 0）
  -ia bool
      ONU的交互式激活：若为true，ONU需通过管理API显式激活（启动时不激活任何ONU）（默认 false）
  -grpc int
      管理API gRPC端口（默认 50061）
  -rest int
      管理API rest端口（默认 50062）