无线脑电原型实战：BW16+ESP32-CYD低成本实时波形显示

做脑电相关的东西，大多数人第一反应是贵、难、医疗级。但这两年开源脑电模块和低成本自带屏的开发板把门槛压得很低。我这次用一块 BW16 无线模组、一块 ESP32-CYD 彩色屏开发板，再接一颗常见的单通道脑电模块，搭了一条从头皮到屏幕、再到手机网页的无线 EEG 原型链路。整条链路下来，材料成本能被压到两百块以内，却能完成实时波形显示、专注度数值读取和局域网网页可视化。如果你是一个想入门脑机接口的嵌入式爱好者，或者想给学生做生物反馈演示，这条链路可以直接抄作业。文章后面会把我踩过的坑、量过的时序、改过的方案都放出来，尽量让每个节点都具备可复现性。

1. 项目定位：为什么是 BW16 加上 ESP32-CYD

1.1 从一颗脑电模块说起

我手上的脑电模块是一颗基于 NeuroSky TGAM 方案的单通道模块，板上已经做好了仪表放大和滤波，输出端只有一根 UART 串口，波特率 57600，默认每秒吐 512 个原始脑电采样点，外加每一秒刷新一次的专注度（attention）和放松度（meditation）数值。这类模块在开源脑机接口圈很常见，适合做原型验证，不追求医疗级精度，但胜在接口简单、功耗低、上手快。

模块的原始输出是微伏级信号，经过放大后变成数字字节流，所以主控这边要做的第一件事不是电路放大，而是把串口字节流拆成有意义的数据包。你盯着波形看时，其实看到的是一串 12bit 或 16bit 的 raw wave 数值。这里要注意，不同模块的波特率和数据封装略有差异，先确认你手里的模块用的是什么协议，最好先接 USB 转 TTL 在电脑上看一下输出，再往 MCU 上接。我见过不少朋友跳过这一步，直接按别人的代码写，结果拆包全错，波形像是被猫扯过的毛线。

1.2 为什么要搞两块板子，而不是一块 ESP32 全包

很多人第一反应是：ESP32-CYD 自带 WiFi，直接把脑电模块接到 ESP32-CYD 上不就行了？理论可以，但实际会撞上两个问题。一是屏幕刷新和 WiFi 协议栈都占用中断和内存，如果再把脑电模块的串口解析塞进主循环，很容易造成数据丢包；二是 ESP32-CYD 主打彩色触屏，主控平时要处理显示缓冲，这时一个干净的采集前端就很有价值。

BW16 是瑞昱 RTL8720DN 方案的一颗小模组，支持 2.4GHz/5GHz 双频 WiFi 和低功耗蓝牙，主频百兆级别，跑一个串口透传加 socket 发送绰绰有余。我让 BW16 只负责一件事：从脑电模块读取串口数据，再通过 WiFi 发给 ESP32-CYD。采集端和显示端分开，干扰少，结构也清楚。ESP32-CYD 则专心做 TCP 接收、屏幕绘制、网页服务三件事，分工明确后，调试时就不会“一改代码全系统崩”。

1.3 链路整体架构：采集、传输、展示三层

我设计的链路分三层。第一层是数据采集，脑电模块通过 3.3V 串口接到 BW16 的 UART；第二层是无线传输，BW16 作为 WiFi Station，主动连接 ESP32-CYD 开出来的热点，并建立 TCP Socket 连接，把封好的 EEG 数据帧持续推送过去；第三层是数据展示，ESP32-CYD 拿到数据后，不仅在自己的 2.8 寸 TFT 屏幕上画实时波形，还开一个 WebSocket 服务，让局域网里的手机或电脑通过网页看同一份波形。

这里有两个可以调整的点。如果你希望链路更“中心化”，可以让 ESP32-CYD 连接家里的路由器，BW16 也连同一个路由器，两者通过 TCP 通信，手机同样访问 CYD 的 IP 即可。如果你需要现场演示，不依赖外部网络，就让 CYD 开热点，手机连上它的 WiFi，再访问http://192.168.4.1就能看到网页。我最后采用的是 CYD 开热点方案，因为演示时不用问会议室要 WiFi 密码，故障面更小。

