xref: /linux/drivers/crypto/intel/keembay/keembay-ocs-ecc.c (revision 3d0fe49454652117522f60bfbefb978ba0e5300b)
1 // SPDX-License-Identifier: GPL-2.0-only
2 /*
3  * Intel Keem Bay OCS ECC Crypto Driver.
4  *
5  * Copyright (C) 2019-2021 Intel Corporation
6  */
7 
8 #define pr_fmt(fmt) KBUILD_MODNAME ": " fmt
9 
10 #include <crypto/ecc_curve.h>
11 #include <crypto/ecdh.h>
12 #include <crypto/engine.h>
13 #include <crypto/internal/ecc.h>
14 #include <crypto/internal/kpp.h>
15 #include <crypto/kpp.h>
16 #include <crypto/rng.h>
17 #include <linux/clk.h>
18 #include <linux/completion.h>
19 #include <linux/err.h>
20 #include <linux/fips.h>
21 #include <linux/interrupt.h>
22 #include <linux/io.h>
23 #include <linux/iopoll.h>
24 #include <linux/irq.h>
25 #include <linux/kernel.h>
26 #include <linux/module.h>
27 #include <linux/of.h>
28 #include <linux/platform_device.h>
29 #include <linux/scatterlist.h>
30 #include <linux/string.h>
31 
32 #define DRV_NAME			"keembay-ocs-ecc"
33 
34 #define KMB_OCS_ECC_PRIORITY		350
35 
36 #define HW_OFFS_OCS_ECC_COMMAND		0x00000000
37 #define HW_OFFS_OCS_ECC_STATUS		0x00000004
38 #define HW_OFFS_OCS_ECC_DATA_IN		0x00000080
39 #define HW_OFFS_OCS_ECC_CX_DATA_OUT	0x00000100
40 #define HW_OFFS_OCS_ECC_CY_DATA_OUT	0x00000180
41 #define HW_OFFS_OCS_ECC_ISR		0x00000400
42 #define HW_OFFS_OCS_ECC_IER		0x00000404
43 
44 #define HW_OCS_ECC_ISR_INT_STATUS_DONE	BIT(0)
45 #define HW_OCS_ECC_COMMAND_INS_BP	BIT(0)
46 
47 #define HW_OCS_ECC_COMMAND_START_VAL	BIT(0)
48 
49 #define OCS_ECC_OP_SIZE_384		BIT(8)
50 #define OCS_ECC_OP_SIZE_256		0
51 
52 /* ECC Instruction : for ECC_COMMAND */
53 #define OCS_ECC_INST_WRITE_AX		(0x1 << HW_OCS_ECC_COMMAND_INS_BP)
54 #define OCS_ECC_INST_WRITE_AY		(0x2 << HW_OCS_ECC_COMMAND_INS_BP)
55 #define OCS_ECC_INST_WRITE_BX_D		(0x3 << HW_OCS_ECC_COMMAND_INS_BP)
56 #define OCS_ECC_INST_WRITE_BY_L		(0x4 << HW_OCS_ECC_COMMAND_INS_BP)
57 #define OCS_ECC_INST_WRITE_P		(0x5 << HW_OCS_ECC_COMMAND_INS_BP)
58 #define OCS_ECC_INST_WRITE_A		(0x6 << HW_OCS_ECC_COMMAND_INS_BP)
59 #define OCS_ECC_INST_CALC_D_IDX_A	(0x8 << HW_OCS_ECC_COMMAND_INS_BP)
60 #define OCS_ECC_INST_CALC_A_POW_B_MODP	(0xB << HW_OCS_ECC_COMMAND_INS_BP)
61 #define OCS_ECC_INST_CALC_A_MUL_B_MODP	(0xC  << HW_OCS_ECC_COMMAND_INS_BP)
62 #define OCS_ECC_INST_CALC_A_ADD_B_MODP	(0xD << HW_OCS_ECC_COMMAND_INS_BP)
63 
64 #define ECC_ENABLE_INTR			1
65 
66 #define POLL_USEC			100
67 #define TIMEOUT_USEC			10000
68 
69 #define KMB_ECC_VLI_MAX_DIGITS		ECC_CURVE_NIST_P384_DIGITS
70 #define KMB_ECC_VLI_MAX_BYTES		(KMB_ECC_VLI_MAX_DIGITS \
71 					 << ECC_DIGITS_TO_BYTES_SHIFT)
72 
73 #define POW_CUBE			3
74 
75 /**
76  * struct ocs_ecc_dev - ECC device context
77  * @list: List of device contexts
78  * @dev: OCS ECC device
79  * @base_reg: IO base address of OCS ECC
80  * @engine: Crypto engine for the device
81  * @irq_done: IRQ done completion.
82  * @irq: IRQ number
83  */
84 struct ocs_ecc_dev {
85 	struct list_head list;
86 	struct device *dev;
87 	void __iomem *base_reg;
88 	struct crypto_engine *engine;
89 	struct completion irq_done;
90 	int irq;
91 };
92 
93 /**
94  * struct ocs_ecc_ctx - Transformation context.
95  * @ecc_dev:	 The ECC driver associated with this context.
96  * @curve:	 The elliptic curve used by this transformation.
97  * @private_key: The private key.
98  */
99 struct ocs_ecc_ctx {
100 	struct ocs_ecc_dev *ecc_dev;
101 	const struct ecc_curve *curve;
102 	u64 private_key[KMB_ECC_VLI_MAX_DIGITS];
103 };
104 
105 /* Driver data. */
106 struct ocs_ecc_drv {
107 	struct list_head dev_list;
108 	spinlock_t lock;	/* Protects dev_list. */
109 };
110 
111 /* Global variable holding the list of OCS ECC devices (only one expected). */
112 static struct ocs_ecc_drv ocs_ecc = {
113 	.dev_list = LIST_HEAD_INIT(ocs_ecc.dev_list),
114 	.lock = __SPIN_LOCK_UNLOCKED(ocs_ecc.lock),
115 };
116 
117 /* Get OCS ECC tfm context from kpp_request. */
118 static inline struct ocs_ecc_ctx *kmb_ocs_ecc_tctx(struct kpp_request *req)
119 {
120 	return kpp_tfm_ctx(crypto_kpp_reqtfm(req));
121 }
122 
123 /* Converts number of digits to number of bytes. */
124 static inline unsigned int digits_to_bytes(unsigned int n)
125 {
126 	return n << ECC_DIGITS_TO_BYTES_SHIFT;
127 }
128 
129 /*
130  * Wait for ECC idle i.e when an operation (other than write operations)
131  * is done.
132  */
133 static inline int ocs_ecc_wait_idle(struct ocs_ecc_dev *dev)
134 {
135 	u32 value;
136 
137 	return readl_poll_timeout((dev->base_reg + HW_OFFS_OCS_ECC_STATUS),
138 				  value,
139 				  !(value & HW_OCS_ECC_ISR_INT_STATUS_DONE),
140 				  POLL_USEC, TIMEOUT_USEC);
141 }
142 
143 static void ocs_ecc_cmd_start(struct ocs_ecc_dev *ecc_dev, u32 op_size)
144 {
145 	iowrite32(op_size | HW_OCS_ECC_COMMAND_START_VAL,
146 		  ecc_dev->base_reg + HW_OFFS_OCS_ECC_COMMAND);
147 }
148 
149 /* Direct write of u32 buffer to ECC engine with associated instruction. */
150 static void ocs_ecc_write_cmd_and_data(struct ocs_ecc_dev *dev,
151 				       u32 op_size,
152 				       u32 inst,
153 				       const void *data_in,
154 				       size_t data_size)
155 {
156 	iowrite32(op_size | inst, dev->base_reg + HW_OFFS_OCS_ECC_COMMAND);
157 
158 	/* MMIO Write src uint32 to dst. */
159 	memcpy_toio(dev->base_reg + HW_OFFS_OCS_ECC_DATA_IN, data_in,
160 		    data_size);
161 }
162 
163 /* Start OCS ECC operation and wait for its completion. */
164 static int ocs_ecc_trigger_op(struct ocs_ecc_dev *ecc_dev, u32 op_size,
165 			      u32 inst)
166 {
167 	reinit_completion(&ecc_dev->irq_done);
168 
169 	iowrite32(ECC_ENABLE_INTR, ecc_dev->base_reg + HW_OFFS_OCS_ECC_IER);
170 	iowrite32(op_size | inst, ecc_dev->base_reg + HW_OFFS_OCS_ECC_COMMAND);
171 
172 	return wait_for_completion_interruptible(&ecc_dev->irq_done);
173 }
174 
175 /**
176  * ocs_ecc_read_cx_out() - Read the CX data output buffer.
177  * @dev:	The OCS ECC device to read from.
178  * @cx_out:	The buffer where to store the CX value. Must be at least
179  *		@byte_count byte long.
180  * @byte_count:	The amount of data to read.
181  */
182 static inline void ocs_ecc_read_cx_out(struct ocs_ecc_dev *dev, void *cx_out,
183 				       size_t byte_count)
184 {
185 	memcpy_fromio(cx_out, dev->base_reg + HW_OFFS_OCS_ECC_CX_DATA_OUT,
186 		      byte_count);
187 }
188 
189 /**
190  * ocs_ecc_read_cy_out() - Read the CX data output buffer.
191  * @dev:	The OCS ECC device to read from.
192  * @cy_out:	The buffer where to store the CY value. Must be at least
193  *		@byte_count byte long.
194  * @byte_count:	The amount of data to read.
195  */
196 static inline void ocs_ecc_read_cy_out(struct ocs_ecc_dev *dev, void *cy_out,
197 				       size_t byte_count)
198 {
199 	memcpy_fromio(cy_out, dev->base_reg + HW_OFFS_OCS_ECC_CY_DATA_OUT,
200 		      byte_count);
201 }
202 
203 static struct ocs_ecc_dev *kmb_ocs_ecc_find_dev(struct ocs_ecc_ctx *tctx)
204 {
205 	if (tctx->ecc_dev)
206 		return tctx->ecc_dev;
207 
208 	spin_lock(&ocs_ecc.lock);
209 
210 	/* Only a single OCS device available. */
211 	tctx->ecc_dev = list_first_entry(&ocs_ecc.dev_list, struct ocs_ecc_dev,
212 					 list);
213 
214 	spin_unlock(&ocs_ecc.lock);
215 
216 	return tctx->ecc_dev;
217 }
218 
219 /* Do point multiplication using OCS ECC HW. */
220 static int kmb_ecc_point_mult(struct ocs_ecc_dev *ecc_dev,
221 			      struct ecc_point *result,
222 			      const struct ecc_point *point,
223 			      u64 *scalar,
224 			      const struct ecc_curve *curve)
225 {
226 	u8 sca[KMB_ECC_VLI_MAX_BYTES]; /* Use the maximum data size. */
227 	u32 op_size = (curve->g.ndigits > ECC_CURVE_NIST_P256_DIGITS) ?
228 		      OCS_ECC_OP_SIZE_384 : OCS_ECC_OP_SIZE_256;
229 	size_t nbytes = digits_to_bytes(curve->g.ndigits);
230 	int rc = 0;
231 
232 	/* Generate random nbytes for Simple and Differential SCA protection. */
233 	rc = crypto_get_default_rng();
234 	if (rc)
235 		return rc;
236 
237 	rc = crypto_rng_get_bytes(crypto_default_rng, sca, nbytes);
238 	crypto_put_default_rng();
239 	if (rc)
240 		return rc;
241 
242 	/* Wait engine to be idle before starting new operation. */
243 	rc = ocs_ecc_wait_idle(ecc_dev);
244 	if (rc)
245 		return rc;
246 
247 	/* Send ecc_start pulse as well as indicating operation size. */
248 	ocs_ecc_cmd_start(ecc_dev, op_size);
249 
250 	/* Write ax param; Base point (Gx). */
251 	ocs_ecc_write_cmd_and_data(ecc_dev, op_size, OCS_ECC_INST_WRITE_AX,
252 				   point->x, nbytes);
253 
254 	/* Write ay param; Base point (Gy). */
255 	ocs_ecc_write_cmd_and_data(ecc_dev, op_size, OCS_ECC_INST_WRITE_AY,
256 				   point->y, nbytes);
257 
258 	/*
259 	 * Write the private key into DATA_IN reg.
260 	 *
261 	 * Since DATA_IN register is used to write different values during the
262 	 * computation private Key value is overwritten with
263 	 * side-channel-resistance value.
264 	 */
265 	ocs_ecc_write_cmd_and_data(ecc_dev, op_size, OCS_ECC_INST_WRITE_BX_D,
266 				   scalar, nbytes);
267 
268 	/* Write operand by/l. */
269 	ocs_ecc_write_cmd_and_data(ecc_dev, op_size, OCS_ECC_INST_WRITE_BY_L,
270 				   sca, nbytes);
271 	memzero_explicit(sca, sizeof(sca));
272 
273 	/* Write p = curve prime(GF modulus). */
274 	ocs_ecc_write_cmd_and_data(ecc_dev, op_size, OCS_ECC_INST_WRITE_P,
275 				   curve->p, nbytes);
276 
277 	/* Write a = curve coefficient. */
278 	ocs_ecc_write_cmd_and_data(ecc_dev, op_size, OCS_ECC_INST_WRITE_A,
279 				   curve->a, nbytes);
280 
281 	/* Make hardware perform the multiplication. */
282 	rc = ocs_ecc_trigger_op(ecc_dev, op_size, OCS_ECC_INST_CALC_D_IDX_A);
283 	if (rc)
284 		return rc;
285 
286 	/* Read result. */
287 	ocs_ecc_read_cx_out(ecc_dev, result->x, nbytes);
288 	ocs_ecc_read_cy_out(ecc_dev, result->y, nbytes);
289 
290 	return 0;
291 }
292 
293 /**
294  * kmb_ecc_do_scalar_op() - Perform Scalar operation using OCS ECC HW.
295  * @ecc_dev:	The OCS ECC device to use.
296  * @scalar_out:	Where to store the output scalar.
297  * @scalar_a:	Input scalar operand 'a'.
298  * @scalar_b:	Input scalar operand 'b'
299  * @curve:	The curve on which the operation is performed.
300  * @ndigits:	The size of the operands (in digits).
301  * @inst:	The operation to perform (as an OCS ECC instruction).
302  *
303  * Return:	0 on success, negative error code otherwise.
304  */
305 static int kmb_ecc_do_scalar_op(struct ocs_ecc_dev *ecc_dev, u64 *scalar_out,
306 				const u64 *scalar_a, const u64 *scalar_b,
307 				const struct ecc_curve *curve,
308 				unsigned int ndigits, const u32 inst)
309 {
310 	u32 op_size = (ndigits > ECC_CURVE_NIST_P256_DIGITS) ?
311 		      OCS_ECC_OP_SIZE_384 : OCS_ECC_OP_SIZE_256;
312 	size_t nbytes = digits_to_bytes(ndigits);
313 	int rc;
314 
315 	/* Wait engine to be idle before starting new operation. */
316 	rc = ocs_ecc_wait_idle(ecc_dev);
317 	if (rc)
318 		return rc;
319 
320 	/* Send ecc_start pulse as well as indicating operation size. */
321 	ocs_ecc_cmd_start(ecc_dev, op_size);
322 
323 	/* Write ax param (Base point (Gx).*/
324 	ocs_ecc_write_cmd_and_data(ecc_dev, op_size, OCS_ECC_INST_WRITE_AX,
325 				   scalar_a, nbytes);
326 
327 	/* Write ay param Base point (Gy).*/
328 	ocs_ecc_write_cmd_and_data(ecc_dev, op_size, OCS_ECC_INST_WRITE_AY,
329 				   scalar_b, nbytes);
330 
331 	/* Write p = curve prime(GF modulus).*/
332 	ocs_ecc_write_cmd_and_data(ecc_dev, op_size, OCS_ECC_INST_WRITE_P,
333 				   curve->p, nbytes);
334 
335 	/* Give instruction A.B or A+B to ECC engine. */
336 	rc = ocs_ecc_trigger_op(ecc_dev, op_size, inst);
337 	if (rc)
338 		return rc;
339 
340 	ocs_ecc_read_cx_out(ecc_dev, scalar_out, nbytes);
341 
342 	if (vli_is_zero(scalar_out, ndigits))
343 		return -EINVAL;
344 
345 	return 0;
346 }
347 
348 /* SP800-56A section 5.6.2.3.4 partial verification: ephemeral keys only */
349 static int kmb_ocs_ecc_is_pubkey_valid_partial(struct ocs_ecc_dev *ecc_dev,
350 					       const struct ecc_curve *curve,
351 					       struct ecc_point *pk)
352 {
353 	u64 xxx[KMB_ECC_VLI_MAX_DIGITS] = { 0 };
354 	u64 yy[KMB_ECC_VLI_MAX_DIGITS] = { 0 };
355 	u64 w[KMB_ECC_VLI_MAX_DIGITS] = { 0 };
356 	int rc;
357 
358 	if (WARN_ON(pk->ndigits != curve->g.ndigits))
359 		return -EINVAL;
360 
361 	/* Check 1: Verify key is not the zero point. */
362 	if (ecc_point_is_zero(pk))
363 		return -EINVAL;
364 
365 	/* Check 2: Verify key is in the range [0, p-1]. */
366 	if (vli_cmp(curve->p, pk->x, pk->ndigits) != 1)
367 		return -EINVAL;
368 
369 	if (vli_cmp(curve->p, pk->y, pk->ndigits) != 1)
370 		return -EINVAL;
371 
372 	/* Check 3: Verify that y^2 == (x^3 + a·x + b) mod p */
373 
374 	 /* y^2 */
375 	/* Compute y^2 -> store in yy */
376 	rc = kmb_ecc_do_scalar_op(ecc_dev, yy, pk->y, pk->y, curve, pk->ndigits,
377 				  OCS_ECC_INST_CALC_A_MUL_B_MODP);
378 	if (rc)
379 		goto exit;
380 
381 	/* x^3 */
382 	/* Assigning w = 3, used for calculating x^3. */
383 	w[0] = POW_CUBE;
384 	/* Load the next stage.*/
385 	rc = kmb_ecc_do_scalar_op(ecc_dev, xxx, pk->x, w, curve, pk->ndigits,
386 				  OCS_ECC_INST_CALC_A_POW_B_MODP);
387 	if (rc)
388 		goto exit;
389 
390 	/* Do a*x -> store in w. */
391 	rc = kmb_ecc_do_scalar_op(ecc_dev, w, curve->a, pk->x, curve,
392 				  pk->ndigits,
393 				  OCS_ECC_INST_CALC_A_MUL_B_MODP);
394 	if (rc)
395 		goto exit;
396 
397 	/* Do ax + b == w + b; store in w. */
398 	rc = kmb_ecc_do_scalar_op(ecc_dev, w, w, curve->b, curve,
399 				  pk->ndigits,
400 				  OCS_ECC_INST_CALC_A_ADD_B_MODP);
401 	if (rc)
402 		goto exit;
403 
404 	/* x^3 + ax + b == x^3 + w -> store in w. */
405 	rc = kmb_ecc_do_scalar_op(ecc_dev, w, xxx, w, curve, pk->ndigits,
406 				  OCS_ECC_INST_CALC_A_ADD_B_MODP);
407 	if (rc)
408 		goto exit;
409 
410 	/* Compare y^2 == x^3 + a·x + b. */
411 	rc = vli_cmp(yy, w, pk->ndigits);
412 	if (rc)
413 		rc = -EINVAL;
414 
415 exit:
416 	memzero_explicit(xxx, sizeof(xxx));
417 	memzero_explicit(yy, sizeof(yy));
418 	memzero_explicit(w, sizeof(w));
419 
420 	return rc;
421 }
422 
423 /* SP800-56A section 5.6.2.3.3 full verification */
424 static int kmb_ocs_ecc_is_pubkey_valid_full(struct ocs_ecc_dev *ecc_dev,
425 					    const struct ecc_curve *curve,
426 					    struct ecc_point *pk)
427 {
428 	struct ecc_point *nQ;
429 	int rc;
430 
431 	/* Checks 1 through 3 */
432 	rc = kmb_ocs_ecc_is_pubkey_valid_partial(ecc_dev, curve, pk);
433 	if (rc)
434 		return rc;
435 
436 	/* Check 4: Verify that nQ is the zero point. */
437 	nQ = ecc_alloc_point(pk->ndigits);
438 	if (!nQ)
439 		return -ENOMEM;
440 
441 	rc = kmb_ecc_point_mult(ecc_dev, nQ, pk, curve->n, curve);
442 	if (rc)
443 		goto exit;
444 
445 	if (!ecc_point_is_zero(nQ))
446 		rc = -EINVAL;
447 
448 exit:
449 	ecc_free_point(nQ);
450 
451 	return rc;
452 }
453 
454 static int kmb_ecc_is_key_valid(const struct ecc_curve *curve,
455 				const u64 *private_key, size_t private_key_len)
456 {
457 	size_t ndigits = curve->g.ndigits;
458 	u64 one[KMB_ECC_VLI_MAX_DIGITS] = {1};
459 	u64 res[KMB_ECC_VLI_MAX_DIGITS];
460 
461 	if (private_key_len != digits_to_bytes(ndigits))
462 		return -EINVAL;
463 
464 	if (!private_key)
465 		return -EINVAL;
466 
467 	/* Make sure the private key is in the range [2, n-3]. */
468 	if (vli_cmp(one, private_key, ndigits) != -1)
469 		return -EINVAL;
470 
471 	vli_sub(res, curve->n, one, ndigits);
472 	vli_sub(res, res, one, ndigits);
473 	if (vli_cmp(res, private_key, ndigits) != 1)
474 		return -EINVAL;
475 
476 	return 0;
477 }
478 
479 /*
480  * ECC private keys are generated using the method of extra random bits,
481  * equivalent to that described in FIPS 186-4, Appendix B.4.1.
482  *
483  * d = (c mod(n–1)) + 1    where c is a string of random bits, 64 bits longer
484  *                         than requested
485  * 0 <= c mod(n-1) <= n-2  and implies that
486  * 1 <= d <= n-1
487  *
488  * This method generates a private key uniformly distributed in the range
489  * [1, n-1].
490  */
491 static int kmb_ecc_gen_privkey(const struct ecc_curve *curve, u64 *privkey)
492 {
493 	size_t nbytes = digits_to_bytes(curve->g.ndigits);
494 	u64 priv[KMB_ECC_VLI_MAX_DIGITS];
495 	size_t nbits;
496 	int rc;
497 
498 	nbits = vli_num_bits(curve->n, curve->g.ndigits);
499 
500 	/* Check that N is included in Table 1 of FIPS 186-4, section 6.1.1 */
501 	if (nbits < 160 || curve->g.ndigits > ARRAY_SIZE(priv))
502 		return -EINVAL;
503 
504 	/*
505 	 * FIPS 186-4 recommends that the private key should be obtained from a
506 	 * RBG with a security strength equal to or greater than the security
507 	 * strength associated with N.
508 	 *
509 	 * The maximum security strength identified by NIST SP800-57pt1r4 for
510 	 * ECC is 256 (N >= 512).
511 	 *
512 	 * This condition is met by the default RNG because it selects a favored
513 	 * DRBG with a security strength of 256.
514 	 */
515 	if (crypto_get_default_rng())
516 		return -EFAULT;
517 
518 	rc = crypto_rng_get_bytes(crypto_default_rng, (u8 *)priv, nbytes);
519 	crypto_put_default_rng();
520 	if (rc)
521 		goto cleanup;
522 
523 	rc = kmb_ecc_is_key_valid(curve, priv, nbytes);
524 	if (rc)
525 		goto cleanup;
526 
527 	ecc_swap_digits(priv, privkey, curve->g.ndigits);
528 
529 cleanup:
530 	memzero_explicit(&priv, sizeof(priv));
531 
532 	return rc;
533 }
534 
535 static int kmb_ocs_ecdh_set_secret(struct crypto_kpp *tfm, const void *buf,
536 				   unsigned int len)
537 {
538 	struct ocs_ecc_ctx *tctx = kpp_tfm_ctx(tfm);
539 	struct ecdh params;
540 	int rc = 0;
541 
542 	rc = crypto_ecdh_decode_key(buf, len, &params);
543 	if (rc)
544 		goto cleanup;
545 
546 	/* Ensure key size is not bigger then expected. */
547 	if (params.key_size > digits_to_bytes(tctx->curve->g.ndigits)) {
548 		rc = -EINVAL;
549 		goto cleanup;
550 	}
551 
552 	/* Auto-generate private key is not provided. */
553 	if (!params.key || !params.key_size) {
554 		rc = kmb_ecc_gen_privkey(tctx->curve, tctx->private_key);
555 		goto cleanup;
556 	}
557 
558 	rc = kmb_ecc_is_key_valid(tctx->curve, (const u64 *)params.key,
559 				  params.key_size);
560 	if (rc)
561 		goto cleanup;
562 
563 	ecc_swap_digits((const u64 *)params.key, tctx->private_key,
564 			tctx->curve->g.ndigits);
565 cleanup:
566 	memzero_explicit(&params, sizeof(params));
567 
568 	if (rc)
569 		tctx->curve = NULL;
570 
571 	return rc;
572 }
573 
574 /* Compute shared secret. */
575 static int kmb_ecc_do_shared_secret(struct ocs_ecc_ctx *tctx,
576 				    struct kpp_request *req)
577 {
578 	struct ocs_ecc_dev *ecc_dev = tctx->ecc_dev;
579 	const struct ecc_curve *curve = tctx->curve;
580 	u64 shared_secret[KMB_ECC_VLI_MAX_DIGITS];
581 	u64 pubk_buf[KMB_ECC_VLI_MAX_DIGITS * 2];
582 	size_t copied, nbytes, pubk_len;
583 	struct ecc_point *pk, *result;
584 	int rc;
585 
586 	nbytes = digits_to_bytes(curve->g.ndigits);
587 
588 	/* Public key is a point, thus it has two coordinates */
589 	pubk_len = 2 * nbytes;
590 
591 	/* Copy public key from SG list to pubk_buf. */
592 	copied = sg_copy_to_buffer(req->src,
593 				   sg_nents_for_len(req->src, pubk_len),
594 				   pubk_buf, pubk_len);
595 	if (copied != pubk_len)
596 		return -EINVAL;
597 
598 	/* Allocate and initialize public key point. */
599 	pk = ecc_alloc_point(curve->g.ndigits);
600 	if (!pk)
601 		return -ENOMEM;
602 
603 	ecc_swap_digits(pubk_buf, pk->x, curve->g.ndigits);
604 	ecc_swap_digits(&pubk_buf[curve->g.ndigits], pk->y, curve->g.ndigits);
605 
606 	/*
607 	 * Check the public key for following
608 	 * Check 1: Verify key is not the zero point.
609 	 * Check 2: Verify key is in the range [1, p-1].
610 	 * Check 3: Verify that y^2 == (x^3 + a·x + b) mod p
611 	 */
612 	rc = kmb_ocs_ecc_is_pubkey_valid_partial(ecc_dev, curve, pk);
613 	if (rc)
614 		goto exit_free_pk;
615 
616 	/* Allocate point for storing computed shared secret. */
617 	result = ecc_alloc_point(pk->ndigits);
618 	if (!result) {
619 		rc = -ENOMEM;
620 		goto exit_free_pk;
621 	}
622 
623 	/* Calculate the shared secret.*/
624 	rc = kmb_ecc_point_mult(ecc_dev, result, pk, tctx->private_key, curve);
625 	if (rc)
626 		goto exit_free_result;
627 
628 	if (ecc_point_is_zero(result)) {
629 		rc = -EFAULT;
630 		goto exit_free_result;
631 	}
632 
633 	/* Copy shared secret from point to buffer. */
634 	ecc_swap_digits(result->x, shared_secret, result->ndigits);
635 
636 	/* Request might ask for less bytes than what we have. */
637 	nbytes = min_t(size_t, nbytes, req->dst_len);
638 
639 	copied = sg_copy_from_buffer(req->dst,
640 				     sg_nents_for_len(req->dst, nbytes),
641 				     shared_secret, nbytes);
642 
643 	if (copied != nbytes)
644 		rc = -EINVAL;
645 
646 	memzero_explicit(shared_secret, sizeof(shared_secret));
647 
648 exit_free_result:
649 	ecc_free_point(result);
650 
651 exit_free_pk:
652 	ecc_free_point(pk);
653 
654 	return rc;
655 }
656 
657 /* Compute public key. */
658 static int kmb_ecc_do_public_key(struct ocs_ecc_ctx *tctx,
659 				 struct kpp_request *req)
660 {
661 	const struct ecc_curve *curve = tctx->curve;
662 	u64 pubk_buf[KMB_ECC_VLI_MAX_DIGITS * 2];
663 	struct ecc_point *pk;
664 	size_t pubk_len;
665 	size_t copied;
666 	int rc;
667 
668 	/* Public key is a point, so it has double the digits. */
669 	pubk_len = 2 * digits_to_bytes(curve->g.ndigits);
670 
671 	pk = ecc_alloc_point(curve->g.ndigits);
672 	if (!pk)
673 		return -ENOMEM;
674 
675 	/* Public Key(pk) = priv * G. */
676 	rc = kmb_ecc_point_mult(tctx->ecc_dev, pk, &curve->g, tctx->private_key,
677 				curve);
678 	if (rc)
679 		goto exit;
680 
681 	/* SP800-56A rev 3 5.6.2.1.3 key check */
682 	if (kmb_ocs_ecc_is_pubkey_valid_full(tctx->ecc_dev, curve, pk)) {
683 		rc = -EAGAIN;
684 		goto exit;
685 	}
686 
687 	/* Copy public key from point to buffer. */
688 	ecc_swap_digits(pk->x, pubk_buf, pk->ndigits);
689 	ecc_swap_digits(pk->y, &pubk_buf[pk->ndigits], pk->ndigits);
690 
691 	/* Copy public key to req->dst. */
692 	copied = sg_copy_from_buffer(req->dst,
693 				     sg_nents_for_len(req->dst, pubk_len),
694 				     pubk_buf, pubk_len);
695 
696 	if (copied != pubk_len)
697 		rc = -EINVAL;
698 
699 exit:
700 	ecc_free_point(pk);
701 
702 	return rc;
703 }
704 
705 static int kmb_ocs_ecc_do_one_request(struct crypto_engine *engine,
706 				      void *areq)
707 {
708 	struct kpp_request *req = container_of(areq, struct kpp_request, base);
709 	struct ocs_ecc_ctx *tctx = kmb_ocs_ecc_tctx(req);
710 	struct ocs_ecc_dev *ecc_dev = tctx->ecc_dev;
711 	int rc;
712 
713 	if (req->src)
714 		rc = kmb_ecc_do_shared_secret(tctx, req);
715 	else
716 		rc = kmb_ecc_do_public_key(tctx, req);
717 
718 	crypto_finalize_kpp_request(ecc_dev->engine, req, rc);
719 
720 	return 0;
721 }
722 
723 static int kmb_ocs_ecdh_generate_public_key(struct kpp_request *req)
724 {
725 	struct ocs_ecc_ctx *tctx = kmb_ocs_ecc_tctx(req);
726 	const struct ecc_curve *curve = tctx->curve;
727 
728 	/* Ensure kmb_ocs_ecdh_set_secret() has been successfully called. */
729 	if (!tctx->curve)
730 		return -EINVAL;
731 
732 	/* Ensure dst is present. */
733 	if (!req->dst)
734 		return -EINVAL;
735 
736 	/* Check the request dst is big enough to hold the public key. */
737 	if (req->dst_len < (2 * digits_to_bytes(curve->g.ndigits)))
738 		return -EINVAL;
739 
740 	/* 'src' is not supposed to be present when generate pubk is called. */
741 	if (req->src)
742 		return -EINVAL;
743 
744 	return crypto_transfer_kpp_request_to_engine(tctx->ecc_dev->engine,
745 						     req);
746 }
747 
748 static int kmb_ocs_ecdh_compute_shared_secret(struct kpp_request *req)
749 {
750 	struct ocs_ecc_ctx *tctx = kmb_ocs_ecc_tctx(req);
751 	const struct ecc_curve *curve = tctx->curve;
752 
753 	/* Ensure kmb_ocs_ecdh_set_secret() has been successfully called. */
754 	if (!tctx->curve)
755 		return -EINVAL;
756 
757 	/* Ensure dst is present. */
758 	if (!req->dst)
759 		return -EINVAL;
760 
761 	/* Ensure src is present. */
762 	if (!req->src)
763 		return -EINVAL;
764 
765 	/*
766 	 * req->src is expected to the (other-side) public key, so its length
767 	 * must be 2 * coordinate size (in bytes).
768 	 */
769 	if (req->src_len != 2 * digits_to_bytes(curve->g.ndigits))
770 		return -EINVAL;
771 
772 	return crypto_transfer_kpp_request_to_engine(tctx->ecc_dev->engine,
773 						     req);
774 }
775 
776 static int kmb_ecc_tctx_init(struct ocs_ecc_ctx *tctx, unsigned int curve_id)
777 {
778 	memset(tctx, 0, sizeof(*tctx));
779 
780 	tctx->ecc_dev = kmb_ocs_ecc_find_dev(tctx);
781 
782 	if (IS_ERR(tctx->ecc_dev)) {
783 		pr_err("Failed to find the device : %ld\n",
784 		       PTR_ERR(tctx->ecc_dev));
785 		return PTR_ERR(tctx->ecc_dev);
786 	}
787 
788 	tctx->curve = ecc_get_curve(curve_id);
789 	if (!tctx->curve)
790 		return -EOPNOTSUPP;
791 
792 	return 0;
793 }
794 
795 static int kmb_ocs_ecdh_nist_p256_init_tfm(struct crypto_kpp *tfm)
796 {
797 	struct ocs_ecc_ctx *tctx = kpp_tfm_ctx(tfm);
798 
799 	return kmb_ecc_tctx_init(tctx, ECC_CURVE_NIST_P256);
800 }
801 
802 static int kmb_ocs_ecdh_nist_p384_init_tfm(struct crypto_kpp *tfm)
803 {
804 	struct ocs_ecc_ctx *tctx = kpp_tfm_ctx(tfm);
805 
806 	return kmb_ecc_tctx_init(tctx, ECC_CURVE_NIST_P384);
807 }
808 
809 static void kmb_ocs_ecdh_exit_tfm(struct crypto_kpp *tfm)
810 {
811 	struct ocs_ecc_ctx *tctx = kpp_tfm_ctx(tfm);
812 
813 	memzero_explicit(tctx->private_key, sizeof(*tctx->private_key));
814 }
815 
816 static unsigned int kmb_ocs_ecdh_max_size(struct crypto_kpp *tfm)
817 {
818 	struct ocs_ecc_ctx *tctx = kpp_tfm_ctx(tfm);
819 
820 	/* Public key is made of two coordinates, so double the digits. */
821 	return digits_to_bytes(tctx->curve->g.ndigits) * 2;
822 }
823 
824 static struct kpp_engine_alg ocs_ecdh_p256 = {
825 	.base.set_secret = kmb_ocs_ecdh_set_secret,
826 	.base.generate_public_key = kmb_ocs_ecdh_generate_public_key,
827 	.base.compute_shared_secret = kmb_ocs_ecdh_compute_shared_secret,
828 	.base.init = kmb_ocs_ecdh_nist_p256_init_tfm,
829 	.base.exit = kmb_ocs_ecdh_exit_tfm,
830 	.base.max_size = kmb_ocs_ecdh_max_size,
831 	.base.base = {
832 		.cra_name = "ecdh-nist-p256",
833 		.cra_driver_name = "ecdh-nist-p256-keembay-ocs",
834 		.cra_priority = KMB_OCS_ECC_PRIORITY,
835 		.cra_module = THIS_MODULE,
836 		.cra_ctxsize = sizeof(struct ocs_ecc_ctx),
837 	},
838 	.op.do_one_request = kmb_ocs_ecc_do_one_request,
839 };
840 
841 static struct kpp_engine_alg ocs_ecdh_p384 = {
842 	.base.set_secret = kmb_ocs_ecdh_set_secret,
843 	.base.generate_public_key = kmb_ocs_ecdh_generate_public_key,
844 	.base.compute_shared_secret = kmb_ocs_ecdh_compute_shared_secret,
845 	.base.init = kmb_ocs_ecdh_nist_p384_init_tfm,
846 	.base.exit = kmb_ocs_ecdh_exit_tfm,
847 	.base.max_size = kmb_ocs_ecdh_max_size,
848 	.base.base = {
849 		.cra_name = "ecdh-nist-p384",
850 		.cra_driver_name = "ecdh-nist-p384-keembay-ocs",
851 		.cra_priority = KMB_OCS_ECC_PRIORITY,
852 		.cra_module = THIS_MODULE,
853 		.cra_ctxsize = sizeof(struct ocs_ecc_ctx),
854 	},
855 	.op.do_one_request = kmb_ocs_ecc_do_one_request,
856 };
857 
858 static irqreturn_t ocs_ecc_irq_handler(int irq, void *dev_id)
859 {
860 	struct ocs_ecc_dev *ecc_dev = dev_id;
861 	u32 status;
862 
863 	/*
864 	 * Read the status register and write it back to clear the
865 	 * DONE_INT_STATUS bit.
866 	 */
867 	status = ioread32(ecc_dev->base_reg + HW_OFFS_OCS_ECC_ISR);
868 	iowrite32(status, ecc_dev->base_reg + HW_OFFS_OCS_ECC_ISR);
869 
870 	if (!(status & HW_OCS_ECC_ISR_INT_STATUS_DONE))
871 		return IRQ_NONE;
872 
873 	complete(&ecc_dev->irq_done);
874 
875 	return IRQ_HANDLED;
876 }
877 
878 static int kmb_ocs_ecc_probe(struct platform_device *pdev)
879 {
880 	struct device *dev = &pdev->dev;
881 	struct ocs_ecc_dev *ecc_dev;
882 	int rc;
883 
884 	ecc_dev = devm_kzalloc(dev, sizeof(*ecc_dev), GFP_KERNEL);
885 	if (!ecc_dev)
886 		return -ENOMEM;
887 
888 	ecc_dev->dev = dev;
889 
890 	platform_set_drvdata(pdev, ecc_dev);
891 
892 	INIT_LIST_HEAD(&ecc_dev->list);
893 	init_completion(&ecc_dev->irq_done);
894 
895 	/* Get base register address. */
896 	ecc_dev->base_reg = devm_platform_ioremap_resource(pdev, 0);
897 	if (IS_ERR(ecc_dev->base_reg)) {
898 		dev_err(dev, "Failed to get base address\n");
899 		rc = PTR_ERR(ecc_dev->base_reg);
900 		goto list_del;
901 	}
902 
903 	/* Get and request IRQ */
904 	ecc_dev->irq = platform_get_irq(pdev, 0);
905 	if (ecc_dev->irq < 0) {
906 		rc = ecc_dev->irq;
907 		goto list_del;
908 	}
909 
910 	rc = devm_request_threaded_irq(dev, ecc_dev->irq, ocs_ecc_irq_handler,
911 				       NULL, 0, "keembay-ocs-ecc", ecc_dev);
912 	if (rc < 0) {
913 		dev_err(dev, "Could not request IRQ\n");
914 		goto list_del;
915 	}
916 
917 	/* Add device to the list of OCS ECC devices. */
918 	spin_lock(&ocs_ecc.lock);
919 	list_add_tail(&ecc_dev->list, &ocs_ecc.dev_list);
920 	spin_unlock(&ocs_ecc.lock);
921 
922 	/* Initialize crypto engine. */
923 	ecc_dev->engine = crypto_engine_alloc_init(dev, 1);
924 	if (!ecc_dev->engine) {
925 		dev_err(dev, "Could not allocate crypto engine\n");
926 		rc = -ENOMEM;
927 		goto list_del;
928 	}
929 
930 	rc = crypto_engine_start(ecc_dev->engine);
931 	if (rc) {
932 		dev_err(dev, "Could not start crypto engine\n");
933 		goto cleanup;
934 	}
935 
936 	/* Register the KPP algo. */
937 	rc = crypto_engine_register_kpp(&ocs_ecdh_p256);
938 	if (rc) {
939 		dev_err(dev,
940 			"Could not register OCS algorithms with Crypto API\n");
941 		goto cleanup;
942 	}
943 
944 	rc = crypto_engine_register_kpp(&ocs_ecdh_p384);
945 	if (rc) {
946 		dev_err(dev,
947 			"Could not register OCS algorithms with Crypto API\n");
948 		goto ocs_ecdh_p384_error;
949 	}
950 
951 	return 0;
952 
953 ocs_ecdh_p384_error:
954 	crypto_engine_unregister_kpp(&ocs_ecdh_p256);
955 
956 cleanup:
957 	crypto_engine_exit(ecc_dev->engine);
958 
959 list_del:
960 	spin_lock(&ocs_ecc.lock);
961 	list_del(&ecc_dev->list);
962 	spin_unlock(&ocs_ecc.lock);
963 
964 	return rc;
965 }
966 
967 static void kmb_ocs_ecc_remove(struct platform_device *pdev)
968 {
969 	struct ocs_ecc_dev *ecc_dev;
970 
971 	ecc_dev = platform_get_drvdata(pdev);
972 
973 	crypto_engine_unregister_kpp(&ocs_ecdh_p384);
974 	crypto_engine_unregister_kpp(&ocs_ecdh_p256);
975 
976 	spin_lock(&ocs_ecc.lock);
977 	list_del(&ecc_dev->list);
978 	spin_unlock(&ocs_ecc.lock);
979 
980 	crypto_engine_exit(ecc_dev->engine);
981 }
982 
983 /* Device tree driver match. */
984 static const struct of_device_id kmb_ocs_ecc_of_match[] = {
985 	{
986 		.compatible = "intel,keembay-ocs-ecc",
987 	},
988 	{}
989 };
990 
991 /* The OCS driver is a platform device. */
992 static struct platform_driver kmb_ocs_ecc_driver = {
993 	.probe = kmb_ocs_ecc_probe,
994 	.remove_new = kmb_ocs_ecc_remove,
995 	.driver = {
996 			.name = DRV_NAME,
997 			.of_match_table = kmb_ocs_ecc_of_match,
998 		},
999 };
1000 module_platform_driver(kmb_ocs_ecc_driver);
1001 
1002 MODULE_LICENSE("GPL");
1003 MODULE_DESCRIPTION("Intel Keem Bay OCS ECC Driver");
1004 MODULE_ALIAS_CRYPTO("ecdh-nist-p256");
1005 MODULE_ALIAS_CRYPTO("ecdh-nist-p384");
1006 MODULE_ALIAS_CRYPTO("ecdh-nist-p256-keembay-ocs");
1007 MODULE_ALIAS_CRYPTO("ecdh-nist-p384-keembay-ocs");
1008