1 /* SPDX-License-Identifier: GPL-2.0+ */ 2 /* 3 * CAAM descriptor composition header 4 * Definitions to support CAAM descriptor instruction generation 5 * 6 * Copyright 2008-2014 Freescale Semiconductor, Inc. 7 * 8 * Based on desc.h file in linux drivers/crypto/caam 9 */ 10 11 #ifndef DESC_H 12 #define DESC_H 13 14 #define KEY_BLOB_SIZE 32 15 #define MAC_SIZE 16 16 17 /* Max size of any CAAM descriptor in 32-bit words, inclusive of header */ 18 #define MAX_CAAM_DESCSIZE 64 19 20 /* Size of DEK Blob descriptor, inclusive of header */ 21 #define DEK_BLOB_DESCSIZE 9 22 23 /* Block size of any entity covered/uncovered with a KEK/TKEK */ 24 #define KEK_BLOCKSIZE 16 25 26 /* 27 * Supported descriptor command types as they show up 28 * inside a descriptor command word. 29 */ 30 #define CMD_SHIFT 27 31 #define CMD_MASK 0xf8000000 32 33 #define CMD_KEY (0x00 << CMD_SHIFT) 34 #define CMD_SEQ_KEY (0x01 << CMD_SHIFT) 35 #define CMD_LOAD (0x02 << CMD_SHIFT) 36 #define CMD_SEQ_LOAD (0x03 << CMD_SHIFT) 37 #define CMD_FIFO_LOAD (0x04 << CMD_SHIFT) 38 #define CMD_SEQ_FIFO_LOAD (0x05 << CMD_SHIFT) 39 #define CMD_STORE (0x0a << CMD_SHIFT) 40 #define CMD_SEQ_STORE (0x0b << CMD_SHIFT) 41 #define CMD_FIFO_STORE (0x0c << CMD_SHIFT) 42 #define CMD_SEQ_FIFO_STORE (0x0d << CMD_SHIFT) 43 #define CMD_MOVE_LEN (0x0e << CMD_SHIFT) 44 #define CMD_MOVE (0x0f << CMD_SHIFT) 45 #define CMD_OPERATION (0x10 << CMD_SHIFT) 46 #define CMD_SIGNATURE (0x12 << CMD_SHIFT) 47 #define CMD_JUMP (0x14 << CMD_SHIFT) 48 #define CMD_MATH (0x15 << CMD_SHIFT) 49 #define CMD_DESC_HDR (0x16 << CMD_SHIFT) 50 #define CMD_SHARED_DESC_HDR (0x17 << CMD_SHIFT) 51 #define CMD_SEQ_IN_PTR (0x1e << CMD_SHIFT) 52 #define CMD_SEQ_OUT_PTR (0x1f << CMD_SHIFT) 53 54 /* General-purpose class selector for all commands */ 55 #define CLASS_SHIFT 25 56 #define CLASS_MASK (0x03 << CLASS_SHIFT) 57 58 #define CLASS_NONE (0x00 << CLASS_SHIFT) 59 #define CLASS_1 (0x01 << CLASS_SHIFT) 60 #define CLASS_2 (0x02 << CLASS_SHIFT) 61 #define CLASS_BOTH (0x03 << CLASS_SHIFT) 62 63 /* 64 * Descriptor header command constructs 65 * Covers shared, job, and trusted descriptor headers 66 */ 67 68 /* 69 * Do Not Run - marks a descriptor inexecutable if there was 70 * a preceding error somewhere 71 */ 72 #define HDR_DNR 0x01000000 73 74 /* 75 * ONE - should always be set. Combination of ONE (always 76 * set) and ZRO (always clear) forms an endianness sanity check 77 */ 78 #define HDR_ONE 0x00800000 79 #define HDR_ZRO 0x00008000 80 81 /* Start Index or SharedDesc Length */ 82 #define HDR_START_IDX_MASK 0x3f 83 #define HDR_START_IDX_SHIFT 16 84 85 /* If shared descriptor header, 6-bit length */ 86 #define HDR_DESCLEN_SHR_MASK 0x3f 87 88 /* If non-shared header, 7-bit length */ 89 #define HDR_DESCLEN_MASK 0x7f 90 91 /* This is a TrustedDesc (if not SharedDesc) */ 92 #define HDR_TRUSTED 0x00004000 93 94 /* Make into TrustedDesc (if not SharedDesc) */ 95 #define HDR_MAKE_TRUSTED 0x00002000 96 97 /* Save context if self-shared (if SharedDesc) */ 98 #define HDR_SAVECTX 0x00001000 99 100 /* Next item points to SharedDesc */ 101 #define HDR_SHARED 0x00001000 102 103 /* 104 * Reverse Execution Order - execute JobDesc first, then 105 * execute SharedDesc (normally SharedDesc goes first). 106 */ 107 #define HDR_REVERSE 0x00000800 108 109 /* Propagate DNR property to SharedDesc */ 110 #define HDR_PROP_DNR 0x00000800 111 112 /* JobDesc/SharedDesc share property */ 113 #define HDR_SD_SHARE_MASK 0x03 114 #define HDR_SD_SHARE_SHIFT 8 115 #define HDR_JD_SHARE_MASK 0x07 116 #define HDR_JD_SHARE_SHIFT 8 117 118 #define HDR_SHARE_NEVER (0x00 << HDR_SD_SHARE_SHIFT) 119 #define HDR_SHARE_WAIT (0x01 << HDR_SD_SHARE_SHIFT) 120 #define HDR_SHARE_SERIAL (0x02 << HDR_SD_SHARE_SHIFT) 121 #define HDR_SHARE_ALWAYS (0x03 << HDR_SD_SHARE_SHIFT) 122 #define HDR_SHARE_DEFER (0x04 << HDR_SD_SHARE_SHIFT) 123 124 /* JobDesc/SharedDesc descriptor length */ 125 #define HDR_JD_LENGTH_MASK 0x7f 126 #define HDR_SD_LENGTH_MASK 0x3f 127 128 /* 129 * KEY/SEQ_KEY Command Constructs 130 */ 131 132 /* Key Destination Class: 01 = Class 1, 02 - Class 2 */ 133 #define KEY_DEST_CLASS_SHIFT 25 /* use CLASS_1 or CLASS_2 */ 134 #define KEY_DEST_CLASS_MASK (0x03 << KEY_DEST_CLASS_SHIFT) 135 136 /* Scatter-Gather Table/Variable Length Field */ 137 #define KEY_SGF 0x01000000 138 #define KEY_VLF 0x01000000 139 140 /* Immediate - Key follows command in the descriptor */ 141 #define KEY_IMM 0x00800000 142 143 /* 144 * Encrypted - Key is encrypted either with the KEK, or 145 * with the TDKEK if TK is set 146 */ 147 #define KEY_ENC 0x00400000 148 149 /* 150 * No Write Back - Do not allow key to be FIFO STOREd 151 */ 152 #define KEY_NWB 0x00200000 153 154 /* 155 * Enhanced Encryption of Key 156 */ 157 #define KEY_EKT 0x00100000 158 159 /* 160 * Encrypted with Trusted Key 161 */ 162 #define KEY_TK 0x00008000 163 164 /* 165 * KDEST - Key Destination: 0 - class key register, 166 * 1 - PKHA 'e', 2 - AFHA Sbox, 3 - MDHA split-key 167 */ 168 #define KEY_DEST_SHIFT 16 169 #define KEY_DEST_MASK (0x03 << KEY_DEST_SHIFT) 170 171 #define KEY_DEST_CLASS_REG (0x00 << KEY_DEST_SHIFT) 172 #define KEY_DEST_PKHA_E (0x01 << KEY_DEST_SHIFT) 173 #define KEY_DEST_AFHA_SBOX (0x02 << KEY_DEST_SHIFT) 174 #define KEY_DEST_MDHA_SPLIT (0x03 << KEY_DEST_SHIFT) 175 176 /* Length in bytes */ 177 #define KEY_LENGTH_MASK 0x000003ff 178 179 /* 180 * LOAD/SEQ_LOAD/STORE/SEQ_STORE Command Constructs 181 */ 182 183 /* 184 * Load/Store Destination: 0 = class independent CCB, 185 * 1 = class 1 CCB, 2 = class 2 CCB, 3 = DECO 186 */ 187 #define LDST_CLASS_SHIFT 25 188 #define LDST_CLASS_MASK (0x03 << LDST_CLASS_SHIFT) 189 #define LDST_CLASS_IND_CCB (0x00 << LDST_CLASS_SHIFT) 190 #define LDST_CLASS_1_CCB (0x01 << LDST_CLASS_SHIFT) 191 #define LDST_CLASS_2_CCB (0x02 << LDST_CLASS_SHIFT) 192 #define LDST_CLASS_DECO (0x03 << LDST_CLASS_SHIFT) 193 194 /* Scatter-Gather Table/Variable Length Field */ 195 #define LDST_SGF 0x01000000 196 #define LDST_VLF LDST_SGF 197 198 /* Immediate - Key follows this command in descriptor */ 199 #define LDST_IMM_MASK 1 200 #define LDST_IMM_SHIFT 23 201 #define LDST_IMM (LDST_IMM_MASK << LDST_IMM_SHIFT) 202 203 /* SRC/DST - Destination for LOAD, Source for STORE */ 204 #define LDST_SRCDST_SHIFT 16 205 #define LDST_SRCDST_MASK (0x7f << LDST_SRCDST_SHIFT) 206 207 #define LDST_SRCDST_BYTE_CONTEXT (0x20 << LDST_SRCDST_SHIFT) 208 #define LDST_SRCDST_BYTE_KEY (0x40 << LDST_SRCDST_SHIFT) 209 #define LDST_SRCDST_BYTE_INFIFO (0x7c << LDST_SRCDST_SHIFT) 210 #define LDST_SRCDST_BYTE_OUTFIFO (0x7e << LDST_SRCDST_SHIFT) 211 212 #define LDST_SRCDST_WORD_MODE_REG (0x00 << LDST_SRCDST_SHIFT) 213 #define LDST_SRCDST_WORD_KEYSZ_REG (0x01 << LDST_SRCDST_SHIFT) 214 #define LDST_SRCDST_WORD_DATASZ_REG (0x02 << LDST_SRCDST_SHIFT) 215 #define LDST_SRCDST_WORD_ICVSZ_REG (0x03 << LDST_SRCDST_SHIFT) 216 #define LDST_SRCDST_WORD_CHACTRL (0x06 << LDST_SRCDST_SHIFT) 217 #define LDST_SRCDST_WORD_DECOCTRL (0x06 << LDST_SRCDST_SHIFT) 218 #define LDST_SRCDST_WORD_IRQCTRL (0x07 << LDST_SRCDST_SHIFT) 219 #define LDST_SRCDST_WORD_DECO_PCLOVRD (0x07 << LDST_SRCDST_SHIFT) 220 #define LDST_SRCDST_WORD_CLRW (0x08 << LDST_SRCDST_SHIFT) 221 #define LDST_SRCDST_WORD_DECO_MATH0 (0x08 << LDST_SRCDST_SHIFT) 222 #define LDST_SRCDST_WORD_STAT (0x09 << LDST_SRCDST_SHIFT) 223 #define LDST_SRCDST_WORD_DECO_MATH1 (0x09 << LDST_SRCDST_SHIFT) 224 #define LDST_SRCDST_WORD_DECO_MATH2 (0x0a << LDST_SRCDST_SHIFT) 225 #define LDST_SRCDST_WORD_DECO_AAD_SZ (0x0b << LDST_SRCDST_SHIFT) 226 #define LDST_SRCDST_WORD_DECO_MATH3 (0x0b << LDST_SRCDST_SHIFT) 227 #define LDST_SRCDST_WORD_CLASS1_ICV_SZ (0x0c << LDST_SRCDST_SHIFT) 228 #define LDST_SRCDST_WORD_ALTDS_CLASS1 (0x0f << LDST_SRCDST_SHIFT) 229 #define LDST_SRCDST_WORD_PKHA_A_SZ (0x10 << LDST_SRCDST_SHIFT) 230 #define LDST_SRCDST_WORD_PKHA_B_SZ (0x11 << LDST_SRCDST_SHIFT) 231 #define LDST_SRCDST_WORD_PKHA_N_SZ (0x12 << LDST_SRCDST_SHIFT) 232 #define LDST_SRCDST_WORD_PKHA_E_SZ (0x13 << LDST_SRCDST_SHIFT) 233 #define LDST_SRCDST_WORD_CLASS_CTX (0x20 << LDST_SRCDST_SHIFT) 234 #define LDST_SRCDST_WORD_DESCBUF (0x40 << LDST_SRCDST_SHIFT) 235 #define LDST_SRCDST_WORD_DESCBUF_JOB (0x41 << LDST_SRCDST_SHIFT) 236 #define LDST_SRCDST_WORD_DESCBUF_SHARED (0x42 << LDST_SRCDST_SHIFT) 237 #define LDST_SRCDST_WORD_DESCBUF_JOB_WE (0x45 << LDST_SRCDST_SHIFT) 238 #define LDST_SRCDST_WORD_DESCBUF_SHARED_WE (0x46 << LDST_SRCDST_SHIFT) 239 #define LDST_SRCDST_WORD_INFO_FIFO (0x7a << LDST_SRCDST_SHIFT) 240 241 /* Offset in source/destination */ 242 #define LDST_OFFSET_SHIFT 8 243 #define LDST_OFFSET_MASK (0xff << LDST_OFFSET_SHIFT) 244 245 /* LDOFF definitions used when DST = LDST_SRCDST_WORD_DECOCTRL */ 246 /* These could also be shifted by LDST_OFFSET_SHIFT - this reads better */ 247 #define LDOFF_CHG_SHARE_SHIFT 0 248 #define LDOFF_CHG_SHARE_MASK (0x3 << LDOFF_CHG_SHARE_SHIFT) 249 #define LDOFF_CHG_SHARE_NEVER (0x1 << LDOFF_CHG_SHARE_SHIFT) 250 #define LDOFF_CHG_SHARE_OK_PROP (0x2 << LDOFF_CHG_SHARE_SHIFT) 251 #define LDOFF_CHG_SHARE_OK_NO_PROP (0x3 << LDOFF_CHG_SHARE_SHIFT) 252 253 #define LDOFF_ENABLE_AUTO_NFIFO (1 << 2) 254 #define LDOFF_DISABLE_AUTO_NFIFO (1 << 3) 255 256 #define LDOFF_CHG_NONSEQLIODN_SHIFT 4 257 #define LDOFF_CHG_NONSEQLIODN_MASK (0x3 << LDOFF_CHG_NONSEQLIODN_SHIFT) 258 #define LDOFF_CHG_NONSEQLIODN_SEQ (0x1 << LDOFF_CHG_NONSEQLIODN_SHIFT) 259 #define LDOFF_CHG_NONSEQLIODN_NON_SEQ (0x2 << LDOFF_CHG_NONSEQLIODN_SHIFT) 260 #define LDOFF_CHG_NONSEQLIODN_TRUSTED (0x3 << LDOFF_CHG_NONSEQLIODN_SHIFT) 261 262 #define LDOFF_CHG_SEQLIODN_SHIFT 6 263 #define LDOFF_CHG_SEQLIODN_MASK (0x3 << LDOFF_CHG_SEQLIODN_SHIFT) 264 #define LDOFF_CHG_SEQLIODN_SEQ (0x1 << LDOFF_CHG_SEQLIODN_SHIFT) 265 #define LDOFF_CHG_SEQLIODN_NON_SEQ (0x2 << LDOFF_CHG_SEQLIODN_SHIFT) 266 #define LDOFF_CHG_SEQLIODN_TRUSTED (0x3 << LDOFF_CHG_SEQLIODN_SHIFT) 267 268 /* Data length in bytes */ 269 #define LDST_LEN_SHIFT 0 270 #define LDST_LEN_MASK (0xff << LDST_LEN_SHIFT) 271 272 /* Special Length definitions when dst=deco-ctrl */ 273 #define LDLEN_ENABLE_OSL_COUNT (1 << 7) 274 #define LDLEN_RST_CHA_OFIFO_PTR (1 << 6) 275 #define LDLEN_RST_OFIFO (1 << 5) 276 #define LDLEN_SET_OFIFO_OFF_VALID (1 << 4) 277 #define LDLEN_SET_OFIFO_OFF_RSVD (1 << 3) 278 #define LDLEN_SET_OFIFO_OFFSET_SHIFT 0 279 #define LDLEN_SET_OFIFO_OFFSET_MASK (3 << LDLEN_SET_OFIFO_OFFSET_SHIFT) 280 281 /* 282 * AAD Definitions 283 */ 284 #define AES_KEY_SHIFT 8 285 #define LD_CCM_MODE 0x66 286 #define KEY_AES_SRC (0x55 << AES_KEY_SHIFT) 287 288 /* 289 * FIFO_LOAD/FIFO_STORE/SEQ_FIFO_LOAD/SEQ_FIFO_STORE 290 * Command Constructs 291 */ 292 293 /* 294 * Load Destination: 0 = skip (SEQ_FIFO_LOAD only), 295 * 1 = Load for Class1, 2 = Load for Class2, 3 = Load both 296 * Store Source: 0 = normal, 1 = Class1key, 2 = Class2key 297 */ 298 #define FIFOLD_CLASS_SHIFT 25 299 #define FIFOLD_CLASS_MASK (0x03 << FIFOLD_CLASS_SHIFT) 300 #define FIFOLD_CLASS_SKIP (0x00 << FIFOLD_CLASS_SHIFT) 301 #define FIFOLD_CLASS_CLASS1 (0x01 << FIFOLD_CLASS_SHIFT) 302 #define FIFOLD_CLASS_CLASS2 (0x02 << FIFOLD_CLASS_SHIFT) 303 #define FIFOLD_CLASS_BOTH (0x03 << FIFOLD_CLASS_SHIFT) 304 305 #define FIFOST_CLASS_SHIFT 25 306 #define FIFOST_CLASS_MASK (0x03 << FIFOST_CLASS_SHIFT) 307 #define FIFOST_CLASS_NORMAL (0x00 << FIFOST_CLASS_SHIFT) 308 #define FIFOST_CLASS_CLASS1KEY (0x01 << FIFOST_CLASS_SHIFT) 309 #define FIFOST_CLASS_CLASS2KEY (0x02 << FIFOST_CLASS_SHIFT) 310 311 /* 312 * Scatter-Gather Table/Variable Length Field 313 * If set for FIFO_LOAD, refers to a SG table. Within 314 * SEQ_FIFO_LOAD, is variable input sequence 315 */ 316 #define FIFOLDST_SGF_SHIFT 24 317 #define FIFOLDST_SGF_MASK (1 << FIFOLDST_SGF_SHIFT) 318 #define FIFOLDST_VLF_MASK (1 << FIFOLDST_SGF_SHIFT) 319 #define FIFOLDST_SGF (1 << FIFOLDST_SGF_SHIFT) 320 #define FIFOLDST_VLF (1 << FIFOLDST_SGF_SHIFT) 321 322 /* Immediate - Data follows command in descriptor */ 323 #define FIFOLD_IMM_SHIFT 23 324 #define FIFOLD_IMM_MASK (1 << FIFOLD_IMM_SHIFT) 325 #define FIFOLD_IMM (1 << FIFOLD_IMM_SHIFT) 326 327 /* Continue - Not the last FIFO store to come */ 328 #define FIFOST_CONT_SHIFT 23 329 #define FIFOST_CONT_MASK (1 << FIFOST_CONT_SHIFT) 330 331 /* 332 * Extended Length - use 32-bit extended length that 333 * follows the pointer field. Illegal with IMM set 334 */ 335 #define FIFOLDST_EXT_SHIFT 22 336 #define FIFOLDST_EXT_MASK (1 << FIFOLDST_EXT_SHIFT) 337 #define FIFOLDST_EXT (1 << FIFOLDST_EXT_SHIFT) 338 339 /* Input data type.*/ 340 #define FIFOLD_TYPE_SHIFT 16 341 #define FIFOLD_CONT_TYPE_SHIFT 19 /* shift past last-flush bits */ 342 #define FIFOLD_TYPE_MASK (0x3f << FIFOLD_TYPE_SHIFT) 343 344 /* PK types */ 345 #define FIFOLD_TYPE_PK (0x00 << FIFOLD_TYPE_SHIFT) 346 #define FIFOLD_TYPE_PK_MASK (0x30 << FIFOLD_TYPE_SHIFT) 347 #define FIFOLD_TYPE_PK_TYPEMASK (0x0f << FIFOLD_TYPE_SHIFT) 348 #define FIFOLD_TYPE_PK_A0 (0x00 << FIFOLD_TYPE_SHIFT) 349 #define FIFOLD_TYPE_PK_A1 (0x01 << FIFOLD_TYPE_SHIFT) 350 #define FIFOLD_TYPE_PK_A2 (0x02 << FIFOLD_TYPE_SHIFT) 351 #define FIFOLD_TYPE_PK_A3 (0x03 << FIFOLD_TYPE_SHIFT) 352 #define FIFOLD_TYPE_PK_B0 (0x04 << FIFOLD_TYPE_SHIFT) 353 #define FIFOLD_TYPE_PK_B1 (0x05 << FIFOLD_TYPE_SHIFT) 354 #define FIFOLD_TYPE_PK_B2 (0x06 << FIFOLD_TYPE_SHIFT) 355 #define FIFOLD_TYPE_PK_B3 (0x07 << FIFOLD_TYPE_SHIFT) 356 #define FIFOLD_TYPE_PK_N (0x08 << FIFOLD_TYPE_SHIFT) 357 #define FIFOLD_TYPE_PK_A (0x0c << FIFOLD_TYPE_SHIFT) 358 #define FIFOLD_TYPE_PK_B (0x0d << FIFOLD_TYPE_SHIFT) 359 360 /* Other types. Need to OR in last/flush bits as desired */ 361 #define FIFOLD_TYPE_MSG_MASK (0x38 << FIFOLD_TYPE_SHIFT) 362 #define FIFOLD_TYPE_MSG (0x10 << FIFOLD_TYPE_SHIFT) 363 #define FIFOLD_TYPE_MSG1OUT2 (0x18 << FIFOLD_TYPE_SHIFT) 364 #define FIFOLD_TYPE_IV (0x20 << FIFOLD_TYPE_SHIFT) 365 #define FIFOLD_TYPE_BITDATA (0x28 << FIFOLD_TYPE_SHIFT) 366 #define FIFOLD_TYPE_AAD (0x30 << FIFOLD_TYPE_SHIFT) 367 #define FIFOLD_TYPE_ICV (0x38 << FIFOLD_TYPE_SHIFT) 368 369 /* Last/Flush bits for use with "other" types above */ 370 #define FIFOLD_TYPE_ACT_MASK (0x07 << FIFOLD_TYPE_SHIFT) 371 #define FIFOLD_TYPE_NOACTION (0x00 << FIFOLD_TYPE_SHIFT) 372 #define FIFOLD_TYPE_FLUSH1 (0x01 << FIFOLD_TYPE_SHIFT) 373 #define FIFOLD_TYPE_LAST1 (0x02 << FIFOLD_TYPE_SHIFT) 374 #define FIFOLD_TYPE_LAST2FLUSH (0x03 << FIFOLD_TYPE_SHIFT) 375 #define FIFOLD_TYPE_LAST2 (0x04 << FIFOLD_TYPE_SHIFT) 376 #define FIFOLD_TYPE_LAST2FLUSH1 (0x05 << FIFOLD_TYPE_SHIFT) 377 #define FIFOLD_TYPE_LASTBOTH (0x06 << FIFOLD_TYPE_SHIFT) 378 #define FIFOLD_TYPE_LASTBOTHFL (0x07 << FIFOLD_TYPE_SHIFT) 379 #define FIFOLD_TYPE_NOINFOFIFO (0x0F << FIFOLD_TYPE_SHIFT) 380 381 #define FIFOLDST_LEN_MASK 0xffff 382 #define FIFOLDST_EXT_LEN_MASK 0xffffffff 383 384 /* Output data types */ 385 #define FIFOST_TYPE_SHIFT 16 386 #define FIFOST_TYPE_MASK (0x3f << FIFOST_TYPE_SHIFT) 387 388 #define FIFOST_TYPE_PKHA_A0 (0x00 << FIFOST_TYPE_SHIFT) 389 #define FIFOST_TYPE_PKHA_A1 (0x01 << FIFOST_TYPE_SHIFT) 390 #define FIFOST_TYPE_PKHA_A2 (0x02 << FIFOST_TYPE_SHIFT) 391 #define FIFOST_TYPE_PKHA_A3 (0x03 << FIFOST_TYPE_SHIFT) 392 #define FIFOST_TYPE_PKHA_B0 (0x04 << FIFOST_TYPE_SHIFT) 393 #define FIFOST_TYPE_PKHA_B1 (0x05 << FIFOST_TYPE_SHIFT) 394 #define FIFOST_TYPE_PKHA_B2 (0x06 << FIFOST_TYPE_SHIFT) 395 #define FIFOST_TYPE_PKHA_B3 (0x07 << FIFOST_TYPE_SHIFT) 396 #define FIFOST_TYPE_PKHA_N (0x08 << FIFOST_TYPE_SHIFT) 397 #define FIFOST_TYPE_PKHA_A (0x0c << FIFOST_TYPE_SHIFT) 398 #define FIFOST_TYPE_PKHA_B (0x0d << FIFOST_TYPE_SHIFT) 399 #define FIFOST_TYPE_AF_SBOX_JKEK (0x10 << FIFOST_TYPE_SHIFT) 400 #define FIFOST_TYPE_AF_SBOX_TKEK (0x21 << FIFOST_TYPE_SHIFT) 401 #define FIFOST_TYPE_PKHA_E_JKEK (0x22 << FIFOST_TYPE_SHIFT) 402 #define FIFOST_TYPE_PKHA_E_TKEK (0x23 << FIFOST_TYPE_SHIFT) 403 #define FIFOST_TYPE_KEY_KEK (0x24 << FIFOST_TYPE_SHIFT) 404 #define FIFOST_TYPE_KEY_TKEK (0x25 << FIFOST_TYPE_SHIFT) 405 #define FIFOST_TYPE_SPLIT_KEK (0x26 << FIFOST_TYPE_SHIFT) 406 #define FIFOST_TYPE_SPLIT_TKEK (0x27 << FIFOST_TYPE_SHIFT) 407 #define FIFOST_TYPE_OUTFIFO_KEK (0x28 << FIFOST_TYPE_SHIFT) 408 #define FIFOST_TYPE_OUTFIFO_TKEK (0x29 << FIFOST_TYPE_SHIFT) 409 #define FIFOST_TYPE_MESSAGE_DATA (0x30 << FIFOST_TYPE_SHIFT) 410 #define FIFOST_TYPE_RNGSTORE (0x34 << FIFOST_TYPE_SHIFT) 411 #define FIFOST_TYPE_RNGFIFO (0x35 << FIFOST_TYPE_SHIFT) 412 #define FIFOST_TYPE_SKIP (0x3f << FIFOST_TYPE_SHIFT) 413 414 /* 415 * OPERATION Command Constructs 416 */ 417 418 /* Operation type selectors - OP TYPE */ 419 #define OP_TYPE_SHIFT 24 420 #define OP_TYPE_MASK (0x07 << OP_TYPE_SHIFT) 421 422 #define OP_TYPE_UNI_PROTOCOL (0x00 << OP_TYPE_SHIFT) 423 #define OP_TYPE_PK (0x01 << OP_TYPE_SHIFT) 424 #define OP_TYPE_CLASS1_ALG (0x02 << OP_TYPE_SHIFT) 425 #define OP_TYPE_CLASS2_ALG (0x04 << OP_TYPE_SHIFT) 426 #define OP_TYPE_DECAP_PROTOCOL (0x06 << OP_TYPE_SHIFT) 427 #define OP_TYPE_ENCAP_PROTOCOL (0x07 << OP_TYPE_SHIFT) 428 429 /* ProtocolID selectors - PROTID */ 430 #define OP_PCLID_SHIFT 16 431 #define OP_PCLID_MASK (0xff << 16) 432 433 /* Assuming OP_TYPE = OP_TYPE_UNI_PROTOCOL */ 434 #define OP_PCLID_SECMEM 0x08 435 #define OP_PCLID_BLOB (0x0d << OP_PCLID_SHIFT) 436 #define OP_PCLID_SECRETKEY (0x11 << OP_PCLID_SHIFT) 437 #define OP_PCLID_PUBLICKEYPAIR (0x14 << OP_PCLID_SHIFT) 438 #define OP_PCLID_DSA_SIGN (0x15 << OP_PCLID_SHIFT) 439 #define OP_PCLID_DSA_VERIFY (0x16 << OP_PCLID_SHIFT) 440 441 /* Assuming OP_TYPE = OP_TYPE_DECAP_PROTOCOL */ 442 #define OP_PCLID_MP_PUB_KEY (0x14 << OP_PCLID_SHIFT) 443 #define OP_PCLID_MP_SIGN (0x15 << OP_PCLID_SHIFT) 444 445 /* Assuming OP_TYPE = OP_TYPE_ENCAP_PROTOCOL */ 446 #define OP_PCLID_MP_PRIV_KEY (0x14 << OP_PCLID_SHIFT) 447 448 /* PROTINFO fields for discrete log public key protocols */ 449 #define OP_PROTINFO_F2M_FP 0x00000001 450 #define OP_PROTINFO_ECC_DL 0x00000002 451 #define OP_PROTINFO_ENC_PRI 0x00000004 452 #define OP_PROTINFO_TEST 0x00000008 453 #define OP_PROTINFO_EXT_PRI 0x00000010 454 #define OP_PROTINFO_ENC_Z 0x00000020 455 #define OP_PROTINFO_EKT_Z 0x00000040 456 #define OP_PROTINFO_MES_REP 0x00000400 457 #define OP_PROTINFO_HASH_MD5 0x00000000 458 #define OP_PROTINFO_HASH_SHA1 0x00000080 459 #define OP_PROTINFO_HASH_SHA224 0x00000100 460 #define OP_PROTINFO_HASH_SHA256 0x00000180 461 #define OP_PROTINFO_HASH_SHA384 0x00000200 462 #define OP_PROTINFO_HASH_SHA512 0x00000280 463 464 /* For non-protocol/alg-only op commands */ 465 #define OP_ALG_TYPE_SHIFT 24 466 #define OP_ALG_TYPE_MASK (0x7 << OP_ALG_TYPE_SHIFT) 467 #define OP_ALG_TYPE_CLASS1 2 468 #define OP_ALG_TYPE_CLASS2 4 469 470 #define OP_ALG_ALGSEL_SHIFT 16 471 #define OP_ALG_ALGSEL_MASK (0xff << OP_ALG_ALGSEL_SHIFT) 472 #define OP_ALG_ALGSEL_SUBMASK (0x0f << OP_ALG_ALGSEL_SHIFT) 473 #define OP_ALG_ALGSEL_AES (0x10 << OP_ALG_ALGSEL_SHIFT) 474 #define OP_ALG_ALGSEL_DES (0x20 << OP_ALG_ALGSEL_SHIFT) 475 #define OP_ALG_ALGSEL_3DES (0x21 << OP_ALG_ALGSEL_SHIFT) 476 #define OP_ALG_ALGSEL_ARC4 (0x30 << OP_ALG_ALGSEL_SHIFT) 477 #define OP_ALG_ALGSEL_MD5 (0x40 << OP_ALG_ALGSEL_SHIFT) 478 #define OP_ALG_ALGSEL_SHA1 (0x41 << OP_ALG_ALGSEL_SHIFT) 479 #define OP_ALG_ALGSEL_SHA224 (0x42 << OP_ALG_ALGSEL_SHIFT) 480 #define OP_ALG_ALGSEL_SHA256 (0x43 << OP_ALG_ALGSEL_SHIFT) 481 #define OP_ALG_ALGSEL_SHA384 (0x44 << OP_ALG_ALGSEL_SHIFT) 482 #define OP_ALG_ALGSEL_SHA512 (0x45 << OP_ALG_ALGSEL_SHIFT) 483 #define OP_ALG_ALGSEL_RNG (0x50 << OP_ALG_ALGSEL_SHIFT) 484 #define OP_ALG_ALGSEL_SNOW (0x60 << OP_ALG_ALGSEL_SHIFT) 485 #define OP_ALG_ALGSEL_SNOW_F8 (0x60 << OP_ALG_ALGSEL_SHIFT) 486 #define OP_ALG_ALGSEL_KASUMI (0x70 << OP_ALG_ALGSEL_SHIFT) 487 #define OP_ALG_ALGSEL_CRC (0x90 << OP_ALG_ALGSEL_SHIFT) 488 #define OP_ALG_ALGSEL_SNOW_F9 (0xA0 << OP_ALG_ALGSEL_SHIFT) 489 490 #define OP_ALG_AAI_SHIFT 4 491 #define OP_ALG_AAI_MASK (0x1ff << OP_ALG_AAI_SHIFT) 492 493 /* randomizer AAI set */ 494 #define OP_ALG_AAI_RNG (0x00 << OP_ALG_AAI_SHIFT) 495 #define OP_ALG_AAI_RNG_NZB (0x10 << OP_ALG_AAI_SHIFT) 496 #define OP_ALG_AAI_RNG_OBP (0x20 << OP_ALG_AAI_SHIFT) 497 498 /* RNG4 AAI set */ 499 #define OP_ALG_AAI_RNG4_SH_0 (0x00 << OP_ALG_AAI_SHIFT) 500 #define OP_ALG_AAI_RNG4_SH_1 (0x01 << OP_ALG_AAI_SHIFT) 501 #define OP_ALG_AAI_RNG4_PS (0x40 << OP_ALG_AAI_SHIFT) 502 #define OP_ALG_AAI_RNG4_AI (0x80 << OP_ALG_AAI_SHIFT) 503 #define OP_ALG_AAI_RNG4_SK (0x100 << OP_ALG_AAI_SHIFT) 504 505 /* hmac/smac AAI set */ 506 #define OP_ALG_AAI_HASH (0x00 << OP_ALG_AAI_SHIFT) 507 #define OP_ALG_AAI_HMAC (0x01 << OP_ALG_AAI_SHIFT) 508 #define OP_ALG_AAI_SMAC (0x02 << OP_ALG_AAI_SHIFT) 509 #define OP_ALG_AAI_HMAC_PRECOMP (0x04 << OP_ALG_AAI_SHIFT) 510 511 #define OP_ALG_AS_SHIFT 2 512 #define OP_ALG_AS_MASK (0x3 << OP_ALG_AS_SHIFT) 513 #define OP_ALG_AS_UPDATE (0 << OP_ALG_AS_SHIFT) 514 #define OP_ALG_AS_INIT (1 << OP_ALG_AS_SHIFT) 515 #define OP_ALG_AS_FINALIZE (2 << OP_ALG_AS_SHIFT) 516 #define OP_ALG_AS_INITFINAL (3 << OP_ALG_AS_SHIFT) 517 518 #define OP_ALG_ICV_SHIFT 1 519 #define OP_ALG_ICV_MASK (1 << OP_ALG_ICV_SHIFT) 520 #define OP_ALG_ICV_OFF (0 << OP_ALG_ICV_SHIFT) 521 #define OP_ALG_ICV_ON (1 << OP_ALG_ICV_SHIFT) 522 523 #define OP_ALG_DIR_SHIFT 0 524 #define OP_ALG_DIR_MASK 1 525 #define OP_ALG_DECRYPT 0 526 #define OP_ALG_ENCRYPT 1 527 528 /* PKHA algorithm type set */ 529 #define OP_ALG_PK 0x00800000 530 #define OP_ALG_PK_FUN_MASK 0x3f /* clrmem, modmath, or cpymem */ 531 532 /* PKHA mode modular-arithmetic functions */ 533 #define OP_ALG_PKMODE_MOD_EXPO 0x006 534 535 /* 536 * SEQ_IN_PTR Command Constructs 537 */ 538 539 /* Release Buffers */ 540 #define SQIN_RBS 0x04000000 541 542 /* Sequence pointer is really a descriptor */ 543 #define SQIN_INL 0x02000000 544 545 /* Sequence pointer is a scatter-gather table */ 546 #define SQIN_SGF 0x01000000 547 548 /* Appends to a previous pointer */ 549 #define SQIN_PRE 0x00800000 550 551 /* Use extended length following pointer */ 552 #define SQIN_EXT 0x00400000 553 554 /* Restore sequence with pointer/length */ 555 #define SQIN_RTO 0x00200000 556 557 /* Replace job descriptor */ 558 #define SQIN_RJD 0x00100000 559 560 #define SQIN_LEN_SHIFT 0 561 #define SQIN_LEN_MASK (0xffff << SQIN_LEN_SHIFT) 562 563 /* 564 * SEQ_OUT_PTR Command Constructs 565 */ 566 567 /* Sequence pointer is a scatter-gather table */ 568 #define SQOUT_SGF 0x01000000 569 570 /* Appends to a previous pointer */ 571 #define SQOUT_PRE SQIN_PRE 572 573 /* Restore sequence with pointer/length */ 574 #define SQOUT_RTO SQIN_RTO 575 576 /* Use extended length following pointer */ 577 #define SQOUT_EXT 0x00400000 578 579 #define SQOUT_LEN_SHIFT 0 580 #define SQOUT_LEN_MASK (0xffff << SQOUT_LEN_SHIFT) 581 582 /* 583 * MOVE Command Constructs 584 */ 585 586 #define MOVE_AUX_SHIFT 25 587 #define MOVE_AUX_MASK (3 << MOVE_AUX_SHIFT) 588 #define MOVE_AUX_MS (2 << MOVE_AUX_SHIFT) 589 #define MOVE_AUX_LS (1 << MOVE_AUX_SHIFT) 590 591 #define MOVE_WAITCOMP_SHIFT 24 592 #define MOVE_WAITCOMP_MASK (1 << MOVE_WAITCOMP_SHIFT) 593 #define MOVE_WAITCOMP (1 << MOVE_WAITCOMP_SHIFT) 594 595 #define MOVE_SRC_SHIFT 20 596 #define MOVE_SRC_MASK (0x0f << MOVE_SRC_SHIFT) 597 #define MOVE_SRC_CLASS1CTX (0x00 << MOVE_SRC_SHIFT) 598 #define MOVE_SRC_CLASS2CTX (0x01 << MOVE_SRC_SHIFT) 599 #define MOVE_SRC_OUTFIFO (0x02 << MOVE_SRC_SHIFT) 600 #define MOVE_SRC_DESCBUF (0x03 << MOVE_SRC_SHIFT) 601 #define MOVE_SRC_MATH0 (0x04 << MOVE_SRC_SHIFT) 602 #define MOVE_SRC_MATH1 (0x05 << MOVE_SRC_SHIFT) 603 #define MOVE_SRC_MATH2 (0x06 << MOVE_SRC_SHIFT) 604 #define MOVE_SRC_MATH3 (0x07 << MOVE_SRC_SHIFT) 605 #define MOVE_SRC_INFIFO (0x08 << MOVE_SRC_SHIFT) 606 #define MOVE_SRC_INFIFO_CL (0x09 << MOVE_SRC_SHIFT) 607 608 #define MOVE_DEST_SHIFT 16 609 #define MOVE_DEST_MASK (0x0f << MOVE_DEST_SHIFT) 610 #define MOVE_DEST_CLASS1CTX (0x00 << MOVE_DEST_SHIFT) 611 #define MOVE_DEST_CLASS2CTX (0x01 << MOVE_DEST_SHIFT) 612 #define MOVE_DEST_OUTFIFO (0x02 << MOVE_DEST_SHIFT) 613 #define MOVE_DEST_DESCBUF (0x03 << MOVE_DEST_SHIFT) 614 #define MOVE_DEST_MATH0 (0x04 << MOVE_DEST_SHIFT) 615 #define MOVE_DEST_MATH1 (0x05 << MOVE_DEST_SHIFT) 616 #define MOVE_DEST_MATH2 (0x06 << MOVE_DEST_SHIFT) 617 #define MOVE_DEST_MATH3 (0x07 << MOVE_DEST_SHIFT) 618 #define MOVE_DEST_CLASS1INFIFO (0x08 << MOVE_DEST_SHIFT) 619 #define MOVE_DEST_CLASS2INFIFO (0x09 << MOVE_DEST_SHIFT) 620 #define MOVE_DEST_INFIFO_NOINFO (0x0a << MOVE_DEST_SHIFT) 621 #define MOVE_DEST_PK_A (0x0c << MOVE_DEST_SHIFT) 622 #define MOVE_DEST_CLASS1KEY (0x0d << MOVE_DEST_SHIFT) 623 #define MOVE_DEST_CLASS2KEY (0x0e << MOVE_DEST_SHIFT) 624 625 #define MOVE_OFFSET_SHIFT 8 626 #define MOVE_OFFSET_MASK (0xff << MOVE_OFFSET_SHIFT) 627 628 #define MOVE_LEN_SHIFT 0 629 #define MOVE_LEN_MASK (0xff << MOVE_LEN_SHIFT) 630 631 #define MOVELEN_MRSEL_SHIFT 0 632 #define MOVELEN_MRSEL_MASK (0x3 << MOVE_LEN_SHIFT) 633 634 /* 635 * JUMP Command Constructs 636 */ 637 638 #define JUMP_CLASS_SHIFT 25 639 #define JUMP_CLASS_MASK (3 << JUMP_CLASS_SHIFT) 640 #define JUMP_CLASS_NONE 0 641 #define JUMP_CLASS_CLASS1 (1 << JUMP_CLASS_SHIFT) 642 #define JUMP_CLASS_CLASS2 (2 << JUMP_CLASS_SHIFT) 643 #define JUMP_CLASS_BOTH (3 << JUMP_CLASS_SHIFT) 644 645 #define JUMP_JSL_SHIFT 24 646 #define JUMP_JSL_MASK (1 << JUMP_JSL_SHIFT) 647 #define JUMP_JSL (1 << JUMP_JSL_SHIFT) 648 649 #define JUMP_TYPE_SHIFT 22 650 #define JUMP_TYPE_MASK (0x03 << JUMP_TYPE_SHIFT) 651 #define JUMP_TYPE_LOCAL (0x00 << JUMP_TYPE_SHIFT) 652 #define JUMP_TYPE_NONLOCAL (0x01 << JUMP_TYPE_SHIFT) 653 #define JUMP_TYPE_HALT (0x02 << JUMP_TYPE_SHIFT) 654 #define JUMP_TYPE_HALT_USER (0x03 << JUMP_TYPE_SHIFT) 655 656 #define JUMP_TEST_SHIFT 16 657 #define JUMP_TEST_MASK (0x03 << JUMP_TEST_SHIFT) 658 #define JUMP_TEST_ALL (0x00 << JUMP_TEST_SHIFT) 659 #define JUMP_TEST_INVALL (0x01 << JUMP_TEST_SHIFT) 660 #define JUMP_TEST_ANY (0x02 << JUMP_TEST_SHIFT) 661 #define JUMP_TEST_INVANY (0x03 << JUMP_TEST_SHIFT) 662 663 /* Condition codes. JSL bit is factored in */ 664 #define JUMP_COND_SHIFT 8 665 #define JUMP_COND_MASK (0x100ff << JUMP_COND_SHIFT) 666 #define JUMP_COND_PK_0 (0x80 << JUMP_COND_SHIFT) 667 #define JUMP_COND_PK_GCD_1 (0x40 << JUMP_COND_SHIFT) 668 #define JUMP_COND_PK_PRIME (0x20 << JUMP_COND_SHIFT) 669 #define JUMP_COND_MATH_N (0x08 << JUMP_COND_SHIFT) 670 #define JUMP_COND_MATH_Z (0x04 << JUMP_COND_SHIFT) 671 #define JUMP_COND_MATH_C (0x02 << JUMP_COND_SHIFT) 672 #define JUMP_COND_MATH_NV (0x01 << JUMP_COND_SHIFT) 673 674 #define JUMP_COND_JRP ((0x80 << JUMP_COND_SHIFT) | JUMP_JSL) 675 #define JUMP_COND_SHRD ((0x40 << JUMP_COND_SHIFT) | JUMP_JSL) 676 #define JUMP_COND_SELF ((0x20 << JUMP_COND_SHIFT) | JUMP_JSL) 677 #define JUMP_COND_CALM ((0x10 << JUMP_COND_SHIFT) | JUMP_JSL) 678 #define JUMP_COND_NIP ((0x08 << JUMP_COND_SHIFT) | JUMP_JSL) 679 #define JUMP_COND_NIFP ((0x04 << JUMP_COND_SHIFT) | JUMP_JSL) 680 #define JUMP_COND_NOP ((0x02 << JUMP_COND_SHIFT) | JUMP_JSL) 681 #define JUMP_COND_NCP ((0x01 << JUMP_COND_SHIFT) | JUMP_JSL) 682 683 #define JUMP_OFFSET_SHIFT 0 684 #define JUMP_OFFSET_MASK (0xff << JUMP_OFFSET_SHIFT) 685 686 #define OP_ALG_RNG4_SHIFT 4 687 #define OP_ALG_RNG4_MAS (0x1f3 << OP_ALG_RNG4_SHIFT) 688 #define OP_ALG_RNG4_SK (0x100 << OP_ALG_RNG4_SHIFT) 689 690 691 /* Structures for Protocol Data Blocks */ 692 struct __packed pdb_ecdsa_verify { 693 uint32_t pdb_hdr; 694 dma_addr_t dma_q; /* Pointer to q (elliptic curve) */ 695 dma_addr_t dma_r; /* Pointer to r (elliptic curve) */ 696 dma_addr_t dma_g_xy; /* Pointer to Gx,y (elliptic curve) */ 697 dma_addr_t dma_pkey; /* Pointer to Wx,y (public key) */ 698 dma_addr_t dma_hash; /* Pointer to hash input */ 699 dma_addr_t dma_c; /* Pointer to C_signature */ 700 dma_addr_t dma_d; /* Pointer to D_signature */ 701 dma_addr_t dma_buf; /* Pointer to 64-byte temp buffer */ 702 dma_addr_t dma_ab; /* Pointer to a,b (elliptic curve ) */ 703 uint32_t img_size; /* Length of Message */ 704 }; 705 706 struct __packed pdb_ecdsa_sign { 707 uint32_t pdb_hdr; 708 dma_addr_t dma_q; /* Pointer to q (elliptic curve) */ 709 dma_addr_t dma_r; /* Pointer to r (elliptic curve) */ 710 dma_addr_t dma_g_xy; /* Pointer to Gx,y (elliptic curve) */ 711 dma_addr_t dma_pri_key; /* Pointer to S (Private key) */ 712 dma_addr_t dma_hash; /* Pointer to hash input */ 713 dma_addr_t dma_c; /* Pointer to C_signature */ 714 dma_addr_t dma_d; /* Pointer to D_signature */ 715 dma_addr_t dma_ab; /* Pointer to a,b (elliptic curve ) */ 716 dma_addr_t dma_u; /* Pointer to Per Message Random */ 717 uint32_t img_size; /* Length of Message */ 718 }; 719 720 #define PDB_ECDSA_SGF_SHIFT 23 721 #define PDB_ECDSA_L_SHIFT 7 722 #define PDB_ECDSA_N_SHIFT 0 723 724 struct __packed pdb_mp_pub_k { 725 uint32_t pdb_hdr; 726 #define PDB_MP_PUB_K_SGF_SHIFT 31 727 dma_addr_t dma_pkey; /* Pointer to Wx,y (public key) */ 728 }; 729 730 struct __packed pdb_mp_sign { 731 uint32_t pdb_hdr; 732 #define PDB_MP_SIGN_SGF_SHIFT 28 733 dma_addr_t dma_addr_msg; /* Pointer to Message */ 734 dma_addr_t dma_addr_hash; /* Pointer to hash output */ 735 dma_addr_t dma_addr_c_sig; /* Pointer to C_signature */ 736 dma_addr_t dma_addr_d_sig; /* Pointer to D_signature */ 737 uint32_t img_size; /* Length of Message */ 738 }; 739 740 #define PDB_MP_CSEL_SHIFT 17 741 #define PDB_MP_CSEL_P256 0x3 << PDB_MP_CSEL_SHIFT /* P-256 */ 742 #define PDB_MP_CSEL_P384 0x4 << PDB_MP_CSEL_SHIFT /* P-384 */ 743 #define PDB_MP_CSEL_P521 0x5 << PDB_MP_CSEL_SHIFT /* P-521 */ 744 745 #endif /* DESC_H */ 746
