Add WiSeConnect™ SDK 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

STM32 FreeRTOS pathSTM32 FreeRTOS path

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

Prepare Project for Porting#

  1. The initial step in porting is to integrate the WiSeConnect SDK into your host application. The SDK depends on a 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 as well as WiSeConnect SDK for developing an SiWx917 application using a host platform.

  2. Download the SiSDK and WiSeConnect SDK:

    • SDK downloads must be performed using SLT-CLI (v1.1.0 or later) — a standalone command-line tool.

    • Follow steps 1–4 in the Installation and Setup section to install SLT-CLI and download the SDKs via SLT-CLI.

    • Note:

      • In step 2, use the following recipe file.

        wiseconnect="~"
simplicity-sdk="~"

      • To download specific SDK versions, use a recipe file like the following. If you are not sure which simplicity-sdk version corresponds to your WiSeConnect SDK version, refer to the WiSeConnect SDK release notes:release notes of WiSeConnect SDK.

        wiseconnect="4.0.0"
simplicity-sdk="2025.12.0"

  3. 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.

    Create project folderCreate project folder

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

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

    Create SDK foldersCreate SDK folders

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

  1. Add the following c source files from SiSDK (formerly GSDK)present to your project.

    • "sl_string.c" present at path: <sisdk>/platform_common/platform/common/src/sl_string.c.

    • "sli_cmsis_os2_ext_task_register.c" present at path: <sisdk>/cmsis_common/platform/common/src/sli_cmsis_os2_ext_task_register.c

    • "sl_mem_pool.c" present at path: <sisdk>/platform_core/platform/service/mem_pool/src/sl_mem_pool.c

    In case of STM32F411RE, the required c source files are added at SiSDK (formerly GSDK)/src folder.

    Add C source files from SiSDK (formerly GSDK)Add C source files from SiSDK (formerly GSDK)

  2. Include the following c header files from SiSDK (formerly GSDK) present at path: <simplicity_sdk>/platform in your project.

    • "sli_mem_pool.h" present at path: <sisdk>/platform_core/platform/service/mem_pool/inc/sli_mem_pool.h

    • All header files present at path: <sisdk>/platform_common/platform/common/inc/

    • "sl_core.h", "sl_endianness.h" and "sl_stdio.h" present at path: <sisdk>/platform_core/platform/common/inc/

    • "sl_cmsis_os2_common.h" and "sli_cmsis_os2_ext_task_register.h" present at path: <sisdk>/cmsis_common/platform/common/inc/

    • "sli_mem_pool.h" present at path: <sisdk>/platform_core\platform\service\mem_pool\incIn case of STM32F411RE, the header files are added at SiSDK (formerly GSDK)/inc as shown below.

     ![Add header files from SiSDK (formerly GSDK)](resources/add-sdk-add-header-files.png)

Port Compiler and Architecture-Specific Functions#

  1. The following compiler-specific function prototypes present in "sl_core.h" should be defined based on the compiler used for your project.

    CORE_EnterAtomic | CORE_ExitAtomic | CORE_EnterCritical | CORE_ExitCritical

  2. Create a C source file to define the compiler-specific functions to define the above functions. In case of STM32F411RE, a file named sl_host_core.c is created and added at SiSDK (formerly GSDK)/src folder.

    Create port file in SiSDK (formerly GSDK)Create port file in SiSDK (formerly GSDK)

  3. Ensure to include compiler-specific CMSIS header file in the C source file created in above step 2. For example, for ARMCC compiler, include "cmsis_armcc.h", for GCC compiler, include "cmsis_gcc.h" etc.

CORE_EnterAtomic#

Prototype#

CORE_irqState_t CORE_EnterAtomic(void);

Description#

This function disables global interrupts to ensure the specific code executes atomically, without interruption from ISRs. It returns the previous interrupt state, allowing safe restoration later.

Parameters#

None.

