🛠️ Verilog ILA Helper
专业级 Verilog ILA 探针管理工具
一键生成、更新、高亮 ILA 信号,让 FPGA 调试效率翻倍
📦 VS Marketplace |
⬇️ Downloads |
⭐ Rating |
📄 MIT License
📖 目录
✨ 功能特性
| 功能 |
说明 |
| ⚡ 一键生成/更新 ILA |
选中信号,按快捷键自动在 endmodule 前生成或更新 probe0 列表 |
| 📊 智能位宽计算 |
自动解析信号位宽,悬停或状态栏实时显示总宽度 |
| 🎨 多色高亮 |
不同 ILA 实例使用不同颜色,一目了然 |
| 🔀 多实例支持 |
支持 ila_0 ~ ila_9 共 10 个独立实例 |
| 🧩 条件编译识别 |
自动识别 `ifdef,只高亮激活块中的 ILA |
| 💡 注释感知 |
被注释的 ILA 或内部信号不会高亮 |
| 🔄 增量更新 |
多次添加信号,自动去重合并 |
| 🔍 悬停信息 |
鼠标悬停显示总位宽,数字加粗突出 |
| 🔘 一键开关高亮 |
Ctrl+Shift+H 快速切换高亮,状态栏实时反馈 |
| ⚙️ 灵活配置 |
自定义快捷键映射、高亮颜色、位宽显示等 |
🎯 快速上手
安装插件
- 在 VS Code 扩展商店搜索 Verilog ILA Helper,点击安装。
- 或手动安装:下载
.vsix 文件,通过 Install from VSIX... 安装。
基本使用
- 打开一个 Verilog 文件(
.v 或 .sv)。
- 选中信号名(支持多选、多光标)。
- 按下对应的快捷键:
Ctrl+Shift+I:弹出选择列表(多实例时)。
Ctrl+Shift+O:添加到 ila_0。
Ctrl+Shift+1 ~ Ctrl+Shift+9:添加到 ila_1 ~ ila_9。
- 插件自动完成插入/更新、合并、高亮。
- 切换高亮:按
Ctrl+Shift+H 随时开关。
⌨️ 快捷键一览
| 快捷键 |
功能 |
Ctrl+Shift+I |
插入/更新 ILA(选择实例) |
Ctrl+Shift+O |
添加到 ila_0 |
Ctrl+Shift+1 |
添加到 ila_1 |
Ctrl+Shift+2 |
添加到 ila_2 |
Ctrl+Shift+3 |
添加到 ila_3 |
Ctrl+Shift+4 |
添加到 ila_4 |
Ctrl+Shift+5 |
添加到 ila_5 |
Ctrl+Shift+6 |
添加到 ila_6 |
Ctrl+Shift+7 |
添加到 ila_7 |
Ctrl+Shift+8 |
添加到 ila_8 |
Ctrl+Shift+9 |
添加到 ila_9 |
Ctrl+Shift+H |
开关高亮显示 |
💡 提示:所有快捷键均可在 VS Code 键盘快捷方式设置中自定义修改。
⚙️ 配置选项
在 VS Code 设置中搜索 ilaHelper,即可调整以下选项:
| 配置项 |
说明 |
默认值 |
ilaHelper.enableHighlight |
是否启用信号高亮 |
true |
ilaHelper.multiColor |
是否启用多色高亮(每个 ILA 不同颜色) |
true |
ilaHelper.highlightColor |
单色模式背景色(关闭多色时生效) |
rgba(255, 255, 0, 0.3) |
ilaHelper.highlightBorder |
单色模式边框色 |
rgba(255, 200, 0, 0.5) |
ilaHelper.highlightTextColor |
单色模式文字色 |
#000000 |
ilaHelper.defines |
额外宏定义(如 ["DEBUG"]) |
[] |
ilaHelper.targetTypes |
快捷键映射的 ILA 类型名数组 |
["ila_0", ..., "ila_9"] |
ilaHelper.enableStatusBar |
状态栏显示总位宽 |
true |
💡 颜色设置小技巧:在设置页面中,点击颜色预览块(小方块),即可弹出颜色选择器,轻松挑选颜色。
📐 使用示例
假设您有一个顶层模块 top,其中例化了 ila_0,您希望将内部信号 data_in 和 data_out 添加到该 ILA 中。
操作步骤
- 在代码中选中信号名
data_in 和 data_out(支持多选)。
- 按快捷键
Ctrl+Shift+O(对应 ila_0)。
- 插件会自动定位到
ila_0 u_ila_0 实例,并将这两个信号追加到 probe0 列表中。
- 同时,插件会重新计算总位宽,并在您悬停鼠标或查看状态栏时显示更新后的宽度。
- 您可以随时按
Ctrl+Shift+H 开关高亮显示,方便集中查看特定信号。
效果预览
- 高亮效果:不同 ILA 实例的信号使用不同颜色背景,便于区分。
- 悬停信息:鼠标悬停在任何 ILA 实例名称上,会显示该实例的总位宽(数字加粗)。
- 状态栏:当光标位于 ILA 实例内部时,底部状态栏会实时显示当前实例的总位宽。
❓ 常见问题
Q:打开 Verilog 文件时没有高亮?
确认文件语言模式为 Verilog(右下角状态栏)。若未自动激活,可手动执行刷新命令。
Q:宏定义未打开时,`ifdef` 块中的 ILA 怎么不消失?
插件只控制信号高亮,不改变代码颜色。未激活块中的 ILA 不会被高亮。
Q:如何添加编译选项定义的宏(如 `+define+DEBUG`)?
在设置 ilaHelper.defines 中添加宏名,例如 ["DEBUG"]。
Q:`Ctrl+Shift+O` 不起作用?
可能是键绑定冲突。在键盘快捷方式设置中搜索 verilog-ila-helper.insertToILA0,重新绑定或检查占用。
Q:悬停时数字没有加粗?
确保使用最新版本(≥ v0.0.31),Markdown 加粗在所有主题下均有效。
📝 版本历史
| 版本 |
更新内容 |
| v0.0.33 |
✨ 更名为 Verilog ILA Helper,优化搜索体验;添加鼓励语。 |
| v0.0.32 |
✨ 新增高亮开关快捷键 Ctrl+Shift+H,状态栏显示 ON/OFF |
| v0.0.31 |
🔍 悬停信息优化:仅总位宽数字加粗,其他文本正常 |
| v0.0.30 |
📝 移除内联样式,改用 Markdown 加粗,提升兼容性 |
| v0.0.29 |
🧪 添加调试日志和强化样式(未生效) |
| v0.0.28 |
📌 支持多实例定位,悬停显示折叠信息 |
| v0.0.27 |
🚀 移除代码注释,改为状态栏显示总位宽 |
| v0.0.26 |
🔢 支持 10 个 ILA 实例(0~9) |
🤝 致 FPGA 工程师
亲爱的 FPGA 工程师朋友:
感谢你使用 Verilog ILA Helper!这个插件的诞生,源于我在日常开发中反复经历的手动添加 ILA 信号的繁琐与易错。我相信,每一个 FPGA 开发者都值得拥有更高效的工具,把宝贵的时间留给真正重要的设计思考。
如果你的朋友或同事也在为 ILA 调试烦恼,欢迎将这个插件分享给他们。你的每一次点赞、反馈和建议,都是推动它变得更好的动力。让我们一起,让 Verilog 开发更轻松,更愉悦!
—— 你的开发者伙伴,WUDI
📄 开源协议
本项目基于 MIT 许可证 开源。
⭐ 如果这个插件对您有帮助,请给一个 Star!
Built with ❤️ by WUDI
| |