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 383e56c69fSYann GautierThis VERSION_PATCH macro is only increased for LTS 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+-----------------+---------------------------+------------------------------+ 71*7c9720f2SHarrison Mutai| v2.11 | 4th week of May '24 | 2nd week of May '24 | 72*7c9720f2SHarrison Mutai+-----------------+---------------------------+------------------------------+ 738eb9490bSPaul Beesley 748eb9490bSPaul BeesleyRemoval of Deprecated Interfaces 758eb9490bSPaul Beesley-------------------------------- 768eb9490bSPaul Beesley 77a6a1dcbeSSandrine BailleuxAs mentioned in the :ref:`Platform Ports Policy`, this is a live document 78a6a1dcbeSSandrine Bailleuxcataloging all the deprecated interfaces in TF-A project and the Release version 79a6a1dcbeSSandrine Bailleuxafter which it will be removed. 808eb9490bSPaul Beesley 818eb9490bSPaul Beesley+--------------------------------+-------------+---------+---------------------------------------------------------+ 828eb9490bSPaul Beesley| Interface | Deprecation | Removed | Comments | 838eb9490bSPaul Beesley| | Date | after | | 848eb9490bSPaul Beesley| | | Release | | 858eb9490bSPaul Beesley+================================+=============+=========+=========================================================+ 8612e683a6SYann Gautier| STM32MP15_OPTEE_RSV_SHM | 2.10 | 3.0 | OP-TEE manages its own memory on STM32MP15 | 8740f9f644SNicolas Toromanoff+--------------------------------+-------------+---------+---------------------------------------------------------+ 881dc77d43SSandrine Bailleux 891dc77d43SSandrine BailleuxRemoval of Deprecated Drivers 901dc77d43SSandrine Bailleux----------------------------- 911dc77d43SSandrine Bailleux 921dc77d43SSandrine BailleuxAs mentioned in the :ref:`Platform Ports Policy`, this is a live document 931dc77d43SSandrine Bailleuxcataloging all the deprecated drivers in TF-A project and the Release version 941dc77d43SSandrine Bailleuxafter which it will be removed. 951dc77d43SSandrine Bailleux 961dc77d43SSandrine Bailleux+--------------------------------+-------------+---------+---------------------------------------------------------+ 971dc77d43SSandrine Bailleux| Driver | Deprecation | Removed | Comments | 981dc77d43SSandrine Bailleux| | Date | after | | 991dc77d43SSandrine Bailleux| | | Release | | 1001dc77d43SSandrine Bailleux+================================+=============+=========+=========================================================+ 101b65dfe40SSandrine Bailleux| None at this time. | | | | 10247c8dcfdSSandrine Bailleux+--------------------------------+-------------+---------+---------------------------------------------------------+ 1038eb9490bSPaul Beesley 1048eb9490bSPaul Beesley-------------- 1058eb9490bSPaul Beesley 106f7c5ec1eSlaurenw-arm*Copyright (c) 2018-2024, Arm Limited and Contributors. All rights reserved.* 107