1. 开发环境准备:从零搭建Ai-WB2-12F基础工具链
第一次接触Ai-WB2-12F开发板的同学可能会被环境配置劝退,其实只要跟着步骤走,半小时就能搞定。我去年第一次用这块板子时,花了整整两天才把环境搭好,现在把踩坑经验都总结成这套保姆级方案。
核心工具链只需要三个部分:MSYS2(模拟Linux环境)、RISC-V工具链、VSCode编辑器。这里特别提醒,MSYS2建议从国内镜像站下载,官方源速度慢得像蜗牛。我常用的是阿里云镜像站,下载msys2-x86_64最新版就行,安装时记得勾选"将MSYS2添加到系统PATH"(不然后面手动加环境变量很麻烦)。
安装完成后,在开始菜单找到MSYS2 UCRT64终端(注意不是默认的MSYS2终端),先执行以下命令更新基础包:
bash复制pacman -Syu
这个步骤可能会遇到"无法锁定数据库"的错误,解决方法很简单——关掉所有MSYS2窗口重新开就行。更新完成后,建议安装几个常用工具:
bash复制pacman -S git make python3
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 获取SDK与解决常见坑点
官方SDK仓库在gitee上,用这个命令克隆:
bash复制git clone --recursive https://gitee.com/Ai-Thinker-Open/Ai-Thinker-WB2
这里有个大坑——toolchain/riscv/MSYS目录经常是空的!我遇到过五六次这种情况,根本原因是子模块拉取失败。有两个解决方案:
- 国内用户推荐:直接下载我打包好的工具链(链接见文末),解压到对应目录
- 手动初始化子模块:
bash复制git submodule update --init --recursive
实测发现,即使开了全局代理也可能失败(别问我怎么知道的)。最稳的方法是下载完成后,检查toolchain目录是否完整,应该包含riscv-none-embed-gcc等工具。如果遇到权限问题,右键文件夹→属性→安全→给当前用户完全控制权限。
3. 环境变量配置的三种姿势
很多教程只教一种配置方法,实际开发中要根据场景灵活选择:
方法一:永久生效(推荐新手)
- Win+R输入`s
