Skip to content

Commit 5675509

Browse files
superna9999superna9999
committed
boards: arm: Add support for Nucleo L432KC
Add configuration, dts and documentation for the Nucleo L432KC board based on the STM32L432KC SoC. Signed-off-by: Neil Armstrong <[email protected]>
1 parent b0de4a3 commit 5675509

File tree

11 files changed

+392
-0
lines changed

11 files changed

+392
-0
lines changed

‎boards/arm/nucleo_l432kc/Kconfig.board‎

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,11 @@
1+
# Kconfig - STM32L432KC Nucleo board configuration
2+
#
3+
# Copyright (c) 2016 Open-RnD Sp. z o.o.
4+
# Copyright (c) 2016 BayLibre, SAS
5+
#
6+
# SPDX-License-Identifier: Apache-2.0
7+
#
8+
9+
config BOARD_NUCLEO_L432KC
10+
bool "Nucleo L432KC Development Board"
11+
depends on SOC_STM32L432XX

‎boards/arm/nucleo_l432kc/Kconfig.defconfig‎

Lines changed: 14 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,14 @@
1+
# Kconfig - STM32L432KC Nucleo board configuration
2+
#
3+
# Copyright (c) 2016 Open-RnD Sp. z o.o.
4+
# Copyright (c) 2016 BayLibre, SAS
5+
#
6+
# SPDX-License-Identifier: Apache-2.0
7+
#
8+
9+
if BOARD_NUCLEO_L432KC
10+
11+
config BOARD
12+
default nucleo_l432kc
13+
14+
endif # BOARD_NUCLEO_L432KC

‎boards/arm/nucleo_l432kc/Makefile‎

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,2 @@
1+
# No C files (yet)
2+
obj- += dummy.o

‎boards/arm/nucleo_l432kc/board.h‎

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,21 @@
1+
/*
2+
* Copyright (c) 2015 Intel Corporation
3+
* Copyright (c) 2017 Linaro Limited.
4+
*
5+
* SPDX-License-Identifier: Apache-2.0
6+
*/
7+
8+
#ifndef __INC_BOARD_H
9+
#define __INC_BOARD_H
10+
11+
#include <soc.h>
12+
13+
/* LD3 green LED */
14+
#define LD3_GPIO_PORT "GPIOB"
15+
#define LD3_GPIO_PIN 3
16+
17+
/* Create aliases to make the basic samples work */
18+
#define LED0_GPIO_PORT LD3_GPIO_PORT
19+
#define LED0_GPIO_PIN LD3_GPIO_PIN
20+
21+
#endif /* __INC_BOARD_H */

‎boards/arm/nucleo_l432kc/doc/img/nucleo32_ulp_logo.jpg‎

13.5 KB
Loading

‎boards/arm/nucleo_l432kc/doc/img/nucleo_l432kc_arduino_nano.png‎

509 KB
Loading

‎boards/arm/nucleo_l432kc/doc/nucleol432kc.rst‎