1.4 整体投入与适用人群

这条链路里，BW16 模块大约十几块，ESP32-CYD 视容不同大约四五十块，脑电模块则看渠道，几十到一百多不等。整体材料成本能被压到两百块以内。它适合谁？想入门脑机接口但不想一开始就买整套医疗设备的爱好者，想给学生做生物反馈演示的创客老师，以及做可穿戴原型验证的嵌入式开发者。如果你只是想做一个能显示滚动曲线的“伪脑电”演示，也可以先不接真实模块，用上位机模拟数据跑通整条链路，再接入硬件。

2. 脑电数据解析：把二进制流变成可用数值

2.1 读懂串口帧的第一件事：找帧头

脑电模块输出的不是一行行文本，而是一段二进制流。以常见的 TGAM 协议为例，每帧以0xAA 0xAA开头，后面跟一个字节表示有效载荷长度，再后面是各段数据，最后有一个字节校验和。校验算法很直白：从表示长度的字节开始，到校验和前一个字节，所有字节加起来，用0x55 - sum就是校验值。

看起来简单，但是实操时最容易翻车的点在于，有效载荷里也有可能连续出现0xAA，你不能仅仅因为看到两个0xAA就以为一定是一帧的开始。我在写解析器时用的是状态机：先等两个连续0xAA，然后读取长度，如果长度超过一帧最大长度就直接丢弃重找，最后校验和不对也丢弃。这样才不会被噪声字节带偏。

2.2 从数据包里提取 raw wave 和 eSense

照协议，有效载荷里会有信号强度、专注度、放松度和原始脑波等字段。以 TGAM 来说，0x02是波形的值，后面两个字节组成 16bit 原始数据；0x80是信号强度，0x04专注度，0x05放松度。有了这套字段号，解析器就能精确地只挑需要的字段，不必关心顺序。注意有些模块的原始波形是低字节在前，有些是高字节在前，必须看模块文档，否则画出来的波形会抖动得很奇怪。

还有一个细节：这类的模块默认输出的原始采样点是 512Hz，也就是每秒 512 个样本。如果带宽足够，你可以把它全部传到屏幕上，但考虑到屏幕刷新和网页渲染的节奏，我不会每个样本都推一次网络。更合理的做法是在接收端做轻量聚合，比如攒 20 个点成一个批次，再一次性送去画波形。这个批次大小可以根据你设定的刷新帧率来回调，后面会具体讲。

2.3 MCU 端不要做重处理

很多新手拿到 raw wave 后，第一反应是在单片机里做一个 50Hz 陷波器或者卡尔曼滤波。并非不行，但要知道，一个 512Hz 采样率的数据流，如果在实时性要求很高的过程中跑了一次 FFT 或高阶 FIR，时间开销会直接影响主循环。原型阶段我更建议只在 MCU 上做两件事：去掉直流偏移，做个简单的滑动平均，剩下更重的滤波和频谱分析放到网页端 JavaScript 里做，因为浏览器里处理起来资源宽裕得多。

所谓去直流偏移，其实就是维护一个基线值，比如取最近 200 个样本的平均值，显示时把每个点减去这个基线。这样波形不会因为头皮电极的极化电位而整体偏离中线。如果后续要做 α/β 频段能量，最好在网页端用降采样后的数据做 FFT，这样效果更好，也不影响 MCU 实时性。

2.4 预留一个模拟数据源

我在正式接脑电模块之前，先给 BW16 写了一个模拟数据源：每秒生成 512 个正弦波采样点，通过同一套协议发给 ESP32-CYD。这个做法帮了大忙，因为可以在完全没有脑电信号干扰的情况下，先调通无线链路和 WebSocket，判断丢包率和网页绘制逻辑。等这些全部跑稳，再换成真实 EEG 模块，就只需要调解析这一层，问题范围瞬间缩小。

