一、OpenBCI_GUI 项目概述 

（一）项目背景与目标

OpenBCI 是一个开源的脑电信号采集硬件平台，其配套的 OpenBCI_GUI 则是专为该硬件设计的图形化界面工具。对于研究人员、开发者和学生而言，首次接触 OpenBCI 设备时，往往面临数据可视化、实时处理及跨平台兼容性等挑战。OpenBCI_GUI 的核心目标是为所有 OpenBCI 设备（包括 Ganglion、Cyton 及 Cyton with Daisy）提供稳定且强大的操作界面，帮助用户快速实现脑电数据的采集、处理与分析。 

（二）核心功能解析

1.多设备与跨平台支持

兼容 Ganglion（无线单通道）、Cyton（8 通道 / 16 通道）及其扩展模块 Daisy（支持更多通道）。 

原生支持 macOS、Windows（64 位）和 Linux（如 Ubuntu 18+）系统，满足不同开发环境需求。 

2.数据可视化与处理

实时绘制脑电信号波形（时间序列图），支持垂直缩放（如 200μV 刻度）和时间窗口调整（如 10 秒显示范围）。 

提供 FFT 频谱分析功能，可直观显示信号频率分布，支持 60Hz 工频滤波及平滑处理（如 Log/Lin 模式、平滑因子0.98）。 

3.数据交互与扩展

支持通过 UDP、OSC、LSL（实验室流媒体层）和串口等协议将数据实时传输至 MATLAB 等第三方应用。 

提供数据文件保存功能，便于离线分析，文件格式兼容后续处理工具。

4.可扩展的插件框架

用户可通过 Widget 机制自定义实验界面，例如新增 SSVEP（稳态视觉诱发电位）功能模块或 CP5 下拉菜单控件，灵活适配不同研究场景。 

二、系统要求与环境准备  

（一）硬件要求

处理器：1.6 GHz 或更高主频（建议使用多核处理器以确保流畅运行）。

内存：至少 2 GB RAM（处理多通道数据时建议 4 GB 以上）。 

存储：400 MB 可用硬盘空间（用于安装软件及存储临时数据）。

显卡：需支持 OpenGL 加速，确保图形渲染性能（集成显卡通常可满足基本需求）。

（二）软件依赖

1.Processing IDE

OpenBCI_GUI 基于 Processing 框架开发，需先安装 Processing 4（当前兼容版本）。 

下载地址：Processing 官方网站

2.Java 运行环境（JRE）

macOS 用户若遇到对话框卡死问题（如 “SELECT PLAYBACK FILE” 无响应），需手动更新 JRE 至最新版本，确保与GUI 的兼容性。 

三、快速安装与启动指南

（一）从 GitHub 获取源码 

克隆仓库在终端或 Git 客户端中执行以下命令： 

git clone https://github.com/OpenBCI/OpenBCI_GUI.git 
cd OpenBCI_GUI 

目录结构说明

OpenBCI_GUI：核心代码文件夹，包含主程序及 UI 组件。 

tools：辅助工具，如用于下载图形界面资源的 Python 脚本。 

release：预编译的可执行文件（适用于不想编译源码的用户）。

CHANGELOG.md：版本更新日志，记录功能迭代与 bug 修复。 

（二）通过 Processing IDE 运行 

1.运行

打开项目启动 Processing IDE，选择 “文件> 打开”，定位到OpenBCI_GUI目录下的OpenBCI_GUI.pde文件。 

2.编译与运行

点击 IDE 顶部的 “运行” 按钮（▶️），首次运行时 Processing 会自动下载所需库文件（如 ControlP5 UI 库）。 

若提示缺少依赖，可手动通过 “Sketch> Import Library > Add Library” 搜索并安装ControlP5和PeasyCam等库。 

3.下载

下载对应系统的安装包进入OpenBCI_GUI Releases 页面，根据系统选择.dmg（macOS）、.exe（Windows）或.deb（Linux）安装包。 

4.安装与启动

macOS：将应用拖入 “应用程序” 文件夹，双击图标启动。 

Windows/Linux：按提示完成安装，通过桌面快捷方式或命令行启动。

四、界面初步探索

（一）主界面布局

（注：截图来源于项目仓库，实际界面可能因版本更新略有差异）

（二）首次连接设备

硬件准备确保 OpenBCI 设备已开机并通过 USB（Cyton）或蓝牙（Ganglion）与电脑连接。 

设备配置

点击顶部导航栏的 “System Control Panel”，在 “Board Setup” 中选择设备类型（如 “Ganglion”）。 

点击 “Connect” 按钮，等待界面显示 “Connected” 及实时数据波动，即表示连接成功。