Doc: Update ITS documentation
Introducing new configuration parameters to aid defining a
ITS_SECTOR_SIZE.
Change-Id: I358ecfc627c935c572d99839cdb42edeecd0c2b0
Signed-off-by: David Hu <david.hu@arm.com>
diff --git a/docs/user_guides/services/tfm_its_integration_guide.rst b/docs/user_guides/services/tfm_its_integration_guide.rst
index ef3691d..cc54523 100644
--- a/docs/user_guides/services/tfm_its_integration_guide.rst
+++ b/docs/user_guides/services/tfm_its_integration_guide.rst
@@ -149,15 +149,10 @@
The CMSIS flash interface **must** be implemented for each target based on
its flash controller.
-The block size (``ITS_SECTOR_SIZE``) and number of blocks
-(``ITS_NBR_OF_SECTORS``) used by the internal trusted storage area, are defined
-in ``flash_layout.h`` located in ``platform/ext/target/<TARGET_NAME>/partition``.
-Those values **must** be defined in that header file based on internal flash
-specifications and vendor specific considerations.
-It is also required to define the ``ITS_FLASH_AREA_ADDR`` which defines the
-address of the first sector to be used as internal trusted storage. The sectors
-reserved to be used as internal trusted storage **must** be contiguous sectors
-starting at ``ITS_FLASH_AREA_ADDR``.
+The ITS flash interface depends on target-specific definitions from
+``platform/ext/target/<TARGET_NAME>/partition/flash_layout.h``.
+Please see the `Internal Trusted Storage Service Definitions` section for
+details.
*****************************
ITS Service Integration Guide
@@ -178,9 +173,11 @@
- ``ITS_FLASH_AREA_ADDR`` - Defines the flash address where the internal trusted
storage area starts.
+- ``ITS_FLASH_AREA_SIZE`` - Defines the size of the dedicated flash area for
+ internal trusted storage.
- ``ITS_SECTOR_SIZE`` - Defines the size of the flash sectors.
-- ``ITS_NBR_OF_SECTORS`` - Defines the number of sectors available for the
- internal trusted storage area. The sectors must be consecutive.
+- ``ITS_SECTORS_PER_BLOCK`` - Defines the number of contiguous ITS_SECTOR_SIZE
+ to form an ITS_BLOCK_SIZE.
- ``ITS_FLASH_DEV_NAME`` - Specifies the flash device used by ITS to store the
data.
- ``ITS_FLASH_PROGRAM_UNIT`` - Defines the smallest flash programmable unit in
@@ -195,6 +192,9 @@
the filesystem metadata tables is allocated statically as ITS does not use
dynamic memory allocation.
+The sectors reserved to be used as internal trusted storage **must** be
+contiguous sectors starting at ``ITS_FLASH_AREA_ADDR``.
+
Target must provide a header file, called ``flash_layout.h``, which defines the
information explained above. The defines must be named as they are specified
above.
diff --git a/platform/ext/readme.rst b/platform/ext/readme.rst
index b16a8de..a5f7e03 100644
--- a/platform/ext/readme.rst
+++ b/platform/ext/readme.rst
@@ -183,9 +183,11 @@
- ``ITS_FLASH_AREA_ADDR`` - Defines the flash area address where the internal
trusted storage area starts.
+- ``ITS_FLASH_AREA_SIZE`` - Defines the size of the dedicated flash area for the
+ internal trusted storage.
- ``ITS_SECTOR_SIZE`` - Defines the size of the internal flash sectors.
-- ``ITS_NBR_OF_SECTORS`` - Defines the number of sectors available for the
- internal trusted storage area.
+- ``ITS_SECTORS_PER_BLOCK`` - Defines the number of contiguous ITS_SECTOR_SIZE
+ to form an ITS_BLOCK_SIZE.
- ``ITS_FLASH_DEV_NAME`` - Specifies the internal flash device used by ITS to
store the data.
- ``ITS_FLASH_PROGRAM_UNIT`` - Defines the smallest flash programmable unit in