1################################
2Platform deprecation and removal
3################################
4
5********************************************
6Process for Platform deprecation and removal
7********************************************
8
9A platform may need to be removed from upstream code due to lack of community
10interest or it may have reached end of life. The below section calls out the
11process for removing platform support from TF-M.
12
13    1. An email to the TF-M mailing list proposing the removal of the platform.
14
15    2. The merit of the proposal will be considered by the maintainers for a
16       period of 4 weeks and community can express their opinion on the same
17       during this time window. The platform owner can veto the proposal and
18       in case of multiple platform owners with differing opinion or community
19       having interest in the platform, then the project maintainer can work
20       with the platform owner and use their discretion to decide on the
21       proposal.
22
23    3. Once a decision is made to remove the platform, the platform is
24       considered to be in `deprecated` state and the TF-M version after
25       which it will be removed will also be mentioned. Suitable build time
26       or runtime messages needs to be incorporated to the platform to warn
27       about the `deprecation`.
28
29    4. The project should strive to keep the `deprecated` platforms
30       building/running till the removal. This relies on platform owners being
31       still actively involved with the project and maintaining the platform.
32
33    5. Although this will be the usual process for platform deprecation and
34       eventual removal, the process still leaves room for the platform
35       deprecation to be cancelled after it has been marked as `deprecated`
36       due to evolving project and market requirements. This is left to
37       consensus between project maintainers and platform owner/s.
38
39    6. Once a platform has been removed, it can be added back in future and
40       this would follow the same guidelines as for a new platform contribution.
41
42****************************
43List of Deprecated Platforms
44****************************
45
46The below list calls out platforms marked for deprecation according to the
47above process and the platform will be removed soon after the mentioned
48release.
49
50+--------------------------------------+-----------+---------------------------+
51| Deprecated Platform                  | Removed   | Comments                  |
52|                                      | after     |                           |
53|                                      | release   |                           |
54+======================================+===========+===========================+
55| arm/mps2/an539                       | v1.2.0    | N.A                       |
56+--------------------------------------+-----------+---------------------------+
57| arm/mps2/sse-200_aws                 | v1.3.0    | N.A                       |
58+--------------------------------------+-----------+---------------------------+
59| arm/musca_a                          | v1.3.0    | N.A                       |
60+--------------------------------------+-----------+---------------------------+
61| arm/mps2/fvp_sse300                  | v1.4.0    | N.A                       |
62+--------------------------------------+-----------+---------------------------+
63| arm/musca_b1/secure_enclave          | v1.6.0    | N.A                       |
64+--------------------------------------+-----------+---------------------------+
65
66--------------
67
68*Copyright (c) 2020-2021, Arm Limited. All rights reserved.*
69