板伴 Boardly:硬件初学者的在线排错工具
板子不工作时,先找到问题在哪。把报错或串口日志贴进来,板伴按 71 条故障规则定位原因;用浏览器直接连接开发板做芯片、供电和引脚体检;编译缺库时告诉你该装哪个库。免费使用,日志只在你的浏览器里分析。
能做什么
- 日志诊断:识别欠压重启(Brownout)、下载失败、串口无输出、缺少头文件等常见问题,并按「供电 → 连接 → 烧录 → 最小程序 → 串口 → 外设」的顺序给出检查步骤。
- 板子体检:用 Chrome / Edge 的 Web Serial 连接 ESP32,检查芯片响应、Flash、带载供电和引脚漏电。
- 代码生成:Arduino、MicroPython、STM32 标准库与 HAL 的 LED、串口、I²C 扫描、ADC、按键起步代码。
- 缺库识别:从编译报错找出缺失的头文件,给出要安装的库和 PlatformIO 写法。
- 网页烧录:在浏览器里给 ESP32 系列写入固件,无需安装软件。
- AI 辅助分析:基于 DeepSeek,结合日志、体检结果和代码排查复杂问题。
支持的开发板
- ESP32 DevKit V1(ESP32-WROOM-32)
- ESP32-C3 SuperMini(ESP32-C3FH4(RISC-V 单核 160 MHz,4 MB Flash))
- ESP32-CAM(AI-Thinker)(ESP32-S(双核 240 MHz)+ 4 MB PSRAM + OV2640 摄像头)
- ESP32-S3-DevKitC-1(ESP32-S3-WROOM-1(N8R8 常见))
- NodeMCU ESP8266(ESP-12E(ESP8266EX))
- Arduino Mega 2560(ATmega2560(8 位 AVR,16 MHz,256 KB Flash,8 KB RAM))
- Arduino Nano(ATmega328P)
- Raspberry Pi Pico(RP2040(双核 Cortex-M0+))
- Raspberry Pi Pico W(RP2040(双核 Cortex-M0+)+ CYW43439 无线芯片)
- STC89C52 实验板(STC89C52 系列)
- STM32 Blue Pill(STM32F103C8T6)
- Arduino Uno R3(ATmega328P)
常见报错与故障
- 串口未被识别
- 串口参数待核对
- I²C 未发现设备
- 供电不稳定
- 未进入下载模式
- Flash 访问或中断代码异常
- 串口没有输出:没开「USB CDC On Boot」
- ESP32-C3 连不上:需要手动进入下载模式
- 端口消失或编号变了
- 摄像头初始化失败
- ESP32-CAM 烧录失败:没进入下载模式
- PSRAM 没有启用或初始化失败
- PSRAM 初始化失败
- 下载失败:未进入下载模式
- 固件格式或 Flash 模式不匹配
- 看门狗复位:程序卡住太久
- 程序异常崩溃
- 启动模式不对
- 上传失败:与 Bootloader 不同步
- 串口被占用或不存在
- 读不到芯片签名
- 上传失败:没有进入 BOOTSEL 模式
- 程序崩溃(HardFault / PANIC)
- MicroPython 缺库或内存不足
- SWD 连接失败
- 启动模式未确认
- 时钟配置待核对
- 等待 ISP 握手
- ISP 配置待核对
- 串口线路待检查
编译提示缺少头文件(No such file or directory)
- ArduinoJson.h:安装 ArduinoJson
- Adafruit_BusIO_Register.h:安装 Adafruit BusIO
- Adafruit_GFX.h:安装 Adafruit GFX Library
- PubSubClient.h:安装 PubSubClient
- ESPAsyncWebServer.h:安装 ESPAsyncWebServer
- Adafruit_Sensor.h:安装 Adafruit Unified Sensor
- Adafruit_NeoPixel.h:安装 Adafruit NeoPixel
- NimBLEDevice.h:安装 NimBLE-Arduino
- Adafruit_SSD1306.h:安装 Adafruit SSD1306
- ESPAsyncTCP.h:安装 ESPAsyncTCP
- WebSockets.h:安装 WebSockets
- lvgl.h:安装 lvgl
- TFT_eSPI.h:安装 TFT_eSPI
- U8g2lib.h:安装 U8g2
- OneWire.h:安装 OneWire
- M5Unified.h:安装 M5Unified