blob: d81410458cce037725567aaf754b380e73948fe7 [file] [log] [blame]
Paul Beesleyfc9ee362019-03-07 15:47:15 +00001Release Processes
2=================
Joel Hutton9e605632019-02-25 15:18:56 +00003
Joel Hutton9e605632019-02-25 15:18:56 +00004Project 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-arm0e77f012019-10-16 16:32:16 -05009non-essential changes) up to 4 weeks prior to the target release date. The release
Joel Hutton9e605632019-02-25 15:18:56 +000010candidates 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-arm0e77f012019-10-16 16:32:16 -050012judgement 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 Hutton9e605632019-02-25 15:18:56 +000014the 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 Gautier9a17e242023-10-04 18:59:44 +020028Version 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
38This VERSION_PATCH macro is only increased for LTS releases.
39
Joel Hutton9e605632019-02-25 15:18:56 +000040Upcoming 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-arm0e77f012019-10-16 16:32:16 -050053| v2.2 | 4th week of Oct '19 | 1st week of Oct '19 |
54+-----------------+---------------------------+------------------------------+
laurenw-arme7f63192020-03-31 14:20:25 -050055| v2.3 | 4th week of Apr '20 | 1st week of Apr '20 |
laurenw-arm0e77f012019-10-16 16:32:16 -050056+-----------------+---------------------------+------------------------------+
Manish V Badarkhe76dc2982020-10-08 02:11:20 +010057| v2.4 | 2nd week of Nov '20 | 4th week of Oct '20 |
laurenw-arm489645f2020-04-15 15:19:50 -050058+-----------------+---------------------------+------------------------------+
Madhukar Pappireddy56c6cce2021-04-26 18:53:31 -050059| v2.5 | 3rd week of May '21 | 5th week of Apr '21 |
Manish V Badarkhe95347d12020-10-08 02:16:25 +010060+-----------------+---------------------------+------------------------------+
Bipin Ravi58392c42021-10-05 15:57:06 -050061| v2.6 | 4th week of Nov '21 | 2nd week of Nov '21 |
Madhukar Pappireddy18b3f592021-04-26 19:01:18 -050062+-----------------+---------------------------+------------------------------+
Daniel Boulby7c1aa592022-05-09 11:11:49 +010063| 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 Ravi68edfdc2021-12-21 09:14:48 -060066+-----------------+---------------------------+------------------------------+
Harrison Mutai3d7d6f32023-04-26 16:39:08 +010067| v2.9 | 4th week of May '23 | 2nd week of May '23 |
68+-----------------+---------------------------+------------------------------+
Olivier Deprez34934572023-09-28 17:33:10 +020069| v2.10 | 4th week of Nov '23 | 2nd week of Nov '23 |
Joanna Farley623ac722022-11-18 02:33:16 +020070+-----------------+---------------------------+------------------------------+
Joel Hutton9e605632019-02-25 15:18:56 +000071
72Removal of Deprecated Interfaces
73--------------------------------
74
Sandrine Bailleuxdad35612022-11-08 13:36:42 +010075As mentioned in the :ref:`Platform Ports Policy`, this is a live document
76cataloging all the deprecated interfaces in TF-A project and the Release version
77after which it will be removed.
Joel Hutton9e605632019-02-25 15:18:56 +000078
79+--------------------------------+-------------+---------+---------------------------------------------------------+
80| Interface | Deprecation | Removed | Comments |
81| | Date | after | |
82| | | Release | |
83+================================+=============+=========+=========================================================+
Yann Gautierff012d12022-06-30 14:05:21 +020084| STM32MP15_OPTEE_RSV_SHM | 2.10 | 3.0 | OP-TEE manages its own memory on STM32MP15 |
Nicolas Toromanoff7f95ac82020-11-09 12:14:52 +010085+--------------------------------+-------------+---------+---------------------------------------------------------+
Sandrine Bailleux8c333e42023-04-17 16:01:50 +020086
87Removal of Deprecated Drivers
88-----------------------------
89
90As mentioned in the :ref:`Platform Ports Policy`, this is a live document
91cataloging all the deprecated drivers in TF-A project and the Release version
92after which it will be removed.
93
94+--------------------------------+-------------+---------+---------------------------------------------------------+
95| Driver | Deprecation | Removed | Comments |
96| | Date | after | |
97| | | Release | |
98+================================+=============+=========+=========================================================+
Sandrine Bailleux2f37ce62023-10-26 15:14:42 +020099| None at this time. | | | |
Sandrine Bailleuxb0b531f2023-04-17 14:09:41 +0200100+--------------------------------+-------------+---------+---------------------------------------------------------+
Joel Hutton9e605632019-02-25 15:18:56 +0000101
Paul Beesleyf8640672019-04-12 14:19:42 +0100102--------------
103
laurenw-armb3b6de72024-03-05 14:55:18 -0600104*Copyright (c) 2018-2024, Arm Limited and Contributors. All rights reserved.*