Distribution and Flavors
Sigasi Studio is distributed online. It is available in two versions: as a stand-alone application or as a plugin inside a standard Eclipse installation. Your license gives you the right to use either version, at any time, at your discretion. Therefore, your first task is to decide which version suits your requirements, based on the description below. Depending on the chosen version, you should then follow the corresponding installation instructions.
Sigasi Studio App
The stand-alone application has the following characteristics:
- Recommended if you are not using Eclipse yet
- Installation is trivial: just unzip!
- Everything is included in a single download
- Well-balanced set of features
- Optimized for VHDL and Verilog development
- Complete freedom to add and configure plugins
Sigasi Studio Eclipse Plugin
The Eclipse plugin has the following characteristics:
- Recommended if you are using Eclipse already
- Easily plugged into your existing Eclipse platform
- Complete freedom to add and configure plugins
- Over one thousand other Eclipse plugins to choose from
- Support for C, C++, Tcl, and other languages
- Support for many version control systems
Sigasi Studio Custom Installation
- Recommended for (larger) teams
- Automates the setup of Eclipse, the Sigasi Studio plugin, and your project
- Ensure that team members have a uniform setup
- Quickly set up Eclipse with Sigasi Studio
- Configure team preferences during setup
- Check out a project from version control at setup time
- Optionally add support for other programming languages
The custom installation is documented in a separate section.
Installation of Sigasi Studio App
To download and install Sigasi Studio as a stand-alone application, follow the online Installation Instructions.
After downloading, choose or create a folder where you want to install
the software and unpack the archive there. The archive contains a
single top-level folder called
sigasi. Inside the folder, there is an
application startup file, also called
sigasi. Start the application by
executing this startup file.
If you are using RedHat Linux 6 or CentOS 6, you need to follow the Plugin installation instructions as explained here.
Running Sigasi Studio with multiple users on the same server
The following section is only relevant if you’re using a Sigasi Studio version older than Sigasi Studio 4.17.2.
Starting with Sigasi Studio 3.8, the Sigasi launcher listens on port 4444. To avoid conflicts on this port when Sigasi Studio is used on a server with multiple users concurrently, the following changes need to be made:
sigasi/sigasi.iniadd following lines between
- If there are other arguments between
-vmargs, append to these.
@noDefault -vm plugins/org.eclipse.justj.openjdk.hotspot.jre.full.<version>/jre/bin --launcher.defaultAction openFile -vmargs
This way Sigasi Studio uses the default Eclipse behavior instead of the custom Sigasi runner. More information on the Eclipse OpenFileFeature can be found here.
The Sigasi runner allows you to open projects using the
This is not possible when using the default Eclipse runner.
Installation of Sigasi Studio Eclipse Plugin
There are two ways to install the Sigasi Studio Eclipse Plugin:
Prerequisites: Java Runtime
- The Sigasi Studio plugin requires Java 11.
- You can check your Java version with
- Java can be downloaded from several sources, a.o. Adoptium.
- You need to have at least Eclipse version 2021-03 (4.19).
- This Eclipse version and the Sigasi Studio plugin require Java 11 or 17.
- If you don’t have Eclipse installed yet, the C/C++ flavor would be a good place to start. Just download (Windows 64 bit/Linux 64 bit/Other versions), unzip, and start.
- We recommend you also increase the heap size for Eclipse.
For more information on system requirements: System Requirements
Install the Eclipse Plugin
This requires the host where you install the Sigasi Studio Plugin to have access to our download server. After starting Eclipse:
- Click Help > Install New Software…
- In the Work with: field enter
https://download.sigasi.com/updates/studioand press enter.
- Check the checkbox next to Sigasi Studio
- Since Sigasi Studio 4.15, installing Sigasi Studio optional features is no longer recommended.
- Click the Next button.
- The following steps are pretty self-explaining.
- After the installation, you will need to restart Eclipse. Once this is done, go to Window > Perspective > Open Perspective > Other… and select the Sigasi Perspective. You can then close the Welcome View to show the Sigasi Views.
Installing the Offline Update Site
Installing the offline update site is very similar to installing from the main update site, where step 2 is replaced with these steps:
- Download the offline update site
- In the Install Wizard, click Add…
- Click Archive…, browse to the zip file you downloaded, and confirm with OK.
Next, continue with step 3. in the general eclipse installation instructions. It is recommended to disable the option Contact all update sites during install to find required software when installing the offline update site.
GPG Certificate Validation
Eclipse 4.26 (2022-12) added GPG certificate checking capabilities. When you install new plugins, you will be prompted to trust any not-yet-trusted GPG keys or unsigned artifacts. Because Sigasi artifacts are correctly signed using GPG, you can expect to see the following screen the first time you install or update Sigasi in an Eclipse >= 4.26.
Previously trusted keys can be inspected by going to Window > Preferences > Install/Update > Trust.
You can refer to this page for all information regarding GPG at Sigasi.
The license key can be filled in under Window > Preferences > Sigasi > License Key.
More details can be found here. The license unlocks the features for your edition.
Sigasi Studio stores its projects on the file system in one or more workspaces.
When you start the tool for the first time, it will propose to create a workspace for you:
Although you can work with multiple workspaces, we recommend using a single workspace for all your projects.
Sigasi Studio has an automated update system. When updates are available, you are notified by a pop-up window called Updates Available in the bottom right corner:
If you want to install the updates, click anywhere in the pop-up window. After a few seconds, a new window will appear with further instructions.
The updates can be postponed by closing the pop-up. You can perform the updates at any time by clicking the -icon in the status bar at the bottom of the screen.
It is good practice to first create a backup of your installation folder before running an update. This can be done by simply compressing the
eclipse or the
sigasi folder in an archive (zip file)
Update Sigasi Studio App
If you run Sigasi Studio as a standalone application, the automated update system will periodically check for software updates.
Update Sigasi Studio Eclipse plugin
If you run Sigasi Studio as an Eclipse plugin, you may need to check for updates manually, by clicking Help > Check for Updates.
You can enable automatic updates by opening this preference page: Install/Update > Automatic Updates. Next, enable Automatically find new updates and notify me. Feel free to modify any of the available options.
Firewalls and Proxies
If the updates are not automatically fetched from the Sigasi Studio update server you are probably behind a firewall or proxy server. You can configure Sigasi Studio’s proxy settings in Window > Preferences > General > Network connections. Make sure to set the Active Provider to Manual and configure the appropriate Proxy entries. Whether you need to configure the entries for HTTP or HTTPS depends on the Locations configured in the Available Software Sites settings.
If you can not add a firewall exception for our update site, the fallback solution is to download the complete application from our website.
You can completely replace your old installation; all settings are stored in your workspace (the default is
workspaceSigasi in your home directory).