This Knowledge Base Article (KBA) will detail the steps necessary to port each of the 5 Z-Wave software example projects from Simplicity Studio 4 and Gecko SDK Suite 2.7.6 to Simplicity Studio 5 and Gecko SDK Suite 3.0.0. If the project being migrated is based on one of the software examples then the steps should be very similar. If possible it is always easiest to create a new software example project using the new GSDK.
1. First Migrate the project from the Simplicity Studio 4 workspace to Simplicity Studio 5 using the [Migrate Project] tool which can be found by clicking the [Tools] icon from any perspective (in Simplicity Studio 5) and then browsing to the correct workspace. Select all projects to be migrated and continue through the dialog boxes. After the projects are migrated a success screen should be displayed that says additional change to the project might be needed and directing you to this Knowledge Base Article (KBA).
2. For All projects:
It is recommended to copy the v5 version of those files into the projects to replace them. The files can just be copied from the v5 project replacing the v4 copies (select the file and use CTRL (or CMD) C and then CTRL (or CMD) V to paste into the migrated project). Confirm that you want to overwrite the files.
3. Projects DoorLockKeyPad, SensorPIR, SwitchOnOff
These projects have changes in the base project file (DoorLockKeyPad.c, SensorPIR.c and SwitchOnOff.c) that need to be merged from a Simplicity Studio 5 version of the project to the migrated project. Select the above mentioned .c file in the project created from Gecko SDK Suite 3.0 and use CTRL-C or right click and select copy. Then click the [src] folder in the migrated version of the project and select CTRL-V or right click the folder and select [Paste] and select [Yes] when prompted to overwrite the file. If user changes have been made to the project or the file has been renamed, then the changes should be merged instead of overwriting the file. Select the .c file in the Simplicity Studio 5 generated copy of the project and ctrl click the equivalent file in the migrated project and then right click the file and select [Compare With] > [Each Other] and then merge the changes into the file.
Verify the project builds correctly after merging the files.
4. Project PowerStrip
1. Copy new folders 'driver' and 'ZAF_ApplicationUtilities_Actuator' from the Simplicity Studio 5 created project into the migrated project using one of the copy methods previously described.
2. The 'ZAF_CommandClasses_MultilevelSwitch' folder has different files in it for Simplicity Studio 5. Delete the folder from the migrated project and then copy the folder from the Simplicity Studio 5 created project into the migrated project.
3. To get the changes to PowerStrip.c copy or merge the Simplicity Studio 5 created file into the migrated project.
4. There are also changes to the Symbols and Includes in the Simplicity Studio 5 created project. To easily port this to the migrated project open project properties <C/C++ General> → <Paths and Symbols> → <Export Settings...> and select a filename to store the Symbols and Includes from the v5 created project and then use <Import Settings...> in the migrated project to add them to the project.
Verify the project builds correctly.
5. Project WallController
1. The 'ZAF_CommandClasses_MultilevelSwitch' folder has different files in it for Simplicity Studio 5. Delete the folder from the migrated project and then copy the folder from the Simplicity Studio 5 created project into the migrated project.
2. To get the changes to WallController.c copy or merge the Simplicity Studio 5 created file into the migrated project.
Verify the project builds correctly.
Hopefully the above instructions help to quickly migrate the project to GSDK 3.0.0.