从零搭建 Ai-WB2 开发板的 Linux 开发环境—— 基于 VMware 虚拟机的零痛苦教程

从零搭建 Ai-WB2 开发板的 Linux 开发环境—— 基于 VMware 虚拟机的零痛苦教程

前言

本文将带你从零开始，在 Windows 11 系统下通过 VMware 虚拟机搭建 Ai-WB2 开发板的 Linux 开发环境，涵盖虚拟机安装、Ubuntu 系统配置、开发工具链部署及程序调试全流程，即使是新手也能轻松跟随操作。

---

一. 准备工作

1.1 硬件清单

• 操作系统为 Windows 11 的电脑
• Ai-WB2 开发板 ×1（含 Type-C 数据线）

1.2 软件提前下载

工具	下载链接	说明
VMware Workstation Player	官方下载	虚拟机运行环境
Ubuntu 20.04 镜像	官方下载	Linux 开发系统（建议保存至非 C 盘）

---

二. VMware 虚拟机安装

1. 下载完成后，右键点击安装包，选择 运行
2. 进入安装向导后，点击 下一步
3. 点击 更改 修改安装路径（建议非 C 盘），完成后点击 下一步
4. 连续点击 下一步直至进入安装阶段，等待 2-3 分钟完成安装
5. 安装完成后点击 完成，桌面会生成 VMware 快捷方式
6. 右键点击桌面 快捷方式，选择 以管理员身份运行启动虚拟机

• 操作如下：

• 完成示例：

---

三. 创建 Ubuntu 虚拟机

1. 启动 VMware 后，点击首页的 创建新的虚拟机
2. 选择 安装程序光盘映像文件 (iso)，点击 浏览选择下载好的 Ubuntu 镜像，点击 下一步
3. 填写用户信息（包括全名、用户名、密码），密码需牢记（用于系统登录），点击 下一步
4. 点击 浏览 选择虚拟机安装路径（建议非 C 盘），点击 下一步
5. 设置虚拟机磁盘大小为 50 GB（默认 20 GB 可能不足），选择 将虚拟磁盘存储为单个文件，点击 下一步
6. 确认配置无误后点击 完成，等待系统自动安装（约 10-15 分钟）
7. 安装完成进入到Ubuntu系统遇到新版本更新提示，点击 取消
8. 若安装过程中若弹出提示窗口，直接点击 确定 即可

• 操作如下:

• 提示窗口直接点 确定:

---

四. Ubuntu 开发环境配置

4.1 更换国内镜像源（加速软件下载）

由于默认国外镜像源下载速度较慢，建议更换为国内的清华源，操作步骤如下：

1. 打开终端：按下Ctrl+Alt+T快捷键快速打开，或点击桌面左下角 显示应用程序，找到 Terminal 并打开
2. 复制粘贴（鼠标中键）以下命令后按Enter打开源配置文件，（输入密码时无显示，输完按回车即可）：

sudo nano /etc/apt/sources.list

3. 按 ↑↓ 方向键移动光标，在原有配置内容前逐一添加 #符号进行注释（快捷键Shift+3可快速输入 #），避免原有源配置干扰
4. 复制以下清华源镜像配置，粘贴到配置文件末尾：

#默认注释了源码镜像以提高 apt update 速度，如有需要可自行取消注释

deb https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ focal main restricted universe multiverse
# deb-src https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ focal main restricted universe multiverse

deb https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ focal-updates main restricted universe multiverse
# deb-src https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ focal-updates main restricted universe multiverse

 deb https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ focal-backports main restricted universe multiverse
# deb-src https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ focal-backports main restricted universe multiverse

#以下安全更新软件源包含了官方源与镜像站配置，如有需要可自行修改注释切换

deb http://security.ubuntu.com/ubuntu/ focal-security main restricted universe multiverse
# deb-src http://security.ubuntu.com/ubuntu/ focal-security main restricted universe multiverse

5. 按Ctrl+O快捷键保存配置，按 Enter键确认保存路径，再按Ctrl+X快捷键退出编辑器

