xref: /rk3399_ARM-atf/docs/components/measured_boot/event_log.rst (revision 1cf3e2f0a8eb0d6324ce3db68dd5c78bdb690a8a)
14a135bc3SAlexei FedorovDTB binding for Event Log properties
24a135bc3SAlexei Fedorov====================================
34a135bc3SAlexei Fedorov
44a135bc3SAlexei FedorovThis document describes the device tree format of Event Log properties.
54a135bc3SAlexei FedorovThese properties are not related to a specific platform and can be queried
64a135bc3SAlexei Fedorovfrom common code.
74a135bc3SAlexei Fedorov
84a135bc3SAlexei FedorovDynamic configuration for Event Log
94a135bc3SAlexei Fedorov~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
104a135bc3SAlexei Fedorov
114a135bc3SAlexei FedorovMeasured Boot driver expects a *tpm_event_log* node with the following field
12e742bcdaSManish V Badarkhein 'tb_fw_config', 'nt_fw_config' and 'tsp_fw_config' DTS files:
134a135bc3SAlexei Fedorov
144a135bc3SAlexei Fedorov- compatible [mandatory]
154a135bc3SAlexei Fedorov   - value type: <string>
164a135bc3SAlexei Fedorov   - Must be the string "arm,tpm_event_log".
174a135bc3SAlexei Fedorov
184a135bc3SAlexei FedorovThen a list of properties representing Event Log configuration, which
194a135bc3SAlexei Fedorovcan be used by Measured Boot driver. Each property is named according
204a135bc3SAlexei Fedorovto the information it contains:
214a135bc3SAlexei Fedorov
224a135bc3SAlexei Fedorov- tpm_event_log_sm_addr [fvp_nt_fw_config.dts with OP-TEE]
234a135bc3SAlexei Fedorov    - value type: <u64>
244a135bc3SAlexei Fedorov    - Event Log base address in secure memory.
254a135bc3SAlexei Fedorov
264a135bc3SAlexei FedorovNote. Currently OP-TEE does not support reading DTBs from Secure memory
274a135bc3SAlexei Fedorovand this property should be removed when this feature is supported.
284a135bc3SAlexei Fedorov
294a135bc3SAlexei Fedorov- tpm_event_log_addr [mandatory]
304a135bc3SAlexei Fedorov    - value type: <u64>
314a135bc3SAlexei Fedorov    - Event Log base address in non-secure memory.
324a135bc3SAlexei Fedorov
334a135bc3SAlexei Fedorov- tpm_event_log_size [mandatory]
344a135bc3SAlexei Fedorov    - value type: <u32>
354a135bc3SAlexei Fedorov    - Event Log size.
36*1cf3e2f0SManish V Badarkhe
37*1cf3e2f0SManish V Badarkhe- tpm_event_log_max_size [mandatory]
38*1cf3e2f0SManish V Badarkhe    - value type: <u32>
39*1cf3e2f0SManish V Badarkhe    - Event Log maximum size.
40*1cf3e2f0SManish V Badarkhe
41*1cf3e2f0SManish V Badarkhe--------------
42*1cf3e2f0SManish V Badarkhe
43*1cf3e2f0SManish V Badarkhe*Copyright (c) 2023, Arm Limited and Contributors. All rights reserved.*
44