Skip to content

Commit 3d9621e

Browse files
nicola-mazzucato-armAnton-TF
nicola-mazzucato-arm
authored and
Anton-TF
committed
Docs: Release notes for v2.2.0
- Add notes for TF-Mv2.2.0. - Remove refs to v1.8.x from TOC to simplify the view, though the documents are not removed. Signed-off-by: Nicola Mazzucato <[email protected]> Change-Id: Ic58768114305f89425c7e58a440b5b29787842e0
1 parent 55c95f5 commit 3d9621e

File tree

7 files changed

+245
-42
lines changed

7 files changed

+245
-42
lines changed

‎cmake/version.cmake‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,12 @@
11
#-------------------------------------------------------------------------------
2-
# Copyright (c) 2021-2024, Arm Limited. All rights reserved.
2+
# SPDX-FileCopyrightText: Copyright The TrustedFirmware-M Contributors
33
#
44
# SPDX-License-Identifier: BSD-3-Clause
55
#
66
#-------------------------------------------------------------------------------
77

88
# The 'TFM_VERSION_MANUAL' is used for fallback when Git tags are not available
9-
set(TFM_VERSION_MANUAL "2.1.1")
9+
set(TFM_VERSION_MANUAL "2.2.0")
1010

1111
execute_process(COMMAND git describe --tags --always
1212
WORKING_DIRECTORY ${CMAKE_CURRENT_SOURCE_DIR}

‎docs/conf.py‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# -*- coding: utf-8 -*-
22
#-------------------------------------------------------------------------------
3-
# Copyright (c) 2019-2024, Arm Limited. All rights reserved.
3+
# SPDX-FileCopyrightText: Copyright The TrustedFirmware-M Contributors
44
#
55
# SPDX-License-Identifier: BSD-3-Clause
66
#
@@ -20,7 +20,7 @@
2020
# -- Project information -----------------------------------------------------
2121

2222
project = 'Trusted Firmware-M'
23-
copyright = '2017-2024, ARM CE-OSS'
23+
copyright = '2017-2025, ARM CE-OSS'
2424
author = 'ARM CE-OSS'
2525
title = 'User Guide'
2626

‎docs/releases/1.8.0.rst‎

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,5 @@
1+
:orphan:
2+
13
*************
24
Version 1.8.0
35
*************

‎docs/releases/1.8.1.rst‎

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,5 @@
1+
:orphan:
2+
13
*************
24
Version 1.8.1
35
*************

‎docs/releases/2.2.0.rst‎

Lines changed: 195 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,195 @@
1+
*************
2+
Version 2.2.0
3+
*************
4+
5+
New major features
6+
==================
7+
8+
- LLVM build support (MPS2/3/4, RSE)
9+
10+
- Mbed TLS upgrade to v3.6.3.
11+
12+
- Compliant with PSA Architecture Compliance Kit tests v1.6
13+
14+
- Initial support for on-core and off-core clients on Hybrid platforms (A-profile + M-profile or
15+
multiple M-profile) using HYBRID_PLAT_SCHED_TYPE=NSPE (a.k.a. solution 2) as described in [1]_.
16+
The functionality is still under active testing and development.
17+
18+
19+
Other relevant changes
20+
======================
21+
22+
- BL1 changes to: key config, crypto api, image layout, BL2 hash removal, fixes for encodings,
23+
ECC keys derivation support, all crypto functions are FIH enabled, shared symbols list updates.
24+
- BL2 changes to: dynamic arbitrary numbers of ROTPKs, shared regions indirection, config options
25+
- Tools: Option to generate signing requests, key_derivation module
26+
- COSE: Switch to upstream t_cose repo
27+
- NS agent mailbox: Support multiple mailbox sources in RPC callback
28+
- Logs: Clean-up macros
29+
- CC3XX: sanity checks, enhancements for PKA & ECDSA, alignments, tests, DRBG additions
30+
- Threat Model: Add mitigation strategies
31+
- MISRA-C: Document status of reported violations
32+
33+
34+
New security advisories
35+
=======================
36+
37+
None.
38+
39+
40+
New platforms support
41+
=====================
42+
43+
- Initial support for building nRF54L15
44+
- Initial support for building stm32wba65i-dk
45+
46+
47+
Deprecated platforms
48+
====================
49+
50+
TC2: arm/rse/tc/tc2
51+
52+
53+
Tested platforms [WIP]
54+
======================
55+
56+
The following platforms are successfully tested in this release.
57+
58+
- **Arm**
59+
60+
- AN519
61+
- AN521
62+
- AN555
63+
- Corstone-300
64+
- Corstone-310
65+
- Corstone-315
66+
- Corstone-320
67+
- Corstone-1000
68+
- Musca-B1
69+
- Musca-S1
70+
71+
- **ArmChina**
72+
73+
- Alcor (AN557)
74+
75+
- **STM**
76+
77+
- NUCLEO-L552ZE-Q - TBC
78+
- STM32H573idk - TBC
79+
80+
- **Infineon/Cypress**
81+
82+
- PSoC 64 - TBC
83+
84+
- **NXP**
85+
86+
- LPCXpresso55S69 - TBC
87+
88+
- **Nordic**
89+
90+
- nrf5340dk_nrf5340_cpuapp
91+
- nrf9160dk_nrf9160
92+
- nrf9161dk_nrf9161
93+
94+
Reference memory footprint
95+
==========================
96+
97+
All measurements below are made for *AN521* platform, built `TF-Mv2.2.0-RC2
98+
<https://git.trustedfirmware.org/TF-M/trusted-firmware-m.git/tag/?h=TF-Mv2.2.0-RC2>`_
99+
on Windows 10 using Armclang v6.18 and build type MinSizeRel.
100+
101+
All modules are measured in bytes. Some minor modules are not shown in the table below.
102+
103+
.. note::
104+
105+
Profile `Medium-ARoT-less` built with disabled Firmware Update service to align with other
106+
TF-M Profiles.
107+
108+
+----------------------+--------------+--------------+--------------+--------------+--------------+
109+
| Module | Base | Small | ARoT-less | Medium | Large |
110+
+ +-------+------+-------+------+-------+------+-------+------+-------+------+
111+
| Module | Base | RAM | Small | RAM | ARoT | RAM | Med. | RAM | Large | RAM |
112+
+======================+=======+======+=======+======+=======+======+=======+======+=======+======+
113+
|Generated | 112| 3184| 208| 3184| 224| 3184| 272| 3184| 272| 3184|
114+
+----------------------+-------+------+-------+------+-------+------+-------+------+-------+------+
115+
|Objects | 972| 1056| 1280| 5188| 1379| 5872| 1513| 1468| 1587| 1468|
116+
+----------------------+-------+------+-------+------+-------+------+-------+------+-------+------+
117+
|c_w.l | 190| 0| 506| 0| 548| 0| 506| 0| 746| 0|
118+
+----------------------+-------+------+-------+------+-------+------+-------+------+-------+------+
119+
|platform_s.a | 5312| 281| 5644| 281| 6044| 281| 6426| 281| 6556| 281|
120+
+----------------------+-------+------+-------+------+-------+------+-------+------+-------+------+
121+
|spm.a | 3678| 173| 4716| 173| 4054| 173| 6652| 1409| 6854| 1414|
122+
+----------------------+-------+------+-------+------+-------+------+-------+------+-------+------+
123+
|sprt.a | 274| 0| 1488| 0| 1402| 0| 2530| 4| 2530| 4|
124+
+----------------------+-------+------+-------+------+-------+------+-------+------+-------+------+
125+
|mbedcrypto.a | 0| 0| 24464| 2108| 28292| 2108| 28392| 2108| 77692| 1992|
126+
+----------------------+-------+------+-------+------+-------+------+-------+------+-------+------+
127+
|PROT_attestation.a | 0| 0| 1610| 557| 1579| 1153| 1583| 3201| 1699| 3201|
128+
+----------------------+-------+------+-------+------+-------+------+-------+------+-------+------+
129+
|PROT_crypto.a | 0| 0| 3596| 2046| 4042| 16002| 4092| 22146| 4600| 28226|
130+
+----------------------+-------+------+-------+------+-------+------+-------+------+-------+------+
131+
|PROT_its.a | 0| 0| 4830| 80| 4864| 112| 5064| 1988| 5072| 2468|
132+
+----------------------+-------+------+-------+------+-------+------+-------+------+-------+------+
133+
|PROT_platform.a | 0| 0| 0| 0| 532| 0| 522| 1280| 522| 1280|
134+
+----------------------+-------+------+-------+------+-------+------+-------+------+-------+------+
135+
|AROT_ps.a | 0| 0| 0| 0| 0| 0| 3312| 4344| 3312| 4344|
136+
+----------------------+-------+------+-------+------+-------+------+-------+------+-------+------+
137+
|Padding | 26| 38| 95| 43| 126| 43| 117| 59| 169| 50|
138+
+----------------------+-------+------+-------+------+-------+------+-------+------+-------+------+
139+
|platform_crypto_keys.a| 0| 0| 258| 0| 276| 0| 276| 0| 276| 0|
140+
+----------------------+-------+------+-------+------+-------+------+-------+------+-------+------+
141+
|qcbor.a | 0| 0| 854| 0| 1070| 0| 1070| 0| 1070| 0|
142+
+----------------------+-------+------+-------+------+-------+------+-------+------+-------+------+
143+
|crypto_service_p256m.a| 0| 0| 0| 0| 3612| 0| 3602| 0| 0| 0|
144+
+----------------------+-------+------+-------+------+-------+------+-------+------+-------+------+
145+
|t_cose_s.a | 0| 0| 1007| 0| 2164| 0| 2159| 0| 2159| 0|
146+
+----------------------+-------+------+-------+------+-------+------+-------+------+-------+------+
147+
|Total inc. Padding | 10564| 4732| 50556| 13660| 60208| 28928| 68088| 41472| 115116| 47912|
148+
+----------------------+-------+------+-------+------+-------+------+-------+------+-------+------+
149+
150+
Known issues
151+
============
152+
153+
Some open issues are not fixed in this release.
154+
155+
.. list-table::
156+
:header-rows: 1
157+
158+
* - Descriptions
159+
- Issue links
160+
* - SPM does not automatically unmap mm-iovecs. It will be recovered in a future release.
161+
- https://github.com/TrustedFirmware-M/trusted-firmware-m/issues/20
162+
163+
164+
Issues fixed since v2.1.1
165+
-------------------------
166+
167+
The following issues have been fixed since the v2.1.1 release.
168+
169+
.. list-table::
170+
:header-rows: 1
171+
172+
* - Descriptions
173+
- Issue links
174+
* - KConfig build has been fixed
175+
- <None>
176+
* - Services do not unmap IOVECS
177+
- https://github.com/TrustedFirmware-M/trusted-firmware-m/issues/19
178+
* - SPM does not return PSA_ERROR on refused psa_connect
179+
- https://github.com/TrustedFirmware-M/trusted-firmware-m/issues/21
180+
* - Fix wrapper to properly mark NSPE images as such
181+
- https://github.com/TrustedFirmware-M/trusted-firmware-m/issues/24
182+
* - Protected Storage content can be lost
183+
- https://github.com/TrustedFirmware-M/trusted-firmware-m/issues/26
184+
185+
186+
Reference
187+
=========
188+
189+
.. [1] `Trusted Firmware-M and Hybrid platforms, TF-M tech forum 14-09-2023 <https://www.trustedfirmware.org/docs/tech_forum_20230914_non_seucure_clients.pdf>`_
190+
191+
--------------
192+
193+
*SPDX-License-Identifier: BSD-3-Clause*
194+
195+
*SPDX-FileCopyrightText: Copyright The TrustedFirmware-M Contributors*

‎docs/releases/index.rst‎

Lines changed: 39 additions & 36 deletions
Original file line numberDiff line numberDiff line change
@@ -4,44 +4,45 @@ Releases
44
.. toctree::
55
:hidden:
66

7+
v2.2.0 <2.2.0>
78
v2.1.1 <2.1.1>
89
v2.1.0 <2.1.0>
910
v2.0.0 <2.0.0>
10-
v1.8.1 <1.8.1>
11-
v1.8.0 <1.8.0>
1211
release_process
1312

14-
+--------------------------------------+--------------+----------------------------+
15-
| Version | Date | PSA-arch tag/hash |
16-
+======================================+==============+============================+
17-
| :doc:`v2.1.1 </releases/2.1.1>` | 2024-11-01 | v23.06_API1.5_ADAC_EAC |
18-
+--------------------------------------+--------------+----------------------------+
19-
| :doc:`v2.1.0 </releases/2.1.0>` | 2024-05-13 | v23.06_API1.5_ADAC_EAC |
20-
+--------------------------------------+--------------+----------------------------+
21-
| :doc:`v2.0.0 </releases/2.0.0>` | 2023-11-28 | v23.06_API1.5_ADAC_EAC |
22-
+--------------------------------------+--------------+----------------------------+
23-
| :doc:`v1.8.1 </releases/1.8.1>` | 2023-09-08 | cf8bd71 |
24-
+--------------------------------------+--------------+----------------------------+
25-
| :doc:`v1.8.0 </releases/1.8.0>` | 2023-04-28 | cf8bd71 |
26-
+--------------------------------------+--------------+----------------------------+
27-
| :doc:`v1.7.0 </releases/1.7.0>` | 2022-12-08 | cf8bd71 |
28-
+--------------------------------------+--------------+----------------------------+
29-
| :doc:`v1.6.1 </releases/1.6.1>` | 2022-11-16 | f7e8495 |
30-
+--------------------------------------+--------------+----------------------------+
31-
| :doc:`v1.6.0 </releases/1.6.0>` | 2022-04-28 | f7e8495 |
32-
+--------------------------------------+--------------+----------------------------+
33-
| :doc:`v1.5.0 </releases/1.5.0>` | 2021-11-30 | v21.10_API1.3_ADAC_ALPHA-1 |
34-
+--------------------------------------+--------------+----------------------------+
35-
| :doc:`v1.4.0 </releases/1.4.0>` | 2021-08-03 | 51ff2bd |
36-
+--------------------------------------+--------------+----------------------------+
37-
| :doc:`v1.3.0 </releases/1.3.0>` | 2021-04-07 | b0635d9 |
38-
+--------------------------------------+--------------+----------------------------+
39-
| :doc:`v1.2.0 </releases/1.2.0>` | 2020-11-25 | 90c8e680 |
40-
+--------------------------------------+--------------+----------------------------+
41-
| :doc:`v1.1 </releases/1.1>` | 2020-07-15 | 1f960947 |
42-
+--------------------------------------+--------------+----------------------------+
43-
| :doc:`v1.0 </releases/1.0>` | 2020-03-27 | v20.03_API1.0 |
44-
+--------------------------------------+--------------+----------------------------+
13+
+----------------------------------+--------------+----------------------------+
14+
| Version | Date | PSA-arch tag/hash |
15+
+==================================+==============+============================+
16+
| :doc:`v2.2.0 </releases/2.2.0>` | 2025-04-14 | v24.03_API1.6_CRYPTO_1.1.0 |
17+
+----------------------------------+--------------+----------------------------+
18+
| :doc:`v2.1.1 </releases/2.1.1>` | 2024-11-01 | v23.06_API1.5_ADAC_EAC |
19+
+----------------------------------+--------------+----------------------------+
20+
| :doc:`v2.1.0 </releases/2.1.0>` | 2024-05-13 | v23.06_API1.5_ADAC_EAC |
21+
+----------------------------------+--------------+----------------------------+
22+
| :doc:`v2.0.0 </releases/2.0.0>` | 2023-11-28 | v23.06_API1.5_ADAC_EAC |
23+
+----------------------------------+--------------+----------------------------+
24+
| :doc:`v1.8.1 </releases/1.8.1>` | 2023-09-08 | cf8bd71 |
25+
+----------------------------------+--------------+----------------------------+
26+
| :doc:`v1.8.0 </releases/1.8.0>` | 2023-04-28 | cf8bd71 |
27+
+----------------------------------+--------------+----------------------------+
28+
| :doc:`v1.7.0 </releases/1.7.0>` | 2022-12-08 | cf8bd71 |
29+
+----------------------------------+--------------+----------------------------+
30+
| :doc:`v1.6.1 </releases/1.6.1>` | 2022-11-16 | f7e8495 |
31+
+----------------------------------+--------------+----------------------------+
32+
| :doc:`v1.6.0 </releases/1.6.0>` | 2022-04-28 | f7e8495 |
33+
+----------------------------------+--------------+----------------------------+
34+
| :doc:`v1.5.0 </releases/1.5.0>` | 2021-11-30 | v21.10_API1.3_ADAC_ALPHA-1 |
35+
+----------------------------------+--------------+----------------------------+
36+
| :doc:`v1.4.0 </releases/1.4.0>` | 2021-08-03 | 51ff2bd |
37+
+----------------------------------+--------------+----------------------------+
38+
| :doc:`v1.3.0 </releases/1.3.0>` | 2021-04-07 | b0635d9 |
39+
+----------------------------------+--------------+----------------------------+
40+
| :doc:`v1.2.0 </releases/1.2.0>` | 2020-11-25 | 90c8e680 |
41+
+----------------------------------+--------------+----------------------------+
42+
| :doc:`v1.1 </releases/1.1>` | 2020-07-15 | 1f960947 |
43+
+----------------------------------+--------------+----------------------------+
44+
| :doc:`v1.0 </releases/1.0>` | 2020-03-27 | v20.03_API1.0 |
45+
+----------------------------------+--------------+----------------------------+
4546

4647
Future release plans
4748
--------------------
@@ -51,15 +52,17 @@ The dates below are tentative and subject to change.
5152
+--------------------------------------+-----------------+---------------+
5253
| Version | Feature Freeze | Release |
5354
+======================================+=================+===============+
54-
| v2.2.0 | 2025-01-27 | 2025-02-14 |
55-
+--------------------------------------+-----------------+---------------+
5655
| v2.3.0-LTS | 2025-10-27 | 2025-11-17 |
5756
+--------------------------------------+-----------------+---------------+
57+
| v2.4.0 | 2026-07-13 | 2026-07-24 |
58+
+--------------------------------------+-----------------+---------------+
5859

5960
Please refer to
6061
:ref:`releases/release_process:Release Cadence and Process` for
6162
interpreting version numbers.
6263

6364
--------------
6465

65-
*Copyright (c) 2020-2024, Arm Limited. All rights reserved.*
66+
*SPDX-License-Identifier: BSD-3-Clause*
67+
68+
*SPDX-FileCopyrightText: Copyright The TrustedFirmware-M Contributors*

‎lib/ext/tf-m-tests/version.txt‎

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,8 @@
55
#-------------------------------------------------------------------------------
66

77
# This file tracks the recommended tf-m-tests version to verify TF-M.
8-
# Developers should keep the version value up to date to make sure it fits current TF-M version.
8+
# Developers should keep the version value up to date to make sure it fits
9+
# current TF-M version.
910
# TF-M does not rely on this file to build.
1011

11-
version=e0a433c67
12+
version=TF-Mv2.1.2-RC2

0 commit comments

Comments
 (0)