Return values#

  • CORE_irqState_t - The saved interrupt state, indicating whether interrupts were enabled before entering the atomic section.

    Note: The CORE_irqState_t is defined in "sl_core.h" file of SiSDK (formerly GSDK).

Examples#

  • EFR32: Refer to the implementation instructions in the "sl_core_cortexm.c" file present at path: <sisdk>/platform_core/platform/common/src for the definition of the function.

  • STM32:

CORE_irqState_t CORE_EnterAtomic(void)
  {
    CORE_irqState_t irqState = __get_PRIMASK();
   __disable_irq();
    return irqState;
  }

CORE_ExitAtomic#

Prototype#

void CORE_ExitAtomic(CORE_irqState_t irqState);

Description#

This function restores the interrupt state saved by CORE_EnterAtomic(). If interrupts were enabled before entering the atomic section, they are re-enabled.

Parameters#

  • CORE_irqState_t - The interrupt state returned by CORE_EnterAtomic(), used to determine whether interrupts should be re-enabled.

Return values#

None

Examples#

  • EFR32: Refer to the implementation instructions in the "sl_core_cortexm.c" file present at path: <sisdk>/platform_core/platform/common/src for the definition of the function.

  • STM32:

void CORE_ExitAtomic(CORE_irqState_t irqState)
  {
  if (irqState == 0) {
      __enable_irq();
     }
  }

CORE_EnterCritical#

Prototype#

CORE_irqState_t CORE_EnterCritical(void);

Description#

This function disables global interrupts to prevent preemption while executing time-sensitive or shared-resource code. It returns the previous interrupt state to be restored later using CORE_ExitCritical().

Parameters#

None.

Return values#

  • CORE_irqState_t - The saved interrupt state before disabling interrupts.

    Note: The CORE_irqState_t is defined in "sl_core.h" file of SiSDK (formerly GSDK).

Examples#

  • EFR32: Refer to the implementation instructions in the "sl_core_cortexm.c" file present at path: <sisdk>/platform_core/platform/common/src for the definition of the function.

  • STM32:

  CORE_irqState_t CORE_EnterCritical(void)
  {
    CORE_irqState_t irqState = __get_PRIMASK();
   __disable_irq();
    return irqState;
  }

CORE_ExitCritical#

Prototype#

void CORE_ExitCritical(CORE_irqState_t irqState)

Description#

This function re-enables global interrupts only if they were enabled prior to entering the critical section, using the saved interrupt state from CORE_EnterCritical().

Parameters#

  • CORE_irqState_t - The interrupt state returned by CORE_EnterCritical(), the saved interupt state.

Return values#

None

Examples#

  • EFR32: Refer to the implementation instructions in the "sl_core_cortexm.c" file present at path: <sisdk>/platform_core/platform/common/src for the definition of the function.

  • STM32:

void CORE_ExitCritical(CORE_irqState_t irqState)
  {
  if (irqState == 0) {
      __enable_irq();
     }
  }

Add Code from WiSeConnect SDK#

It is not required to add all the files and folders present in the SDK to your project. The SDK 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.

  • 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 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.

    Hierarchy of SDK files and folders to be portedHierarchy of SDK files and folders to be ported

    Hierarchy of SDK files and folders to be portedHierarchy of SDK files and folders to be ported

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.

NOTE: Ensure the "malloc" is made thread safe in your project. For more details, refer to "malloc_thread_safety.c" file at path:<SDK>\components\device\silabs\si91x\mcu\core\common\src.

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.

Required files and folders from SDKRequired files and folders from SDK

Required files and folders from SDKRequired files and folders from SDK

Required files and folders from SDKRequired files and folders from SDK

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”.

    STM32 Sample project imported into IDESTM32 Sample project imported into IDE

  2. Add the required files and folders from SiSDK (formerly GSDK) and SDK to your application project. Organize the files and folders as per SDK 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:

    Required files and folders from SDKRequired files and folders from SDK

    Required header files from SDKRequired header files from SDK