VHDL by HGB 1.0.1

VHDLbyHGB：Visual Studio Code的VHDL项目编辑扩展

VHDLbyHGB是由上奥地利应用科学大学Hagenberg校区的Jakob Jungreuthmayer、Sonja Schoissengaier和Florian Lucut维护的Visual Studio Code扩展，旨在为VHDL项目提供高效的编辑和开发环境。

技术基础

该扩展基于VHDL-LS语言服务器，支持Linux、Windows和MacOS的预编译二进制文件。用户可以根据vhdl-by-hgb.vhdlls.languageServer属性的值，从系统路径或Docker中加载服务器。

使用方法

语言服务器需要了解项目中VHDL文件的库映射，为此它会读取名为vhdl_ls.toml的TOML格式配置文件。该文件应位于工作区根目录，包含项目内所有文件的库映射。vhdl_ls会按以下优先级顺序加载配置文件：

1. 用户主文件夹中的.vhdl_ls.toml文件。
2. VHDL_LS_CONFIG环境变量指定的文件。
3. 工作区根目录中的vhdl_ls.toml文件。

后加载的文件设置会覆盖先前加载的文件设置。

项目设置

要使用VHDLbyHGB，您需要：

1. 在VS-Code中打开整个VHDL项目文件夹。
2. 将vhdl_ls.toml文件放置在项目根目录。
3. 通过调用命令VHDLbyHGB.Project.Setup，将打开的文件夹设置为VHDL项目。默认情况下，vhdl_ls.toml将自动生成，包含所有子文件夹中的vhdl文件。

LSP功能

VHDLbyHGB提供以下LSP功能：

• 实时语法和类型检查
• 查找缺失、重复和未使用的声明
• 跳转到定义/声明（支持重载）
• 查找所有引用（支持重载）
• 跳转到实现
• 从组件声明到匹配的实体默认绑定
• 从实体到匹配的组件声明默认绑定
• 悬停符号显示更多信息
• 重命名符号
• 查找工作区符号
• 查看/查找文档符号
• 代码完成（实体）

格式化

您可以通过命令面板或键盘快捷键格式化文档。支持的格式化工具包括vhdl_formatter和emacs_vhdl_formatter，用户可以根据需要选择和配置。

动态片段和实体转换器

动态片段为实体实例化提供自动完成功能。实体转换器允许您将实体复制并以不同格式粘贴，支持组件声明、实例化、实体、信号和常量。

综合和验证

VHDLbyHGB支持基本的综合操作，目前仅支持Quartus。验证功能通过VUnit和HDLRegression等工具实现，并与VSCode-TestExplorer集成。

VHDL片段

扩展提供了多种VHDL片段，包括转换函数、实例化、测试台和其他常用代码片段，帮助您快速编写VHDL代码。

前提条件

使用VHDLbyHGB需要预先安装验证工具（如VUnit、HDLRegression）和综合工具（如Quartus）。

贡献和许可

欢迎以代码、文档、反馈、教程、创意或错误报告的形式贡献。该扩展在GNU GPL许可下发布。

通过VHDLbyHGB，您可以更高效地管理和开发VHDL项目，提升您的开发体验。