6. 依次复制粘贴（鼠标中键）以下命令更新源列表和系统软件：

   sudo apt update  # 更新镜像源列表，获取最新软件索引
   

   sudo apt upgrade  # 更新系统已安装软件（出现确认提示时，输入 Y 并按回车键即可）
   

• 具体操作如下：

4.2 安装开发工具全家桶

嵌入式开发需要依赖编译工具、版本控制工具等，复制粘贴（鼠标中键）以下命令一键安装必备工具集：

sudo apt install build-essential python3 python3-pip git screen

1. 执行命令后，输入用户密码确认权限，出现 Do you want to continue? [Y/n] 提示时，输入 Y 并按 Enter 回车键继续安装
2. 安装完成后，若系统弹出重启提示，点击 Restart Now重启 Ubuntu 系统，确保工具生效

• 具体过程如下：

4.3 配置 USB 端口权限

为避免后续连接 Ai-WB2 开发板时，因串口权限不足导致无法识别设备，复制粘贴（鼠标中键）依次执行以下命令配置权限：

sudo usermod -a -G dialout \$USER  # 将当前用户添加到串口权限组

dialout sudo reboot  # 重启系统，使权限配置生效

4.4 安装串口调试工具

安装可视化串口助手 cutecom，方便后续查看开发板运行日志，命令如下：

sudo apt-get install cutecom

五、SDK 下载与编译

5.1 下载官方 SDK

打开终端，输入以下命令克隆 Ai-WB2 官方 SDK 仓库（--recursive 参数不可省略，用于同步子模块，避免 SDK 缺失文件）：

git clone --recursive https://gitee.com/Ai-Thinker-Open/Ai-Thinker-WB2

• 具体操作如下：

5.2 配置编译工具链

1. 进入 SDK 根目录（输入 cd Ai-Thi 后按 Tab 键可自动补全目录名称，提高操作效率）：

   cd Ai-Thinker-WB2
   

2. 进入工具链目录，并执行权限修改脚本，确保工具链可执行：

   cd toolchain/riscv/Linux/
   

   . chmod755.sh  # 注意：脚本前的点和空格不可省略
   

3. 连续回退三级目录，返回 SDK 根目录：

   cd ../../..
   

5.3 编译 Hello World 示例

以基础的 helloworld 示例工程为例，验证编译环境是否可用：

1. 进入 helloworld 示例工程目录：

   cd applications/get-started/helloworld
   

2. 输入以下命令开始编译（-j8 表示使用 8 线程编译，可根据电脑 CPU 核心数调整，如 4 核心则改为 -j4，加速编译过程）：

   make -j8
   

3. 若终端无报错信息，并生成对应的烧录文件，说明编译环境配置成功

• 具体操作如下(配置+编译)：

六、程序烧录与调试

6.1 烧录程序到 Ai-WB2 开发板

1. 使用 Type-C 数据线连接Ai-WB2 开发板和电脑，此时 VMware 会弹出 USB 设备连接提示，选择 连接到虚拟机 ，将开发板映射到 Ubuntu 系统中
2. 保持终端在 helloworld 工程目录，输入以下烧录命令：

   make flash p=/dev/ttyUSB0
   

3. 按照终端提示，快速按下Ai-WB2 开发板上的 EN 按键，触发烧录流程，等待烧录完成
4. 当终端显示 All Success 字样时，说明程序已成功烧录到开发板中

• 具体操作如下
  
• 烧录成功示例：
  

6.2 查看程序运行结果

1. 打开串口助手 cutecom，命令如下：

sudo cutecom

2. 配置串口参数（需与工程配置一致）：

   • 端口选择：/dev/ttyUSB0
   • 波特率：115200
   • 数据位：8
   • 停止位：1
   • 校验位：None

3. 点击串口助手界面的 Open 按钮，打开串口连接，此时即可在接收窗口看到 Ai-WB2 开发板循环输出的 hello world 信息，验证程序运行正常

• 程序运行结果如下：

结语

恭喜你成功完成Ai-WB2 开发板 Linux 开发环境的全套搭建！至此，你已拥有完整的嵌入式开发环境，可基于该环境进行Ai-WB2 开发板的功能拓展、项目开发等后续操作。

赞个

很详细的教程！

很详细的教程！

超棒！