安装使用
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 版本
- Windows 版本
ZStudio 默认包含基础扩展的 libzcc,如需额外的 libzcc、 libdsp 或 libnn 的软件库,可以在 ZStudio 中使用软件包管理下载安装。对于用户指定的 Arch,如果 ZStudio 没有在工具链中检测到可用的库,将会提醒用户在包管理器中下载。
- 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 时,成功登录即将账号与当前设备进行绑定;注销登录即自动将账号与当前设备解绑。
-
点击左下角 "用户" > "登录"跳转到默认浏览器中打开兆松云。
-
用户需要输入已注册账号的用户名邮箱和密码进行登录。
-
点击弹出提示框中的"打开 ZStudio",回跳到桌面软件,右下角将会弹出"登陆成功"提示信息。
-
用户在未解绑上次登录设备的情况下直接登录当前的设备,ZStudio 将在右下角弹出错误提示信息,用户可以通过"解除绑定并重新请求 License"按钮进行解绑并重新绑定当前设备。
-
解绑完成后右下角会弹出"成功解除 license 与设备的绑定"提示信息。
-
重新绑定当前设备成功后右下角将弹出"请求授权信息成功"提示信息,即用户可以开始在当前设备使用 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) |
软件包 | 功能 |
---|---|
Nuclei | 包含支持芯来科技 SDK 所需的库 |
HPMicro | 包含支持先楫半导体 SDK 所需的库 |
- Linux 版本
- Windows 版本
-
ZCC Pro 授权(lite版本可以直接使用):
解压后的
bin
目录下提供了zstudio.sh
脚本。用户需要手动将脚本中的USERNAME
和PASSWORD
修改为兆松云的用户名邮箱和密码。License 有效期为一个小时,为了实现 License 的持续更新,建议使用zstudio.sh -d
或zstudio.sh --daemon
命令设置定时任务刷新 License。如需取消定时任务,使用zstudio.sh -U
或zstudio.sh -unset-daemon
命令。 -
添加环境变量
通过运行
export PATH=$PATH:<zcc_install_path>
指定 zcc 可执行文件的路径将 ZCC 添加进环境变量,或者直接修改脚本中 PATH_ZCC 变量的值(同时注释掉该变量下方对 PATH_ZCC 进行检测的 which 代码块)。 -
安装扩展包:
扩展包默认为
.zip
格式,用户下载解压后,执行压缩包中的install.sh
执行脚本会要求用户输入 ZCC Pro/Lite 的根目录的路径,脚本会自动将包含的库解压到 ZCC Pro/Lite 目录中。
-
ZCC Pro 授权(lite版本可以直接使用):
解压后的
bin
目录下提供了zstudio.sh
脚本。用户需要手动将脚本中的USERNAME
和PASSWORD
修改为兆松云的用户名邮箱和密码。 -
添加环境变量
通过运行
export PATH=$PATH:<zcc_install_path>
指定 zcc 可执行文件的路径将 ZCC 添加进环境变量,或者直接修改脚本中 PATH_ZCC 变量的值(同时注释掉该变量下方对 PATH_ZCC 进行检测的 which 代码块)。 -
安装扩展包:
扩展包默认为
.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
以清除授权历史记录。