McuStudio

简述

产品简介

MCUStudio是一款专为MCU（微控制器）开发者设计的VSCode扩展，提供从芯片项目创建、芯片管理到AI辅助开发的完整解决方案。
该扩展集成了强大的AI识别功能，能够自动识别引脚图、解析芯片特性，大幅提升开发效率。

主要特性

• 🏗️ 智能项目管理: 一键创建MCU项目，自动生成标准目录结构
• 🧩 芯片管理: 支持芯片系列、型号、封装的完整生命周期管理
• 🤖 AI智能识别: 基于AI的引脚图识别和芯片特性分析
• 🌲 可视化树视图: 直观的项目结构展示，丰富的右键菜单操作
• ⚡ 高效开发: 模板系统、自动化工具、批量处理等开发辅助功能

适用场景

• MCU芯片包开发
• 嵌入式系统开发
• 芯片文档编写
• 引脚配置和特性分析
• 批量芯片数据处理

---

🚀 安装与配置

系统要求

• VSCode版本: 1.105.0 或更高版本
• 操作系统: Windows、macOS、Linux
• 网络连接: AI功能需要网络连接

安装步骤

1. 通过VSCode市场安装:

   • 打开VSCode
   • 按 Ctrl+Shift+X 打开扩展面板
   • 搜索 "MCUStudio"
   • 点击"安装"

2. 通过VSIX文件安装:

   • 下载 mcustudio-*.vsix 文件
   • 在VSCode中按 Ctrl+Shift+P
   • 输入 "Extensions: Install from VSIX"
   • 选择下载的文件

初始配置

1. AI功能配置:

   • 按 Ctrl+Shift+P 打开命令面板
   • 输入 "打开设置"
   • 搜索 "MCUStudio"
   • 配置 mcustudio.cozeToken（Coze API Token）

2. 工作区准备:

   • 确保工作区文件夹已打开
   • 扩展会自动检测工作区并显示树视图

---

🏁 快速开始

创建第一个项目

1. 打开VSCode，按 Ctrl+Shift+P
2. 输入 "Create New Project" 并选择
3. 选择项目存储位置
4. 输入项目名称（如：my-mcu-project）
5. 点击确认，项目将自动创建

项目结构概览

my-mcu-project/
├── chip_config/          # 芯片配置目录
│   ├── templates/        # 项目模板
│   ├── generators/       # 代码生成器
│   └── pins/            # 引脚配置
│       ├── series1/      # 芯片系列
│       │   ├── chip1/    # 芯片型号
│       │   │   ├── package/  # 封装信息
│       │   │   ├── pins_af/  # 引脚功能图
│       │   │   └── features/ # 芯片特性图
│       │   └── chip2/
│       └── series2/
├── src/                  # 源代码目录
├── plugins/              # 插件目录
└── sdk/                  # SDK目录

基本操作流程

1. 创建芯片系列: 在 chip_config 上右键 → "新建系列"
2. 添加芯片型号: 在系列上右键 → "新建型号"
3. 配置引脚: 添加图片到引脚目录，使用AI识别
4. 生成文档: 使用AI生成芯片特性分析
5. 开发调试: 在src目录编写代码，使用生成的配置

---

🔧 核心功能

🌲 树视图界面

树视图是MCUStudio的主要交互界面，位于VSCode侧边栏的"MCUStudio"面板中。

节点类型说明

节点类型	图标	说明	右键菜单
项目根目录	📁	整个项目的根节点	上传项目
chip_config	⚙️	芯片配置目录	新建系列
芯片系列	📚	同一系列的芯片集合	新建型号、删除系列
芯片型号	🔲	具体的芯片型号	删除型号
package系列	📚	芯片封装信息	AI解析封装、生成型号
pins_af	🔌	引脚功能图目录	AI解析引脚功能图
features	🏷️	芯片特性图目录	AI解析芯片特性
peripherals	🔧	外设目录	添加外设
外设	⚙️	具体外设	删除外设
代码版本	📝	外设代码版本	添加代码版本
配置版本	📋	外设配置版本	添加配置版本

📁 文件操作功能

所有文件和目录都支持基本的文件操作：

• 打开文件: 在VSCode编辑器中打开文件
• 在终端中打开: 在系统终端中打开目录
• 复制/粘贴: 支持文件和目录的复制粘贴
• 重命名: 修改文件或目录名称
• 删除: 删除不需要的文件或目录

---

🤖 AI功能详解

AI功能概述

MCUStudio集成了基于Coze平台的AI功能，提供智能的图像识别和数据分析能力。

配置AI服务

1. 配置Token:
   • VSCode设置中搜索 "mcustudio.cozeToken"
   • 输入您的API Token
   • 保存配置

AI助手

访问方式:

• 命令面板: "打开 MCUStudio AI 助手"
• 菜单: 侧边栏 → MCUStudio → "McuStudio AI助理"

功能特性:

• 实时对话交互
• Markdown格式支持
• 代码高亮显示
• 会话历史记录

AI图像识别功能

1. AI解析封装

用途: 自动识别芯片封装图的引脚信息

使用步骤:

1. 在 package系列 目录中放入封装图片（PNG/JPG格式）
2. 在目录上右键 → "AI 解析封装"
3. 等待AI分析完成
4. 查看生成的 pin.json 文件

输出格式:

{
  "chip_name": "STM32F103",
  "package_type": "LQFP48",
  "pins": [
    {
      "number": 1,
      "name": "PC13/TAMPER-RTC",
      "type": "GPIO"
    }
  ]
}

2. AI解析引脚功能图

用途: 分析引脚复用功能和配置

