ControlBoard 控制面板
约 1946 字
ControlBoard 位于 Client 左侧,负责把视觉、发射机、策略进程、仿真器和裁判系统连接起来。第一次使用时,不必逐项理解所有参数:先根据运行场景完成快速配置,再进入对应控件查看细节。
ControlBoard 由四个 Tab 组成,如下图所示,从左往右依次为:主界面,裁判界面,LOG界面,设置界面

功能导航
选择网卡、视觉源、相机与仿真/实车模式。
配置车型协议、串口和无线频点,连接实车。
选择队伍、方向、模式、测试脚本与战术包。
启动外置 grSim,并选择 GUI 与通信协议。
发送裁判指令、设置下一指令并查看裁判数据。
录制比赛数据、回放 REC 文件并定位关键比赛事件。
查看球速,以及安全终止 Client 拉起的全部进程。
按场景快速启动
配置 Vision
选择回环网卡
lo,grSim IP 选择127.0.0.1,模式切到 Simulation,然后连接视觉。配置 Medusa
选择进攻方向、队伍颜色和运行模式;日常联调可开启 Test Mode 并选择 TestPlay。
启动策略
点击对应颜色的 Medusa 启动按钮。内置 ZSimulator 不需要配置 Radio 或外置 grSim。
确认网络
选择能够接收视觉组播的有线或无线网卡,刷新并选择正确的 grSim IP,模式保持 Simulation。
配置 grSim
根据仿真器版本选择通信协议;需要本机拉起仿真器时,再开启 grSim 控件。
启动 Medusa
选择队伍、方向与战术配置后启动。若视觉正常但车辆不动,优先检查 grSim IP 和协议。
连接视觉
选择场地网络对应的网卡,将模式切到 Real,确认状态栏中的本机 IP 后连接视觉。
连接发射机
确认串口权限,选择本方串口、比赛约定频点,并标记使用途零协议的车号,然后连接 Radio。
启动 Medusa
核对队伍颜色与进攻方向后启动。正式比赛可在配置验证无误后启用守护进程。
启动前检查
- 实车/仿真模式必须正确,避免向错误目标发送控制数据。
- 队伍颜色与进攻方向必须一致,否则策略会以错误坐标系运行。
- 公共网络中不要随意开启内置裁判盒;实车频点需提前与其他队伍协调。
推荐启动顺序
ControlBoard 中各模块存在前后依赖。无论使用仿真还是实车,都建议按“数据源 → 控制出口 → 策略”的顺序启动:
| 顺序 | 操作 | 完成标志 | 不通过时 |
|---|---|---|---|
| 1 | 确认网络与运行模式 | 网卡、IP、Simulation / Real 与场景一致 | 不要继续启动后续模块 |
| 2 | 连接 Vision | TopBar 的 VISION FPS 持续更新,画布中的球和机器人位置正常 | 检查网卡、grSim IP、相机和视觉源 |
| 3 | 准备控制出口 | 仿真器已运行,或本方 Radio 已连接 | 检查仿真协议,或串口权限、频点和车型协议 |
| 4 | 核对 Medusa 参数 | 颜色、方向、Test Mode、TestPlay、战术包均正确 | 修改参数后重新核对,不要带着旧配置启动 |
| 5 | 启动 Medusa | 对应颜色的 FPS 持续更新,车辆按预期响应 | 根据下方故障表逐项定位 |
| 6 | 需要时连接裁判源 | 当前指令与 source_identifier 符合预期 | 检查裁判源过滤,避免接收错误来源 |
为什么先连接 Vision
Medusa 需要持续获得球和机器人的位置才能正确决策。先确认 Vision FPS 和画面正常,可以把“没有数据”与“策略或控制链路故障”分开,减少排查范围。
比赛前完整检查清单
网络与视觉
仿真或实车出口
策略与裁判
按现象快速排障
| 现象 | 优先检查 | 对应页面 |
|---|---|---|
VISION FPS 为 0 | 网卡、视觉源 IP、相机选择、Vision 是否已连接 | Vision 视觉 |
| 画面正常,但仿真车不动 | Simulation 模式、grSim IP、grSim 协议、Medusa FPS | grSim 仿真 |
| 实车全部不动 | Radio 串口权限、连接状态、频点、本方颜色 | Radio 发射机 |
| 只有部分实车不动 | 对应车号的乐博 / 途零协议、车辆上电与无线状态 | Radio 发射机 |
| 车辆方向或攻防目标相反 | 队伍颜色与进攻方向 | Medusa 策略 |
| TestPlay 没有运行 | 本方 Test Mode、脚本选择、脚本列表是否刷新 | Medusa 策略 |
| 收到意外裁判指令 | source_identifier、Source Filter、局域网内其他裁判盒 | 裁判系统 |
| 重启 Client 后端口仍被占用 | 是否仍有 Medusa、grSim 或裁判进程残留 | 运行监控与进程终止 |
推荐停止顺序
普通测试结束时,先停止 Medusa,再断开 Radio 或关闭 grSim,最后断开 Vision。需要彻底退出整套环境时,使用 Kill 清理 Client 拉起的相关进程;不要只关闭窗口后直接开始下一轮测试,否则残留进程可能继续占用端口或发送数据。
顶部 TabBar
TabBar 将 ControlBoard 分为四个工作区:
| Tab | 用途 | 常用时机 |
|---|---|---|
| 主界面 | Vision、Radio、Medusa、grSim 与运行监控 | 每次启动和比赛前配置 |
| 裁判模拟 | 发送、接收与检查裁判指令 | 本地联调、观察比赛状态 |
| LOG 录制与回放 | 记录或复现运行数据 | 问题复盘、算法调试 |
| 参数设置 | 修改 Client 运行参数 | 环境搭建或专项调参 |