Add WiSeConnect™ SDK v3.x to Your Application#

Prerequisites#

Your host application must contain the CMSIS-RTOS2 API and an RTOS library.

As an example, for STM32F411RE™ (hereafter referred to as STM32), let us consider a sample Keil µVision project host application project (Sample_STM32_project) created using STM32CubeMX tool. By default, the STM32CubeMX provides the CMSIS-RTOS2 API ported onto FreeRTOS library. This implementation is present at path: <STM32 project>\Middlewares\Third_Party\FreeRTOS\Source

Follow the below sequence of steps to port WiSeConnect™ SDK v3.x (hereafter referred to as SDK v3.x) to your host MCU application.

Prepare Project for Porting#

1. The initial step in porting is to integrate the SDK v3.x into your host application. The SDK v3.x depends on few header and c source files present in the Silicon Labs Simplicity SDK (formerly Gecko SDK) (hereafter referred to as SiSDK (formerly GSDK)). Therefore, it is necessary to integrate the required files from SiSDK (formerly GSDK) as well as SDK v3.x for developing an SiWx917 application using a host platform.

2. Create a new folder or a directory in the host platform project’s root directory or any convenient location in the project.

   For example, let us consider a sample STM32 Keil µVision project (Sample_STM32_project) created using the STM32CubeMX tool. In this case, create a directory, say SiliconLabs_SDK in the sample project’s root directory.

   

3. Within SiliconLabs_SDK, create two sub-directories for SiSDK (formerly GSDK) and SDK v3.x.

   For STM32 project, two sub-directories with names SiSDK (formerly GSDK) and WSDK are created.

   

Add Code from Simplicity SDK (formerly Gecko SDK) (SiSDK (formerly GSDK))#

The required c source files sl_string.c and sli_cmsis_os2_ext_task_register.c from SiSDK (formerly GSDK) are present at path: <gecko_sdk>/platform/common/src. The required header files from SiSDK (formerly GSDK) are present at path: <gecko_sdk>/platform/common/inc. Add these c source files and header files from the SiSDK (formerly GSDK) to the newly created directory.

In case of STM32F411RE, the required c source files are added at SiSDK (formerly GSDK)/src folder and header files are added at SiSDK (formerly GSDK)/inc as shown below.

Add Code from WiSeConnect SDK v3.x#

It is not required to add all the files and folders present in the SDK v3.x to your project. The SDK v3.x contains the SiWx917 features such as Wi-Fi, BLE, application layer protocols etc., and their implementations organized into components. This benefits the user to add only the required files and folders associated with the respective feature from the components folder to their host MCU application project.

The following figure shows the hierarchy of files and folders present in the components and resources folders of SDK v3.x.

• The entities (component/c source file/header file/folder) that are marked Mandatory must be added to your application project.

• The entities that are marked Optional can be added based on the features your application requires. For example, if your application requires HTTP Client functionality, add the http_client folder from /components/service to your application project.

• The entities that are marked Options imply that any of the available options (marked in red) can be chosen while adding Mandatory or Optional entities. For example, the memory configuration used by SDK v3.x can be static, malloc (dynamic memory allocation), lwip buffers, memory pool buffers, and memory pool buffer quota. lwip buffers can be used only when using LWIP network stack.

• The entities that are marked Not required need not be added. The board, console, console_autogen, segger_sysview, and si91x_support folders are related to SiWx917 SoC and Simplicity Studio IDE. These need not be added if you are using a non-silicon Labs host MCU and IDE.

• The socket component present at components/device/silabs/si91x/wireless is mandatory when your application needs socket-based data transfers.

• The resources folder contains the default values required by the network_management component.

  

  

The files and folders that are to be added entirely depends on the application requirements. For instance, consider a typical example application where the SiWx917 as a Wi-Fi client must connect to a Wi-Fi network, send application data to a TCP Server and then should be set in connected sleep mode. This SiWx917 application requires the wifi and asynchronous_socketor socketor bsd_socket components. In this case, let us choose the bsd_socket component. At this point, add the complete folders or only those required as per your choice.

For STM32 project, copy the required entities from the components and resources folders to the WSDK directory. From the components folder, add the required files/folders from the common, device, protocol, and service entities.

Configure the Project#

1. Import the project into the IDE.

   For STM32, the Sample_STM32_project is imported into Keil µVision IDE. For MDK-ARM tool chain, it is mandatory to enable the preprocessor symbol: “__Keil”.

   

2. Add the required files and folders from SiSDK (formerly GSDK) and SDK v3.x to your application project. Organize the files and folders as per SDK v3.x structure. Ensure to include the respective header files present in the mandatory folders.

   For STM32 project, the required files and folders are added to the project as shown below: