xref: /rk3399_ARM-atf/include/drivers/auth/auth_mod.h (revision 44f1aa8efe627e578c38fbc0623b083223109342)
105799ae0SJuan Castillo /*
26f8a2565SSandrine Bailleux  * Copyright (c) 2015-2020, ARM Limited and Contributors. All rights reserved.
305799ae0SJuan Castillo  *
482cb2c1aSdp-arm  * SPDX-License-Identifier: BSD-3-Clause
505799ae0SJuan Castillo  */
605799ae0SJuan Castillo 
7c3cf06f1SAntonio Nino Diaz #ifndef AUTH_MOD_H
8c3cf06f1SAntonio Nino Diaz #define AUTH_MOD_H
905799ae0SJuan Castillo 
1005799ae0SJuan Castillo #if TRUSTED_BOARD_BOOT
1105799ae0SJuan Castillo 
1209d40e0eSAntonio Nino Diaz #include <common/tbbr/cot_def.h>
1309d40e0eSAntonio Nino Diaz #include <common/tbbr/tbbr_img_def.h>
1409d40e0eSAntonio Nino Diaz #include <drivers/auth/auth_common.h>
1509d40e0eSAntonio Nino Diaz #include <drivers/auth/img_parser_mod.h>
1605799ae0SJuan Castillo 
176f8a2565SSandrine Bailleux #include <lib/utils_def.h>
186f8a2565SSandrine Bailleux 
1905799ae0SJuan Castillo /*
2005799ae0SJuan Castillo  * Image flags
2105799ae0SJuan Castillo  */
2205799ae0SJuan Castillo #define IMG_FLAG_AUTHENTICATED		(1 << 0)
2305799ae0SJuan Castillo 
2405799ae0SJuan Castillo 
2505799ae0SJuan Castillo /*
2605799ae0SJuan Castillo  * Authentication image descriptor
2705799ae0SJuan Castillo  */
2805799ae0SJuan Castillo typedef struct auth_img_desc_s {
2905799ae0SJuan Castillo 	unsigned int img_id;
3005799ae0SJuan Castillo 	img_type_t img_type;
31b313d755SSoby Mathew 	const struct auth_img_desc_s *parent;
3230070427SJoel Hutton 	const auth_method_desc_t *const img_auth_methods;
3330070427SJoel Hutton 	const auth_param_desc_t *const authenticated_data;
3405799ae0SJuan Castillo } auth_img_desc_t;
3505799ae0SJuan Castillo 
3605799ae0SJuan Castillo /* Public functions */
3705799ae0SJuan Castillo void auth_mod_init(void);
3805799ae0SJuan Castillo int auth_mod_get_parent_id(unsigned int img_id, unsigned int *parent_id);
3905799ae0SJuan Castillo int auth_mod_verify_img(unsigned int img_id,
4005799ae0SJuan Castillo 			void *img_ptr,
4105799ae0SJuan Castillo 			unsigned int img_len);
4205799ae0SJuan Castillo 
430b6377d1SJoel Hutton /* Macro to register a CoT defined as an array of auth_img_desc_t pointers */
4405799ae0SJuan Castillo #define REGISTER_COT(_cot) \
452efb7ddcSSandrine Bailleux 	const auth_img_desc_t *const *const cot_desc_ptr = (_cot); \
466f8a2565SSandrine Bailleux 	const size_t cot_desc_size = ARRAY_SIZE(_cot);		   \
47735181b6SRoberto Vargas 	unsigned int auth_img_flags[MAX_NUMBER_IDS]
4805799ae0SJuan Castillo 
492efb7ddcSSandrine Bailleux extern const auth_img_desc_t *const *const cot_desc_ptr;
506f8a2565SSandrine Bailleux extern const size_t cot_desc_size;
513b94189aSRoberto Vargas extern unsigned int auth_img_flags[MAX_NUMBER_IDS];
523b94189aSRoberto Vargas 
53*44f1aa8eSManish Pandey #if defined(SPD_spmd)
54*44f1aa8eSManish Pandey #define DEFINE_SP_PKG(n) \
55*44f1aa8eSManish Pandey 	static const auth_img_desc_t sp_pkg##n = { \
56*44f1aa8eSManish Pandey 		.img_id = SP_CONTENT_CERT_ID + (n), \
57*44f1aa8eSManish Pandey 		.img_type = IMG_RAW, \
58*44f1aa8eSManish Pandey 		.parent = &sp_content_cert, \
59*44f1aa8eSManish Pandey 		.img_auth_methods = (const auth_method_desc_t[AUTH_METHOD_NUM]) { \
60*44f1aa8eSManish Pandey 			[0] = { \
61*44f1aa8eSManish Pandey 				.type = AUTH_METHOD_HASH, \
62*44f1aa8eSManish Pandey 				.param.hash = { \
63*44f1aa8eSManish Pandey 					.data = &raw_data, \
64*44f1aa8eSManish Pandey 					.hash = &sp_pkg##n##_hash \
65*44f1aa8eSManish Pandey 				} \
66*44f1aa8eSManish Pandey 			} \
67*44f1aa8eSManish Pandey 		} \
68*44f1aa8eSManish Pandey 	}
69*44f1aa8eSManish Pandey #endif
70*44f1aa8eSManish Pandey 
7105799ae0SJuan Castillo #endif /* TRUSTED_BOARD_BOOT */
7205799ae0SJuan Castillo 
73c3cf06f1SAntonio Nino Diaz #endif /* AUTH_MOD_H */
74