.. zephyr:board:: nucleo_wl55jc

Overview

The NUCLEO-WL55JC STM32WL Nucleo-64 board provides an affordable and flexible way for users to try out new concepts and build prototypes with the STM32WL Series microcontroller, choosing from the various combinations of performance, power consumption, and features.

STM32WL55JC microcontroller multiprotocol LPWAN dual-core 32-bit (Arm® Cortex®-M4/M0+ at 48 MHz) in UFBGA73 package featuring:
- Ultra-low-power MCU
- RF transceiver (150 MHz to 960 MHz frequency range) supporting LoRa®, (G)FSK, (G)MSK, and BPSK modulations
- 256-Kbyte Flash memory and 64-Kbyte SRAM
3 user LEDs
3 user buttons and 1 reset push-button
32.768 kHz LSE crystal oscillator
32 MHz HSE on-board oscillator
Board connectors:
- USB with Micro-B
- MIPI debug connector
- ARDUINO Uno V3 expansion connector
- ST morpho extension pin headers for full access to all STM32WL I/Os
Delivered with SMA antenna
Flexible power-supply options: ST-LINK, USB VBUS, or external sources
On-board STLINK-V3 debugger/programmer with USB re-enumeration capability: mass storage, Virtual COM port, and debug port
Comprehensive free software libraries and examples available with the STM32CubeWL MCU Package
Suitable for rapid prototyping of end nodes based on LoRaWAN, Sigfox, wM-Bus, and many other proprietary protocols
Fully open hardware platform

More information about the board can be found at the Nucleo WL55JC website_.

Hardware

The STM32WL55JC long-range wireless and ultra-low-power devices embed a powerful and ultra-low-power LPWAN-compliant radio solution, enabling the following modulations: LoRa®, (G)FSK, (G)MSK, and BPSK It provides the following hardware capabilities:

Radio
- Frequency range: 150 MHz to 960 MHz
- Modulation: LoRa®, (G)FSK, (G)MSK and BPSK
- RX sensitivity: –123 dBm for 2-FSK(at 1.2 Kbit/s), –148 dBm for LoRa® (at 10.4 kHz, spreading factor 12)
- Transmitter high output power, programmable up to +22 dBm
- Transmitter low output power, programmable up to +15 dBm
- Compliant with the following radio frequency regulations such as ETSI EN 300 220, EN 300 113, EN 301 166, FCC CFR 47 Part 15, 24, 90, 101 and the Japanese ARIB STD-T30, T-67, T-108
- Compatible with standardized or proprietary protocols such as LoRaWAN®, Sigfox™, W-MBus and more (fully open wireless system-on-chip)
Core
- 32-bit Arm® Cortex®-M4 CPU
  - Adaptive real-time accelerator (ART Accelerator) allowing 0-wait-state execution from Flash memory, frequency up to 48 MHz, MPU and DSP instructions
  - 1.25 DMIPS/MHz (Dhrystone 2.1)
- 32-bit Arm®Cortex®-M0+ CPU
  - Frequency up to 48 MHz, MPU
  - 0.95 DMIPS/MHz (Dhrystone 2.1)
Security and identification
- Hardware encryption AES 256-bit
- True random number generator (RNG)
- Sector protection against read/write operations (PCROP, RDP, WRP)
- CRC calculation unit
- Unique device identifier (64-bit UID compliant with IEEE 802-2001 standard)
- 96-bit unique die identifier
- Hardware public key accelerator (PKA)
- Key management services
- Secure sub-GHz MAC layer
- Secure firmware update (SFU)
- Secure firmware install (SFI)
Supply and reset management
- High-efficiency embedded SMPS step-down converter
- SMPS to LDO smart switch
- Ultra-safe, low-power BOR (brownout reset) with 5 selectable thresholds
- Ultra-low-power POR/PDR
- Programmable voltage detector (PVD)
- VBAT mode with RTC and 20x32-byte backup registers
Clock sources
- 32 MHz crystal oscillator
- TCXO support: programmable supply voltage
- 32 kHz oscillator for RTC with calibration
- High-speed internal 16 MHz factory trimmed RC (± 1 %)
- Internal low-power 32 kHz RC
- Internal multi-speed low-power 100 kHz to 48 MHz RC
- PLL for CPU, ADC and audio clocks
Memories
- 256-Kbyte Flash memory
- 64-Kbyte RAM
- 20x32-bit backup register
- Bootloader supporting USART and SPI interfaces
- OTA (over-the-air) firmware update capable
- Sector protection against read/write operations
Rich analog peripherals (down to 1.62 V)
- 12-bit ADC 2.5 Msps, up to 16 bits with hardware oversampling, conversion range up to 3.6 V
- 12-bit DAC, low-power sample-and-hold
- 2x ultra-low-power comparators
System peripherals
- Mailbox and semaphores for communication between Cortex®-M4 and Cortex®-M0+ firmware
Controllers
- 2x DMA controller (7 channels each) supporting ADC, DAC, SPI, I2C, LPUART, USART, AES and timers
- 2x USART (ISO 7816, IrDA, SPI)
- 1x LPUART (low-power)
- 2x SPI 16 Mbit/s (1 over 2 supporting I2S)
- 3x I2C (SMBus/PMBus™)
- 2x 16-bit 1-channel timer
- 1x 16-bit 4-channel timer (supporting motor control)
- 1x 32-bit 4-channel timer
- 3x 16-bit ultra-low-power timer
- 1x RTC with 32-bit sub-second wakeup counter
- 1x independent SysTick
- 1x independent watchdog
- 1x window watchdog
Up to 43 I/Os, most 5 V-tolerant
Development support
- Serial-wire debug (SWD), JTAG
- Dual CPU cross trigger capabilities

