1 /*
2  *  Copyright (c) 2008 Silicon Graphics, Inc.  All Rights Reserved.
3  *
4  *  This program is free software; you can redistribute it and/or modify
5  *  it under the terms of the GNU Lesser General Public License as published by
6  *  the Free Software Foundation; either version 2.1 of the License, or
7  *  (at your option) any later version.
8  *
9  *  This program is distributed in the hope that it will be useful,
10  *  but WITHOUT ANY WARRANTY; without even the implied warranty of
11  *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
12  *  GNU Lesser General Public License for more details.
13  *
14  *  You should have received a copy of the GNU Lesser General Public License
15  *  along with this program; if not, write to the Free Software
16  *  Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307 USA
17  */
18 
19 #ifndef __GRU_INSTRUCTIONS_H__
20 #define __GRU_INSTRUCTIONS_H__
21 
22 extern int gru_check_status_proc(void *cb);
23 extern int gru_wait_proc(void *cb);
24 extern void gru_wait_abort_proc(void *cb);
25 
26 
27 
28 /*
29  * Architecture dependent functions
30  */
31 
32 #if defined(CONFIG_IA64)
33 #include <linux/compiler.h>
34 #include <asm/intrinsics.h>
35 #define __flush_cache(p)		ia64_fc((unsigned long)p)
36 /* Use volatile on IA64 to ensure ordering via st4.rel */
37 #define gru_ordered_store_ulong(p, v)					\
38 		do {							\
39 			barrier();					\
40 			*((volatile unsigned long *)(p)) = v; /* force st.rel */	\
41 		} while (0)
42 #elif defined(CONFIG_X86_64)
43 #define __flush_cache(p)		clflush(p)
44 #define gru_ordered_store_ulong(p, v)					\
45 		do {							\
46 			barrier();					\
47 			*(unsigned long *)p = v;			\
48 		} while (0)
49 #else
50 #error "Unsupported architecture"
51 #endif
52 
53 /*
54  * Control block status and exception codes
55  */
56 #define CBS_IDLE			0
57 #define CBS_EXCEPTION			1
58 #define CBS_ACTIVE			2
59 #define CBS_CALL_OS			3
60 
61 /* CB substatus bitmasks */
62 #define CBSS_MSG_QUEUE_MASK		7
63 #define CBSS_IMPLICIT_ABORT_ACTIVE_MASK	8
64 
65 /* CB substatus message queue values (low 3 bits of substatus) */
66 #define CBSS_NO_ERROR			0
67 #define CBSS_LB_OVERFLOWED		1
68 #define CBSS_QLIMIT_REACHED		2
69 #define CBSS_PAGE_OVERFLOW		3
70 #define CBSS_AMO_NACKED			4
71 #define CBSS_PUT_NACKED			5
72 
73 /*
74  * Structure used to fetch exception detail for CBs that terminate with
75  * CBS_EXCEPTION
76  */
77 struct control_block_extended_exc_detail {
78 	unsigned long	cb;
79 	int		opc;
80 	int		ecause;
81 	int		exopc;
82 	long		exceptdet0;
83 	int		exceptdet1;
84 	int		cbrstate;
85 	int		cbrexecstatus;
86 };
87 
88 /*
89  * Instruction formats
90  */
91 
92 /*
93  * Generic instruction format.
94  * This definition has precise bit field definitions.
95  */
96 struct gru_instruction_bits {
97     /* DW 0  - low */
98     unsigned int		icmd:      1;
99     unsigned char		ima:	   3;	/* CB_DelRep, unmapped mode */
100     unsigned char		reserved0: 4;
101     unsigned int		xtype:     3;
102     unsigned int		iaa0:      2;
103     unsigned int		iaa1:      2;
104     unsigned char		reserved1: 1;
105     unsigned char		opc:       8;	/* opcode */
106     unsigned char		exopc:     8;	/* extended opcode */
107     /* DW 0  - high */
108     unsigned int		idef2:    22;	/* TRi0 */
109     unsigned char		reserved2: 2;
110     unsigned char		istatus:   2;
111     unsigned char		isubstatus:4;
112     unsigned char		reserved3: 1;
113     unsigned char		tlb_fault_color: 1;
114     /* DW 1 */
115     unsigned long		idef4;		/* 42 bits: TRi1, BufSize */
116     /* DW 2-6 */
117     unsigned long		idef1;		/* BAddr0 */
118     unsigned long		idef5;		/* Nelem */
119     unsigned long		idef6;		/* Stride, Operand1 */
120     unsigned long		idef3;		/* BAddr1, Value, Operand2 */
121     unsigned long		reserved4;
122     /* DW 7 */
123     unsigned long		avalue;		 /* AValue */
124 };
125 
126 /*
127  * Generic instruction with friendlier names. This format is used
128  * for inline instructions.
129  */
130 struct gru_instruction {
131     /* DW 0 */
132     union {
133     	unsigned long		op64;    /* icmd,xtype,iaa0,ima,opc,tri0 */
134 	struct {
135 		unsigned int	op32;
136 		unsigned int	tri0;
137 	};
138     };
139     unsigned long		tri1_bufsize;		/* DW 1 */
140     unsigned long		baddr0;			/* DW 2 */
141     unsigned long		nelem;			/* DW 3 */
142     unsigned long		op1_stride;		/* DW 4 */
143     unsigned long		op2_value_baddr1;	/* DW 5 */
144     unsigned long		reserved0;		/* DW 6 */
145     unsigned long		avalue;			/* DW 7 */
146 };
147 
148 /* Some shifts and masks for the low 64 bits of a GRU command */
149 #define GRU_CB_ICMD_SHFT	0
150 #define GRU_CB_ICMD_MASK	0x1
151 #define GRU_CB_XTYPE_SHFT	8
152 #define GRU_CB_XTYPE_MASK	0x7
153 #define GRU_CB_IAA0_SHFT	11
154 #define GRU_CB_IAA0_MASK	0x3
155 #define GRU_CB_IAA1_SHFT	13
156 #define GRU_CB_IAA1_MASK	0x3
157 #define GRU_CB_IMA_SHFT		1
158 #define GRU_CB_IMA_MASK		0x3
159 #define GRU_CB_OPC_SHFT		16
160 #define GRU_CB_OPC_MASK		0xff
161 #define GRU_CB_EXOPC_SHFT	24
162 #define GRU_CB_EXOPC_MASK	0xff
163 #define GRU_IDEF2_SHFT		32
164 #define GRU_IDEF2_MASK		0x3ffff
165 #define GRU_ISTATUS_SHFT	56
166 #define GRU_ISTATUS_MASK	0x3
167 
168 /* GRU instruction opcodes (opc field) */
169 #define OP_NOP		0x00
170 #define OP_BCOPY	0x01
171 #define OP_VLOAD	0x02
172 #define OP_IVLOAD	0x03
173 #define OP_VSTORE	0x04
174 #define OP_IVSTORE	0x05
175 #define OP_VSET		0x06
176 #define OP_IVSET	0x07
177 #define OP_MESQ		0x08
178 #define OP_GAMXR	0x09
179 #define OP_GAMIR	0x0a
180 #define OP_GAMIRR	0x0b
181 #define OP_GAMER	0x0c
182 #define OP_GAMERR	0x0d
183 #define OP_BSTORE	0x0e
184 #define OP_VFLUSH	0x0f
185 
186 
187 /* Extended opcodes values (exopc field) */
188 
189 /* GAMIR - AMOs with implicit operands */
190 #define EOP_IR_FETCH	0x01 /* Plain fetch of memory */
191 #define EOP_IR_CLR	0x02 /* Fetch and clear */
192 #define EOP_IR_INC	0x05 /* Fetch and increment */
193 #define EOP_IR_DEC	0x07 /* Fetch and decrement */
194 #define EOP_IR_QCHK1	0x0d /* Queue check, 64 byte msg */
195 #define EOP_IR_QCHK2	0x0e /* Queue check, 128 byte msg */
196 
197 /* GAMIRR - Registered AMOs with implicit operands */
198 #define EOP_IRR_FETCH	0x01 /* Registered fetch of memory */
199 #define EOP_IRR_CLR	0x02 /* Registered fetch and clear */
200 #define EOP_IRR_INC	0x05 /* Registered fetch and increment */
201 #define EOP_IRR_DEC	0x07 /* Registered fetch and decrement */
202 #define EOP_IRR_DECZ	0x0f /* Registered fetch and decrement, update on zero*/
203 
204 /* GAMER - AMOs with explicit operands */
205 #define EOP_ER_SWAP	0x00 /* Exchange argument and memory */
206 #define EOP_ER_OR	0x01 /* Logical OR with memory */
207 #define EOP_ER_AND	0x02 /* Logical AND with memory */
208 #define EOP_ER_XOR	0x03 /* Logical XOR with memory */
209 #define EOP_ER_ADD	0x04 /* Add value to memory */
210 #define EOP_ER_CSWAP	0x08 /* Compare with operand2, write operand1 if match*/
211 #define EOP_ER_CADD	0x0c /* Queue check, operand1*64 byte msg */
212 
213 /* GAMERR - Registered AMOs with explicit operands */
214 #define EOP_ERR_SWAP	0x00 /* Exchange argument and memory */
215 #define EOP_ERR_OR	0x01 /* Logical OR with memory */
216 #define EOP_ERR_AND	0x02 /* Logical AND with memory */
217 #define EOP_ERR_XOR	0x03 /* Logical XOR with memory */
218 #define EOP_ERR_ADD	0x04 /* Add value to memory */
219 #define EOP_ERR_CSWAP	0x08 /* Compare with operand2, write operand1 if match*/
220 #define EOP_ERR_EPOLL	0x09 /* Poll for equality */
221 #define EOP_ERR_NPOLL	0x0a /* Poll for inequality */
222 
223 /* GAMXR - SGI Arithmetic unit */
224 #define EOP_XR_CSWAP	0x0b /* Masked compare exchange */
225 
226 
227 /* Transfer types (xtype field) */
228 #define XTYPE_B		0x0	/* byte */
229 #define XTYPE_S		0x1	/* short (2-byte) */
230 #define XTYPE_W		0x2	/* word (4-byte) */
231 #define XTYPE_DW	0x3	/* doubleword (8-byte) */
232 #define XTYPE_CL	0x6	/* cacheline (64-byte) */
233 
234 
235 /* Instruction access attributes (iaa0, iaa1 fields) */
236 #define IAA_RAM		0x0	/* normal cached RAM access */
237 #define IAA_NCRAM	0x2	/* noncoherent RAM access */
238 #define IAA_MMIO	0x1	/* noncoherent memory-mapped I/O space */
239 #define IAA_REGISTER	0x3	/* memory-mapped registers, etc. */
240 
241 
242 /* Instruction mode attributes (ima field) */
243 #define IMA_MAPPED	0x0	/* Virtual mode  */
244 #define IMA_CB_DELAY	0x1	/* hold read responses until status changes */
245 #define IMA_UNMAPPED	0x2	/* bypass the TLBs (OS only) */
246 #define IMA_INTERRUPT	0x4	/* Interrupt when instruction completes */
247 
248 /* CBE ecause bits */
249 #define CBE_CAUSE_RI				(1 << 0)
250 #define CBE_CAUSE_INVALID_INSTRUCTION		(1 << 1)
251 #define CBE_CAUSE_UNMAPPED_MODE_FORBIDDEN	(1 << 2)
252 #define CBE_CAUSE_PE_CHECK_DATA_ERROR		(1 << 3)
253 #define CBE_CAUSE_IAA_GAA_MISMATCH		(1 << 4)
254 #define CBE_CAUSE_DATA_SEGMENT_LIMIT_EXCEPTION	(1 << 5)
255 #define CBE_CAUSE_OS_FATAL_TLB_FAULT		(1 << 6)
256 #define CBE_CAUSE_EXECUTION_HW_ERROR		(1 << 7)
257 #define CBE_CAUSE_TLBHW_ERROR			(1 << 8)
258 #define CBE_CAUSE_RA_REQUEST_TIMEOUT		(1 << 9)
259 #define CBE_CAUSE_HA_REQUEST_TIMEOUT		(1 << 10)
260 #define CBE_CAUSE_RA_RESPONSE_FATAL		(1 << 11)
261 #define CBE_CAUSE_RA_RESPONSE_NON_FATAL		(1 << 12)
262 #define CBE_CAUSE_HA_RESPONSE_FATAL		(1 << 13)
263 #define CBE_CAUSE_HA_RESPONSE_NON_FATAL		(1 << 14)
264 #define CBE_CAUSE_ADDRESS_SPACE_DECODE_ERROR	(1 << 15)
265 #define CBE_CAUSE_PROTOCOL_STATE_DATA_ERROR	(1 << 16)
266 #define CBE_CAUSE_RA_RESPONSE_DATA_ERROR	(1 << 17)
267 #define CBE_CAUSE_HA_RESPONSE_DATA_ERROR	(1 << 18)
268 #define CBE_CAUSE_FORCED_ERROR			(1 << 19)
269 
270 /* CBE cbrexecstatus bits */
271 #define CBR_EXS_ABORT_OCC_BIT			0
272 #define CBR_EXS_INT_OCC_BIT			1
273 #define CBR_EXS_PENDING_BIT			2
274 #define CBR_EXS_QUEUED_BIT			3
275 #define CBR_EXS_TLB_INVAL_BIT			4
276 #define CBR_EXS_EXCEPTION_BIT			5
277 #define CBR_EXS_CB_INT_PENDING_BIT		6
278 
279 #define CBR_EXS_ABORT_OCC			(1 << CBR_EXS_ABORT_OCC_BIT)
280 #define CBR_EXS_INT_OCC				(1 << CBR_EXS_INT_OCC_BIT)
281 #define CBR_EXS_PENDING				(1 << CBR_EXS_PENDING_BIT)
282 #define CBR_EXS_QUEUED				(1 << CBR_EXS_QUEUED_BIT)
283 #define CBR_EXS_TLB_INVAL			(1 << CBR_EXS_TLB_INVAL_BIT)
284 #define CBR_EXS_EXCEPTION			(1 << CBR_EXS_EXCEPTION_BIT)
285 #define CBR_EXS_CB_INT_PENDING			(1 << CBR_EXS_CB_INT_PENDING_BIT)
286 
287 /*
288  * Exceptions are retried for the following cases. If any OTHER bits are set
289  * in ecause, the exception is not retryable.
290  */
291 #define EXCEPTION_RETRY_BITS (CBE_CAUSE_EXECUTION_HW_ERROR |		\
292 			      CBE_CAUSE_TLBHW_ERROR |			\
293 			      CBE_CAUSE_RA_REQUEST_TIMEOUT |		\
294 			      CBE_CAUSE_RA_RESPONSE_NON_FATAL |		\
295 			      CBE_CAUSE_HA_RESPONSE_NON_FATAL |		\
296 			      CBE_CAUSE_RA_RESPONSE_DATA_ERROR |	\
297 			      CBE_CAUSE_HA_RESPONSE_DATA_ERROR		\
298 			      )
299 
300 /* Message queue head structure */
301 union gru_mesqhead {
302 	unsigned long	val;
303 	struct {
304 		unsigned int	head;
305 		unsigned int	limit;
306 	};
307 };
308 
309 
310 /* Generate the low word of a GRU instruction */
311 static inline unsigned long
312 __opdword(unsigned char opcode, unsigned char exopc, unsigned char xtype,
313        unsigned char iaa0, unsigned char iaa1,
314        unsigned long idef2, unsigned char ima)
315 {
316     return (1 << GRU_CB_ICMD_SHFT) |
317 	   ((unsigned long)CBS_ACTIVE << GRU_ISTATUS_SHFT) |
318 	   (idef2<< GRU_IDEF2_SHFT) |
319 	   (iaa0 << GRU_CB_IAA0_SHFT) |
320 	   (iaa1 << GRU_CB_IAA1_SHFT) |
321 	   (ima << GRU_CB_IMA_SHFT) |
322 	   (xtype << GRU_CB_XTYPE_SHFT) |
323 	   (opcode << GRU_CB_OPC_SHFT) |
324 	   (exopc << GRU_CB_EXOPC_SHFT);
325 }
326 
327 /*
328  * Architecture specific intrinsics
329  */
330 static inline void gru_flush_cache(void *p)
331 {
332 	__flush_cache(p);
333 }
334 
335 /*
336  * Store the lower 64 bits of the command including the "start" bit. Then
337  * start the instruction executing.
338  */
339 static inline void gru_start_instruction(struct gru_instruction *ins, unsigned long op64)
340 {
341 	gru_ordered_store_ulong(ins, op64);
342 	mb();
343 	gru_flush_cache(ins);
344 }
345 
346 
347 /* Convert "hints" to IMA */
348 #define CB_IMA(h)		((h) | IMA_UNMAPPED)
349 
350 /* Convert data segment cache line index into TRI0 / TRI1 value */
351 #define GRU_DINDEX(i)		((i) * GRU_CACHE_LINE_BYTES)
352 
353 /* Inline functions for GRU instructions.
354  *     Note:
355  *     	- nelem and stride are in elements
356  *     	- tri0/tri1 is in bytes for the beginning of the data segment.
357  */
358 static inline void gru_vload_phys(void *cb, unsigned long gpa,
359 		unsigned int tri0, int iaa, unsigned long hints)
360 {
361 	struct gru_instruction *ins = (struct gru_instruction *)cb;
362 
363 	ins->baddr0 = (long)gpa | ((unsigned long)iaa << 62);
364 	ins->nelem = 1;
365 	ins->op1_stride = 1;
366 	gru_start_instruction(ins, __opdword(OP_VLOAD, 0, XTYPE_DW, iaa, 0,
367 					(unsigned long)tri0, CB_IMA(hints)));
368 }
369 
370 static inline void gru_vstore_phys(void *cb, unsigned long gpa,
371 		unsigned int tri0, int iaa, unsigned long hints)
372 {
373 	struct gru_instruction *ins = (struct gru_instruction *)cb;
374 
375 	ins->baddr0 = (long)gpa | ((unsigned long)iaa << 62);
376 	ins->nelem = 1;
377 	ins->op1_stride = 1;
378 	gru_start_instruction(ins, __opdword(OP_VSTORE, 0, XTYPE_DW, iaa, 0,
379 					(unsigned long)tri0, CB_IMA(hints)));
380 }
381 
382 static inline void gru_vload(void *cb, unsigned long mem_addr,
383 		unsigned int tri0, unsigned char xtype, unsigned long nelem,
384 		unsigned long stride, unsigned long hints)
385 {
386 	struct gru_instruction *ins = (struct gru_instruction *)cb;
387 
388 	ins->baddr0 = (long)mem_addr;
389 	ins->nelem = nelem;
390 	ins->op1_stride = stride;
391 	gru_start_instruction(ins, __opdword(OP_VLOAD, 0, xtype, IAA_RAM, 0,
392 					(unsigned long)tri0, CB_IMA(hints)));
393 }
394 
395 static inline void gru_vstore(void *cb, unsigned long mem_addr,
396 		unsigned int tri0, unsigned char xtype, unsigned long nelem,
397 		unsigned long stride, unsigned long hints)
398 {
399 	struct gru_instruction *ins = (void *)cb;
400 
401 	ins->baddr0 = (long)mem_addr;
402 	ins->nelem = nelem;
403 	ins->op1_stride = stride;
404 	gru_start_instruction(ins, __opdword(OP_VSTORE, 0, xtype, IAA_RAM, 0,
405 					tri0, CB_IMA(hints)));
406 }
407 
408 static inline void gru_ivload(void *cb, unsigned long mem_addr,
409 		unsigned int tri0, unsigned int tri1, unsigned char xtype,
410 		unsigned long nelem, unsigned long hints)
411 {
412 	struct gru_instruction *ins = (void *)cb;
413 
414 	ins->baddr0 = (long)mem_addr;
415 	ins->nelem = nelem;
416 	ins->tri1_bufsize = tri1;
417 	gru_start_instruction(ins, __opdword(OP_IVLOAD, 0, xtype, IAA_RAM, 0,
418 					tri0, CB_IMA(hints)));
419 }
420 
421 static inline void gru_ivstore(void *cb, unsigned long mem_addr,
422 		unsigned int tri0, unsigned int tri1,
423 		unsigned char xtype, unsigned long nelem, unsigned long hints)
424 {
425 	struct gru_instruction *ins = (void *)cb;
426 
427 	ins->baddr0 = (long)mem_addr;
428 	ins->nelem = nelem;
429 	ins->tri1_bufsize = tri1;
430 	gru_start_instruction(ins, __opdword(OP_IVSTORE, 0, xtype, IAA_RAM, 0,
431 					tri0, CB_IMA(hints)));
432 }
433 
434 static inline void gru_vset(void *cb, unsigned long mem_addr,
435 		unsigned long value, unsigned char xtype, unsigned long nelem,
436 		unsigned long stride, unsigned long hints)
437 {
438 	struct gru_instruction *ins = (void *)cb;
439 
440 	ins->baddr0 = (long)mem_addr;
441 	ins->op2_value_baddr1 = value;
442 	ins->nelem = nelem;
443 	ins->op1_stride = stride;
444 	gru_start_instruction(ins, __opdword(OP_VSET, 0, xtype, IAA_RAM, 0,
445 					 0, CB_IMA(hints)));
446 }
447 
448 static inline void gru_ivset(void *cb, unsigned long mem_addr,
449 		unsigned int tri1, unsigned long value, unsigned char xtype,
450 		unsigned long nelem, unsigned long hints)
451 {
452 	struct gru_instruction *ins = (void *)cb;
453 
454 	ins->baddr0 = (long)mem_addr;
455 	ins->op2_value_baddr1 = value;
456 	ins->nelem = nelem;
457 	ins->tri1_bufsize = tri1;
458 	gru_start_instruction(ins, __opdword(OP_IVSET, 0, xtype, IAA_RAM, 0,
459 					0, CB_IMA(hints)));
460 }
461 
462 static inline void gru_vflush(void *cb, unsigned long mem_addr,
463 		unsigned long nelem, unsigned char xtype, unsigned long stride,
464 		unsigned long hints)
465 {
466 	struct gru_instruction *ins = (void *)cb;
467 
468 	ins->baddr0 = (long)mem_addr;
469 	ins->op1_stride = stride;
470 	ins->nelem = nelem;
471 	gru_start_instruction(ins, __opdword(OP_VFLUSH, 0, xtype, IAA_RAM, 0,
472 					0, CB_IMA(hints)));
473 }
474 
475 static inline void gru_nop(void *cb, int hints)
476 {
477 	struct gru_instruction *ins = (void *)cb;
478 
479 	gru_start_instruction(ins, __opdword(OP_NOP, 0, 0, 0, 0, 0, CB_IMA(hints)));
480 }
481 
482 
483 static inline void gru_bcopy(void *cb, const unsigned long src,
484 		unsigned long dest,
485 		unsigned int tri0, unsigned int xtype, unsigned long nelem,
486 		unsigned int bufsize, unsigned long hints)
487 {
488 	struct gru_instruction *ins = (void *)cb;
489 
490 	ins->baddr0 = (long)src;
491 	ins->op2_value_baddr1 = (long)dest;
492 	ins->nelem = nelem;
493 	ins->tri1_bufsize = bufsize;
494 	gru_start_instruction(ins, __opdword(OP_BCOPY, 0, xtype, IAA_RAM,
495 					IAA_RAM, tri0, CB_IMA(hints)));
496 }
497 
498 static inline void gru_bstore(void *cb, const unsigned long src,
499 		unsigned long dest, unsigned int tri0, unsigned int xtype,
500 		unsigned long nelem, unsigned long hints)
501 {
502 	struct gru_instruction *ins = (void *)cb;
503 
504 	ins->baddr0 = (long)src;
505 	ins->op2_value_baddr1 = (long)dest;
506 	ins->nelem = nelem;
507 	gru_start_instruction(ins, __opdword(OP_BSTORE, 0, xtype, 0, IAA_RAM,
508 					tri0, CB_IMA(hints)));
509 }
510 
511 static inline void gru_gamir(void *cb, int exopc, unsigned long src,
512 		unsigned int xtype, unsigned long hints)
513 {
514 	struct gru_instruction *ins = (void *)cb;
515 
516 	ins->baddr0 = (long)src;
517 	gru_start_instruction(ins, __opdword(OP_GAMIR, exopc, xtype, IAA_RAM, 0,
518 					0, CB_IMA(hints)));
519 }
520 
521 static inline void gru_gamirr(void *cb, int exopc, unsigned long src,
522 		unsigned int xtype, unsigned long hints)
523 {
524 	struct gru_instruction *ins = (void *)cb;
525 
526 	ins->baddr0 = (long)src;
527 	gru_start_instruction(ins, __opdword(OP_GAMIRR, exopc, xtype, IAA_RAM, 0,
528 					0, CB_IMA(hints)));
529 }
530 
531 static inline void gru_gamer(void *cb, int exopc, unsigned long src,
532 		unsigned int xtype,
533 		unsigned long operand1, unsigned long operand2,
534 		unsigned long hints)
535 {
536 	struct gru_instruction *ins = (void *)cb;
537 
538 	ins->baddr0 = (long)src;
539 	ins->op1_stride = operand1;
540 	ins->op2_value_baddr1 = operand2;
541 	gru_start_instruction(ins, __opdword(OP_GAMER, exopc, xtype, IAA_RAM, 0,
542 					0, CB_IMA(hints)));
543 }
544 
545 static inline void gru_gamerr(void *cb, int exopc, unsigned long src,
546 		unsigned int xtype, unsigned long operand1,
547 		unsigned long operand2, unsigned long hints)
548 {
549 	struct gru_instruction *ins = (void *)cb;
550 
551 	ins->baddr0 = (long)src;
552 	ins->op1_stride = operand1;
553 	ins->op2_value_baddr1 = operand2;
554 	gru_start_instruction(ins, __opdword(OP_GAMERR, exopc, xtype, IAA_RAM, 0,
555 					0, CB_IMA(hints)));
556 }
557 
558 static inline void gru_gamxr(void *cb, unsigned long src,
559 		unsigned int tri0, unsigned long hints)
560 {
561 	struct gru_instruction *ins = (void *)cb;
562 
563 	ins->baddr0 = (long)src;
564 	ins->nelem = 4;
565 	gru_start_instruction(ins, __opdword(OP_GAMXR, EOP_XR_CSWAP, XTYPE_DW,
566 				 IAA_RAM, 0, 0, CB_IMA(hints)));
567 }
568 
569 static inline void gru_mesq(void *cb, unsigned long queue,
570 		unsigned long tri0, unsigned long nelem,
571 		unsigned long hints)
572 {
573 	struct gru_instruction *ins = (void *)cb;
574 
575 	ins->baddr0 = (long)queue;
576 	ins->nelem = nelem;
577 	gru_start_instruction(ins, __opdword(OP_MESQ, 0, XTYPE_CL, IAA_RAM, 0,
578 					tri0, CB_IMA(hints)));
579 }
580 
581 static inline unsigned long gru_get_amo_value(void *cb)
582 {
583 	struct gru_instruction *ins = (void *)cb;
584 
585 	return ins->avalue;
586 }
587 
588 static inline int gru_get_amo_value_head(void *cb)
589 {
590 	struct gru_instruction *ins = (void *)cb;
591 
592 	return ins->avalue & 0xffffffff;
593 }
594 
595 static inline int gru_get_amo_value_limit(void *cb)
596 {
597 	struct gru_instruction *ins = (void *)cb;
598 
599 	return ins->avalue >> 32;
600 }
601 
602 static inline union gru_mesqhead  gru_mesq_head(int head, int limit)
603 {
604 	union gru_mesqhead mqh;
605 
606 	mqh.head = head;
607 	mqh.limit = limit;
608 	return mqh;
609 }
610 
611 /*
612  * Get struct control_block_extended_exc_detail for CB.
613  */
614 extern int gru_get_cb_exception_detail(void *cb,
615 		       struct control_block_extended_exc_detail *excdet);
616 
617 #define GRU_EXC_STR_SIZE		256
618 
619 
620 /*
621  * Control block definition for checking status
622  */
623 struct gru_control_block_status {
624 	unsigned int	icmd		:1;
625 	unsigned int	ima		:3;
626 	unsigned int	reserved0	:4;
627 	unsigned int	unused1		:24;
628 	unsigned int	unused2		:24;
629 	unsigned int	istatus		:2;
630 	unsigned int	isubstatus	:4;
631 	unsigned int	unused3		:2;
632 };
633 
634 /* Get CB status */
635 static inline int gru_get_cb_status(void *cb)
636 {
637 	struct gru_control_block_status *cbs = (void *)cb;
638 
639 	return cbs->istatus;
640 }
641 
642 /* Get CB message queue substatus */
643 static inline int gru_get_cb_message_queue_substatus(void *cb)
644 {
645 	struct gru_control_block_status *cbs = (void *)cb;
646 
647 	return cbs->isubstatus & CBSS_MSG_QUEUE_MASK;
648 }
649 
650 /* Get CB substatus */
651 static inline int gru_get_cb_substatus(void *cb)
652 {
653 	struct gru_control_block_status *cbs = (void *)cb;
654 
655 	return cbs->isubstatus;
656 }
657 
658 /*
659  * User interface to check an instruction status. UPM and exceptions
660  * are handled automatically. However, this function does NOT wait
661  * for an active instruction to complete.
662  *
663  */
664 static inline int gru_check_status(void *cb)
665 {
666 	struct gru_control_block_status *cbs = (void *)cb;
667 	int ret;
668 
669 	ret = cbs->istatus;
670 	if (ret != CBS_ACTIVE)
671 		ret = gru_check_status_proc(cb);
672 	return ret;
673 }
674 
675 /*
676  * User interface (via inline function) to wait for an instruction
677  * to complete. Completion status (IDLE or EXCEPTION is returned
678  * to the user. Exception due to hardware errors are automatically
679  * retried before returning an exception.
680  *
681  */
682 static inline int gru_wait(void *cb)
683 {
684 	return gru_wait_proc(cb);
685 }
686 
687 /*
688  * Wait for CB to complete. Aborts program if error. (Note: error does NOT
689  * mean TLB mis - only fatal errors such as memory parity error or user
690  * bugs will cause termination.
691  */
692 static inline void gru_wait_abort(void *cb)
693 {
694 	gru_wait_abort_proc(cb);
695 }
696 
697 /*
698  * Get a pointer to the start of a gseg
699  * 	p	- Any valid pointer within the gseg
700  */
701 static inline void *gru_get_gseg_pointer (void *p)
702 {
703 	return (void *)((unsigned long)p & ~(GRU_GSEG_PAGESIZE - 1));
704 }
705 
706 /*
707  * Get a pointer to a control block
708  * 	gseg	- GSeg address returned from gru_get_thread_gru_segment()
709  * 	index	- index of desired CB
710  */
711 static inline void *gru_get_cb_pointer(void *gseg,
712 						      int index)
713 {
714 	return gseg + GRU_CB_BASE + index * GRU_HANDLE_STRIDE;
715 }
716 
717 /*
718  * Get a pointer to a cacheline in the data segment portion of a GSeg
719  * 	gseg	- GSeg address returned from gru_get_thread_gru_segment()
720  * 	index	- index of desired cache line
721  */
722 static inline void *gru_get_data_pointer(void *gseg, int index)
723 {
724 	return gseg + GRU_DS_BASE + index * GRU_CACHE_LINE_BYTES;
725 }
726 
727 /*
728  * Convert a vaddr into the tri index within the GSEG
729  * 	vaddr		- virtual address of within gseg
730  */
731 static inline int gru_get_tri(void *vaddr)
732 {
733 	return ((unsigned long)vaddr & (GRU_GSEG_PAGESIZE - 1)) - GRU_DS_BASE;
734 }
735 #endif		/* __GRU_INSTRUCTIONS_H__ */
736