RAK3372 WisBlock Core Module

Overview

The RAK3372 WisBlock Core module is a RAK3172 LoRa module with an expansion PCB and connectors compatible with the WisBlock Base. It allows an easy way to access the pins of the RAK3172 module, simplifying development and testing processes.

The module itself comprises a RAK3172 as its main component. The RAK3372 is based on the STM32WLE5CCU6 LoRa SoC transceiver chip. It features ultra-low power consumption of less than 2.0 uA during sleep mode with configurable high LoRa output RF power up to 22 dBm during transmission mode.

Hardware

Supported Features

The rak3372 board supports the hardware features listed below.

on-chip / on-board
Feature integrated in the SoC / present on the board.
2 / 2
Number of instances that are enabled / disabled.
Click on the label to see the first instance of this feature in the board/SoC DTS files.
vnd,foo
Compatible string for the Devicetree binding matching the feature.
Click on the link to view the binding documentation.

rak3372/stm32wle5xx target

On-target memory for this board target: 64 KiB of RAM, 256 KiB of Flash.

Type

Location

Description

Compatible

CPU

on-chip

ARM Cortex-M4 CPU1

arm,cortex-m4

ADC

on-chip

STM32 ADC1

st,stm32-adc

on-board

WisBlock ADC Channel Map1

wisblock-adc

Clock control

on-chip

STM32WL RCC (Reset and Clock controller)1

st,stm32wl-rcc

on-chip

STM32WL HSE Clock1

st,stm32wl-hse-clock

on-chip

Generic fixed-rate clock provider2

fixed-clock

on-chip

STM32 MSI Clock1

st,stm32-msi-clock

on-chip

STM32 LSE Clock1

st,stm32-lse-clock

on-chip

STM32WB and STM32WL PLL node1

st,stm32wb-pll-clock

on-chip

STM32 Microcontroller Clock Output (MCO)1

st,stm32-clock-mco

Counter

on-chip

STM32 counters4

st,stm32-counter

CRC

on-chip

STM32 CRC calculation unit1

st,stm32-crc

Cryptographic accelerator

on-chip

STM32 AES Accelerator1

st,stm32-aes

DAC

on-chip

STM32 family DAC1

st,stm32-dac

DMA

on-chip

STM32 DMA controller (V2)2

st,stm32-dma-v2

on-chip

STM32 DMAMUX controller1

st,stm32-dmamux

Flash controller

on-chip

STM32 Family flash controller1

st,stm32-flash-controller

GPIO & Headers

on-chip

STM32 GPIO Controller4

st,stm32-gpio

on-board

WisBlock I/O Slot Connector1

wisblock-io-slot

I2C

on-chip

STM32 I2C V2 controller3

st,stm32-i2c-v2

Interrupt controller

on-chip

ARMv7-M NVIC (Nested Vectored Interrupt Controller)1

arm,v7m-nvic

on-chip

STM32 External Interrupt Controller1

st,stm32-exti

LoRa

on-chip

STM32WL Sub-GHz Radio1

st,stm32wl-subghz-radio

Memory controller

on-chip

STM32 Battery Backed RAM1

st,stm32-bbram

MTD

on-chip

STM32 flash memory1

st,stm32-nv-flash

NVMEM

on-chip

Fixed layout for Non-Volatile memory1

fixed-layout

OTP memory

on-chip

STM32 embedded NVM OTP11

st,stm32-nvm-otp

Pin control

on-chip

STM32 Pin controller1

st,stm32-pinctrl

Power management

on-chip

STM32 power controller1

st,stm32-pwr

on-chip

STM32 wake-up lines controller1

st,stm32-pwr-wkupctrl

PWM

on-chip

STM32 PWM22

st,stm32-pwm

on-board

WisBlock PWM Channel Map1

wisblock-pwm

Reset controller

on-chip

STM32 Reset and Clock Control (RCC) Controller1

st,stm32-rcc-rctl

RNG

on-chip

STM32 Random Number Generator1

st,stm32-rng

RTC

on-chip

STM32 RTC1

st,stm32-rtc

Sensors

