18eb9490bSPaul BeesleyRelease Processes 28eb9490bSPaul Beesley================= 38eb9490bSPaul Beesley 48eb9490bSPaul BeesleyProject Release Cadence 58eb9490bSPaul Beesley----------------------- 68eb9490bSPaul Beesley 78eb9490bSPaul BeesleyThe project currently aims to do a release once every 6 months which will be 88eb9490bSPaul Beesleytagged on the master branch. There will be a code freeze (stop merging 9e69f3500Slaurenw-armnon-essential changes) up to 4 weeks prior to the target release date. The release 108eb9490bSPaul Beesleycandidates will start appearing after this and only bug fixes or updates 118eb9490bSPaul Beesleyrequired for the release will be merged. The maintainers are free to use their 12e69f3500Slaurenw-armjudgement on what changes are essential for the release. A release branch may be 13e69f3500Slaurenw-armcreated after code freeze if there are significant changes that need merging onto 148eb9490bSPaul Beesleythe integration branch during the merge window. 158eb9490bSPaul Beesley 168eb9490bSPaul BeesleyThe release testing will be performed on release candidates and depending on 178eb9490bSPaul Beesleyissues found, additional release candidates may be created to fix the issues. 188eb9490bSPaul Beesley 198eb9490bSPaul Beesley:: 208eb9490bSPaul Beesley 218eb9490bSPaul Beesley |<----------6 months---------->| 228eb9490bSPaul Beesley |<---4 weeks--->| |<---4 weeks--->| 238eb9490bSPaul Beesley +-----------------------------------------------------------> time 248eb9490bSPaul Beesley | | | | 258eb9490bSPaul Beesley code freeze ver w.x code freeze ver y.z 268eb9490bSPaul Beesley 278eb9490bSPaul Beesley 283e56c69fSYann GautierVersion numbering 293e56c69fSYann Gautier~~~~~~~~~~~~~~~~~ 303e56c69fSYann GautierTF-A version is given in Makefile, through several macros: 313e56c69fSYann Gautier 323e56c69fSYann Gautier- VERSION_MAJOR 333e56c69fSYann Gautier- VERSION_MINOR 343e56c69fSYann Gautier- VERSION_PATCH 353e56c69fSYann Gautier 363e56c69fSYann GautierFor example, TF-A v2.10 has VERSION_MAJOR=2, VERSION_MINOR=10 and VERSION_PATCH=0. 373e56c69fSYann Gautier 38d39c2f38SGovindraj RajaThis VERSION_PATCH macro is only increased for :ref:`LTS - Long-Term Support` releases. 393e56c69fSYann Gautier 408eb9490bSPaul BeesleyUpcoming Releases 418eb9490bSPaul Beesley~~~~~~~~~~~~~~~~~ 428eb9490bSPaul Beesley 438eb9490bSPaul BeesleyThese are the estimated dates for the upcoming release. These may change 448eb9490bSPaul Beesleydepending on project requirement and partner feedback. 458eb9490bSPaul Beesley 468eb9490bSPaul Beesley+-----------------+---------------------------+------------------------------+ 478eb9490bSPaul Beesley| Release Version | Target Date | Expected Code Freeze | 488eb9490bSPaul Beesley+=================+===========================+==============================+ 498eb9490bSPaul Beesley| v2.0 | 1st week of Oct '18 | 1st week of Sep '18 | 508eb9490bSPaul Beesley+-----------------+---------------------------+------------------------------+ 518eb9490bSPaul Beesley| v2.1 | 5th week of Mar '19 | 1st week of Mar '19 | 528eb9490bSPaul Beesley+-----------------+---------------------------+------------------------------+ 53e69f3500Slaurenw-arm| v2.2 | 4th week of Oct '19 | 1st week of Oct '19 | 54e69f3500Slaurenw-arm+-----------------+---------------------------+------------------------------+ 55fa65b0e4Slaurenw-arm| v2.3 | 4th week of Apr '20 | 1st week of Apr '20 | 56e69f3500Slaurenw-arm+-----------------+---------------------------+------------------------------+ 57f329442cSManish V Badarkhe| v2.4 | 2nd week of Nov '20 | 4th week of Oct '20 | 583056819bSlaurenw-arm+-----------------+---------------------------+------------------------------+ 59a6edefe0SMadhukar Pappireddy| v2.5 | 3rd week of May '21 | 5th week of Apr '21 | 60c20bbfa1SManish V Badarkhe+-----------------+---------------------------+------------------------------+ 61c90fa472SBipin Ravi| v2.6 | 4th week of Nov '21 | 2nd week of Nov '21 | 621328076cSMadhukar Pappireddy+-----------------+---------------------------+------------------------------+ 6306c6f653SDaniel Boulby| v2.7 | 5th week of May '22 | 3rd week of May '22 | 6406c6f653SDaniel Boulby+-----------------+---------------------------+------------------------------+ 6506c6f653SDaniel Boulby| v2.8 | 5th week of Nov '22 | 3rd week of Nov '22 | 663e80e840SBipin Ravi+-----------------+---------------------------+------------------------------+ 673fb7d622SHarrison Mutai| v2.9 | 4th week of May '23 | 2nd week of May '23 | 683fb7d622SHarrison Mutai+-----------------+---------------------------+------------------------------+ 692226b453SOlivier Deprez| v2.10 | 4th week of Nov '23 | 2nd week of Nov '23 | 70a846d33aSJoanna Farley+-----------------+---------------------------+------------------------------+ 717c9720f2SHarrison Mutai| v2.11 | 4th week of May '24 | 2nd week of May '24 | 727c9720f2SHarrison Mutai+-----------------+---------------------------+------------------------------+ 73b80feed7SOlivier Deprez| v2.12 | 4th week of Nov '24 | 2nd week of Nov '24 | 74b80feed7SOlivier Deprez+-----------------+---------------------------+------------------------------+ 75368e4fa5SGovindraj Raja| v2.13 | 4th week of May '25 | 2nd week of May '25 | 76368e4fa5SGovindraj Raja+-----------------+---------------------------+------------------------------+ 77*7b4c906fSGovindraj Raja| v2.14 | 4th week of Nov '25 | 2nd week of Nov '25 | 78*7b4c906fSGovindraj Raja+-----------------+---------------------------+------------------------------+ 798eb9490bSPaul Beesley 808eb9490bSPaul BeesleyRemoval of Deprecated Interfaces 818eb9490bSPaul Beesley-------------------------------- 828eb9490bSPaul Beesley 83a6a1dcbeSSandrine BailleuxAs mentioned in the :ref:`Platform Ports Policy`, this is a live document 84a6a1dcbeSSandrine Bailleuxcataloging all the deprecated interfaces in TF-A project and the Release version 85a6a1dcbeSSandrine Bailleuxafter which it will be removed. 868eb9490bSPaul Beesley 878eb9490bSPaul Beesley+--------------------------------+-------------+---------+---------------------------------------------------------+ 888eb9490bSPaul Beesley| Interface | Deprecation | Removed | Comments | 898eb9490bSPaul Beesley| | Date | after | | 908eb9490bSPaul Beesley| | | Release | | 918eb9490bSPaul Beesley+================================+=============+=========+=========================================================+ 928dd2a64aSYann Gautier| | | | | 9340f9f644SNicolas Toromanoff+--------------------------------+-------------+---------+---------------------------------------------------------+ 941dc77d43SSandrine Bailleux 951dc77d43SSandrine BailleuxRemoval of Deprecated Drivers 961dc77d43SSandrine Bailleux----------------------------- 971dc77d43SSandrine Bailleux 981dc77d43SSandrine BailleuxAs mentioned in the :ref:`Platform Ports Policy`, this is a live document 991dc77d43SSandrine Bailleuxcataloging all the deprecated drivers in TF-A project and the Release version 1001dc77d43SSandrine Bailleuxafter which it will be removed. 1011dc77d43SSandrine Bailleux 1021dc77d43SSandrine Bailleux+--------------------------------+-------------+---------+---------------------------------------------------------+ 1031dc77d43SSandrine Bailleux| Driver | Deprecation | Removed | Comments | 1041dc77d43SSandrine Bailleux| | Date | after | | 1051dc77d43SSandrine Bailleux| | | Release | | 1061dc77d43SSandrine Bailleux+================================+=============+=========+=========================================================+ 107b65dfe40SSandrine Bailleux| None at this time. | | | | 10847c8dcfdSSandrine Bailleux+--------------------------------+-------------+---------+---------------------------------------------------------+ 1098eb9490bSPaul Beesley 110c643188fSGovindraj RajaBuild Options deprecated/removed 111c643188fSGovindraj Raja~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 112c643188fSGovindraj Raja 113c643188fSGovindraj RajaPopulated table provides details about build options that were removed or deprecated. 114c643188fSGovindraj Raja 115c643188fSGovindraj Raja+-----------------------+--------------------------------+ 116c643188fSGovindraj Raja| Build Option | Deprecated from TF-A Version | 117c643188fSGovindraj Raja+=======================+================================+ 1186f2b8810SSona Mathew| | | 119c643188fSGovindraj Raja+-----------------------+--------------------------------+ 1206f2b8810SSona Mathew| | | 121c643188fSGovindraj Raja+-----------------------+--------------------------------+ 122c643188fSGovindraj Raja 1238eb9490bSPaul Beesley-------------- 1248eb9490bSPaul Beesley 125d39c2f38SGovindraj Raja*Copyright (c) 2018-2025, Arm Limited and Contributors. All rights reserved.* 126