Arduino IDE 环境
本页把烧录之前的电脑端环境一次配到位：ESP32 板卡包、sdkconfig 修改、依赖库、源码目录命名与板型参数。主线是 Bittle X V2（BiBoard V1）；分区方案一处把老款 Bittle X（BiBoard V0）分表对照。本页做完的验收标准很明确：ModuleTests 里的 testBuzzer.ino 能编译、能上传成功。
ESP32 板卡包：版本锁死 2.0.12
打开 Arduino IDE 的 Preferences，把 ESP32 板卡地址加入 Additional boards manager URLs：
https://raw.githubusercontent.com/espressif/arduino-esp32/gh-pages/package_esp32_index.json保存后打开 Boards Manager，等外部板卡源更新完成，搜索 esp32 安装板卡支持包。版本是本页唯一的硬约束：必须安装 2.0.12，官方原文写明 Installing version 2.0.13 and above may cause the motherboard to fail to startup——装了 2.0.13 及以上，主板可能直接起不来。已经装成更高版本的，处理办法就是回到 Boards Manager 把板卡包降到 2.0.12 重装，这一步没有别的绕法。
修改 sdkconfig.h
板卡包装好后，还要改它内部的一个头文件：在各系统对应的安装目录里找到 sdkconfig.h，在文件末尾追加一行：
#define CONFIG_DISABLE_HAL_LOCKS 1该文件在三个系统下的位置：
- Windows：C:\Users\{username}\AppData\Local\Arduino15\packages\esp32\hardware\esp32\2.0.*\tools\sdk\esp32\qio_qspi\include\sdkconfig.h
- Mac：/Users/{username}/Library/Arduino15/packages/esp32/hardware/esp32/2.0.*/tools/sdk/esp32/qio_qspi/include/sdkconfig.h
- Ubuntu：Arduino 根目录/.arduino15（隐藏目录）/packages/esp32/hardware/esp32/2.0.12/tools/sdk/esp32/qio_qspi/include/sdkconfig.h
依赖库
- MU Vision Sensor library：需要手动下载安装，不走库管理器
- ArduinoJson：库管理器安装
- WebSockets：库管理器安装
库装齐之后，ModuleTests 文件夹里有一组 test***.ino 单模块测试程序，官方推荐把 testBuzzer.ino 作为第一个测试 sketch 单独上传——先用它把环境与烧录链路打通，再去碰主程序，出问题时才能把「环境没配对」和「主程序本身的问题」分开。
整包下载与目录命名
源码必须整包下载：官方要求每次都下载完整的 OpenCatEsp32 文件夹，所有代码必须是同一版本才能一起工作。用 ZIP 方式下载解压后，得到的是 OpenCatEsp32-main 目录，必须先重命名为 OpenCatEsp32，再打开里面的 OpenCatEsp32.ino，让目录名与 .ino 同名。没改名就编译，会直接报：
OpenCat:82:10: fatal error: src/OpenCat.h: No such file or directory看到这条报错，不要去改 include 路径，先检查目录名——官方 FAQ 把这条报错与整包目录名不匹配绑定在一起说明，重命名目录即可消除。目录名对上、报错消失，环境就算就绪。
板型参数（ESP32 Dev Module）
| 参数 | 数值 |
|---|---|
| Upload Speed | 921600 |
| CPU Frequency | 240 MHz (WiFi/BT) |
| Flash Mode | QIO |
| Flash Size | 4 MB |
| Partition Scheme | Default 4MB with spiffs |
| PSRAM | Disabled |
这组数值来自 OpenCatEsp32 仓库 README 的板型参数表，是官方给出的唯一完整参数集；本页不补充任何 IDE 截图里才可见的其他板型选项。
分区方案：按板卡版本分表
Flash Size 与 Partition Scheme 怎么填，官方文档存在两处口径，按板卡分列如下：
| 板卡 | Flash | 可选分区口径 |
|---|---|---|
| BiBoard V1（Bittle X V2） | 4M | Minimal SPIFFS (1.9MB APP with OTA/190KB SPIFFS)；也可选 No OTA 或 Huge APP |
| BiBoard V0（老款 Bittle X） | 16M | 可直接用默认 4 MB 分区表；要吃满 16M 需另行添加硬件分区配置 |
README 参数表给的是 Flash Size 4 MB、Partition Scheme Default 4MB with spiffs；guide 教程页给出的则是上表的分版本口径。两处口径并列存在，官方没有把它们统一成一句，这里照原样分列、不合并也不裁决。使用时先认准手里是哪块板：BiBoard V1 是 4M flash，BiBoard V0 是 16M flash，再对照各自口径选分区。
IDE 版本：官方两处口径并列
Arduino IDE 本体装哪个版本，官方文档同样存在两处口径：
| 出处 | 口径 |
|---|---|
| Bittle X V2 的 Arduino IDE 教程页 | 按 docs.arduino.cc 的 IDE v2 安装教程安装 |
| Serial Monitor 页、Useful Tools 页 | 推荐 1.8.19 |
两处口径并列，官方未做统一，本页不裁决哪个对。有一点可以分清：板卡包的 2.0.12 是 ESP32 boards 的版本约束，与 IDE 本体的版本是两回事，不要把「装 2.0.12」理解成 IDE 也必须停留在某个旧版本。
到这里的环境自查清单：板卡包 2.0.12、sdkconfig.h 追加过那行宏、三个库在列、目录名是 OpenCatEsp32、板型参数照表填好。之后进入烧录与首次初始化一页。