1.. _disco_l475_iot1_board:
2
3ST Disco L475 IOT01 (B-L475E-IOT01A)
4####################################
5
6Overview
7********
8
9The B-L475E-IOT01A Discovery kit for IoT node allows users to develop
10applications with direct connection to cloud servers.
11The Discovery kit enables a wide diversity of applications by exploiting
12low-power communication, multiway sensing and ARM |reg| Cortex |reg|-M4 core-based
13STM32L4 Series features.
14
15This kit provides:
16
17- 64-Mbit Quad-SPI (Macronix) Flash memory
18- Bluetooth |reg| V4.1 module (SPBTLE-RF)
19- Sub-GHz (868 or 915 MHz) low-power-programmable RF module (SPSGRF-868 or SPSGRF-915)
20- Wi-Fi |reg| module Inventek ISM43362-M3G-L44 (802.11 b/g/n compliant)
21- Dynamic NFC tag based on M24SR with its printed NFC antenna
22- 2 digital omni-directional microphones (MP34DT01)
23- Capacitive digital sensor for relative humidity and temperature (HTS221)
24- High-performance 3-axis magnetometer (LIS3MDL)
25- 3D accelerometer and 3D gyroscope (LSM6DSL)
26- 260-1260 hPa absolute digital output barometer (LPS22HB)
27- Time-of-Flight and gesture-detection sensor (VL53L0X)
28- 2 push-buttons (user and reset)
29- USB OTG FS with Micro-AB connector
30- Expansion connectors:
31        - Arduino |trade| Uno V3
32        - PMOD
33- Flexible power-supply options:
34        - ST LINK USB VBUS or external sources
35- On-board ST-LINK/V2-1 debugger/programmer with USB re-enumeration capability:
36        - mass storage, virtual COM port and debug port
37
38
39.. image:: img/disco_l475_iot1.jpg
40     :align: center
41     :alt: Disco L475 IoT1
42
43More information about the board can be found at the `Disco L475 IoT1 website`_.
44
45Hardware
46********
47
48The STM32L475VG SoC provides the following hardware IPs:
49
50- Ultra-low-power with FlexPowerControl (down to 120 nA Standby mode and 100 uA/MHz run mode)
51- Core: ARM |reg| 32-bit Cortex |reg|-M4 CPU with FPU, frequency up to 80 MHz, 100DMIPS/1.25DMIPS/MHz (Dhrystone 2.1)
52- Clock Sources:
53        - 4 to 48 MHz crystal oscillator
54        - 32 kHz crystal oscillator for RTC (LSE)
55        - Internal 16 MHz factory-trimmed RC ( |plusminus| 1%)
56        - Internal low-power 32 kHz RC ( |plusminus| 5%)
57        - Internal multispeed 100 kHz to 48 MHz oscillator, auto-trimmed by
58          LSE (better than |plusminus| 0.25 % accuracy)
59        - 3 PLLs for system clock, USB, audio, ADC
60- RTC with HW calendar, alarms and calibration
61- Up to 24 capacitive sensing channels: support touchkey, linear and rotary touch sensors
62- 16x timers:
63        - 2x 16-bit advanced motor-control
64        - 2x 32-bit and 5x 16-bit general purpose
65        - 2x 16-bit basic
66        - 2x low-power 16-bit timers (available in Stop mode)
67        - 2x watchdogs
68        - SysTick timer
69- Up to 114 fast I/Os, most 5 V-tolerant, up to 14 I/Os with independent supply down to 1.08 V
70- Memories
71        - Up to 1 MB Flash, 2 banks read-while-write, proprietary code readout protection
72        - Up to 128 KB of SRAM including 32 KB with hardware parity check
73        - External memory interface for static memories supporting SRAM, PSRAM, NOR and NAND memories
74        - Quad SPI memory interface
75- 4x digital filters for sigma delta modulator
76- Rich analog peripherals (independent supply)
77        - 2x 12-bit ADC 5 MSPS, up to 16-bit with hardware oversampling, 200 uA/MSPS
78        - 2x 12-bit DAC, low-power sample and hold
79        - 2x operational amplifiers with built-in PGA
80        - 2x ultra-low-power comparators
81- 18x communication interfaces
82        - USB OTG 2.0 full-speed, LPM and BCD
83        - 2x SAIs (serial audio interface)
84        - 3x I2C FM+(1 Mbit/s), SMBus/PMBus
85        - 6x USARTs (ISO 7816, LIN, IrDA, modem)
86        - 3x SPIs (4x SPIs with the Quad SPI)
87        - CAN (2.0B Active) and SDMMC interface
88        - SWPMI single wire protocol master I/F
89- 14-channel DMA controller
90- True random number generator
91- CRC calculation unit, 96-bit unique ID
92- Development support: serial wire debug (SWD), JTAG, Embedded Trace Macrocell |trade|
93
94
95More information about STM32L475VG can be found here:
96       - `STM32L475VG on www.st.com`_
97       - `STM32L475 reference manual`_
98
99Supported Features
100==================
101
102The Zephyr Disco L475 IoT board configuration supports the following hardware features:
103
104+-----------+------------+-------------------------------------+
105| Interface | Controller | Driver/Component                    |
106+===========+============+=====================================+
107| NVIC      | on-chip    | nested vector interrupt controller  |
108+-----------+------------+-------------------------------------+
109| UART      | on-chip    | serial port-polling;                |
110|           |            | serial port-interrupt               |
111+-----------+------------+-------------------------------------+
112| PINMUX    | on-chip    | pinmux                              |
113+-----------+------------+-------------------------------------+
114| GPIO      | on-chip    | gpio                                |
115+-----------+------------+-------------------------------------+
116| FLASH     | on-chip    | flash memory                        |
117+-----------+------------+-------------------------------------+
118| I2C       | on-chip    | i2c                                 |
119+-----------+------------+-------------------------------------+
120| SPI       | on-chip    | spi                                 |
121+-----------+------------+-------------------------------------+
122| PWM       | on-chip    | pwm                                 |
123+-----------+------------+-------------------------------------+
124| WATCHDOG  | on-chip    | independent watchdog                |
125+-----------+------------+-------------------------------------+
126| DAC       | on-chip    | DAC Controller                      |
127+-----------+------------+-------------------------------------+
128| ADC       | on-chip    | adc                                 |
129+-----------+------------+-------------------------------------+
130| QSPI NOR  | on-chip    | off-chip flash                      |
131+-----------+------------+-------------------------------------+
132| die-temp  | on-chip    | die temperature sensor              |
133+-----------+------------+-------------------------------------+
134| RTC       | on-chip    | rtc                                 |
135+-----------+------------+-------------------------------------+
136
137Other hardware features are not yet supported on this Zephyr port.
138
139The default configuration can be found in the defconfig file:
140
141	:zephyr_file:`boards/st/disco_l475_iot1/disco_l475_iot1_defconfig`
142
143
144Connections and IOs
145===================
146
147Disco L475 IoT Board has 8 GPIO controllers. These controllers are responsible for pin muxing,
148input/output, pull-up, etc.
149
150Note that LED LD1 and SPI1 SCK use the same GPIO pin and cannot be used simultaneously.
151
152Available pins:
153---------------
154
155For detailed information about available pins please refer to `STM32 Disco L475 IoT1 board User Manual`_.
156
157Default Zephyr Peripheral Mapping:
158----------------------------------
159
160- UART_1 TX/RX : PB6/PB7 (ST-Link Virtual Port Com)
161- UART_4 TX/RX : PA0/PA1 (Arduino Serial)
162- I2C1 SCL/SDA : PB8/PB9 (Arduino I2C)
163- I2C2 SCL/SDA : PB10/PB11 (Sensor I2C bus)
164- I2C3 SCL/SDA : PC0/PC1
165- SPI1 NSS/SCK/MISO/MOSI : PA2/PA5/PA6/PA7 (Arduino SPI)
166- SPI3 SCK/MISO/MOSI : PC10/PC11/PC12 (BT SPI bus)
167- PWM_2_CH1 : PA15
168- PWM_15_CH1 : PB14 (LD2)
169- USER_PB : PC13
170- LD1 : PA5 (same as SPI1 SCK)
171- LD2 : PB14
172- ADC12_IN5 : PA0
173- ADC123_IN3 : PC2
174- ADC123_IN4 : PC3
175- ADC12_IN13 : PC4
176- ADC12_IN14 : PC5
177- DAC1_OUT1 : PA4
178
179System Clock
180------------
181
182Disco L475 IoT System Clock could be driven by internal or external oscillator,
183as well as main PLL clock. By default System clock is driven by PLL clock at 80MHz,
184driven by 16MHz high speed internal oscillator.
185
186Serial Port
187-----------
188
189Disco L475 IoT board has 6 U(S)ARTs. The Zephyr console output is assigned to UART1.
190Default settings are 115200 8N1.
191
192
193Programming and Debugging
194*************************
195
196Applications for the ``disco_l475_iot1`` board configuration can be built and
197flashed in the usual way (see :ref:`build_an_application` and
198:ref:`application_run` for more details).
199
200Flashing
201========
202
203Disco L475 IoT board includes an ST-LINK/V2-1 embedded debug tool
204interface.  This interface is supported by the openocd version
205included in the Zephyr SDK since v0.9.2.
206
207Flashing an application to Disco L475 IoT
208-----------------------------------------
209
210Here is an example for the :ref:`hello_world` application.
211
212Connect the Disco L475 IoT to your host computer using the USB port, then
213run a serial host program to connect with your Nucleo board. For example:
214
215.. code-block:: console
216
217   $ minicom -D /dev/ttyACM0
218
219Then build and flash the application:
220
221.. zephyr-app-commands::
222   :zephyr-app: samples/hello_world
223   :board: disco_l475_iot1
224   :goals: build flash
225
226You should see the following message on the console:
227
228.. code-block:: console
229
230   $ Hello World! arm
231
232Debugging
233=========
234
235You can debug an application in the usual way.  Here is an example for the
236:ref:`hello_world` application.
237
238.. zephyr-app-commands::
239   :zephyr-app: samples/hello_world
240   :board: disco_l475_iot1
241   :maybe-skip-config:
242   :goals: debug
243
244.. _Disco L475 IoT1 website:
245   https://www.st.com/content/st_com/en/products/evaluation-tools/product-evaluation-tools/mcu-eval-tools/stm32-mcu-eval-tools/stm32-mcu-discovery-kits/b-l475e-iot01a.html
246
247.. _STM32 Disco L475 IoT1 board User Manual:
248   https://www.st.com/resource/en/user_manual/dm00347848.pdf
249
250.. _STM32L475VG on www.st.com:
251   https://www.st.com/en/microcontrollers-microprocessors/stm32l475vg.html
252
253.. _STM32L475 reference manual:
254   https://www.st.com/resource/en/reference_manual/dm00083560.pdf
255