Lines changed: 237 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,237 @@
1+
.. _nucleo_l432kc_board:
2+
3+
ST Nucleo L432KC
4+
################
5+
6+
Overview
7+
********
8+
9+
The Nucleo L432KC board features an ARM Cortex-M4 based STM32L432KC MCU
10+
with a wide range of connectivity support and configurations. Here are
11+
some highlights of the Nucleo L432KC board:
12+
13+
- STM32 microcontroller in UFQFPN32 package
14+
- Arduino Uno V3 connectivity
15+
- On-board ST-LINK/V2-1 debugger/programmer with SWD connector
16+
- Flexible board power supply:
17+
18+
- USB VBUS or external source(3.3V, 5V, 7 - 12V)
19+
- Power management access point
20+
21+
- Three LEDs: USB communication (LD1), user LED (LD2), power LED (LD3)
22+
- One push-button: RESET
23+
24+
.. image:: img/nucleo32_ulp_logo.jpg
25+
:width: 250px
26+
:align: center
27+
:height: 188px
28+
:alt: Nucleo L432KC
29+
30+
More information about the board can be found at the `Nucleo L432KC website`_.
31+
32+
Hardware
33+
********
34+
35+
The STM32L432KC SoC provides the following hardware IPs:
36+
37+
- Ultra-low-power with FlexPowerControl (down to 28 nA Standby mode and 84 μA/MHz run mode)
38+
- Core: ARM® 32-bit Cortex®-M4 CPU with FPU, frequency up to 80 MHz, 100DMIPS/1.25DMIPS/MHz (Dhrystone 2.1)
39+
- Clock Sources:
40+
41+
- 32 kHz crystal oscillator for RTC (LSE)
42+
- Internal 16 MHz factory-trimmed RC (±1%)
43+
- Internal low-power 32 kHz RC (±5%)
44+
- Internal multispeed 100 kHz to 48 MHz oscillator, auto-trimmed by LSE (better than ±0.25 % accuracy)
45+
- 2 PLLs for system clock, USB, audio, ADC
46+
47+
- RTC with HW calendar, alarms and calibration
48+
- Up to 3 capacitive sensing channels: support touchkey, linear and rotary touch sensors
49+
- 11x timers:
50+
51+
- 1x 16-bit advanced motor-control
52+
- 1x 32-bit and 2x 16-bit general purpose
53+
- 2x 16-bit basic
54+
- 2x low-power 16-bit timers (available in Stop mode)
55+
- 2x watchdogs
56+
- SysTick timer
57+
58+
- Up to 26 fast I/Os, most 5 V-tolerant
59+
- Memories
60+
61+
- Up to 256 KB single bank Flash, proprietary code readout protection
62+
- Up to 64 KB of SRAM including 16 KB with hardware parity check
63+
- Quad SPI memory interface
64+
65+
- Rich analog peripherals (independent supply)
66+
67+
- 1× 12-bit ADC 5 MSPS, up to 16-bit with hardware oversampling, 200 μA/MSPS
68+
- 2x 12-bit DAC, low-power sample and hold
69+
- 1x operational amplifiers with built-in PGA
70+
- 2x ultra-low-power comparators
71+
72+
- 13x communication interfaces
73+
74+
- USB OTG 2.0 full-speed crystal less solution with LPM and BCD
75+
- 1x SAIs (serial audio interface)
76+
- 2x I2C FM+(1 Mbit/s), SMBus/PMBus
77+
- 3x USARTs (ISO 7816, LIN, IrDA, modem)
78+
- 2x SPIs (3x SPIs with the Quad SPI)
79+
- CAN (2.0B Active)
80+
- SWPMI single wire protocol master I/F
81+
- IRTIM (Infrared interface)
82+
83+
- 14-channel DMA controller
84+
- True random number generator
85+
- CRC calculation unit, 96-bit unique ID
86+
- Development support: serial wire debug (SWD), JTAG, Embedded Trace Macrocell™
87+
88+
89+
More information about STM32L432KC can be found here:
90+
- `STM32L432KC on www.st.com`_
91+
- `STM32L432 reference manual`_
92+
93+
Supported Features
94+
==================
95+
96+
The Zephyr nucleo_l432kc board configuration supports the following hardware features:
97+
98+
+-----------+------------+-------------------------------------+
99+
| Interface | Controller | Driver/Component |
100+
+===========+============+=====================================+
101+
| NVIC | on-chip | nested vector interrupt controller |
102+
+-----------+------------+-------------------------------------+
103+
| UART | on-chip | serial port-polling; |
104+
| | | serial port-interrupt |
105+
+-----------+------------+-------------------------------------+
106+
| PINMUX | on-chip | pinmux |
107+
+-----------+------------+-------------------------------------+
108+
| GPIO | on-chip | gpio |
109+
+-----------+------------+-------------------------------------+
110+
| I2C | on-chip | i2c |
111+
+-----------+------------+-------------------------------------+
112+
| PWM | on-chip | pwm |
113+
+-----------+------------+-------------------------------------+
114+
115+
Other hardware features are not yet supported on this Zephyr port.
116+
117+
The default configuration can be found in the defconfig file:
118+
119+
``boards/arm/nucleo_l432kc/nucleo_l432kc_defconfig``
120+
121+
122+
Connections and IOs
123+
===================
124+
125+
Nucleo L432KC Board has 6 GPIO controllers. These controllers are responsible for pin muxing,
126+
input/output, pull-up, etc.
127+
128+
Available pins:
129+
---------------
130+
.. image:: img/nucleo_l432kc_arduino_nano.png
131+
:width: 960px
132+
:align: center
133+
:height: 720px
134+
:alt: Nucleo L432KC Arduino connectors
135+
136+
For mode details please refer to `STM32 Nucleo-32 board User Manual`_.
137+
138+
Default Zephyr Peripheral Mapping:
139+
----------------------------------
140+
141+
- UART_1_TX : PA9
142+
- UART_1_RX : PA10
143+
- UART_2_TX : PA2
144+
- UART_2_RX : PA3
145+
- I2C_1_SCL : PB6
146+
- I2C_1_SDA : PB7
147+
- PWM_2_CH1 : PA0
148+
- LD3 : PB3
149+
150+
System Clock
151+
------------
152+
153+
Nucleo L432KC System Clock could be driven by internal or external oscillator,
154+
as well as main PLL clock. By default System clock is driven by PLL clock at 80MHz,
155+
driven by 16MHz high speed internal oscillator.
156+
157+
Serial Port
158+
-----------
159+
160+
Nucleo L432KC board has 3 U(S)ARTs. The Zephyr console output is assigned to UART2.
161+
Default settings are 115200 8N1.
162+
163+
164+
Programming and Debugging
165+
*************************
166+
167+
Flashing
168+
========
169+
170+
Nucleo L432KC board includes an ST-LINK/V2-1 embedded debug tool interface.
171+
This interface is not supported by the openocd version 0.9 included by the Zephyr SDK v0.9.
172+
Until we update the Zephyr SDK, use openocd v0.10.0 from the openocd-stm32 project on GitHub
173+
to get the minimum set of scripts needed to flash and debug STM32 development boards.
174+
175+
.. code-block:: console
176+
177+
$ git clone https://github.com/erwango/openocd-stm32.git
178+
179+
Then follow instructions in README.md
180+
181+
182+
Flashing an application to Nucleo L432KC
183+
----------------------------------------
184+
185+
The sample application :ref:`hello_world` is being used in this tutorial:
186+
187+
To build the Zephyr kernel and application, enter:
188+
189+
.. code-block:: console
190+
191+
$ cd <zephyr_root_path>
192+
$ source zephyr-env.sh
193+
$ cd $ZEPHYR_BASE/samples/hello_world/
194+
$ make BOARD=nucleo_l432kc
195+
196+
Connect the Nucleo L432KC to your host computer using the USB port.
197+
Then, enter the following command:
198+
199+
.. code-block:: console
200+
201+
$ cd <openocd-stm32_path>
202+
$ stm32_flsh l4 $ZEPHYR_BASE/samples/hello_world/outdir/nucleo_l432kc/zephyr.bin
203+
204+
Run a serial host program to connect with your Nucleo board.
205+
206+
.. code-block:: console
207+
208+
$ minicom -D /dev/ttyACM0
209+
210+
You should see the following message:
211+
212+
.. code-block:: console
213+
214+
$ Hello World! arm
215+
216+
217+
Debugging
218+
=========
219+
220+
Access gdb with the following make command:
221+
222+
.. code-block:: console
223+
224+
$ cd <openocd-stm32_path>
225+
$ stm32_dbg l4 $ZEPHYR_BASE/samples/hello_world/outdir/nucleo_l432kc/zephyr.elf
226+
227+
.. _Nucleo L432KC website:
228+
http://www.st.com/en/evaluation-tools/nucleo-l432kc.html
229+
230+
.. _STM32 Nucleo-32 board User Manual:
231+
http://www.st.com/resource/en/user_manual/dm00231744.pdf
232+
233+
.. _STM32L432KC on www.st.com:
234+
http://www.st.com/en/microcontrollers/stm32l432kc.html
235+
236+
.. _STM32L432 reference manual:
237+
http://www.st.com/resource/en/reference_manual/dm00151940.pdf

