NUCLEO-WL33CC Out Of Box Demonstration

1. Introduction

This sub-1GHz NUCLEO-WL33 wiki page contains an out-of-the-box demo and showcases the different features of the STM32WL33 product.

It provides a guide to the initial setup of the NUCLEO-WL33CC1 board and offers guidance and links to other wiki pages for starting application development.

Explore the full potential of the STM32WL3x series with this comprehensive demo guide. With just a few clicks, access and program the STM32WL33 chipset and establish sub-1GHz RF communication.

Refer to the Introduction to sub-1GHz wiki page for more details on sub-1GHz connectivity and an in-depth description of the STMicroelectronics sub-1GHz portfolio.

NUCLEO-WL33CC box contents
NUCLEO-WL33CC box contents


2. Tools

2.1. Software and system requirements

The following software tools are required:

  • One of the following IDEs:
    • IAR Embedded Workbench for ARM (EWARM) toolchain V9.30.1 or above + ST-LINK, patch available here:
      • STM32Cube_FW_WL3_V1.x.x\Utilities\PC_Software\EWARMv9_STM32WL3x_V1.0.0.zip
      • This patch supports STM32WL33 devices
    • Arm® Keil® V5.37 or above, patch available here:
      • STM32Cube_FW_WL3_V1.x.x\Utilities\PC_Software\Keil.STM32WL3x_DFP.1.0.0.zip
      • This patch supports STM32WL33 devices
    • STM32CubeIDE V1.17.0 or above:
      • Supports STM32WL33 devices
      • More details about STM32CubeIDE in this article
  • STM32CubeProgrammer, to program the board with a generated binary.
  • The STM32CubeWL3 MCU Package, available from:

2.2. Hardware requirements

The following hardware equipment is required:

NUCLEO-WL33CC1
NUCLEO-WL33CC1


3. Building and programming a project

The \STM32Cube_FW_WL3_V1.0.0\Projects\NUCLEO-WL33CC\Demonstrations\Command_Line_Interface\CLI project (on GitHub) demonstrates the basics and can be used in further steps.

3.1. Building and programming with STM32CubeIDE using onboard ST-LINK

  • Open the project by doing one of the following:
    • Double-clicking the .cproject file in \STM32Cube_FW_WL3_V1.0.0\Projects\NUCLEO-WL33CC\Demonstrations\Command_Line_Interface\CLI\STM32CubeIDE
    • Importing the path by running STM32CubeIDE (File -> Open Projects from File System), as shown by the image below:

      Connectivity NUCLEO-WL33CC Out Of Box Demonstration cubeide import.png

  • Build the project (Project -> Build project or click the icon, as shown by the image below):

Connectivity NUCLEO-WL33CC Out Of Box Demonstration 1741700005179 cubeide compilation.png


  • Program the project (Run -> Run As -> STM32 C/C++ Application, as shown by the image below):

    Connectivity NUCLEO-WL33CC Out Of Box Demonstration 1741700601302 cubeide run.png

  • In the pop-up window (as shown in the image below), click OK to program the CLI firmware onto the board.

    Connectivity NUCLEO-WL33CC Out Of Box Demonstration 1741701230660.png

3.2. Building and programming with Arm® Keil® using onboard ST-LINK

  • Make sure that the patch was installed (STM32Cube_FW_WL3_V1.x.x\Utilities\PC_Software\Keil.STM32WL3x_DFP.1.0.0.zip)
  • Open \STM32Cube_FW_WL3_V1.0.0\Projects\NUCLEO-WL33CC\Demonstrations\Command_Line_Interface\CLI\CLI.uvprojx
  • Build the project (Project -> Build Target (F7), as shown by the image below):

    Connectivity NUCLEO-WL33CC Out Of Box Demonstration 1741703219941 keil build.png

  • Program the board (Flash -> Download, as shown by the image below, or launch a debug session, which also triggers download):

    Connectivity NUCLEO-WL33CC Out Of Box Demonstration 1741703373765 keil flash.png

3.3. Building and programming with IAR Embedded Workbench using onboard ST-LINK

  • Make sure that the patch was installed (STM32Cube_FW_WL3_V1.x.x\Utilities\PC_Software\EWARMv9_STM32WL3x_V1.0.0.zip)
  • Open \STM32Cube_FW_WL3_V1.0.0\Projects\NUCLEO-WL33CC\Demonstrations\Command_Line_Interface\CLI\EWARM
  • Build the project (Project -> Make (F7), as shown by the image below):

    Connectivity NUCLEO-WL33CC Out Of Box Demonstration 1741704370148 iar build.png

  • Download the project (Project -> Download -> Download active application, as shown by the image below, or click Download and Debug):

    Connectivity NUCLEO-WL33CC Out Of Box Demonstration 1741704493973 iar flash.png

3.4. Connecting to the device using STM32CubeProgrammer and ST-LINK

STM32CubeProgrammer can be used to view the device memory, download firmware to the device, upload the device memory to a file, manage the device option bytes, and much more.

In this case, STM32CubeProgrammer can be used to download the built binary (from either of the IDEs) to a device or multiple devices.

To do so:

  • Launch STM32CubeProgrammer and connect to the device (reset mode must be set to Software reset, other settings can be left at default value)

    Connectivity NUCLEO-WL33CC Out Of Box Demonstration 1741706981632 stlink.png

  • Open the compiled CLI binary from either of the IDEs:
    • For STM32CubeIDE: \CLI\STM32CubeIDE\Debug\CLI.elf (hex generation can be enabled in the project settings)
    • For Arm® Keil®: \CLI\MDK-ARM\Release\Exe\CLI.hex or CLI.axf
    • For IAR: \CLI\EWARM\Release\Exe\CLI.hex
  • Depending on the binary, the address may need to be set to 0x1004 0000 manually.

    Connectivity stm32wl3 cli cubeprog.png

  • Disconnect the device