xref: /rk3399_ARM-atf/docs/components/measured_boot/event_log.rst (revision 4a135bc33e4d22c6666167a2df67bf10caa30d0a)
1*4a135bc3SAlexei FedorovDTB binding for Event Log properties
2*4a135bc3SAlexei Fedorov====================================
3*4a135bc3SAlexei Fedorov
4*4a135bc3SAlexei FedorovThis document describes the device tree format of Event Log properties.
5*4a135bc3SAlexei FedorovThese properties are not related to a specific platform and can be queried
6*4a135bc3SAlexei Fedorovfrom common code.
7*4a135bc3SAlexei Fedorov
8*4a135bc3SAlexei FedorovDynamic configuration for Event Log
9*4a135bc3SAlexei Fedorov~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
10*4a135bc3SAlexei Fedorov
11*4a135bc3SAlexei FedorovMeasured Boot driver expects a *tpm_event_log* node with the following field
12*4a135bc3SAlexei Fedorovin 'nt_fw_config' and 'tsp_fw_config' DTS files:
13*4a135bc3SAlexei Fedorov
14*4a135bc3SAlexei Fedorov- compatible [mandatory]
15*4a135bc3SAlexei Fedorov   - value type: <string>
16*4a135bc3SAlexei Fedorov   - Must be the string "arm,tpm_event_log".
17*4a135bc3SAlexei Fedorov
18*4a135bc3SAlexei FedorovThen a list of properties representing Event Log configuration, which
19*4a135bc3SAlexei Fedorovcan be used by Measured Boot driver. Each property is named according
20*4a135bc3SAlexei Fedorovto the information it contains:
21*4a135bc3SAlexei Fedorov
22*4a135bc3SAlexei Fedorov- tpm_event_log_sm_addr [fvp_nt_fw_config.dts with OP-TEE]
23*4a135bc3SAlexei Fedorov    - value type: <u64>
24*4a135bc3SAlexei Fedorov    - Event Log base address in secure memory.
25*4a135bc3SAlexei Fedorov
26*4a135bc3SAlexei FedorovNote. Currently OP-TEE does not support reading DTBs from Secure memory
27*4a135bc3SAlexei Fedorovand this property should be removed when this feature is supported.
28*4a135bc3SAlexei Fedorov
29*4a135bc3SAlexei Fedorov- tpm_event_log_addr [mandatory]
30*4a135bc3SAlexei Fedorov    - value type: <u64>
31*4a135bc3SAlexei Fedorov    - Event Log base address in non-secure memory.
32*4a135bc3SAlexei Fedorov
33*4a135bc3SAlexei Fedorov- tpm_event_log_size [mandatory]
34*4a135bc3SAlexei Fedorov    - value type: <u32>
35*4a135bc3SAlexei Fedorov    - Event Log size.
36