MCU Studio

一个 VS Code 扩展，提供 MCU/MPU 工程创建向导、MCU 工作台（编译/下载/调试）与 NPU Model Composer。生成的工程基于 CMake + Ninja + arm-none-eabi-gcc + OpenOCD 工具链（无 Keil/MDK 依赖）。

功能

1. 新建工程 (MCU/MPU) —— 工程创建向导：

   • 顶部三个选项卡：MCU/MPU Selector / Board Selector / Example Selector
   • 中间为列表，右侧详情区：Features / Block Diagram / Docs / CAD / Datasheet
   • 点击 Start Project 弹出内联配置（开发板选择 / 自定义开发板 / Demo 选择 / 工程名），确认后实际生成完整工程骨架并打开 App/Src/main.c

2. 导入工程 (打开已有) —— 选择已有工程目录，校验为 MCU Studio 工程（含 CMakeLists.txt 或 .mcustudio/project.json）后在工作区中打开。

3. MCU 工作台 —— 左侧垂直选项卡「编译 / 下载 / 调试」，右侧详情：

   • 编译：Build Type / Generator / Toolchain File
   • 下载 / 调试：OpenOCD Interface / Target / Adapter Speed
   • 可「保存配置 / 恢复默认」（写入 .mcustudio/config.json 并同步生成 openocd.cfg），底部为操作日志
   • 编译调用 CMake/Ninja，下载/调试调用 OpenOCD（安装 marus25.cortex-debug 可获得图形化调试）

4. Model Composer —— NPU 模型选择与编译：

   • Model Selection / Compile 选项卡，单个设备 / 模型下拉与规格面板
   • Compile 目前为占位实现（NPU 后端待接入）

5. 状态栏 —— 左侧常驻「编译 / 下载 / 调试 / NPU」快捷入口。

运行

1. 用 VS Code 打开 mcu-studio 文件夹。
2. 按 F5 启动扩展开发宿主。
3. 在活动栏点击 MCU Studio 图标，或在命令面板运行：
   • MCU Studio: 新建工程 (MCU/MPU)
   • MCU Studio: 导入工程 (打开已有)
   • MCU Studio: 打开 MCU 工作台
   • MCU Studio: 打开 Model Composer
   • MCU Studio: 编译 (Build) / 下载 (Flash) / 调试 (Debug)

生成的工程结构

<project>/
├─ App/                    应用层（Inc/main.h…、Src/main.c…）
├─ Drivers/                BSP / CMSIS / <CHIP>_HAL_Driver / SYSTEM
├─ Middlewares/            中间件占位
├─ Output/                 构建产物说明
├─ cmake/
│  └─ arm-none-eabi-gcc.cmake   GCC 交叉编译工具链文件
├─ linker/
│  └─ gcc_arm.ld          链接脚本
├─ openocd.cfg            OpenOCD 烧录/调试配置
├─ CMakeLists.txt         CMake 构建脚本
├─ .vscode/               tasks.json / launch.json
└─ .mcustudio/            config.json（工具链配置）/ project.json（工程元数据）

扩展目录结构

mcu-studio/
├─ package.json            扩展清单（命令、视图容器、侧边视图、欢迎页）
├─ src/extension.js        入口：面板管理、消息处理、SDK 脚手架、工具链运行器、状态栏、catalog 读取
└─ media/
   ├─ catalog.json         数据源（mcus / boards / examples / devices / models）
   ├─ style.css            各界面的样式
   ├─ home.js              侧边栏入口视图
   ├─ projectWizard.js     新建工程向导界面逻辑
   ├─ mcuWorkbench.js      MCU 工作台界面逻辑
   ├─ modelComposer.js     Model Composer 界面逻辑
   └─ icon.svg             活动栏图标

说明

catalog 中的芯片/开发板/示例为占位数据。新建/导入工程、编译/下载/调试与配置管理均为真实实现；Model Composer 的 Compile 仍为占位（待接入 NPU 后端）。