xref: /arm-trusted-firmware/include/drivers/nxp/crypto/caam/caam.h (revision 91f16700b400a8c0651d24a598fc48ee2997a0d7)
1*91f16700Schasinglulu /*
2*91f16700Schasinglulu  * Copyright 2017-2022 NXP
3*91f16700Schasinglulu  *
4*91f16700Schasinglulu  * SPDX-License-Identifier: BSD-3-Clause
5*91f16700Schasinglulu  *
6*91f16700Schasinglulu  */
7*91f16700Schasinglulu 
8*91f16700Schasinglulu #ifndef CAAM_H
9*91f16700Schasinglulu #define CAAM_H
10*91f16700Schasinglulu 
11*91f16700Schasinglulu #include "caam_io.h"
12*91f16700Schasinglulu #include "sec_jr_driver.h"
13*91f16700Schasinglulu 
14*91f16700Schasinglulu 
15*91f16700Schasinglulu /* Job ring 3 is reserved for usage by sec firmware */
16*91f16700Schasinglulu #define DEFAULT_JR	3
17*91f16700Schasinglulu 
18*91f16700Schasinglulu #if defined(CONFIG_CHASSIS_3_2) || defined(CONFIG_CHASSIS_3) || defined(CONFIG_CHASSIS_2)
19*91f16700Schasinglulu #define CAAM_JR0_OFFSET			0x10000
20*91f16700Schasinglulu #define CAAM_JR1_OFFSET			0x20000
21*91f16700Schasinglulu #define CAAM_JR2_OFFSET			0x30000
22*91f16700Schasinglulu #define CAAM_JR3_OFFSET			0x40000
23*91f16700Schasinglulu #endif
24*91f16700Schasinglulu 
25*91f16700Schasinglulu enum sig_alg {
26*91f16700Schasinglulu 	RSA,
27*91f16700Schasinglulu 	ECC
28*91f16700Schasinglulu };
29*91f16700Schasinglulu 
30*91f16700Schasinglulu /* This function does basic SEC Initialization */
31*91f16700Schasinglulu int sec_init(uintptr_t nxp_caam_addr);
32*91f16700Schasinglulu int config_sec_block(void);
33*91f16700Schasinglulu uintptr_t get_caam_addr(void);
34*91f16700Schasinglulu 
35*91f16700Schasinglulu /* This function is used to submit jobs to JR */
36*91f16700Schasinglulu int run_descriptor_jr(struct job_descriptor *desc);
37*91f16700Schasinglulu 
38*91f16700Schasinglulu /* This function is used to instatiate the HW RNG is already not instantiated */
39*91f16700Schasinglulu int hw_rng_instantiate(void);
40*91f16700Schasinglulu 
41*91f16700Schasinglulu /* This function is used to return random bytes of byte_len from HW RNG */
42*91f16700Schasinglulu int get_rand_bytes_hw(uint8_t *bytes, int byte_len);
43*91f16700Schasinglulu 
44*91f16700Schasinglulu /* This function is used to set the hw unique key from HW CAAM */
45*91f16700Schasinglulu int get_hw_unq_key_blob_hw(uint8_t *hw_key, int size);
46*91f16700Schasinglulu 
47*91f16700Schasinglulu /* This function is used to fetch random number from
48*91f16700Schasinglulu  * CAAM of length either of 4 bytes or 8 bytes depending
49*91f16700Schasinglulu  * rngWidth value.
50*91f16700Schasinglulu  */
51*91f16700Schasinglulu unsigned long long get_random(int rngWidth);
52*91f16700Schasinglulu 
53*91f16700Schasinglulu #endif /* CAAM_H */
54