xref: /OK3568_Linux_fs/u-boot/lib/optee_clientApi/README (revision 4882a59341e53eb6f0b4789bf948001014eff981)
1#
2# Copyright (c) 2020, Rockchip Electronics Co., Ltd.
3# Written by Elon Zhang <zhangzj@rock-chips.com>
4#
5# SPDX-License-Identifier:      GPL-2.0+
6#
7
8OP-TEE Client in U-Boot
9==========================
10OP-TEE Client in U-Boot is responsible for communication managerment
11between Secure World(OP-TEE) and Non-Secure World(U-Boot).
12
13
14Change Log
15==========================
162020.8 Update OP-TEE message protocol
17
18OP-TEE message protocol is updated from version 1 to version 2
19on platform RK312x/RK322x/RK3288/RK3399/RK3399Pro/RK3368/RK3328/RK3228H.
20
21This message protocol update involves some software component, including
22OP-TEE(trust.img), U-Boot, Kernel, binary&library in Android/Linux.
23The software component above **MUST** be consistent because OP-TEE message
24protocol v1 and v2 are not compatible, otherwise TEE related function
25will **NOT** work normally.
26
27One Very Important Change:
28
29	MMU policy for share memory between REE and TEE
30	+-------+-----------------+----------------+
31	| arch  |  before update  |  after update  |
32	+-------+-----------------+----------------+
33	| arm64 | dcache enabled  | dcache enabled |
34	+-------+-----------------+----------------+
35	|  arm  | dcache disabled | dcache enabled |
36	+-------+-----------------+----------------+
37
38Related commits are shown below:
39
401. rkbin
41	c20711e rk3036: tee: update optee version to v2.00
42	cb7d8f9 rk322x: tee with ta: update optee version to v2.11
43	4f9488e rk3128x: tee with ta: update optee version to v2.11
44	6d6473c rk312x: tee with ta: update optee version to v2.01
45	c0b025b rk3288: tee with ta: update optee version to v2.01
46	664ccee rk3228h/rk3328: bl32: update version to 2.01
47	6334115 rk3368: bl32: update version to 2.01
48	ccf1bef rk3399pro: bl32: update version to 2.01
49	8c01e53 rk3399: bl32: update version to 2.01
50
512. uboot
52	7a349fdcbd lib: optee_client: add optee initialize flag
53	74eb602743 lib: optee_client: update to new optee msg for optee v1 platform
54	102dfafc4a rochchip: board: map op-tee memory as dcache enabled
55	396e3049bd rochchip: board: only map op-tee share memory as dcache enabled
56
573. kernel
58	1) 4.19
59		90928381ffa9 ARM: dts: rockchip: add firmware and optee node
60		d752a21c0853 arm64: dts: rockchip: add firmware and optee node
61		c31ab35ad86d ARM: rockchip_defconfig: enable CONFIG_TEE and CONFIG_OPTEE
62
634. Android
64	1) Android 10
65	repo: android/rk/platform/vendor/rockchip/common
66		a515160d optee: v1 rebuild ca/ta to support new OP-TEE MSG
67		4fc68259 optee v1: arm&arm64: update tee-supplicant and libteec.so
68		a515160d optee: v1 rebuild ca/ta to support new OP-TEE MSG
69	repo: android/rk/hardware/rk29/weaver
70		26c9dd9b rebuild libRkTeeWeaver.v1.so for new OP-TEE MSG
71
725. Linux
73	repo: linux/security/bin
74		f59085c optee_v1: lib: arm&arm64: update binary and library
75