Project Migration#

Moving to the Component-Based Architecture#

In SSv5 version 5.3, the Gecko Bootloader, Zigbee, and Z-Wave changed to the Silicon Labs Configurator component-based architecture. For more information on transitioning these projects from earlier versions of SSv5 see:

If you are migrating one of these project types from Simplicity Studio 4 (SSv4), first follow the instructions below.

Migrate from Simplicity Studio 4 to Simplicity Studio 5#

The process to migrate a project from Simplicity Studio® 4 (SSv4) to SSv5 depends on the type of project.

If you are migrating a Bootloader, EFM32, or EFM8 project, use the Migrate Project tool. If you are migrating a Z-Wave, Bluetooth/Bluetooth Mesh, Proprietary Flex, or Zigbee project, follow the instructions in the specified documents.

Bootloader, EFM32, and EFM8 Projects#

Bootloader note: Use this procedure as a first step in migration.

Click the Tools toolbar button to open the Tools dialog. Select Migrate Projects and click OK. Select the project to be migrated and click Next.

migrate startmigrate start

Verify the information displayed and click Next.

migrate verifymigrate verify

Decide if you want to copy the project (recommended) and click Finish.

migrate copymigrate copy

The project is migrated from SSv4 to SSv5.

migrate successmigrate success

Z-Wave Projects#

(Through Simplicity Studio 5.2) Follow the instructions in the knowledge base article Migrating a Z-Wave project from GSDK 2.7.6 to GSDK 3.0.0.

Zigbee, Flex, and Bluetooth/Bluetooth Mesh Projects#

These projects cannot be migrated using the tool. Instead, refer to the following documents:

If you try using the tool, in most cases the tool will point you to the documentation for the migration process.

migrate incompatiblemigrate incompatible