gru_instructions.h 19 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673
  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. #ifndef __GRU_INSTRUCTIONS_H__
  19. #define __GRU_INSTRUCTIONS_H__
  20. extern int gru_check_status_proc(void *cb);
  21. extern int gru_wait_proc(void *cb);
  22. extern void gru_wait_abort_proc(void *cb);
  23. /*
  24. * Architecture dependent functions
  25. */
  26. #if defined(CONFIG_IA64)
  27. #include <linux/compiler.h>
  28. #include <asm/intrinsics.h>
  29. #define __flush_cache(p) ia64_fc((unsigned long)p)
  30. /* Use volatile on IA64 to ensure ordering via st4.rel */
  31. #define gru_ordered_store_int(p, v) \
  32. do { \
  33. barrier(); \
  34. *((volatile int *)(p)) = v; /* force st.rel */ \
  35. } while (0)
  36. #elif defined(CONFIG_X86_64)
  37. #define __flush_cache(p) clflush(p)
  38. #define gru_ordered_store_int(p, v) \
  39. do { \
  40. barrier(); \
  41. *(int *)p = v; \
  42. } while (0)
  43. #else
  44. #error "Unsupported architecture"
  45. #endif
  46. /*
  47. * Control block status and exception codes
  48. */
  49. #define CBS_IDLE 0
  50. #define CBS_EXCEPTION 1
  51. #define CBS_ACTIVE 2
  52. #define CBS_CALL_OS 3
  53. /* CB substatus bitmasks */
  54. #define CBSS_MSG_QUEUE_MASK 7
  55. #define CBSS_IMPLICIT_ABORT_ACTIVE_MASK 8
  56. /* CB substatus message queue values (low 3 bits of substatus) */
  57. #define CBSS_NO_ERROR 0
  58. #define CBSS_LB_OVERFLOWED 1
  59. #define CBSS_QLIMIT_REACHED 2
  60. #define CBSS_PAGE_OVERFLOW 3
  61. #define CBSS_AMO_NACKED 4
  62. #define CBSS_PUT_NACKED 5
  63. /*
  64. * Structure used to fetch exception detail for CBs that terminate with
  65. * CBS_EXCEPTION
  66. */
  67. struct control_block_extended_exc_detail {
  68. unsigned long cb;
  69. int opc;
  70. int ecause;
  71. int exopc;
  72. long exceptdet0;
  73. int exceptdet1;
  74. };
  75. /*
  76. * Instruction formats
  77. */
  78. /*
  79. * Generic instruction format.
  80. * This definition has precise bit field definitions.
  81. */
  82. struct gru_instruction_bits {
  83. /* DW 0 - low */
  84. unsigned int icmd: 1;
  85. unsigned char ima: 3; /* CB_DelRep, unmapped mode */
  86. unsigned char reserved0: 4;
  87. unsigned int xtype: 3;
  88. unsigned int iaa0: 2;
  89. unsigned int iaa1: 2;
  90. unsigned char reserved1: 1;
  91. unsigned char opc: 8; /* opcode */
  92. unsigned char exopc: 8; /* extended opcode */
  93. /* DW 0 - high */
  94. unsigned int idef2: 22; /* TRi0 */
  95. unsigned char reserved2: 2;
  96. unsigned char istatus: 2;
  97. unsigned char isubstatus:4;
  98. unsigned char reserved3: 2;
  99. /* DW 1 */
  100. unsigned long idef4; /* 42 bits: TRi1, BufSize */
  101. /* DW 2-6 */
  102. unsigned long idef1; /* BAddr0 */
  103. unsigned long idef5; /* Nelem */
  104. unsigned long idef6; /* Stride, Operand1 */
  105. unsigned long idef3; /* BAddr1, Value, Operand2 */
  106. unsigned long reserved4;
  107. /* DW 7 */
  108. unsigned long avalue; /* AValue */
  109. };
  110. /*
  111. * Generic instruction with friendlier names. This format is used
  112. * for inline instructions.
  113. */
  114. struct gru_instruction {
  115. /* DW 0 */
  116. unsigned int op32; /* icmd,xtype,iaa0,ima,opc */
  117. unsigned int tri0;
  118. unsigned long tri1_bufsize; /* DW 1 */
  119. unsigned long baddr0; /* DW 2 */
  120. unsigned long nelem; /* DW 3 */
  121. unsigned long op1_stride; /* DW 4 */
  122. unsigned long op2_value_baddr1; /* DW 5 */
  123. unsigned long reserved0; /* DW 6 */
  124. unsigned long avalue; /* DW 7 */
  125. };
  126. /* Some shifts and masks for the low 32 bits of a GRU command */
  127. #define GRU_CB_ICMD_SHFT 0
  128. #define GRU_CB_ICMD_MASK 0x1
  129. #define GRU_CB_XTYPE_SHFT 8
  130. #define GRU_CB_XTYPE_MASK 0x7
  131. #define GRU_CB_IAA0_SHFT 11
  132. #define GRU_CB_IAA0_MASK 0x3
  133. #define GRU_CB_IAA1_SHFT 13
  134. #define GRU_CB_IAA1_MASK 0x3
  135. #define GRU_CB_IMA_SHFT 1
  136. #define GRU_CB_IMA_MASK 0x3
  137. #define GRU_CB_OPC_SHFT 16
  138. #define GRU_CB_OPC_MASK 0xff
  139. #define GRU_CB_EXOPC_SHFT 24
  140. #define GRU_CB_EXOPC_MASK 0xff
  141. /* GRU instruction opcodes (opc field) */
  142. #define OP_NOP 0x00
  143. #define OP_BCOPY 0x01
  144. #define OP_VLOAD 0x02
  145. #define OP_IVLOAD 0x03
  146. #define OP_VSTORE 0x04
  147. #define OP_IVSTORE 0x05
  148. #define OP_VSET 0x06
  149. #define OP_IVSET 0x07
  150. #define OP_MESQ 0x08
  151. #define OP_GAMXR 0x09
  152. #define OP_GAMIR 0x0a
  153. #define OP_GAMIRR 0x0b
  154. #define OP_GAMER 0x0c
  155. #define OP_GAMERR 0x0d
  156. #define OP_BSTORE 0x0e
  157. #define OP_VFLUSH 0x0f
  158. /* Extended opcodes values (exopc field) */
  159. /* GAMIR - AMOs with implicit operands */
  160. #define EOP_IR_FETCH 0x01 /* Plain fetch of memory */
  161. #define EOP_IR_CLR 0x02 /* Fetch and clear */
  162. #define EOP_IR_INC 0x05 /* Fetch and increment */
  163. #define EOP_IR_DEC 0x07 /* Fetch and decrement */
  164. #define EOP_IR_QCHK1 0x0d /* Queue check, 64 byte msg */
  165. #define EOP_IR_QCHK2 0x0e /* Queue check, 128 byte msg */
  166. /* GAMIRR - Registered AMOs with implicit operands */
  167. #define EOP_IRR_FETCH 0x01 /* Registered fetch of memory */
  168. #define EOP_IRR_CLR 0x02 /* Registered fetch and clear */
  169. #define EOP_IRR_INC 0x05 /* Registered fetch and increment */
  170. #define EOP_IRR_DEC 0x07 /* Registered fetch and decrement */
  171. #define EOP_IRR_DECZ 0x0f /* Registered fetch and decrement, update on zero*/
  172. /* GAMER - AMOs with explicit operands */
  173. #define EOP_ER_SWAP 0x00 /* Exchange argument and memory */
  174. #define EOP_ER_OR 0x01 /* Logical OR with memory */
  175. #define EOP_ER_AND 0x02 /* Logical AND with memory */
  176. #define EOP_ER_XOR 0x03 /* Logical XOR with memory */
  177. #define EOP_ER_ADD 0x04 /* Add value to memory */
  178. #define EOP_ER_CSWAP 0x08 /* Compare with operand2, write operand1 if match*/
  179. #define EOP_ER_CADD 0x0c /* Queue check, operand1*64 byte msg */
  180. /* GAMERR - Registered AMOs with explicit operands */
  181. #define EOP_ERR_SWAP 0x00 /* Exchange argument and memory */
  182. #define EOP_ERR_OR 0x01 /* Logical OR with memory */
  183. #define EOP_ERR_AND 0x02 /* Logical AND with memory */
  184. #define EOP_ERR_XOR 0x03 /* Logical XOR with memory */
  185. #define EOP_ERR_ADD 0x04 /* Add value to memory */
  186. #define EOP_ERR_CSWAP 0x08 /* Compare with operand2, write operand1 if match*/
  187. #define EOP_ERR_EPOLL 0x09 /* Poll for equality */
  188. #define EOP_ERR_NPOLL 0x0a /* Poll for inequality */
  189. /* GAMXR - SGI Arithmetic unit */
  190. #define EOP_XR_CSWAP 0x0b /* Masked compare exchange */
  191. /* Transfer types (xtype field) */
  192. #define XTYPE_B 0x0 /* byte */
  193. #define XTYPE_S 0x1 /* short (2-byte) */
  194. #define XTYPE_W 0x2 /* word (4-byte) */
  195. #define XTYPE_DW 0x3 /* doubleword (8-byte) */
  196. #define XTYPE_CL 0x6 /* cacheline (64-byte) */
  197. /* Instruction access attributes (iaa0, iaa1 fields) */
  198. #define IAA_RAM 0x0 /* normal cached RAM access */
  199. #define IAA_NCRAM 0x2 /* noncoherent RAM access */
  200. #define IAA_MMIO 0x1 /* noncoherent memory-mapped I/O space */
  201. #define IAA_REGISTER 0x3 /* memory-mapped registers, etc. */
  202. /* Instruction mode attributes (ima field) */
  203. #define IMA_MAPPED 0x0 /* Virtual mode */
  204. #define IMA_CB_DELAY 0x1 /* hold read responses until status changes */
  205. #define IMA_UNMAPPED 0x2 /* bypass the TLBs (OS only) */
  206. #define IMA_INTERRUPT 0x4 /* Interrupt when instruction completes */
  207. /* CBE ecause bits */
  208. #define CBE_CAUSE_RI (1 << 0)
  209. #define CBE_CAUSE_INVALID_INSTRUCTION (1 << 1)
  210. #define CBE_CAUSE_UNMAPPED_MODE_FORBIDDEN (1 << 2)
  211. #define CBE_CAUSE_PE_CHECK_DATA_ERROR (1 << 3)
  212. #define CBE_CAUSE_IAA_GAA_MISMATCH (1 << 4)
  213. #define CBE_CAUSE_DATA_SEGMENT_LIMIT_EXCEPTION (1 << 5)
  214. #define CBE_CAUSE_OS_FATAL_TLB_FAULT (1 << 6)
  215. #define CBE_CAUSE_EXECUTION_HW_ERROR (1 << 7)
  216. #define CBE_CAUSE_TLBHW_ERROR (1 << 8)
  217. #define CBE_CAUSE_RA_REQUEST_TIMEOUT (1 << 9)
  218. #define CBE_CAUSE_HA_REQUEST_TIMEOUT (1 << 10)
  219. #define CBE_CAUSE_RA_RESPONSE_FATAL (1 << 11)
  220. #define CBE_CAUSE_RA_RESPONSE_NON_FATAL (1 << 12)
  221. #define CBE_CAUSE_HA_RESPONSE_FATAL (1 << 13)
  222. #define CBE_CAUSE_HA_RESPONSE_NON_FATAL (1 << 14)
  223. #define CBE_CAUSE_ADDRESS_SPACE_DECODE_ERROR (1 << 15)
  224. #define CBE_CAUSE_RESPONSE_DATA_ERROR (1 << 16)
  225. #define CBE_CAUSE_PROTOCOL_STATE_DATA_ERROR (1 << 17)
  226. /*
  227. * Exceptions are retried for the following cases. If any OTHER bits are set
  228. * in ecause, the exception is not retryable.
  229. */
  230. #define EXCEPTION_RETRY_BITS (CBE_CAUSE_RESPONSE_DATA_ERROR | \
  231. CBE_CAUSE_RA_REQUEST_TIMEOUT | \
  232. CBE_CAUSE_TLBHW_ERROR | \
  233. CBE_CAUSE_HA_REQUEST_TIMEOUT)
  234. /* Message queue head structure */
  235. union gru_mesqhead {
  236. unsigned long val;
  237. struct {
  238. unsigned int head;
  239. unsigned int limit;
  240. };
  241. };
  242. /* Generate the low word of a GRU instruction */
  243. static inline unsigned int
  244. __opword(unsigned char opcode, unsigned char exopc, unsigned char xtype,
  245. unsigned char iaa0, unsigned char iaa1,
  246. unsigned char ima)
  247. {
  248. return (1 << GRU_CB_ICMD_SHFT) |
  249. (iaa0 << GRU_CB_IAA0_SHFT) |
  250. (iaa1 << GRU_CB_IAA1_SHFT) |
  251. (ima << GRU_CB_IMA_SHFT) |
  252. (xtype << GRU_CB_XTYPE_SHFT) |
  253. (opcode << GRU_CB_OPC_SHFT) |
  254. (exopc << GRU_CB_EXOPC_SHFT);
  255. }
  256. /*
  257. * Architecture specific intrinsics
  258. */
  259. static inline void gru_flush_cache(void *p)
  260. {
  261. __flush_cache(p);
  262. }
  263. /*
  264. * Store the lower 32 bits of the command including the "start" bit. Then
  265. * start the instruction executing.
  266. */
  267. static inline void gru_start_instruction(struct gru_instruction *ins, int op32)
  268. {
  269. gru_ordered_store_int(ins, op32);
  270. gru_flush_cache(ins);
  271. }
  272. /* Convert "hints" to IMA */
  273. #define CB_IMA(h) ((h) | IMA_UNMAPPED)
  274. /* Convert data segment cache line index into TRI0 / TRI1 value */
  275. #define GRU_DINDEX(i) ((i) * GRU_CACHE_LINE_BYTES)
  276. /* Inline functions for GRU instructions.
  277. * Note:
  278. * - nelem and stride are in elements
  279. * - tri0/tri1 is in bytes for the beginning of the data segment.
  280. */
  281. static inline void gru_vload(void *cb, unsigned long mem_addr,
  282. unsigned int tri0, unsigned char xtype, unsigned long nelem,
  283. unsigned long stride, unsigned long hints)
  284. {
  285. struct gru_instruction *ins = (struct gru_instruction *)cb;
  286. ins->baddr0 = (long)mem_addr;
  287. ins->nelem = nelem;
  288. ins->tri0 = tri0;
  289. ins->op1_stride = stride;
  290. gru_start_instruction(ins, __opword(OP_VLOAD, 0, xtype, IAA_RAM, 0,
  291. CB_IMA(hints)));
  292. }
  293. static inline void gru_vstore(void *cb, unsigned long mem_addr,
  294. unsigned int tri0, unsigned char xtype, unsigned long nelem,
  295. unsigned long stride, unsigned long hints)
  296. {
  297. struct gru_instruction *ins = (void *)cb;
  298. ins->baddr0 = (long)mem_addr;
  299. ins->nelem = nelem;
  300. ins->tri0 = tri0;
  301. ins->op1_stride = stride;
  302. gru_start_instruction(ins, __opword(OP_VSTORE, 0, xtype, IAA_RAM, 0,
  303. CB_IMA(hints)));
  304. }
  305. static inline void gru_ivload(void *cb, unsigned long mem_addr,
  306. unsigned int tri0, unsigned int tri1, unsigned char xtype,
  307. unsigned long nelem, unsigned long hints)
  308. {
  309. struct gru_instruction *ins = (void *)cb;
  310. ins->baddr0 = (long)mem_addr;
  311. ins->nelem = nelem;
  312. ins->tri0 = tri0;
  313. ins->tri1_bufsize = tri1;
  314. gru_start_instruction(ins, __opword(OP_IVLOAD, 0, xtype, IAA_RAM, 0,
  315. CB_IMA(hints)));
  316. }
  317. static inline void gru_ivstore(void *cb, unsigned long mem_addr,
  318. unsigned int tri0, unsigned int tri1,
  319. unsigned char xtype, unsigned long nelem, unsigned long hints)
  320. {
  321. struct gru_instruction *ins = (void *)cb;
  322. ins->baddr0 = (long)mem_addr;
  323. ins->nelem = nelem;
  324. ins->tri0 = tri0;
  325. ins->tri1_bufsize = tri1;
  326. gru_start_instruction(ins, __opword(OP_IVSTORE, 0, xtype, IAA_RAM, 0,
  327. CB_IMA(hints)));
  328. }
  329. static inline void gru_vset(void *cb, unsigned long mem_addr,
  330. unsigned long value, unsigned char xtype, unsigned long nelem,
  331. unsigned long stride, unsigned long hints)
  332. {
  333. struct gru_instruction *ins = (void *)cb;
  334. ins->baddr0 = (long)mem_addr;
  335. ins->op2_value_baddr1 = value;
  336. ins->nelem = nelem;
  337. ins->op1_stride = stride;
  338. gru_start_instruction(ins, __opword(OP_VSET, 0, xtype, IAA_RAM, 0,
  339. CB_IMA(hints)));
  340. }
  341. static inline void gru_ivset(void *cb, unsigned long mem_addr,
  342. unsigned int tri1, unsigned long value, unsigned char xtype,
  343. unsigned long nelem, unsigned long hints)
  344. {
  345. struct gru_instruction *ins = (void *)cb;
  346. ins->baddr0 = (long)mem_addr;
  347. ins->op2_value_baddr1 = value;
  348. ins->nelem = nelem;
  349. ins->tri1_bufsize = tri1;
  350. gru_start_instruction(ins, __opword(OP_IVSET, 0, xtype, IAA_RAM, 0,
  351. CB_IMA(hints)));
  352. }
  353. static inline void gru_vflush(void *cb, unsigned long mem_addr,
  354. unsigned long nelem, unsigned char xtype, unsigned long stride,
  355. unsigned long hints)
  356. {
  357. struct gru_instruction *ins = (void *)cb;
  358. ins->baddr0 = (long)mem_addr;
  359. ins->op1_stride = stride;
  360. ins->nelem = nelem;
  361. gru_start_instruction(ins, __opword(OP_VFLUSH, 0, xtype, IAA_RAM, 0,
  362. CB_IMA(hints)));
  363. }
  364. static inline void gru_nop(void *cb, int hints)
  365. {
  366. struct gru_instruction *ins = (void *)cb;
  367. gru_start_instruction(ins, __opword(OP_NOP, 0, 0, 0, 0, CB_IMA(hints)));
  368. }
  369. static inline void gru_bcopy(void *cb, const unsigned long src,
  370. unsigned long dest,
  371. unsigned int tri0, unsigned int xtype, unsigned long nelem,
  372. unsigned int bufsize, unsigned long hints)
  373. {
  374. struct gru_instruction *ins = (void *)cb;
  375. ins->baddr0 = (long)src;
  376. ins->op2_value_baddr1 = (long)dest;
  377. ins->nelem = nelem;
  378. ins->tri0 = tri0;
  379. ins->tri1_bufsize = bufsize;
  380. gru_start_instruction(ins, __opword(OP_BCOPY, 0, xtype, IAA_RAM,
  381. IAA_RAM, CB_IMA(hints)));
  382. }
  383. static inline void gru_bstore(void *cb, const unsigned long src,
  384. unsigned long dest, unsigned int tri0, unsigned int xtype,
  385. unsigned long nelem, unsigned long hints)
  386. {
  387. struct gru_instruction *ins = (void *)cb;
  388. ins->baddr0 = (long)src;
  389. ins->op2_value_baddr1 = (long)dest;
  390. ins->nelem = nelem;
  391. ins->tri0 = tri0;
  392. gru_start_instruction(ins, __opword(OP_BSTORE, 0, xtype, 0, IAA_RAM,
  393. CB_IMA(hints)));
  394. }
  395. static inline void gru_gamir(void *cb, int exopc, unsigned long src,
  396. unsigned int xtype, unsigned long hints)
  397. {
  398. struct gru_instruction *ins = (void *)cb;
  399. ins->baddr0 = (long)src;
  400. gru_start_instruction(ins, __opword(OP_GAMIR, exopc, xtype, IAA_RAM, 0,
  401. CB_IMA(hints)));
  402. }
  403. static inline void gru_gamirr(void *cb, int exopc, unsigned long src,
  404. unsigned int xtype, unsigned long hints)
  405. {
  406. struct gru_instruction *ins = (void *)cb;
  407. ins->baddr0 = (long)src;
  408. gru_start_instruction(ins, __opword(OP_GAMIRR, exopc, xtype, IAA_RAM, 0,
  409. CB_IMA(hints)));
  410. }
  411. static inline void gru_gamer(void *cb, int exopc, unsigned long src,
  412. unsigned int xtype,
  413. unsigned long operand1, unsigned long operand2,
  414. unsigned long hints)
  415. {
  416. struct gru_instruction *ins = (void *)cb;
  417. ins->baddr0 = (long)src;
  418. ins->op1_stride = operand1;
  419. ins->op2_value_baddr1 = operand2;
  420. gru_start_instruction(ins, __opword(OP_GAMER, exopc, xtype, IAA_RAM, 0,
  421. CB_IMA(hints)));
  422. }
  423. static inline void gru_gamerr(void *cb, int exopc, unsigned long src,
  424. unsigned int xtype, unsigned long operand1,
  425. unsigned long operand2, unsigned long hints)
  426. {
  427. struct gru_instruction *ins = (void *)cb;
  428. ins->baddr0 = (long)src;
  429. ins->op1_stride = operand1;
  430. ins->op2_value_baddr1 = operand2;
  431. gru_start_instruction(ins, __opword(OP_GAMERR, exopc, xtype, IAA_RAM, 0,
  432. CB_IMA(hints)));
  433. }
  434. static inline void gru_gamxr(void *cb, unsigned long src,
  435. unsigned int tri0, unsigned long hints)
  436. {
  437. struct gru_instruction *ins = (void *)cb;
  438. ins->baddr0 = (long)src;
  439. ins->nelem = 4;
  440. gru_start_instruction(ins, __opword(OP_GAMXR, EOP_XR_CSWAP, XTYPE_DW,
  441. IAA_RAM, 0, CB_IMA(hints)));
  442. }
  443. static inline void gru_mesq(void *cb, unsigned long queue,
  444. unsigned long tri0, unsigned long nelem,
  445. unsigned long hints)
  446. {
  447. struct gru_instruction *ins = (void *)cb;
  448. ins->baddr0 = (long)queue;
  449. ins->nelem = nelem;
  450. ins->tri0 = tri0;
  451. gru_start_instruction(ins, __opword(OP_MESQ, 0, XTYPE_CL, IAA_RAM, 0,
  452. CB_IMA(hints)));
  453. }
  454. static inline unsigned long gru_get_amo_value(void *cb)
  455. {
  456. struct gru_instruction *ins = (void *)cb;
  457. return ins->avalue;
  458. }
  459. static inline int gru_get_amo_value_head(void *cb)
  460. {
  461. struct gru_instruction *ins = (void *)cb;
  462. return ins->avalue & 0xffffffff;
  463. }
  464. static inline int gru_get_amo_value_limit(void *cb)
  465. {
  466. struct gru_instruction *ins = (void *)cb;
  467. return ins->avalue >> 32;
  468. }
  469. static inline union gru_mesqhead gru_mesq_head(int head, int limit)
  470. {
  471. union gru_mesqhead mqh;
  472. mqh.head = head;
  473. mqh.limit = limit;
  474. return mqh;
  475. }
  476. /*
  477. * Get struct control_block_extended_exc_detail for CB.
  478. */
  479. extern int gru_get_cb_exception_detail(void *cb,
  480. struct control_block_extended_exc_detail *excdet);
  481. #define GRU_EXC_STR_SIZE 256
  482. /*
  483. * Control block definition for checking status
  484. */
  485. struct gru_control_block_status {
  486. unsigned int icmd :1;
  487. unsigned int ima :3;
  488. unsigned int reserved0 :4;
  489. unsigned int unused1 :24;
  490. unsigned int unused2 :24;
  491. unsigned int istatus :2;
  492. unsigned int isubstatus :4;
  493. unsigned int unused3 :2;
  494. };
  495. /* Get CB status */
  496. static inline int gru_get_cb_status(void *cb)
  497. {
  498. struct gru_control_block_status *cbs = (void *)cb;
  499. return cbs->istatus;
  500. }
  501. /* Get CB message queue substatus */
  502. static inline int gru_get_cb_message_queue_substatus(void *cb)
  503. {
  504. struct gru_control_block_status *cbs = (void *)cb;
  505. return cbs->isubstatus & CBSS_MSG_QUEUE_MASK;
  506. }
  507. /* Get CB substatus */
  508. static inline int gru_get_cb_substatus(void *cb)
  509. {
  510. struct gru_control_block_status *cbs = (void *)cb;
  511. return cbs->isubstatus;
  512. }
  513. /* Check the status of a CB. If the CB is in UPM mode, call the
  514. * OS to handle the UPM status.
  515. * Returns the CB status field value (0 for normal completion)
  516. */
  517. static inline int gru_check_status(void *cb)
  518. {
  519. struct gru_control_block_status *cbs = (void *)cb;
  520. int ret;
  521. ret = cbs->istatus;
  522. if (ret == CBS_CALL_OS)
  523. ret = gru_check_status_proc(cb);
  524. return ret;
  525. }
  526. /* Wait for CB to complete.
  527. * Returns the CB status field value (0 for normal completion)
  528. */
  529. static inline int gru_wait(void *cb)
  530. {
  531. struct gru_control_block_status *cbs = (void *)cb;
  532. int ret = cbs->istatus;
  533. if (ret != CBS_IDLE)
  534. ret = gru_wait_proc(cb);
  535. return ret;
  536. }
  537. /* Wait for CB to complete. Aborts program if error. (Note: error does NOT
  538. * mean TLB mis - only fatal errors such as memory parity error or user
  539. * bugs will cause termination.
  540. */
  541. static inline void gru_wait_abort(void *cb)
  542. {
  543. struct gru_control_block_status *cbs = (void *)cb;
  544. if (cbs->istatus != CBS_IDLE)
  545. gru_wait_abort_proc(cb);
  546. }
  547. /*
  548. * Get a pointer to a control block
  549. * gseg - GSeg address returned from gru_get_thread_gru_segment()
  550. * index - index of desired CB
  551. */
  552. static inline void *gru_get_cb_pointer(void *gseg,
  553. int index)
  554. {
  555. return gseg + GRU_CB_BASE + index * GRU_HANDLE_STRIDE;
  556. }
  557. /*
  558. * Get a pointer to a cacheline in the data segment portion of a GSeg
  559. * gseg - GSeg address returned from gru_get_thread_gru_segment()
  560. * index - index of desired cache line
  561. */
  562. static inline void *gru_get_data_pointer(void *gseg, int index)
  563. {
  564. return gseg + GRU_DS_BASE + index * GRU_CACHE_LINE_BYTES;
  565. }
  566. /*
  567. * Convert a vaddr into the tri index within the GSEG
  568. * vaddr - virtual address of within gseg
  569. */
  570. static inline int gru_get_tri(void *vaddr)
  571. {
  572. return ((unsigned long)vaddr & (GRU_GSEG_PAGESIZE - 1)) - GRU_DS_BASE;
  573. }
  574. #endif /* __GRU_INSTRUCTIONS_H__ */