1 /*
2  * (C) Copyright 2016
3  * Texas Instruments, <www.ti.com>
4  *
5  * Andreas Dannenberg <dannenberg@ti.com>
6  *
7  * SPDX-License-Identifier:	GPL-2.0+
8  */
9 #ifndef	_OMAP_SEC_COMMON_H_
10 #define	_OMAP_SEC_COMMON_H_
11 
12 #include <common.h>
13 
14 /*
15  * Invoke secure ROM API on high-security (HS) device variants. It formats
16  * the variable argument list into the format expected by the ROM code before
17  * triggering the actual low-level smc entry.
18  */
19 u32 secure_rom_call(u32 service, u32 proc_id, u32 flag, ...);
20 
21 /*
22  * Invoke a secure ROM API on high-secure (HS) device variants that can be used
23  * to verify a secure blob by authenticating and optionally decrypting it. The
24  * exact operation performed depends on how the certificate that was embedded
25  * into the blob during the signing/encryption step when the secure blob was
26  * first created.
27  */
28 int secure_boot_verify_image(void **p_image, size_t *p_size);
29 
30 /*
31  * Return the start of secure reserved RAM, if a default start address has
32  * not been configured then return a region at the end of the external DRAM.
33  */
34 u32 get_sec_mem_start(void);
35 
36 /*
37  * Invoke a secure HAL API that allows configuration of the external memory
38  * firewall regions.
39  */
40 int secure_emif_firewall_setup(uint8_t region_num, uint32_t start_addr,
41 			       uint32_t size, uint32_t access_perm,
42 			       uint32_t initiator_perm);
43 
44 /*
45  * Invoke a secure HAL API on high-secure (HS) device variants that reserves a
46  * region of external memory for secure world use, and protects it using memory
47  * firewalls that prevent public world access. This API is intended to setaside
48  * memory that will be used for a secure world OS/TEE.
49  */
50 int secure_emif_reserve(void);
51 
52 /*
53  * Invoke a secure HAL API to lock the external memory firewall configurations.
54  * After this API is called, none of the HAL APIs for configuring the that
55  * firewall will be usable (calls to those APIs will return failure and have
56  * no effect).
57  */
58 int secure_emif_firewall_lock(void);
59 
60 /*
61  * Invoke a secure HAL API to authenticate and install a Trusted Execution
62  * Environment (TEE) image.
63  */
64 int secure_tee_install(u32 tee_image);
65 
66 #endif /* _OMAP_SEC_COMMON_H_ */
67