Documentation/stm32h7: add supported chips and a brief description of dual-core

Documentation/platforms/arm/stm32h7/boards/nucleo-h745zi/index.rst

@@ -1,3 +1,24 @@
 ================
 ST Nucleo H745ZI
 ================
+
+Dual core support
+-----------------
+
+It is recommended to use CMake to build firmware consisting of multiple images.
+The commands to build ``nsh_xxx_rptun`` configurations are as follows::
+
+  cmake -B build_h7m7 -DBOARD_CONFIG=nucleo-h745zi:nsh_cm7_rptun -GNinja
+  cmake -B build_h7m4 -DBOARD_CONFIG=nucleo-h745zi:nsh_cm4_rptun -GNinja
+
+  cmake --build build_h7m7
+  cmake --build build_h7m4
+
+Tools
+-----
+
+Support for the board was tested using an external JLink interface.
+Openocd with built-in ST-LINK didn't work well.
+
+Image flashing was accomplished using ``JFlashLiteExe``, with the device
+set to ``STM32H745ZI_M7``.

Documentation/platforms/arm/stm32h7/index.rst

@@ -5,7 +5,43 @@ ST STM32H7
 Supported MCUs
 ==============
 
-TODO
+Dual-core lines:
+
+===========  ======= ================
+MCU          Support Note
+===========  ======= ================
+STM32H747    Partial Only STM32H747XI
+STM32H757    No
+STM32H745    Yes
+STM32H755    No
+===========  ======= ================
+
+Single-core lines:
+
+===========  ======= ================
+MCU          Support Note
+===========  ======= ================
+STM32H7A3    No
+STM32H7B3    Partial Only STM32H7B3LI
+STM32H743    Yes
+STM32H753    Yes
+STM32H742    No
+STM32H725    No
+STM32H735    No
+STM32H723    No
+STM32H733    No
+===========  ======= ================
+
+Value lines:
+
+===========  ======= ================
+MCU          Support Note
+===========  ======= ================
+STM32H7B0    No
+STM32H750    No
+STM32H730    No
+===========  ======= ================
+
 
 Peripheral Support
 ==================
@@ -68,6 +104,25 @@ ETH         Yes
 HDMI_CEC    No
 ==========  =======  =====
 
+Dual-core support
+=================
+
+Some of the STM32H7 chips have an additional Cortex-M4 core built-in.
+The selection of the core for which the image is build is made using options:
+
+  - ``CONFIG_ARCH_CHIP_STM32H7_CORTEXM7`` - selects Cortex-M7 core
+  - ``CONFIG_ARCH_CHIP_STM32H7_CORTEXM4`` - selects Cortex-M4 core
+
+Support for the CM7 core is always enabled, support for the CM4 core is controlled
+with the ``CONFIG_STM32H7_CORTEXM4_ENABLED`` option.
+
+Interprocessor communication between cores is realized with the NuttX RPTUN
+device based on the OpenAMP framework. ``HSEM`` is used for synchronization and
+notification between cores.
+
+32kB of the SRAM3 is reseved for shared memory and this is the only available
+option at the moment.
+
 Supported Boards
 ================