1Release Processes 2================= 3 4Project Release Cadence 5----------------------- 6 7The project currently aims to do a release once every 6 months which will be 8tagged on the master branch. There will be a code freeze (stop merging 9non-essential changes) up to 4 weeks prior to the target release date. The release 10candidates will start appearing after this and only bug fixes or updates 11required for the release will be merged. The maintainers are free to use their 12judgement on what changes are essential for the release. A release branch may be 13created after code freeze if there are significant changes that need merging onto 14the integration branch during the merge window. 15 16The release testing will be performed on release candidates and depending on 17issues found, additional release candidates may be created to fix the issues. 18 19:: 20 21 |<----------6 months---------->| 22 |<---4 weeks--->| |<---4 weeks--->| 23 +-----------------------------------------------------------> time 24 | | | | 25 code freeze ver w.x code freeze ver y.z 26 27 28Version numbering 29~~~~~~~~~~~~~~~~~ 30TF-A version is given in Makefile, through several macros: 31 32- VERSION_MAJOR 33- VERSION_MINOR 34- VERSION_PATCH 35 36For example, TF-A v2.10 has VERSION_MAJOR=2, VERSION_MINOR=10 and VERSION_PATCH=0. 37 38This VERSION_PATCH macro is only increased for LTS releases. 39 40Upcoming Releases 41~~~~~~~~~~~~~~~~~ 42 43These are the estimated dates for the upcoming release. These may change 44depending on project requirement and partner feedback. 45 46+-----------------+---------------------------+------------------------------+ 47| Release Version | Target Date | Expected Code Freeze | 48+=================+===========================+==============================+ 49| v2.0 | 1st week of Oct '18 | 1st week of Sep '18 | 50+-----------------+---------------------------+------------------------------+ 51| v2.1 | 5th week of Mar '19 | 1st week of Mar '19 | 52+-----------------+---------------------------+------------------------------+ 53| v2.2 | 4th week of Oct '19 | 1st week of Oct '19 | 54+-----------------+---------------------------+------------------------------+ 55| v2.3 | 4th week of Apr '20 | 1st week of Apr '20 | 56+-----------------+---------------------------+------------------------------+ 57| v2.4 | 2nd week of Nov '20 | 4th week of Oct '20 | 58+-----------------+---------------------------+------------------------------+ 59| v2.5 | 3rd week of May '21 | 5th week of Apr '21 | 60+-----------------+---------------------------+------------------------------+ 61| v2.6 | 4th week of Nov '21 | 2nd week of Nov '21 | 62+-----------------+---------------------------+------------------------------+ 63| v2.7 | 5th week of May '22 | 3rd week of May '22 | 64+-----------------+---------------------------+------------------------------+ 65| v2.8 | 5th week of Nov '22 | 3rd week of Nov '22 | 66+-----------------+---------------------------+------------------------------+ 67| v2.9 | 4th week of May '23 | 2nd week of May '23 | 68+-----------------+---------------------------+------------------------------+ 69| v2.10 | 4th week of Nov '23 | 2nd week of Nov '23 | 70+-----------------+---------------------------+------------------------------+ 71| v2.11 | 4th week of May '24 | 2nd week of May '24 | 72+-----------------+---------------------------+------------------------------+ 73| v2.12 | 4th week of Nov '24 | 2nd week of Nov '24 | 74+-----------------+---------------------------+------------------------------+ 75 76Removal of Deprecated Interfaces 77-------------------------------- 78 79As mentioned in the :ref:`Platform Ports Policy`, this is a live document 80cataloging all the deprecated interfaces in TF-A project and the Release version 81after which it will be removed. 82 83+--------------------------------+-------------+---------+---------------------------------------------------------+ 84| Interface | Deprecation | Removed | Comments | 85| | Date | after | | 86| | | Release | | 87+================================+=============+=========+=========================================================+ 88| | | | | 89+--------------------------------+-------------+---------+---------------------------------------------------------+ 90 91Removal of Deprecated Drivers 92----------------------------- 93 94As mentioned in the :ref:`Platform Ports Policy`, this is a live document 95cataloging all the deprecated drivers in TF-A project and the Release version 96after which it will be removed. 97 98+--------------------------------+-------------+---------+---------------------------------------------------------+ 99| Driver | Deprecation | Removed | Comments | 100| | Date | after | | 101| | | Release | | 102+================================+=============+=========+=========================================================+ 103| None at this time. | | | | 104+--------------------------------+-------------+---------+---------------------------------------------------------+ 105 106Build Options deprecated/removed 107~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 108 109Populated table provides details about build options that were removed or deprecated. 110 111+-----------------------+--------------------------------+ 112| Build Option | Deprecated from TF-A Version | 113+=======================+================================+ 114| CTX_INCLUDE_MTE_REGS | 2.11 | 115+-----------------------+--------------------------------+ 116| ENABLE_FEAT_MTE | 2.11 | 117+-----------------------+--------------------------------+ 118 119-------------- 120 121*Copyright (c) 2018-2024, Arm Limited and Contributors. All rights reserved.* 122