Manuals+

AN1255: Transitioning from Bluetooth SDK v2.x to v3.x

A guide to migrating your Bluetooth projects to the latest SDK version.

Introduction to the Migration

This document outlines the key changes and steps required to transition projects from Silicon Labs' Bluetooth SDK v2.x to the newer v3.x version. The update involves significant enhancements in Simplicity Studio and the underlying Gecko Platform architecture, introducing a component-based approach for improved developer experience.

Key Changes and Features

Discover the core differences and new features, including:

Migration Process Overview

The migration process involves several key stages:

  1. Creating a new SoC-Empty project in the latest Simplicity Studio.
  2. Familiarizing with the Component Library for installing necessary components.
  3. Integrating RTOS components if applicable.
  4. Updating initialization code and configuration parameters.
  5. Reviewing and adapting to Bluetooth API changes.
  6. Rebuilding bootloaders and importing GATT databases as needed.

For detailed instructions and examples, refer to the full documentation.

PDF preview unavailable. Download the PDF instead.

an1255-transitioning-from-bluetooth-sdk-v2-to-v3 Silicon Labs Adobe PDF Library 20.13.106

Related Documents

Preview Silicon Labs Gecko Platform Release Notes - Version 5.1.3
Release notes for Silicon Labs Gecko Platform, detailing updates, improvements, and fixes for SDK version 5.1.3 and earlier versions. Covers modules like CMSIS Device, Peripherals, Drivers, Services, CPC, Common, Middleware, Security, Operating System, Gecko Bootloader, MVP Math Library, Examples, Boards and External Devices, Other Gecko Platform Components, and RAIL Library.
Preview Simplicity Studio 5 User's Guide - Silicon Labs
Comprehensive guide to Simplicity Studio 5, Silicon Labs' integrated development environment for IoT SoCs and modules. Learn about features, development workflows, and tools for 32-bit and 8-bit devices.
Preview Silicon Labs Bluetooth Mesh SDK v2.x Quick-Start Guide
A guide to getting started with Bluetooth mesh development using Silicon Labs' Bluetooth Mesh SDK v2.x and Simplicity Studio 5. It provides step-by-step instructions for demonstrating a basic Bluetooth mesh network with WSTK devices, controlling lights, and understanding the SDK's features and limitations.
Preview Gecko Platform Release Notes v4.2.3.0
Comprehensive release notes for Silicon Labs Gecko Platform version 4.2.3.0 (SDK Suite 4.2), detailing new features, improvements, and bug fixes across all core components. Covers CMSIS Device, Peripherals, Drivers, Services, CPC, Common, Middleware, Security, Operating System, Gecko Bootloader, Machine Learning, Examples, Boards and External Devices, and the RAIL Library.
Preview Simplicity SDK Release Notes Version 2025.6.1
Release notes for Simplicity SDK Version 2025.6.1, detailing updates, new features, bug fixes, and API changes for the Silicon Labs IoT software development ecosystem.
Preview Silicon Labs RAIL API Reference Guide
Comprehensive guide to the Silicon Labs Radio Abstraction Interface Layer (RAIL) API, covering development, configuration, and features for embedded wireless applications.
Preview Silicon Labs Connect Stack: A Comprehensive Guide to Wireless Networking
Explore the Silicon Labs Connect stack, an IEEE 802.15.4 MAC-based wireless networking solution optimized for low-power devices. This guide covers development, fundamentals, bootloading, security, and more for proprietary wireless applications.
Preview BGAPI and BGLIB SPP Server Example for BT121 and DKBT
This application note details the BGAPI serial protocol and BGLib library usage, walking through a sample implementation for the BT121 and DKBT. It covers project setup, firmware compilation, host application development, and client connectivity testing with an Android smartphone.