Yichip Assembler
面向 YiChip 蓝牙与音频固件开发的 Visual Studio Code 扩展,支持 .prog、.format 和 .dat 文件。
语法高亮
保留 1.0.1 原有高亮分类及匹配优先级,已有颜色沿用原规则;函数名称与 define/ifdef 宏名称按 Python 的函数和常量分类显示;define 关键字使用 Python def 的分类,ifdef、ifndef、else if、else、endif 与 define 使用相同的高亮分类,跟随当前主题。仅为此前未着色的新指令、寄存器、标志位等补充高亮。词表覆盖 325 个当前及旧版保留指令名称。
编译输出文件高亮
支持 .lis 的地址、机器码和汇编代码,以及 .list 的地址、源码行号和汇编代码。.meta 支持宏、指令及地址符号表,.rom 的二进制与十六进制数据沿用 DAT 数据配色。LIS、LIST、META 同时支持指令补全、参数提示和指令悬浮说明;列表文件的地址、机器码、行号不参与指令匹配。.lis 使用橙色 L 图标,.list 保留紫色 L。
未启用宏代码淡化
默认从工作区 program/core/core_load.prog 读取宏,递归处理 PROG include,结合编辑器中尚未保存的修改,淡化确定未启用的分支,默认不透明度为 60%。支持嵌套 ifdef/ifndef、else if、else、endif 和宏布尔表达式。else if 按当前工程 mergepatch.pl 的规则重新求值。
可在设置中搜索 inactiveCode 调整开关、不透明度、宏入口文件及额外预定义宏。请打开工程根目录;采用不同构建入口的工程需要设置对应入口。入口缺失、无法识别的表达式及不完整条件结构保持正常显示。本功能提供编辑辅助,编译结果以工程构建脚本为准。
文件图标
为 .prog、.format、.dat 提供蓝色 P、橙色 F、绿色 D 文件图标;另为 .list、.meta、.rom 提供紫色 L、青色 M、红色 R 文件图标,分别适配浅色和深色主题。当前文件图标主题已有的专用图标优先;如未显示,可在“首选项:文件图标主题”中选择 Seti(Visual Studio Code)。选择 None、Minimal 或禁止语言图标的主题时,图标可能不显示。
文件名包含 patch 的 .prog 文件使用黄色 P 图标,例如 patch.prog、bt_patch.prog,不区分大小写。其语言模式为 Assembler patch file,沿用 PROG 高亮、补全、悬浮与导航功能。
指令补全与悬浮说明
输入指令前缀即可选择候选项,也可按 Ctrl+Space 手动触发。选择后按 Tab 依次填写参数。候选项和悬浮窗口提供参数顺序、运算关系、内存读写方向和条件跳转说明。
sub regr, immediate, regw
isub regr, regw
ifetcho num_bytes, immediate, regaddr
sub 显示“被减数 immediate − 减数 regr → 结果 regw”,isub 显示“被减数 pdata − 减数 regr → 结果 regw”。
参数和说明依据 XD/XF 的 command.format 整理,当前有 313 条指令定义。其余旧版保留名称提供名称补全。
可视化规则编辑
按 Ctrl+Shift+P,执行 Yichip Assembler: 编辑高亮规则,即可编辑指令、寄存器、标志位词表,并选择新增高亮的颜色。原版已着色部分不受此面板的颜色设置影响。
- 勾选颜色项目可覆盖主题配色,取消勾选后跟随主题。
- 颜色保存到 VS Code 用户设置并立即应用。
- 词表保存到当前扩展目录,语法高亮需要重载窗口后生效。
- 点击“恢复默认到表单”后保存,可恢复初始词表和主题配色。
更具体的工作区或主题设置可能覆盖用户配色。升级可能替换扩展目录中的词表,升级前请保留 highlight-customizations.json。
从旧版迁移
首次启用时检查旧版 jing.yichip-project 及此前测试版 airiet-tools-test.yichip-assembler。如检测到旧版,可选择卸载旧版、打开旧版管理页面或暂不处理。
旧版仍可被检测到时,新版暂停注册编辑功能。卸载或禁用旧版后重载窗口,即可启用新版。也可从命令面板执行 Yichip Assembler: 检查并迁移旧版 再次打开提示。
安装与升级
在扩展视图的“…”菜单中选择“从 VSIX 安装…”,选择安装包后按提示重载窗口。也可运行以下命令。
code --install-extension .\yichip-assembler-1.2.4.vsix --force
打开 .prog、.format 或 .dat 文件即可使用。如未自动识别,可点击状态栏语言模式,选择对应的 Assembler 文件类型。
要求 VS Code 1.71.0 或更高版本。扩展标识为 Airiet.yichip-assembler,通过迁移提示协助移除旧版。扩展基于原版 Yichip Project Manage 更新,保留其许可与署名。