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