1.. zephyr:board:: yd_stm32h750vb
2
3Overview
4********
5
6The YD-STM32H750VB development board is a complete demonstration and development
7platform for Arm |reg| Cortex |reg|-M7 core-based STM32H750VBT6 microcontroller, with
8128Kbytes of Flash memory and 1 Mbytes of SRAM.
9
10More information about STM32H750 can be found here:
11
12- `STM32H750 on www.st.com`_
13- `STM32H750xx reference manual`_
14- `STM32H750xx datasheet`_
15
16Supported Features
17==================
18
19The current Zephyr YD-STM32H750VB board supports the following features:
20
21+-----------+------------+-------------------------------------+
22| Interface | Controller | Driver/Component                    |
23+===========+============+=====================================+
24| CLOCK     | on-chip    | reset and clock control             |
25+-----------+------------+-------------------------------------+
26| NVIC      | on-chip    | nested vector interrupt controller  |
27+-----------+------------+-------------------------------------+
28| UART      | on-chip    | serial port-polling;                |
29|           |            | serial port-interrupt               |
30+-----------+------------+-------------------------------------+
31| PINMUX    | on-chip    | pinmux                              |
32+-----------+------------+-------------------------------------+
33| GPIO      | on-chip    | gpio                                |
34+-----------+------------+-------------------------------------+
35
36Other hardware features are not yet supported on Zephyr porting.
37
38The default configuration can be found in the defconfig file:
39:zephyr_file:`boards/vcc-gnd/yd_stm32h750vb/yd_stm32h750vb_defconfig`
40
41Pin Mapping
42===========
43
44Default Zephyr Peripheral Mapping:
45----------------------------------
46
47- UART_1_TX : PA9
48- UART_1_RX : PA10
49- LED_1 : PA13 (SWDIO)
50- LED_2 : PA14 (SWCLK)
51- LED_3 : PA15
52- LED_4 : PB4
53- KEY : PB3
54
55System Clock
56============
57
58The STM32H750VB System Clock can be driven by an internal or external oscillator,
59as well as by the main PLL clock. By default, the System clock
60is driven by the PLL clock at 480MHz. PLL clock is feed by a 25MHz high speed external clock.
61
62Flashing
63========
64
65There are 2 main entry points for flashing STM32H750VB SoCs, one using the ROM
66bootloader, and another by using the SWD debug port (which requires additional
67hardware such as ST-Link). Flashing using the ROM bootloader requires a special activation
68pattern, which can be triggered by using the BOOT0 button.
69
70Installing dfu-util
71-------------------
72
73It is recommended to use at least v0.8 of `dfu-util`_. The package available in
74debian/ubuntu can be quite old, so you might have to build dfu-util from source.
75
76There is also a Windows version which works, but you may have to install the
77right USB drivers with a tool like `Zadig`_.
78
79Flashing an application to YD-STM32H750VB
80-----------------------------------------
81
82Connect a USB-C cable and the board should power ON. Force the board into DFU mode
83by keeping the BOOT0 switch pressed while pressing and releasing the RST switch.
84
85The dfu-util runner is supported on this board and so a sample can be built and
86tested easily.
87
88Here is an example for the :zephyr:code-sample:`blinky` application.
89
90.. zephyr-app-commands::
91   :zephyr-app: samples/basic/blinky
92   :board: yd_stm32h750vb
93   :goals: build flash
94
95You will see the LED blinking every second.
96
97Debugging
98=========
99
100You can debug an application in the usual way.  Here is an example for the
101:zephyr:code-sample:`hello_world` application.
102
103.. zephyr-app-commands::
104   :zephyr-app: samples/hello_world
105   :board: yd_stm32h750vb
106   :goals: debug
107
108References
109**********
110
111.. target-notes::
112
113.. _Zadig:
114   https://zadig.akeo.ie/
115
116.. _dfu-util:
117   http://dfu-util.sourceforge.net/build.html
118
119.. _STM32H750 on www.st.com:
120   https://www.st.com/en/microcontrollers-microprocessors/stm32h750-value-line.html
121
122.. _STM32H750xx reference manual:
123   https://www.st.com/resource/en/reference_manual/rm0433-stm32h742-stm32h743753-and-stm32h750-value-line-advanced-armbased-32bit-mcus-stmicroelectronics.pdf
124
125.. _STM32H750xx datasheet:
126   https://www.st.com/resource/en/datasheet/stm32h750vb.pdf
127