| Paul Beesley | fc9ee36 | 2019-03-07 15:47:15 +0000 | [diff] [blame] | 1 | Release Processes |
| 2 | ================= |
| Joel Hutton | 9e60563 | 2019-02-25 15:18:56 +0000 | [diff] [blame] | 3 | |
| Joel Hutton | 9e60563 | 2019-02-25 15:18:56 +0000 | [diff] [blame] | 4 | Project Release Cadence |
| 5 | ----------------------- |
| 6 | |
| 7 | The project currently aims to do a release once every 6 months which will be |
| 8 | tagged on the master branch. There will be a code freeze (stop merging |
| laurenw-arm | 0e77f01 | 2019-10-16 16:32:16 -0500 | [diff] [blame] | 9 | non-essential changes) up to 4 weeks prior to the target release date. The release |
| Joel Hutton | 9e60563 | 2019-02-25 15:18:56 +0000 | [diff] [blame] | 10 | candidates will start appearing after this and only bug fixes or updates |
| 11 | required for the release will be merged. The maintainers are free to use their |
| laurenw-arm | 0e77f01 | 2019-10-16 16:32:16 -0500 | [diff] [blame] | 12 | judgement on what changes are essential for the release. A release branch may be |
| 13 | created after code freeze if there are significant changes that need merging onto |
| Joel Hutton | 9e60563 | 2019-02-25 15:18:56 +0000 | [diff] [blame] | 14 | the integration branch during the merge window. |
| 15 | |
| 16 | The release testing will be performed on release candidates and depending on |
| 17 | issues 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 Gautier | 9a17e24 | 2023-10-04 18:59:44 +0200 | [diff] [blame] | 28 | Version numbering |
| 29 | ~~~~~~~~~~~~~~~~~ |
| 30 | TF-A version is given in Makefile, through several macros: |
| 31 | |
| 32 | - VERSION_MAJOR |
| 33 | - VERSION_MINOR |
| 34 | - VERSION_PATCH |
| 35 | |
| 36 | For example, TF-A v2.10 has VERSION_MAJOR=2, VERSION_MINOR=10 and VERSION_PATCH=0. |
| 37 | |
| 38 | This VERSION_PATCH macro is only increased for LTS releases. |
| 39 | |
| Joel Hutton | 9e60563 | 2019-02-25 15:18:56 +0000 | [diff] [blame] | 40 | Upcoming Releases |
| 41 | ~~~~~~~~~~~~~~~~~ |
| 42 | |
| 43 | These are the estimated dates for the upcoming release. These may change |
| 44 | depending 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-arm | 0e77f01 | 2019-10-16 16:32:16 -0500 | [diff] [blame] | 53 | | v2.2 | 4th week of Oct '19 | 1st week of Oct '19 | |
| 54 | +-----------------+---------------------------+------------------------------+ |
| laurenw-arm | e7f6319 | 2020-03-31 14:20:25 -0500 | [diff] [blame] | 55 | | v2.3 | 4th week of Apr '20 | 1st week of Apr '20 | |
| laurenw-arm | 0e77f01 | 2019-10-16 16:32:16 -0500 | [diff] [blame] | 56 | +-----------------+---------------------------+------------------------------+ |
| Manish V Badarkhe | 76dc298 | 2020-10-08 02:11:20 +0100 | [diff] [blame] | 57 | | v2.4 | 2nd week of Nov '20 | 4th week of Oct '20 | |
| laurenw-arm | 489645f | 2020-04-15 15:19:50 -0500 | [diff] [blame] | 58 | +-----------------+---------------------------+------------------------------+ |
| Madhukar Pappireddy | 56c6cce | 2021-04-26 18:53:31 -0500 | [diff] [blame] | 59 | | v2.5 | 3rd week of May '21 | 5th week of Apr '21 | |
| Manish V Badarkhe | 95347d1 | 2020-10-08 02:16:25 +0100 | [diff] [blame] | 60 | +-----------------+---------------------------+------------------------------+ |
| Bipin Ravi | 58392c4 | 2021-10-05 15:57:06 -0500 | [diff] [blame] | 61 | | v2.6 | 4th week of Nov '21 | 2nd week of Nov '21 | |
| Madhukar Pappireddy | 18b3f59 | 2021-04-26 19:01:18 -0500 | [diff] [blame] | 62 | +-----------------+---------------------------+------------------------------+ |
| Daniel Boulby | 7c1aa59 | 2022-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 Ravi | 68edfdc | 2021-12-21 09:14:48 -0600 | [diff] [blame] | 66 | +-----------------+---------------------------+------------------------------+ |
| Harrison Mutai | 3d7d6f3 | 2023-04-26 16:39:08 +0100 | [diff] [blame] | 67 | | v2.9 | 4th week of May '23 | 2nd week of May '23 | |
| 68 | +-----------------+---------------------------+------------------------------+ |
| Olivier Deprez | 3493457 | 2023-09-28 17:33:10 +0200 | [diff] [blame] | 69 | | v2.10 | 4th week of Nov '23 | 2nd week of Nov '23 | |
| Joanna Farley | 623ac72 | 2022-11-18 02:33:16 +0200 | [diff] [blame] | 70 | +-----------------+---------------------------+------------------------------+ |
| Joel Hutton | 9e60563 | 2019-02-25 15:18:56 +0000 | [diff] [blame] | 71 | |
| 72 | Removal of Deprecated Interfaces |
| 73 | -------------------------------- |
| 74 | |
| Sandrine Bailleux | dad3561 | 2022-11-08 13:36:42 +0100 | [diff] [blame] | 75 | As mentioned in the :ref:`Platform Ports Policy`, this is a live document |
| 76 | cataloging all the deprecated interfaces in TF-A project and the Release version |
| 77 | after which it will be removed. |
| Joel Hutton | 9e60563 | 2019-02-25 15:18:56 +0000 | [diff] [blame] | 78 | |
| 79 | +--------------------------------+-------------+---------+---------------------------------------------------------+ |
| 80 | | Interface | Deprecation | Removed | Comments | |
| 81 | | | Date | after | | |
| 82 | | | | Release | | |
| 83 | +================================+=============+=========+=========================================================+ |
| Yann Gautier | ff012d1 | 2022-06-30 14:05:21 +0200 | [diff] [blame] | 84 | | STM32MP15_OPTEE_RSV_SHM | 2.10 | 3.0 | OP-TEE manages its own memory on STM32MP15 | |
| Nicolas Toromanoff | 7f95ac8 | 2020-11-09 12:14:52 +0100 | [diff] [blame] | 85 | +--------------------------------+-------------+---------+---------------------------------------------------------+ |
| Sandrine Bailleux | 8c333e4 | 2023-04-17 16:01:50 +0200 | [diff] [blame] | 86 | |
| 87 | Removal of Deprecated Drivers |
| 88 | ----------------------------- |
| 89 | |
| 90 | As mentioned in the :ref:`Platform Ports Policy`, this is a live document |
| 91 | cataloging all the deprecated drivers in TF-A project and the Release version |
| 92 | after which it will be removed. |
| 93 | |
| 94 | +--------------------------------+-------------+---------+---------------------------------------------------------+ |
| 95 | | Driver | Deprecation | Removed | Comments | |
| 96 | | | Date | after | | |
| 97 | | | | Release | | |
| 98 | +================================+=============+=========+=========================================================+ |
| Sandrine Bailleux | 2f37ce6 | 2023-10-26 15:14:42 +0200 | [diff] [blame] | 99 | | None at this time. | | | | |
| Sandrine Bailleux | b0b531f | 2023-04-17 14:09:41 +0200 | [diff] [blame] | 100 | +--------------------------------+-------------+---------+---------------------------------------------------------+ |
| Joel Hutton | 9e60563 | 2019-02-25 15:18:56 +0000 | [diff] [blame] | 101 | |
| Paul Beesley | f864067 | 2019-04-12 14:19:42 +0100 | [diff] [blame] | 102 | -------------- |
| 103 | |
| laurenw-arm | b3b6de7 | 2024-03-05 14:55:18 -0600 | [diff] [blame] | 104 | *Copyright (c) 2018-2024, Arm Limited and Contributors. All rights reserved.* |