xref: /linux/drivers/crypto/allwinner/sun8i-ss/sun8i-ss.h (revision da1d9caf95def6f0320819cf941c9fd1069ba9e1)
1 /* SPDX-License-Identifier: GPL-2.0 */
2 /*
3  * sun8i-ss.h - hardware cryptographic offloader for
4  * Allwinner A80/A83T SoC
5  *
6  * Copyright (C) 2016-2019 Corentin LABBE <clabbe.montjoie@gmail.com>
7  */
8 #include <crypto/aes.h>
9 #include <crypto/des.h>
10 #include <crypto/engine.h>
11 #include <crypto/rng.h>
12 #include <crypto/skcipher.h>
13 #include <linux/atomic.h>
14 #include <linux/debugfs.h>
15 #include <linux/crypto.h>
16 #include <crypto/internal/hash.h>
17 #include <crypto/md5.h>
18 #include <crypto/sha1.h>
19 #include <crypto/sha2.h>
20 
21 #define SS_START	1
22 
23 #define SS_ENCRYPTION		0
24 #define SS_DECRYPTION		BIT(6)
25 
26 #define SS_ALG_AES		0
27 #define SS_ALG_DES		(1 << 2)
28 #define SS_ALG_3DES		(2 << 2)
29 #define SS_ALG_MD5		(3 << 2)
30 #define SS_ALG_PRNG		(4 << 2)
31 #define SS_ALG_SHA1		(6 << 2)
32 #define SS_ALG_SHA224		(7 << 2)
33 #define SS_ALG_SHA256		(8 << 2)
34 
35 #define SS_CTL_REG		0x00
36 #define SS_INT_CTL_REG		0x04
37 #define SS_INT_STA_REG		0x08
38 #define SS_KEY_ADR_REG		0x10
39 #define SS_IV_ADR_REG		0x18
40 #define SS_SRC_ADR_REG		0x20
41 #define SS_DST_ADR_REG		0x28
42 #define SS_LEN_ADR_REG		0x30
43 
44 #define SS_ID_NOTSUPP		0xFF
45 
46 #define SS_ID_CIPHER_AES	0
47 #define SS_ID_CIPHER_DES	1
48 #define SS_ID_CIPHER_DES3	2
49 #define SS_ID_CIPHER_MAX	3
50 
51 #define SS_ID_OP_ECB	0
52 #define SS_ID_OP_CBC	1
53 #define SS_ID_OP_MAX	2
54 
55 #define SS_AES_128BITS 0
56 #define SS_AES_192BITS 1
57 #define SS_AES_256BITS 2
58 
59 #define SS_OP_ECB	0
60 #define SS_OP_CBC	(1 << 13)
61 
62 #define SS_ID_HASH_MD5	0
63 #define SS_ID_HASH_SHA1	1
64 #define SS_ID_HASH_SHA224	2
65 #define SS_ID_HASH_SHA256	3
66 #define SS_ID_HASH_MAX	4
67 
68 #define SS_FLOW0	BIT(30)
69 #define SS_FLOW1	BIT(31)
70 
71 #define SS_PRNG_CONTINUE	BIT(18)
72 
73 #define MAX_SG 8
74 
75 #define MAXFLOW 2
76 
77 #define SS_MAX_CLOCKS 2
78 
79 #define SS_DIE_ID_SHIFT	20
80 #define SS_DIE_ID_MASK	0x07
81 
82 #define PRNG_DATA_SIZE (160 / 8)
83 #define PRNG_SEED_SIZE DIV_ROUND_UP(175, 8)
84 
85 #define MAX_PAD_SIZE 4096
86 
87 /*
88  * struct ss_clock - Describe clocks used by sun8i-ss
89  * @name:       Name of clock needed by this variant
90  * @freq:       Frequency to set for each clock
91  * @max_freq:   Maximum frequency for each clock
92  */
93 struct ss_clock {
94 	const char *name;
95 	unsigned long freq;
96 	unsigned long max_freq;
97 };
98 
99 /*
100  * struct ss_variant - Describe SS capability for each variant hardware
101  * @alg_cipher:	list of supported ciphers. for each SS_ID_ this will give the
102  *              coresponding SS_ALG_XXX value
103  * @alg_hash:	list of supported hashes. for each SS_ID_ this will give the
104  *              corresponding SS_ALG_XXX value
105  * @op_mode:	list of supported block modes
106  * @ss_clks:	list of clock needed by this variant
107  */
108 struct ss_variant {
109 	char alg_cipher[SS_ID_CIPHER_MAX];
110 	char alg_hash[SS_ID_HASH_MAX];
111 	u32 op_mode[SS_ID_OP_MAX];
112 	struct ss_clock ss_clks[SS_MAX_CLOCKS];
113 };
114 
115 struct sginfo {
116 	u32 addr;
117 	u32 len;
118 };
119 
120 /*
121  * struct sun8i_ss_flow - Information used by each flow
122  * @engine:	ptr to the crypto_engine for this flow
123  * @complete:	completion for the current task on this flow
124  * @status:	set to 1 by interrupt if task is done
125  * @stat_req:	number of request done by this flow
126  * @iv:		list of IV to use for each step
127  * @biv:	buffer which contain the backuped IV
128  * @pad:	padding buffer for hash operations
129  * @result:	buffer for storing the result of hash operations
130  */
131 struct sun8i_ss_flow {
132 	struct crypto_engine *engine;
133 	struct completion complete;
134 	int status;
135 	u8 *iv[MAX_SG];
136 	u8 *biv;
137 	void *pad;
138 	void *result;
139 #ifdef CONFIG_CRYPTO_DEV_SUN8I_SS_DEBUG
140 	unsigned long stat_req;
141 #endif
142 };
143 
144 /*
145  * struct sun8i_ss_dev - main container for all this driver information
146  * @base:	base address of SS
147  * @ssclks:	clocks used by SS
148  * @reset:	pointer to reset controller
149  * @dev:	the platform device
150  * @mlock:	Control access to device registers
151  * @flows:	array of all flow
152  * @flow:	flow to use in next request
153  * @variant:	pointer to variant specific data
154  * @dbgfs_dir:	Debugfs dentry for statistic directory
155  * @dbgfs_stats: Debugfs dentry for statistic counters
156  */
157 struct sun8i_ss_dev {
158 	void __iomem *base;
159 	struct clk *ssclks[SS_MAX_CLOCKS];
160 	struct reset_control *reset;
161 	struct device *dev;
162 	struct mutex mlock;
163 	struct sun8i_ss_flow *flows;
164 	atomic_t flow;
165 	const struct ss_variant *variant;
166 #ifdef CONFIG_CRYPTO_DEV_SUN8I_SS_DEBUG
167 	struct dentry *dbgfs_dir;
168 	struct dentry *dbgfs_stats;
169 #endif
170 };
171 
172 /*
173  * struct sun8i_cipher_req_ctx - context for a skcipher request
174  * @t_src:		list of mapped SGs with their size
175  * @t_dst:		list of mapped SGs with their size
176  * @p_key:		DMA address of the key
177  * @p_iv:		DMA address of the IVs
178  * @niv:		Number of IVs DMA mapped
179  * @method:		current algorithm for this request
180  * @op_mode:		op_mode for this request
181  * @op_dir:		direction (encrypt vs decrypt) for this request
182  * @flow:		the flow to use for this request
183  * @ivlen:		size of IVs
184  * @keylen:		keylen for this request
185  * @fallback_req:	request struct for invoking the fallback skcipher TFM
186  */
187 struct sun8i_cipher_req_ctx {
188 	struct sginfo t_src[MAX_SG];
189 	struct sginfo t_dst[MAX_SG];
190 	u32 p_key;
191 	u32 p_iv[MAX_SG];
192 	int niv;
193 	u32 method;
194 	u32 op_mode;
195 	u32 op_dir;
196 	int flow;
197 	unsigned int ivlen;
198 	unsigned int keylen;
199 	struct skcipher_request fallback_req;   // keep at the end
200 };
201 
202 /*
203  * struct sun8i_cipher_tfm_ctx - context for a skcipher TFM
204  * @enginectx:		crypto_engine used by this TFM
205  * @key:		pointer to key data
206  * @keylen:		len of the key
207  * @ss:			pointer to the private data of driver handling this TFM
208  * @fallback_tfm:	pointer to the fallback TFM
209  *
210  * enginectx must be the first element
211  */
212 struct sun8i_cipher_tfm_ctx {
213 	struct crypto_engine_ctx enginectx;
214 	u32 *key;
215 	u32 keylen;
216 	struct sun8i_ss_dev *ss;
217 	struct crypto_skcipher *fallback_tfm;
218 };
219 
220 /*
221  * struct sun8i_ss_prng_ctx - context for PRNG TFM
222  * @seed:	The seed to use
223  * @slen:	The size of the seed
224  */
225 struct sun8i_ss_rng_tfm_ctx {
226 	void *seed;
227 	unsigned int slen;
228 };
229 
230 /*
231  * struct sun8i_ss_hash_tfm_ctx - context for an ahash TFM
232  * @enginectx:		crypto_engine used by this TFM
233  * @fallback_tfm:	pointer to the fallback TFM
234  * @ss:			pointer to the private data of driver handling this TFM
235  *
236  * enginectx must be the first element
237  */
238 struct sun8i_ss_hash_tfm_ctx {
239 	struct crypto_engine_ctx enginectx;
240 	struct crypto_ahash *fallback_tfm;
241 	struct sun8i_ss_dev *ss;
242 	u8 *ipad;
243 	u8 *opad;
244 	u8 key[SHA256_BLOCK_SIZE];
245 	int keylen;
246 };
247 
248 /*
249  * struct sun8i_ss_hash_reqctx - context for an ahash request
250  * @t_src:	list of DMA address and size for source SGs
251  * @t_dst:	list of DMA address and size for destination SGs
252  * @fallback_req:	pre-allocated fallback request
253  * @method:	the register value for the algorithm used by this request
254  * @flow:	the flow to use for this request
255  */
256 struct sun8i_ss_hash_reqctx {
257 	struct sginfo t_src[MAX_SG];
258 	struct sginfo t_dst[MAX_SG];
259 	struct ahash_request fallback_req;
260 	u32 method;
261 	int flow;
262 };
263 
264 /*
265  * struct sun8i_ss_alg_template - crypto_alg template
266  * @type:		the CRYPTO_ALG_TYPE for this template
267  * @ss_algo_id:		the SS_ID for this template
268  * @ss_blockmode:	the type of block operation SS_ID
269  * @ss:			pointer to the sun8i_ss_dev structure associated with
270  *			this template
271  * @alg:		one of sub struct must be used
272  * @stat_req:		number of request done on this template
273  * @stat_fb:		number of request which has fallbacked
274  * @stat_bytes:		total data size done by this template
275  */
276 struct sun8i_ss_alg_template {
277 	u32 type;
278 	u32 ss_algo_id;
279 	u32 ss_blockmode;
280 	struct sun8i_ss_dev *ss;
281 	union {
282 		struct skcipher_alg skcipher;
283 		struct rng_alg rng;
284 		struct ahash_alg hash;
285 	} alg;
286 	unsigned long stat_req;
287 	unsigned long stat_fb;
288 	unsigned long stat_bytes;
289 	unsigned long stat_fb_len;
290 	unsigned long stat_fb_sglen;
291 	unsigned long stat_fb_align;
292 	unsigned long stat_fb_sgnum;
293 	char fbname[CRYPTO_MAX_ALG_NAME];
294 };
295 
296 int sun8i_ss_enqueue(struct crypto_async_request *areq, u32 type);
297 
298 int sun8i_ss_aes_setkey(struct crypto_skcipher *tfm, const u8 *key,
299 			unsigned int keylen);
300 int sun8i_ss_des3_setkey(struct crypto_skcipher *tfm, const u8 *key,
301 			 unsigned int keylen);
302 int sun8i_ss_cipher_init(struct crypto_tfm *tfm);
303 void sun8i_ss_cipher_exit(struct crypto_tfm *tfm);
304 int sun8i_ss_skdecrypt(struct skcipher_request *areq);
305 int sun8i_ss_skencrypt(struct skcipher_request *areq);
306 
307 int sun8i_ss_get_engine_number(struct sun8i_ss_dev *ss);
308 
309 int sun8i_ss_run_task(struct sun8i_ss_dev *ss, struct sun8i_cipher_req_ctx *rctx, const char *name);
310 int sun8i_ss_prng_generate(struct crypto_rng *tfm, const u8 *src,
311 			   unsigned int slen, u8 *dst, unsigned int dlen);
312 int sun8i_ss_prng_seed(struct crypto_rng *tfm, const u8 *seed, unsigned int slen);
313 int sun8i_ss_prng_init(struct crypto_tfm *tfm);
314 void sun8i_ss_prng_exit(struct crypto_tfm *tfm);
315 
316 int sun8i_ss_hash_crainit(struct crypto_tfm *tfm);
317 void sun8i_ss_hash_craexit(struct crypto_tfm *tfm);
318 int sun8i_ss_hash_init(struct ahash_request *areq);
319 int sun8i_ss_hash_export(struct ahash_request *areq, void *out);
320 int sun8i_ss_hash_import(struct ahash_request *areq, const void *in);
321 int sun8i_ss_hash_final(struct ahash_request *areq);
322 int sun8i_ss_hash_update(struct ahash_request *areq);
323 int sun8i_ss_hash_finup(struct ahash_request *areq);
324 int sun8i_ss_hash_digest(struct ahash_request *areq);
325 int sun8i_ss_hash_run(struct crypto_engine *engine, void *breq);
326 int sun8i_ss_hmac_setkey(struct crypto_ahash *ahash, const u8 *key,
327 			 unsigned int keylen);
328