omap_sec_common.h 2.1 KB

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