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