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