项目简介
本项目是一个基于MPLAB Harmony v3框架的Wio Terminal嵌入式开发模板。借助此模板,开发者能够快速开启使用MPLAB Harmony进行Wio Terminal的软件开发工作,并且支持通过OpenOCD开展源码级别的调试。
项目的主要特性和功能
- MPLAB Harmony v3支持:利用MPLAB Harmony v3生成驱动代码,简化嵌入式开发流程。
- OpenOCD调试支持:可通过OpenOCD进行源码级调试,支持SWD接口的调试器,如FT2232D、STLink - V2等。
- CMake + Ninja构建系统:运用CMake和Ninja进行代码构建,提升构建效率。
- Bootloader支持:支持通过Wio Terminal的Bootloader实现固件的快速烧录。
- VSCode集成:提供VSCode的配置文件,支持在VSCode中进行构建和调试。
安装使用步骤
1. 环境准备
1.1 安装必要的工具
- MPLAB Harmony v3:用于生成驱动代码。
- CMake + Ninja:用于代码的构建。
- OpenOCD:用于调试和固件烧录。
- arm - none - eabi - gcc:用于编译嵌入式代码。
1.2 安装OpenOCD
由于Ubuntu自带的OpenOCD版本较旧,建议从源码编译安装最新版本:
bash
sudo apt install -y libhidapi-dev libusb-1.0-0-dev libftdi-dev
cd ~
git clone --recursive git://git.code.sf.net/p/openocd/code openocd-code
cd openocd-code
./bootstrap
./configure --prefix=$HOME/openocd --enable-ftdi --enable-stlink --enable-cmsis-dap --enable-jlink
make -j
make install
1.3 安装MPLAB Harmony v3
bash
sudo apt install -y openjfx
mkdir -p ~/Harmony3
cd ~/Harmony3
使用contentmanager GUI工具下载并安装Harmony v3的必要组件:
bash
cd ~/Harmony3/contentmanager
java \
-p /usr/share/openjfx/lib \
--add-modules javafx.controls \
--add-modules javafx.swing \
--add-modules javafx.base \
--add-modules javafx.fxml \
--add-modules javafx.media \
--add-modules javafx.web \
-jar harmony-content-manager.jar
2. 生成驱动代码
使用MPLAB Harmony Configurator (MHC)生成驱动代码:
bash
cd ~/Harmony3/mhc
sh ./runmhc.sh
在MHC中打开项目配置文件 firmware/src/config/default/harmony.prj
,然后生成代码。
3. 构建项目
安装构建工具:
bash
sudo apt install -y cmake ninja arm-none-eabi-gcc gcc-arm-none-eabi
使用CMake和Ninja进行构建:
bash
mkdir build
cd build
cmake -G Ninja ..
ninja
4. 固件烧录
4.1 使用Bootloader烧录
安装 bossac
工具:
bash
sudo apt install -y bossa-cli
将Wio Terminal连接到PC,快速按两次复位按钮进入Bootloader模式,然后执行以下命令进行烧录:
bash
sudo bossac -U -R -i --offset 0x4000 -w -v build/MyProject.bin
4.2 使用调试器烧录和调试
使用OpenOCD进行固件烧录和调试:
bash
~/openocd/bin/openocd -s ~/openocd/share/openocd/scripts -f openocd.tcl -c "flash_bin build/MyProject.bin"
在另一个终端中启动GDB进行调试:
bash
gdb-multiarch
target remote localhost:3333
symbol-file build/MyProject.elf
monitor reset halt
cont
5. 使用VSCode进行开发
项目中包含了VSCode的配置文件,可以直接在VSCode中进行构建和调试:
- 按 Ctrl + B
执行构建任务。
- 按 F5
启动调试,程序会在入口点停止。
下载地址
点击下载 【提取码: 4003】【解压密码: www.makuang.net】