gru_instructions.h revision 289750d1f1fd4a715baa2a2c6dd0cec2b8317fd7
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
22extern int gru_check_status_proc(void *cb);
23extern int gru_wait_proc(void *cb);
24extern 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_int(p, v)					\
38		do {							\
39			barrier();					\
40			*((volatile int *)(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_int(p, v)					\
45		do {							\
46			barrier();					\
47			*(int *)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 */
77struct 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 */
96struct 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 */
130struct gru_instruction {
131    /* DW 0 */
132    unsigned int		op32;    /* icmd,xtype,iaa0,ima,opc */
133    unsigned int		tri0;
134    unsigned long		tri1_bufsize;		/* DW 1 */
135    unsigned long		baddr0;			/* DW 2 */
136    unsigned long		nelem;			/* DW 3 */
137    unsigned long		op1_stride;		/* DW 4 */
138    unsigned long		op2_value_baddr1;	/* DW 5 */
139    unsigned long		reserved0;		/* DW 6 */
140    unsigned long		avalue;			/* DW 7 */
141};
142
143/* Some shifts and masks for the low 32 bits of a GRU command */
144#define GRU_CB_ICMD_SHFT	0
145#define GRU_CB_ICMD_MASK	0x1
146#define GRU_CB_XTYPE_SHFT	8
147#define GRU_CB_XTYPE_MASK	0x7
148#define GRU_CB_IAA0_SHFT	11
149#define GRU_CB_IAA0_MASK	0x3
150#define GRU_CB_IAA1_SHFT	13
151#define GRU_CB_IAA1_MASK	0x3
152#define GRU_CB_IMA_SHFT		1
153#define GRU_CB_IMA_MASK		0x3
154#define GRU_CB_OPC_SHFT		16
155#define GRU_CB_OPC_MASK		0xff
156#define GRU_CB_EXOPC_SHFT	24
157#define GRU_CB_EXOPC_MASK	0xff
158
159/* GRU instruction opcodes (opc field) */
160#define OP_NOP		0x00
161#define OP_BCOPY	0x01
162#define OP_VLOAD	0x02
163#define OP_IVLOAD	0x03
164#define OP_VSTORE	0x04
165#define OP_IVSTORE	0x05
166#define OP_VSET		0x06
167#define OP_IVSET	0x07
168#define OP_MESQ		0x08
169#define OP_GAMXR	0x09
170#define OP_GAMIR	0x0a
171#define OP_GAMIRR	0x0b
172#define OP_GAMER	0x0c
173#define OP_GAMERR	0x0d
174#define OP_BSTORE	0x0e
175#define OP_VFLUSH	0x0f
176
177
178/* Extended opcodes values (exopc field) */
179
180/* GAMIR - AMOs with implicit operands */
181#define EOP_IR_FETCH	0x01 /* Plain fetch of memory */
182#define EOP_IR_CLR	0x02 /* Fetch and clear */
183#define EOP_IR_INC	0x05 /* Fetch and increment */
184#define EOP_IR_DEC	0x07 /* Fetch and decrement */
185#define EOP_IR_QCHK1	0x0d /* Queue check, 64 byte msg */
186#define EOP_IR_QCHK2	0x0e /* Queue check, 128 byte msg */
187
188/* GAMIRR - Registered AMOs with implicit operands */
189#define EOP_IRR_FETCH	0x01 /* Registered fetch of memory */
190#define EOP_IRR_CLR	0x02 /* Registered fetch and clear */
191#define EOP_IRR_INC	0x05 /* Registered fetch and increment */
192#define EOP_IRR_DEC	0x07 /* Registered fetch and decrement */
193#define EOP_IRR_DECZ	0x0f /* Registered fetch and decrement, update on zero*/
194
195/* GAMER - AMOs with explicit operands */
196#define EOP_ER_SWAP	0x00 /* Exchange argument and memory */
197#define EOP_ER_OR	0x01 /* Logical OR with memory */
198#define EOP_ER_AND	0x02 /* Logical AND with memory */
199#define EOP_ER_XOR	0x03 /* Logical XOR with memory */
200#define EOP_ER_ADD	0x04 /* Add value to memory */
201#define EOP_ER_CSWAP	0x08 /* Compare with operand2, write operand1 if match*/
202#define EOP_ER_CADD	0x0c /* Queue check, operand1*64 byte msg */
203
204/* GAMERR - Registered AMOs with explicit operands */
205#define EOP_ERR_SWAP	0x00 /* Exchange argument and memory */
206#define EOP_ERR_OR	0x01 /* Logical OR with memory */
207#define EOP_ERR_AND	0x02 /* Logical AND with memory */
208#define EOP_ERR_XOR	0x03 /* Logical XOR with memory */
209#define EOP_ERR_ADD	0x04 /* Add value to memory */
210#define EOP_ERR_CSWAP	0x08 /* Compare with operand2, write operand1 if match*/
211#define EOP_ERR_EPOLL	0x09 /* Poll for equality */
212#define EOP_ERR_NPOLL	0x0a /* Poll for inequality */
213
214/* GAMXR - SGI Arithmetic unit */
215#define EOP_XR_CSWAP	0x0b /* Masked compare exchange */
216
217
218/* Transfer types (xtype field) */
219#define XTYPE_B		0x0	/* byte */
220#define XTYPE_S		0x1	/* short (2-byte) */
221#define XTYPE_W		0x2	/* word (4-byte) */
222#define XTYPE_DW	0x3	/* doubleword (8-byte) */
223#define XTYPE_CL	0x6	/* cacheline (64-byte) */
224
225
226/* Instruction access attributes (iaa0, iaa1 fields) */
227#define IAA_RAM		0x0	/* normal cached RAM access */
228#define IAA_NCRAM	0x2	/* noncoherent RAM access */
229#define IAA_MMIO	0x1	/* noncoherent memory-mapped I/O space */
230#define IAA_REGISTER	0x3	/* memory-mapped registers, etc. */
231
232
233/* Instruction mode attributes (ima field) */
234#define IMA_MAPPED	0x0	/* Virtual mode  */
235#define IMA_CB_DELAY	0x1	/* hold read responses until status changes */
236#define IMA_UNMAPPED	0x2	/* bypass the TLBs (OS only) */
237#define IMA_INTERRUPT	0x4	/* Interrupt when instruction completes */
238
239/* CBE ecause bits */
240#define CBE_CAUSE_RI				(1 << 0)
241#define CBE_CAUSE_INVALID_INSTRUCTION		(1 << 1)
242#define CBE_CAUSE_UNMAPPED_MODE_FORBIDDEN	(1 << 2)
243#define CBE_CAUSE_PE_CHECK_DATA_ERROR		(1 << 3)
244#define CBE_CAUSE_IAA_GAA_MISMATCH		(1 << 4)
245#define CBE_CAUSE_DATA_SEGMENT_LIMIT_EXCEPTION	(1 << 5)
246#define CBE_CAUSE_OS_FATAL_TLB_FAULT		(1 << 6)
247#define CBE_CAUSE_EXECUTION_HW_ERROR		(1 << 7)
248#define CBE_CAUSE_TLBHW_ERROR			(1 << 8)
249#define CBE_CAUSE_RA_REQUEST_TIMEOUT		(1 << 9)
250#define CBE_CAUSE_HA_REQUEST_TIMEOUT		(1 << 10)
251#define CBE_CAUSE_RA_RESPONSE_FATAL		(1 << 11)
252#define CBE_CAUSE_RA_RESPONSE_NON_FATAL		(1 << 12)
253#define CBE_CAUSE_HA_RESPONSE_FATAL		(1 << 13)
254#define CBE_CAUSE_HA_RESPONSE_NON_FATAL		(1 << 14)
255#define CBE_CAUSE_ADDRESS_SPACE_DECODE_ERROR	(1 << 15)
256#define CBE_CAUSE_PROTOCOL_STATE_DATA_ERROR	(1 << 16)
257#define CBE_CAUSE_RA_RESPONSE_DATA_ERROR	(1 << 17)
258#define CBE_CAUSE_HA_RESPONSE_DATA_ERROR	(1 << 18)
259
260/* CBE cbrexecstatus bits */
261#define CBR_EXS_ABORT_OCC_BIT			0
262#define CBR_EXS_INT_OCC_BIT			1
263#define CBR_EXS_PENDING_BIT			2
264#define CBR_EXS_QUEUED_BIT			3
265#define CBR_EXS_TLB_INVAL_BIT			4
266#define CBR_EXS_EXCEPTION_BIT			5
267
268#define CBR_EXS_ABORT_OCC			(1 << CBR_EXS_ABORT_OCC_BIT)
269#define CBR_EXS_INT_OCC				(1 << CBR_EXS_INT_OCC_BIT)
270#define CBR_EXS_PENDING				(1 << CBR_EXS_PENDING_BIT)
271#define CBR_EXS_QUEUED				(1 << CBR_EXS_QUEUED_BIT)
272#define CBR_TLB_INVAL				(1 << CBR_EXS_TLB_INVAL_BIT)
273#define CBR_EXS_EXCEPTION			(1 << CBR_EXS_EXCEPTION_BIT)
274
275/*
276 * Exceptions are retried for the following cases. If any OTHER bits are set
277 * in ecause, the exception is not retryable.
278 */
279#define EXCEPTION_RETRY_BITS (CBE_CAUSE_EXECUTION_HW_ERROR |		\
280			      CBE_CAUSE_TLBHW_ERROR |			\
281			      CBE_CAUSE_RA_REQUEST_TIMEOUT |		\
282			      CBE_CAUSE_RA_RESPONSE_NON_FATAL |		\
283			      CBE_CAUSE_HA_RESPONSE_NON_FATAL |		\
284			      CBE_CAUSE_RA_RESPONSE_DATA_ERROR |	\
285			      CBE_CAUSE_HA_RESPONSE_DATA_ERROR		\
286			      )
287
288/* Message queue head structure */
289union gru_mesqhead {
290	unsigned long	val;
291	struct {
292		unsigned int	head;
293		unsigned int	limit;
294	};
295};
296
297
298/* Generate the low word of a GRU instruction */
299static inline unsigned int
300__opword(unsigned char opcode, unsigned char exopc, unsigned char xtype,
301       unsigned char iaa0, unsigned char iaa1,
302       unsigned char ima)
303{
304    return (1 << GRU_CB_ICMD_SHFT) |
305	   (iaa0 << GRU_CB_IAA0_SHFT) |
306	   (iaa1 << GRU_CB_IAA1_SHFT) |
307	   (ima << GRU_CB_IMA_SHFT) |
308	   (xtype << GRU_CB_XTYPE_SHFT) |
309	   (opcode << GRU_CB_OPC_SHFT) |
310	   (exopc << GRU_CB_EXOPC_SHFT);
311}
312
313/*
314 * Architecture specific intrinsics
315 */
316static inline void gru_flush_cache(void *p)
317{
318	__flush_cache(p);
319}
320
321/*
322 * Store the lower 32 bits of the command including the "start" bit. Then
323 * start the instruction executing.
324 */
325static inline void gru_start_instruction(struct gru_instruction *ins, int op32)
326{
327	gru_ordered_store_int(ins, op32);
328	gru_flush_cache(ins);
329}
330
331
332/* Convert "hints" to IMA */
333#define CB_IMA(h)		((h) | IMA_UNMAPPED)
334
335/* Convert data segment cache line index into TRI0 / TRI1 value */
336#define GRU_DINDEX(i)		((i) * GRU_CACHE_LINE_BYTES)
337
338/* Inline functions for GRU instructions.
339 *     Note:
340 *     	- nelem and stride are in elements
341 *     	- tri0/tri1 is in bytes for the beginning of the data segment.
342 */
343static inline void gru_vload_phys(void *cb, unsigned long gpa,
344		unsigned int tri0, int iaa, unsigned long hints)
345{
346	struct gru_instruction *ins = (struct gru_instruction *)cb;
347
348	ins->baddr0 = (long)gpa | ((unsigned long)iaa << 62);
349	ins->nelem = 1;
350	ins->tri0 = tri0;
351	ins->op1_stride = 1;
352	gru_start_instruction(ins, __opword(OP_VLOAD, 0, XTYPE_DW, iaa, 0,
353					CB_IMA(hints)));
354}
355
356static inline void gru_vload(void *cb, unsigned long mem_addr,
357		unsigned int tri0, unsigned char xtype, unsigned long nelem,
358		unsigned long stride, unsigned long hints)
359{
360	struct gru_instruction *ins = (struct gru_instruction *)cb;
361
362	ins->baddr0 = (long)mem_addr;
363	ins->nelem = nelem;
364	ins->tri0 = tri0;
365	ins->op1_stride = stride;
366	gru_start_instruction(ins, __opword(OP_VLOAD, 0, xtype, IAA_RAM, 0,
367					CB_IMA(hints)));
368}
369
370static inline void gru_vstore(void *cb, unsigned long mem_addr,
371		unsigned int tri0, unsigned char xtype, unsigned long nelem,
372		unsigned long stride, unsigned long hints)
373{
374	struct gru_instruction *ins = (void *)cb;
375
376	ins->baddr0 = (long)mem_addr;
377	ins->nelem = nelem;
378	ins->tri0 = tri0;
379	ins->op1_stride = stride;
380	gru_start_instruction(ins, __opword(OP_VSTORE, 0, xtype, IAA_RAM, 0,
381					CB_IMA(hints)));
382}
383
384static inline void gru_ivload(void *cb, unsigned long mem_addr,
385		unsigned int tri0, unsigned int tri1, unsigned char xtype,
386		unsigned long nelem, unsigned long hints)
387{
388	struct gru_instruction *ins = (void *)cb;
389
390	ins->baddr0 = (long)mem_addr;
391	ins->nelem = nelem;
392	ins->tri0 = tri0;
393	ins->tri1_bufsize = tri1;
394	gru_start_instruction(ins, __opword(OP_IVLOAD, 0, xtype, IAA_RAM, 0,
395					CB_IMA(hints)));
396}
397
398static inline void gru_ivstore(void *cb, unsigned long mem_addr,
399		unsigned int tri0, unsigned int tri1,
400		unsigned char xtype, unsigned long nelem, unsigned long hints)
401{
402	struct gru_instruction *ins = (void *)cb;
403
404	ins->baddr0 = (long)mem_addr;
405	ins->nelem = nelem;
406	ins->tri0 = tri0;
407	ins->tri1_bufsize = tri1;
408	gru_start_instruction(ins, __opword(OP_IVSTORE, 0, xtype, IAA_RAM, 0,
409					CB_IMA(hints)));
410}
411
412static inline void gru_vset(void *cb, unsigned long mem_addr,
413		unsigned long value, unsigned char xtype, unsigned long nelem,
414		unsigned long stride, unsigned long hints)
415{
416	struct gru_instruction *ins = (void *)cb;
417
418	ins->baddr0 = (long)mem_addr;
419	ins->op2_value_baddr1 = value;
420	ins->nelem = nelem;
421	ins->op1_stride = stride;
422	gru_start_instruction(ins, __opword(OP_VSET, 0, xtype, IAA_RAM, 0,
423					 CB_IMA(hints)));
424}
425
426static inline void gru_ivset(void *cb, unsigned long mem_addr,
427		unsigned int tri1, unsigned long value, unsigned char xtype,
428		unsigned long nelem, unsigned long hints)
429{
430	struct gru_instruction *ins = (void *)cb;
431
432	ins->baddr0 = (long)mem_addr;
433	ins->op2_value_baddr1 = value;
434	ins->nelem = nelem;
435	ins->tri1_bufsize = tri1;
436	gru_start_instruction(ins, __opword(OP_IVSET, 0, xtype, IAA_RAM, 0,
437					CB_IMA(hints)));
438}
439
440static inline void gru_vflush(void *cb, unsigned long mem_addr,
441		unsigned long nelem, unsigned char xtype, unsigned long stride,
442		unsigned long hints)
443{
444	struct gru_instruction *ins = (void *)cb;
445
446	ins->baddr0 = (long)mem_addr;
447	ins->op1_stride = stride;
448	ins->nelem = nelem;
449	gru_start_instruction(ins, __opword(OP_VFLUSH, 0, xtype, IAA_RAM, 0,
450					CB_IMA(hints)));
451}
452
453static inline void gru_nop(void *cb, int hints)
454{
455	struct gru_instruction *ins = (void *)cb;
456
457	gru_start_instruction(ins, __opword(OP_NOP, 0, 0, 0, 0, CB_IMA(hints)));
458}
459
460
461static inline void gru_bcopy(void *cb, const unsigned long src,
462		unsigned long dest,
463		unsigned int tri0, unsigned int xtype, unsigned long nelem,
464		unsigned int bufsize, unsigned long hints)
465{
466	struct gru_instruction *ins = (void *)cb;
467
468	ins->baddr0 = (long)src;
469	ins->op2_value_baddr1 = (long)dest;
470	ins->nelem = nelem;
471	ins->tri0 = tri0;
472	ins->tri1_bufsize = bufsize;
473	gru_start_instruction(ins, __opword(OP_BCOPY, 0, xtype, IAA_RAM,
474					IAA_RAM, CB_IMA(hints)));
475}
476
477static inline void gru_bstore(void *cb, const unsigned long src,
478		unsigned long dest, unsigned int tri0, unsigned int xtype,
479		unsigned long nelem, unsigned long hints)
480{
481	struct gru_instruction *ins = (void *)cb;
482
483	ins->baddr0 = (long)src;
484	ins->op2_value_baddr1 = (long)dest;
485	ins->nelem = nelem;
486	ins->tri0 = tri0;
487	gru_start_instruction(ins, __opword(OP_BSTORE, 0, xtype, 0, IAA_RAM,
488					CB_IMA(hints)));
489}
490
491static inline void gru_gamir(void *cb, int exopc, unsigned long src,
492		unsigned int xtype, unsigned long hints)
493{
494	struct gru_instruction *ins = (void *)cb;
495
496	ins->baddr0 = (long)src;
497	gru_start_instruction(ins, __opword(OP_GAMIR, exopc, xtype, IAA_RAM, 0,
498					CB_IMA(hints)));
499}
500
501static inline void gru_gamirr(void *cb, int exopc, unsigned long src,
502		unsigned int xtype, unsigned long hints)
503{
504	struct gru_instruction *ins = (void *)cb;
505
506	ins->baddr0 = (long)src;
507	gru_start_instruction(ins, __opword(OP_GAMIRR, exopc, xtype, IAA_RAM, 0,
508					CB_IMA(hints)));
509}
510
511static inline void gru_gamer(void *cb, int exopc, unsigned long src,
512		unsigned int xtype,
513		unsigned long operand1, unsigned long operand2,
514		unsigned long hints)
515{
516	struct gru_instruction *ins = (void *)cb;
517
518	ins->baddr0 = (long)src;
519	ins->op1_stride = operand1;
520	ins->op2_value_baddr1 = operand2;
521	gru_start_instruction(ins, __opword(OP_GAMER, exopc, xtype, IAA_RAM, 0,
522					CB_IMA(hints)));
523}
524
525static inline void gru_gamerr(void *cb, int exopc, unsigned long src,
526		unsigned int xtype, unsigned long operand1,
527		unsigned long operand2, unsigned long hints)
528{
529	struct gru_instruction *ins = (void *)cb;
530
531	ins->baddr0 = (long)src;
532	ins->op1_stride = operand1;
533	ins->op2_value_baddr1 = operand2;
534	gru_start_instruction(ins, __opword(OP_GAMERR, exopc, xtype, IAA_RAM, 0,
535					CB_IMA(hints)));
536}
537
538static inline void gru_gamxr(void *cb, unsigned long src,
539		unsigned int tri0, unsigned long hints)
540{
541	struct gru_instruction *ins = (void *)cb;
542
543	ins->baddr0 = (long)src;
544	ins->nelem = 4;
545	gru_start_instruction(ins, __opword(OP_GAMXR, EOP_XR_CSWAP, XTYPE_DW,
546				 IAA_RAM, 0, CB_IMA(hints)));
547}
548
549static inline void gru_mesq(void *cb, unsigned long queue,
550		unsigned long tri0, unsigned long nelem,
551		unsigned long hints)
552{
553	struct gru_instruction *ins = (void *)cb;
554
555	ins->baddr0 = (long)queue;
556	ins->nelem = nelem;
557	ins->tri0 = tri0;
558	gru_start_instruction(ins, __opword(OP_MESQ, 0, XTYPE_CL, IAA_RAM, 0,
559					CB_IMA(hints)));
560}
561
562static inline unsigned long gru_get_amo_value(void *cb)
563{
564	struct gru_instruction *ins = (void *)cb;
565
566	return ins->avalue;
567}
568
569static inline int gru_get_amo_value_head(void *cb)
570{
571	struct gru_instruction *ins = (void *)cb;
572
573	return ins->avalue & 0xffffffff;
574}
575
576static inline int gru_get_amo_value_limit(void *cb)
577{
578	struct gru_instruction *ins = (void *)cb;
579
580	return ins->avalue >> 32;
581}
582
583static inline union gru_mesqhead  gru_mesq_head(int head, int limit)
584{
585	union gru_mesqhead mqh;
586
587	mqh.head = head;
588	mqh.limit = limit;
589	return mqh;
590}
591
592/*
593 * Get struct control_block_extended_exc_detail for CB.
594 */
595extern int gru_get_cb_exception_detail(void *cb,
596		       struct control_block_extended_exc_detail *excdet);
597
598#define GRU_EXC_STR_SIZE		256
599
600
601/*
602 * Control block definition for checking status
603 */
604struct gru_control_block_status {
605	unsigned int	icmd		:1;
606	unsigned int	ima		:3;
607	unsigned int	reserved0	:4;
608	unsigned int	unused1		:24;
609	unsigned int	unused2		:24;
610	unsigned int	istatus		:2;
611	unsigned int	isubstatus	:4;
612	unsigned int	unused3		:2;
613};
614
615/* Get CB status */
616static inline int gru_get_cb_status(void *cb)
617{
618	struct gru_control_block_status *cbs = (void *)cb;
619
620	return cbs->istatus;
621}
622
623/* Get CB message queue substatus */
624static inline int gru_get_cb_message_queue_substatus(void *cb)
625{
626	struct gru_control_block_status *cbs = (void *)cb;
627
628	return cbs->isubstatus & CBSS_MSG_QUEUE_MASK;
629}
630
631/* Get CB substatus */
632static inline int gru_get_cb_substatus(void *cb)
633{
634	struct gru_control_block_status *cbs = (void *)cb;
635
636	return cbs->isubstatus;
637}
638
639/*
640 * User interface to check an instruction status. UPM and exceptions
641 * are handled automatically. However, this function does NOT wait
642 * for an active instruction to complete.
643 *
644 */
645static inline int gru_check_status(void *cb)
646{
647	struct gru_control_block_status *cbs = (void *)cb;
648	int ret;
649
650	ret = cbs->istatus;
651	if (ret != CBS_ACTIVE)
652		ret = gru_check_status_proc(cb);
653	return ret;
654}
655
656/*
657 * User interface (via inline function) to wait for an instruction
658 * to complete. Completion status (IDLE or EXCEPTION is returned
659 * to the user. Exception due to hardware errors are automatically
660 * retried before returning an exception.
661 *
662 */
663static inline int gru_wait(void *cb)
664{
665	return gru_wait_proc(cb);
666}
667
668/*
669 * Wait for CB to complete. Aborts program if error. (Note: error does NOT
670 * mean TLB mis - only fatal errors such as memory parity error or user
671 * bugs will cause termination.
672 */
673static inline void gru_wait_abort(void *cb)
674{
675	gru_wait_abort_proc(cb);
676}
677
678
679/*
680 * Get a pointer to a control block
681 * 	gseg	- GSeg address returned from gru_get_thread_gru_segment()
682 * 	index	- index of desired CB
683 */
684static inline void *gru_get_cb_pointer(void *gseg,
685						      int index)
686{
687	return gseg + GRU_CB_BASE + index * GRU_HANDLE_STRIDE;
688}
689
690/*
691 * Get a pointer to a cacheline in the data segment portion of a GSeg
692 * 	gseg	- GSeg address returned from gru_get_thread_gru_segment()
693 * 	index	- index of desired cache line
694 */
695static inline void *gru_get_data_pointer(void *gseg, int index)
696{
697	return gseg + GRU_DS_BASE + index * GRU_CACHE_LINE_BYTES;
698}
699
700/*
701 * Convert a vaddr into the tri index within the GSEG
702 * 	vaddr		- virtual address of within gseg
703 */
704static inline int gru_get_tri(void *vaddr)
705{
706	return ((unsigned long)vaddr & (GRU_GSEG_PAGESIZE - 1)) - GRU_DS_BASE;
707}
708#endif		/* __GRU_INSTRUCTIONS_H__ */
709