Linux kernel mirror (for testing)
git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel
os
linux
dt-bindings: arm: firmware: Convert linaro,optee-tz to json schema
Convert linaro,optee-tz to json schema format for better documentation
and error checks.
NOTE: This change does introduce a stricter naming convention for
optee nodes.
Signed-off-by: Nishanth Menon <nm@ti.com>
Link: https://lore.kernel.org/r/20210426164008.20000-1-nm@ti.com
Signed-off-by: Rob Herring <robh@kernel.org>
authored by
Nishanth Menon
and committed by
Rob Herring
be783297
5a9652f6
+58
-31
-31
Documentation/devicetree/bindings/arm/firmware/linaro,optee-tz.txt
-31
Documentation/devicetree/bindings/arm/firmware/linaro,optee-tz.txt
···
1
-
OP-TEE Device Tree Bindings
2
-
3
-
OP-TEE is a piece of software using hardware features to provide a Trusted
4
-
Execution Environment. The security can be provided with ARM TrustZone, but
5
-
also by virtualization or a separate chip.
6
-
7
-
We're using "linaro" as the first part of the compatible property for
8
-
the reference implementation maintained by Linaro.
9
-
10
-
* OP-TEE based on ARM TrustZone required properties:
11
-
12
-
- compatible : should contain "linaro,optee-tz"
13
-
14
-
- method : The method of calling the OP-TEE Trusted OS. Permitted
15
-
values are:
16
-
17
-
"smc" : SMC #0, with the register assignments specified
18
-
in drivers/tee/optee/optee_smc.h
19
-
20
-
"hvc" : HVC #0, with the register assignments specified
21
-
in drivers/tee/optee/optee_smc.h
22
-
23
-
24
-
25
-
Example:
26
-
firmware {
27
-
optee {
28
-
compatible = "linaro,optee-tz";
29
-
method = "smc";
30
-
};
31
-
};
+58
Documentation/devicetree/bindings/arm/firmware/linaro,optee-tz.yaml
+58
Documentation/devicetree/bindings/arm/firmware/linaro,optee-tz.yaml
···
1
+
# SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)
2
+
%YAML 1.2
3
+
---
4
+
$id: http://devicetree.org/schemas/arm/firmware/linaro,optee-tz.yaml#
5
+
$schema: http://devicetree.org/meta-schemas/core.yaml#
6
+
7
+
title: OP-TEE Device Tree Bindings
8
+
9
+
maintainers:
10
+
- Jens Wiklander <jens.wiklander@linaro.org>
11
+
12
+
description: |
13
+
OP-TEE is a piece of software using hardware features to provide a Trusted
14
+
Execution Environment. The security can be provided with ARM TrustZone, but
15
+
also by virtualization or a separate chip.
16
+
17
+
We're using "linaro" as the first part of the compatible property for
18
+
the reference implementation maintained by Linaro.
19
+
20
+
properties:
21
+
$nodename:
22
+
const: optee
23
+
24
+
compatible:
25
+
const: linaro,optee-tz
26
+
27
+
method:
28
+
enum: [smc, hvc]
29
+
description: |
30
+
The method of calling the OP-TEE Trusted OS depending on smc or hvc
31
+
instruction usage.
32
+
SMC #0, register assignments
33
+
or
34
+
HVC #0, register assignments
35
+
register assignments are specified in drivers/tee/optee/optee_smc.h
36
+
37
+
required:
38
+
- compatible
39
+
- method
40
+
41
+
additionalProperties: false
42
+
43
+
examples:
44
+
- |
45
+
firmware {
46
+
optee {
47
+
compatible = "linaro,optee-tz";
48
+
method = "smc";
49
+
};
50
+
};
51
+
52
+
- |
53
+
firmware {
54
+
optee {
55
+
compatible = "linaro,optee-tz";
56
+
method = "hvc";
57
+
};
58
+
};