‎boards/arm/nucleo_l432kc/nucleo_l432kc_defconfig‎

Lines changed: 55 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,55 @@
1+
CONFIG_ARM=y
2+
CONFIG_BOARD_STM32_NUCLEO_L432KC=y
3+
CONFIG_SOC_FAMILY_STM32=y
4+
CONFIG_SOC_SERIES_STM32L4X=y
5+
CONFIG_SOC_STM32L432XX=y
6+
CONFIG_CORTEX_M_SYSTICK=y
7+
# 80MHz system clock
8+
CONFIG_SYS_CLOCK_HW_CYCLES_PER_SEC=80000000
9+
10+
# enable uart driver
11+
CONFIG_SERIAL=y
12+
CONFIG_UART_STM32=y
13+
CONFIG_UART_STM32_PORT_2=y
14+
15+
# enable pinmux
16+
CONFIG_PINMUX=y
17+
CONFIG_PINMUX_STM32=y
18+
19+
# enable GPIOs
20+
CONFIG_GPIO=y
21+
CONFIG_GPIO_STM32=y
22+
CONFIG_GPIO_STM32_PORTA=y
23+
CONFIG_GPIO_STM32_PORTB=y
24+
CONFIG_GPIO_STM32_PORTC=y
25+
CONFIG_GPIO_STM32_PORTH=y
26+
27+
# clock configuration
28+
CONFIG_CLOCK_CONTROL=y
29+
CONFIG_CLOCK_CONTROL_STM32_CUBE=y
30+
# SYSCLK selection
31+
CONFIG_CLOCK_STM32_SYSCLK_SRC_PLL=y
32+
# PLL configuration
33+
CONFIG_CLOCK_STM32_PLL_SRC_HSI
34+
# produce 80MHz clock at PLL output
35+
CONFIG_CLOCK_STM32_PLL_M_DIVISOR=1
36+
CONFIG_CLOCK_STM32_PLL_N_MULTIPLIER=20
37+
CONFIG_CLOCK_STM32_PLL_P_DIVISOR=7
38+
CONFIG_CLOCK_STM32_PLL_Q_DIVISOR=2
39+
CONFIG_CLOCK_STM32_PLL_R_DIVISOR=4
40+
CONFIG_CLOCK_STM32_AHB_PRESCALER=1
41+
CONFIG_CLOCK_STM32_APB1_PRESCALER=1
42+
CONFIG_CLOCK_STM32_APB2_PRESCALER=1
43+
44+
# console
45+
CONFIG_CONSOLE=y
46+
CONFIG_UART_CONSOLE=y
47+
CONFIG_UART_CONSOLE_ON_DEV_NAME="UART_2"
48+
49+
#enable pwm
50+
CONFIG_PWM=y
51+
CONFIG_PWM_STM32=y
52+
CONFIG_PWM_STM32_2=y
53+
54+
#enable DTS
55+
CONFIG_HAS_DTS=y