模拟数据源还有一个好处：你可以控制波形频率和幅值，测试屏幕在不同倍率下的响应。比如先用 10Hz 正弦波模拟 α 节律，看波形是不是刚好十个波峰；再用 100Hz 的方波测试高频响应和抗混叠。这样一旦接入真人信号，心里就有底。

2.5 一个数据帧的拆包实例

假设你的串口收到的原始字节是：

AA AA 04 02 12 34 80 00 04 30 08 ...

先看到AA AA，读长度0x04，表示后面有效载荷长度为 4 字节，那么从第三个字节开始到校验前为止，需要在这个范围内找带字段号的子段。02 12 34可以表示 raw wave，值0x1234；80 00可以表示信号质量；04 30可以表示专注度。最后一位08是校验和，验证时把0x04、0x02、0x12、0x34、0x80、0x00、0x04、0x30累加，然后0x55 - sum看是否等于0x08。注意我这里只是示意，实际模块的字段顺序不一定如此，但思路一样。

拆包最关键的是把状态机写成一个独立函数，串口一有字节就送进去，不要让解析逻辑阻塞在中断里。如果你用的是 Arduino 环境，建议把状态变量定义为全局结构体，每次调用一次性返回一个完整帧，主循环则只关心有没有结果。这样写出来的代码，接模块和接模拟数据源可以完全复用。

3. 无线链路搭建：BW16 到 ESP32-CYD 的实时通道

3.1 网络拓扑与通信方式的选择

我在这个项目里让 ESP32-CYD 创建了一个 AP 热点，固定 IP 为192.168.4.1，同时开启 TCP Server 和 WebSocket Server。BW16 作为 Station 连接这个热点，然后作为 TCP Client 去连 CYD 的 6666 端口。这样做的好处是，手机连上EEG-Link热点后，可以直接访问 80 或者 81 端口的网页，同时浏览器再建立 WebSocket 连接，整个拓扑只需要一个电源就能跑起来，不需要外部路由器。

通信协议我选了 TCP，而不是 UDP。原因很简单：脑电数据实时性要求虽然高，但带宽其实很小，原始数据算下来也就是 512 样本 × 2 字节，10kbps 左右，TCP 的拥塞控制根本不会成为瓶颈。TCP 保证有序和完整性，波形偶尔停顿几毫秒，比波形突然跳一个点更好看。如果你以后要传到公网，再考虑 UDP 加前向纠错也不迟。

3.2 BW16 端的透传固件基本框架

BW16 在 Arduino 环境下开发很方便。核心代码大致是初始化硬件串口、连接指定 WiFi、然后进入循环：读串口字节、拼接数据帧、用 WiFiClient 发送。需要注意 BW16 的硬件串口不要用软件模拟，否则 57600 波特率下很容易丢字节。

