FMD C Compiler

FMD C Compiler 是一个用于 FMD 系列 MCU 工程开发的 VS Code 插件。插件封装厂商 c.exe 编译器，并自动生成 VS Code 工程配置，让传统 MCU 工程可以在 VS Code 中编辑、编译、管理输出文件和配置 IntelliSense。

功能特性

• 一键编译 FMD MCU 工程
• 编译当前 C 文件
• 清理编译中间文件
• 自动识别 .prj 工程文件
• 自动配置编译器路径
• 自动切换目标芯片
• 编译输出默认保存到工程目录下的 build 文件夹
• 自动生成 .vscode/settings.json
• 自动生成 .vscode/c_cpp_properties.json
• 自动生成 .vscode/fmd_intellisense.h，用于识别芯片寄存器
• 自动生成/补充 .gitignore
• 支持外部烧录工具下载程序到单片机
• 支持 EEPROM 查看、修改、导出

适用工程

插件主要面向厂商 CCompiler 工具链工程，例如：

xxx.prj
xxx.C
*.c
*.h

默认编译器路径：

C:\Program Files (x86)\CCompiler\Compiler\data\bin\c.exe

目标芯片会优先从 .prj 文件中的 Device = ... 字段自动识别。部分官方工程型号会映射为编译器芯片库中的实际型号，例如 FT61E13X 会按官方工具输出映射为 FT61F13X 后传给 c.exe --chip=...。

快速开始

1. 在 VS Code 中打开 MCU 工程目录。
2. 插件会自动搜索 .prj 工程文件。
3. 插件会自动生成或更新：

.vscode/settings.json
.vscode/c_cpp_properties.json
.vscode/fmd_intellisense.h
.gitignore

4. 按 F7 或执行命令：

FMD: Build Project

5. 默认输出文件位于：

工程目录\build\xxx.hex
工程目录\build\xxx.bin

常用命令

状态栏按钮

插件会在 VS Code 状态栏显示：

自动生成 VS Code 配置

执行以下命令可手动重新生成配置：

FMD: Regenerate VS Code Config

该命令会生成或更新：

.gitignore
.vscode/settings.json
.vscode/c_cpp_properties.json
.vscode/fmd_intellisense.h

settings.json

示例：

{
  "fmdCompiler.compilerPath": "C:\\Program Files (x86)\\CCompiler\\Compiler\\data\\bin\\c.exe",
  "fmdCompiler.chip": "从 .prj 的 Device 自动识别，或手动指定",
  "fmdCompiler.projectFile": "C:\\path\\to\\project.prj",
  "fmdCompiler.outputDir": "build",
  "fmdCompiler.autoSaveBeforeBuild": true,
  "fmdCompiler.showOutputOnBuild": true
}

c_cpp_properties.json

插件会自动配置：

{
  "includePath": [
    "${workspaceFolder}/**",
    "工程目录",
    "工程目录/**",
    "C:/Program Files (x86)/CCompiler/Compiler/data/include"
  ],
  "defines": [
    "_当前工程芯片型号",
    "__GCC8PRO__",
    "_CHIP_SELECT_H_"
  ],
  "forcedInclude": [
    "工程目录/.vscode/fmd_intellisense.h"
  ]
}

fmd_intellisense.h

厂商芯片头文件中寄存器通常使用非标准 C 语法，例如：

volatile unsigned char ANSEL0 @ 0x011E;

VS Code C/C++ IntelliSense 可能无法识别这些寄存器。插件会自动从当前芯片头文件中抽取寄存器名，生成 IntelliSense 专用头文件：

.vscode/fmd_intellisense.h

该文件只用于 VS Code 代码提示，不参与真实 c.exe 编译。

编译输出目录

默认输出目录为：

"fmdCompiler.outputDir": "build"

含义：

工程目录\build\

为了兼容官方工具链，插件会先让 c.exe 按官方风格输出到工程根目录的小写文件名前缀，例如 ft61e132a.hex，编译成功后再把所有编译生成/更新的产物移动到配置输出目录，例如 build\FT61E132A.hex、build\FT61E132A.map、build\FT61E132A.lst、build\button.p1 等。

也可以设置为绝对路径，例如：

"fmdCompiler.outputDir": "D:\\firmware-output"

如果设置为空字符串，则输出到工程目录。

下载程序到单片机

由于不同环境使用的烧录工具不同，插件不内置固定烧录协议，而是通过外部工具适配。

常用配置：

{
  "fmdCompiler.programmerPath": "C:\\path\\to\\programmer.exe",
  "fmdCompiler.programmerArgs": [
    "--chip", "${chip}",
    "--file", "${hexFile}",
    "--program"
  ],
  "fmdCompiler.downloadFileType": "hex"
}

支持变量：

EEPROM 功能

插件提供 EEPROM 编辑器，可查看和修改 EEPROM 镜像数据。

默认 EEPROM 配置：

{
  "fmdCompiler.eepromBaseAddress": "0x2100",
  "fmdCompiler.eepromStart": "0x00",
  "fmdCompiler.eepromSize": 112,
  "fmdCompiler.eepromFill": "0xFF"
}

插件会优先从 .map 文件解析 EEPROM 区域，例如：

-AEEDATA=00h-06Fh/02100h

EEPROM 硬件读取/写入同样通过外部烧录工具命令实现。

自动生成 .gitignore

插件会自动生成/补充 .gitignore，屏蔽常见 MCU 编译产物和临时文件，例如：

.vscode
**/*.as
**/*.asm
**/*.bin
**/*.hex
**/*.obj
**/*.p1
**/*.pre
**/*.map
**/*.lst
**/*.ini
**/*.zip
**/*.rar

如果已有 .gitignore，插件只会补充 FMD 生成块，不会删除用户已有内容。

常见问题

1. 找不到 SYSCFG.h

执行：

FMD: Regenerate VS Code Config

插件会重新生成 c_cpp_properties.json，加入编译器 include 路径。

2. ANSEL0、TRISA 等寄存器未定义

执行：

FMD: Regenerate VS Code Config

插件会重新生成 fmd_intellisense.h 并配置 forcedInclude。

如果红线仍未消失，执行：

C/C++: Reset IntelliSense Database

然后 Reload Window。

3. 没有输出到 build 文件夹

确认当前工程的 .vscode/settings.json 中存在：

"fmdCompiler.outputDir": "build"

也可以执行：

FMD: Regenerate VS Code Config

4. 编译提示芯片不在 gcc8.ini 中

如果输出类似：

chip "FT61E13X" not present in chipinfo file "...gcc8.ini"

说明插件已经从 .prj 的 Device 字段识别出了芯片，但当前安装的 CCompiler 芯片数据库不支持该型号。插件会尝试从历史 .map 的 Machine type is ... 和内置别名规则推导实际编译器芯片名，例如 FT61E13X -> FT61F13X。如果仍失败，请确认：

• 是否安装了支持该芯片的新版本 CCompiler
• .prj 中的 Device = ... 是否写成了官方工具支持的芯片名
• fmdCompiler.compilerPath 是否指向正确的 CCompiler 安装目录

5. 下载功能不能直接使用

需要先配置实际使用的外部烧录工具路径和参数：

FMD: Configure Programmer

开发与打包

安装依赖：

npm install

编译：

npm run compile

打包：

npx @vscode/vsce package --allow-missing-repository

License

MIT