diff options
author | Jamie Fox <jamie.fox@arm.com> | 2020-06-12 18:21:25 +0100 |
---|---|---|
committer | Jamie Fox <jamie.fox@arm.com> | 2020-06-23 15:22:26 +0100 |
commit | f58bd227e66b399ade789f1a29c263a25e884cd1 (patch) | |
tree | 0413389ac2b1394a4bdf6d1f2b971be23445584b /docs | |
parent | 48e632b2ec2b94841d28882a06a9d7cc1488b253 (diff) | |
download | trusted-firmware-m-f58bd227e66b399ade789f1a29c263a25e884cd1.tar.gz |
Build: Disable RAM FS by default
Changes the common configuration to disable the ITS and PS RAM FS by
default, even when running the regression tests. Testing with persistent
storage allows for greater coverage of scenarios such as initialisation
with existing storage and correct erasing of flash before overwriting.
The setting can still be overridden in the platform CMake config, or by
providing it on the command line if flash wear is a concern.
Change-Id: If950e13d5f89ff164b47ed8d6602cdef5d4d6b5e
Signed-off-by: Jamie Fox <jamie.fox@arm.com>
Diffstat (limited to 'docs')
-rw-r--r-- | docs/design_documents/tfm_profile_small.rst | 3 | ||||
-rw-r--r-- | docs/reference/services/tfm_its_integration_guide.rst | 20 | ||||
-rw-r--r-- | docs/reference/services/tfm_ps_integration_guide.rst | 20 |
3 files changed, 20 insertions, 23 deletions
diff --git a/docs/design_documents/tfm_profile_small.rst b/docs/design_documents/tfm_profile_small.rst index 67f677985e..051dd3d554 100644 --- a/docs/design_documents/tfm_profile_small.rst +++ b/docs/design_documents/tfm_profile_small.rst @@ -410,9 +410,6 @@ The details will be covered in each module in `Implementation details`_. * - ``TFM_PARTITION_INTERNAL_TRUSTED_STORAGE`` - ``ON`` - Enable ITS SP - * - ``ITS_RAM_FS`` - - ``OFF`` - - Stop using RAM to simulate Flash * - ``ITS_BUF_SIZE`` - ``32`` - ITS internal transient buffer size diff --git a/docs/reference/services/tfm_its_integration_guide.rst b/docs/reference/services/tfm_its_integration_guide.rst index f6b2dec408..230117edf2 100644 --- a/docs/reference/services/tfm_its_integration_guide.rst +++ b/docs/reference/services/tfm_its_integration_guide.rst @@ -277,18 +277,18 @@ needs. The list of ITS services flags are: enable/disable the validation mechanism to check the metadata store in flash every time the flash data is read from flash. This validation is required if the flash is not hardware protected against data corruption. -- ``ITS_RAM_FS``- this flag allows to enable/disable the use of RAM - instead of the flash to store the FS in internal trusted storage service. This - flag is set by default in the regression tests, if it is not defined by the - platform. The ITS regression tests reduce the life of the flash memory - as they write/erase multiple times in the memory. +- ``ITS_RAM_FS``- setting this flag to ``ON`` enables the use of RAM instead of + the persistent storage device to store the FS in the Internal Trusted Storage + service. This flag is ``OFF`` by default. The ITS regression tests write/erase + storage multiple time, so enabling this flag can increase the life of flash + memory when testing. .. Note:: - If this flag is manually disabled when running the regression tests, - then the storage flash area should also be erased before running the tests - to ensure they run successfully. The type of storage flash area is platform - specific (QSPI, eFlash, etc.) and it is described in corresponding - flash_layout.h + If this flag is disabled when running the regression tests, then it is + recommended that the persistent storage area is erased before running the + tests to ensure that all tests can run to completion. The type of persistent + storage area is platform specific (eFlash, MRAM, etc.) and it is described + in corresponding flash_layout.h -------------- diff --git a/docs/reference/services/tfm_ps_integration_guide.rst b/docs/reference/services/tfm_ps_integration_guide.rst index 4da23a5e23..342011a71c 100644 --- a/docs/reference/services/tfm_ps_integration_guide.rst +++ b/docs/reference/services/tfm_ps_integration_guide.rst @@ -327,18 +327,18 @@ needs. The list of PS services flags are: - ``PS_ROLLBACK_PROTECTION``- this flag allows to enable/disable rollback protection in protected storage service. This flag takes effect only if the target has non-volatile counters and ``PS_ENCRYPTION`` flag is on. -- ``PS_RAM_FS``- this flag allows to enable/disable the use of RAM - instead of the flash to store the FS in protected storage service. This flag - is set by default in the regression tests, if it is not defined by the - platform. The PS regression tests reduce the life of the flash memory - as they write/erase multiple times in the memory. +- ``PS_RAM_FS``- setting this flag to ``ON`` enables the use of RAM instead of + the persistent storage device to store the FS in the Protected Storage + service. This flag is ``OFF`` by default. The PS regression tests write/erase + storage multiple time, so enabling this flag can increase the life of flash + memory when testing. .. Note:: - If this flag is manually disabled when running the regression tests, - then the storage flash area should also be erased before running the tests - to ensure they run successfully. The type of storage flash area is platform - specific (QSPI, eFlash, etc.) and it is described in corresponding - flash_layout.h + If this flag is disabled when running the regression tests, then it is + recommended that the persistent storage area is erased before running the + tests to ensure that all tests can run to completion. The type of persistent + storage area is platform specific (eFlash, MRAM, etc.) and it is described + in corresponding flash_layout.h - ``PS_TEST_NV_COUNTERS``- this flag enables the virtual implementation of the PS NV counters interface in |