Skip to main content

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）支持多种项目类型，可通过 File > New 创建。最常用的是基于 Project Configurator（.slcp 文件）的项目，适用于 Gecko SDK 4.0 起所有主流协议和工具，包括 Bluetooth、Zigbee、Thread、RAIL、Wi-SUN 等。本页重点介绍 Project Configurator 项目的创建流程与常用配置工具。

​
支持的项目类型

通过 File > New > Project 打开 New Project Wizards 对话框，可以看到以下主要向导：
项目向导用途
Silicon Labs Project Wizard创建 Project Configurator（.slcp）项目，适用于 GSDK 4.0+ 的所有协议
Silicon Labs MCU Project Wizard创建 Project Configurator MCU 项目
Direction Finding Project Wizard创建 Bluetooth 多定位器方向查找项目
AppBuilder Project Wizard创建 AppBuilder 项目（适用于 GSDK 3.2 及更低版本的 Zigbee/Bootloader）

​
项目创建

新建 Project Configurator 项目通过三个连续对话框完成，对话框顶部的指示器显示当前所处的步骤。 您可以从 Launcher 透视图的三个不同入口开始创建项目，起始位置决定了您进入哪个对话框：
  • 从 OVERVIEW 选项卡：点击 Create New Project → 从 Examples 对话框开始
  • 从 EXAMPLE PROJECTS 选项卡：筛选并选择项目，点击 CREATE → 从 Configuration 对话框开始
  • 从文件菜单：File > New > Silicon Labs Project Wizard → 从 Target, SDK, and Toolchain Selection 对话框开始
1

Target, SDK, and Toolchain Selection

如果已连接或选择了目标设备，所有信息会自动预填充。否则，在此处手动选择目标芯片或套件，并选择 SDK 版本和工具链。
如果您计划在 SSv5 中使用 IAR 编译器，请在此步骤选择。在 Project Configurator 环境中，一旦项目创建完成后很难再更改编译器。默认工具链为 GNU ARM。
确认选择后点击 NEXT。
2

Examples（示例选择）

使用复选框过滤器或关键字搜索找到感兴趣的示例项目，选择后点击 NEXT。可用的过滤维度包括技术类型（如 Proprietary Flex、Bluetooth、Zigbee 等）、关键字、以及已安装的 SDK。
3

Configuration（项目配置）

如有需要，修改项目名称。With project files 下的三个选项控制源文件的复制/链接策略：
选项说明
Link to sources项目链接到 SDK 文件和项目文件（如 app.c），修改会影响共享该文件的所有项目
Link SDK and copy project sources（默认）项目源文件被复制到工作区，SDK 文件夹结构存在但内容为空
Copy contents项目文件和 SDK 文件全部复制到工作区
点击 FINISH 完成项目创建。
项目创建完成后，Simplicity IDE 透视图将自动打开。首次配置可能有短暂延迟。该透视图包含以下主要区域：
  1. 编辑器区域（Editor area） — 取决于项目类型（Project Configurator、AppBuilder 或 8-bit Hardware Configurator）
  2. 项目资源管理器视图（Project Explorer view） — 列出工作区中可用的项目和解决方案
  3. 调试适配器视图（Debug Adapters view） — 显示通过 USB 连接的套件或网络上检测到的 J-Link
  4. 开发者视图（Developer views） — 开发过程中使用的一组辅助视图

​
Project Configurator 项目

Project Configurator 项目在 .slcp（Silicon Labs Configurator project）文件中定义，通过在 SOFTWARE COMPONENTS 选项卡上添加、删除和配置组件来修改项目功能。 项目通常在 README 选项卡或 OVERVIEW 选项卡上打开。

​
OVERVIEW 选项卡

OVERVIEW 选项卡包含三个信息卡片：

Target and Tool Settings

显示开发目标、SDK 和项目生成器配置。向下滚动并点击 Change Target/SDK/Generators 可修改这些设置。项目生成器决定了 SSv5 生成的 IDE 或构建系统项目文件类型。

Project Details

可重命名项目、更改源文件导入模式，以及在必要时通过 Force Generation 强制重新生成项目文件（通常用于在 SSv5 外部编辑了 .slcp 文件后）。

Quick Links

