This page explains how to install and configure the Sigasi Studio extension for VS Code.
The extension requires VS Code or VS Codium version
1.77.0 or higher.
The path to use the Java Runtime (JRE) can optionally be configured in the settings. If the setting is empty, the extension will extract the included JRE in the user’s home folder.
If you wish to provide the JRE:
- The extension requires a Java Runtime
- The Java runtime must be 64-bit. Make sure to use JRE 11 or JRE 17
- You can check your Java version with
- Java can be downloaded from several sources, a.o. Adoptium
- Make sure the
javaexecutable is available in the
To install the extension, open the Extensions pane using Ctrl+Shift+X. In the Search field on top, type Sigasi. Click the Sigasi extension and click Install.
If you’re working on a remote host for your HDL development, the extension only needs to be installed on the remote.
The settings for the Sigasi extension can be reached trough:
- Open the Command Palette using Ctrl+Shift+P
- Start typing and select Preferences: Open Settings (UI)
- In the Search field on top, type Sigasi.
- First, configure the Path To License. This can be a local node-locked license file or a floating license server (e.g.
email@example.com). The setting for the license path is similar to the one in Sigasi Studio on Eclipse.
- Optionally, configure the JRE location in Sigasi > Java: Path. Make sure to add the
javaexecutable name in the configured value.
Alternatively, the Sigasi extension settings can be accessed through the Manage icon () in the extensions overview.
You can help improve the Sigasi extension for VS Code by enabling the automatic submission of usage statistics and error stack traces. More information about this feature is available on the Talkback manual page.
This feature is disabled by default.
To enable talkback in the VS Code extension, open the settings and enable the
Sigasi: Enable Talkback option.
The messages sent to Sigasi can also be logged locally. Then you can view these messages using the Sigasi: Open Talkback Log command. In order to log the messages locally, a data storage needs to be configured.
You can specify a directory to be used by the Sigasi Language Server to write the cache and talkback logs to.
Open the settings and search for
Sigasi › Server > Caching: Data Location.
The directory needs to exist already.
Choose a local folder for optimal performance.
Once you’ve configured this directory, the setting
Sigasi > Server > Caching: Enable On Disk Caching can be enabled.
The cache will speed up the plugin by preserving the state from an earlier moment. This will speed up the build significantly. Be careful though: opening the same project in another VS Code window at the same time will corrupt the cache causing a myriad of issues.