doc: describe the scp03 command
[platform/kernel/u-boot.git] / doc / usage / scp03.rst
1 .. SPDX-License-Identifier: GPL-2.0+
2
3 scp03 command
4 =============
5
6 Synopsis
7 --------
8
9 ::
10
11     scp03 enable
12     scp03 provision
13
14 Description
15 -----------
16
17 The *scp03* command calls into a Trusted Application executing in a
18 Trusted Execution Environment to enable (if present) the Secure
19 Channel Protocol 03 stablished between the processor and the secure
20 element.
21
22 This protocol encrypts all the communication between the processor and
23 the secure element using a set of pre-defined keys. These keys can be
24 rotated (provisioned) using the *provision* request.
25
26 See also
27 --------
28
29 For some information on the internals implemented in the TEE, please
30 check the GlobalPlatform documentation on `Secure Channel Protocol '03'`_
31
32 .. _Secure Channel Protocol '03':
33    https://globalplatform.org/wp-content/uploads/2014/07/GPC_2.3_D_SCP03_v1.1.2_PublicRelease.pdf