STM32 : update Readme file

Merged README files to centralize documentation and avoid duplication.

Signed-off-by: Ahmad EL JOUAID <[email protected]>
Change-Id: I4e313797144aa13ec5d2d55187b8e2d967c3cb95

(cherry picked from commit 5bd762ff21232b47a28b1a4a4842f0d8b7648eb8)

Author: ahmadstm

docs/platform/stm/b_u585i_iot02a/readme.rst

@@ -1,3 +1,38 @@
+-------
+STM32U5
+-------
+
+TF-M is supported on STM32U5 family
+
+https://www.st.com/en/microcontrollers-microprocessors/stm32u5-series.html
+
+
+Directory content
+^^^^^^^^^^^^^^^^^
+
+- stm/common/stm32u5xx/stm32u5xx_hal:
+   Content from https://github.com/STMicroelectronics/stm32u5xx_hal_driver.git
+
+- stm/common/stm32u5xx/Device:
+   Content from https://github.com/STMicroelectronics/cmsis_device_u5.git
+
+- stm/common/stm32u5xx/bl2:
+   stm32l5xx bl2 code specific from https://github.com/STMicroelectronics/STM32CubeU5.git (Projects/B-U585I-IOT02A/Applications/TFM)
+
+- stm/common/stm32u5xx/secure:
+   stm32l5xx Secure porting adaptation from https://github.com/STMicroelectronics/STM32CubeU5.git (Projects/B-U585I-IOT02A/Applications/TFM)
+
+- stm/common/stm32u5xx/boards:
+   Adaptation for stm32 board using stm32l5xx soc from https://github.com/STMicroelectronics/STM32CubeU5.git (Projects/B-U585I-IOT02A/Applications/TFM)
+
+
+Specific Software Requirements
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+STM32_Programmer_CLI is required.(see https://www.st.com/en/development-tools/stm32cubeprog.html)
+
+
+
 B_U585I_IOT02A
 ^^^^^^^^^^^^^^^
 
@@ -75,6 +110,25 @@ the attestation service in Isolation Level 1 on Linux.
     ninja -C . -j 8
 
 
+Write software on target
+^^^^^^^^^^^^^^^^^^^^^^^^
+In secure build folder directory api_ns:
+
+  - ``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
 
 -------------
 

docs/platform/stm/common/stm32h5xx/readme.rst

@@ -6,20 +6,16 @@ This document contains SOC and boards supported by stm32.
 
 .. toctree::
     :maxdepth: 1
-    :caption: SOC
+    :caption: SOC and Boards
     :glob:
 
-    common/stm*/**
+    b_u585i_iot02a/readme.rst
+    nucleo_l552ze_q/readme.rst
+    stm32l562e_dk/readme.rst
+    stm32h573i_dk/readme.rst
+    stm32wba65i-dk/readme.rst
 
-.. toctree::
-    :maxdepth: 1
-    :caption: Boards
-    :glob:
-
-    nucleo*/**
-    stm32*/**
-    b_*/**
 
 --------------
 
-*Copyright (c) 2021, stmicroelectronics All rights reserved.*
+*Copyright (c) 2021 - 2025, stmicroelectronics All rights reserved.*