More information about STM32WL55JC can be found here:

STM32WL55JC on www.st.com_
STM32WL55JC datasheet_
STM32WL55JC reference manual_

Supported Features

.. zephyr:board-supported-hw::

Connections and IOs

Nucleo WL55JC Board has 4 GPIO controllers. These controllers are responsible for pin muxing, input/output, pull-up, etc.

Default Zephyr Peripheral Mapping:

.. rst-class:: rst-columns

LPUART_1 TX/RX : PA3/PA2 (ST-Link Virtual Port Com)
I2C_2_SCL : PA12 (Arduino I2C)
I2C_2_SDA : PA11 (Arduino I2C)
SPI_1_NSS : PA4 (arduino_spi)
SPI_1_SCK : PA5 (arduino_spi)
SPI_1_MISO : PA6 (arduino_spi)
SPI_1_MOSI : PA7 (arduino_spi)
ADC1_IN5 : PB1 (Arduino pin A0)
DAC1_OUT1 : PA10 (Arduino pin A2)

System Clock

Nucleo WL55JC System Clock could be driven by internal or external oscillator, as well as main PLL clock. By default System clock is driven by HSE clock at 32MHz.

Serial Port

Nucleo WL55JC board has 2 (LP)U(S)ARTs. The Zephyr console output is assigned to LPUART_1. Default settings are 115200 8N1.

Programming and Debugging

.. zephyr:board-supported-runners::

Nucleo WL55JC board includes an STLINK-V3 embedded debug tool interface.

Applications for the nucleo_wl55jc board configuration can be built the usual way (see :ref:build_an_application).

Flashing

The board is configured to be flashed using west STM32CubeProgrammer_ runner, so its :ref:installation <stm32cubeprog-flash-host-tools> is required.

Alternatively, OpenOCD can also be used to flash the board using the --runner (or -r) option:

.. code-block:: console

$ west flash --runner openocd

Flashing an application to Nucleo WL55JC

Connect the Nucleo WL55JC to your host computer using the USB port. Then build and flash an application. Here is an example for the :zephyr:code-sample:hello_world application.

Run a serial host program to connect with your Nucleo board:

.. code-block:: console

$ minicom -D /dev/ttyUSB0

Then build and flash the application.

.. zephyr-app-commands:: :zephyr-app: samples/hello_world :board: nucleo_wl55jc :goals: build flash

You should see the following message on the console:

.. code-block:: console

Hello World! arm

.. Note:

Nucleo WL55JC board is provided with a stock firmware which demonstrates sleep mode. Unfortunately, default openocd configuration, which is debug compatible, doesn't allow flashing when SoC is in sleep mode. As a consequence, when flashing Nucleo WL55JC board over a stock firmware, please update board's openocd.cfg configuration file to select sleep mode compatible configuration.

Debugging

You can debug an application in the usual way. Here is an example for the :zephyr:code-sample:blinky application.

.. zephyr-app-commands:: :zephyr-app: samples/basic/blinky :board: nucleo_wl55jc :maybe-skip-config: :goals: debug

.. _Nucleo WL55JC website: https://www.st.com/en/evaluation-tools/nucleo-wl55jc.html

.. _STM32WL55JC on www.st.com: https://www.st.com/en/microcontrollers-microprocessors/stm32wl55jc.html

.. _STM32WL55JC datasheet: https://www.st.com/resource/en/datasheet/stm32wl55jc.pdf

.. _STM32WL55JC reference manual: https://www.st.com/resource/en/reference_manual/dm00451556-stm32wl5x-advanced-armbased-32bit-mcus-with-subghz-radio-solution-stmicroelectronics.pdf

.. _STM32CubeProgrammer: https://www.st.com/en/development-tools/stm32cubeprog.html