147549250SJit Loon Lim /* 247549250SJit Loon Lim * Copyright (c) 2020-2023, Intel Corporation. All rights reserved. 3cab83c34SJit Loon Lim * Copyright (c) 2024, Altera Corporation. All rights reserved. 447549250SJit Loon Lim * 547549250SJit Loon Lim * SPDX-License-Identifier: BSD-3-Clause 647549250SJit Loon Lim */ 747549250SJit Loon Lim 847549250SJit Loon Lim #ifndef SOCFPGA_VAB_H 947549250SJit Loon Lim #define SOCFPGA_VAB_H 1047549250SJit Loon Lim 1147549250SJit Loon Lim #include <stdlib.h> 1247549250SJit Loon Lim #include "socfpga_fcs.h" 1347549250SJit Loon Lim 14cab83c34SJit Loon Lim /* Macros */ 15cab83c34SJit Loon Lim #define IS_BYTE_ALIGNED(x, a) (((x) & ((typeof(x))(a) - 1)) == 0) 16cab83c34SJit Loon Lim #define BYTE_ALIGN(x, a) __ALIGN_MASK((x), (typeof(x))(a)-1) 17cab83c34SJit Loon Lim #define __ALIGN_MASK(x, mask) (((x)+(mask))&~(mask)) 18cab83c34SJit Loon Lim #define VAB_CERT_HEADER_SIZE sizeof(struct fcs_hps_vab_certificate_header) 19cab83c34SJit Loon Lim #define VAB_CERT_MAGIC_OFFSET offsetof(struct fcs_hps_vab_certificate_header, d) 20cab83c34SJit Loon Lim #define VAB_CERT_FIT_SHA384_OFFSET offsetof(struct fcs_hps_vab_certificate_data, fcs_sha384[0]) 21cab83c34SJit Loon Lim #define SDM_CERT_MAGIC_NUM 0x25D04E7F 22cab83c34SJit Loon Lim #define CHUNKSZ_PER_WD_RESET (256 * 1024) 23*3eb5640aSSieu Mun Tang #define CCERT_CMD_TEST_PGM_MASK 0x80000000 //TODO: ATF FDT location 24cab83c34SJit Loon Lim 25cab83c34SJit Loon Lim /* SHA related return Macro */ 26cab83c34SJit Loon Lim #define ENOVABCERT 1 /* VAB certificate not available */ 27cab83c34SJit Loon Lim #define EIMGERR 2 /* Image format/size not valid */ 28cab83c34SJit Loon Lim #define ETIMEOUT 3 /* Execution timeout */ 29cab83c34SJit Loon Lim #define EPROCESS 4 /* Process error */ 30cab83c34SJit Loon Lim #define EKEYREJECTED 5 /* Key was rejected by service */ 31*3eb5640aSSieu Mun Tang #define EINITREJECTED 6 /* VAB init was rejected */ 32cab83c34SJit Loon Lim 3347549250SJit Loon Lim struct fcs_hps_vab_certificate_data { 3447549250SJit Loon Lim uint32_t vab_cert_magic_num; /* offset 0x10 */ 3547549250SJit Loon Lim uint32_t flags; 3647549250SJit Loon Lim uint8_t rsvd0_1[8]; 3747549250SJit Loon Lim uint8_t fcs_sha384[FCS_SHA384_WORD_SIZE]; /* offset 0x20 */ 3847549250SJit Loon Lim }; 3947549250SJit Loon Lim 4047549250SJit Loon Lim struct fcs_hps_vab_certificate_header { 4147549250SJit Loon Lim uint32_t cert_magic_num; /* offset 0 */ 4247549250SJit Loon Lim uint32_t cert_data_sz; 4347549250SJit Loon Lim uint32_t cert_ver; 4447549250SJit Loon Lim uint32_t cert_type; 4547549250SJit Loon Lim struct fcs_hps_vab_certificate_data d; /* offset 0x10 */ 4647549250SJit Loon Lim /* keychain starts at offset 0x50 */ 4747549250SJit Loon Lim }; 4847549250SJit Loon Lim 4947549250SJit Loon Lim /* Function Definitions */ 50*3eb5640aSSieu Mun Tang size_t get_img_size(uint8_t *img_buf, size_t img_buf_sz); 51*3eb5640aSSieu Mun Tang uint32_t get_unaligned_le32(const void *p); 52*3eb5640aSSieu Mun Tang int socfpga_vab_authentication(void **p_image, size_t *p_size); 53*3eb5640aSSieu Mun Tang int socfpga_vab_init(unsigned int image_id); 5447549250SJit Loon Lim #endif 55