1.. zephyr:board:: rak3172
2
3Overview
4********
5
6RAK3172 is a WisDuo LPWAN module which integrating a STM32WLE5CC chip.
7The breakout board has the RAK3172 as its core and with soldered to the
8antenna connector.
9
10Hardware
11********
12
13The breakout board footprint allows RAK3172 stamp module pins to be transferred to 2.54 mm headers.
14It is designed to easy access to the pins on the board and simplify the evaluation of the RAK3172
15module.
16
17- RAK3172 STM32WLE5CC Module with LPWAN single-core Cortex®-M4 at 48 MHz
18- 256-Kbyte Flash memory and 64-Kbyte SRAM
19- RF transceiver LoRa® modulations
20- Hardware encryption AES256-bit and a True random number generator
21- SMA connectors for the LORA antenna
22- I/O ports:
23
24   - UART
25   - I2C
26   - SPI
27   - SWD
28
29.. image:: img/pinout.webp
30   :align: center
31   :alt: RAK3172-pinout
32
33For more information about the RAK3172 stamp module:
34
35- `WisDuo RAK3172 Website`_
36- `STM32WLE5CC on www.st.com`_
37
38Supported Features
39==================
40
41.. zephyr:board-supported-hw::
42
43Programming and Debugging
44=========================
45
46.. zephyr:board-supported-runners::
47
48The RAK3172 board can be debugged and flashed with an external debug probe connected
49to the SWD pins.
50It can also be flashed via `pyOCD`_, but have to install an additional pack to support STM32WL.
51
52.. code-block:: console
53
54   $ pyocd pack --update
55   $ pyocd pack --install stm32wl
56
57Flashing an application
58-----------------------
59
60Connect the board to your host computer and build and flash an application.
61The sample application :zephyr:code-sample:`hello_world` is used for this example.
62Build the Zephyr kernel and application, then flash it to the device:
63
64.. zephyr-app-commands::
65   :zephyr-app: samples/hello_world
66   :board: rak3172
67   :goals: build flash
68
69Run a serial terminal to connect with your board. By default, ``usart1`` is
70accessible via the USB to TTL converter.
71
72- Speed: 115200
73- Data: 8 bits
74- Parity: None
75- Stop bits: 1
76
77.. code-block:: console
78
79   Hello World! rak3172/stm32wle5xx
80
81References
82**********
83
84.. target-notes::
85
86.. _WisDuo RAK3172 Website:
87   https://docs.rakwireless.com/Product-Categories/WisDuo/RAK3172-Module/Overview/#product-description
88
89.. _STM32WLE5CC on www.st.com:
90   https://www.st.com/en/microcontrollers-microprocessors/stm32wle5cc.html
91
92.. _pyOCD:
93   https://github.com/pyocd/pyOCD
94