TrustedFirmware Git Browser
Code Review Sign In
review.trustedfirmware.org / sandbox / arthur / trustedfirmware-a / 7b4c906f0c77a0192afadae681ab21f5db0606b4 / . / docs / about / release-information.rst
blob: 0edd314d20d9e632191e2cac663b8300173277bd [file] [log] [blame]
Paul Beesley8aa05052019-03-07 15:47:15 +0000[diff] [blame]1Release Processes
2=================
Joel Hutton4fe91232019-02-25 15:18:56 +0000[diff] [blame]3
Joel Hutton4fe91232019-02-25 15:18:56 +0000[diff] [blame]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
laurenw-arme69f3502019-10-16 16:32:16 -0500[diff] [blame]9non-essential changes) up to 4 weeks prior to the target release date. The release
Joel Hutton4fe91232019-02-25 15:18:56 +0000[diff] [blame]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
laurenw-arme69f3502019-10-16 16:32:16 -0500[diff] [blame]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
Joel Hutton4fe91232019-02-25 15:18:56 +0000[diff] [blame]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
Yann Gautier3e56c692023-10-04 18:59:44 +0200[diff] [blame]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
Govindraj Rajad39c2f32024-12-12 17:16:03 -0600[diff] [blame]38This VERSION_PATCH macro is only increased for :ref:`LTS - Long-Term Support` releases.
Yann Gautier3e56c692023-10-04 18:59:44 +0200[diff] [blame]39
Joel Hutton4fe91232019-02-25 15:18:56 +0000[diff] [blame]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+-----------------+---------------------------+------------------------------+
laurenw-arme69f3502019-10-16 16:32:16 -0500[diff] [blame]53| v2.2 | 4th week of Oct '19 | 1st week of Oct '19 |
54+-----------------+---------------------------+------------------------------+
laurenw-armfa65b0e2020-03-31 14:20:25 -0500[diff] [blame]55| v2.3 | 4th week of Apr '20 | 1st week of Apr '20 |
laurenw-arme69f3502019-10-16 16:32:16 -0500[diff] [blame]56+-----------------+---------------------------+------------------------------+
Manish V Badarkhef3294422020-10-08 02:11:20 +0100[diff] [blame]57| v2.4 | 2nd week of Nov '20 | 4th week of Oct '20 |
laurenw-arm30568192020-04-15 15:19:50 -0500[diff] [blame]58+-----------------+---------------------------+------------------------------+
Madhukar Pappireddya6edefe2021-04-26 18:53:31 -0500[diff] [blame]59| v2.5 | 3rd week of May '21 | 5th week of Apr '21 |
Manish V Badarkhec20bbfa2020-10-08 02:16:25 +0100[diff] [blame]60+-----------------+---------------------------+------------------------------+
Bipin Ravic90fa472021-10-05 15:57:06 -0500[diff] [blame]61| v2.6 | 4th week of Nov '21 | 2nd week of Nov '21 |
Madhukar Pappireddy13280762021-04-26 19:01:18 -0500[diff] [blame]62+-----------------+---------------------------+------------------------------+
Daniel Boulby06c6f652022-05-09 11:11:49 +0100[diff] [blame]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 |
Bipin Ravi3e80e842021-12-21 09:14:48 -0600[diff] [blame]66+-----------------+---------------------------+------------------------------+
Harrison Mutai3fb7d622023-04-26 16:39:08 +0100[diff] [blame]67| v2.9 | 4th week of May '23 | 2nd week of May '23 |
68+-----------------+---------------------------+------------------------------+
Olivier Deprez2226b452023-09-28 17:33:10 +0200[diff] [blame]69| v2.10 | 4th week of Nov '23 | 2nd week of Nov '23 |
Joanna Farleya846d332022-11-18 02:33:16 +0200[diff] [blame]70+-----------------+---------------------------+------------------------------+
Harrison Mutai7c9720f2024-04-04 14:54:58 +0000[diff] [blame]71| v2.11 | 4th week of May '24 | 2nd week of May '24 |
72+-----------------+---------------------------+------------------------------+
Olivier Deprezb80feed2024-09-18 14:28:26 +0200[diff] [blame]73| v2.12 | 4th week of Nov '24 | 2nd week of Nov '24 |
74+-----------------+---------------------------+------------------------------+
Govindraj Raja368e4fa2024-10-15 14:45:57 -0500[diff] [blame]75| v2.13 | 4th week of May '25 | 2nd week of May '25 |
76+-----------------+---------------------------+------------------------------+
Govindraj Raja7b4c9062025-04-16 10:59:34 -0500[diff] [blame^]77| v2.14 | 4th week of Nov '25 | 2nd week of Nov '25 |
78+-----------------+---------------------------+------------------------------+
Joel Hutton4fe91232019-02-25 15:18:56 +0000[diff] [blame]79
80Removal of Deprecated Interfaces
81--------------------------------
82
Sandrine Bailleuxa6a1dcb2022-11-08 13:36:42 +0100[diff] [blame]83As mentioned in the :ref:`Platform Ports Policy`, this is a live document
84cataloging all the deprecated interfaces in TF-A project and the Release version
85after which it will be removed.
Joel Hutton4fe91232019-02-25 15:18:56 +0000[diff] [blame]86
87+--------------------------------+-------------+---------+---------------------------------------------------------+
88| Interface | Deprecation | Removed | Comments |
89| | Date | after | |
90| | | Release | |
91+================================+=============+=========+=========================================================+
Yann Gautier8dd2a642022-06-30 14:40:06 +0200[diff] [blame]92| | | | |
Nicolas Toromanoff40f9f642020-11-09 12:14:52 +0100[diff] [blame]93+--------------------------------+-------------+---------+---------------------------------------------------------+
Sandrine Bailleux1dc77d42023-04-17 16:01:50 +0200[diff] [blame]94
95Removal of Deprecated Drivers
96-----------------------------
97
98As mentioned in the :ref:`Platform Ports Policy`, this is a live document
99cataloging all the deprecated drivers in TF-A project and the Release version
100after which it will be removed.
101
102+--------------------------------+-------------+---------+---------------------------------------------------------+
103| Driver | Deprecation | Removed | Comments |
104| | Date | after | |
105| | | Release | |
106+================================+=============+=========+=========================================================+
Sandrine Bailleuxb65dfe42023-10-26 15:14:42 +0200[diff] [blame]107| None at this time. | | | |
Sandrine Bailleux47c8dcf2023-04-17 14:09:41 +0200[diff] [blame]108+--------------------------------+-------------+---------+---------------------------------------------------------+
Joel Hutton4fe91232019-02-25 15:18:56 +0000[diff] [blame]109
Govindraj Rajac6431882024-04-18 12:04:18 -0500[diff] [blame]110Build Options deprecated/removed
111~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
112
113Populated table provides details about build options that were removed or deprecated.
114
115+-----------------------+--------------------------------+
116| Build Option | Deprecated from TF-A Version |
117+=======================+================================+
Sona Mathew6f2b8812024-10-24 10:00:19 -0500[diff] [blame]118| | |
Govindraj Rajac6431882024-04-18 12:04:18 -0500[diff] [blame]119+-----------------------+--------------------------------+
Sona Mathew6f2b8812024-10-24 10:00:19 -0500[diff] [blame]120| | |
Govindraj Rajac6431882024-04-18 12:04:18 -0500[diff] [blame]121+-----------------------+--------------------------------+
122
Paul Beesley34760952019-04-12 14:19:42 +0100[diff] [blame]123--------------
124
Govindraj Rajad39c2f32024-12-12 17:16:03 -0600[diff] [blame]125*Copyright (c) 2018-2025, Arm Limited and Contributors. All rights reserved.*