1 /* SPDX-License-Identifier: GPL-2.0-or-later */ 2 /* 3 * ICSWX api 4 * 5 * Copyright (C) 2015 IBM Corp. 6 * 7 * This provides the Initiate Coprocessor Store Word Indexed (ICSWX) 8 * instruction. This instruction is used to communicate with PowerPC 9 * coprocessors. This also provides definitions of the structures used 10 * to communicate with the coprocessor. 11 * 12 * The RFC02130: Coprocessor Architecture document is the reference for 13 * everything in this file unless otherwise noted. 14 */ 15 #ifndef _ARCH_POWERPC_INCLUDE_ASM_ICSWX_H_ 16 #define _ARCH_POWERPC_INCLUDE_ASM_ICSWX_H_ 17 18 #include <asm/ppc-opcode.h> /* for PPC_ICSWX */ 19 20 /* Chapter 6.5.8 Coprocessor-Completion Block (CCB) */ 21 22 #define CCB_VALUE (0x3fffffffffffffff) 23 #define CCB_ADDRESS (0xfffffffffffffff8) 24 #define CCB_CM (0x0000000000000007) 25 #define CCB_CM0 (0x0000000000000004) 26 #define CCB_CM12 (0x0000000000000003) 27 28 #define CCB_CM0_ALL_COMPLETIONS (0x0) 29 #define CCB_CM0_LAST_IN_CHAIN (0x4) 30 #define CCB_CM12_STORE (0x0) 31 #define CCB_CM12_INTERRUPT (0x1) 32 33 #define CCB_SIZE (0x10) 34 #define CCB_ALIGN CCB_SIZE 35 36 struct coprocessor_completion_block { 37 __be64 value; 38 __be64 address; 39 } __packed __aligned(CCB_ALIGN); 40 41 42 /* Chapter 6.5.7 Coprocessor-Status Block (CSB) */ 43 44 #define CSB_V (0x80) 45 #define CSB_F (0x04) 46 #define CSB_CH (0x03) 47 #define CSB_CE_INCOMPLETE (0x80) 48 #define CSB_CE_TERMINATION (0x40) 49 #define CSB_CE_TPBC (0x20) 50 51 #define CSB_CC_SUCCESS (0) 52 #define CSB_CC_INVALID_ALIGN (1) 53 #define CSB_CC_OPERAND_OVERLAP (2) 54 #define CSB_CC_DATA_LENGTH (3) 55 #define CSB_CC_TRANSLATION (5) 56 #define CSB_CC_PROTECTION (6) 57 #define CSB_CC_RD_EXTERNAL (7) 58 #define CSB_CC_INVALID_OPERAND (8) 59 #define CSB_CC_PRIVILEGE (9) 60 #define CSB_CC_INTERNAL (10) 61 #define CSB_CC_WR_EXTERNAL (12) 62 #define CSB_CC_NOSPC (13) 63 #define CSB_CC_EXCESSIVE_DDE (14) 64 #define CSB_CC_WR_TRANSLATION (15) 65 #define CSB_CC_WR_PROTECTION (16) 66 #define CSB_CC_UNKNOWN_CODE (17) 67 #define CSB_CC_ABORT (18) 68 #define CSB_CC_EXCEED_BYTE_COUNT (19) /* P9 or later */ 69 #define CSB_CC_TRANSPORT (20) 70 #define CSB_CC_INVALID_CRB (21) /* P9 or later */ 71 #define CSB_CC_INVALID_DDE (30) /* P9 or later */ 72 #define CSB_CC_SEGMENTED_DDL (31) 73 #define CSB_CC_PROGRESS_POINT (32) 74 #define CSB_CC_DDE_OVERFLOW (33) 75 #define CSB_CC_SESSION (34) 76 #define CSB_CC_PROVISION (36) 77 #define CSB_CC_CHAIN (37) 78 #define CSB_CC_SEQUENCE (38) 79 #define CSB_CC_HW (39) 80 /* P9 DD2 NX Workbook 3.2 (Table 4-36): Address translation fault */ 81 #define CSB_CC_FAULT_ADDRESS (250) 82 83 #define CSB_SIZE (0x10) 84 #define CSB_ALIGN CSB_SIZE 85 86 struct coprocessor_status_block { 87 u8 flags; 88 u8 cs; 89 u8 cc; 90 u8 ce; 91 __be32 count; 92 __be64 address; 93 } __packed __aligned(CSB_ALIGN); 94 95 96 /* Chapter 6.5.10 Data-Descriptor List (DDL) 97 * each list contains one or more Data-Descriptor Entries (DDE) 98 */ 99 100 #define DDE_P (0x8000) 101 102 #define DDE_SIZE (0x10) 103 #define DDE_ALIGN DDE_SIZE 104 105 struct data_descriptor_entry { 106 __be16 flags; 107 u8 count; 108 u8 index; 109 __be32 length; 110 __be64 address; 111 } __packed __aligned(DDE_ALIGN); 112 113 /* 4.3.2 NX-stamped Fault CRB */ 114 115 #define NX_STAMP_ALIGN (0x10) 116 117 struct nx_fault_stamp { 118 __be64 fault_storage_addr; 119 __be16 reserved; 120 __u8 flags; 121 __u8 fault_status; 122 __be32 pswid; 123 } __packed __aligned(NX_STAMP_ALIGN); 124 125 /* Chapter 6.5.2 Coprocessor-Request Block (CRB) */ 126 127 #define CRB_SIZE (0x80) 128 #define CRB_ALIGN (0x100) /* Errata: requires 256 alignment */ 129 130 /* Coprocessor Status Block field 131 * ADDRESS address of CSB 132 * C CCB is valid 133 * AT 0 = addrs are virtual, 1 = addrs are phys 134 * M enable perf monitor 135 */ 136 #define CRB_CSB_ADDRESS (0xfffffffffffffff0) 137 #define CRB_CSB_C (0x0000000000000008) 138 #define CRB_CSB_AT (0x0000000000000002) 139 #define CRB_CSB_M (0x0000000000000001) 140 141 struct coprocessor_request_block { 142 __be32 ccw; 143 __be32 flags; 144 __be64 csb_addr; 145 146 struct data_descriptor_entry source; 147 struct data_descriptor_entry target; 148 149 struct coprocessor_completion_block ccb; 150 151 union { 152 struct nx_fault_stamp nx; 153 u8 reserved[16]; 154 } stamp; 155 156 u8 reserved[32]; 157 158 struct coprocessor_status_block csb; 159 } __packed; 160 161 162 /* RFC02167 Initiate Coprocessor Instructions document 163 * Chapter 8.2.1.1.1 RS 164 * Chapter 8.2.3 Coprocessor Directive 165 * Chapter 8.2.4 Execution 166 * 167 * The CCW must be converted to BE before passing to icswx() 168 */ 169 170 #define CCW_PS (0xff000000) 171 #define CCW_CT (0x00ff0000) 172 #define CCW_CD (0x0000ffff) 173 #define CCW_CL (0x0000c000) 174 175 176 /* RFC02167 Initiate Coprocessor Instructions document 177 * Chapter 8.2.1 Initiate Coprocessor Store Word Indexed (ICSWX) 178 * Chapter 8.2.4.1 Condition Register 0 179 */ 180 181 #define ICSWX_INITIATED (0x8) 182 #define ICSWX_BUSY (0x4) 183 #define ICSWX_REJECTED (0x2) 184 #define ICSWX_XERS0 (0x1) /* undefined or set from XERSO. */ 185 186 static inline int icswx(__be32 ccw, struct coprocessor_request_block *crb) 187 { 188 __be64 ccw_reg = ccw; 189 u32 cr; 190 191 __asm__ __volatile__( 192 PPC_ICSWX(%1,0,%2) "\n" 193 "mfcr %0\n" 194 : "=r" (cr) 195 : "r" (ccw_reg), "r" (crb) 196 : "cr0", "memory"); 197 198 return (int)((cr >> 28) & 0xf); 199 } 200 201 202 #endif /* _ARCH_POWERPC_INCLUDE_ASM_ICSWX_H_ */ 203