Wi-Fi Applications v2.0.0

Author: silabs-DanielN

README.md

@@ -14,10 +14,10 @@
 # Silicon Labs Wi-Fi Applications #
 
 
-[![Version Badge](https://img.shields.io/badge/-v1.1.0-green)](https://github.com/SiliconLabs/wifi_applications/releases)
-[![GSDK Badge](https://img.shields.io/badge/GSDK-v4.4.3-green)](https://github.com/SiliconLabs/gecko_sdk/releases)
-[![WSDK Badge](https://img.shields.io/badge/WSDK-v3.2.0-green)](https://github.com/SiliconLabs/wiseconnect/releases)
-[![TPHD Version Badge](https://img.shields.io/badge/TPHD-v3.0.1+-green)](https://github.com/SiliconLabs/third_party_hw_drivers_extension/releases)
+[![Version Badge](https://img.shields.io/badge/-v2.0.0-green)](https://github.com/SiliconLabs/wifi_applications/releases)
+[![SiSDK Badge](https://img.shields.io/badge/SiSDK-v2024.12.0-green)](https://github.com/SiliconLabs/simplicity_sdk/releases)
+[![WSDK Badge](https://img.shields.io/badge/WSDK-v3.4.0-green)](https://github.com/SiliconLabs/wiseconnect/releases)
+[![TPHD Version Badge](https://img.shields.io/badge/TPHD-v4.1.0+-green)](https://github.com/SiliconLabs/third_party_hw_drivers_extension/releases)
 ![License badge](https://img.shields.io/badge/License-Zlib-green)
 
 The Silicon Labs Wi-Fi allows for a wide variety applications to be built on its foundation. This repo showcases some example applications using the Silicon Labs Wi-Fi.
@@ -37,7 +37,7 @@ This repository provides SLCP projects (as External Repositories).
 
 1. Silicon Labs SiWx91x development kit
 2. Simplicity Studio 5
-3. Compatible GSDK version that specified in each project's readme file. You can install it via Simplicity Studio or download it from our GitHub [gecko_sdk](https://github.com/SiliconLabs/gecko_sdk)
+3. Compatible SDK version that specified in each project's readme file. You can install it via Simplicity Studio or download it from our GitHub [simplicity sdk](https://github.com/SiliconLabs/simplicity_sdk)
 4. Compatible WiSeConnect SDK version that specified in each project's readme file. You can install it via Simplicity Studio or download it from our GitHub [wiseconnect_sdk](https://github.com/SiliconLabs/wiseconnect)
 5. Compatible Third-Party Hardware Drivers extension that also specified in each project's readme file, available [here](https://github.com/SiliconLabs/third_party_hw_drivers_extension)
 

templates.xml

@@ -6,8 +6,8 @@
     <properties key="solutionReferenceId" value="wifi_asset_tracking.SimplicityStudio.wifi_asset_tracking.slcp"/>
     <properties key="projectFilePaths" value="wifi_asset_tracking/SimplicityStudio/wifi_asset_tracking.slcp"/>
     <properties key="readmeFiles" value="wifi_asset_tracking/README.md"/>
-    <properties key="boardCompatibility" value="brd4338a com.silabs.board.none"/>
-    <properties key="partCompatibility" value=".*si917.* .*siwg917m111mgtba.*"/>
+    <properties key="boardCompatibility" value="brd4338a brd2605a com.silabs.board.none"/>
+    <properties key="partCompatibility" value=".*si917.* .*siwg917m111.*"/>
     <properties key="ideCompatibility" value="iar-embedded-workbench makefile-ide simplicity-ide visual-studio-code"/>
     <properties key="ideCompatibility" value="iar-embedded-workbench makefile-ide segger-embedded-studio simplicity-ide"/>
     <properties key="toolchainCompatibility" value="gcc iar segger"/>
@@ -23,8 +23,8 @@
     <properties key="solutionReferenceId" value="wifi_weather_display.SimplicityStudio.wifi_weather_display.slcp"/>
     <properties key="projectFilePaths" value="wifi_weather_display/SimplicityStudio/wifi_weather_display.slcp"/>
     <properties key="readmeFiles" value="wifi_weather_display/README.md"/>
-    <properties key="boardCompatibility" value="brd4338a com.silabs.board.none"/>
-    <properties key="partCompatibility" value=".*si917.* .*siwg917m111mgtba.*"/>
+    <properties key="boardCompatibility" value="brd4338a brd2605a com.silabs.board.none"/>
+    <properties key="partCompatibility" value=".*siwg917m111.*"/>
     <properties key="ideCompatibility" value="iar-embedded-workbench makefile-ide simplicity-ide visual-studio-code"/>
     <properties key="ideCompatibility" value="iar-embedded-workbench makefile-ide segger-embedded-studio simplicity-ide"/>
     <properties key="toolchainCompatibility" value="gcc iar segger"/>

wifi_asset_tracking/README.md

@@ -67,15 +67,14 @@ Firmware application consists of three logical modules:
 
     ![application_overview](images/firmware/application_overview.png)
 
+## SDK version ##
+
+SiSDK 2024.12.0
+
 ## Hardware Requirements ##
 
 - A Wireless Access Point
-- SoC Model:
-  - Standalone
-    - [Si-MB4002A - Wireless pro kit mainboard](https://www.silabs.com/development-tools/wireless/wireless-pro-kit-mainboard?tab=overview)
-    - [SiWx917-RB4338A - SiWx917 Wi-Fi 6 and Bluetooth LE SoC 8 MB Flash Radio Board](https://www.silabs.com/development-tools/wireless/wi-fi/siwx917-rb4338a-wifi-6-bluetooth-le-soc-radio-board?tab=overview)
-  - Kits
-    - [SiWx917-PK6031A - SiWx917 Wi-Fi 6 and Bluetooth LE 8 MB Flash SoC Pro Kit](https://www.silabs.com/development-tools/wireless/wi-fi/siwx917-pro-kit?tab=overview)
+- 1x [Wi-Fi Development Kit](https://www.silabs.com/development-tools/wireless/wi-fi) based on SiWG917 (e.g. [SIWX917-DK2605A](https://www.silabs.com/development-tools/wireless/wi-fi/siwx917-dk2605a-wifi-6-bluetooth-le-soc-dev-kit) or [SIWX917-RB4338A](https://www.silabs.com/development-tools/wireless/wi-fi/siwx917-rb4338a-wifi-6-bluetooth-le-soc-radio-board))
 - [SparkFun Humidity and Temperature Sensor Breakout - Si7021](https://www.sparkfun.com/products/13763)
 - [SparkFun GNSS Receiver Breakout - MAX-M10S (Qwiic)](https://www.sparkfun.com/products/18037)
 - [SparkFun 6 Degrees of Freedom Breakout - BMI270 (Qwiic)](https://www.sparkfun.com/products/22397)
@@ -87,17 +86,17 @@ Firmware application consists of three logical modules:
   - Download the [Simplicity Studio v5 IDE](https://www.silabs.com/developers/simplicity-studio)
   - Follow the [Simplicity Studio User Guide](https://docs.silabs.com/simplicity-studio-5-users-guide/1.1.0/ss-5-users-guide-getting-started/install-ss-5-and-software#install-ssv5) to install Simplicity Studio IDE
 - Follow these document to setup your [Azure Cloud](https://github.com/SiliconLabs/wifi_applications/blob/main/wifi_asset_tracking/AZURE.md) and [Dashboard](https://github.com/SiliconLabs/wifi_applications/blob/main/wifi_asset_tracking/dashboard/README.md)
-- [Gecko SDK (GSDK) Version 4.4.3](https://github.com/SiliconLabs/gecko_sdk/releases/tag/v4.4.3)
-- [WiSeConnect 3.2.0 SDK](https://docs.silabs.com/wiseconnect/3.2.0/wiseconnect-developers-guide-developing-for-silabs-hosts/)
-- [Third Party Hardware Drivers Extension V3.0.1](https://github.com/SiliconLabs/third_party_hw_drivers_extension/releases/tag/v3.0.1)
+- [Simplicity SDK Version 2024.12.0](https://github.com/SiliconLabs/simplicity_sdk/releases/tag/v2024.12.0)
+- [WiSeConnect 3.4.0 SDK](https://github.com/SiliconLabs/wiseconnect/releases/tag/v3.4.0)
+- [Third Party Hardware Drivers Extension V4.1.0](https://github.com/SiliconLabs/third_party_hw_drivers_extension/releases/tags/v4.1.0)
 
 ## Setup ##
 
-### Setup Diagram ###
+### Connections Required ###
 
 Sparkfun Qwiic boards can be easily connected to each other using Qwiic cables. Then connect it all back to the SiWx917 Wi-Fi 6 and Bluetooth LE 8 MB Flash SoC Pro Kit board as shown in the table below:
 
-| Description  | BRD4338A GPIO | BRD4002 EXP Header | SparkFun Qwiic boards |
+| Description  | BRD4338A + BRD2605A  | BRD4002 EXP Header | SparkFun Qwiic boards |
 | -------------| ------------- | ------------------ | ------------------ |
 | I2C_SDA      | ULP_GPIO_6    | EXP_16             | SDA                |
 | I2C_SCL      | ULP_GPIO_7    | EXP_15             | SCL                |
@@ -110,7 +109,7 @@ To test this application, you can either create a project based on an example pr
 
 ### Create a project based on an example project ###
 
-1. From the Launcher Home, add the BRD4338A to My Products, click on it, and click on the **EXAMPLE PROJECTS & DEMOS** tab. Find the example project filtering by "asset".
+1. From the Launcher Home, add your board to My Products, click on it, and click on the **EXAMPLE PROJECTS & DEMOS** tab. Find the example project filtering by "asset".
 
 2. Click **Create** button on the **Wi-Fi - Asset Tracking** example. Example project creation dialog pops up -> click Create and Finish and Project should be generated.
 
@@ -131,7 +130,7 @@ To test this application, you can either create a project based on an example pr
 
 ### Start with a "SL Si91x - Empty C Project SoC" project ###
 
-1. Create a **SL Si91x - Empty C Project SoC** project for BRD4338A using Simplicity Studio 5.
+1. Create a **SL Si91x - Empty C Project SoC** project for the SiWx917 using Simplicity Studio 5.
 
 2. Copy all of source files in "wifi_asset_tracking/src" and header files in "wifi_asset_tracking/inc" to the directory of the project root folder (overwriting the existing files).
 
@@ -149,7 +148,7 @@ To test this application, you can either create a project based on an example pr
         - [WiSeConnect 3 SDK] → [Device] → [Si91x] → [Wireless] → [Buffer Manager] → [Memory Pool Buffers]
         - [WiSeConnect 3 SDK] → [Third Party] → [AZURE FreeRTOS Middleware]
         - [WiSeConnect 3 SDK] → [Service] → [Network Management] → [Configuration] → [Basic Network Configuration Manager]
-        - [WiSeConnect 3 SDK] → [Device] → [Si91x] → [MCU] → [Hardware] → [Memory LCD SPI driver]
+        - [WiSeConnect 3 SDK] → [Device] → [Si91x] → [MCU] → [Hardware] → [Memory LCD SPI driver] (if using the SiWx917 Wi-Fi 6 and Bluetooth LE 8 MB Flash SoC Pro Kit - BRD4338A)
         - [WiSeConnect 3 SDK] → [Device] → [Si91x] → [MCU] → [Peripheral] → [Calendar]
         - [WiSeConnect 3 SDK] → [Device] → [Si91x] → [MCU] → [Hardware] → [Si70xx Humidity and Temperature Sensor]
         - [WiSeConnect 3 SDK] → [Device] → [Si91x] → [Wireless] → [Crypto] → [HMAC]
@@ -158,7 +157,7 @@ To test this application, you can either create a project based on an example pr
         - [WiSeConnect 3 SDK] → [Resources] → [WiSeConnect3 Resources]
         - [WiSeConnect 3 SDK] → [Device] → [Si91x] → [MCU] → [Service] → [Power Manager] → [ULP Peripheral] → [ULP SSI]
         - [Application] → [Utility] → [Assert]
-        - [Platform] → [Driver] → [GLIB Graphics Library]
+        - [Platform] → [Driver] → [GLIB Graphics Library] (if using the SiWx917 Wi-Fi 6 and Bluetooth LE 8 MB Flash SoC Pro Kit - BRD4338A)
         - [RTOS] →  [FreeRTOS] → [FreeRTOS Heap 4]
 
 4. From the project root folder, open file "config/sl_net_default_values.h" change 2 macros "DEFAULT_WIFI_CLIENT_PROFILE_SSID" and "DEFAULT_WIFI_CLIENT_CREDENTIAL" match with your WIFI SSID and WIFI PASSPHRASE

wifi_asset_tracking/SimplicityStudio/wifi_asset_tracking.slcp

@@ -107,9 +107,9 @@ tag:
 
 sdk_extension:
 - id: third_party_hw_drivers
-  version: 3.0.1
+  version: 4.1.0
 - id: wiseconnect3_sdk
-  version: 3.2.0
+  version: 3.4.0
 
 ui_hints:
   highlight:

wifi_asset_tracking/images/firmware/system_overview.png

@@ -122,11 +122,11 @@ sl_status_t sl_retry_azure_cloud_connection();
 sl_status_t sl_load_ssl_certificates();
 
 /******************************************************************************
-* @brief Function is used to create TLS transport for Azure IoT Hub connection.
-* @return The following values are returned:
-* -  \ref SL_STATUS_OK on success
-* -  \ref SL_STATUS_FAIL - on TLS connection creation failed
-******************************************************************************/
+ * @brief Function is used to create TLS transport for Azure IoT Hub connection.
+ * @return The following values are returned:
+ * -  \ref SL_STATUS_OK on success
+ * -  \ref SL_STATUS_FAIL - on TLS connection creation failed
+ ******************************************************************************/
 sl_status_t sl_create_tls_client_connection();
 
 /**************************************************************************/ /**

wifi_asset_tracking/inc/sl_wifi_asset_tracking_azure_handler.h

@@ -36,9 +36,9 @@ extern "C" {
  * Default : 60 seconds
  */
 #define DEMO_CONFIG_WIFI_SAMPLING_INTERVAL                            60
-#if (DEMO_CONFIG_WIFI_SAMPLING_INTERVAL < MIN_LIMIT_OF_WIFI_SAMPLING_INTERVAL \
-     || DEMO_CONFIG_WIFI_SAMPLING_INTERVAL                                    \
-     > MAX_LIMIT_OF_WIFI_SAMPLING_INTERVAL)
+#if (DEMO_CONFIG_WIFI_SAMPLING_INTERVAL < MIN_LIMIT_OF_WIFI_SAMPLING_INTERVAL   \
+                                          || DEMO_CONFIG_WIFI_SAMPLING_INTERVAL \
+                                          > MAX_LIMIT_OF_WIFI_SAMPLING_INTERVAL)
 #error Invalid sampling interval of wi-fi. It should be within specified range.
 #endif
 
@@ -49,9 +49,9 @@ extern "C" {
  * Default : 5 seconds
  */
 #define DEMO_CONFIG_TEMP_RH_SENSOR_SAMPLING_INTERVAL                  5
-#if (DEMO_CONFIG_TEMP_RH_SENSOR_SAMPLING_INTERVAL    \
-     < MIN_LIMIT_OF_TEMP_RH_SENSOR_SAMPLING_INTERVAL \
-     || DEMO_CONFIG_TEMP_RH_SENSOR_SAMPLING_INTERVAL \
+#if (DEMO_CONFIG_TEMP_RH_SENSOR_SAMPLING_INTERVAL      \
+     < MIN_LIMIT_OF_TEMP_RH_SENSOR_SAMPLING_INTERVAL   \
+       || DEMO_CONFIG_TEMP_RH_SENSOR_SAMPLING_INTERVAL \
      > MAX_LIMIT_OF_TEMP_RH_SENSOR_SAMPLING_INTERVAL)
 #error \
   Invalid sampling interval of temperature and RH sensor. It should be within specified range.
@@ -64,9 +64,9 @@ extern "C" {
  * Default : 1 second
  */
 #define DEMO_CONFIG_IMU_SENSOR_SAMPLING_INTERVAL                      1
-#if (DEMO_CONFIG_IMU_SENSOR_SAMPLING_INTERVAL    \
-     < MIN_LIMIT_OF_IMU_SENSOR_SAMPLING_INTERVAL \
-     || DEMO_CONFIG_IMU_SENSOR_SAMPLING_INTERVAL \
+#if (DEMO_CONFIG_IMU_SENSOR_SAMPLING_INTERVAL      \
+     < MIN_LIMIT_OF_IMU_SENSOR_SAMPLING_INTERVAL   \
+       || DEMO_CONFIG_IMU_SENSOR_SAMPLING_INTERVAL \
      > MAX_LIMIT_OF_IMU_SENSOR_SAMPLING_INTERVAL)
 #error \
   Invalid sampling interval of imu sensor. It should be within specified range.
@@ -79,9 +79,9 @@ extern "C" {
  * Default : 60 seconds
  */
 #define DEMO_CONFIG_GNSS_RECEIVER_SAMPLING_INTERVAL                   60
-#if (DEMO_CONFIG_GNSS_RECEIVER_SAMPLING_INTERVAL    \
-     < MIN_LIMIT_OF_GNSS_RECEIVER_SAMPLING_INTERVAL \
-     || DEMO_CONFIG_GNSS_RECEIVER_SAMPLING_INTERVAL \
+#if (DEMO_CONFIG_GNSS_RECEIVER_SAMPLING_INTERVAL      \
+     < MIN_LIMIT_OF_GNSS_RECEIVER_SAMPLING_INTERVAL   \
+       || DEMO_CONFIG_GNSS_RECEIVER_SAMPLING_INTERVAL \
      > MAX_LIMIT_OF_GNSS_RECEIVER_SAMPLING_INTERVAL)
 #error \
   Invalid sampling interval of gnss receiver. It should be within specified range.

wifi_asset_tracking/inc/sl_wifi_asset_tracking_demo_config.h

@@ -139,11 +139,11 @@ sl_status_t sl_convert_si7021_reading_to_json_format(
 void sl_json_data_converter_task();
 
 /**************************************************************************/ /**
-* @brief Function to send new session JSON message to MQTT package queue.
-* @return The following values are returned:
-* -  \ref SL_STATUS_OK on success
-* -  \ref SL_STATUS_FAIL - on keep alive message sending failure.
-*******************************************************************************/
+ * @brief Function to send new session JSON message to MQTT package queue.
+ * @return The following values are returned:
+ * -  \ref SL_STATUS_OK on success
+ * -  \ref SL_STATUS_FAIL - on keep alive message sending failure.
+ *******************************************************************************/
 sl_status_t sl_json_send_new_session_message();
 
 /**************************************************************************/ /**

wifi_asset_tracking/inc/sl_wifi_asset_tracking_json_data_handler.h

@@ -425,8 +425,8 @@ uint32_t sl_create_crypto_hmac(const uint8_t *pucKey,
 }
 
 /******************************************************************************
-* Function will create properties for tele-metry messages
-******************************************************************************/
+ * Function will create properties for tele-metry messages
+ ******************************************************************************/
 sl_status_t sl_create_telemetry_message_properties()
 {
   AzureIoTResult_t azure_iot_status;
@@ -480,9 +480,9 @@ sl_status_t sl_create_telemetry_message_properties()
 }
 
 /******************************************************************************
-* Function will retry for Azure cloud connection with configured
-* authentication method for five times at every five seconds.
-******************************************************************************/
+ * Function will retry for Azure cloud connection with configured
+ * authentication method for five times at every five seconds.
+ ******************************************************************************/
 sl_status_t sl_retry_azure_cloud_connection()
 {
   uint8_t retry_cnt;
@@ -531,8 +531,8 @@ sl_status_t sl_retry_azure_cloud_connection()
 }
 
 /******************************************************************************
-* Function is used to load SSL certificates based on authentication method.
-******************************************************************************/
+ * Function is used to load SSL certificates based on authentication method.
+ ******************************************************************************/
 sl_status_t sl_load_ssl_certificates()
 {
   sl_status_t status;
@@ -624,8 +624,8 @@ sl_status_t sl_load_ssl_certificates()
 }
 
 /******************************************************************************
-* Function is used to create TLS transport for Azure IoT Hub connection.
-******************************************************************************/
+ * Function is used to create TLS transport for Azure IoT Hub connection.
+ ******************************************************************************/
 sl_status_t sl_create_tls_client_connection(void)
 {
   sl_status_t status;
@@ -638,7 +638,7 @@ sl_status_t sl_create_tls_client_connection(void)
 
   /// DNS query to resolve Azure IoT Hub host name
   do {
-    status = sl_net_host_get_by_name(
+    status = sl_net_dns_resolve_hostname(
       (const char *)DEMO_CONFIG_IOT_HUB_HOST_NAME,
       DNS_TIMEOUT,
       SL_NET_DNS_TYPE_IPV4,
@@ -725,8 +725,8 @@ sl_status_t sl_create_tls_client_connection(void)
 }
 
 /******************************************************************************
-* Callback function used to receive data from TLS socket connection.
-******************************************************************************/
+ * Callback function used to receive data from TLS socket connection.
+ ******************************************************************************/
 int32_t sl_tls_sock_recv(NetworkContext_t *network_context,
                          void *buffer,
                          size_t bytes_to_recv)
@@ -754,8 +754,8 @@ int32_t sl_tls_sock_recv(NetworkContext_t *network_context,
 }
 
 /******************************************************************************
-* Callback function used to send data on TLS socket connection.
-******************************************************************************/
+ * Callback function used to send data on TLS socket connection.
+ ******************************************************************************/
 int32_t sl_tls_sock_send(NetworkContext_t *network_context,
                          const void *buffer,
                          size_t bytes_to_send)
@@ -773,8 +773,8 @@ int32_t sl_tls_sock_send(NetworkContext_t *network_context,
 }
 
 /******************************************************************************
-* Function used to disconnect Azure IoT Hub connection and clean up TLS socket.
-******************************************************************************/
+ * Function used to disconnect Azure IoT Hub connection and clean up TLS socket.
+ ******************************************************************************/
 sl_status_t sl_disconnect_azure_iot_hub()
 {
   /// Disconnect Azure IoT Hub Connection

wifi_asset_tracking/src/sl_wifi_asset_tracking_azure_handler.c

@@ -830,8 +830,8 @@ void sl_json_data_converter_task()
 }
 
 /******************************************************************************
-* Function to send new session JSON message to MQTT package queue.
-******************************************************************************/
+ * Function to send new session JSON message to MQTT package queue.
+ ******************************************************************************/
 sl_status_t sl_json_send_new_session_message()
 {
   sl_wifi_asset_tracking_mqtt_package_queue_data_t new_session_message;