1.. zephyr:board:: stm32h735g_disco
2
3Overview
4********
5
6The STM32H735G-DK Discovery kit is a complete demonstration and development
7platform for Arm® Cortex®-M7 core-based STM32H735IGK6U microcontroller, with
81 Mbyte of Flash memory and 564 Kbytes of SRAM.
9
10The STM32H735G-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. STM32H735G-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 `STM32H735G-DISCO website`_.
28More information about STM32H735 can be found here:
29
30- `STM32H725/735 on www.st.com`_
31- `STM32H735xx reference manual`_
32- `STM32H735xx datasheet`_
33
34Supported Features
35==================
36
37The current Zephyr stm32h735g_disco 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| FLASH     | on-chip    | flash memory                        |
52+-----------+------------+-------------------------------------+
53| ETHERNET  | on-chip    | ethernet                            |
54+-----------+------------+-------------------------------------+
55| RNG       | on-chip    | True Random number generator        |
56+-----------+------------+-------------------------------------+
57| FMC       | on-chip    | memc (SDRAM)                        |
58+-----------+------------+-------------------------------------+
59| ADC       | on-chip    | ADC Controller                      |
60+-----------+------------+-------------------------------------+
61| FDCAN1    | on-chip    | CAN-FD Controller                   |
62+-----------+------------+-------------------------------------+
63| FDCAN2    | on-chip    | CAN-FD Controller                   |
64+-----------+------------+-------------------------------------+
65| FDCAN3    | on-chip    | CAN-FD Controller (disabled by      |
66|           |            | default. Solder bridges SB29 and    |
67|           |            | SB30 need to be closed for FDCAN3   |
68|           |            | to work)                            |
69+-----------+------------+-------------------------------------+
70| USB       | on-chip    | usb_device                          |
71+-----------+------------+-------------------------------------+
72
73Other hardware features are not yet supported on Zephyr porting.
74
75The default configuration can be found in the defconfig file:
76:zephyr_file:`boards/st/stm32h735g_disco/stm32h735g_disco_defconfig`
77
78Pin Mapping
79===========
80
81For more details please refer to `STM32H735G-DISCO website`_.
82
83Default Zephyr Peripheral Mapping:
84----------------------------------
85
86- UART_3 TX/RX : PD8/PD9 (ST-Link Virtual Port Com)
87- UART_7 TX/RX : PF7/PF6 (Arduino Serial)
88- LD1 : PC2
89- LD2 : PC3
90- FDCAN1 : CAN
91
92System Clock
93============
94
95The STM32H735G System Clock can be driven by an internal or external oscillator,
96as well as by the main PLL clock. By default, the System clock
97is driven by the PLL clock at 550MHz. PLL clock is feed by a 25MHz high speed external clock.
98
99Serial Port
100===========
101
102The STM32H735G Discovery kit has up to 6 UARTs.
103The Zephyr console output is assigned to UART3 which connected to the onboard ST-LINK/V3.0. Virtual
104COM port interface. Default communication settings are 115200 8N1.
105
106
107Programming and Debugging
108*************************
109
110STM32H735G-DISCO board includes an ST-LINK/V3 embedded debug tool interface.
111
112See :ref:`build_an_application` for more information about application builds.
113
114
115Flashing
116========
117
118The board is configured to be flashed using west `STM32CubeProgrammer`_ runner,
119so its :ref:`installation <stm32cubeprog-flash-host-tools>` is required.
120
121Alternatively, OpenOCD or JLink can also be used to flash the board using
122the ``--runner`` (or ``-r``) option:
123
124.. code-block:: console
125
126   $ west flash --runner openocd
127   $ west flash --runner jlink
128
129It is advised to use `STM32CubeProgrammer`_ to check and update option bytes
130configuration.
131
132Debugging
133=========
134
135You can debug an application in the usual way.  Here is an example for the
136:zephyr:code-sample:`hello_world` application.
137
138.. zephyr-app-commands::
139   :zephyr-app: samples/hello_world
140   :board: stm32h735g_disco
141   :goals: debug
142
143
144.. _STM32H735G-DISCO website:
145   https://www.st.com/en/evaluation-tools/stm32h735g-dk.html
146
147.. _STM32H725/735 on www.st.com:
148   https://www.st.com/en/microcontrollers-microprocessors/stm32h725-735.html
149
150.. _STM32H735xx reference manual:
151   https://www.st.com/resource/en/reference_manual/dm00603761-stm32h723733-stm32h725735-and-stm32h730-value-line-advanced-armbased-32bit-mcus-stmicroelectronics.pdf
152
153.. _STM32H735xx datasheet:
154   https://www.st.com/resource/en/datasheet/stm32h735ag.pdf
155
156.. _STM32CubeProgrammer:
157   https://www.st.com/en/development-tools/stm32cubeprog.html
158