xref: /openbmc/u-boot/drivers/crypto/fsl/desc.h (revision e3963c09)
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