1 /* SPDX-License-Identifier: GPL-2.0-or-later */ 2 /* 3 * Copyright 2015 IBM Corp. 4 */ 5 6 #ifndef _HCALLS_H 7 #define _HCALLS_H 8 9 #include <linux/types.h> 10 #include <asm/byteorder.h> 11 #include <asm/hvcall.h> 12 #include "cxl.h" 13 14 #define SG_BUFFER_SIZE 4096 15 #define SG_MAX_ENTRIES 256 16 17 struct sg_list { 18 u64 phys_addr; 19 u64 len; 20 }; 21 22 /* 23 * This is straight out of PAPR, but replacing some of the compound fields with 24 * a single field, where they were identical to the register layout. 25 * 26 * The 'flags' parameter regroups the various bit-fields 27 */ 28 #define CXL_PE_CSRP_VALID (1ULL << 63) 29 #define CXL_PE_PROBLEM_STATE (1ULL << 62) 30 #define CXL_PE_SECONDARY_SEGMENT_TBL_SRCH (1ULL << 61) 31 #define CXL_PE_TAGS_ACTIVE (1ULL << 60) 32 #define CXL_PE_USER_STATE (1ULL << 59) 33 #define CXL_PE_TRANSLATION_ENABLED (1ULL << 58) 34 #define CXL_PE_64_BIT (1ULL << 57) 35 #define CXL_PE_PRIVILEGED_PROCESS (1ULL << 56) 36 37 #define CXL_PROCESS_ELEMENT_VERSION 1 38 struct cxl_process_element_hcall { 39 __be64 version; 40 __be64 flags; 41 u8 reserved0[12]; 42 __be32 pslVirtualIsn; 43 u8 applicationVirtualIsnBitmap[256]; 44 u8 reserved1[144]; 45 struct cxl_process_element_common common; 46 u8 reserved4[12]; 47 } __packed; 48 49 #define H_STATE_NORMAL 1 50 #define H_STATE_DISABLE 2 51 #define H_STATE_TEMP_UNAVAILABLE 3 52 #define H_STATE_PERM_UNAVAILABLE 4 53 54 /* NOTE: element must be a logical real address, and must be pinned */ 55 long cxl_h_attach_process(u64 unit_address, struct cxl_process_element_hcall *element, 56 u64 *process_token, u64 *mmio_addr, u64 *mmio_size); 57 58 /** 59 * cxl_h_detach_process - Detach a process element from a coherent 60 * platform function. 61 */ 62 long cxl_h_detach_process(u64 unit_address, u64 process_token); 63 64 /** 65 * cxl_h_reset_afu - Perform a reset to the coherent platform function. 66 */ 67 long cxl_h_reset_afu(u64 unit_address); 68 69 /** 70 * cxl_h_suspend_process - Suspend a process from being executed 71 * Parameter1 = process-token as returned from H_ATTACH_CA_PROCESS when 72 * process was attached. 73 */ 74 long cxl_h_suspend_process(u64 unit_address, u64 process_token); 75 76 /** 77 * cxl_h_resume_process - Resume a process to be executed 78 * Parameter1 = process-token as returned from H_ATTACH_CA_PROCESS when 79 * process was attached. 80 */ 81 long cxl_h_resume_process(u64 unit_address, u64 process_token); 82 83 /** 84 * cxl_h_read_error_state - Reads the error state of the coherent 85 * platform function. 86 * R4 contains the error state 87 */ 88 long cxl_h_read_error_state(u64 unit_address, u64 *state); 89 90 /** 91 * cxl_h_get_afu_err - collect the AFU error buffer 92 * Parameter1 = byte offset into error buffer to retrieve, valid values 93 * are between 0 and (ibm,error-buffer-size - 1) 94 * Parameter2 = 4K aligned real address of error buffer, to be filled in 95 * Parameter3 = length of error buffer, valid values are 4K or less 96 */ 97 long cxl_h_get_afu_err(u64 unit_address, u64 offset, u64 buf_address, u64 len); 98 99 /** 100 * cxl_h_get_config - collect configuration record for the 101 * coherent platform function 102 * Parameter1 = # of configuration record to retrieve, valid values are 103 * between 0 and (ibm,#config-records - 1) 104 * Parameter2 = byte offset into configuration record to retrieve, 105 * valid values are between 0 and (ibm,config-record-size - 1) 106 * Parameter3 = 4K aligned real address of configuration record buffer, 107 * to be filled in 108 * Parameter4 = length of configuration buffer, valid values are 4K or less 109 */ 110 long cxl_h_get_config(u64 unit_address, u64 cr_num, u64 offset, 111 u64 buf_address, u64 len); 112 113 /** 114 * cxl_h_terminate_process - Terminate the process before completion 115 * Parameter1 = process-token as returned from H_ATTACH_CA_PROCESS when 116 * process was attached. 117 */ 118 long cxl_h_terminate_process(u64 unit_address, u64 process_token); 119 120 /** 121 * cxl_h_collect_vpd - Collect VPD for the coherent platform function. 122 * Parameter1 = # of VPD record to retrieve, valid values are between 0 123 * and (ibm,#config-records - 1). 124 * Parameter2 = 4K naturally aligned real buffer containing block 125 * list entries 126 * Parameter3 = number of block list entries in the block list, valid 127 * values are between 0 and 256 128 */ 129 long cxl_h_collect_vpd(u64 unit_address, u64 record, u64 list_address, 130 u64 num, u64 *out); 131 132 /** 133 * cxl_h_get_fn_error_interrupt - Read the function-wide error data based on an interrupt 134 */ 135 long cxl_h_get_fn_error_interrupt(u64 unit_address, u64 *reg); 136 137 /** 138 * cxl_h_ack_fn_error_interrupt - Acknowledge function-wide error data 139 * based on an interrupt 140 * Parameter1 = value to write to the function-wide error interrupt register 141 */ 142 long cxl_h_ack_fn_error_interrupt(u64 unit_address, u64 value); 143 144 /** 145 * cxl_h_get_error_log - Retrieve the Platform Log ID (PLID) of 146 * an error log 147 */ 148 long cxl_h_get_error_log(u64 unit_address, u64 value); 149 150 /** 151 * cxl_h_collect_int_info - Collect interrupt info about a coherent 152 * platform function after an interrupt occurred. 153 */ 154 long cxl_h_collect_int_info(u64 unit_address, u64 process_token, 155 struct cxl_irq_info *info); 156 157 /** 158 * cxl_h_control_faults - Control the operation of a coherent platform 159 * function after a fault occurs. 160 * 161 * Parameters 162 * control-mask: value to control the faults 163 * looks like PSL_TFC_An shifted >> 32 164 * reset-mask: mask to control reset of function faults 165 * Set reset_mask = 1 to reset PSL errors 166 */ 167 long cxl_h_control_faults(u64 unit_address, u64 process_token, 168 u64 control_mask, u64 reset_mask); 169 170 /** 171 * cxl_h_reset_adapter - Perform a reset to the coherent platform facility. 172 */ 173 long cxl_h_reset_adapter(u64 unit_address); 174 175 /** 176 * cxl_h_collect_vpd - Collect VPD for the coherent platform function. 177 * Parameter1 = 4K naturally aligned real buffer containing block 178 * list entries 179 * Parameter2 = number of block list entries in the block list, valid 180 * values are between 0 and 256 181 */ 182 long cxl_h_collect_vpd_adapter(u64 unit_address, u64 list_address, 183 u64 num, u64 *out); 184 185 /** 186 * cxl_h_download_adapter_image - Download the base image to the coherent 187 * platform facility. 188 */ 189 long cxl_h_download_adapter_image(u64 unit_address, 190 u64 list_address, u64 num, 191 u64 *out); 192 193 /** 194 * cxl_h_validate_adapter_image - Validate the base image in the coherent 195 * platform facility. 196 */ 197 long cxl_h_validate_adapter_image(u64 unit_address, 198 u64 list_address, u64 num, 199 u64 *out); 200 #endif /* _HCALLS_H */ 201