platform: stm: Add board stm32h573i_dk
Change-Id: I0fc2e6884f589edf81b487f2435ad79960a3f954
Signed-off-by: Ahmad EL JOUAID <ahmad.eljouaid@st.com>
diff --git a/docs/platform/platform_introduction.rst b/docs/platform/platform_introduction.rst
index 8b9d0b4..c49381f 100644
--- a/docs/platform/platform_introduction.rst
+++ b/docs/platform/platform_introduction.rst
@@ -33,6 +33,8 @@
<https://developer.arm.com/tools-and-software/development-boards/fpga-prototyping-boards/mps3>`_
- `LPC55S69.
<https://www.nxp.com/products/processors-and-microcontrollers/arm-microcontrollers/general-purpose-mcus/lpc5500-cortex-m33/lpcxpresso55s69-development-board:LPC55S69-EVK>`_
+ - `STM32H573I-DK.
+ <https://www.st.com/en/evaluation-tools/stm32h573i-dk.html>`_
- `B-U585I-IOT02A.
<https://www.st.com/en/evaluation-tools/B-U585I-IOT02A.html>`_
- `NUCLEO L552ZE Q.
diff --git a/docs/platform/stm/common/stm32h5xx/readme.rst b/docs/platform/stm/common/stm32h5xx/readme.rst
new file mode 100644
index 0000000..416fe3f
--- /dev/null
+++ b/docs/platform/stm/common/stm32h5xx/readme.rst
@@ -0,0 +1,66 @@
+-------
+STM32H5
+-------
+
+TF-M is supported on STM32H5 family
+
+https://www.st.com/en/microcontrollers-microprocessors/stm32h5-series.html
+
+
+Directory content
+^^^^^^^^^^^^^^^^^
+
+- stm/common/stm32h5xx/stm32h5xx_hal:
+ Content from https://github.com/STMicroelectronics/stm32h5xx_hal_driver
+
+- stm/common/stm32h5xx/Device:
+ Content from https://github.com/STMicroelectronics/cmsis_device_h5
+
+- stm/common/stm32h5xx/bl2:
+ stm32h5xx bl2 code specific from https://github.com/STMicroelectronics/STM32CubeH5.git (Projects/STM32H573I_DK/Applications/TFM)
+
+- stm/common/stm32h5xx/secure:
+ stm32h5xx Secure porting adaptation from https://github.com/STMicroelectronics/STM32CubeH5.git (Projects/STM32H573I_DK/Applications/TFM)
+
+- stm/common/stm32h5xx/boards:
+ Adaptation and tools specific to stm32 board using stm32h5xx soc from https://github.com/STMicroelectronics/STM32CubeH5.git (Projects/STM32H573I_DK/Applications/TFM)
+
+- stm/common/stm32h5xx/CMSIS_Driver:
+ Flash and uart driver for stm32h5xx platform
+
+- stm/common/stm32h5xx/Native_Driver:
+ Random generator and tickless implementation
+
+Specific Software Requirements
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+STM32_Programmer_CLI is required.(see https://www.st.com/en/development-tools/stm32cubeprog.html)
+
+Limitations to Consider When Using the Platform
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+MPU and ICACHE disabled in bl2 boot stage
+
+Write software on target
+^^^^^^^^^^^^^^^^^^^^^^^^
+In build folder:
+
+ - ``postbuild.sh``: Updates regression.sh and TFM_UPDATE.sh scripts according to flash_layout.h
+ - ``regression.sh``: Sets platform option bytes config and erase platform
+ - ``TFM_UPDATE.sh``: Writes bl2, secure, and non secure image in target
+
+
+Connect board to USB and Execute the 3 scripts in following order to update platform:
+postbuild.sh, regression.sh, TFM_UPDATE.sh
+
+The virtual com port from STLINK is used for TFM log and serial port configuration should be:
+
+ - Baud rate = 115200
+ - Data = 8 bits
+ - Parity = none
+ - Stop = 1 bit
+ - Flow control = none
+
+-------------
+
+*Copyright (c) 2023 STMicroelectronics. All rights reserved.*
+*SPDX-License-Identifier: BSD-3-Clause*
\ No newline at end of file
diff --git a/docs/platform/stm/stm32h573i_dk/readme.rst b/docs/platform/stm/stm32h573i_dk/readme.rst
new file mode 100644
index 0000000..e827fb9
--- /dev/null
+++ b/docs/platform/stm/stm32h573i_dk/readme.rst
@@ -0,0 +1,22 @@
+STM32H573I_DK
+^^^^^^^^^^^^^^^
+
+Discovery kit for IoT node with STM32H5 series
+https://www.st.com/en/evaluation-tools/stm32h573i-dk.html
+
+Configuration and Build
+"""""""""""""""""""""""
+
+GNUARM/ARMCLANG/IARARM compilation is available for this target.
+and build the selected configuration as follow.
+
+``> mkdir build && cd build``
+
+``> cmake .. -DTFM_PLATFORM=stm/stm32h573i_dk -DTFM_TOOLCHAIN_FILE=../toolchain_GNUARM.cmake -G"Unix Makefiles"``
+
+``> cmake --build ./ -- install``
+
+-------------
+
+*Copyright (c) 2023, STMicroelectronics. All rights reserved.*
+*SPDX-License-Identifier: BSD-3-Clause*