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:

• Zigbee AN1301: Transitioning from Zigbee EmberZNet SDK 6.x to SDK 7.x

• Gecko Bootloader AN1326: Transitioning to the Updated Gecko Bootloader in GSDK 4.0 and Higher

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.

Verify the information displayed and click Next.

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

The project is migrated from SSv4 to SSv5.

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:

• Zigbee (Through Simplicity Studio 5.2): QSG106: Getting Started with EmberZNet PRO

• Flex: AN1254: Transitioning from the v2.x to the v3.x Proprietary Flex SDK

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

• Bluetooth Mesh: AN1298: Transitioning from the v1.x to the v2.x Bluetooth Mesh SDK

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