aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--docs/conf.py.in8
-rw-r--r--docs/design_documents/tfm_its_512_flash.rst41
-rw-r--r--docs/user_guides/tfm_build_instruction.rst4
-rw-r--r--lib/ext/cryptocell-312-runtime/README.md14
-rw-r--r--readme.rst4
5 files changed, 38 insertions, 33 deletions
diff --git a/docs/conf.py.in b/docs/conf.py.in
index 4c5a74079b..39b2e1c7bc 100644
--- a/docs/conf.py.in
+++ b/docs/conf.py.in
@@ -1,6 +1,6 @@
# -*- coding: utf-8 -*-
#-------------------------------------------------------------------------------
-# Copyright (c) 2019, Arm Limited. All rights reserved.
+# Copyright (c) 2019-2020, Arm Limited. All rights reserved.
#
# SPDX-License-Identifier: BSD-3-Clause
#
@@ -81,7 +81,8 @@ language = None
# List of patterns, relative to source directory, that match files and
# directories to ignore when looking for source files.
# This pattern also affects html_static_path and html_extra_path .
-exclude_patterns = ['_build', 'Thumbs.db', '.DS_Store', 'readme.rst']
+exclude_patterns = ['_build', 'Thumbs.db', '.DS_Store', 'readme.rst',
+ 'platform/ext/target/cypress/psoc64/security/keys/readme.rst']
# The name of the Pygments (syntax highlighting) style to use.
pygments_style = 'sphinx'
@@ -130,6 +131,9 @@ def setup(app):
# Output file base name for HTML help builder.
htmlhelp_basename = 'TF-M doc'
+rst_prolog = """
+.. |TFM_VERSION| replace:: @SPHINXCFG_TFM_VERSION@
+"""
# -- Options for LaTeX output ------------------------------------------------
diff --git a/docs/design_documents/tfm_its_512_flash.rst b/docs/design_documents/tfm_its_512_flash.rst
index 768ec5970a..6ce144d717 100644
--- a/docs/design_documents/tfm_its_512_flash.rst
+++ b/docs/design_documents/tfm_its_512_flash.rst
@@ -1,6 +1,6 @@
-===============================================================
+###############################################################
Add support for block-aligned flash in Internal Trusted Storage
-===============================================================
+###############################################################
:Author: Minos Galanakis
:Organization: Arm Limited
@@ -38,31 +38,31 @@ Proposed implementation overview
================================
1. A new block-sized static buffer should be added to its_flash.c when
-``ITS_FLASH_PROGRAM_UNIT`` is larger than currently supported.
+ ``ITS_FLASH_PROGRAM_UNIT`` is larger than currently supported.
2. Methods calling the flash API such as ``its_flash_write()`` or
-``its_flash_block_to_block_move()`` will populate the buffer instead of
-directly programming the flash.
+ ``its_flash_block_to_block_move()`` will populate the buffer instead of
+ directly programming the flash.
3. A new method ``its_flash_flush()``, should be provided in order to flush
-the block buffer to the device.
-4. ``its_flash_flush()`` should be called twice: Once after a data block update
-and once more after the metadata block update is completed.
-4. The proposed design should require that the data block update is
-always completed before the metadata block update starts
-5. Writes to the block buffer should be atomic, and guarded against corruption
-by data from different blocks.
+ the block buffer to the device.
+4. ``its_flash_flush()`` should be called twice: Once after a data block
+ update and once more after the metadata block update is completed.
+5. The proposed design should require that the data block update is always
+ completed before the metadata block update starts
+6. Writes to the block buffer should be atomic, and guarded against corruption
+ by data from different blocks.
Considerations
==============
- The proposed implementation will increase the RAM usage of ITS by the size
-of a block, only for platforms which require block-aligned writes.
+ of a block, only for platforms which require block-aligned writes.
- Currently power-failure is detected by software by incrementing an 8-bit
-metadata header field (``swap_count``), as the last written byte. When the
-proposed block-buffer is used, the block is programmed in one-shot and the
-order the bytes are written on the physical device, is hardware dependent.
+ metadata header field (``swap_count``), as the last written byte. When the
+ proposed block-buffer is used, the block is programmed in one-shot and the
+ order the bytes are written on the physical device, is hardware dependent.
- A set of guarantees are required by the supported flash ECC devices.
-The device's flash APIs should provide a mechanism to capture and raise
-incomplete program operations, as well as write bytes in a sequential order.
+ The device's flash APIs should provide a mechanism to capture and raise
+ incomplete program operations, as well as write bytes in a sequential order.
For example, if a board powers down through a 512 page program operation, the
next read operation should return an error rather than read invalid data.
@@ -72,6 +72,8 @@ Functional flow diagram
The logic of the proposal is described in the following diagram
+.. code-block::
+
|----------------------|
| data write() |
|----------------------|
@@ -97,7 +99,6 @@ The logic of the proposal is described in the following diagram
| Operation Complete |
|--------------------------|
-
--------------
-*Copyright (c) 2019, Arm Limited. All rights reserved.*
+*Copyright (c) 2019-2020, Arm Limited. All rights reserved.*
diff --git a/docs/user_guides/tfm_build_instruction.rst b/docs/user_guides/tfm_build_instruction.rst
index b7ab2c0e4f..7257ec74d6 100644
--- a/docs/user_guides/tfm_build_instruction.rst
+++ b/docs/user_guides/tfm_build_instruction.rst
@@ -214,7 +214,7 @@ line arguments:
``-DTARGET_PLATFORM=AN524``
- Cypress CYS0644ABZI-S2D44 board (PSoC64 platform)
``-DTARGET_PLATFORM=psoc64``
- See :doc:`Cypress PSoC 64 platform specifics </platform/ext/target/cypress/psoc64/cypress_psoc_64_spec>`
+ See :doc:`Cypress PSoC 64 platform specifics </platform/ext/target/cypress/psoc64/cypress_psoc64_spec>`
- DesignStart FPGA on Cloud: Cortex-M33 based platform (SSE-200_AWS platform)
``-DTARGET_PLATFORM=SSE-200_AWS``
@@ -250,4 +250,4 @@ line arguments:
--------------
-*Copyright (c) 2017-2019, Arm Limited. All rights reserved.*
+*Copyright (c) 2017-2020, Arm Limited. All rights reserved.*
diff --git a/lib/ext/cryptocell-312-runtime/README.md b/lib/ext/cryptocell-312-runtime/README.md
index 282ed4b433..6b9a2669a9 100644
--- a/lib/ext/cryptocell-312-runtime/README.md
+++ b/lib/ext/cryptocell-312-runtime/README.md
@@ -1,14 +1,14 @@
# cryptocell-312-runtime
-Refer to docs/cc312_cryptocell_runtime_software_developers_manual*.pdf for APIs documentation.
+Refer to `cc312_cryptocell_runtime_software_developers_manual
+<https://git.trustedfirmware.org/trusted-firmware-m.git/plain/lib/ext/cryptocell-312-runtime/docs/cc312_cryptocell_runtime_software_developers_manual_101122_0103_01_en.pdf>`_
+for APIs documentation.
-Refer to docs/cc312_r1_oss_rt_sw-*_ReleaseNote.pdf for additional information ( contents, build commands and more).
-# cryptocell-312-runtime
-
-Refer to docs/cc312_cryptocell_runtime_software_developers_manual*.pdf for APIs documentation.
-Refer to docs/cc312_r1_oss_rt_sw-*_ReleaseNote.pdf for additional information ( contents, build commands and more).
+Refer to `cc312_r1_oss_rt_sw-r1p3-00rel0_ReleaseNote
+<https://git.trustedfirmware.org/trusted-firmware-m.git/plain/lib/ext/cryptocell-312-runtime/docs/cc312_r1_oss_rt_sw-r1p3-00rel0_ReleaseNote.pdf>`_
+for additional information ( contents, build commands and more ).
--------------
-Copyright (c) 2001-2019, Arm Limited. All rights reserved.
+Copyright (c) 2001-2020, Arm Limited. All rights reserved.
diff --git a/readme.rst b/readme.rst
index c115cb748b..2118adab8c 100644
--- a/readme.rst
+++ b/readme.rst
@@ -41,8 +41,8 @@ Feedback can be submitted via email to
.. _ARMv8-M Architecture: https://developer.arm.com/docs/100688/latest/an-introduction-to-the-armv8-m-architecture
.. _Platform Security Architecture: https://www.arm.com/why-arm/architecture/platform-security-architecture
.. _PSA certified: https://www.psacertified.org/
-.. _Trusted Firmware-M documentation: Documentation home_
+.. _Trusted Firmware-M documentation: `Documentation home`_
.. _Documentation home: https://ci.trustedfirmware.org/job/tf-m-build-test-nightly/lastSuccessfulBuild/artifact/build-docs/tf-m_documents/install/doc/user_guide/html/docs/readme.html
.. _trustedfirmware.org: http://www.trustedfirmware.org
-*Copyright (c) 2017-2019, Arm Limited. All rights reserved.*
+*Copyright (c) 2017-2020, Arm Limited. All rights reserved.*