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.
Currently if the offline installer archives are used to install and update Simplicity Studio it is hard to tell when the archive files have been updated indicating that an update is available. Since the files tend to be very large (some are over 8 GB) it is inconvenient to download them just to check if they have been updated. So this article will list the latest version of Simplicity Studio and the various SDKs that have been released. The goal will be to update the article each time there is a new release, so that by following this article customers will be notified when Simplicity Studio and the various SDKs have been updated.
I also want to point out that the Simplicity Studio [Help] > [About] functionality has been enhanced to show a unified version number and the versions of the various components that comprise that version of Simplicity Studio. The information is presented in a matrix format that will show the component versions for the last 10 Simplicity Studio releases. The unified version number will make it easier to communicate the installed version of Simplicity Studio to Silicon Labs.
The current version of Simplicity Studio is 18.104.22.168. It was released on November 26th, 2019 and this is a portion of the [Help] > [About] information that also shows the Simplicity Studio Platform version (which was previously the easiest way to report the Simplicity Studio version):
On the About box there is also a "Toolchains and SDKs" tab that shows the versions of the installed toolchains and SDKs. This screenshot shows the information on the latest available SDKs as of November 26th, 2019:
I hope this information proves useful especially to customers using the offline archives files to install and update Simplicity Studio. This article should provide a temporary benefit until an update indication can be added to the offline installer page.