Installation and setup

ZStudio is a cross-platform embedded IDE, which can run on your desktop for Windows and Linux, or you can try it online on any machine with a browser.

Install ZStudio desktop

You can review the system requirements to check if your computer configuration is supported.

• Windows : Windows 10 (32-bit and 64-bit) and above; Visual C++ is needed in development environment

• Linux:

  • Ubuntu 20.04, Ubuntu 22.04 and Ubuntu 24.04

  • CentOS 7

  • Fedora 41

Please visit Terapines Products and follow the platform-specific guides to download and install ZStudio Lite or ZStudio Pro.

On Linux

1. Download the ZStudio Lite/Pro tarball for Linux on Terapines Products.

2. Unpack the downloaded archive. The extract directory should not contain Chinese or other special characters such as space or ( ).

3. Execute the Bash file with command sudo ./install.sh to create application shortcut.

4. Double-click the shortcut to run ZStudio.

On Windows

1. Download the ZStudio Lite/Pro zip for Windows on Terapines Products.

2. Unpack the downloaded archive. The extract directory should not contain Chinese or other special characters such as space or ( ).

3. Double-click the execution file ZStudio.exe to run ZStudio.

ZStudio included libzcc with base ISAs by default. You can install additional libzcc, libdsp or libnn software libraries by Pack management. If ZStudio detects that a required library for your specified architecture is missing from the toolchain, it will prompt you to download it via the package manager.

The supported multilib/march of libzcc with base ISA

• rv32ec/ilp32e
• rv32emc/ilp32e
• rv32emac/ilp32e
• rv32ic/ilp32
• rv32imc/ilp32
• rv32imac/ilp32
• rv32imafc/ilp32f
• rv32imafdc/ilp32d
• rv64imac/lp64
• rv64imafc/lp64f
• rv64imafdc/lp64d

Login

You can use ZStudio Lite directly without log in. License is required to get the full features of ZStudio Pro by logging in with a Terapines Cloud account. Each user account is linked to a specific license. When use ZStudio, signing in successfully means that the account is bound with the current machine. When signing out, the account will be unbound from the machine.

1. Click the (Account) > Sign in in the bottom-left corner and you will be redirected to the Terapines in your default web browser.

   

2. Login in to your Terapines account on the website and click Sign in.

   

3. Click Open ZStudio in the pop-up dialog to jump back to ZStudio on desktop and check "Sign in successfully" message.

   

4. If you sign in on current machine without signing out from the previous one, there is an error message on bottom-right corner. Click Unbind and Request License button to unbind the License from the previous machine and use it on current one.

   

5. Check the Unbind license successfully prompted from message window.

6. Check the Request license successfully and you can experience the full features of ZStudio in current machine.

Logout

Click (Account) > Sign out to log out. With out available account, you only have access to the free features. To use the full version of the application, you need to use Terapines account to log in.

Version information

You can identify the version of ZStudio you are using by clicking Help > About. To get informed of information about the changes, improvements, and fixes, go to Help > Changelog.

Try ZStudio Cloud

You can access ZStudio Cloud online on any machines.

You have to register a new account before trying ZStudio Cloud. Terapines Gitlab account is recommended. Or simply sign in if you already have one.

Click the button to launch ZStudio Cloud. ZStudio opens up in the ZSolution mode by default. To switch to another mode, click mode icons on up-left corner and make a selection from the drop-down menu.

Feel free to create projects or solutions in your $HOME directory, which will be persistently saved. Even if you log out of ZStudio Cloud and later create a new instance, there's no need to worry about losing these files.