‎dts/arm/Makefile‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -8,6 +8,7 @@ dtb-$(CONFIG_BOARD_HEXIWEAR_KW40Z) = hexiwear_kw40z.dts_compiled
88
dtb-$(CONFIG_BOARD_CC3200_LAUNCHXL) = cc3200_launchxl.dts_compiled
99
dtb-$(CONFIG_BOARD_CC3220SF_LAUNCHXL) = cc3220sf_launchxl.dts_compiled
1010
dtb-$(CONFIG_BOARD_NUCLEO_L476RG) = nucleo_l476rg.dts_compiled
11+
dtb-$(CONFIG_BOARD_NUCLEO_L432KC) = nucleo_l432kc.dts_compiled
1112
dtb-$(CONFIG_BOARD_V2M_BEETLE) = v2m_beetle.dts_compiled
1213
dtb-$(CONFIG_BOARD_OLIMEXINO_STM32) = olimexino_stm32.dts_compiled
1314
dtb-$(CONFIG_BOARD_96B_CARBON) = 96b_carbon.dts_compiled

‎dts/arm/nucleo_l432kc.dts‎

Lines changed: 24 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,24 @@
1+
/*
2+
* Copyright (c) 2017 Linaro Limited
3+
*
4+
* SPDX-License-Identifier: Apache-2.0
5+
*/
6+
7+
/dts-v1/;
8+
#include <st/stm32l432.dtsi>
9+
10+
/ {
11+
model = "STMicroelectronics STM32L432KC-NUCLEO board";
12+
compatible = "st,stm32l432kc-nucleo", "st,stm32l432";
13+
14+
chosen {
15+
zephyr,console = &usart2;
16+
zephyr,sram = &sram0;
17+
zephyr,flash = &flash0;
18+
};
19+
};
20+
21+
&usart2 {
22+
current-speed = <115200>;
23+
status = "ok";
24+
};

0 commit comments

Comments
 (0)