Settings

Every setting of HDL Studio, by group.

Open them with Preferences: Open Settings and the filter @ext:SoftForge.soft-forge-hdl-studio, or from the gear of the workspace dashboard. Toolchain paths are machine settings and are never stored in the workspace file.

GHDL#

Setting	Default	Description
`hdl.ghdl.path` string	`"ghdl"`	GHDL executable.
`hdl.ghdl.gdbPath` string	`"gdb"`	GDB executable, used for source-level debugging with GHDL’s GCC or LLVM backend.
`hdl.ghdl.ccPath` string	`"gcc"`	C compiler used once to build the VPI debug agent.
`hdl.ghdl.standard` string	`"08"`	VHDL standard for a launch without a workspace file (a workspace file sets its own). One of %!v(MISSING), %!v(MISSING), %!v(MISSING), %!v(MISSING), %!v(MISSING), %!v(MISSING), %!v(MISSING)
`hdl.ghdl.workDir` string	`".hdl-studio"`	Folder for the GHDL library and the recordings of a launch without a workspace file; relative to the workspace folder.
`hdl.diagnostics.onSave` boolean	`true`	Check a VHDL file with GHDL when it is saved and show the errors in the editor and the Problems panel.

Debugger#

Setting	Default	Description
`hdl.debugger.stepTime` string	`""`	Time the Step Time command advances (for example 10 ns). Empty: up to the next time with activity.
`hdl.debugger.stopAtEntry` boolean	`true`	Stop at the start of the simulation when debugging a launch without a workspace file.
`hdl.debugger.record` boolean	`true`	Keep a .ghw recording of each launch without a workspace file, in the work folder.

Signal viewer#

Setting	Default	Description
`hdl.viewer.radix` string	`"hex"`	Radix used for vectors. One of %!v(MISSING), %!v(MISSING), %!v(MISSING), %!v(MISSING)
`hdl.viewer.followCursor` boolean	`true`	Keep the time where the debugger stands in view in the signal viewer while stepping.
`hdl.viewer.maxTransitions` number	`2000000`	Value changes kept in memory by the signal viewer. The oldest are dropped first.

License#

Setting	Default	Description
`hdl.license.serverUrl` string	`""`	Another Soft Forge Payments server than the built-in one, for example a local one for development. Empty: the built-in server.
`hdl.license.publicKey` string	`""`	Ed25519 public key of the product, as base64 of the 32 raw bytes or a PEM block; several, separated by commas, for a key rotation. Empty: the built-in key. A setting is not an enforcement boundary; releases build the key in.
`hdl.license.keyPrefix` string	`""`	The first part of every license key of the product. Empty: the built-in prefix.

Vivado#

Setting	Default	Description
`hdl.vivado.path` string	`""`	Vivado installation: the vivado executable, its bin directory or the install directory. Empty looks on the PATH and in /opt/Xilinx. hw_server is taken from the same installation.
`hdl.vivado.part` string	`""`	FPGA part for synthesis (for example xc7a35tcpg236-1). Empty uses the part (or board) of the workspace file.
`hdl.vivado.verifyAfterProgram` boolean	`false`	After programming the device, check that it reports DONE.

Command line#

Setting	Default	Description
`hdl.cli.addToTerminalPath` boolean	`true`	Make the hdl command available in terminals opened in VS Code.
`hdl.cli.bridge` boolean	`true`	Let the hdl command in a terminal drive this window’s debug session, breakpoints and signal viewer (a local socket only you can reach).

Documentation for HDL Studio 1.0.4.