WiFiClient client; void setup() { Serial.begin(115200); // 调试口 Serial1.begin(57600); // 接脑电模块 WiFi.begin("EEG-Link", "12345678"); while (WiFi.status() != WL_CONNECTED) delay(10); while (!client.connect(IPAddress(192,168,4,1), 6666)) delay(100); } void loop() { while (Serial1.available() > 0) { uint8_t b = Serial1.read(); if (protocol_push(b) && client.connected()) { client.write(encode_current_frame(), frame_len); } } }

这里有两个常见的坑。第一，WiFi 连接后不要急着connect，最好加一个重连状态机；第二，脑电模块的串口是持续不间断吐数据的，如果只是简单在loop里处理，偶尔会漏读字节，攒到一定量就会丢掉帧头。稳妥一点的做法是用串口中断或 DMA 加环形缓冲区，让数据先入队，主循环再从队列里取出来封帧发送。BW16 的 RAM 不大，但一个 512 字节的环形缓冲足够支撑 512Hz 采样流。

3.3 ESP32-CYD 端的 Server 与数据分发

ESP32-CYD 这边的任务稍重。它要做三件事：维护 TCP Server 接收 BW16 数据，维护 WebSocket Server 向浏览器客户广播，再维护屏幕绘制逻辑。我建议把这些任务拆成 FreeRTOS 的独立任务，用队列传递数据块。

• 任务A：监听 6666 端口，接收 BW16 发来的完整数据帧，校验后存入环形缓冲区。
• 任务B：每 50ms 从缓冲区取一批样本，更新屏幕并准备一个 JSON 数据块。
• 任务C：WebSocket 任务将 JSON 数据块广播给所有网页客户端。

这三件事如果都放在loop()里做，很容易互相阻塞。尤其WebServer.send()和画屏都是耗时操作，放在一个循环里你很难把握刷新节奏。用任务隔离之后，每个部分的优先级是独立设置的，我在测试中把画屏任务的优先级设得最高，其次是 TCP 接收，网页广播最后。因为如果屏幕卡顿，你会立刻觉得很卡；网页广播晚几十毫秒，人眼并不敏感。

3.4 数据帧格式：轻量二进制，不要用 JSON 传输

MCU 之间传输我建议不要用 JSON，因为每个脑电样本都要带一堆花括号和 key，白白浪费带宽和 CPU。自定义一个二进制帧更合适。帧头用0xE1 0xE2，跟模块原始协议的0xAA区分开，后面一个字节表示 payload 类型，比如0x01表示波形数据，0x02表示 eSense 数值，再后面是两字节样本数和数据，最后用两个字节 CRC16。

0xE1 0xE2 0x01 0x14 [data...] CRC16_HI CRC16_LO

其中0x14是 20，表示这一帧携带 20 个样本。接收端一看到0xE1 0xE2，就能明确知道这是自封协议，不会与模块原始数据混淆。你在调试时可先用串口打印十六进制帧，确认字节顺序。CRC16 在 MCU 上没有太大开销，我顺手加上了，防止 WiFi 偶发错误包导致波形毛刺。

3.5 从模块到 BW16 的接线与电平换算

脑电模块用的是 3.3V TTL 串口，BW16 的 GPIO 也是 3.3V 电平，所以不需要额外电平转换。但有些兼容模块为了兼容 Arduino 5V，板载了 5V 上拉，这时你必须先确认模块 TX 空闲电平，如果高于 3.3V，就要用电阻分压或者带方向控制的电平转换芯片，否则可能烧坏 BW16 引脚。

我实际用的接线是：

需要注意的是，BW16 的串口名称在不同开发环境下可能不一样，比如 Arduino 里是Serial、Serial1，Ameba SDK 里用法又会变。接好线后不要急着写复杂协议，先写一个 10 行代码把收到的字节原样打印到串口监视器，确认波特率对不对，再看字节流里能不能看到连续的AA AA帧头。

4. 屏幕端实时波形：ESP32-CYD 上的 TFT 绘制

4.1 用 Arduino_GFX 驱动 CYD 屏幕

ESP32-CYD 的板载屏幕在淘宝上一般叫 ESP32-2432S028R，2.8 寸，320×240，常见驱动芯片是 ILI9341。直接用 TFT_eSPI 需要手动配置引脚，而且不同 CYD 版本的背光、触摸、SD 卡引脚很容易踩坑。我后来改用 Arduino_GFX 库，它内置了一个Arduino_ESP32_2432S028R的定义，一条语句就能初始化，省掉很多刷版本差异的麻烦。

#include <Arduino_GFX_Library.h> Arduino_DataBus *bus = new Arduino_ESP32SPI(12, 14, 13, 15); // MOSI, CS, SCLK, DC Arduino_GFX *gfx = new Arduino_ILI9341(bus, 10 /*RST*/);

如果编译后屏幕一直花屏，先检查复位脚是否接对，再检查 CYD 的触摸芯片到底是 XPT2046 还是 STMPE610，不同型号初始化方式不同。不要以为 GPIO 数量多就可以随便分配，CYD 的 SD 卡和屏幕会竞争 SPI 总线，SD 卡初始化后如果不把片选拉高，屏幕就会莫名卡顿。

4.2 滚动波形不要整屏推拉

实时滚动波形最简单的想法是每隔一段时间把整块 LCD 内容往左移动一列，再在最右侧画新点。这在大屏上是可以的，但在 CYD 上做 512Hz 数据流就会因为整块刷新而卡顿。

更好的做法是用setAddrWindow()只更新屏幕最右侧的一列，然后维护一个波形数组把历史数据保存在内存里。当数据满了，就把整个数组向左覆盖，用背景色擦除最左列，再在最右侧画新值。这样每次刷新只涉及几十个像素，屏幕负担小很多。

void drawWave(int16_t* wave, size_t len) { static int x = 0; gfx->startWrite(); for (size_t i = 0; i < len; i++) { int y = map(wave[i], 0, 1023, 40, 200); gfx->drawFastVLine(x, baseline - 1, 3, COLOR_GRID); gfx->drawPixel(x, y, COLOR_WAVE); x = (x + 1) % 320; } gfx->endWrite(); }

这段代码里的x每到一个点就向右前进一格，到边缘就回绕到左边。为了看起来像滚动，实际上我用了回绕覆盖而不是整屏平移，视觉上接受度更高。如果确实需要示波器式滚动，也可以把 320 个像素分成 16 个批次，每个批次把左半屏向右移动 20 像素，但那样 CPU 占用明显上升。

4.3 屏幕端的信息层次

屏幕不能只画一条波形，否则你看不出信号质量。我在 CYD 上分了四个区域：顶部是标题和当前信号质量，中间是波形区，底部是专注度/放松度两个横向进度条。专注度数值每秒钟才会刷新一次，所以底部进度条不慌不忙地更新即可；波形区则保持与数据批次同步刷新。

我还在屏幕上加了两个触摸按键：一个切换波形放大幅度，另一个在“原始波形”和“平滑波形”之间切换。触摸按键的命中区域不能太小，否则手指一偏就误触。我实测下来，CYD 的电阻触摸屏精度足够做两个 120×80 的按钮，再小就非常难点。触摸处理要加防抖，不然切一次会连续触发好几次。

4.4 屏幕供电与稳定化

CYD 驱动 2.8 寸背光和触摸，峰值电流会到 300mA 以上。如果直接用电脑 USB 口供电，同时 BW16 又从同一 USB 口取电，可能会电压跌落导致花屏或重启。我把 CYD 和 BW16 都接到同一个带 5V 输出的充电宝上，并且在 CYD 的 5V 和 GND 之间并了一个 470μF 电解电容，实测花屏概率大幅下降。如果是 USB 供电，千万注意不要让两个开发板各用一个适配器还要共地，地电位差会让串口数据变得不可靠。

4.5 别让 SD 卡和触摸屏抢总线

CYD 这块板子便宜，但把屏幕、触摸、SD 卡都挂在同一个 SPI 总线上。很多人在初始化屏幕后，再碰一下 SD 卡，屏幕就花了；或者一触摸就触发波形跳动。原因是这几个外设共用 MOSI/MISO/SCLK，但各自片选脚不同。SD 卡初始化后，如果它的 CS 脚没有拉高，就会一直占用 SPI 总线，导致后续对屏幕和触摸的指令无效。

我的建议是在程序启动时，把所有可能用到的外设 CS 脚先设为 OUTPUT 并拉高，再初始化屏幕。如果暂时不用 SD 卡，干脆别初始化它的库，只把 CS 脚推高即可。触摸和屏幕可以共用 CS，但注意不同 CYD 版本触摸芯片不同，初始化函数也不同。花屏时，优先用 Arduino_GFX 内置的 CYD 定义来初始化，这个库维护得比较勤，常见坑都处理了。

5. 网页端可视化：让手机浏览器也能看波形

5.1 网页服务与 WebSocket 分工

网页端我没有用传统 HTTP 轮询，而是用了 WebSocket。原因是脑电波形是持续流数据，轮询每秒几十次很不经济，也会让 ESP32-CYD 的 CPU 白忙。CYD 上的 WebServer 只负责发送一个 HTML 页面，页面加载完成后，JavaScript 主动发起ws://192.168.4.1:81/ws连接，之后服务端就把波形数据主动推给浏览器。

WebSocket Server 端口要和 HTTP 端口分开，避免同端口处理不同类型的握手代码太乱。我在 CYD 上用WebServer监听 80 端口，用WebSocketsServer监听 81 端口。浏览器连接时写清楚端口号即可。如果你不用打印机之类的杂设备，也可以把 HTTP 和 WS 都放在 80 端口上用同一个库，但代码会绕一些。

5.2 一段能直接抄的前端绘制代码

前端我用 Canvas 2D 画波形。整体思想和一个迷你示波器差不多：维护一个画布，每次收到一批数据，就擦掉上一帧窗口最左边的若干列，再把新一帧数据连线画到右边。由于 WebSocket 消息是 JSON，我可以在 push 之前把原始 EEG 转成可读字符串。

const ws = new WebSocket('ws://' + location.host + ':81/ws'); const canvas = document.getElementById('wave'); const ctx = canvas.getContext('2d'); let x = 0; ws.onmessage = (evt) => { const msg = JSON.parse(evt.data); const samples = msg.samples; for (const v of samples) { const y = map(v, msg.rangeMin, msg.rangeMax, 240, 20); ctx.fillStyle = '#0ff'; ctx.fillRect(x, y, 2, 2); x = (x + 2) % canvas.width; } };

这段代码的核心是每像素间隔 2px，画点而不是连线，这样速度最快且不会有锯齿。如果你想看到更漂亮的连续折线，也可以用lineTo()，但要注意每帧都要beginPath()并stroke()，否则路径会叠在一起。我建议先用点状图跑通，确认数据链路稳定后再上折线。

5.3 网页端顺手做一个简易 FFT

网页上最大的优势是处理能力比 MCU 充足，所以我把更深度的特征提取放在浏览器里做。我用一个简单滑动窗口取最近 1024 个样本，然后做 FFT，把能量分成 Delta、Theta、Alpha、Beta 四个频段，画成四个小柱状条。这是脑机接口 demo 里最容易出视觉效果的模块，来访的人虽然看不懂脑电原始波形，但一看频段能量变化就知道你在“实时分析”。

FFT 在浏览器里可以用现成库，比如fft.js，也可以手写一个 1024 点基 2 FFT。为了省时间，我直接用了库，引入一个<script>标签即可。注意，浏览器端采样的数据是经过了模块滤波的，FFT 结果只能算娱乐级，不能拿着去发表论文。

5.4 浏览器缓存与端口注意

调试网页时最讨厌的是改了 HTML 但浏览器还在用旧缓存。我用的是每次在 CYD 端把 HTML 字符串固定，开发阶段可以加一个随机查询参数?v=时间戳强制刷新。另外，如果浏览器打开了https://页面，再访问ws://会被浏览器拦截，说混合内容不安全。所以本地演示时，务必用http://192.168.4.1访问网页，WebSocket 才会畅通。

还有一个容易忽略的小问题：手机连上热点后，系统可能会提示“该网络不能上网”，并且默认不再给你分配 DHCP 地址。CYD 的热点本身没有外网，但它可以正常分配内网 IP。遇到这种情况，在手机 WiFi 设置里关闭“自动登录”或者忽略无互联网提示，浏览器直接访问固定 IP 即可。

5.5 手机和平板上的网页布局

开发网页时，一开始我用固定 800 像素宽度的 Canvas，在电脑上没问题，但手机一访问就只能看到左上角一块。后来给页面加了<meta name="viewport" content="width=device-width, initial-scale=1.0">，并用 CSS 让 Canvas 宽度撑满容器，高度按比例自动缩放。

不过要注意，Canvas 绘图坐标和显示尺寸是两回事。我用canvas.width固定为 800，再通过style把宽度设为 100%，这样浏览器会自动缩放，不用担心模糊。波形图下方再放一个专注度数字，用一个大号字体显示，演示时隔着半米也能看清。移动端不做太多按钮，触摸屏操作还是以 CYD 为主，网页主要是给人看的。

6. 调试实录：从信号乱跳到链路稳定的几个坑

6.1 脑电模块和 MCU 的共地问题

我第一次把脑电模块接 BW16 时，波形全是随机毛刺，后来用万用表量了一下模块 TX 和 BW16 RX，发现两者之间参考地不一致，严重时电平都飘了。所有串口通信必须共地，简单说就是模块 GND 要接 BW16 GND。用两块不同的 USB 充电器给模块和开发板供电，地之间会有微小压差，也会导致通信乱码。推荐的做法是全部从同一个充电宝取 5V，再用 AMS1117 降到 3.3V 给模块供电。

6.2 原始波形出现直流漂移

脑袋不动时，波形在屏幕上来回飘，像随机游走一样。这其实是电极极化电位和接触电阻变化造成的直流漂移。模块内部虽然已有高通滤波，但时间常数很长，不是完全干净的。我在解析器里额外做了一阶数字高通，截止频率设在 0.5Hz 左右：每次新样本减去上次样本，再乘一个系数 0.95 加回去。这样做能把慢速漂移压掉大半，又不影响 1Hz 以上的实际脑电。

6.3 TCP 偶尔断线重连

WiFi 都是面向连接的，但环境里微波炉、蓝牙耳机都可能造成瞬断。一开始我的 BW16 断开后不会重连，导致网页上波形永远停住。后来我写了一个看门狗式的重连逻辑：如果client.connected()返回 false，就关闭连接，重新WiFi.disconnect()，再WiFi.reconnect()，等到连接好了再重连 TCP Server。这个流程一定要加延时不限速，否则会陷入疯狂重连的死循环。

6.4 CYD 上网页突然白屏

排查思路是先用手机浏览器直接访问http://192.168.4.1/看能不能返回 HTML。如果白屏，先看串口日志里 CYD 有没有打印异常；如果是 SPIFFS 存储页面，可能是没有正确 upload file system，或者文件名大小写不对。我把页面直接以字符串常量写在固件里之后，这个坑就彻底消失了。还是建议原型阶段不要用文件系统，一个 HTML 才几 KB，直接塞进代码更省心。

6.5 数据速率不高，为什么还会卡

整条链路数据量虽然不大，但如果你在 CYD 的 WebSocket 任务里把每个样本都作为一个 JSON 字符串发送，那么每个样本都要格式化浮点数，再加上 JSON 的引号、逗号，每秒几百条消息，CPU 就消耗在字符串处理上了。我改成每 50ms 打包一批样本，用整数数组发出去，网页端一次性遍历绘制，CPU 占用立刻降下来。这个优化对 CYD 这种双核 240MHz 的芯片也很明显。

上面这些坑，大部分不是任何单片机的专属 bug，而是系统集成时必然会遇到的边界问题。做成一个稳定的原型链路后，你会发现脑电模块、BW16、ESP32-CYD 这三部分单独拆出来都挺简单，真正难的是把三者的节奏对齐：串口 512Hz 的采样、WiFi 的毫秒级延迟、屏幕的刷新周期、浏览器的人眼感知，要让它们在一个时间刻度里协同工作。我个人在做这个项目时的体会是，先要砍掉多余的实时性假设，不要试图让每一个环节都 1ms 不差。用队列在每层之间解耦，丢掉瞬间的样本远比让整个链路停滞要好。最后再分享一个小技巧：所有波形绘制和网络传输都用批量模式处理，一次攒 20 或 50 个点再往前推，这个容量对 512Hz 的脑电来说只延迟几十毫秒，人眼完全感觉不到，但系统稳定性能提升一大截。沿着这条无线链路继续扩展，后面可以加电池、加九轴传感器做动作伪迹检测，也可以把网页端升级成多路双通道显示，感兴趣的话完全可以从原型直接改成可穿戴版本。