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 |
|
ADC |
on-chip |
STM32 ADC1 |
|
on-board |
WisBlock ADC Channel Map1 |
||
Clock control |
on-chip |
STM32WL RCC (Reset and Clock controller)1 |
|
on-chip |
STM32WL HSE Clock1 |
||
on-chip |
Generic fixed-rate clock provider2 |
||
on-chip |
STM32 MSI Clock1 |
||
on-chip |
STM32 LSE Clock1 |
||
on-chip |
STM32WB and STM32WL PLL node1 |
||
on-chip |
STM32 Microcontroller Clock Output (MCO)1 |
||
Counter |
on-chip |
STM32 counters4 |
|
CRC |
on-chip |
STM32 CRC calculation unit1 |
|
Cryptographic accelerator |
on-chip |
STM32 AES Accelerator1 |
|
DAC |
on-chip |
STM32 family DAC1 |
|
DMA |
on-chip |
STM32 DMA controller (V2)2 |
|
on-chip |
STM32 DMAMUX controller1 |
||
Flash controller |
on-chip |
STM32 Family flash controller1 |
|
GPIO & Headers |
on-chip |
STM32 GPIO Controller4 |
|
on-board |
WisBlock I/O Slot Connector1 |
||
I2C |
on-chip |
STM32 I2C V2 controller3 |
|
Interrupt controller |
on-chip |
ARMv7-M NVIC (Nested Vectored Interrupt Controller)1 |
|
on-chip |
STM32 External Interrupt Controller1 |
||
LoRa |
on-chip |
STM32WL Sub-GHz Radio1 |
|
Memory controller |
on-chip |
STM32 Battery Backed RAM1 |
|
MTD |
on-chip |
STM32 flash memory1 |
|
NVMEM |
on-chip |
Fixed layout for Non-Volatile memory1 |
|
OTP memory |
on-chip |
||
Pin control |
on-chip |
STM32 Pin controller1 |
|
Power management |
on-chip |
STM32 power controller1 |
|
on-chip |
STM32 wake-up lines controller1 |
||
PWM |
on-chip |
||
on-board |
WisBlock PWM Channel Map1 |
||
Reset controller |
on-chip |
STM32 Reset and Clock Control (RCC) Controller1 |
|
RNG |
on-chip |
STM32 Random Number Generator1 |
|
RTC |
on-chip |
STM32 RTC1 |
|
Sensors |
on-chip |
STM32 quadrature decoder2 |
|
on-chip |
STM32 family TEMP node for production calibrated sensors with two calibration temperatures1 |
||
on-chip |
STM32 VREF+1 |
||
on-chip |
STM32 VBAT1 |
||
Serial controller |
on-chip |
||
on-chip |
STM32 LPUART1 |
||
SMbus |
on-chip |
STM32 SMBus controller3 |
|
SPI |
on-chip |
STM32 SPI controller with embedded Rx and Tx FIFOs2 |
|
on-chip |
STM32 SUBGHZ SPI controller1 |
||
Timer |
on-chip |
ARMv7-M System Tick1 |
|
on-chip |
|||
on-chip |
STM32 low-power timer (LPTIM)1 |
||
Watchdog |
on-chip |
STM32 system window watchdog1 |
|
on-chip |
STM32 watchdog1 |
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