Skip to content

Commit

Permalink
Wi-Fi Applications v1.0.0
Browse files Browse the repository at this point in the history
  • Loading branch information
silabs-ThiepN authored and silabs-DanielN committed Sep 13, 2024
0 parents commit ea24b1a
Show file tree
Hide file tree
Showing 306 changed files with 44,486 additions and 0 deletions.
66 changes: 66 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,66 @@
<table border="0">
<tr>
<td align="left" valign="middle">
<h1>SiWx91x Wi-Fi Application Examples</h1>
</td>
<td align="left" valign="middle">
<a href="https://www.silabs.com/wireless/wi-fi">
<img src="https://www.silabs.com/content/siliconlabs/en/wireless/wi-fi/siwx917-wireless-socs.thumb.256.144.png" title="Silicon Labs Gecko and Wireless Gecko MCUs" alt="SiWx91x microcontrollers" width="250"/>
</a>
</td>
</tr>
</table>

# Silicon Labs Wi-Fi Applications #

[![Version Badge](https://img.shields.io/badge/-v1.0.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.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.

This repository provides SLCP projects (as External Repositories).

## Examples ##

| No | Example name | Link to example |
|:--:|:-------------|:---------------:|
| 1 | Wi-Fi - Asset Tracking | [Click Here](./wifi_asset_tracking) |

## Requirements ##

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)
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)

## Working with Projects ##

1. To add an external repository, perform the following steps.

- From Simpilicity Studio 5, go to **Preferences > Simplicity Studio > External Repos**. Here you can add the repo `https://github.com/SiliconLabs/wifi_applications.git`

- Cloning and then selecting the branch, tag, or commit to add. The default branch is Master. This repo cloned to `<path_to_the_SimplicityStudio_v5>\developer\repos\`

2. From Launcher, select your device from the "Debug Adapters" on the left before creating a project. Then click the **EXAMPLE PROJECTS & DEMOS** tab -> check **wifi_applications** under **Provider** to show a list of Wi-Fi application example projects compatible with the selected device. Click CREATE on a project to generate a new application from the selected template.

## Porting to Another Board ##

To change the target board, navigate to Project -> Properties -> C/C++ Build -> Board/Part/SDK. Start typing in the Boards search box and locate the desired development board, then click Apply to change the project settings. Ensure that the board specifics include paths, found in Project -> Properties -> C/C++ General -> Paths and Symbols, correctly match the target board.

## Documentation ##

The official Wi-Fi documentation is available on the [Developer Documentation](https://docs.silabs.com/wiseconnect/latest/wiseconnect-developing-with-wiseconnect-sdk/) page.

## Reporting Bugs/Issues and Posting Questions and Comments ##

To report bugs in the Application Examples projects, please create a new "Issue" in the "Issues" section of this repo. Please reference the board, project, and source files associated with the bug, and reference line numbers. If you are proposing a fix, also include information on the proposed fix. Since these examples are provided as-is, there is no guarantee that these examples will be updated to fix these issues.

Questions and comments related to these examples should be made by creating a new "Issue" in the "Issues" section of this repo.

## Disclaimer ##

The Gecko SDK suite supports development with Silicon Labs IoT SoC and module devices. Unless otherwise specified in the specific directory, all examples are considered to be EXPERIMENTAL QUALITY which implies that the code provided in the repos has not been formally tested and is provided as-is. It is not suitable for production environments. In addition, this code will not be maintained and there may be no bug maintenance planned for these resources. Silicon Labs may update projects from time to time.
19 changes: 19 additions & 0 deletions templates.xml
Original file line number Diff line number Diff line change
@@ -0,0 +1,19 @@
<?xml version="1.0" encoding="ASCII"?><model:MDescriptors xmlns:model="http://www.silabs.com/ss/Studio.ecore">
<descriptors name="wifi_asset_tracking" label="Wi-Fi - Asset Tracking"
description="This application demonstrates how to configure the SiWG917 module as an Azure device endpoint and how to establish a connection with Azure IoT Hub. This project contains Development of a Wi-Fi tracker application on the SiWG917-PK6031A that will be connected to Wi-Fi access point using WLAN APIs provided by the WiSeConnect 3 SDK. Communicates with Azure IoT Hub based on the configurations provided by the developer through the JSON messages containig the following fields.">
<properties key="namespace" value="template.uc"/>
<properties key="keywords" value="universal\ configurator"/>
<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="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"/>
<properties key="category" value="Wifi Examples"/>
<properties key="quality" value="EXPERIMENTAL"/>
<properties key="filters" value="Capability|SoC MCU|32-bit\ MCU Project\ Difficulty|Advanced Wireless\ Technology|Wifi"/>
<properties key="stockConfigCompatibility" value="com.silabs.ss.framework.project.toolchain.core.default"/>
</descriptors>
</model:MDescriptors>
Loading

0 comments on commit ea24b1a

Please sign in to comment.