1.. zephyr:board:: stm32h750b_dk
2
3Overview
4********
5
6The STM32H750B-DK Discovery kit is a complete demonstration and development
7platform for Arm® Cortex®-M7 core-based STM32H750XBH6 microcontroller, with
8128Kbytes of Flash memory and 1 Mbytes of SRAM.
9
10The STM32H750B-DK Discovery kit is used as a reference design for user
11application development before porting to the final product, thus simplifying
12the application development.
13
14The full range of hardware features available on the board helps users to enhance
15their application development by an evaluation of all the peripherals (such as
16USB OTG FS, Ethernet, microSD™ card, USART, CAN FD, SAI audio DAC stereo with
17audio jack input and output, MEMS digital microphone, HyperRAM™,
18Octo-SPI Flash memory, RGB interface LCD with capacitive touch panel, and others).
19ARDUINO® Uno V3, Pmod™ and STMod+ connectors provide easy connection to extension
20shields or daughterboards for specific applications.
21
22STLINK-V3E is integrated into the board, as the embedded in-circuit debugger and
23programmer for the STM32 MCU and USB Virtual COM port bridge. STM32H750B-DK board
24comes with the STM32CubeH7 MCU Package, which provides an STM32 comprehensive
25software HAL library as well as various software examples.
26
27More information about the board can be found at the `STM32H750B-DK website`_.
28More information about STM32H750 can be found here:
29
30- `STM32H750 on www.st.com`_
31- `STM32H750xx reference manual`_
32- `STM32H750xx datasheet`_
33
34Supported Features
35==================
36
37The current Zephyr stm32h750b_dk board configuration supports the following hardware features:
38
39+-----------+------------+-------------------------------------+
40| Interface | Controller | Driver/Component                    |
41+===========+============+=====================================+
42| NVIC      | on-chip    | nested vector interrupt controller  |
43+-----------+------------+-------------------------------------+
44| UART      | on-chip    | serial port-polling;                |
45|           |            | serial port-interrupt               |
46+-----------+------------+-------------------------------------+
47| PINMUX    | on-chip    | pinmux                              |
48+-----------+------------+-------------------------------------+
49| GPIO      | on-chip    | gpio                                |
50+-----------+------------+-------------------------------------+
51| QSPI NOR  | on-chip    | off-chip flash                      |
52+-----------+------------+-------------------------------------+
53| RTC       | on-chip    | rtc                                 |
54+-----------+------------+-------------------------------------+
55| ADC       | on-chip    | adc                                 |
56+-----------+------------+-------------------------------------+
57| LTDC      | on-chip    | display                             |
58+-----------+------------+-------------------------------------+
59| QSPI NOR  | on-chip    | off-chip flash                      |
60+-----------+------------+-------------------------------------+
61| FMC       | on-chip    | memc (SDRAM)                        |
62+-----------+------------+-------------------------------------+
63
64Other hardware features are not yet supported on Zephyr porting.
65
66The default configuration can be found in the defconfig file:
67:zephyr_file:`boards/st/stm32h750b_dk/stm32h750b_dk_defconfig`
68
69Pin Mapping
70===========
71
72For more details please refer to `STM32H750B-DK website`_.
73
74Default Zephyr Peripheral Mapping:
75----------------------------------
76
77- UART_3 TX/RX : PB10/PB11 (ST-Link Virtual Port Com)
78- LD1 : PJ2
79- LD2 : PI13
80- USART1 TX/RX : PB6/PB7 (Arduino D1/D0)
81
82System Clock
83============
84
85The STM32H750B System Clock can be driven by an internal or external oscillator,
86as well as by the main PLL clock. By default, the System clock
87is driven by the PLL clock at 480MHz. PLL clock is feed by a 25MHz high speed external clock.
88
89Serial Port
90===========
91
92The STM32H750B Discovery kit has up to 6 UARTs.
93The Zephyr console output is assigned to UART3 which connected to the onboard ST-LINK/V3.0. Virtual
94COM port interface. Default communication settings are 115200 8N1.
95
96
97Programming and Debugging
98*************************
99
100STM32H750B Discovery kit includes an ST-LINK-V3E embedded debug tool interface.
101This probe allows flashing and debugging the board using various tools.
102
103See :ref:`build_an_application` for more information about application builds.
104
105
106Flashing
107========
108
109The board is configured to be flashed using west `STM32CubeProgrammer`_ runner,
110so its :ref:`installation <stm32cubeprog-flash-host-tools>` is required.
111
112Alternatively, OpenOCD or JLink can also be used to flash the board using
113the ``--runner`` (or ``-r``) option:
114
115.. code-block:: console
116
117   $ west flash --runner openocd
118   $ west flash --runner jlink
119
120Flashing an application to STM32H750B_DK
121----------------------------------------
122
123Connect the STM32H750B-DK to your host computer using the ST-LINK
124USB port, then run a serial host program to connect with the board. For example:
125
126.. code-block:: console
127
128   $ minicom -b 115200 -D /dev/ttyACM0
129
130You can then build and flash applications in the usual way.
131Here is an example for the :zephyr:code-sample:`hello_world` application.
132
133.. zephyr-app-commands::
134   :zephyr-app: samples/hello_world
135   :board: stm32h750b_dk
136   :goals: build flash
137
138You should see the following message in the serial host program:
139
140.. code-block:: console
141
142   $ Hello World! stm32h750b_dk
143
144
145Debugging
146=========
147
148You can debug an application in the usual way.  Here is an example for the
149:zephyr:code-sample:`hello_world` application.
150
151.. zephyr-app-commands::
152   :zephyr-app: samples/hello_world
153   :board: stm32h750b_dk
154   :goals: debug
155
156
157.. _STM32H750B-DK website:
158   https://www.st.com/en/evaluation-tools/stm32h750b-dk.html
159
160.. _STM32H750 on www.st.com:
161   https://www.st.com/en/microcontrollers-microprocessors/stm32h750-value-line.html
162
163.. _STM32H750xx reference manual:
164   https://www.st.com/resource/en/reference_manual/rm0433-stm32h742-stm32h743753-and-stm32h750-value-line-advanced-armbased-32bit-mcus-stmicroelectronics.pdf
165
166.. _STM32H750xx datasheet:
167   https://www.st.com/resource/en/datasheet/stm32h750ib.pdf
168
169.. _STM32CubeProgrammer:
170   https://www.st.com/en/development-tools/stm32cubeprog.html
171