指向常用配置工具的快捷链接，例如 Pin Tool、GATT Configurator 等。可用链接因 SDK 和目标设备而异。

​
SOFTWARE COMPONENTS 选项卡

点击 SOFTWARE COMPONENTS 选项卡可通过组件库配置项目。多种过滤器和关键字搜索帮助您浏览各类组件。
  • 项目中已安装的组件会被选中（复选框状态），可以被卸载
  • 可配置组件由齿轮符号（⚙）表示
点击组件名称旁的齿轮符号或可配置组件描述中的 Configure 可打开 Component Editor，在其中修改参数或直接编辑组件源文件。Component Editor 中的变更会自动保存。
在 Project Configurator 中安装或卸载组件时，项目输出文件会自动生成。生成进度显示在透视图右下角。请确保生成完成后再进行构建，以避免编译不一致。

​
CONFIGURATION TOOLS 选项卡

提供与项目类型相关的所有配置工具入口。点击工具卡上的 Open 可在单独选项卡中打开对应工具。

​
配置工具参考

Pin Tool 允许修改目标设备的引脚使用和参数。除通过 CONFIGURATION TOOLS 选项卡打开外，也可在 Project Explorer 视图中双击 <project>.pintool 文件打开。双击 Software Component 可打开 Component Editor 配置相应功能。
Pin Tool 不会自动保存，使用完毕后请手动保存更改。
Bluetooth 和 Bluetooth Mesh 项目均使用 Bluetooth GATT Configurator 进行 GATT 数据库配置。菜单控件说明：
  1. 添加一个项
  2. 复制所选项
  3. 向上移动所选项
  4. 向下移动所选项
  5. 导入 Bluetooth GATT 数据库
  6. 添加预定义服务/特征
  7. 删除所选项
  • 添加自定义服务：点击 Profile (Custom BLE GATT)，然后点击 Add（1）
  • 添加自定义特征：选中一个服务，然后点击 Add（1）
  • 添加预定义服务/特征：点击 Add Predefined（6）
Bluetooth Mesh Configurator 用于配置 Mesh 设备的 Device Composition Data，包含三个方面：设备信息、元素（Element）和模型（Model）。
  • 设备信息由在第一个字段中选择的公司确定
  • 每个节点至少有一个主要元素，点击右下角绿色 + 符号可添加更多元素
  • 支持 SIG-adopted 模型（可从左侧模型池拖入）和 vendor 模型（可自定义规范，包括状态、消息和行为）
Radio Configurator 作为 Proprietary SDK 的一部分提供，用于为 RAIL-based 无线电应用创建标准或自定义的无线电配置。参数以卡片形式排列，核心操作：
  1. 在 General Settings 卡片的 Select radio profile 下拉菜单中选择无线电配置文件（支持 Sigfox、WMBus 等标准协议，或完全自定义的 Base Profile）
  2. 在 Select a radio PHY 下拉列表中选择无线电 PHY 配置
  3. 默认配置不允许修改（字段显示为灰色）；启用 General Settings 卡片上的 Customized 开关后，可访问配置文件定义的所有参数
Wi-SUN Configurator 作为 Wi-SUN SDK 的一部分提供，通过三个面板配置 Wi-SUN 应用的主要设置：Application、Security 和 Radio。对于某些项目，仅 Radio 面板可用。Wi-SUN Configurator 可在创建项目时打开，或通过打开项目文件 /config/wisun/wisun_settings.wisunconf 显示。
Zigbee Cluster Configurator 作为 Zigbee EmberZNet SDK 的一部分提供，用于管理 Zigbee 端点（Endpoint）、簇（Cluster）和命令（Command）。簇配置界面由三个选项卡组成：
  • Attributes — 属性配置
  • Attribute Reporting — 属性上报配置
  • Commands — 命令配置
通过 Zigbee Cluster Configurator 所做的更改保存到 zcl_config.zap 文件中。保存时，工具会自动生成 Zigbee 应用所需的所有 .c 和 .h 文件。
Memory Editor 是图形化内存布局编辑工具的 Beta 版实现，主要与 Solutions 配合使用，也可用于单个项目。大多数项目当前没有包含默认设置，工具会显示警告。建议将工具计算的默认值保存下来作为起点。

Build docs developers (and LLMs) love

Get started for freeTalk to us