OpenBCI + OpenViBE + Python: 实时运动想象小球控制系统

快速开始

第一阶段：模型训练 (Calibration)

1. 启动 OpenBCI 采集并连接 OpenViBE Acquisition Server。
2. 运行 mi-csp-1-acquisition.xml: 跟随屏幕箭头提示（动觉想象），采集约 20-40 组数据。
3. 运行 **mi-csp-2-train-CSP.xml**: 生成 csp-spatial-filter.cfg。
4. 运行 **mi-csp-3-classifier-trainer.xml**: 生成 classifier.cfg。确保准确率 > 60-70%。

第二阶段：在线控制 (Online Free Run)

1. 打开 mi-csp-5-freerun-analysis.xml (本项目修改版)。
   • 该场景去除了箭头提示。
   • 使用 Python 3 Scripting 盒子通过 LSL 发送实时控制信号。
2. 点击 OpenViBE Play。
3. 开始想象左右手运动，控制小球移动。

运行 Python 游戏脚本：

python move_ball.py 

项目文件说明

• openvibe_scenarios/: 修改后的 OpenViBE 场景文件 (OpenViBE 的示例文件通常安装在 C:\Program Files\OpenViBE\share\openvibe\scenarios\ ，受权限影响要拷贝到其它地方 )。
  • 包含 LSL 输出功能的 Python 脚本代码。
• python_game/move_ball.py: PyGame 前端程序。

🛠️ 踩坑指南与常见问题 (FAQ)

在开发过程中遇到的问题及解决方案，供参考：

Q1: OpenViBE 里找不到 Python Scripting 盒子？

• 原因: OpenViBE 启动时没找到指定版本的 Python DLL。
• 解决:
  1. 重新安装 Python 3.10 (64-bit) 并勾选 'Add to PATH'。
  2. 检查控制台日志是否显示 Python initialized successfully。

修改 openvibe.conf (AppData/Roaming/openvibe/)，添加：

Global_Python3_Path = "C:\Path\To\Python310\python310.dll" 

Q2: Python 3.13 运行 PyGame 报错 ImportError: cannot import name 'resolve_stream'

• 原因: 新版 pylsl 在 Python 3.13 环境下 API 变动。

解决: 使用 resolve_streams (复数) 获取列表，然后遍历查找名字。

streams = resolve_streams()
for s in streams:
    if s.name()=="BCI_Control_Signal":
        ...

Q3: 运行出错：Lua error

• 原因: motor-imagery-bci-graz-stimulator.lua 中 math.random 函数只能接受整数。
• 解决: 给参数加上 math.floor() 强制转为整数。

Q4: OpenViBE 传给 Python 的数据是 [val1, val2] 两个数？

• 原因: 分类器输出可能是两个类别的得分矩阵。

解决: 在 OpenViBE 的 Python 脚本中计算差值：

# 伪代码
control_val = chunk[0] - chunk[1]  # 左手得分 - 右手得分
outlet.push_sample([control_val])

Q5: openvibe acquisition server 选 openbci，不勾选 Daisy module，应该是 8 个通道才对，为什么打开 change channel names 却有 11 个通道呢？

• 原因: 通道 9、10、11 是 OpenBCI 板载的'三轴加速度计' (Accelerometer X, Y, Z) 数据。对于你的 运动想象 (Motor Imagery) 实验，这三个通道的数据是完全不需要甚至有害的。把这三个通道喂给 CSP (Common Spatial Pattern) 算法，CSP 会试图去拟合这些巨大的方差，导致计算出来的空间滤波器完全跑偏，原本应该提取 C3/C4 特征的滤波器变成了提取'头皮抖动'的滤波器。
• 解决: Acquisition Client 盒子后面紧接着连一个 Channel Selector 盒子，双击 Channel Selector，设置 Select 条件为：
  1:8 (表示只保留前 8 个) 或者直接写名字 C3;C4;Cz;FC3;FC4;CP3;CP4;Pz。

另外在可使用相关实验指导工具，但需小心，部分转换功能可能不易找到。