https://github.com/STMicroelectronics/STM32CubeWL3
Full firmware package for the STM32WL3x product line microcontrollers containing CMSIS, HAL, LL and BSP drivers, MW libraries, and a set of demos, applications, and examples.
https://github.com/STMicroelectronics/STM32CubeWL3
stm32 stm32cube-mcu-package stm32wl3 wireless
Last synced: 10 months ago
JSON representation
Full firmware package for the STM32WL3x product line microcontrollers containing CMSIS, HAL, LL and BSP drivers, MW libraries, and a set of demos, applications, and examples.
- Host: GitHub
- URL: https://github.com/STMicroelectronics/STM32CubeWL3
- Owner: STMicroelectronics
- License: other
- Created: 2024-12-04T17:01:42.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-03-03T13:35:40.000Z (about 1 year ago)
- Last Synced: 2025-03-03T14:31:44.767Z (about 1 year ago)
- Topics: stm32, stm32cube-mcu-package, stm32wl3, wireless
- Language: C
- Homepage: https://www.st.com/en/microcontrollers-microprocessors/stm32wl3x.html
- Size: 19.1 MB
- Stars: 0
- Watchers: 6
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE.md
- Code of conduct: CODE_OF_CONDUCT.md
- Security: SECURITY.md
Awesome Lists containing this project
README
# STM32CubeWL3 MCU Firmware Package
> [!IMPORTANT]
> This repository has been created using the `git submodule` command. Please refer to the ["How to use"](README.md#how-to-use) section for more details.
**STM32Cube** is an STMicroelectronics original initiative to ease the developers' life by reducing efforts, time and cost.
**STM32Cube** covers the overall STM32 products portfolio. It includes a comprehensive embedded software platform delivered for each STM32 series.
* The CMSIS modules (core and device) corresponding to the ARM(tm) core implemented in this STM32 product.
* The STM32 HAL-LL drivers, an abstraction layer offering a set of APIs ensuring maximized portability across the STM32 portfolio.
* The BSP drivers of each evaluation, discovery or nucleo board provided for this STM32 series.
* A consistent set of middleware libraries such as FatFs, FreeRTOS, Sigfox...
* A full set of software projects (basic examples, applications, and demonstrations) for each board, each project developed in three flavors using three toolchains (EWARM, MDK-ARM, and STM32CubeIDE).
Two models of publication are proposed for the STM32Cube embedded software:
* The monolithic **MCU Package**: all STM32Cube software modules of one STM32 series are present (Drivers, Middleware, Projects, Utilities) in the repository (usual name **STM32Cubexx**, xx corresponding to the STM32 series).
* The **MCU component**: each STM32Cube software module being part of the STM32Cube MCU Package, is delivered as an individual repository, allowing the user to select and get only the required software functions.
The **STM32CubeWL3 MCU Package** projects are directly running on the STM32WL3 series boards. You can find in each Projects/*Board name* directories a set of software projects (Applications/Demonstration/Examples).
> [!NOTE]
> ## Some middleware libraries and projects are unavailable in this repository
>
> In this repository, the middleware libraries listed below **along with** [this](Projects/README.md#list-of-unavailable-projects) list of projects (demos, applications, and examples) using them, are **not available** as they (the middleware libraries) are subject to some restrictive license terms requiring the user's approval via a "click thru" procedure.
> * `./Middlewares/Third_Party/Sigfox`
>
> If needed, they can be found inside the full firmware package available on our website `st.com` and downloadable from [here](https://www.st.com/content/st_com/en/products/embedded-software/mcu-mpu-embedded-software/stm32-embedded-software/stm32cube-mcu-mpu-packages/stm32cubewl3.html#get-software). You will be prompted to login or to register in case you have no account.
## Release note
Details about the content of this release are available in the release note [here](https://htmlpreview.github.io/?https://github.com/STMicroelectronics/STM32CubeWL3/blob/main/Release_Notes.html).
## How to use
This repository has been created using the `git submodule` command. Please check the instructions below for proper use. Please check also **the notes at the end of this section** for further information.
1. To **clone** this repository along with the linked submodules, option `--recursive` has to be specified as shown below.
```bash
git clone --recursive https://github.com/STMicroelectronics/STM32CubeWL3.git
```
2. To get the **latest updates**, in case this repository is **already** on your local machine, issue the following **two** commands (with this repository as the **current working directory**).
```bash
git pull
git submodule update --init --recursive
```
3. To use the **same firmware version** as the one available on [st.com](https://www.st.com/en/microcontrollers-microprocessors/stm32-32-bit-arm-cortex-mcus.html), issue the command below **after** specifying the targeted `vX.Y.Z` version. This should be done **after** the command(s) indicated in instruction (1) or in instruction (2) above have been successfully executed.
```bash
git checkout vX.Y.Z # Specify the targeted vX.Y.Z version
```
4. To **avoid** going through the above instructions and **directly** clone the same firmware version as the one available on [st.com](https://www.st.com/en/microcontrollers-microprocessors/stm32-32-bit-arm-cortex-mcus.html), issue the command below **after** specifying the targeted `vX.Y.Z` version.
```bash
git clone --recursive --depth 1 --branch vX.Y.Z https://github.com/STMicroelectronics/STM32CubeWL3.git
```
> [!NOTE]
> * The latest version of this firmware available on GitHub may be **ahead** of the one available on [st.com](https://www.st.com/en/microcontrollers-microprocessors/stm32-32-bit-arm-cortex-mcus.html) or via [STM32CubeMX](https://www.st.com/en/development-tools/stm32cubemx.html). This is due to the **rolling release** process deployed on GitHub. Please refer to [this](https://github.com/STMicroelectronics/STM32Cube_MCU_Overall_Offer/discussions/21) post for more details.
> * Option `--depth 1` specified in instruction (4) above is **not** mandatory. It may be useful to skip downloading all previous commits up to the one corresponding to the targeted version.
> * If GitHub "Download ZIP" option is used instead of the `git clone` command, then the different submodules have to be collected and added **manually**.
## Boards available
* STM32WL3
* [NUCLEO-WL33CC1](https://www.st.com/en/evaluation-tools/nucleo-wl33cc1.html)
* [NUCLEO-WL33CC2](https://www.st.com/en/evaluation-tools/nucleo-wl33cc2.html)
## Troubleshooting
Please refer to the [CONTRIBUTING.md](CONTRIBUTING.md) guide.