| Joel Hutton | 9e60563 | 2019-02-25 15:18:56 +0000 | [diff] [blame] | 1 | TF-A Release Information |
| 2 | ======================== |
| 3 | |
| 4 | .. section-numbering:: |
| 5 | :suffix: . |
| 6 | |
| 7 | .. contents:: |
| 8 | |
| 9 | -------------- |
| 10 | |
| 11 | Project Release Cadence |
| 12 | ----------------------- |
| 13 | |
| 14 | The project currently aims to do a release once every 6 months which will be |
| 15 | tagged on the master branch. There will be a code freeze (stop merging |
| 16 | non-essential PRs) up to 4 weeks prior to the target release date. The release |
| 17 | candidates will start appearing after this and only bug fixes or updates |
| 18 | required for the release will be merged. The maintainers are free to use their |
| 19 | judgement on what PRs are essential for the release. A release branch may be |
| 20 | created after code freeze if there are significant PRs that need merging onto |
| 21 | the integration branch during the merge window. |
| 22 | |
| 23 | The release testing will be performed on release candidates and depending on |
| 24 | issues found, additional release candidates may be created to fix the issues. |
| 25 | |
| 26 | :: |
| 27 | |
| 28 | |<----------6 months---------->| |
| 29 | |<---4 weeks--->| |<---4 weeks--->| |
| 30 | +-----------------------------------------------------------> time |
| 31 | | | | | |
| 32 | code freeze ver w.x code freeze ver y.z |
| 33 | |
| 34 | |
| 35 | Upcoming Releases |
| 36 | ~~~~~~~~~~~~~~~~~ |
| 37 | |
| 38 | These are the estimated dates for the upcoming release. These may change |
| 39 | depending on project requirement and partner feedback. |
| 40 | |
| 41 | +-----------------+---------------------------+------------------------------+ |
| 42 | | Release Version | Target Date | Expected Code Freeze | |
| 43 | +=================+===========================+==============================+ |
| 44 | | v2.0 | 1st week of Oct '18 | 1st week of Sep '18 | |
| 45 | +-----------------+---------------------------+------------------------------+ |
| 46 | | v2.1 | 5th week of Mar '19 | 1st week of Mar '19 | |
| 47 | +-----------------+---------------------------+------------------------------+ |
| 48 | |
| 49 | Removal of Deprecated Interfaces |
| 50 | -------------------------------- |
| 51 | |
| 52 | As mentioned in the `Platform compatibility policy`_, this is a live document |
| 53 | cataloging all the deprecated interfaces in TF-A project and the Release version |
| 54 | after which it will be removed. |
| 55 | |
| 56 | +--------------------------------+-------------+---------+---------------------------------------------------------+ |
| 57 | | Interface | Deprecation | Removed | Comments | |
| 58 | | | Date | after | | |
| 59 | | | | Release | | |
| 60 | +================================+=============+=========+=========================================================+ |
| 61 | | Legacy Console API | Jan '18 | v2.1 | Deprecated in favour of ``MULTI_CONSOLE_API`` | |
| 62 | +--------------------------------+-------------+---------+---------------------------------------------------------+ |
| 63 | | Weak default | Oct '18 | v2.1 | The default implementations are defined in | |
| 64 | | ``plat_crash_console_*`` | | | `crash_console_helpers.S`_. The platforms have to | |
| 65 | | APIs | | | define ``plat_crash_console_*``. | |
| 66 | +--------------------------------+-------------+---------+---------------------------------------------------------+ |
| 67 | | ``finish_console_register`` | Oct '18 | v2.1 | The old version of the macro is deprecated. See commit | |
| 68 | | macro in | | | cc5859c_ for more details. | |
| 69 | | ``MULTI_CONSOLE_API`` | | | | |
| 70 | +--------------------------------+-------------+---------+---------------------------------------------------------+ |
| 71 | | Types ``tzc_action_t`` and | Oct '18 | v2.1 | Using logical operations such as OR in enumerations | |
| 72 | | ``tzc_region_attributes_t`` | | | goes against the MISRA guidelines. | |
| 73 | +--------------------------------+-------------+---------+---------------------------------------------------------+ |
| 74 | | Macro ``EL_IMPLEMENTED()`` | Oct '18 | v2.1 | Deprecated in favour of ``el_implemented()``. | |
| 75 | +--------------------------------+-------------+---------+---------------------------------------------------------+ |
| 76 | | ``get_afflvl_shift()``, | Dec '18 | v2.1 | Removed. | |
| 77 | | ``mpidr_mask_lower_afflvls()``,| | | | |
| 78 | | and ``eret()``. | | | | |
| 79 | +--------------------------------+-------------+---------+---------------------------------------------------------+ |
| 80 | | Extra include paths in the | Jan '18 | v2.1 | Now it is needed to use the full path of the common | |
| 81 | | Makefile in ``INCLUDES``. | | | header files. More information in commit 09d40e0e0828_. | |
| 82 | +--------------------------------+-------------+---------+---------------------------------------------------------+ |
| 83 | |
| Joel Hutton | 0f79fb1 | 2019-02-26 16:23:54 +0000 | [diff] [blame] | 84 | *Copyright (c) 2018-2019, Arm Limited and Contributors. All rights reserved.* |
| Joel Hutton | 9e60563 | 2019-02-25 15:18:56 +0000 | [diff] [blame] | 85 | |
| Joel Hutton | 0f79fb1 | 2019-02-26 16:23:54 +0000 | [diff] [blame] | 86 | .. _Platform compatibility policy: platform-compatibility-policy.rst |
| 87 | .. _crash_console_helpers.S: https://git.trustedfirmware.org/TF-A/trusted-firmware-a.git/tree/plat/common/aarch64/crash_console_helpers.S |
| 88 | .. _cc5859c: https://git.trustedfirmware.org/TF-A/trusted-firmware-a.git/commit/?id=cc5859ca19ff546c35eb0331000dae090b6eabcf |
| 89 | .. _09d40e0e0828: https://git.trustedfirmware.org/TF-A/trusted-firmware-a.git/commit/?id=09d40e0e08283a249e7dce0e106c07c5141f9b7e |