PiMCHIP IDE

PiMCHIP IDE 是一款面向 MCU/MPU 开发的 VS Code 扩展，提供工程创建、编译、下载、调试和 NPU 模型编译的一体化工作流。

当前 Marketplace 稳定通道版本线为 0.2.x；0.x stable 表示已通过正式发布门禁，不代表已经作出 1.0.0 级别的兼容性承诺。

工程向导：根据芯片、开发板和示例生成 CMake 工程
MCU 工作台：集中管理 Build / Flash / Debug 配置和操作
Model Composer：选择设备与算法，执行 NPU 模型编译
状态栏快捷入口：一键触发编译、下载、调试和 NPU 编译

MCU 工程默认采用 CMake + Ninja + arm-none-eabi-gcc + OpenOCD，不依赖 Keil/MDK。

安装要求

VS Code 1.90.0 或更高版本
MCU 编译和调试：
- arm-none-eabi-gcc、arm-none-eabi-gdb 及配套 Binutils，需要安装并加入 PATH
- 扩展内置 Ninja 和 OpenOCD
- Windows 版还会在首次使用时自动准备随扩展提供的 CMake/Make
- Linux/macOS 需要系统中已有可用的 CMake
C/C++ 扩展（ms-vscode.cpptools）：作为扩展依赖自动安装，用于代码编辑和 cppdbg 调试
NPU 编译：
- 自动环境安装目前面向 Windows x64
- 建议使用 Python 3.11 和仅含英文可打印字符的路径
- 完整环境约占用 3 GB，首次安装需要访问 Python 软件包镜像

快速开始

在 VS Code 扩展市场安装 PiMCHIP IDE。
安装完成后，按提示重载 VS Code。
点击活动栏中的 PiMCHIP IDE 图标。
选择“新建工程 (MCU/MPU)”或“导入工程 (打开已有)”。
使用 MCU 工作台完成编译、下载和调试，或打开 Model Composer 编译 NPU 模型。

也可以打开命令面板，搜索 PiMCHIP IDE 执行对应命令。

工程向导

新建工程

依次选择 MCU/MPU、开发板和示例
在详情面板查看 Features、Block Diagram、Docs、CAD 和 Datasheet
点击 Start Project，填写工程名称和目标配置
扩展生成完整工程目录，并自动打开 App/Src/main.c

导入已有工程

选择已有目录后，扩展会按以下条件识别 PiMCHIP IDE 工程：

包含 CMakeLists.txt，或
包含 .mcustudio/project.json

识别成功后，可以直接在当前 VS Code 窗口中打开工程。

MCU 工作台

MCU 工作台包含编译、下载和调试三个页签。

编译

Build Type
Generator
Toolchain File

下载与调试

OpenOCD Interface
Target
Adapter Speed

配置可保存或恢复默认值，并同步写入 .mcustudio/config.json 和 openocd.cfg。面板底部会显示实时操作日志。

Model Composer

Model Composer 支持：

Device 和 Algorithm 选择
Model File 和 Data Directory 选择
Weight Address 配置
编译进度、实时日志、结果展示和中途停止

编译输出统一写入：

ModelZoo/{case}/generated

编译 NPU 模型

打开 Model Composer。
选择 Device 和 Algorithm。
在 Compile 页签选择 Model File 和 Data Directory。
按需设置 Weight Address。默认值为 0x08800000，有效范围为 [0x08800000, 0x09000000]。
点击 Compile & Generate。
在日志区查看编译进度和结果。
编译成功后，到 ModelZoo/{case}/generated 查看生成文件。

首次编译时，如果没有检测到可用的 NPU Python 环境，扩展会提示安装。安装过程会创建隔离的 Python 环境、校验关键依赖版本，并安装或升级 npu_compile_toolchain wheel。也可以通过 mcuStudio.pythonPath 指定已有环境。

命令

PiMCHIP IDE: 新建工程 (MCU/MPU)
PiMCHIP IDE: 导入工程 (打开已有)
PiMCHIP IDE: 打开 MCU 工作台
PiMCHIP IDE: 打开 Model Composer
PiMCHIP IDE: 编译 (Build)
PiMCHIP IDE: 下载 (Flash)
PiMCHIP IDE: 调试 (Debug)
PiMCHIP IDE: NPU 编译

配置

`mcuStudio.pythonPath`

类型：string
默认值：空字符串
说明：指定 NPU 编译使用的 Python 目录。该目录会被添加到扩展进程的 PATH 前部；留空时由扩展自动查找或引导安装环境。

`mcuStudio.debug.stopAtEntry`

类型：boolean
默认值：true
说明：启动嵌入式调试会话后，在 ELF 程序入口处暂停。

生成的工程结构

{project}/
├─ App/                    应用层（Inc/main.h、Src/main.c 等）
├─ Drivers/                BSP / CMSIS / HAL / SYSTEM
├─ Middlewares/            中间件
├─ Output/                 构建输出目录
├─ cmake/
│  └─ arm-none-eabi-gcc.cmake
├─ linker/
│  └─ gcc_arm.ld
├─ openocd.cfg
├─ CMakeLists.txt
├─ .vscode/                tasks.json / launch.json
└─ .mcustudio/             config.json / project.json

已知限制

可选芯片、开发板、示例和模型取决于扩展所带 SDK catalog/DB 的内容。
NPU 环境自动安装目前仅支持 Windows x64。
NPU 模型和数据路径建议只使用英文可打印字符，以避免底层 ONNX/ONNX Runtime 的路径兼容问题。
编译、下载和调试是否成功还取决于本机工具链、调试器驱动、目标板连接和供电状态。

License

MIT