ST Nucleo WL55JC
The Nucleo-WL55JC is a development board for the STM32WL55 SoC from ST. It features 64 I/O, 3 onboard LEDs and buttons, integrated stlink for easy debug and flashing and on-board LoRa receiver with external antenna. NSH can be easily access via virtual serial port from usb.
Features
STM32WL55JC MCU, 256K FLASH, 64K SRAM
32768 Hz LSE crystal
32 MHz HSE crystal
Embedded stlink-v3 debugger (debug/flash and virtual serial port)
Reset button
3 user programmable LEDs
3 user programmable buttons
Power indicator LED
LoRa radio with antenna
64 Nucleo I/O
Arduino compatible pinout
Pin Mapping
Pin mapping can be altered by (de)soldering bridges, by default board uses following mapping:
Pin |
Signal |
Notes |
---|---|---|
PA2 |
LPUART1 TX |
Virtual serial port over usb |
PA3 |
LPUART2 RX |
Virtual serial port over usb |
PB6 |
USART1 TX |
D1 on Arduino pinout |
PB7 |
USART1 RX |
R0 on Arduino pinout |
PA0 |
Button 1 |
|
PA1 |
Button 2 |
|
PC6 |
Button 3 |
|
PB15 |
Blue LED |
Active HIGH |
PB11 |
Red LED |
Active HIGH |
PB9 |
Green LED |
Active HIGH |
Default Peripherals Configuration
LED
Green and Red LEDs are used by the system at boot to show system state. Once system is booted these LEDs are for user to control. When CONFIG_ARCH_LEDS is set, Blue LED is reserved by OS for reporting system status. When CONFIG_ARCH_LEDS is not set, OS state won’t be reported on any of the LEDs and all 3 LEDs are available for user right from the start.
Serial Console
There are 2 serial ports - USART1 and LPUART1.
USART1 is connected to arduino D0/D1 pin and LPUART is connected to stlink that provides virtual serial port.
NSH is configured to use LPUART and virtual serial port. After flashing you can open /dev/ttyACM0 (may change depending on your system) and nsh prompt will be waiting for you there. Serial device does not disappear when flashing and resetting board - it can be left opened and flashing will work without problems.
Configurations
nsh
Basic NuttShell configuration (console enabled in LPUART1, exposed via USB connection, at 115200 bps 8n1).
demo
This configuration contains demonstration code and programs to show what board is capable of. These programs and settings are usually absolutely useless in production code and are here just to show, by example, what you can do with the board.
Flash & Debug
Both flashing and debugging are done using the embedded stlink-v3 debugger. OpenOCD can be invoked in the following way to flash:
openocd -f interface/stlink.cfg -f target/stm32wlx.cfg \
-c "program nuttx.bin exit 0x08000000"
To debug attach openocd to stlink with command:
openocd -f interface/stlink.cfg -f target/stm32wlx.cfg
start gdb:
arm-none-eabi-gdb ./nuttx --tui
attach to gdb server:
target remote localhost:3333
(optionally) reset program and start from the very beginning:
monitor reset halt
Remember to generate debug symbol by setting CONFIG_DEBUG_SYMBOLS and optionally (for more natural flow in gdb step) suppress optimization by setting CONFIG_DEBUG_NOOPT.