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