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 28*3e56c69fSYann GautierVersion numbering 29*3e56c69fSYann Gautier~~~~~~~~~~~~~~~~~ 30*3e56c69fSYann GautierTF-A version is given in Makefile, through several macros: 31*3e56c69fSYann Gautier 32*3e56c69fSYann Gautier- VERSION_MAJOR 33*3e56c69fSYann Gautier- VERSION_MINOR 34*3e56c69fSYann Gautier- VERSION_PATCH 35*3e56c69fSYann Gautier 36*3e56c69fSYann GautierFor example, TF-A v2.10 has VERSION_MAJOR=2, VERSION_MINOR=10 and VERSION_PATCH=0. 37*3e56c69fSYann Gautier 38*3e56c69fSYann GautierThis VERSION_PATCH macro is only increased for LTS releases. 39*3e56c69fSYann 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+-----------------+---------------------------+------------------------------+ 718eb9490bSPaul Beesley 728eb9490bSPaul BeesleyRemoval of Deprecated Interfaces 738eb9490bSPaul Beesley-------------------------------- 748eb9490bSPaul Beesley 75a6a1dcbeSSandrine BailleuxAs mentioned in the :ref:`Platform Ports Policy`, this is a live document 76a6a1dcbeSSandrine Bailleuxcataloging all the deprecated interfaces in TF-A project and the Release version 77a6a1dcbeSSandrine Bailleuxafter which it will be removed. 788eb9490bSPaul Beesley 798eb9490bSPaul Beesley+--------------------------------+-------------+---------+---------------------------------------------------------+ 808eb9490bSPaul Beesley| Interface | Deprecation | Removed | Comments | 818eb9490bSPaul Beesley| | Date | after | | 828eb9490bSPaul Beesley| | | Release | | 838eb9490bSPaul Beesley+================================+=============+=========+=========================================================+ 8412e683a6SYann Gautier| STM32MP15_OPTEE_RSV_SHM | 2.10 | 3.0 | OP-TEE manages its own memory on STM32MP15 | 8540f9f644SNicolas Toromanoff+--------------------------------+-------------+---------+---------------------------------------------------------+ 861dc77d43SSandrine Bailleux 871dc77d43SSandrine BailleuxRemoval of Deprecated Drivers 881dc77d43SSandrine Bailleux----------------------------- 891dc77d43SSandrine Bailleux 901dc77d43SSandrine BailleuxAs mentioned in the :ref:`Platform Ports Policy`, this is a live document 911dc77d43SSandrine Bailleuxcataloging all the deprecated drivers in TF-A project and the Release version 921dc77d43SSandrine Bailleuxafter which it will be removed. 931dc77d43SSandrine Bailleux 941dc77d43SSandrine Bailleux+--------------------------------+-------------+---------+---------------------------------------------------------+ 951dc77d43SSandrine Bailleux| Driver | Deprecation | Removed | Comments | 961dc77d43SSandrine Bailleux| | Date | after | | 971dc77d43SSandrine Bailleux| | | Release | | 981dc77d43SSandrine Bailleux+================================+=============+=========+=========================================================+ 992226b453SOlivier Deprez| CryptoCell-712 | 2.9 | 2.10 | No longer maintained. | 10047c8dcfdSSandrine Bailleux+--------------------------------+-------------+---------+---------------------------------------------------------+ 1012226b453SOlivier Deprez| CryptoCell-713 | 2.9 | 2.10 | No longer maintained. | 10247c8dcfdSSandrine Bailleux+--------------------------------+-------------+---------+---------------------------------------------------------+ 1038eb9490bSPaul Beesley 1048eb9490bSPaul Beesley-------------- 1058eb9490bSPaul Beesley 1061dc77d43SSandrine Bailleux*Copyright (c) 2018-2023, Arm Limited and Contributors. All rights reserved.* 107