Documentation Index
Fetch the complete documentation index at: https://mintlify.com/dsyx/docs.silabs.com_zh/llms.txt
Use this file to discover all available pages before exploring further.
Simplicity Studio® 5（SSv5）支持在 Windows、macOS 和 Linux（Ubuntu LTS）三个平台上安装。本页分别介绍各平台的安装步骤，以及安装完 SSv5 本体后如何安装 Gecko SDK（GSDK）等开发软件包。安装过程需要互联网连接以下载软件包。
根据您的公司网络环境，可能会遇到连接更新服务器失败或无法登录的问题。如果您确认用户名和密码正确却仍无法登录，或收到更新服务器连接错误，请参阅官方文档 SDK 安装或更新不起作用 排查原因。 安装 SSv5
Windows 和 macOS
Linux（Ubuntu LTS）
下载安装包
从 Silicon Labs 官网下载 SSv5 安装包。Windows 软件包为 .iso 磁盘映像。下载完成后，双击 .iso 文件将其挂载为驱动器，然后双击驱动器内的 setup.exe 启动安装程序。 接受许可协议
安装程序首次启动时会显示 Simplicity Studio License Agreement 对话框。接受协议条款并点击 Next >。
选择安装目录
选择目标安装位置，点击 Next >，然后点击 Install 开始安装。
接受附加许可协议
SSv5 启动时会显示一个或多个附加许可协议（如 Eclipse Foundation Software User Agreement）。可以逐个或一次性全部接受，完成后点击 DONE。
登录 Silicon Labs 帐户
系统会邀请您登录。使用您的 Silicon Labs 帐户用户名和密码登录。虽然可以跳过此步骤，但必须登录才能访问某些受限软件包。建议在此处完成登录。
同意 Experience Tracking
完成登录前需同意 Experience Tracking。您可以在 SSv5 Preferences > Simplicity Studio > User Experience 中随时更改此设置。
安装 Device Inspector（如有硬件）
如果已连接硬件设备，根据操作系统和安全设置，SSv5 可能会提示您允许其对系统进行更改并安装 Device Inspector。点击 Yes 继续。
Simplicity Studio for Linux 仅在 Ubuntu® LTS 发行版上得到官方支持。可能可以在其他发行版上运行，但仅在 Ubuntu® LTS 上进行了测试和验证。SSv5 的 Linux 版本以 tar 文件形式提供（非安装程序），应将其展开到所需的安装目录中。推荐安装目录为用户根目录：/home/USERNAME/SimplicityStudio_v5。该目录必须可在不使用 root 权限的情况下更新。
解压安装包
将下载的 tar 文件展开到目标安装目录：tar -xf SimplicityStudio_v5.tar.gz -C ~/
更新系统并运行 setup.sh
在首次启动 Simplicity Studio 之前，执行以下命令：sudo apt-get update
sudo apt-get upgrade
cd SimplicityStudio_v5
sudo ./setup.sh
setup.sh 脚本会执行以下操作：
- 尝试为 USB 设备连接安装 dev 规则
- 通过系统包管理器安装缺失的依赖库
setup.sh 仅在 Ubuntu® 发行版上自动安装所需的外部软件包。对于其他 Linux 发行版，请检查脚本内容以确定需要手动安装哪些依赖。
启动 Simplicity Studio
执行 studio 可执行文件启动 SSv5。如果使用的是 Wayland 显示协议，请改用： Linux 注意事项
Simplicity Studio 使用第三方产品 JxBrowser 渲染部分窗口（包括安装窗口、Launcher 透视图和 Project Configurator）。默认情况下，JxBrowser 将 Chromium 浏览器展开到 /tmp 目录。如果 /tmp 目录访问权限不足，可在 studio.ini 文件中添加以下行来指定自定义路径：-Djxbrowser.chromium.dir=/home/USERNAME/.jxbrowser
安装软件
SSv5 安装完成并启动后，会提示安装 Gecko SDK（GSDK）等软件包。提供两种安装方式：
此方式适合已有 Silicon Labs 硬件套件的开发者。SSv5 会检测已连接的设备并自动推荐兼容软件。连接设备并选择安装方式
确保设备已通过 USB 连接，然后在安装方式对话框中点击 Install by Connecting Devices。SSv5 将显示已检测到的设备列表。如果未看到已连接设备，或在此对话框打开后才插入了设备，请点击 Refresh。若没有连接的设备，则无法使用此方式继续。
选择目标设备
勾选要使用的设备。如果选择了多个具有不同软件兼容性的设备，SSv5 将下载与任意所选设备兼容的所有软件包。点击 NEXT。
选择安装选项
在 Auto 和 Advanced 两个安装选项中选择：
- Auto：SSv5 自动下载与连接硬件兼容且您的帐户有权访问的所有包，推荐大多数用户使用。
- Advanced：手动选择要安装的软件包，或指定 GSDK 的安装位置。
使用 Advanced 模式时，所有标记为 “Required” 的包必须安装。除非您完全了解排除某个包的影响，否则不要移除它们。
接受软件许可协议
在安装开始前，接受一份或多份软件许可协议。
等待安装完成
点击 NEXT 后，安装开始。进度条可能会在下载大文件时暂停，完成后自动恢复。如果安装过程中出现错误，必须重启 SSv5 后才能恢复安装。安装完成后点击 CLOSE。
重启 SSv5
点击 RESTART 使安装的软件包生效，之后即可开始项目开发。
此方式不需要连接设备，适合希望先配置好开发环境再购买/连接硬件的开发者。选择安装方式
在安装方式对话框中点击 Install by Technology Type。
选择技术类型
选择要安装的技术类型并点击 NEXT。要安装完整的 Gecko SDK Suite，请选择 32-Bit and Wireless MCUs。
选择安装选项
与按设备安装相同，可选择 Auto（推荐）或 Advanced 模式。
- Auto：自动下载您帐户有权访问的所有推荐包。
- Advanced：手动选择软件包并可指定 GSDK 安装位置。
接受软件许可协议
在安装开始前接受相应的软件许可协议。
等待安装完成
点击 NEXT 开始安装，等待进度条完成。安装完成后点击 CLOSE。
重启 SSv5
点击 RESTART 完成环境配置，开始项目开发。