83 lines
5.7 KiB
ReStructuredText
83 lines
5.7 KiB
ReStructuredText
|
Release Processes
|
||
|
|
=================
|
||
|
|
|
||
|
|
Project Release Cadence
|
||
|
|
-----------------------
|
||
|
|
|
||
|
|
The project currently aims to do a release once every 6 months which will be
|
||
|
|
tagged on the master branch. There will be a code freeze (stop merging
|
||
|
|
non-essential PRs) up to 4 weeks prior to the target release date. The release
|
||
|
|
candidates will start appearing after this and only bug fixes or updates
|
||
|
|
required for the release will be merged. The maintainers are free to use their
|
||
|
|
judgement on what PRs are essential for the release. A release branch may be
|
||
|
|
created after code freeze if there are significant PRs that need merging onto
|
||
|
|
the integration branch during the merge window.
|
||
|
|
|
||
|
|
The release testing will be performed on release candidates and depending on
|
||
|
|
issues found, additional release candidates may be created to fix the issues.
|
||
|
|
|
||
|
|
::
|
||
|
|
|
||
|
|
|<----------6 months---------->|
|
||
|
|
|<---4 weeks--->| |<---4 weeks--->|
|
||
|
|
+-----------------------------------------------------------> time
|
||
|
|
| | | |
|
||
|
|
code freeze ver w.x code freeze ver y.z
|
||
|
|
|
||
|
|
|
||
|
|
Upcoming Releases
|
||
|
|
~~~~~~~~~~~~~~~~~
|
||
|
|
|
||
|
|
These are the estimated dates for the upcoming release. These may change
|
||
|
|
depending on project requirement and partner feedback.
|
||
|
|
|
||
|
|
+-----------------+---------------------------+------------------------------+
|
||
|
|
| Release Version | Target Date | Expected Code Freeze |
|
||
|
|
+=================+===========================+==============================+
|
||
|
|
| v2.0 | 1st week of Oct '18 | 1st week of Sep '18 |
|
||
|
|
+-----------------+---------------------------+------------------------------+
|
||
|
|
| v2.1 | 5th week of Mar '19 | 1st week of Mar '19 |
|
||
|
|
+-----------------+---------------------------+------------------------------+
|
||
|
|
|
||
|
|
Removal of Deprecated Interfaces
|
||
|
|
--------------------------------
|
||
|
|
|
||
|
|
As mentioned in the `Platform compatibility policy`_, this is a live document
|
||
|
|
cataloging all the deprecated interfaces in TF-A project and the Release version
|
||
|
|
after which it will be removed.
|
||
|
|
|
||
|
|
+--------------------------------+-------------+---------+---------------------------------------------------------+
|
||
|
|
| Interface | Deprecation | Removed | Comments |
|
||
|
|
| | Date | after | |
|
||
|
|
| | | Release | |
|
||
|
|
+================================+=============+=========+=========================================================+
|
||
|
|
| Legacy Console API | Jan '18 | v2.1 | Deprecated in favour of ``MULTI_CONSOLE_API`` |
|
||
|
|
+--------------------------------+-------------+---------+---------------------------------------------------------+
|
||
|
|
| Weak default | Oct '18 | v2.1 | The default implementations are defined in |
|
||
|
|
| ``plat_crash_console_*`` | | | `crash_console_helpers.S`_. The platforms have to |
|
||
|
|
| APIs | | | define ``plat_crash_console_*``. |
|
||
|
|
+--------------------------------+-------------+---------+---------------------------------------------------------+
|
||
|
|
| ``finish_console_register`` | Oct '18 | v2.1 | The old version of the macro is deprecated. See commit |
|
||
|
|
| macro in | | | cc5859c_ for more details. |
|
||
|
|
| ``MULTI_CONSOLE_API`` | | | |
|
||
|
|
+--------------------------------+-------------+---------+---------------------------------------------------------+
|
||
|
|
| Types ``tzc_action_t`` and | Oct '18 | v2.1 | Using logical operations such as OR in enumerations |
|
||
|
|
| ``tzc_region_attributes_t`` | | | goes against the MISRA guidelines. |
|
||
|
|
+--------------------------------+-------------+---------+---------------------------------------------------------+
|
||
|
|
| Macro ``EL_IMPLEMENTED()`` | Oct '18 | v2.1 | Deprecated in favour of ``el_implemented()``. |
|
||
|
|
+--------------------------------+-------------+---------+---------------------------------------------------------+
|
||
|
|
| ``get_afflvl_shift()``, | Dec '18 | v2.1 | Removed. |
|
||
|
|
| ``mpidr_mask_lower_afflvls()``,| | | |
|
||
|
|
| and ``eret()``. | | | |
|
||
|
|
+--------------------------------+-------------+---------+---------------------------------------------------------+
|
||
|
|
| Extra include paths in the | Jan '18 | v2.1 | Now it is needed to use the full path of the common |
|
||
|
|
| Makefile in ``INCLUDES``. | | | header files. More information in commit 09d40e0e0828_. |
|
||
|
|
+--------------------------------+-------------+---------+---------------------------------------------------------+
|
||
|
|
|
||
|
|
*Copyright (c) 2018-2019, Arm Limited and Contributors. All rights reserved.*
|
||
|
|
|
||
|
|
.. _Platform compatibility policy: platform-compatibility-policy.rst
|
||
|
|
.. _crash_console_helpers.S: https://git.trustedfirmware.org/TF-A/trusted-firmware-a.git/tree/plat/common/aarch64/crash_console_helpers.S
|
||
|
|
.. _cc5859c: https://git.trustedfirmware.org/TF-A/trusted-firmware-a.git/commit/?id=cc5859ca19ff546c35eb0331000dae090b6eabcf
|
||
|
|
.. _09d40e0e0828: https://git.trustedfirmware.org/TF-A/trusted-firmware-a.git/commit/?id=09d40e0e08283a249e7dce0e106c07c5141f9b7e
|