使用步骤:

1. 在 pins_af 目录中放入引脚功能图
2. 目录右键 → "AI 解析引脚功能图"
3. AI自动处理所有图片
4. 生成 {芯片名}_af_analysis.json 文件

处理能力:

• 批量处理多张图片
• 自动识别引脚复用功能
• 生成结构化的配置数据

3. AI解析芯片特性

用途: 分析芯片的技术特性和参数

使用步骤:

1. 在 features 目录中放入芯片特性图
2. 目录右键 → "AI 解析芯片特性"
3. AI分析芯片规格和特性
4. 生成 {芯片名}_features_analysis.json 文件

分析内容:

• CPU架构和频率
• 存储器配置
• 外设接口
• 电气特性
• 封装信息

AI使用技巧

1. 图片质量: 使用高清、清晰的图片可获得更好的识别效果
2. 文件命名: 使用有意义的文件名便于AI理解
3. 批量处理: 一次处理多个图片提高效率
4. 结果验证: AI结果需要人工验证和调整

---

🧩 芯片管理

芯片系列管理

芯片系列是对同一架构不同型号芯片的分组管理。

创建系列

1. 在 chip_config 目录上右键
2. 选择 "新建系列"
3. 输入系列名称（如：STM32F1）
4. 确认创建

删除系列

1. 在芯片系列节点上右键
2. 选择 "删除系列"
3. 确认删除操作

注意: 删除系列会删除该系列下的所有芯片型号，请谨慎操作。

芯片型号管理

每个芯片型号代表一个具体的芯片产品。

添加型号

1. 在芯片系列上右键
2. 选择 "新建型号"
3. 输入型号名称（如：STM32F103C8T6）
4. 确认创建

删除型号

1. 在芯片型号节点上右键
2. 选择 "删除型号"
3. 确认删除

封装管理

封装信息描述芯片的物理封装和引脚布局。

封装目录结构

chip_name/
├── package/
│   ├── LQFP48/      # 封装类型目录
│   │   ├── gpio.png  # 引脚图
│   │   └── pin.json  # AI识别结果
│   └── QFP32/

生成型号

用途: 基于已有的pin.json文件生成标准化的芯片型号数据

使用步骤:

1. 在 package系列 目录上右键
2. 选择 "生成型号"
3. 系统自动扫描所有封装目录
4. 为每个封装生成 chip.json 文件

生成内容:

• 芯片名称和封装类型
• 完整的引脚列表
• 引脚功能映射
• 生成时间和版本信息

---

⚙️ 外设管理

外设目录结构

chip_name/
├── peripherals/
│   ├── UART/           # 外设名称
│   │   ├── code/      # 代码版本
│   │   │   ├── v1.0/
│   │   │   └── v2.0/
│   │   └── schema/    # 配置版本
│   │       ├── v1.0/
│   │       └── v2.0/
│   └── SPI/

外设操作

添加外设

1. 在 peripherals 目录上右键
2. 选择 "添加外设"
3. 输入外设名称（如：UART）
4. 确认创建

删除外设

1. 在外设节点上右键
2. 选择 "删除外设"
3. 确认删除

管理版本

• 添加代码版本: 在外设的code目录右键 → "添加外设代码版本"
• 添加配置版本: 在外设的schema目录右键 → "添加外设配置版本"

版本管理最佳实践

1. 语义化版本: 使用 x.y.z 格式（如：1.0.0, 1.1.0, 2.0.0）
2. 版本说明: 在版本目录中添加README文件说明变更内容
3. 向后兼容: 保持API的向后兼容性
4. 文档同步: 代码版本和配置版本保持同步更新

---

📂 项目管理

项目创建

新建项目

1. 按 Ctrl+Shift+P 打开命令面板
2. 输入 "Create New Project"
3. 选择项目存储位置
4. 输入项目名称
5. 选择项目模板（可选）
6. 确认创建

项目模板

MCUStudio提供多种项目模板：

• 基础模板: 简单的MCU项目结构
• 驱动模板: 包含常用驱动代码
• 应用模板: 完整的应用程序框架

项目转换

支持在不同项目类型之间进行转换：

1. 打开要转换的项目
2. 运行 "Convert Project" 命令
3. 选择目标类型
4. 确认转换

项目上传

将项目上传到代码仓库或云端：

1. 在项目根目录右键
2. 选择 "上传项目"
3. 选择上传目标
4. 配置上传参数
5. 开始上传

---

⌨️ 快捷键和命令

常用命令列表

命令名称	快捷键	功能描述
Create New Project	-	创建新的MCU项目
Show Project Explorer	-	显示项目资源管理器
Open File	-	打开选中的文件
Open in Terminal	-	在终端中打开目录
新建系列	-	创建新的芯片系列
新建型号	-	创建新的芯片型号
删除系列	-	删除芯片系列
删除型号	-	删除芯片型号
添加外设	-	添加新的外设
删除外设	-	删除外设
AI 解析封装	-	使用AI识别封装引脚
AI 解析引脚功能图	-	使用AI分析引脚复用
AI 解析芯片特性	-	使用AI分析芯片特性
生成型号	-	基于引脚数据生成型号
打开 MCUStudio AI 助手	-	打开AI对话界面

命令面板使用

1. 按 Ctrl+Shift+P 打开命令面板
2. 输入命令名称或关键词
3. 选择对应命令执行
4. 按照提示完成操作

右键菜单

不同类型的节点提供不同的右键菜单选项：

• 导航类: 打开、在终端中打开
• 编辑类: 新建、删除、重命名、复制
• 功能类: AI解析、生成、转换

入门

快速开始

---