一、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” 及实时数据波动，即表示连接成功。
