Livt Installation

This guide provides step-by-step instructions for installing the Livt compiler on Linux and Windows. Follow the section for your operating system below.

Supported Operating Systems

The Livt compiler supports the following OS versions:

• Ubuntu 24.04 LTS (Noble Numbat)
• Windows 11
• Windows 10

Installation on Ubuntu 24.04 LTS (Noble Numbat)

Before installing the Livt compiler on Ubuntu 24.04 LTS, you must first install the prerequisites.

Prerequisites

• Java Runtime Environment (JRE) from OpenJDK 17

The following command installs the JRE from OpenJDK 17.

sudo apt update && sudo apt install openjdk-17-jre

Installing the Livt Compiler

Once the prerequisites are installed, download the Livt installation package from your download section and extract it into the installation directory:

mkdir -p ${HOME}/.livt
tar -xzf livt-ubuntu-24.04-latest.tar.gz -C ${HOME}/.livt

To make the livt command accessible from any terminal session, add the installation path to your .bashrc file:

echo 'export PATH="${PATH}:${HOME}/.livt"' >> ~/.bashrc
source ~/.bashrc

Check that the Livt compiler is installed correctly by running livt --version.

livt --version

Licensing

To use the Livt compiler, a valid license must be installed. If no licenses are found, you will see:

livt --licenses    
Licenses Path: /home/developer/.livt/licenses

No licenses found.

Download the license file from your account's license section to the Livt compiler's license directory:

~/.livt/licenses/livt.lic

Once the license file is in place, check its validity:

livt --licenses    
Licenses Path: /home/developer/.livt/licenses

Licenses (File, Product, Type, Start Date, Expiration Date)

livt.lic - Livt, Team, 13/12/2023, 31/12/2024

Your Livt compiler setup is now complete and ready to use.

Simulation

The livt test command uses GHDL as its default simulator. Through vendor integrations, other simulators can be used as well. To use the default GHDL simulator, GHDL must be installed on your system and the ghdl executable must be available on the PATH — only then is the livt command able to invoke it.

Download and install the latest GHDL release from the GHDL releases page. For installation instructions and build options, refer to the GHDL repository.

Verify the installation by checking the GHDL version:

ghdl --version

Using HxS with Livt

If your project requires CPU access to FPGA components, Livt relies on the HxS compiler to generate the necessary bus interface. In this case, HxS must be installed in addition to Livt and be available on the PATH.

Refer to the HxS Installation on Ubuntu 24.04 LTS guide for setup instructions.

Windows 11

This guide walks you through the steps to install and configure the Livt compiler on Windows 11.

Prerequisites

Before installing the Livt compiler, ensure the following software is installed:

• Java Runtime for Windows

Installing the Livt Compiler

Download the latest version of the Livt compiler from your download section and extract the package into the folder %USERPROFILE%\.livt.

Livt Installation Path: %USERPROFILE%\.livt

Adding the Livt installation path to the Windows PATH environment variable makes the livt command available system-wide.

Configure PATH:

• Right-click on 'This PC' and select 'Properties'.
• Go to 'Advanced system settings' and click on 'Environment Variables'.
• Under 'System Variables', find and select 'Path', then click 'Edit'.
• Add %USERPROFILE%\.livt to the list to make the livt command available system-wide.

Verify the installation by running the Livt compiler from the command line.

C:\livt --version

Licensing

To use the Livt compiler, a valid license must be installed. If no licenses are found, you will see:

C:\livt --licenses    
Licenses Path:  C:\Users\Developer\.livt\licenses

No licenses found.

Download the license file from your account's license section to the Livt compiler's license directory:

C:\Users\Developer\.livt\licenses\livt.lic

Once the license file is in place, check its validity:

C:\livt --licenses    
Licenses Path: C:\Users\Developer\.livt\licenses

Licenses (File, Product, Type, Start Date, Expiration Date)

livt.lic - Livt, Team, 13/12/2023, 31/12/2024

After completing these steps, the Livt compiler is fully set up and ready for use.

Simulation

The livt test command uses GHDL as its default simulator. Through vendor integrations, other simulators can be used as well. To use the default GHDL simulator, GHDL must be installed on your system and the ghdl executable must be available on the PATH — only then is the livt command able to invoke it.

Download the latest GHDL release for Windows from the GHDL GitHub releases page. Extract the package and add the GHDL binary directory to the Windows PATH environment variable following the same steps used for the Livt compiler above.

Verify the installation by checking the GHDL version:

C:\ghdl --version

Using HxS with Livt

If your project requires CPU access to FPGA components, Livt relies on the HxS compiler to generate the necessary bus interface. In this case, HxS must be installed in addition to Livt and be available on the PATH.

Refer to the HxS Installation on Windows 11 guide for setup instructions.

Windows 10

This guide walks you through the steps to install and configure the Livt compiler on Windows 10.

Prerequisites

Before installing the Livt compiler, ensure the following software is installed:

• Java Runtime for Windows

Installing the Livt Compiler

Download the latest version of the Livt compiler from your download section and extract the package into the folder %USERPROFILE%\.livt.

Livt Installation Path: %USERPROFILE%\.livt

Adding the Livt installation path to the Windows PATH environment variable makes the livt command available system-wide.

Configure PATH:

• Right-click on 'This PC' and select 'Properties'.
• Go to 'Advanced system settings' and click on 'Environment Variables'.
• Under 'System Variables', find and select 'Path', then click 'Edit'.
• Add %USERPROFILE%\.livt to the list to make the livt command available system-wide.

Verify the installation by running the Livt compiler from the command line.

C:\livt --version

Licensing

To use the Livt compiler, a valid license must be installed. If no licenses are found, you will see:

C:\livt --licenses    
Licenses Path:  C:\Users\Developer\.livt\licenses

No licenses found.

Download the license file from your account's license section to the Livt compiler's license directory:

C:\Users\Developer\.livt\licenses\livt.lic

Once the license file is in place, check its validity:

C:\livt --licenses    
Licenses Path: C:\Users\Developer\.livt\licenses

Licenses (File, Product, Type, Start Date, Expiration Date)

livt.lic - Livt, Team, 13/12/2023, 31/12/2024

After completing these steps, the Livt compiler is fully set up and ready for use.

Simulation

The livt test command uses GHDL as its default simulator. Through vendor integrations, other simulators can be used as well. To use the default GHDL simulator, GHDL must be installed on your system and the ghdl executable must be available on the PATH — only then is the livt command able to invoke it.

Download the latest GHDL release for Windows from the GHDL GitHub releases page. Extract the package and add the GHDL binary directory to the Windows PATH environment variable following the same steps used for the Livt compiler above.

Verify the installation by checking the GHDL version:

C:\ghdl --version

Using HxS with Livt

If your project requires CPU access to FPGA components, Livt relies on the HxS compiler to generate the necessary bus interface. In this case, HxS must be installed in addition to Livt and be available on the PATH.

Refer to the HxS Installation on Windows 10 guide for setup instructions.