onosproject/ran-simulator

Ran Simulator

镜像概述和主要用途

Ran Simulator是µONOS的一部分，旨在与onos-ric和sd-ran-gui配合工作。该模拟器模拟一组基站（Cell Towers）和沿不同位置间路线移动的UE（用户设备）集合，用于µONOS生态中的RAN网络模拟、测试与开发。

核心功能和特性

• 基站与UE模拟：模拟基站集群及沿预设路线移动的UE设备群体
• 高度可配置：通过丰富的启动参数调整模拟行为，包括基站数量、UE分布、路线特性等
• 多环境部署：支持作为Docker独立应用运行或部署在Kubernetes集群中
• 地图集成：可选通过Google Directions API生成真实路线（需API密钥），无API时自动生成随机路线（通常为锯齿形）

使用场景和适用范围

• µONOS RAN（无线电接入网）功能的开发与测试验证
• 网络拓扑和UE移动性场景模拟
• 与onos-ric和sd-ran-gui构建完整的SD-RAN测试环境

使用方法和配置说明

Google Maps API Key

RAN Simulator可通过Google API密钥连接Google https://developers.google.com/maps/documentation/directions/start。Google对https://developers.google.com/maps/documentation/directions/start的收费为每1000次请求5.00***，因此未公开提供API密钥。无API密钥时，路线将在两个位置之间随机生成（通常为锯齿形）。

SD RAN GUI（单独）也会访问Google [Maps API]，额外产生每1000次请求7.00***的费用。

启动参数

向ran-simulator提供无效参数可显示所有启动参数及其默认值：

bash
docker run -it docker.xuanyuan.run/onosproject/ran-simulator:latest -test

参数说明：

• -caPath string：CA证书路径
• -certPath string：客户端证书路径
• -fade：启动时地图显示为淡色（默认true）
• -googleAPIKey string：Google地图API密钥
• -keyPath string：客户端私钥路径
• -mapCenterLat float：地图中心纬度（默认52.52）
• -mapCenterLng float：地图中心经度（默认13.405）
• -maxUEsPerTower：每基站最大UE数量
• -numLocations int：位置数量（默认10）
• -numRoutes int：路线数量（默认3）
• -showRoutes：启动时显示路线（默认true）
• -stepDelayMs int：路线步骤间延迟（毫秒，默认1000）
• -towerCols int：基站列数（默认3）
• -towerRows int：基站行数（默认3）
• -towerSpacingHoriz float：基站水平间距（经度度数，默认0.02）
• -towerSpacingVert float：基站垂直间距（纬度度数，默认0.02）
• -zoom float：初始缩放级别（默认12）

Kubernetes部署

有关如何在Kubernetes部署中修改这些参数，请参见deployment.md。

浏览器访问

与sd-ran-gui应用一起部署时，可通过浏览器访问模拟界面。