VHDL Language Server/Support
VHDL Language Server and Support for Visual Studio Code.
- Live syntax and type checking
- Finds missing and duplicate declarations
- Goto-definition/declaration (also in presence of overloading)
- Find-all-references (also in presence of overloading)
- From component declaration to matching entity by default binding
- From entity to matching component declaration by default binding
- Hovering symbols reveals more information
- Renaming symbols
- Finding workspace symbols
- Viewing/finding document symbols
The language server needs to know the library mapping of the VHDL files in the project, for this purpose it reads a configuration file in the TOML format named
The file contains the library mapping of all files within the project and should be located in the workspace root.
Files outside of the project without library mapping are checked for syntax errors only.
vhdl_ls will load configuration files in the following order of priority (first to last):
- A file named
.vhdl_ls.toml in the user home folder.
- A file name from the
VHDL_LS_CONFIG environment variable.
- A file named
vhdl_ls.toml in the workspace root.
Library definitions in later files redefines those from previously loaded files.
# File names are either absolute or relative to the parent folder of the
# vhdl_ls.toml file and supports glob-style patterns.
# Defines library lib2
lib2.files = [
# Defines library lib1
lib1.files = [
Technology under the hood
This extension is based on the VHDL-LS Language Server.
Pre-compiled binaries for Linux and Windows are provided with the extension.
The server can also be loaded from either the system path or Docker depending
on the value of the
embedded: Use the embedded binary.
user: Use path provided by user in
vhdl_ls from path.
docker: Use docker image (Only supports files below workspace root)
NOTE: On Linux, it may be necessary to set -x on the vhdl_ls binary.
Issues related to the extension can be reported at VHDL LS - VSCode repository.
Issues related to the VHDL language support and language server featuresshould be reported directly to VHDL-LS
Syntax coloring is based on the textmate vhdl.tmbundle
The VSCode extension is available under the MIT license.
VHDL language server is available under the Mozilla Public
License, v. 2.0.