安装使用

ZStudio 是一款跨平台集成开发环境，支持 Windows 和 Linux 桌面版本以及不受机器限制的云端版本。

安装 ZStudio 桌面版

请查看系统要求以确认您的计算机是否符合 ZStudio 支持的运行环境。

• Windows : Windows 10 (32-bit and 64-bit) 及以上，需要安装 Visual C++
• Linux : Ubuntu 20.04 和 Ubuntu 22.04

前往兆松产品页下载 Linux 或 Windows 压缩包并遵循适用平台的指南安装 ZStudio Lite 或 ZStudio Pro。

Linux 版本

1. 前往兆松产品页下载 Linux 版 ZStudio Lite/Pro 压缩包。

2. 请使用 tar 工具或其他解压工具，解压路径中请不要包含中文、空格或者 () 等特殊字符。

3. 解压完成后用户需要先以管理员权限运行 install.sh 脚本文件： sudo ./install.sh 。

4. 运行结束将生成 ZStudio 应用图标，双击打开即可运行。

Windows 版本

1. 前往兆松产品页下载 Windows 版 ZStudio Lite/Pro 压缩包。

2. 请使用 7-Zip 或其他工具解压，解压路径中不要包含中文、空格或者 () 等特殊字符。

3. 解压完成后直接双击 ZStudio.exe 即可运行。

ZStudio 默认包含基础扩展的 libzcc，如需额外的 libzcc、 libdsp 或 libnn 的软件库，可以在 ZStudio 中使用软件包管理下载安装。对于用户指定的 Arch，如果 ZStudio 没有在工具链中检测到可用的库，将会提醒用户在包管理器中下载。

基础扩展 libzcc 软件库支持的 multilib/march

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

登录运行

ZStudio Lite 无需登录，可以直接使用。体验 ZStudio Pro 完整功能需使用兆松云账号进行登录，一个用户账号绑定一个 License。用户在使用桌面版本 ZStudio 时，成功登录即将账号与当前设备进行绑定；注销登录即自动将账号与当前设备解绑。

1. 点击左下角 "用户" > "登录"跳转到默认浏览器中打开兆松云。

   

2. 用户需要输入已注册账号的用户名邮箱和密码进行登录。

   

3. 点击弹出提示框中的"打开 ZStudio"，回跳到桌面软件，右下角将会弹出"登陆成功"提示信息。

   

4. 用户在未解绑上次登录设备的情况下直接登录当前的设备，ZStudio 将在右下角弹出错误提示信息，用户可以通过"解除绑定并重新请求 License"按钮进行解绑并重新绑定当前设备。

   

5. 解绑完成后右下角会弹出"成功解除 license 与设备的绑定"提示信息。

6. 重新绑定当前设备成功后右下角将弹出"请求授权信息成功"提示信息，即用户可以开始在当前设备使用 ZStudio 完整功能。

注销登录

用户点击界面左下角的 "账户" > "注销"注销登录，注销后仅能使用免费功能，使用完整版功能需重新使用兆松云账号进行登录。

版本信息

用户点击菜单栏中的"帮助" > "关于"可查看当前软件的版本，点击"更新日志"可查看 ZStudio 的版本更新记录以了解 bug 修复进展以及最新功能。

试用 ZStudio 云端版

用户无需在本地安装和配置软件，且不受机器限制，随时随地打开浏览器访问 ZStudio Cloud 就可在线使用 ZStudio。

首次使用需要注册新账户，如果您已有账户，可以直接登录。

登录完成后，请点击按钮启动 ZStudio Cloud。首次运行 ZStudio，默认进入 ZSolution 模式，主菜单左上角提供模式切换的入口，用户可以从当前模式进入任意其他模式。

请在 $HOME 目录下创建项目或解决方案，$HOME 目录会被持久化保存，即使退出并重新登录 ZStudio Cloud，也不用担心这些文件会丢失。

终端运行工具链

请查看系统要求以确认您的计算机是否符合工具链支持的运行环境。

• Windows : Windows 10 (32-bit and 64-bit) 及以上，需要安装 Visual C++
• Linux : Ubuntu 20.04 和 Ubuntu 22.04

