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>
diff --git a/docs/reference/services/tfm_ps_integration_guide.rst b/docs/reference/services/tfm_ps_integration_guide.rst
index 4da23a5..342011a 100644
--- a/docs/reference/services/tfm_ps_integration_guide.rst
+++ b/docs/reference/services/tfm_ps_integration_guide.rst
@@ -327,18 +327,18 @@
- ``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