1 /* SPDX-License-Identifier: GPL-2.0 */ 2 /* 3 * sun8i-ce.h - hardware cryptographic offloader for 4 * Allwinner H3/A64/H5/H2+/H6 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/skcipher.h> 12 #include <linux/atomic.h> 13 #include <linux/debugfs.h> 14 #include <linux/crypto.h> 15 #include <linux/hw_random.h> 16 #include <crypto/internal/hash.h> 17 #include <crypto/md5.h> 18 #include <crypto/rng.h> 19 #include <crypto/sha1.h> 20 #include <crypto/sha2.h> 21 22 /* CE Registers */ 23 #define CE_TDQ 0x00 24 #define CE_CTR 0x04 25 #define CE_ICR 0x08 26 #define CE_ISR 0x0C 27 #define CE_TLR 0x10 28 #define CE_TSR 0x14 29 #define CE_ESR 0x18 30 #define CE_CSSGR 0x1C 31 #define CE_CDSGR 0x20 32 #define CE_CSAR 0x24 33 #define CE_CDAR 0x28 34 #define CE_TPR 0x2C 35 36 /* Used in struct ce_task */ 37 /* ce_task common */ 38 #define CE_ENCRYPTION 0 39 #define CE_DECRYPTION BIT(8) 40 41 #define CE_COMM_INT BIT(31) 42 43 /* ce_task symmetric */ 44 #define CE_AES_128BITS 0 45 #define CE_AES_192BITS 1 46 #define CE_AES_256BITS 2 47 48 #define CE_OP_ECB 0 49 #define CE_OP_CBC (1 << 8) 50 51 #define CE_ALG_AES 0 52 #define CE_ALG_DES 1 53 #define CE_ALG_3DES 2 54 #define CE_ALG_MD5 16 55 #define CE_ALG_SHA1 17 56 #define CE_ALG_SHA224 18 57 #define CE_ALG_SHA256 19 58 #define CE_ALG_SHA384 20 59 #define CE_ALG_SHA512 21 60 #define CE_ALG_TRNG 48 61 #define CE_ALG_PRNG 49 62 #define CE_ALG_TRNG_V2 0x1c 63 #define CE_ALG_PRNG_V2 0x1d 64 65 /* Used in ce_variant */ 66 #define CE_ID_NOTSUPP 0xFF 67 68 #define CE_ID_CIPHER_AES 0 69 #define CE_ID_CIPHER_DES 1 70 #define CE_ID_CIPHER_DES3 2 71 #define CE_ID_CIPHER_MAX 3 72 73 #define CE_ID_HASH_MD5 0 74 #define CE_ID_HASH_SHA1 1 75 #define CE_ID_HASH_SHA224 2 76 #define CE_ID_HASH_SHA256 3 77 #define CE_ID_HASH_SHA384 4 78 #define CE_ID_HASH_SHA512 5 79 #define CE_ID_HASH_MAX 6 80 81 #define CE_ID_OP_ECB 0 82 #define CE_ID_OP_CBC 1 83 #define CE_ID_OP_MAX 2 84 85 /* Used in CE registers */ 86 #define CE_ERR_ALGO_NOTSUP BIT(0) 87 #define CE_ERR_DATALEN BIT(1) 88 #define CE_ERR_KEYSRAM BIT(2) 89 #define CE_ERR_ADDR_INVALID BIT(5) 90 #define CE_ERR_KEYLADDER BIT(6) 91 92 #define ESR_H3 0 93 #define ESR_A64 1 94 #define ESR_R40 2 95 #define ESR_H5 3 96 #define ESR_H6 4 97 #define ESR_D1 5 98 99 #define PRNG_DATA_SIZE (160 / 8) 100 #define PRNG_SEED_SIZE DIV_ROUND_UP(175, 8) 101 #define PRNG_LD BIT(17) 102 103 #define CE_DIE_ID_SHIFT 16 104 #define CE_DIE_ID_MASK 0x07 105 106 #define MAX_SG 8 107 108 #define CE_MAX_CLOCKS 4 109 110 #define MAXFLOW 4 111 112 /* 113 * struct ce_clock - Describe clocks used by sun8i-ce 114 * @name: Name of clock needed by this variant 115 * @freq: Frequency to set for each clock 116 * @max_freq: Maximum frequency for each clock (generally given by datasheet) 117 */ 118 struct ce_clock { 119 const char *name; 120 unsigned long freq; 121 unsigned long max_freq; 122 }; 123 124 /* 125 * struct ce_variant - Describe CE capability for each variant hardware 126 * @alg_cipher: list of supported ciphers. for each CE_ID_ this will give the 127 * coresponding CE_ALG_XXX value 128 * @alg_hash: list of supported hashes. for each CE_ID_ this will give the 129 * corresponding CE_ALG_XXX value 130 * @op_mode: list of supported block modes 131 * @cipher_t_dlen_in_bytes: Does the request size for cipher is in 132 * bytes or words 133 * @hash_t_dlen_in_bytes: Does the request size for hash is in 134 * bits or words 135 * @prng_t_dlen_in_bytes: Does the request size for PRNG is in 136 * bytes or words 137 * @trng_t_dlen_in_bytes: Does the request size for TRNG is in 138 * bytes or words 139 * @ce_clks: list of clocks needed by this variant 140 * @esr: The type of error register 141 * @prng: The CE_ALG_XXX value for the PRNG 142 * @trng: The CE_ALG_XXX value for the TRNG 143 */ 144 struct ce_variant { 145 char alg_cipher[CE_ID_CIPHER_MAX]; 146 char alg_hash[CE_ID_HASH_MAX]; 147 u32 op_mode[CE_ID_OP_MAX]; 148 bool cipher_t_dlen_in_bytes; 149 bool hash_t_dlen_in_bits; 150 bool prng_t_dlen_in_bytes; 151 bool trng_t_dlen_in_bytes; 152 struct ce_clock ce_clks[CE_MAX_CLOCKS]; 153 int esr; 154 unsigned char prng; 155 unsigned char trng; 156 }; 157 158 struct sginfo { 159 __le32 addr; 160 __le32 len; 161 } __packed; 162 163 /* 164 * struct ce_task - CE Task descriptor 165 * The structure of this descriptor could be found in the datasheet 166 */ 167 struct ce_task { 168 __le32 t_id; 169 __le32 t_common_ctl; 170 __le32 t_sym_ctl; 171 __le32 t_asym_ctl; 172 __le32 t_key; 173 __le32 t_iv; 174 __le32 t_ctr; 175 __le32 t_dlen; 176 struct sginfo t_src[MAX_SG]; 177 struct sginfo t_dst[MAX_SG]; 178 __le32 next; 179 __le32 reserved[3]; 180 } __packed __aligned(8); 181 182 /* 183 * struct sun8i_ce_flow - Information used by each flow 184 * @engine: ptr to the crypto_engine for this flow 185 * @complete: completion for the current task on this flow 186 * @status: set to 1 by interrupt if task is done 187 * @t_phy: Physical address of task 188 * @tl: pointer to the current ce_task for this flow 189 * @backup_iv: buffer which contain the next IV to store 190 * @bounce_iv: buffer which contain the IV 191 * @stat_req: number of request done by this flow 192 */ 193 struct sun8i_ce_flow { 194 struct crypto_engine *engine; 195 struct completion complete; 196 int status; 197 dma_addr_t t_phy; 198 int timeout; 199 struct ce_task *tl; 200 void *backup_iv; 201 void *bounce_iv; 202 #ifdef CONFIG_CRYPTO_DEV_SUN8I_CE_DEBUG 203 unsigned long stat_req; 204 #endif 205 }; 206 207 /* 208 * struct sun8i_ce_dev - main container for all this driver information 209 * @base: base address of CE 210 * @ceclks: clocks used by CE 211 * @reset: pointer to reset controller 212 * @dev: the platform device 213 * @mlock: Control access to device registers 214 * @rnglock: Control access to the RNG (dedicated channel 3) 215 * @chanlist: array of all flow 216 * @flow: flow to use in next request 217 * @variant: pointer to variant specific data 218 * @dbgfs_dir: Debugfs dentry for statistic directory 219 * @dbgfs_stats: Debugfs dentry for statistic counters 220 */ 221 struct sun8i_ce_dev { 222 void __iomem *base; 223 struct clk *ceclks[CE_MAX_CLOCKS]; 224 struct reset_control *reset; 225 struct device *dev; 226 struct mutex mlock; 227 struct mutex rnglock; 228 struct sun8i_ce_flow *chanlist; 229 atomic_t flow; 230 const struct ce_variant *variant; 231 #ifdef CONFIG_CRYPTO_DEV_SUN8I_CE_DEBUG 232 struct dentry *dbgfs_dir; 233 struct dentry *dbgfs_stats; 234 #endif 235 #ifdef CONFIG_CRYPTO_DEV_SUN8I_CE_TRNG 236 struct hwrng trng; 237 #ifdef CONFIG_CRYPTO_DEV_SUN8I_CE_DEBUG 238 unsigned long hwrng_stat_req; 239 unsigned long hwrng_stat_bytes; 240 #endif 241 #endif 242 }; 243 244 /* 245 * struct sun8i_cipher_req_ctx - context for a skcipher request 246 * @op_dir: direction (encrypt vs decrypt) for this request 247 * @flow: the flow to use for this request 248 * @ivlen: size of bounce_iv 249 * @nr_sgs: The number of source SG (as given by dma_map_sg()) 250 * @nr_sgd: The number of destination SG (as given by dma_map_sg()) 251 * @addr_iv: The IV addr returned by dma_map_single, need to unmap later 252 * @addr_key: The key addr returned by dma_map_single, need to unmap later 253 * @fallback_req: request struct for invoking the fallback skcipher TFM 254 */ 255 struct sun8i_cipher_req_ctx { 256 u32 op_dir; 257 int flow; 258 unsigned int ivlen; 259 int nr_sgs; 260 int nr_sgd; 261 dma_addr_t addr_iv; 262 dma_addr_t addr_key; 263 struct skcipher_request fallback_req; // keep at the end 264 }; 265 266 /* 267 * struct sun8i_cipher_tfm_ctx - context for a skcipher TFM 268 * @enginectx: crypto_engine used by this TFM 269 * @key: pointer to key data 270 * @keylen: len of the key 271 * @ce: pointer to the private data of driver handling this TFM 272 * @fallback_tfm: pointer to the fallback TFM 273 */ 274 struct sun8i_cipher_tfm_ctx { 275 struct crypto_engine_ctx enginectx; 276 u32 *key; 277 u32 keylen; 278 struct sun8i_ce_dev *ce; 279 struct crypto_skcipher *fallback_tfm; 280 }; 281 282 /* 283 * struct sun8i_ce_hash_tfm_ctx - context for an ahash TFM 284 * @enginectx: crypto_engine used by this TFM 285 * @ce: pointer to the private data of driver handling this TFM 286 * @fallback_tfm: pointer to the fallback TFM 287 */ 288 struct sun8i_ce_hash_tfm_ctx { 289 struct crypto_engine_ctx enginectx; 290 struct sun8i_ce_dev *ce; 291 struct crypto_ahash *fallback_tfm; 292 }; 293 294 /* 295 * struct sun8i_ce_hash_reqctx - context for an ahash request 296 * @fallback_req: pre-allocated fallback request 297 * @flow: the flow to use for this request 298 */ 299 struct sun8i_ce_hash_reqctx { 300 struct ahash_request fallback_req; 301 int flow; 302 }; 303 304 /* 305 * struct sun8i_ce_prng_ctx - context for PRNG TFM 306 * @seed: The seed to use 307 * @slen: The size of the seed 308 */ 309 struct sun8i_ce_rng_tfm_ctx { 310 void *seed; 311 unsigned int slen; 312 }; 313 314 /* 315 * struct sun8i_ce_alg_template - crypto_alg template 316 * @type: the CRYPTO_ALG_TYPE for this template 317 * @ce_algo_id: the CE_ID for this template 318 * @ce_blockmode: the type of block operation CE_ID 319 * @ce: pointer to the sun8i_ce_dev structure associated with 320 * this template 321 * @alg: one of sub struct must be used 322 * @stat_req: number of request done on this template 323 * @stat_fb: number of request which has fallbacked 324 * @stat_bytes: total data size done by this template 325 */ 326 struct sun8i_ce_alg_template { 327 u32 type; 328 u32 ce_algo_id; 329 u32 ce_blockmode; 330 struct sun8i_ce_dev *ce; 331 union { 332 struct skcipher_alg skcipher; 333 struct ahash_alg hash; 334 struct rng_alg rng; 335 } alg; 336 unsigned long stat_req; 337 unsigned long stat_fb; 338 unsigned long stat_bytes; 339 unsigned long stat_fb_maxsg; 340 unsigned long stat_fb_leniv; 341 unsigned long stat_fb_len0; 342 unsigned long stat_fb_mod16; 343 unsigned long stat_fb_srcali; 344 unsigned long stat_fb_srclen; 345 unsigned long stat_fb_dstali; 346 unsigned long stat_fb_dstlen; 347 char fbname[CRYPTO_MAX_ALG_NAME]; 348 }; 349 350 int sun8i_ce_enqueue(struct crypto_async_request *areq, u32 type); 351 352 int sun8i_ce_aes_setkey(struct crypto_skcipher *tfm, const u8 *key, 353 unsigned int keylen); 354 int sun8i_ce_des3_setkey(struct crypto_skcipher *tfm, const u8 *key, 355 unsigned int keylen); 356 int sun8i_ce_cipher_init(struct crypto_tfm *tfm); 357 void sun8i_ce_cipher_exit(struct crypto_tfm *tfm); 358 int sun8i_ce_skdecrypt(struct skcipher_request *areq); 359 int sun8i_ce_skencrypt(struct skcipher_request *areq); 360 361 int sun8i_ce_get_engine_number(struct sun8i_ce_dev *ce); 362 363 int sun8i_ce_run_task(struct sun8i_ce_dev *ce, int flow, const char *name); 364 365 int sun8i_ce_hash_crainit(struct crypto_tfm *tfm); 366 void sun8i_ce_hash_craexit(struct crypto_tfm *tfm); 367 int sun8i_ce_hash_init(struct ahash_request *areq); 368 int sun8i_ce_hash_export(struct ahash_request *areq, void *out); 369 int sun8i_ce_hash_import(struct ahash_request *areq, const void *in); 370 int sun8i_ce_hash(struct ahash_request *areq); 371 int sun8i_ce_hash_final(struct ahash_request *areq); 372 int sun8i_ce_hash_update(struct ahash_request *areq); 373 int sun8i_ce_hash_finup(struct ahash_request *areq); 374 int sun8i_ce_hash_digest(struct ahash_request *areq); 375 int sun8i_ce_hash_run(struct crypto_engine *engine, void *breq); 376 377 int sun8i_ce_prng_generate(struct crypto_rng *tfm, const u8 *src, 378 unsigned int slen, u8 *dst, unsigned int dlen); 379 int sun8i_ce_prng_seed(struct crypto_rng *tfm, const u8 *seed, unsigned int slen); 380 void sun8i_ce_prng_exit(struct crypto_tfm *tfm); 381 int sun8i_ce_prng_init(struct crypto_tfm *tfm); 382 383 int sun8i_ce_hwrng_register(struct sun8i_ce_dev *ce); 384 void sun8i_ce_hwrng_unregister(struct sun8i_ce_dev *ce); 385