Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion .github/CONTRIBUTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@ If you haven't already done so, you'll need to create a (free) GitHub account at
and have Git tools available on your development system. You also need to add your email address to your account.

As a contributor, you'll want to be familiar with the Silicon Labs tooling:
- [Simplicity Studio](https://docs.silabs.com/simplicity-studio-5-users-guide/latest/ss-5-users-guide-overview/)
- [Simplicity Studio](https://docs.silabs.com/ssv6ug/latest/ssv6ug-overview/)
- [Platform](https://docs.silabs.com/gecko-platform/latest/platform-overview/)
- [Simplicity Commander](https://docs.silabs.com/simplicity-commander/latest/simplicity-commander-start/)

Expand Down
12 changes: 6 additions & 6 deletions sld213-bluetooth-getting-started-overview/index.md
Original file line number Diff line number Diff line change
@@ -1,13 +1,13 @@
# Getting Started with Silicon Labs Bluetooth LE Development

To get started with Bluetooth LE development, download the Simplicity Studio Development environment
as described in the [Simplicity Studio 5 User's Guide](https://docs.silabs.com/simplicity-studio-5-users-guide/latest/ss-5-users-guide-getting-started/). Simplicity Studio 5 includes everything needed for IoT product development with Silicon Labs devices including a resource and project launcher, software configuration tools, full IDE with GNU toolchain, and analysis tools.
as described in the [Simplicity Studio User's Guide](https://docs.silabs.com/ssv6ug/latest/ssv6ug-overview/). The latest version of Simplicity Studio includes everything needed for IoT product development with Silicon Labs devices including a resource and project launcher, software configuration tools, full IDE with GNU toolchain, and analysis tools.

Once you have downloaded Simplicity Studio, you will be prompted to install the Gecko SDK (GSDK), which contains the Bluetooth Software Development Kit (SDK). The GSDK combines Silicon Labs wireless SDKs and Gecko Platform into a single, integrated package. The Bluetooth SDK comes with a number of example application that you can then modify to create your own applications.
Once you download Simplicity Studio, you are prompted to install the Gecko SDK (GSDK), which contains the Bluetooth Software Development Kit (SDK). The GSDK combines Silicon Labs wireless SDKs and Gecko Platform into a single, integrated package. The Bluetooth SDK comes with a number of example application that you can then modify to create your own applications.

See [Prerequisites](#prerequisites) for additional details.

These pages focus on use and development in the Simplicity Studio 5 environment. Alternatively, Gecko SDK may be installed manually by downloading or cloning the latest from GitHub. See the [GitHub site](https://github.com/SiliconLabs/gecko_sdk) for more information.
These pages focus on use and development in the Simplicity Studio environment. Alternatively, Gecko SDK may be installed manually by downloading or cloning the latest from GitHub. See the [GitHub site](https://github.com/SiliconLabs/gecko_sdk) for more information.

Silicon Labs provides two different starter kits. The links below provide specific instructions for getting started with each kit.

Expand All @@ -24,7 +24,7 @@ Before beginning application development, you should have:

- Purchased an EFR32BG Wireless Starter Kit or BGM220 Explorer Kit.
- Created an account at Silicon Labs. You can register at [https://siliconlabs.force.com/apex/SL_CommunitiesSelfReg?form=short](https://siliconlabs.force.com/apex/SL_CommunitiesSelfReg?form=short).
- Downloaded Simplicity Studio 5 and the Silicon Labs Gecko SDK containing the Bluetooth SDK and become generally familiar with the SSv5 Launcher perspective. SSv5 installation and getting started instructions along with a set of detailed references can be found in the online *Simplicity Studio 5 User’s Guide*, available on [https://docs.silabs.com/](https://docs.silabs.com/) and through the SSv5 help menu.
- Downloaded the latest version of Simplicity Studio and the Silicon Labs Gecko SDK containing the Bluetooth SDK and become generally familiar with the Simplicity Studio Launcher perspective. Simplicity Studio installation and getting started instructions along with a set of detailed references can be found in the online *Simplicity Studio User’s Guide*, available on [https://docs.silabs.com/](https://docs.silabs.com/) and through the Simplicity Studio's help menu.
- Obtained a compatible compiler (See the Bluetooth SDK’s release notes for the compatible versions):

- Simplicity Studio comes with a free GCC C-compiler.
Expand All @@ -49,12 +49,12 @@ The Gecko Platform is a set of drivers and other lower layer features that inter

## Documentation

Hardware-specific documentation may be accessed through links on the part Overview tab in Simplicity Studio 5.
Hardware-specific documentation may be accessed through links on the part Overview tab in Simplicity Studio.

![Overview with hardware doc](resources/sld213-image3.png?darkModeUrl=resources/sld213-image3.png)

## Support

You can access the Silicon Labs support portal at [https://www.silabs.com/support](https://www.silabs.com/support) through Simplicity Studio 5’s Welcome view under Learn and Support. Use the support portal to contact Customer Support for any questions you might have during the development process.
You can access the Silicon Labs support portal at [https://www.silabs.com/support](https://www.silabs.com/support) through Simplicity Studio’s Welcome view under Learn and Support. Use the support portal to contact Customer Support for any questions you might have during the development process.

![Learn and Support tab](resources/sld213-image2.png?darkModeUrl=resources/sld213-image2.png)
10 changes: 5 additions & 5 deletions sld216-bluetooth-developing-debugging-overview/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,22 +4,22 @@ These pages provide details on developing and debugging Bluetooth LE application
includes:

- [**Silicon Labs Bluetooth C Application Developer's Guide for SDK v7.x and Higher**](/bluetooth/{build-docspace-version}/bluetooth-c-soc-dev-guide-sdk-v9x): Covers the Bluetooth stack v7.x architecture, application development flow, using the MCU core and peripherals, stack configuration options, and stack resource usage.
- [**GATT Configurator User's Guide**](/bluetooth/{build-docspace-version}/gatt-configurator-users-guide-ble-btmesh): Describes how to use the Simplicity Studio 5 GATT Configurator, an intuitive interface providing access to all the Profiles, Services, Characteristics, and Descriptors as defined in the Bluetooth specification.
- [**GATT Configurator User's Guide**](/bluetooth/{build-docspace-version}/gatt-configurator-users-guide-ble-btmesh): Describes how to use the Simplicity Studio GATT Configurator, an intuitive interface providing access to all the Profiles, Services, Characteristics, and Descriptors as defined in the Bluetooth specification.
- [**Blue Gecko Bluetooth Profile Toolkit Developer's Guide**](/bluetooth/{build-docspace-version}/bluetooth-profile-toolkit-developers-guide): Reviews using this XML-based mark-up language to describe the Bluetooth GATT database,configure access and security properties, and include the GATT database as part of the firmware.
- [**Using Network Analyzer with Bluetooth Low Energy and Mesh**](/bluetooth/{build-docspace-version}/network-analyzer-with-ble-btmesh): Describes using Simplicity Studio 5's Network Analyzer to debug Bluetooth Mesh and Low Energy applications. It can be read jointly with [**AN958: Debugging and Programming Interfaces for Customer Designs (PDF)**](https://www.silabs.com/documents/public/application-notes/an958-mcu-stk-wstk-guide.pdf) for more information on using Packet Trace Interface with custom hardware.
- [**Using Network Analyzer with Bluetooth Low Energy and Mesh**](/bluetooth/{build-docspace-version}/network-analyzer-with-ble-btmesh): Describes using Simplicity Studio's Network Analyzer to debug Bluetooth Mesh and Low Energy applications. It can be read jointly with [**AN958: Debugging and Programming Interfaces for Customer Designs (PDF)**](https://www.silabs.com/documents/public/application-notes/an958-mcu-stk-wstk-guide.pdf) for more information on using Packet Trace Interface with custom hardware.
- [**Transitioning from the v2.x to the v3.x Bluetooth SDK (PDF)**](https://www.silabs.com/documents/public/application-notes/an1255-transitioning-from-bluetooth-sdk-v2-to-v3.pdf): Provides information for those already developing with Bluetooth SDK version 2.x and who are interested in upgrading to the current version.

## Development Tools

**Simplicity Studio and the Simplicity IDE**: Simplicity Studio is the unified development environment for all Silicon Labs technologies, SoCs, and modules. It provides you with access to the target device-specific web and SDK resources, software and hardware configuration tools, and an integrated development environment (IDE) featuring industry-standard code editors, compilers, and debuggers. See the silabs.com [Simplicity Studio page](https://www.silabs.com/developers/simplicity-studio) to download the tools and for more information.

**Bluetooth GATT Configurator**: Bluetooth GATT Configurator, installed with Simplicity Studio, is a simple-to-use tool to help build a customized Bluetooth GATT database for Bluetooth projects. See the [Simplicity Studio User's Guide GATT Configurator section](https://docs.silabs.com/simplicity-studio-5-users-guide/latest/ss-5-users-guide-developing-with-project-configurator/bluetooth-gatt-configurator) of the Simplicity Studio 5 User's Guide for more information.
**Bluetooth GATT Configurator**: Bluetooth GATT Configurator, installed with Simplicity Studio, is a simple-to-use tool to help build a customized Bluetooth GATT database for Bluetooth projects. See the [Simplicity Studio User's Guide GATT Configurator section](https://docs.silabs.com/ssv6ug/latest/studio-bluetooth-gatt-configurator/) of the Simplicity Studio User's Guide for more information.

**Network Analyzer**: Simplicity Studio® 5 (SSv5)'s Network Analyzer enables debugging of complex wireless systems. This tool captures a trace of wireless network activity that can be examined in detail live or at a later time. See the [Simplicity Studio User's Guide Network Analyzer section](https://docs.silabs.com/simplicity-studio-5-users-guide/latest/ss-5-users-guide-tools-network-analyzer/) of the Simplicity Studio 5 User's Guide for more information.
**Network Analyzer**: Simplicity Studio®'s Network Analyzer enables debugging of complex wireless systems. This tool captures a trace of wireless network activity that can be examined in detail live or at a later time. See the [Simplicity Studio User's Guide Network Analyzer section](https://docs.silabs.com/network-analyzer/latest/network-analyzer-start/) of the Simplicity Studio 6 User's Guide for more information.

**Wireshark**: Wireshark is the recommended network protocol analyzer for the use with Wi-SUN networks. Download instructions are provided for [Windows/Mac users](https://www.wireshark.org/download.html) or [Linux users](https://www.wireshark.org/docs/wsug_html_chunked/ChBuildInstallUnixInstallBins.html). Simplicity Studio® 5 supports [live interaction](https://docs.silabs.com/simplicity-studio-5-users-guide/latest/ss-5-users-guide-testing-and-debugging/using-wireshark) between the application running on a Silicon Labs device and Wireshark.

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I do not see Wireshark details in SS6 User Guide. Can you provide the link from SS6 that should be updated here?

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I am not sure why this page mentions the tool for Wi-sun


**Energy Profiler**: Simplicity Studio® 5 (SSv5)'s Energy Profiler enables you to visualize the energy consumption of individual devices, multiple devices on one target system, or a network of interacting wireless devices to analyze and improve the power performance of these systems. Real-time information on current consumption is correlated with the program counter providing advanced energy software monitoring capabilities. It also provides a basic level of integration with the Network Analyzer network analysis tool. See the [Simplicity Studio User's Guide Energy Profiler section](https://docs.silabs.com/simplicity-studio-5-users-guide/latest/ss-5-users-guide-tools-energy-profiler/) of the Simplicity Studio 5 User's Guide for more information.
**Energy Profiler**: The latest version of Simplicity Studio®'s Energy Profiler enables you to visualize the energy consumption of individual devices, multiple devices on one target system, or a network of interacting wireless devices to analyze and improve the power performance of these systems. Real-time information on current consumption is correlated with the program counter providing advanced energy software monitoring capabilities. It also provides a basic level of integration with the Network Analyzer network analysis tool. See the [Simplicity Studio User's Guide Energy Profiler section](https://docs.silabs.com/energy-profiler/latest/energy-profiler-start/) of the Simplicity Studio 6 User's Guide for more information.

**Simplicity Commander**: Simplicity Commander is a single, all-purpose tool to be used in a production environment. It is invoked using a simple Command Line Interface (CLI) that is also scriptable. Simplicity Commander enables customers to complete essential tasks such as configuring and building applications and bootloaders and flashing images to their devices. Simplicity Commander is available through Simplicity Studio or can be downloaded through [system-specific installers](https://www.silabs.com/developers/mcu-programming-options#programming). The [**Simplicity Commander User's Guide**](https://docs.silabs.com/simplicity-commander/latest/simplicity-commander-start/) provides more information.

Expand Down
2 changes: 1 addition & 1 deletion sld222-bluetooth-bootloading-overview/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,4 +8,4 @@ Labs Gecko Bootloader.
- [**Silicon Labs Gecko Bootloader User's Guide for GSDK 4.0 and Higher (series 1 and 2 devices)**](/bluetooth/{build-docspace-version}/bootloader-user-guide-gsdk-4): Describes the high-level implementation of the Silicon Labs Gecko Bootloader for EFR32 SoCs and NCPs, and provides information on how to get started using the Gecko Bootloader with Silicon Labs wireless protocol stacks in GSDK 4.0 and higher.
- [**Using the Gecko Bootloader with Silicon Labs Bluetooth Applications**](/bluetooth/{build-docspace-version}/using-gecko-bootloader-with-bluetooth-apps): Includes detailed information on using the Gecko Bootloader with Silicon Labs Bluetooth applications. It supplements the general Gecko Bootloader implementation information provided in the Gecko Bootloader User's Guide.
- [**Series 2 and Series 3 Secure Boot with RTSL**](/bluetooth/{build-docspace-version}/series2-secure-boot-with-rtsl): Describes the design of Secure Boot with RTSL (Root of Trust and Secure Loader) on Series 2 and Series 3 devices. It also provides examples of how to implement the Secure Boot process.
- [**Transitioning to the Updated Gecko Bootloader in GSDK 4.0 and Higher**](/bluetooth/{build-docspace-version}/bootloader-transitioning-guide-gsdk-v40-and-higher): Gecko Bootloader v2.x, introduced in GSDK 4.0, contains a number of changes compared to Gecko Bootloader v1.x. This document describes the differences between the versions, including how to configure the new Gecko Bootloader in Simplicity Studio 5.
- [**Transitioning to the Updated Gecko Bootloader in GSDK 4.0 and Higher**](/bluetooth/{build-docspace-version}/bootloader-transitioning-guide-gsdk-v40-and-higher): Gecko Bootloader v2.x, introduced in GSDK 4.0, contains a number of changes compared to Gecko Bootloader v1.x. This document describes the differences between the versions, including how to configure the new Gecko Bootloader in Simplicity Studio.
Original file line number Diff line number Diff line change
Expand Up @@ -19,7 +19,7 @@ Although some devices are shipped with preprogrammed bootloaders, it is always r

2. Flash your Bluetooth application (.s37 or .hex or .bin) to the device.

3. Create a new Gecko Bootloader project, e.g., Bluetooth in-place OTA DFU Bootloader or BGAPI UART DFU Bootloader. You can find these example projects after selecting your device under the Example Projects & Demos tab of the Launcher view of Simplicity Studio 5.
3. Create a new Gecko Bootloader project, e.g., Bluetooth in-place OTA DFU Bootloader or BGAPI UART DFU Bootloader. You can find these example projects after selecting your device under the Example Projects & Demos tab of the Launcher view of Simplicity Studio.

4. Generate and build it.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@ For tutorial purposes, the `Bluetooth - SoC Empty` SDK example application will
### Requirements

- Wireless Starter Kit and Bluetooth-capable radio board
- Simplicity Studio 5
- Latest version of Simplicity Studio
- Android or iOS mobile device

## First Steps
Expand Down
2 changes: 1 addition & 1 deletion sld276-bluetooth-stack-overview/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -167,7 +167,7 @@ Bluetooth applications usually need a GATT database. The structure of the GATT d

**The Bluetooth Profile Toolkit GATT Builder**: The Bluetooth Profile Toolkit is a simple XML-based API and description language used to describe (static) GATT-based services and characteristics easily without the need to write them in code. The XML files can be easily written by hand based on the information contained in [Blue Gecko Bluetooth Profile Toolkit Developer Guide](/bluetooth/{build-docspace-version}/bluetooth-profile-toolkit-developers-guide). Use the Profile Toolkit GATT Builder if you are developing outside of Simplicity Studio, and follow the instructions in *Blue Gecko Bluetooth Profile Toolkit Developer Guide* to convert your GATT database into C code.

**The GATT Configurator**: Simplicity Studio includes the GATT Configurator, a tool that allows building the (static) GATT database in a visual way, without hand editing the XML file. It also automatically converts the database structure into C code upon saving. See the Simplicity Studio User's Guide section on the [GATT Configurator](https://docs.silabs.com/simplicity-studio-5-users-guide/latest/ss-5-users-guide-developing-with-project-configurator/bluetooth-gatt-configurator) for summary information, and [GATT Configurator User’s Guide for Bluetooth SDK v3.x](/bluetooth/{build-docspace-version}/gatt-configurator-users-guide-ble-btmesh) for details. Open the GATT Configurator in Simplicity Studio through the Project Configurator, Configuration Tools tab. Click **Open** and the GATT Configurator tool opens the file *gatt\_configuration.btconf* in a new tab.
**The GATT Configurator**: Simplicity Studio includes the GATT Configurator, a tool that allows building the (static) GATT database in a visual way, without hand editing the XML file. It also automatically converts the database structure into C code upon saving. See the Simplicity Studio User's Guide section on the [GATT Configurator](https://docs.silabs.com/ssv6ug/latest/studio-bluetooth-gatt-configurator/) for summary information, and [GATT Configurator User’s Guide for Bluetooth SDK v3.x](/bluetooth/{build-docspace-version}/gatt-configurator-users-guide-ble-btmesh) for details. Open the GATT Configurator in Simplicity Studio through the Project Configurator, Configuration Tools tab. Click **Open** and the GATT Configurator tool opens the file *gatt\_configuration.btconf* in a new tab.

![Opening the Bluetooth GATT Configurator](resources/sld276-image12.png)

Expand Down
Loading
Loading