sun8i-ss.h (9283B)
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 */ 93struct 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 */ 108struct 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 115struct 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 */ 131struct 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 */ 157struct 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 */ 187struct 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 */ 212struct 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 */ 225struct 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 */ 238struct 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 */ 256struct 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 */ 276struct 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 296int sun8i_ss_enqueue(struct crypto_async_request *areq, u32 type); 297 298int sun8i_ss_aes_setkey(struct crypto_skcipher *tfm, const u8 *key, 299 unsigned int keylen); 300int sun8i_ss_des3_setkey(struct crypto_skcipher *tfm, const u8 *key, 301 unsigned int keylen); 302int sun8i_ss_cipher_init(struct crypto_tfm *tfm); 303void sun8i_ss_cipher_exit(struct crypto_tfm *tfm); 304int sun8i_ss_skdecrypt(struct skcipher_request *areq); 305int sun8i_ss_skencrypt(struct skcipher_request *areq); 306 307int sun8i_ss_get_engine_number(struct sun8i_ss_dev *ss); 308 309int sun8i_ss_run_task(struct sun8i_ss_dev *ss, struct sun8i_cipher_req_ctx *rctx, const char *name); 310int sun8i_ss_prng_generate(struct crypto_rng *tfm, const u8 *src, 311 unsigned int slen, u8 *dst, unsigned int dlen); 312int sun8i_ss_prng_seed(struct crypto_rng *tfm, const u8 *seed, unsigned int slen); 313int sun8i_ss_prng_init(struct crypto_tfm *tfm); 314void sun8i_ss_prng_exit(struct crypto_tfm *tfm); 315 316int sun8i_ss_hash_crainit(struct crypto_tfm *tfm); 317void sun8i_ss_hash_craexit(struct crypto_tfm *tfm); 318int sun8i_ss_hash_init(struct ahash_request *areq); 319int sun8i_ss_hash_export(struct ahash_request *areq, void *out); 320int sun8i_ss_hash_import(struct ahash_request *areq, const void *in); 321int sun8i_ss_hash_final(struct ahash_request *areq); 322int sun8i_ss_hash_update(struct ahash_request *areq); 323int sun8i_ss_hash_finup(struct ahash_request *areq); 324int sun8i_ss_hash_digest(struct ahash_request *areq); 325int sun8i_ss_hash_run(struct crypto_engine *engine, void *breq); 326int sun8i_ss_hmac_setkey(struct crypto_ahash *ahash, const u8 *key, 327 unsigned int keylen);