返回官网

开发板与编译上传

选择开发板与串口、编译上传流程、平台与库管理、常见错误排查。

本文介绍嵌入式项目（Arduino / ESP-IDF / STM32）的开发板与编译上传流程；通用软件项目（Python / Node 等）见 快速开始。

选择开发板

在插件面板的「设备」选项卡里选（左侧活动栏点你的工具链插件，如 Arduino）：

  1. 在「开发板 / 板型」下拉里搜索并选择，如 Arduino/Genuino UNO
  2. 选中的板型会显示在左下角状态栏（工具链图标旁），并作为编译目标

TrieCode 目前支持：

  • Arduino（AVR Uno、Nano、Mega 等；ESP32 / ESP8266 板卡）—— 由 arduino-cli-toolchain 插件提供：共用官方 Arduino15 编译链，ESP32/ESP8266 平台经国内镜像加速（镜像源随插件分发）
  • ESP-IDF —— 由 espressif-idf-toolchain 插件提供：检测本机已装 ESP-IDF 工具链（可一键下载官方安装器）、图形化 Kconfig 配置视图、目标芯片选择、编译 / 烧录 / 串口日志
  • STM32 —— 由 stm32-cube-toolchain 插件提供：检测本机已装 STM32CubeCLT，原生 CMake 编译 / SWD 一键烧录，打开已有 CubeMX CMake 工程或新建裸机脚手架（F103 / F401 / F411），串口日志、AI 工具
  • 51 单片机（8051） —— 由 sdcc-51-toolchain 插件提供：SDCC 开源编译器编译任意 8051 兼容芯片、stcgal 串口 ISP 烧录 STC 系列（内置裸机模板 + 10 款常用 STC 芯片），芯片型号在插件面板的「设备」选项卡里选

选择串口

  1. 将开发板用 USB 连接到电脑
  2. 在插件面板的「设备」选项卡里选端口（如 COM3）；当前端口同样显示在左下角状态栏
  3. 如未识别，请检查 USB 驱动是否安装

编译与上传

编译（验证）

点击「编译」按钮，或快捷键 Ctrl+R：

  • 只检查代码能否通过编译，不烧录到板子
  • 编译输出实时显示，出错时错误信息带行号，点击可跳转定位
  • 编译进度条显示当前阶段
  • 工具栏编译 / AI 编译 / 烧录输出都流式进入底部编译面板（cli 命令带 stream + streamChannel=compile:onOutput），AI 的 build/flash 也走同一通道

上传（烧录）

点击「上传」按钮，或快捷键 Ctrl+U：

  1. 自动执行编译
  2. 编译通过后自动开始烧录
  3. 进度条显示「编译 → 写入 → 完成」
  4. 完成后状态栏显示「上传成功」

上传前请确认已选择正确的开发板和串口，否则会报「无法连接开发板」。

门控差异：Arduino 需要先选板（FQBN）+ 端口；ESP-IDF 只需端口（目标芯片在设备标签页选），不要求 FQBN。

ESP-IDF 开发流程（espressif-idf-toolchain 插件）

ESP-IDF 是独立的嵌入式工具链（非 Arduino）。首次使用：

  1. 检测工具链：打开插件「目标与工具链」视图，自动检测本机已装 ESP-IDF（环境变量 IDF_PATH / 官方安装器 idf-env.json / 常见路径）；未安装可点「一键下载」官方 idf-installer.exe
  2. 新建项目：文件 → 新建，选择「ESP-IDF 项目」，生成 CMakeLists.txt + main/main.c + sdkconfig.defaults（默认目标 esp32）
  3. 选目标芯片：插件面板的「设备」选项卡 → 目标芯片下拉选择 esp32 / esp32s3 / esp32c3 …，选中即自动执行 set_target（重配置项目）
  4. 编译：工具栏「编译」→ 执行 idf.py build，输出流式进底部编译面板
  5. 配置 Kconfig：插件面板的「配置」选项卡图形化修改 Kconfig 符号（set/save 写回 sdkconfig）；也可用 open_menuconfig 在真实终端打开交互式配置
  6. 烧录：设备标签选串口 → 工具栏「烧录」→ idf.py -p {port} flash（烧录前自动暂停串口日志防串口争用）

AI 能力：17 个插件工具覆盖 build / flash / set_target / get_targets / config_get / config_set / clean / erase_flash / 串口日志 / 崩溃分析，与 UI 主按钮同源（同一执行器）。

STM32 开发流程（stm32-cube-toolchain 插件）

STM32 是独立的原生 CMake 平台（非 Arduino），基于 STM32CubeCLT（CMake + Ninja + arm-none-eabi-gcc + STM32_Programmer_CLI）。两条使用路径：

路径 A · 打开已有 CubeMX 工程：

  1. 检测工具链：打开插件「工具链状态」视图，自动检测本机已装 STM32CubeCLT（环境变量 STM32CubeCLT / 常见安装路径）；未装可到 ST 官网下载，或手动填 CubeCLT 根目录
  2. 打开工程：文件 → 打开一个 CubeMX 生成的 CMake 工程（含 CMakeLists.txt 与 .ioc），软件按 stm32cubemx 标记自动识别并绑定 STM32 工具链
  3. 编译 / 烧录：工具栏「编译」执行 CMake 配置 + Ninja 构建；「烧录」自动定位 build 产物，用 STM32_Programmer_CLI 经 ST-Link（SWD）写入并校验

路径 B · 新建裸机脚手架（无需 CubeMX）：

  1. 文件 → 新建，选择「STM32 裸机 F103C8T6（蓝药丸）/ F401CCU6 / F411CEU6」，生成 CMakeLists + CMSIS 裸机模板（CMSIS 器件文件随插件分发）
  2. 直接编译 / 烧录即可点亮板载 LED

串口日志：STM32 板载 USB 虚拟串口（VCP）即普通串口，串口监视器直接可用；AI 的 serial_monitor_* 工具后台读取 / 检索日志。

门控差异：STM32 烧录走 SWD（ST-Link），不要求先选串口；串口仅用于日志监视。

库管理器

  • 库管理器：浏览和安装第三方 Arduino 库（如 Servo、LiquidCrystal）
  • 搜索库：在 AI 面板或库管理器中搜索库并一键安装
  • 已安装的库会在编译时自动包含

平台安装

Arduino 平台（ESP32 / ESP8266 等）：

  • 首次选择乐鑫板型时，软件会提示安装平台
  • 板卡镜像源由 arduino-cli-toolchain 插件 environment 分发（国内镜像加速），无需手工配置 Boards Manager URL
  • 安装完成后即可编译上传，无需重启软件

ESP-IDF 工具链：独立于 Arduino，由 espressif-idf-toolchain 插件检测本机安装；未装可一键下载官方 idf-installer.exe（见上「ESP-IDF 开发流程」）。

常见编译错误

错误常见原因
'xxx' was not declared变量/函数未定义，或缺少库
No such file or directory缺少头文件，检查是否已安装对应库
avrdude: stk500_recv()串口选择错误或板子未连接
programmer is not responding上传时板子处于占用状态，拔出重插

遇到编译错误时，可以直接问 AI：「把上面的报错解释一下并帮我修复」。

← 上一篇 AI 智能体使用