先楫半导体 HPM_SDK 使用 VSCode（CMake）开发指南

本文档主要基于 WSL Arch（测试通过，日期：2025/11/24）。

前言

先楫半导体官方提供的 SDK 基于 CMake 工程，但官方侧重用于构建 Segger Embedded Studio (SES) 与 IAR 工程。若想直接通过 CMake 在 VSCode 中构建和调试，需要对工具链与 CMake 配置做一定调整。官方也提供改造过的 GNU 工具链及 GUI 工具，可提升芯片性能。SES 工程本质上调用 GCC 工具链，仅为方便开箱即用，但对习惯 VSCode/CMake 的开发者支持有限（如代码补全、快速调试集成等）。

准备工作

环境准备（概览）

Windows：安装 VSCode（官方），并安装 Remote - WSL 插件用于在 WSL 中开发。
WSL：建议使用 Arch（本文基于 Arch 测试），在 WSL 内安装构建工具和交叉编译器。
工具链：使用厂商或 AUR 提供的 RISC‑V / ARM 交叉编译器。根据目标平台选择对应的工具链二进制包或源码构建。

VSCode 与推荐扩展

推荐安装（至少）：

Remote - WSL (ms-vscode-remote.remote-wsl)
C/C++ (ms-vscode.cpptools)
CMake Tools (ms-vscode.cmake-tools)
clangd (llvm-vs-code-extensions.vscode-clangd，可选)
Cortex-Debug (marus25.cortex-debug，用于 ARM 调试)

扩展安装示例（在 Windows PowerShell 或 WSL 的 code CLI 中运行）：

code --install-extension ms-vscode.cpptools
code --install-extension ms-vscode.cmake-tools
code --install-extension llvm-vs-code-extensions.vscode-clangd
code --install-extension marus25.cortex-debug
code --install-extension ms-vscode-remote.remote-wsl

WSL（Arch）与常用构建工具安装

在 Arch WSL 中执行（示例）：

# 更新系统并安装常用工具
sudo pacman -Syu
sudo pacman -S --needed base-devel cmake ninja git python python-pip pkgconf make gcc openocd llvm lldb gdb clang curl libmpc mpfr gmp texinfo gperf patchutils bc zlib expat libslirp

安装交叉编译器（RISC‑V，使用 AUR）

推荐使用 AUR 预编译包 riscv-gnu-toolchain-bin（链接：https://aur.archlinux.org/packages/riscv-gnu-toolchain-bin）。

使用 AUR 助手（如 yay）安装示例：

# 安装 base-devel 与 git（若尚未安装）
sudo pacman -S --needed base-devel git

# 克隆并安装 yay（或用 paru 等 AUR 助手）
git clone https://aur.archlinux.org/yay.git
cd yay
makepkg -si
cd ..

# 使用 yay 安装预编译 RISC-V 工具链
yay -S riscv-gnu-toolchain-bin

若不使用 AUR 助手，可手动构建：

git clone https://aur.archlinux.org/riscv-gnu-toolchain-bin.git
cd riscv-gnu-toolchain-bin
makepkg -si

安装后验证并配置 PATH：

# 检查安装的可执行文件
which riscv64-unknown-elf-gcc || which riscv64-unknown-elf-cc || echo &quot;请确认工具链名称&quot;

# 若安装到例如 /opt/riscv/bin，则加入 PATH（示例）
export GNURISCV_TOOLCHAIN_PATH=/opt/riscv
export PATH=&quot;$GNURISCV_TOOLCHAIN_PATH/bin:$PATH&quot;

# 建议将上两行加入 ~/.bashrc 或 ~/.profile 以持久生效

克隆 HPM-SDK 与环境变量

克隆 SDK：

git clone https://github.com/hpmicro/hpm_sdk.git ~/hpm_sdk

设置环境变量（在 ~/.bashrc 或 ~/.profile 中添加，替换占位符为实际路径）：

# 将下面的占位符替换为实际路径，例如 HPM_SDK_BASE=~/hpm_sdk, GNURISCV_TOOLCHAIN_PATH=/opt/riscv
export HPM_SDK_BASE=&quot;$HOME/hpm_sdk&quot;
export GNURISCV_TOOLCHAIN_PATH=&quot;$HOME/toolchains/riscv&quot;   # 示例路径，按实际安装调整
export PATH=&quot;$GNURISCV_TOOLCHAIN_PATH/bin:$PATH&quot;

注意：不同工具链可能提供不同前缀（如 riscv64-unknown-elf-或 riscv32-unknown-elf-），以实际安装的可执行文件为准。