on-chip

STM32 quadrature decoder2

st,stm32-qdec

on-chip

STM32 family TEMP node for production calibrated sensors with two calibration temperatures1

st,stm32-temp-cal

on-chip

STM32 VREF+1

st,stm32-vref

on-chip

STM32 VBAT1

st,stm32-vbat

Serial controller

on-chip

STM32 USART11

st,stm32-usart

on-chip

STM32 LPUART1

st,stm32-lpuart

SMbus

on-chip

STM32 SMBus controller3

st,stm32-smbus

SPI

on-chip

STM32 SPI controller with embedded Rx and Tx FIFOs2

st,stm32-spi-fifo

on-chip

STM32 SUBGHZ SPI controller1

st,stm32-spi-subghz

Timer

on-chip

ARMv7-M System Tick1

arm,armv7m-systick

on-chip

STM32 timers22

st,stm32-timers

on-chip

STM32 low-power timer (LPTIM)1

st,stm32-lptim

Watchdog

on-chip

STM32 system window watchdog1

st,stm32-window-watchdog

on-chip

STM32 watchdog1

st,stm32-watchdog

Connections and IOs

The RAK3372 features a 40-pin header with various I/O interfaces for the WisBlock ecosystem. The pinout is as follows:

Used

Name

Pin

Pin

Name

Used

NC

VBAT

1

2

VBAT

NC

GND

GND

3

4

GND

GND

3V3

3V3

5

6

3V3

3V3

CH340_P / UART2

USB_P

7

8

USB_N

CH340_N / UART2

NC

VBUS

9

10

SW1

NC

NC (R10 unpopulated)

TXD0

11

12

RXD0

NC (R9 unpopulated)

RESET

RESET

13

14

LED1

PA0

PA1

LED2

15

16

LED3

NC

3V3

VDD

17

18

VDD

3V3

PA11 / I2C2_SDA

I2C1_SDA

19

20

I2C1_SCL

PA12 / I2C2_SCL

PB3 / ADC_VBAT

AIN0

21

22

AIN1

PB4 / ADC

BOOT

BOOT0

23

24

IO7

NC

PA4 / SPI1_CS

SPI_CS

25

26

SPI_CLK

PA5 / SPI1_SCK

PA6 / SPI1_MISO

SPI_MISO

27

28

SPI_MOSI

PA7 / SPI1_MOSI

PB5

IO1

29

30

IO2

PA8

PB12

IO3

31

32

IO4

PB2

PB6 / UART1_TX

TXD1

33

34

RXD1

PB7 / UART1_RX

PA10

I2C2_SDA

35

36

I2C2_SCL

PA9

PA15

IO5

37

38

IO6

NC

GND

GND

39

40

GND

GND

The module does not route IO6, IO7, TXD0 or RXD0: R3, R5, R9 and R10 are left unpopulated, and the SoM pins behind IO6 and IO7 carry I2C2 instead. A sensor slot that needs IO6, such as slot D on a base board, is therefore unavailable.

The console is usart2, wired on the module through R7 and R8 to the onboard CH340E USB-to-serial converter. The converter’s USB lines leave on WisBlock connector pins 7 and 8, and the module carries no USB jack of its own, so a WisBlock Base Board is needed to reach the console.

Connecting to a Baseboard

The module mounts on a WisBlock Base Board through the 40-pin WisBlock connector. See the RAK3372 datasheet [2] for the mounting orientation.

Programming and debugging

The rak3372 board supports the runners and associated west commands listed below.

flash debug rtt reset attach debugserver
jlink ✅ ✅ ✅ ✅ ✅ ✅
pyocd ✅ (default) ✅ (default) ✅ ✅ ✅ ✅
stm32cubeprogrammer ✅

Building & Flashing

# From the root of the zephyr repository
west build -b rak3372 --shield rakwireless_rak19007 samples/basic/blinky
west flash

Debugging

You can debug an application in the usual way. Here is an example for the Hello World application.

# From the root of the zephyr repository
west build -b rak3372 --shield rakwireless_rak19007 samples/hello_world
west debug

References