Docs: some clean-up to platform folder
- Remove support platform list from integration guide. Only keep the
list under platform folder.
Otherwise platform vendors have to maintain two lists and information
can be duplicated or misaligned.
- Refine Arm platform doc structure to put OpenAMP docs under
Corstone-1000
- Refine Cypress PSoC64 doc structure to move library docs under the
PSoC64 list.
Change-Id: I7fad8dd1eb52594d406f6be8a61c38c27fcb72ff
Signed-off-by: David Hu <david.hu@arm.com>
diff --git a/docs/integration_guide/tfm_integration_guide.rst b/docs/integration_guide/tfm_integration_guide.rst
index 7979c65..2203596 100644
--- a/docs/integration_guide/tfm_integration_guide.rst
+++ b/docs/integration_guide/tfm_integration_guide.rst
@@ -21,62 +21,6 @@
:doc:`Porting TF-M to a New Hardware </docs/integration_guide/porting_TFM_to_a_new_hardware>`
contains guidance on how to add a new platform.
-*******************
-Supported Platforms
-*******************
-The hardware platforms currently supported are:
-
-- Soft Macro Model (SMM) Cortex-M33 SSE-200 subsystem for MPS2+ (AN521)
-- Cortex-M23 IoT Kit subsystem for MPS2+ (AN519)
-- Corstone-300 Ethos-U55 FVP (Cortex-M55 plus Ethos-U55 SSE-300 MPS3)
-- Musca-B1 test chip board (Cortex-M33 SSE-200 subsystem)
-- Musca-S1 test chip board (Cortex-M33 SSE-200 subsystem)
-- CoreLink SSE-200 Subsystem for MPS3 (AN524)
-- Corstone SSE-300 with Ethos-U55 Example Subsystem for MPS3 (AN547)
-- Corstone SSE-300 with Ethos-U55 Example Subsystem for MPS3 (AN552)
-- Corstone-300 Ethos-U55 Ecosystem FVP (FVP_SSE300_MPS3)
-- STM32L5xx: Cortex-M33 based platform (STM32L562 and STM32L552 socs)
-- nRF9160 DK (Cortex-M33)
-- nRF5340 DK (Cortex-M33 Application MCU)
-- BL5340 DVK (Cortex-M33 Application MCU)
-- Corstone-Polaris Ethos-U55 FVP (Olympus CPU plus Ethos-U55)
-
-The files related to the supported platforms are contained under the
-``platform`` subfolder. The platform specific files are under
-``platform/ext/target``, which is organised by boards
-(e.g. ``platform/ext/target/mps2``), while the folder ``platform/ext/common``
-is used to store source and header files which are platform generic.
-
-More information about subsystems supported by the MPS2+ board can be found in:
-`MPS2+ homepage <https://developer.arm.com/products/system-design/development-boards/fpga-prototyping-boards/mps2>`__
-
-More information about subsystems supported by the MPS3 board can be found in:
-`MPS3 homepage <https://developer.arm.com/products/system-design/development-boards/fpga-prototyping-boards/mps3>`__
-
-More information about the Musca-B1 test chip board can be found in:
-`Musca-B1 homepage <https://www.arm.com/products/development-tools/development-boards/musca-b1-iot>`__
-
-More information about the Musca-S1 test chip board can be found in:
-`Musca-S1 homepage <https://www.arm.com/company/news/2019/05/arm-demonstrates-new-iot-test-chip-and-board>`__
-
-More information about subsystems supported by the MPS3 board can be found in:
-`MPS3 homepage <https://www.arm.com/products/development-tools/development-boards/mps3>`__
-
-More information about the Corstone-300 FVPs can be found in:
-`Arm Ecosystem FVPs homepage <https://developer.arm.com/tools-and-software/open-source-software/arm-platforms-software/arm-ecosystem-fvps>`__
-
-More information about the STM32L5xx platform can be found in:
-`STM32L5 series product page <https://www.st.com/content/st_com/en/products/microcontrollers-microprocessors/stm32-32-bit-arm-cortex-mcus/stm32-ultra-low-power-mcus/stm32l5-series.html>`__
-
-More information about the nRF5340 DK platform can be found in:
-`nRF5340 DK product page <https://www.nordicsemi.com/Software-and-tools/Development-Kits/nRF5340-DK>`__
-
-More information about the nRF9160 DK platform can be found in:
-`nRF9160 DK product page <https://www.nordicsemi.com/Software-and-tools/Development-Kits/nRF9160-DK>`__
-
-More information about the BL5340 platform can be found in:
-`BL5340 product page <https://www.lairdconnect.com/wireless-modules/bluetooth-modules/bluetooth-5-modules/bl5340-series-multi-core-bluetooth-52-802154-nfc-modules>`__
-
***************************
How to integrate another OS
***************************
diff --git a/platform/ext/index.rst b/platform/ext/index.rst
index 2e0633c..4aea392 100644
--- a/platform/ext/index.rst
+++ b/platform/ext/index.rst
@@ -16,7 +16,7 @@
:caption: arm
:glob:
- target/arm/**
+ target/arm/index
.. toctree::
:maxdepth: 1
@@ -30,7 +30,7 @@
:caption: Cypress
:glob:
- target/cypress/**
+ target/cypress/psoc64/index
.. toctree::
:maxdepth: 1
diff --git a/platform/ext/platform_introduction.rst b/platform/ext/platform_introduction.rst
index b895e29..b9e043e 100644
--- a/platform/ext/platform_introduction.rst
+++ b/platform/ext/platform_introduction.rst
@@ -30,7 +30,7 @@
<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>`_
- - 'B-U585I-IOT02A.
+ - `B-U585I-IOT02A.
<https://www.st.com/en/evaluation-tools/B-U585I-IOT02A.html>`_
- `NUCLEO L552ZE Q.
<https://www.st.com/content/st_com/en/products/evaluation-tools/product-evaluation-tools/mcu-mpu-eval-tools/stm32-mcu-mpu-eval-tools/stm32-nucleo-boards/nucleo-l552ze-q.html>`_
diff --git a/platform/ext/target/arm/corstone1000/index.rst b/platform/ext/target/arm/corstone1000/index.rst
new file mode 100755
index 0000000..9e3136b
--- /dev/null
+++ b/platform/ext/target/arm/corstone1000/index.rst
@@ -0,0 +1,13 @@
+Arm Corstone-1000
+=================
+
+.. toctree::
+ :maxdepth: 1
+ :glob:
+
+ readme.rst
+ openamp/**
+
+--------------
+
+*Copyright (c) 2022, Arm Limited. All rights reserved.*
diff --git a/platform/ext/target/arm/index.rst b/platform/ext/target/arm/index.rst
new file mode 100755
index 0000000..3e71053
--- /dev/null
+++ b/platform/ext/target/arm/index.rst
@@ -0,0 +1,14 @@
+Arm platforms
+=============
+
+.. toctree::
+ :maxdepth: 1
+ :glob:
+
+ corstone1000/index
+ mps3/**
+ musca_b1/**
+
+--------------
+
+*Copyright (c) 2022, Arm Limited. All rights reserved.*
diff --git a/platform/ext/target/cypress/psoc64/cypress_psoc64_spec.rst b/platform/ext/target/cypress/psoc64/cypress_psoc64_spec.rst
index 9d88b43..045f79b 100644
--- a/platform/ext/target/cypress/psoc64/cypress_psoc64_spec.rst
+++ b/platform/ext/target/cypress/psoc64/cypress_psoc64_spec.rst
@@ -183,9 +183,8 @@
Signing
*******
-############
Signing keys
-############
+============
Copy secure keys used in the board provisioning process to
platform/ext/target/cypress/psoc64/security/keys:
@@ -236,9 +235,8 @@
cysecuretools -t cy8ckit-064s0s2-4343w -p policy/policy_multi_CM0_CM4_tfm.json re-provision-device
-##################
Signing the images
-##################
+==================
Sign the images using CySecureTools CLI tool.
Note: the tool overwrites unsigned file with a signed one, it also creates an
diff --git a/platform/ext/target/cypress/psoc64/index.rst b/platform/ext/target/cypress/psoc64/index.rst
new file mode 100755
index 0000000..d4f6d00
--- /dev/null
+++ b/platform/ext/target/cypress/psoc64/index.rst
@@ -0,0 +1,19 @@
+Cypress PSoC64
+==============
+
+.. toctree::
+ :maxdepth: 1
+ :caption: Specifics
+
+ cypress_psoc64_spec.rst
+
+.. toctree::
+ :maxdepth: 1
+ :caption: Libraries
+ :glob:
+
+ libs/**
+
+--------------
+
+*Copyright (c) 2022, Arm Limited. All rights reserved.*