xref: /rk3399_ARM-atf/docs/about/release-information.rst (revision 6251d6ed1ffa7080edc55fa75f525e19ecf5edbd)
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+-----------------+---------------------------+------------------------------+
777b4c906fSGovindraj Raja| v2.14           | 4th week of Nov '25       | 2nd week of Nov '25          |
787b4c906fSGovindraj Raja+-----------------+---------------------------+------------------------------+
7950cb1b6dSGovindraj Raja| v2.15           | 4th week of May '26       | 2nd week of May '26          |
8050cb1b6dSGovindraj Raja+-----------------+---------------------------+------------------------------+
818eb9490bSPaul Beesley
828eb9490bSPaul BeesleyRemoval of Deprecated Interfaces
838eb9490bSPaul Beesley--------------------------------
848eb9490bSPaul Beesley
85a6a1dcbeSSandrine BailleuxAs mentioned in the :ref:`Platform Ports Policy`, this is a live document
86a6a1dcbeSSandrine Bailleuxcataloging all the deprecated interfaces in TF-A project and the Release version
87a6a1dcbeSSandrine Bailleuxafter which it will be removed.
888eb9490bSPaul Beesley
898eb9490bSPaul Beesley+--------------------------------+-------------+---------+---------------------------------------------------------+
908eb9490bSPaul Beesley| Interface                      | Deprecation | Removed | Comments                                                |
918eb9490bSPaul Beesley|                                | Date        | after   |                                                         |
928eb9490bSPaul Beesley|                                |             | Release |                                                         |
938eb9490bSPaul Beesley+================================+=============+=========+=========================================================+
948dd2a64aSYann Gautier|                                |             |         |                                                         |
9540f9f644SNicolas Toromanoff+--------------------------------+-------------+---------+---------------------------------------------------------+
961dc77d43SSandrine Bailleux
971dc77d43SSandrine BailleuxRemoval of Deprecated Drivers
981dc77d43SSandrine Bailleux-----------------------------
991dc77d43SSandrine Bailleux
1001dc77d43SSandrine BailleuxAs mentioned in the :ref:`Platform Ports Policy`, this is a live document
1011dc77d43SSandrine Bailleuxcataloging all the deprecated drivers in TF-A project and the Release version
1021dc77d43SSandrine Bailleuxafter which it will be removed.
1031dc77d43SSandrine Bailleux
1041dc77d43SSandrine Bailleux+--------------------------------+-------------+---------+---------------------------------------------------------+
1051dc77d43SSandrine Bailleux| Driver                         | Deprecation | Removed | Comments                                                |
1061dc77d43SSandrine Bailleux|                                | Date        | after   |                                                         |
1071dc77d43SSandrine Bailleux|                                |             | Release |                                                         |
1081dc77d43SSandrine Bailleux+================================+=============+=========+=========================================================+
109b65dfe40SSandrine Bailleux| None at this time.             |             |         |                                                         |
11047c8dcfdSSandrine Bailleux+--------------------------------+-------------+---------+---------------------------------------------------------+
1118eb9490bSPaul Beesley
112c643188fSGovindraj RajaBuild Options deprecated/removed
1132c344bf8SOlivier Deprez--------------------------------
114c643188fSGovindraj Raja
115c643188fSGovindraj RajaPopulated table provides details about build options that were removed or deprecated.
116c643188fSGovindraj Raja
117c643188fSGovindraj Raja+-----------------------+--------------------------------+
118c643188fSGovindraj Raja| Build Option          | Deprecated from TF-A Version   |
119c643188fSGovindraj Raja+=======================+================================+
1202c344bf8SOlivier Deprez| NS_TIMER_SWITCH       | v2.14.0                        |
121c643188fSGovindraj Raja+-----------------------+--------------------------------+
122*1988ea81SOlivier Deprez| SPM_MM                | v2.14.0                        |
123c643188fSGovindraj Raja+-----------------------+--------------------------------+
124c643188fSGovindraj Raja
1258eb9490bSPaul Beesley--------------
1268eb9490bSPaul Beesley
127d39c2f38SGovindraj Raja*Copyright (c) 2018-2025, Arm Limited and Contributors. All rights reserved.*
128