1 // SPDX-License-Identifier: GPL-2.0-only
3 * Copyright 2016 Broadcom
7 * This file works with the SPU2 version of the SPU. SPU2 has different message
8 * formats than the previous version of the SPU. All SPU message format
9 * differences should be hidden in the spux.c,h files.
12 #include <linux/kernel.h>
13 #include <linux/string.h>
19 #define SPU2_TX_STATUS_LEN 0 /* SPU2 has no STATUS in input packet */
22 * Controlled by pkt_stat_cnt field in CRYPTO_SS_SPU0_CORE_SPU2_CONTROL0
23 * register. Defaults to 2.
25 #define SPU2_RX_STATUS_LEN 2
29 SPU2_MACSEC_SECTAG8_ECB = 1,
30 SPU2_MACSEC_SECTAG8_SCB = 2,
31 SPU2_MACSEC_SECTAG16 = 3,
32 SPU2_MACSEC_SECTAG16_8_XPN = 4,
41 static char *spu2_cipher_type_names[] = { "None", "AES128", "AES192", "AES256",
45 static char *spu2_cipher_mode_names[] = { "ECB", "CBC", "CTR", "CFB", "OFB",
49 static char *spu2_hash_type_names[] = { "None", "AES128", "AES192", "AES256",
50 "Reserved", "Reserved", "MD5", "SHA1", "SHA224", "SHA256", "SHA384",
51 "SHA512", "SHA512/224", "SHA512/256", "SHA3-224", "SHA3-256",
52 "SHA3-384", "SHA3-512"
55 static char *spu2_hash_mode_names[] = { "CMAC", "CBC-MAC", "XCBC-MAC", "HMAC",
56 "Rabin", "CCM", "GCM", "Reserved"
59 static char *spu2_ciph_type_name(enum spu2_cipher_type cipher_type)
61 if (cipher_type >= SPU2_CIPHER_TYPE_LAST)
63 return spu2_cipher_type_names[cipher_type];
66 static char *spu2_ciph_mode_name(enum spu2_cipher_mode cipher_mode)
68 if (cipher_mode >= SPU2_CIPHER_MODE_LAST)
70 return spu2_cipher_mode_names[cipher_mode];
73 static char *spu2_hash_type_name(enum spu2_hash_type hash_type)
75 if (hash_type >= SPU2_HASH_TYPE_LAST)
77 return spu2_hash_type_names[hash_type];
80 static char *spu2_hash_mode_name(enum spu2_hash_mode hash_mode)
82 if (hash_mode >= SPU2_HASH_MODE_LAST)
84 return spu2_hash_mode_names[hash_mode];
88 * Convert from a software cipher mode value to the corresponding value
91 static int spu2_cipher_mode_xlate(enum spu_cipher_mode cipher_mode,
92 enum spu2_cipher_mode *spu2_mode)
94 switch (cipher_mode) {
96 *spu2_mode = SPU2_CIPHER_MODE_ECB;
99 *spu2_mode = SPU2_CIPHER_MODE_CBC;
101 case CIPHER_MODE_OFB:
102 *spu2_mode = SPU2_CIPHER_MODE_OFB;
104 case CIPHER_MODE_CFB:
105 *spu2_mode = SPU2_CIPHER_MODE_CFB;
107 case CIPHER_MODE_CTR:
108 *spu2_mode = SPU2_CIPHER_MODE_CTR;
110 case CIPHER_MODE_CCM:
111 *spu2_mode = SPU2_CIPHER_MODE_CCM;
113 case CIPHER_MODE_GCM:
114 *spu2_mode = SPU2_CIPHER_MODE_GCM;
116 case CIPHER_MODE_XTS:
117 *spu2_mode = SPU2_CIPHER_MODE_XTS;
126 * spu2_cipher_xlate() - Convert a cipher {alg/mode/type} triple to a SPU2
127 * cipher type and mode.
128 * @cipher_alg: [in] cipher algorithm value from software enumeration
129 * @cipher_mode: [in] cipher mode value from software enumeration
130 * @cipher_type: [in] cipher type value from software enumeration
131 * @spu2_type: [out] cipher type value used by spu2 hardware
132 * @spu2_mode: [out] cipher mode value used by spu2 hardware
134 * Return: 0 if successful
136 static int spu2_cipher_xlate(enum spu_cipher_alg cipher_alg,
137 enum spu_cipher_mode cipher_mode,
138 enum spu_cipher_type cipher_type,
139 enum spu2_cipher_type *spu2_type,
140 enum spu2_cipher_mode *spu2_mode)
144 err = spu2_cipher_mode_xlate(cipher_mode, spu2_mode);
146 flow_log("Invalid cipher mode %d\n", cipher_mode);
150 switch (cipher_alg) {
151 case CIPHER_ALG_NONE:
152 *spu2_type = SPU2_CIPHER_TYPE_NONE;
155 /* SPU2 does not support RC4 */
157 *spu2_type = SPU2_CIPHER_TYPE_NONE;
160 *spu2_type = SPU2_CIPHER_TYPE_DES;
162 case CIPHER_ALG_3DES:
163 *spu2_type = SPU2_CIPHER_TYPE_3DES;
166 switch (cipher_type) {
167 case CIPHER_TYPE_AES128:
168 *spu2_type = SPU2_CIPHER_TYPE_AES128;
170 case CIPHER_TYPE_AES192:
171 *spu2_type = SPU2_CIPHER_TYPE_AES192;
173 case CIPHER_TYPE_AES256:
174 *spu2_type = SPU2_CIPHER_TYPE_AES256;
180 case CIPHER_ALG_LAST:
187 flow_log("Invalid cipher alg %d or type %d\n",
188 cipher_alg, cipher_type);
193 * Convert from a software hash mode value to the corresponding value
194 * for SPU2. Note that HASH_MODE_NONE and HASH_MODE_XCBC have the same value.
196 static int spu2_hash_mode_xlate(enum hash_mode hash_mode,
197 enum spu2_hash_mode *spu2_mode)
201 *spu2_mode = SPU2_HASH_MODE_XCBC_MAC;
204 *spu2_mode = SPU2_HASH_MODE_CMAC;
207 *spu2_mode = SPU2_HASH_MODE_HMAC;
210 *spu2_mode = SPU2_HASH_MODE_CCM;
213 *spu2_mode = SPU2_HASH_MODE_GCM;
222 * spu2_hash_xlate() - Convert a hash {alg/mode/type} triple to a SPU2 hash type
224 * @hash_alg: [in] hash algorithm value from software enumeration
225 * @hash_mode: [in] hash mode value from software enumeration
226 * @hash_type: [in] hash type value from software enumeration
227 * @ciph_type: [in] cipher type value from software enumeration
228 * @spu2_type: [out] hash type value used by SPU2 hardware
229 * @spu2_mode: [out] hash mode value used by SPU2 hardware
231 * Return: 0 if successful
234 spu2_hash_xlate(enum hash_alg hash_alg, enum hash_mode hash_mode,
235 enum hash_type hash_type, enum spu_cipher_type ciph_type,
236 enum spu2_hash_type *spu2_type, enum spu2_hash_mode *spu2_mode)
240 err = spu2_hash_mode_xlate(hash_mode, spu2_mode);
242 flow_log("Invalid hash mode %d\n", hash_mode);
248 *spu2_type = SPU2_HASH_TYPE_NONE;
251 *spu2_type = SPU2_HASH_TYPE_MD5;
254 *spu2_type = SPU2_HASH_TYPE_SHA1;
256 case HASH_ALG_SHA224:
257 *spu2_type = SPU2_HASH_TYPE_SHA224;
259 case HASH_ALG_SHA256:
260 *spu2_type = SPU2_HASH_TYPE_SHA256;
262 case HASH_ALG_SHA384:
263 *spu2_type = SPU2_HASH_TYPE_SHA384;
265 case HASH_ALG_SHA512:
266 *spu2_type = SPU2_HASH_TYPE_SHA512;
270 case CIPHER_TYPE_AES128:
271 *spu2_type = SPU2_HASH_TYPE_AES128;
273 case CIPHER_TYPE_AES192:
274 *spu2_type = SPU2_HASH_TYPE_AES192;
276 case CIPHER_TYPE_AES256:
277 *spu2_type = SPU2_HASH_TYPE_AES256;
283 case HASH_ALG_SHA3_224:
284 *spu2_type = SPU2_HASH_TYPE_SHA3_224;
286 case HASH_ALG_SHA3_256:
287 *spu2_type = SPU2_HASH_TYPE_SHA3_256;
289 case HASH_ALG_SHA3_384:
290 *spu2_type = SPU2_HASH_TYPE_SHA3_384;
292 case HASH_ALG_SHA3_512:
293 *spu2_type = SPU2_HASH_TYPE_SHA3_512;
302 flow_log("Invalid hash alg %d or type %d\n",
303 hash_alg, hash_type);
307 /* Dump FMD ctrl0. The ctrl0 input is in host byte order */
308 static void spu2_dump_fmd_ctrl0(u64 ctrl0)
310 enum spu2_cipher_type ciph_type;
311 enum spu2_cipher_mode ciph_mode;
312 enum spu2_hash_type hash_type;
313 enum spu2_hash_mode hash_mode;
315 char *ciph_mode_name;
317 char *hash_mode_name;
321 packet_log(" FMD CTRL0 %#16llx\n", ctrl0);
322 if (ctrl0 & SPU2_CIPH_ENCRYPT_EN)
323 packet_log(" encrypt\n");
325 packet_log(" decrypt\n");
327 ciph_type = (ctrl0 & SPU2_CIPH_TYPE) >> SPU2_CIPH_TYPE_SHIFT;
328 ciph_name = spu2_ciph_type_name(ciph_type);
329 packet_log(" Cipher type: %s\n", ciph_name);
331 if (ciph_type != SPU2_CIPHER_TYPE_NONE) {
332 ciph_mode = (ctrl0 & SPU2_CIPH_MODE) >> SPU2_CIPH_MODE_SHIFT;
333 ciph_mode_name = spu2_ciph_mode_name(ciph_mode);
334 packet_log(" Cipher mode: %s\n", ciph_mode_name);
337 cfb = (ctrl0 & SPU2_CFB_MASK) >> SPU2_CFB_MASK_SHIFT;
338 packet_log(" CFB %#x\n", cfb);
340 proto = (ctrl0 & SPU2_PROTO_SEL) >> SPU2_PROTO_SEL_SHIFT;
341 packet_log(" protocol %#x\n", proto);
343 if (ctrl0 & SPU2_HASH_FIRST)
344 packet_log(" hash first\n");
346 packet_log(" cipher first\n");
348 if (ctrl0 & SPU2_CHK_TAG)
349 packet_log(" check tag\n");
351 hash_type = (ctrl0 & SPU2_HASH_TYPE) >> SPU2_HASH_TYPE_SHIFT;
352 hash_name = spu2_hash_type_name(hash_type);
353 packet_log(" Hash type: %s\n", hash_name);
355 if (hash_type != SPU2_HASH_TYPE_NONE) {
356 hash_mode = (ctrl0 & SPU2_HASH_MODE) >> SPU2_HASH_MODE_SHIFT;
357 hash_mode_name = spu2_hash_mode_name(hash_mode);
358 packet_log(" Hash mode: %s\n", hash_mode_name);
361 if (ctrl0 & SPU2_CIPH_PAD_EN) {
362 packet_log(" Cipher pad: %#2llx\n",
363 (ctrl0 & SPU2_CIPH_PAD) >> SPU2_CIPH_PAD_SHIFT);
367 /* Dump FMD ctrl1. The ctrl1 input is in host byte order */
368 static void spu2_dump_fmd_ctrl1(u64 ctrl1)
378 packet_log(" FMD CTRL1 %#16llx\n", ctrl1);
379 if (ctrl1 & SPU2_TAG_LOC)
380 packet_log(" Tag after payload\n");
382 packet_log(" Msg includes ");
383 if (ctrl1 & SPU2_HAS_FR_DATA)
385 if (ctrl1 & SPU2_HAS_AAD1)
387 if (ctrl1 & SPU2_HAS_NAAD)
389 if (ctrl1 & SPU2_HAS_AAD2)
391 if (ctrl1 & SPU2_HAS_ESN)
395 hash_key_len = (ctrl1 & SPU2_HASH_KEY_LEN) >> SPU2_HASH_KEY_LEN_SHIFT;
396 packet_log(" Hash key len %u\n", hash_key_len);
398 ciph_key_len = (ctrl1 & SPU2_CIPH_KEY_LEN) >> SPU2_CIPH_KEY_LEN_SHIFT;
399 packet_log(" Cipher key len %u\n", ciph_key_len);
401 if (ctrl1 & SPU2_GENIV)
402 packet_log(" Generate IV\n");
404 if (ctrl1 & SPU2_HASH_IV)
405 packet_log(" IV included in hash\n");
407 if (ctrl1 & SPU2_RET_IV)
408 packet_log(" Return IV in output before payload\n");
410 ret_iv_len = (ctrl1 & SPU2_RET_IV_LEN) >> SPU2_RET_IV_LEN_SHIFT;
411 packet_log(" Length of returned IV %u bytes\n",
412 ret_iv_len ? ret_iv_len : 16);
414 iv_offset = (ctrl1 & SPU2_IV_OFFSET) >> SPU2_IV_OFFSET_SHIFT;
415 packet_log(" IV offset %u\n", iv_offset);
417 iv_len = (ctrl1 & SPU2_IV_LEN) >> SPU2_IV_LEN_SHIFT;
418 packet_log(" Input IV len %u bytes\n", iv_len);
420 hash_tag_len = (ctrl1 & SPU2_HASH_TAG_LEN) >> SPU2_HASH_TAG_LEN_SHIFT;
421 packet_log(" Hash tag length %u bytes\n", hash_tag_len);
423 packet_log(" Return ");
424 ret_md = (ctrl1 & SPU2_RETURN_MD) >> SPU2_RETURN_MD_SHIFT;
427 if (ret_md == SPU2_RET_FMD_OMD)
429 else if (ret_md == SPU2_RET_FMD_OMD_IV)
430 packet_log("OMD IV ");
431 if (ctrl1 & SPU2_RETURN_FD)
433 if (ctrl1 & SPU2_RETURN_AAD1)
435 if (ctrl1 & SPU2_RETURN_NAAD)
437 if (ctrl1 & SPU2_RETURN_AAD2)
439 if (ctrl1 & SPU2_RETURN_PAY)
440 packet_log("Payload");
444 /* Dump FMD ctrl2. The ctrl2 input is in host byte order */
445 static void spu2_dump_fmd_ctrl2(u64 ctrl2)
447 packet_log(" FMD CTRL2 %#16llx\n", ctrl2);
449 packet_log(" AAD1 offset %llu length %llu bytes\n",
450 ctrl2 & SPU2_AAD1_OFFSET,
451 (ctrl2 & SPU2_AAD1_LEN) >> SPU2_AAD1_LEN_SHIFT);
452 packet_log(" AAD2 offset %llu\n",
453 (ctrl2 & SPU2_AAD2_OFFSET) >> SPU2_AAD2_OFFSET_SHIFT);
454 packet_log(" Payload offset %llu\n",
455 (ctrl2 & SPU2_PL_OFFSET) >> SPU2_PL_OFFSET_SHIFT);
458 /* Dump FMD ctrl3. The ctrl3 input is in host byte order */
459 static void spu2_dump_fmd_ctrl3(u64 ctrl3)
461 packet_log(" FMD CTRL3 %#16llx\n", ctrl3);
463 packet_log(" Payload length %llu bytes\n", ctrl3 & SPU2_PL_LEN);
464 packet_log(" TLS length %llu bytes\n",
465 (ctrl3 & SPU2_TLS_LEN) >> SPU2_TLS_LEN_SHIFT);
468 static void spu2_dump_fmd(struct SPU2_FMD *fmd)
470 spu2_dump_fmd_ctrl0(le64_to_cpu(fmd->ctrl0));
471 spu2_dump_fmd_ctrl1(le64_to_cpu(fmd->ctrl1));
472 spu2_dump_fmd_ctrl2(le64_to_cpu(fmd->ctrl2));
473 spu2_dump_fmd_ctrl3(le64_to_cpu(fmd->ctrl3));
476 static void spu2_dump_omd(u8 *omd, u16 hash_key_len, u16 ciph_key_len,
477 u16 hash_iv_len, u16 ciph_iv_len)
481 packet_log(" OMD:\n");
484 packet_log(" Hash Key Length %u bytes\n", hash_key_len);
485 packet_dump(" KEY: ", ptr, hash_key_len);
490 packet_log(" Cipher Key Length %u bytes\n", ciph_key_len);
491 packet_dump(" KEY: ", ptr, ciph_key_len);
496 packet_log(" Hash IV Length %u bytes\n", hash_iv_len);
497 packet_dump(" hash IV: ", ptr, hash_iv_len);
502 packet_log(" Cipher IV Length %u bytes\n", ciph_iv_len);
503 packet_dump(" cipher IV: ", ptr, ciph_iv_len);
507 /* Dump a SPU2 header for debug */
508 void spu2_dump_msg_hdr(u8 *buf, unsigned int buf_len)
510 struct SPU2_FMD *fmd = (struct SPU2_FMD *)buf;
520 packet_log("SPU2 message header %p len: %u\n", buf, buf_len);
523 omd = (u8 *)(fmd + 1);
525 ctrl1 = le64_to_cpu(fmd->ctrl1);
526 hash_key_len = (ctrl1 & SPU2_HASH_KEY_LEN) >> SPU2_HASH_KEY_LEN_SHIFT;
527 ciph_key_len = (ctrl1 & SPU2_CIPH_KEY_LEN) >> SPU2_CIPH_KEY_LEN_SHIFT;
529 ciph_iv_len = (ctrl1 & SPU2_IV_LEN) >> SPU2_IV_LEN_SHIFT;
530 spu2_dump_omd(omd, hash_key_len, ciph_key_len, hash_iv_len,
533 /* Double check sanity */
534 omd_len = hash_key_len + ciph_key_len + hash_iv_len + ciph_iv_len;
535 if (FMD_SIZE + omd_len != buf_len) {
537 (" Packet parsed incorrectly. buf_len %u, sum of MD %zu\n",
538 buf_len, FMD_SIZE + omd_len);
544 * spu2_fmd_init() - At setkey time, initialize the fixed meta data for
545 * subsequent ablkcipher requests for this context.
546 * @spu2_cipher_type: Cipher algorithm
547 * @spu2_mode: Cipher mode
548 * @cipher_key_len: Length of cipher key, in bytes
549 * @cipher_iv_len: Length of cipher initialization vector, in bytes
551 * Return: 0 (success)
553 static int spu2_fmd_init(struct SPU2_FMD *fmd,
554 enum spu2_cipher_type spu2_type,
555 enum spu2_cipher_mode spu2_mode,
556 u32 cipher_key_len, u32 cipher_iv_len)
567 ctrl0 = (spu2_type << SPU2_CIPH_TYPE_SHIFT) |
568 (spu2_mode << SPU2_CIPH_MODE_SHIFT);
570 ctrl1 = (cipher_key_len << SPU2_CIPH_KEY_LEN_SHIFT) |
571 ((u64)cipher_iv_len << SPU2_IV_LEN_SHIFT) |
572 ((u64)SPU2_RET_FMD_ONLY << SPU2_RETURN_MD_SHIFT) | SPU2_RETURN_PAY;
575 * AAD1 offset is from start of FD. FD length is always 0 for this
576 * driver. So AAD1_offset is always 0.
579 aad2_offset = aad1_offset;
581 ctrl2 = aad1_offset |
582 (aad1_len << SPU2_AAD1_LEN_SHIFT) |
583 (aad2_offset << SPU2_AAD2_OFFSET_SHIFT) |
584 (payload_offset << SPU2_PL_OFFSET_SHIFT);
588 fmd->ctrl0 = cpu_to_le64(ctrl0);
589 fmd->ctrl1 = cpu_to_le64(ctrl1);
590 fmd->ctrl2 = cpu_to_le64(ctrl2);
591 fmd->ctrl3 = cpu_to_le64(ctrl3);
597 * spu2_fmd_ctrl0_write() - Write ctrl0 field in fixed metadata (FMD) field of
598 * SPU request packet.
599 * @fmd: Start of FMD field to be written
600 * @is_inbound: true if decrypting. false if encrypting.
601 * @authFirst: true if alg authenticates before encrypting
602 * @protocol: protocol selector
603 * @cipher_type: cipher algorithm
604 * @cipher_mode: cipher mode
605 * @auth_type: authentication type
606 * @auth_mode: authentication mode
608 static void spu2_fmd_ctrl0_write(struct SPU2_FMD *fmd,
609 bool is_inbound, bool auth_first,
610 enum spu2_proto_sel protocol,
611 enum spu2_cipher_type cipher_type,
612 enum spu2_cipher_mode cipher_mode,
613 enum spu2_hash_type auth_type,
614 enum spu2_hash_mode auth_mode)
618 if ((cipher_type != SPU2_CIPHER_TYPE_NONE) && !is_inbound)
619 ctrl0 |= SPU2_CIPH_ENCRYPT_EN;
621 ctrl0 |= ((u64)cipher_type << SPU2_CIPH_TYPE_SHIFT) |
622 ((u64)cipher_mode << SPU2_CIPH_MODE_SHIFT);
625 ctrl0 |= (u64)protocol << SPU2_PROTO_SEL_SHIFT;
628 ctrl0 |= SPU2_HASH_FIRST;
630 if (is_inbound && (auth_type != SPU2_HASH_TYPE_NONE))
631 ctrl0 |= SPU2_CHK_TAG;
633 ctrl0 |= (((u64)auth_type << SPU2_HASH_TYPE_SHIFT) |
634 ((u64)auth_mode << SPU2_HASH_MODE_SHIFT));
636 fmd->ctrl0 = cpu_to_le64(ctrl0);
640 * spu2_fmd_ctrl1_write() - Write ctrl1 field in fixed metadata (FMD) field of
641 * SPU request packet.
642 * @fmd: Start of FMD field to be written
643 * @assoc_size: Length of additional associated data, in bytes
644 * @auth_key_len: Length of authentication key, in bytes
645 * @cipher_key_len: Length of cipher key, in bytes
646 * @gen_iv: If true, hw generates IV and returns in response
647 * @hash_iv: IV participates in hash. Used for IPSEC and TLS.
648 * @return_iv: Return IV in output packet before payload
649 * @ret_iv_len: Length of IV returned from SPU, in bytes
650 * @ret_iv_offset: Offset into full IV of start of returned IV
651 * @cipher_iv_len: Length of input cipher IV, in bytes
652 * @digest_size: Length of digest (aka, hash tag or ICV), in bytes
653 * @return_payload: Return payload in SPU response
654 * @return_md : return metadata in SPU response
656 * Packet can have AAD2 w/o AAD1. For algorithms currently supported,
657 * associated data goes in AAD2.
659 static void spu2_fmd_ctrl1_write(struct SPU2_FMD *fmd, bool is_inbound,
661 u64 auth_key_len, u64 cipher_key_len,
662 bool gen_iv, bool hash_iv, bool return_iv,
663 u64 ret_iv_len, u64 ret_iv_offset,
664 u64 cipher_iv_len, u64 digest_size,
665 bool return_payload, bool return_md)
669 if (is_inbound && digest_size)
670 ctrl1 |= SPU2_TAG_LOC;
673 ctrl1 |= SPU2_HAS_AAD2;
674 ctrl1 |= SPU2_RETURN_AAD2; /* need aad2 for gcm aes esp */
678 ctrl1 |= ((auth_key_len << SPU2_HASH_KEY_LEN_SHIFT) &
682 ctrl1 |= ((cipher_key_len << SPU2_CIPH_KEY_LEN_SHIFT) &
689 ctrl1 |= SPU2_HASH_IV;
692 ctrl1 |= SPU2_RET_IV;
693 ctrl1 |= ret_iv_len << SPU2_RET_IV_LEN_SHIFT;
694 ctrl1 |= ret_iv_offset << SPU2_IV_OFFSET_SHIFT;
697 ctrl1 |= ((cipher_iv_len << SPU2_IV_LEN_SHIFT) & SPU2_IV_LEN);
700 ctrl1 |= ((digest_size << SPU2_HASH_TAG_LEN_SHIFT) &
703 /* Let's ask for the output pkt to include FMD, but don't need to
704 * get keys and IVs back in OMD.
707 ctrl1 |= ((u64)SPU2_RET_FMD_ONLY << SPU2_RETURN_MD_SHIFT);
709 ctrl1 |= ((u64)SPU2_RET_NO_MD << SPU2_RETURN_MD_SHIFT);
711 /* Crypto API does not get assoc data back. So no need for AAD2. */
714 ctrl1 |= SPU2_RETURN_PAY;
716 fmd->ctrl1 = cpu_to_le64(ctrl1);
720 * spu2_fmd_ctrl2_write() - Set the ctrl2 field in the fixed metadata field of
722 * @fmd: Start of FMD field to be written
723 * @cipher_offset: Number of bytes from Start of Packet (end of FD field) where
724 * data to be encrypted or decrypted begins
725 * @auth_key_len: Length of authentication key, in bytes
726 * @auth_iv_len: Length of authentication initialization vector, in bytes
727 * @cipher_key_len: Length of cipher key, in bytes
728 * @cipher_iv_len: Length of cipher IV, in bytes
730 static void spu2_fmd_ctrl2_write(struct SPU2_FMD *fmd, u64 cipher_offset,
731 u64 auth_key_len, u64 auth_iv_len,
732 u64 cipher_key_len, u64 cipher_iv_len)
740 /* AAD1 offset is from start of FD. FD length always 0. */
743 aad2_offset = aad1_offset;
744 payload_offset = cipher_offset;
745 ctrl2 = aad1_offset |
746 (aad1_len << SPU2_AAD1_LEN_SHIFT) |
747 (aad2_offset << SPU2_AAD2_OFFSET_SHIFT) |
748 (payload_offset << SPU2_PL_OFFSET_SHIFT);
750 fmd->ctrl2 = cpu_to_le64(ctrl2);
754 * spu2_fmd_ctrl3_write() - Set the ctrl3 field in FMD
755 * @fmd: Fixed meta data. First field in SPU2 msg header.
756 * @payload_len: Length of payload, in bytes
758 static void spu2_fmd_ctrl3_write(struct SPU2_FMD *fmd, u64 payload_len)
762 ctrl3 = payload_len & SPU2_PL_LEN;
764 fmd->ctrl3 = cpu_to_le64(ctrl3);
768 * spu2_ctx_max_payload() - Determine the maximum length of the payload for a
769 * SPU message for a given cipher and hash alg context.
770 * @cipher_alg: The cipher algorithm
771 * @cipher_mode: The cipher mode
772 * @blocksize: The size of a block of data for this algo
774 * For SPU2, the hardware generally ignores the PayloadLen field in ctrl3 of
775 * FMD and just keeps computing until it receives a DMA descriptor with the EOF
776 * flag set. So we consider the max payload to be infinite. AES CCM is an
779 * Return: Max payload length in bytes
781 u32 spu2_ctx_max_payload(enum spu_cipher_alg cipher_alg,
782 enum spu_cipher_mode cipher_mode,
783 unsigned int blocksize)
785 if ((cipher_alg == CIPHER_ALG_AES) &&
786 (cipher_mode == CIPHER_MODE_CCM)) {
787 u32 excess = SPU2_MAX_PAYLOAD % blocksize;
789 return SPU2_MAX_PAYLOAD - excess;
791 return SPU_MAX_PAYLOAD_INF;
796 * spu_payload_length() - Given a SPU2 message header, extract the payload
798 * @spu_hdr: Start of SPU message header (FMD)
800 * Return: payload length, in bytes
802 u32 spu2_payload_length(u8 *spu_hdr)
804 struct SPU2_FMD *fmd = (struct SPU2_FMD *)spu_hdr;
808 ctrl3 = le64_to_cpu(fmd->ctrl3);
809 pl_len = ctrl3 & SPU2_PL_LEN;
815 * spu_response_hdr_len() - Determine the expected length of a SPU response
817 * @auth_key_len: Length of authentication key, in bytes
818 * @enc_key_len: Length of encryption key, in bytes
820 * For SPU2, includes just FMD. OMD is never requested.
822 * Return: Length of FMD, in bytes
824 u16 spu2_response_hdr_len(u16 auth_key_len, u16 enc_key_len, bool is_hash)
830 * spu_hash_pad_len() - Calculate the length of hash padding required to extend
831 * data to a full block size.
832 * @hash_alg: hash algorithm
833 * @hash_mode: hash mode
834 * @chunksize: length of data, in bytes
835 * @hash_block_size: size of a hash block, in bytes
837 * SPU2 hardware does all hash padding
839 * Return: length of hash pad in bytes
841 u16 spu2_hash_pad_len(enum hash_alg hash_alg, enum hash_mode hash_mode,
842 u32 chunksize, u16 hash_block_size)
848 * spu2_gcm_ccm_padlen() - Determine the length of GCM/CCM padding for either
849 * the AAD field or the data.
851 * Return: 0. Unlike SPU-M, SPU2 hardware does any GCM/CCM padding required.
853 u32 spu2_gcm_ccm_pad_len(enum spu_cipher_mode cipher_mode,
854 unsigned int data_size)
860 * spu_assoc_resp_len() - Determine the size of the AAD2 buffer needed to catch
861 * associated data in a SPU2 output packet.
862 * @cipher_mode: cipher mode
863 * @assoc_len: length of additional associated data, in bytes
864 * @iv_len: length of initialization vector, in bytes
865 * @is_encrypt: true if encrypting. false if decrypt.
867 * Return: Length of buffer to catch associated data in response
869 u32 spu2_assoc_resp_len(enum spu_cipher_mode cipher_mode,
870 unsigned int assoc_len, unsigned int iv_len,
873 u32 resp_len = assoc_len;
876 /* gcm aes esp has to write 8-byte IV in response */
882 * spu_aead_ivlen() - Calculate the length of the AEAD IV to be included
883 * in a SPU request after the AAD and before the payload.
884 * @cipher_mode: cipher mode
885 * @iv_ctr_len: initialization vector length in bytes
887 * For SPU2, AEAD IV is included in OMD and does not need to be repeated
888 * prior to the payload.
890 * Return: Length of AEAD IV in bytes
892 u8 spu2_aead_ivlen(enum spu_cipher_mode cipher_mode, u16 iv_len)
898 * spu2_hash_type() - Determine the type of hash operation.
899 * @src_sent: The number of bytes in the current request that have already
900 * been sent to the SPU to be hashed.
902 * SPU2 always does a FULL hash operation
904 enum hash_type spu2_hash_type(u32 src_sent)
906 return HASH_TYPE_FULL;
910 * spu2_digest_size() - Determine the size of a hash digest to expect the SPU to
912 * alg_digest_size: Number of bytes in the final digest for the given algo
913 * alg: The hash algorithm
914 * htype: Type of hash operation (init, update, full, etc)
917 u32 spu2_digest_size(u32 alg_digest_size, enum hash_alg alg,
918 enum hash_type htype)
920 return alg_digest_size;
924 * spu_create_request() - Build a SPU2 request message header, includint FMD and
926 * @spu_hdr: Start of buffer where SPU request header is to be written
927 * @req_opts: SPU request message options
928 * @cipher_parms: Parameters related to cipher algorithm
929 * @hash_parms: Parameters related to hash algorithm
930 * @aead_parms: Parameters related to AEAD operation
931 * @data_size: Length of data to be encrypted or authenticated. If AEAD, does
932 * not include length of AAD.
934 * Construct the message starting at spu_hdr. Caller should allocate this buffer
935 * in DMA-able memory at least SPU_HEADER_ALLOC_LEN bytes long.
937 * Return: the length of the SPU header in bytes. 0 if an error occurs.
939 u32 spu2_create_request(u8 *spu_hdr,
940 struct spu_request_opts *req_opts,
941 struct spu_cipher_parms *cipher_parms,
942 struct spu_hash_parms *hash_parms,
943 struct spu_aead_parms *aead_parms,
944 unsigned int data_size)
946 struct SPU2_FMD *fmd;
948 unsigned int buf_len;
950 enum spu2_cipher_type spu2_ciph_type = SPU2_CIPHER_TYPE_NONE;
951 enum spu2_cipher_mode spu2_ciph_mode;
952 enum spu2_hash_type spu2_auth_type = SPU2_HASH_TYPE_NONE;
953 enum spu2_hash_mode spu2_auth_mode;
954 bool return_md = true;
955 enum spu2_proto_sel proto = SPU2_PROTO_RESV;
957 /* size of the payload */
958 unsigned int payload_len =
959 hash_parms->prebuf_len + data_size + hash_parms->pad_len -
960 ((req_opts->is_aead && req_opts->is_inbound) ?
961 hash_parms->digestsize : 0);
963 /* offset of prebuf or data from start of AAD2 */
964 unsigned int cipher_offset = aead_parms->assoc_size +
965 aead_parms->aad_pad_len + aead_parms->iv_len;
968 /* total size of the data following OMD (without STAT word padding) */
969 unsigned int real_db_size = spu_real_db_size(aead_parms->assoc_size,
971 hash_parms->prebuf_len,
973 aead_parms->aad_pad_len,
974 aead_parms->data_pad_len,
975 hash_parms->pad_len);
977 unsigned int assoc_size = aead_parms->assoc_size;
979 if (req_opts->is_aead &&
980 (cipher_parms->alg == CIPHER_ALG_AES) &&
981 (cipher_parms->mode == CIPHER_MODE_GCM))
983 * On SPU 2, aes gcm cipher first on encrypt, auth first on
986 req_opts->auth_first = req_opts->is_inbound;
988 /* and do opposite for ccm (auth 1st on encrypt) */
989 if (req_opts->is_aead &&
990 (cipher_parms->alg == CIPHER_ALG_AES) &&
991 (cipher_parms->mode == CIPHER_MODE_CCM))
992 req_opts->auth_first = !req_opts->is_inbound;
994 flow_log("%s()\n", __func__);
995 flow_log(" in:%u authFirst:%u\n",
996 req_opts->is_inbound, req_opts->auth_first);
997 flow_log(" cipher alg:%u mode:%u type %u\n", cipher_parms->alg,
998 cipher_parms->mode, cipher_parms->type);
999 flow_log(" is_esp: %s\n", req_opts->is_esp ? "yes" : "no");
1000 flow_log(" key: %d\n", cipher_parms->key_len);
1001 flow_dump(" key: ", cipher_parms->key_buf, cipher_parms->key_len);
1002 flow_log(" iv: %d\n", cipher_parms->iv_len);
1003 flow_dump(" iv: ", cipher_parms->iv_buf, cipher_parms->iv_len);
1004 flow_log(" auth alg:%u mode:%u type %u\n",
1005 hash_parms->alg, hash_parms->mode, hash_parms->type);
1006 flow_log(" digestsize: %u\n", hash_parms->digestsize);
1007 flow_log(" authkey: %d\n", hash_parms->key_len);
1008 flow_dump(" authkey: ", hash_parms->key_buf, hash_parms->key_len);
1009 flow_log(" assoc_size:%u\n", assoc_size);
1010 flow_log(" prebuf_len:%u\n", hash_parms->prebuf_len);
1011 flow_log(" data_size:%u\n", data_size);
1012 flow_log(" hash_pad_len:%u\n", hash_parms->pad_len);
1013 flow_log(" real_db_size:%u\n", real_db_size);
1014 flow_log(" cipher_offset:%u payload_len:%u\n",
1015 cipher_offset, payload_len);
1016 flow_log(" aead_iv: %u\n", aead_parms->iv_len);
1018 /* Convert to spu2 values for cipher alg, hash alg */
1019 err = spu2_cipher_xlate(cipher_parms->alg, cipher_parms->mode,
1021 &spu2_ciph_type, &spu2_ciph_mode);
1023 /* If we are doing GCM hashing only - either via rfc4543 transform
1024 * or because we happen to do GCM with AAD only and no payload - we
1025 * need to configure hardware to use hash key rather than cipher key
1026 * and put data into payload. This is because unlike SPU-M, running
1027 * GCM cipher with 0 size payload is not permitted.
1029 if ((req_opts->is_rfc4543) ||
1030 ((spu2_ciph_mode == SPU2_CIPHER_MODE_GCM) &&
1031 (payload_len == 0))) {
1032 /* Use hashing (only) and set up hash key */
1033 spu2_ciph_type = SPU2_CIPHER_TYPE_NONE;
1034 hash_parms->key_len = cipher_parms->key_len;
1035 memcpy(hash_parms->key_buf, cipher_parms->key_buf,
1036 cipher_parms->key_len);
1037 cipher_parms->key_len = 0;
1039 if (req_opts->is_rfc4543)
1040 payload_len += assoc_size;
1042 payload_len = assoc_size;
1050 flow_log("spu2 cipher type %s, cipher mode %s\n",
1051 spu2_ciph_type_name(spu2_ciph_type),
1052 spu2_ciph_mode_name(spu2_ciph_mode));
1054 err = spu2_hash_xlate(hash_parms->alg, hash_parms->mode,
1057 &spu2_auth_type, &spu2_auth_mode);
1061 flow_log("spu2 hash type %s, hash mode %s\n",
1062 spu2_hash_type_name(spu2_auth_type),
1063 spu2_hash_mode_name(spu2_auth_mode));
1065 fmd = (struct SPU2_FMD *)spu_hdr;
1067 spu2_fmd_ctrl0_write(fmd, req_opts->is_inbound, req_opts->auth_first,
1068 proto, spu2_ciph_type, spu2_ciph_mode,
1069 spu2_auth_type, spu2_auth_mode);
1071 spu2_fmd_ctrl1_write(fmd, req_opts->is_inbound, assoc_size,
1072 hash_parms->key_len, cipher_parms->key_len,
1074 aead_parms->return_iv, aead_parms->ret_iv_len,
1075 aead_parms->ret_iv_off,
1076 cipher_parms->iv_len, hash_parms->digestsize,
1077 !req_opts->bd_suppress, return_md);
1079 spu2_fmd_ctrl2_write(fmd, cipher_offset, hash_parms->key_len, 0,
1080 cipher_parms->key_len, cipher_parms->iv_len);
1082 spu2_fmd_ctrl3_write(fmd, payload_len);
1084 ptr = (u8 *)(fmd + 1);
1085 buf_len = sizeof(struct SPU2_FMD);
1088 if (hash_parms->key_len) {
1089 memcpy(ptr, hash_parms->key_buf, hash_parms->key_len);
1090 ptr += hash_parms->key_len;
1091 buf_len += hash_parms->key_len;
1093 if (cipher_parms->key_len) {
1094 memcpy(ptr, cipher_parms->key_buf, cipher_parms->key_len);
1095 ptr += cipher_parms->key_len;
1096 buf_len += cipher_parms->key_len;
1098 if (cipher_parms->iv_len) {
1099 memcpy(ptr, cipher_parms->iv_buf, cipher_parms->iv_len);
1100 ptr += cipher_parms->iv_len;
1101 buf_len += cipher_parms->iv_len;
1104 packet_dump(" SPU request header: ", spu_hdr, buf_len);
1110 * spu_cipher_req_init() - Build an ablkcipher SPU2 request message header,
1111 * including FMD and OMD.
1112 * @spu_hdr: Location of start of SPU request (FMD field)
1113 * @cipher_parms: Parameters describing cipher request
1115 * Called at setkey time to initialize a msg header that can be reused for all
1116 * subsequent ablkcipher requests. Construct the message starting at spu_hdr.
1117 * Caller should allocate this buffer in DMA-able memory at least
1118 * SPU_HEADER_ALLOC_LEN bytes long.
1120 * Return: the total length of the SPU header (FMD and OMD) in bytes. 0 if an
1123 u16 spu2_cipher_req_init(u8 *spu_hdr, struct spu_cipher_parms *cipher_parms)
1125 struct SPU2_FMD *fmd;
1127 enum spu2_cipher_type spu2_type = SPU2_CIPHER_TYPE_NONE;
1128 enum spu2_cipher_mode spu2_mode;
1131 flow_log("%s()\n", __func__);
1132 flow_log(" cipher alg:%u mode:%u type %u\n", cipher_parms->alg,
1133 cipher_parms->mode, cipher_parms->type);
1134 flow_log(" cipher_iv_len: %u\n", cipher_parms->iv_len);
1135 flow_log(" key: %d\n", cipher_parms->key_len);
1136 flow_dump(" key: ", cipher_parms->key_buf, cipher_parms->key_len);
1138 /* Convert to spu2 values */
1139 err = spu2_cipher_xlate(cipher_parms->alg, cipher_parms->mode,
1140 cipher_parms->type, &spu2_type, &spu2_mode);
1144 flow_log("spu2 cipher type %s, cipher mode %s\n",
1145 spu2_ciph_type_name(spu2_type),
1146 spu2_ciph_mode_name(spu2_mode));
1148 /* Construct the FMD header */
1149 fmd = (struct SPU2_FMD *)spu_hdr;
1150 err = spu2_fmd_init(fmd, spu2_type, spu2_mode, cipher_parms->key_len,
1151 cipher_parms->iv_len);
1155 /* Write cipher key to OMD */
1156 omd = (u8 *)(fmd + 1);
1157 if (cipher_parms->key_buf && cipher_parms->key_len)
1158 memcpy(omd, cipher_parms->key_buf, cipher_parms->key_len);
1160 packet_dump(" SPU request header: ", spu_hdr,
1161 FMD_SIZE + cipher_parms->key_len + cipher_parms->iv_len);
1163 return FMD_SIZE + cipher_parms->key_len + cipher_parms->iv_len;
1167 * spu_cipher_req_finish() - Finish building a SPU request message header for a
1168 * block cipher request.
1169 * @spu_hdr: Start of the request message header (MH field)
1170 * @spu_req_hdr_len: Length in bytes of the SPU request header
1171 * @isInbound: 0 encrypt, 1 decrypt
1172 * @cipher_parms: Parameters describing cipher operation to be performed
1173 * @update_key: If true, rewrite the cipher key in SCTX
1174 * @data_size: Length of the data in the BD field
1176 * Assumes much of the header was already filled in at setkey() time in
1177 * spu_cipher_req_init().
1178 * spu_cipher_req_init() fills in the encryption key. For RC4, when submitting a
1179 * request for a non-first chunk, we use the 260-byte SUPDT field from the
1180 * previous response as the key. update_key is true for this case. Unused in all
1183 void spu2_cipher_req_finish(u8 *spu_hdr,
1184 u16 spu_req_hdr_len,
1185 unsigned int is_inbound,
1186 struct spu_cipher_parms *cipher_parms,
1188 unsigned int data_size)
1190 struct SPU2_FMD *fmd;
1191 u8 *omd; /* start of optional metadata */
1195 flow_log("%s()\n", __func__);
1196 flow_log(" in: %u\n", is_inbound);
1197 flow_log(" cipher alg: %u, cipher_type: %u\n", cipher_parms->alg,
1198 cipher_parms->type);
1200 flow_log(" cipher key len: %u\n", cipher_parms->key_len);
1201 flow_dump(" key: ", cipher_parms->key_buf,
1202 cipher_parms->key_len);
1204 flow_log(" iv len: %d\n", cipher_parms->iv_len);
1205 flow_dump(" iv: ", cipher_parms->iv_buf, cipher_parms->iv_len);
1206 flow_log(" data_size: %u\n", data_size);
1208 fmd = (struct SPU2_FMD *)spu_hdr;
1209 omd = (u8 *)(fmd + 1);
1212 * FMD ctrl0 was initialized at setkey time. update it to indicate
1213 * whether we are encrypting or decrypting.
1215 ctrl0 = le64_to_cpu(fmd->ctrl0);
1217 ctrl0 &= ~SPU2_CIPH_ENCRYPT_EN; /* decrypt */
1219 ctrl0 |= SPU2_CIPH_ENCRYPT_EN; /* encrypt */
1220 fmd->ctrl0 = cpu_to_le64(ctrl0);
1222 if (cipher_parms->alg && cipher_parms->iv_buf && cipher_parms->iv_len) {
1223 /* cipher iv provided so put it in here */
1224 memcpy(omd + cipher_parms->key_len, cipher_parms->iv_buf,
1225 cipher_parms->iv_len);
1228 ctrl3 = le64_to_cpu(fmd->ctrl3);
1229 data_size &= SPU2_PL_LEN;
1231 fmd->ctrl3 = cpu_to_le64(ctrl3);
1233 packet_dump(" SPU request header: ", spu_hdr, spu_req_hdr_len);
1237 * spu_request_pad() - Create pad bytes at the end of the data.
1238 * @pad_start: Start of buffer where pad bytes are to be written
1239 * @gcm_padding: Length of GCM padding, in bytes
1240 * @hash_pad_len: Number of bytes of padding extend data to full block
1241 * @auth_alg: Authentication algorithm
1242 * @auth_mode: Authentication mode
1243 * @total_sent: Length inserted at end of hash pad
1244 * @status_padding: Number of bytes of padding to align STATUS word
1246 * There may be three forms of pad:
1247 * 1. GCM pad - for GCM mode ciphers, pad to 16-byte alignment
1248 * 2. hash pad - pad to a block length, with 0x80 data terminator and
1250 * 3. STAT pad - to ensure the STAT field is 4-byte aligned
1252 void spu2_request_pad(u8 *pad_start, u32 gcm_padding, u32 hash_pad_len,
1253 enum hash_alg auth_alg, enum hash_mode auth_mode,
1254 unsigned int total_sent, u32 status_padding)
1256 u8 *ptr = pad_start;
1258 /* fix data alignent for GCM */
1259 if (gcm_padding > 0) {
1260 flow_log(" GCM: padding to 16 byte alignment: %u bytes\n",
1262 memset(ptr, 0, gcm_padding);
1266 if (hash_pad_len > 0) {
1267 /* clear the padding section */
1268 memset(ptr, 0, hash_pad_len);
1270 /* terminate the data */
1272 ptr += (hash_pad_len - sizeof(u64));
1274 /* add the size at the end as required per alg */
1275 if (auth_alg == HASH_ALG_MD5)
1276 *(u64 *)ptr = cpu_to_le64((u64)total_sent * 8);
1277 else /* SHA1, SHA2-224, SHA2-256 */
1278 *(u64 *)ptr = cpu_to_be64((u64)total_sent * 8);
1282 /* pad to a 4byte alignment for STAT */
1283 if (status_padding > 0) {
1284 flow_log(" STAT: padding to 4 byte alignment: %u bytes\n",
1287 memset(ptr, 0, status_padding);
1288 ptr += status_padding;
1293 * spu2_xts_tweak_in_payload() - Indicate that SPU2 does NOT place the XTS
1294 * tweak field in the packet payload (it uses IV instead)
1298 u8 spu2_xts_tweak_in_payload(void)
1304 * spu2_tx_status_len() - Return the length of the STATUS field in a SPU
1307 * Return: Length of STATUS field in bytes.
1309 u8 spu2_tx_status_len(void)
1311 return SPU2_TX_STATUS_LEN;
1315 * spu2_rx_status_len() - Return the length of the STATUS field in a SPU
1318 * Return: Length of STATUS field in bytes.
1320 u8 spu2_rx_status_len(void)
1322 return SPU2_RX_STATUS_LEN;
1326 * spu_status_process() - Process the status from a SPU response message.
1327 * @statp: start of STATUS word
1329 * Return: 0 - if status is good and response should be processed
1330 * !0 - status indicates an error and response is invalid
1332 int spu2_status_process(u8 *statp)
1334 /* SPU2 status is 2 bytes by default - SPU_RX_STATUS_LEN */
1335 u16 status = le16_to_cpu(*(__le16 *)statp);
1340 flow_log("rx status is %#x\n", status);
1341 if (status == SPU2_INVALID_ICV)
1342 return SPU_INVALID_ICV;
1348 * spu2_ccm_update_iv() - Update the IV as per the requirements for CCM mode.
1350 * @digestsize: Digest size of this request
1351 * @cipher_parms: (pointer to) cipher parmaeters, includes IV buf & IV len
1352 * @assoclen: Length of AAD data
1353 * @chunksize: length of input data to be sent in this req
1354 * @is_encrypt: true if this is an output/encrypt operation
1355 * @is_esp: true if this is an ESP / RFC4309 operation
1358 void spu2_ccm_update_iv(unsigned int digestsize,
1359 struct spu_cipher_parms *cipher_parms,
1360 unsigned int assoclen, unsigned int chunksize,
1361 bool is_encrypt, bool is_esp)
1363 int L; /* size of length field, in bytes */
1366 * In RFC4309 mode, L is fixed at 4 bytes; otherwise, IV from
1367 * testmgr contains (L-1) in bottom 3 bits of first byte,
1371 L = CCM_ESP_L_VALUE;
1373 L = ((cipher_parms->iv_buf[0] & CCM_B0_L_PRIME) >>
1374 CCM_B0_L_PRIME_SHIFT) + 1;
1376 /* SPU2 doesn't want these length bytes nor the first byte... */
1377 cipher_parms->iv_len -= (1 + L);
1378 memmove(cipher_parms->iv_buf, &cipher_parms->iv_buf[1],
1379 cipher_parms->iv_len);
1383 * spu2_wordalign_padlen() - SPU2 does not require padding.
1384 * @data_size: length of data field in bytes
1386 * Return: length of status field padding, in bytes (always 0 on SPU2)
1388 u32 spu2_wordalign_padlen(u32 data_size)