boards/st/b_l4s5i_iot01a/doc/index.rst
.. zephyr:board:: b_l4s5i_iot01a
Overview
The B_L4S5I_IOT01A Discovery kit features an ARM Cortex-M4 based STM32L4S5VI MCU with a wide range of connectivity support and configurations. Here are some highlights of the B_L4S5I_IOT01A Discovery kit:
STM32L4S5VIT6 microcontroller featuring 2 Mbyte of Flash memory, 640 Kbytes of RAM in LQFP100 package
On-board ST-LINK/V2-1 supporting USB re-enumeration capability
Three different interfaces supported on USB:
ARDUINO ® Uno V3 and Pmod TM expansion connector
4 LEDs (2 for user, wifi, BLE)
2 push-buttons (user and reset)
USB OTG FS with micro-AB connector
Dynamic NFC tag
2 digital omnidirectional microphones
Capacitive digital sensor for relative humidity and temperature
Time-of-flight and gesture-detection sensors
High-performance 3-axis magnetometer
3D accelerometer and 3D gyroscope
64-Mbit Quad-SPI Flash memory
Bluetooth ® 4.1 module
802.11 b/g/n compliant Wi‐Fi ® module
MCU current ammeter with 4 ranges and auto-calibration
Flexible power supply options:
More information about the board can be found at the B L4S5I IOT01A Discovery kit website_.
Hardware
The STM32L4S5VI SoC provides the following hardware features:
Ultra-low-power with FlexPowerControl (down to 130 nA Standby mode and 100 uA/MHz run mode)
Core: ARM® 32-bit Cortex®-M4 CPU with FPU, frequency up to 120 MHz, 100DMIPS/1.25DMIPS/MHz (Dhrystone 2.1)
Clock Sources:
RTC with HW calendar, alarms and calibration
Up to 21 capacitive sensing channels: support touchkey, linear and rotary touch sensors
16x timers:
Up to 83 fast I/Os, most 5 V-tolerant
Memories
4x digital filters for sigma delta modulator
Rich analog peripherals (independent supply)
18x communication interfaces
14-channel DMA controller with multiplex request router
True random number generator
CRC calculation unit, 96-bit unique ID
AES and HASH hardware accelerators
Development support: serial wire debug (SWD), JTAG, Embedded Trace Macrocell™
More information about STM32L4S5VI can be found here:
STM32L4S5VI on www.st.com_STM32L4S5 reference manual_.. zephyr:board-supported-hw::
B_L4S5I_IOT01A Discovery kit has 9 GPIO controllers (from A to I). These controllers are responsible for pin muxing, input/output, pull-up, etc.
For more details please refer to B L47S5I IOT01A board User Manual_.
B_L4S5I_IOT01A Discovery System Clock could be driven by an internal or external oscillator, as well as the main PLL clock. By default the System clock is driven by the PLL clock at 80MHz, driven by 16MHz high speed internal oscillator.
B_L4S5I_IOT01A Discovery kit has 4 U(S)ARTs. The Zephyr console output is assigned to UART1. Default settings are 115200 8N1.
Programming and Debugging
.. zephyr:board-supported-runners::
B_L4S5I_IOT01A Discovery kit includes an ST-LINK/V2-1 embedded debug tool interface.
The board is configured to be flashed using west STM32CubeProgrammer_ runner,
so its :ref:installation <stm32cubeprog-flash-host-tools> is required.
Alternatively, OpenOCD or JLink can also be used to flash the board using
the --runner (or -r) option:
.. code-block:: console
$ west flash --runner openocd $ west flash --runner jlink
Connect the B_L4S5I_IOT01A Discovery kit to your host computer using the USB port, then run a serial host program to connect with your Discovery board. For example:
.. code-block:: console
$ minicom -D /dev/ttyACM0
Then, build and flash in the usual way. Here is an example for the
:zephyr:code-sample:hello_world application.
.. zephyr-app-commands:: :zephyr-app: samples/hello_world :board: b_l4s5i_iot01a :goals: build flash
You should see the following message on the console:
.. code-block:: console
Hello World! arm
You can debug an application in the usual way. Here is an example for the
:zephyr:code-sample:hello_world application.
.. zephyr-app-commands:: :zephyr-app: samples/hello_world :board: b_l4s5i_iot01a :maybe-skip-config: :goals: debug
.. _B L4S5I IOT01A Discovery kit website: https://www.st.com/en/evaluation-tools/b-l4s5i-iot01a.html
.. _B L47S5I IOT01A board User Manual: https://www.st.com/resource/en/user_manual/dm00698410.pdf
.. _STM32L4S5VI on www.st.com: https://www.st.com/en/microcontrollers-microprocessors/stm32l4s5vi.html
.. _STM32L4S5 reference manual: https://www.st.com/resource/en/reference_manual/dm00310109.pdf
.. _STM32CubeProgrammer: https://www.st.com/en/development-tools/stm32cubeprog.html