前往兆松产品页下载 ZCC 工具链以及支持软件库。ZCC 工具链默认包含基础扩展的 libzcc，如需要额外的扩展功能，请选择合适的软件包下载并按照以下说明将其添加到工具链中。除了自行配置扩展包，我们还提供了针对特定供应商的软件包。

• libzcc: C 和 C++ 标准库，包括 newlib，compiler-rt 和 libc++
  • newlib: 面向嵌入式系统的标准 C 库实现。提供了一组轻量且高效的函数，适用于资源受限的环境。
  • compiler-rt：运行时库，旨在支持编译器的低级代码生成和优化功能。它包含内置函数和例程，用于高效执行编译代码。
  • libc++：提供 C++ 标准库的实现。提供容器、算法和迭代器等旨在高度优化和符合标准。
• libdsp: 提供了一系列专门设计用于数字信号处理（DSP）的函数和工具。
• libnn: 专门用于实现和运行神经网络算法的库。

标准扩展包

软件包	功能
全选	包含以下所有扩展
Base*	基础扩展（I/EMAFDC）
Base_Zb*	RISC-V 位操作扩展（B）
Base_Zc*	RISC-V 代码尺寸优化扩展（Zc*）
Base_Zb*_Zc*	包含 B 扩展和 Zc* 扩展
Base_V	RISC-V 向量扩展（V）

标准扩展包支持的 multilib/march

厂商支持包

软件包	功能
Nuclei	包含支持芯来科技 SDK 所需的库
HPMicro	包含支持先楫半导体 SDK 所需的库

厂商支持包支持的 multilib/march

Linux 版本

1. ZCC Pro 授权（lite版本可以直接使用）：

   解压后的 bin 目录下提供了 zstudio.sh 脚本。用户需要手动将脚本中的 USERNAME 和 PASSWORD 修改为兆松云的用户名邮箱和密码。License 有效期为一个小时，为了实现 License 的持续更新，建议使用 zstudio.sh -d 或 zstudio.sh --daemon 命令设置定时任务刷新 License。如需取消定时任务，使用 zstudio.sh -U 或 zstudio.sh -unset-daemon 命令。

2. 添加环境变量

   通过运行 export PATH=$PATH:<zcc_install_path> 指定 zcc 可执行文件的路径将 ZCC 添加进环境变量，或者直接修改脚本中 PATH_ZCC 变量的值（同时注释掉该变量下方对 PATH_ZCC 进行检测的 which 代码块）。

3. 安装扩展包：

   扩展包默认为 .zip 格式，用户下载解压后，执行压缩包中的 install.sh 执行脚本会要求用户输入 ZCC Pro/Lite 的根目录的路径，脚本会自动将包含的库解压到 ZCC Pro/Lite 目录中。

Windows 版本

1. ZCC Pro 授权（lite版本可以直接使用）：

   解压后的 bin 目录下提供了 zstudio.sh 脚本。用户需要手动将脚本中的 USERNAME 和 PASSWORD 修改为兆松云的用户名邮箱和密码。

2. 添加环境变量

   通过运行 export PATH=$PATH:<zcc_install_path> 指定 zcc 可执行文件的路径将 ZCC 添加进环境变量，或者直接修改脚本中 PATH_ZCC 变量的值（同时注释掉该变量下方对 PATH_ZCC 进行检测的 which 代码块）。

3. 安装扩展包：

   扩展包默认为 .zip 格式，用户下载解压后，执行压缩包中的 install.ps1 或 install.bat 脚本，用户需要输入 ZCC Pro/Lite 的根目录的路径，脚本会自动将包含的库解压到 ZCC Pro/Lite 目录中。

提示

该脚本用于在 Linux/Darwin 环境执行，且使用 curl 进行网络请求，运行前请确认已安装 curl，运行时可以添加 --curl 参数以设置代理。如需在 Windows 上执行，推荐在 Git Bash 等可以运行 Unix 命令的环境中执行。

注意

当执行 zstudio.sh 出现 [ERROR] refresh_license(1): ... Please run this script with '-c' to clear the license history. 的错误提示时，请执行 zstudio.sh -c 或 zstudio --clear 以清除授权历史记录。