1.. zephyr:board:: stm32f723e_disco
2
3Overview
4********
5
6The discovery kit enables a wide diversity of applications taking benefit
7from audio, multi-sensor support, graphics, security, security, video,
8and high-speed connectivity features. Important board features include:
9
10- STM32F723IEK6 microcontroller featuring 512 Kbytes of Flash memory and 256+16+4 Kbytes of RAM, in BGA176 package
11- On-board ST-LINK/V2-1 supporting USB re-enumeration capability
12- TFT LCD 240x240 pixels with touch panel
13- SAI audio codec
14- Audio line in and line out jack
15- Stereo speaker outputs
16- Four ST MEMS microphones
17- Two pushbuttons (user and reset)
18- 512-Mbit Quad-SPI Flash memory
19- 8-Mbit external PSRAM
20- USB OTG HS with Micro-AB connectors
21- USB OTG FS with Micro-AB connectors
22
23More information about the board can be found at the `32F723E-DISCO website`_.
24
25Hardware
26********
27
28The STM32F723E Discovery kit provides the following hardware components:
29
30- STM32F723IEK6 in BGA176 package
31- ARM |reg| 32-bit Cortex |reg| -M7 CPU with FPU
32- 216 MHz max CPU frequency
33- VDD from 1.8 V to 3.6 V
34- 1 MB Flash
35- 256+16+4 KB SRAM including 64KB of tightly coupled memory
36- GPIO with external interrupt capability
37- 3x12-bit ADC with 24 channels
38- 2x12-bit D/A converters
39- RTC
40- Advanced-control Timer (2)
41- General Purpose Timers (13)
42- Watchdog Timers (2)
43- USART/UART (8)
44- I2C (3)
45- SPI (5)
46- 2xSAI (serial audio interface)
47- SDIO (2)
48- CAN
49- USB 2.0 OTG FS with on-chip PHY
50- USB 2.0 OTG HS/FS with dedicated DMA, on-chip full-speed PHY and on-chip hi-speed PHY
51- CRC calculation unit
52- True random number generator
53- DMA Controller
54
55More information about STM32F723IEK6 can be found here:
56
57- `STM32F723IEK6 on www.st.com`_
58- `STM32F72xxx reference manual`_
59
60Supported Features
61==================
62
63The Zephyr stm32f723e_disco board configuration supports the following hardware features:
64
65+-----------+------------+-------------------------------------+
66| Interface | Controller | Driver/Component                    |
67+===========+============+=====================================+
68| NVIC      | on-chip    | nested vector interrupt controller  |
69+-----------+------------+-------------------------------------+
70| UART      | on-chip    | serial port-polling;                |
71|           |            | serial port-interrupt               |
72+-----------+------------+-------------------------------------+
73| PINMUX    | on-chip    | pinmux                              |
74+-----------+------------+-------------------------------------+
75| GPIO      | on-chip    | gpio                                |
76+-----------+------------+-------------------------------------+
77| I2C       | on-chip    | i2c                                 |
78+-----------+------------+-------------------------------------+
79| SPI       | on-chip    | spi                                 |
80+-----------+------------+-------------------------------------+
81| USB       | on-chip    | USB device                          |
82+-----------+------------+-------------------------------------+
83
84Other hardware features are not yet supported on Zephyr porting.
85
86The default configuration can be found in
87:zephyr_file:`boards/st/stm32f723e_disco/stm32f723e_disco_defconfig`
88
89Pin Mapping
90===========
91
92STM32F723E Discovery kit has 7 GPIO controllers. These controllers are responsible for pin muxing,
93input/output, pull-up, etc.
94
95For more details please refer to `32F723E-DISCO board User Manual`_.
96
97Default Zephyr Peripheral Mapping:
98----------------------------------
99- UART_2 TX/RX : PA2/PA3 (Arduino Serial)
100- UART_6 TX/RX : PC6/PC7 (ST-Link Virtual Port Com)
101- I2C1 SCL/SDA : PB8/PB9
102- I2C2 SCL/SDA : PH4/PH5 (Arduino I2C)
103- I2C3 SCL/SDA : PA8/PH8
104- SPI1 SCK/MISO/MOSI : PA5/PB4/PB5 (Arduino SPI)
105- LD1 : PA5
106- LD5 : PA7
107- LD6 : PB1
108- OTG_FS_DM : PA11
109- OTG_FS_DP : PA12
110
111System Clock
112============
113
114The STM32F723E System Clock can be driven by an internal or external oscillator,
115as well as by the main PLL clock. By default, the System clock is driven by the PLL
116clock at 216MHz, driven by a 25MHz high speed external clock.
117
118Serial Port
119===========
120
121The STM32F723E Discovery kit has up to 8 UARTs. The Zephyr console output is assigned to UART6
122which connected to the onboard ST-LINK/V2 Virtual COM port interface. Default communication
123settings are 115200 8N1.
124
125Programming and Debugging
126*************************
127
128STM32F723E Discovery kit includes an ST-LINK/V2 embedded debug tool interface.
129
130Applications for the ``stm32f723e_disco`` board configuration can be built and
131flashed in the usual way (see :ref:`build_an_application` and
132:ref:`application_run` for more details).
133
134Flashing
135========
136
137The board is configured to be flashed using west `STM32CubeProgrammer`_ runner,
138so its :ref:`installation <stm32cubeprog-flash-host-tools>` is required.
139
140Alternatively, OpenOCD or JLink can also be used to flash the board using
141the ``--runner`` (or ``-r``) option:
142
143.. code-block:: console
144
145   $ west flash --runner openocd
146   $ west flash --runner jlink
147
148Flashing an application to STM32F723E-DISCO
149-------------------------------------------
150
151First, connect the STM32F723E Discovery kit to your host computer using
152the USB port to prepare it for flashing. Then build and flash your application.
153
154Here is an example for the :zephyr:code-sample:`hello_world` application.
155
156.. zephyr-app-commands::
157   :zephyr-app: samples/hello_world
158   :board: stm32f723e_disco
159   :goals: build flash
160
161Run a serial host program to connect with your board:
162
163.. code-block:: console
164
165   $ minicom -D /dev/ttyACM0
166
167You should see the following message on the console:
168
169.. code-block:: console
170
171   Hello World! arm
172
173Debugging
174=========
175
176You can debug an application in the usual way.  Here is an example for the
177:zephyr:code-sample:`hello_world` application.
178
179.. zephyr-app-commands::
180   :zephyr-app: samples/hello_world
181   :board: stm32f723e_disco
182   :goals: debug
183
184
185.. _32F723E-DISCO website:
186   https://www.st.com/en/evaluation-tools/32f723ediscovery.html
187
188.. _32F723E-DISCO board User Manual:
189   https://www.st.com/resource/en/user_manual/dm00342318.pdf
190
191.. _STM32F723IEK6 on www.st.com:
192   https://www.st.com/en/microcontrollers/stm32f723ie.html
193
194.. _STM32F72xxx reference manual:
195   https://www.st.com/resource/en/reference_manual/dm00305990.pdf
196
197.. _STM32CubeProgrammer:
198   https://www.st.com/en/development-tools/stm32cubeprog.html
199