1*2874c5fdSThomas Gleixner /* SPDX-License-Identifier: GPL-2.0-or-later */ 2444c4ba4SChristophe Lombard /* 3444c4ba4SChristophe Lombard * Copyright 2015 IBM Corp. 4444c4ba4SChristophe Lombard */ 5444c4ba4SChristophe Lombard 6444c4ba4SChristophe Lombard #ifndef _HCALLS_H 7444c4ba4SChristophe Lombard #define _HCALLS_H 8444c4ba4SChristophe Lombard 9444c4ba4SChristophe Lombard #include <linux/types.h> 10444c4ba4SChristophe Lombard #include <asm/byteorder.h> 1114baf4d9SChristophe Lombard #include <asm/hvcall.h> 12444c4ba4SChristophe Lombard #include "cxl.h" 13444c4ba4SChristophe Lombard 14444c4ba4SChristophe Lombard #define SG_BUFFER_SIZE 4096 15444c4ba4SChristophe Lombard #define SG_MAX_ENTRIES 256 16444c4ba4SChristophe Lombard 17444c4ba4SChristophe Lombard struct sg_list { 18444c4ba4SChristophe Lombard u64 phys_addr; 19444c4ba4SChristophe Lombard u64 len; 20444c4ba4SChristophe Lombard }; 21444c4ba4SChristophe Lombard 22444c4ba4SChristophe Lombard /* 23444c4ba4SChristophe Lombard * This is straight out of PAPR, but replacing some of the compound fields with 24444c4ba4SChristophe Lombard * a single field, where they were identical to the register layout. 25444c4ba4SChristophe Lombard * 26444c4ba4SChristophe Lombard * The 'flags' parameter regroups the various bit-fields 27444c4ba4SChristophe Lombard */ 28444c4ba4SChristophe Lombard #define CXL_PE_CSRP_VALID (1ULL << 63) 29444c4ba4SChristophe Lombard #define CXL_PE_PROBLEM_STATE (1ULL << 62) 30444c4ba4SChristophe Lombard #define CXL_PE_SECONDARY_SEGMENT_TBL_SRCH (1ULL << 61) 31444c4ba4SChristophe Lombard #define CXL_PE_TAGS_ACTIVE (1ULL << 60) 32444c4ba4SChristophe Lombard #define CXL_PE_USER_STATE (1ULL << 59) 33444c4ba4SChristophe Lombard #define CXL_PE_TRANSLATION_ENABLED (1ULL << 58) 34444c4ba4SChristophe Lombard #define CXL_PE_64_BIT (1ULL << 57) 35444c4ba4SChristophe Lombard #define CXL_PE_PRIVILEGED_PROCESS (1ULL << 56) 36444c4ba4SChristophe Lombard 37444c4ba4SChristophe Lombard #define CXL_PROCESS_ELEMENT_VERSION 1 38444c4ba4SChristophe Lombard struct cxl_process_element_hcall { 39444c4ba4SChristophe Lombard __be64 version; 40444c4ba4SChristophe Lombard __be64 flags; 41444c4ba4SChristophe Lombard u8 reserved0[12]; 42444c4ba4SChristophe Lombard __be32 pslVirtualIsn; 43444c4ba4SChristophe Lombard u8 applicationVirtualIsnBitmap[256]; 44444c4ba4SChristophe Lombard u8 reserved1[144]; 45444c4ba4SChristophe Lombard struct cxl_process_element_common common; 46444c4ba4SChristophe Lombard u8 reserved4[12]; 47444c4ba4SChristophe Lombard } __packed; 48444c4ba4SChristophe Lombard 49444c4ba4SChristophe Lombard #define H_STATE_NORMAL 1 50444c4ba4SChristophe Lombard #define H_STATE_DISABLE 2 51444c4ba4SChristophe Lombard #define H_STATE_TEMP_UNAVAILABLE 3 52444c4ba4SChristophe Lombard #define H_STATE_PERM_UNAVAILABLE 4 53444c4ba4SChristophe Lombard 54444c4ba4SChristophe Lombard /* NOTE: element must be a logical real address, and must be pinned */ 55444c4ba4SChristophe Lombard long cxl_h_attach_process(u64 unit_address, struct cxl_process_element_hcall *element, 56444c4ba4SChristophe Lombard u64 *process_token, u64 *mmio_addr, u64 *mmio_size); 57444c4ba4SChristophe Lombard 58444c4ba4SChristophe Lombard /** 59444c4ba4SChristophe Lombard * cxl_h_detach_process - Detach a process element from a coherent 60444c4ba4SChristophe Lombard * platform function. 61444c4ba4SChristophe Lombard */ 62444c4ba4SChristophe Lombard long cxl_h_detach_process(u64 unit_address, u64 process_token); 63444c4ba4SChristophe Lombard 64444c4ba4SChristophe Lombard /** 65444c4ba4SChristophe Lombard * cxl_h_reset_afu - Perform a reset to the coherent platform function. 66444c4ba4SChristophe Lombard */ 67444c4ba4SChristophe Lombard long cxl_h_reset_afu(u64 unit_address); 68444c4ba4SChristophe Lombard 69444c4ba4SChristophe Lombard /** 70444c4ba4SChristophe Lombard * cxl_h_suspend_process - Suspend a process from being executed 71444c4ba4SChristophe Lombard * Parameter1 = process-token as returned from H_ATTACH_CA_PROCESS when 72444c4ba4SChristophe Lombard * process was attached. 73444c4ba4SChristophe Lombard */ 74444c4ba4SChristophe Lombard long cxl_h_suspend_process(u64 unit_address, u64 process_token); 75444c4ba4SChristophe Lombard 76444c4ba4SChristophe Lombard /** 77444c4ba4SChristophe Lombard * cxl_h_resume_process - Resume a process to be executed 78444c4ba4SChristophe Lombard * Parameter1 = process-token as returned from H_ATTACH_CA_PROCESS when 79444c4ba4SChristophe Lombard * process was attached. 80444c4ba4SChristophe Lombard */ 81444c4ba4SChristophe Lombard long cxl_h_resume_process(u64 unit_address, u64 process_token); 82444c4ba4SChristophe Lombard 83444c4ba4SChristophe Lombard /** 84444c4ba4SChristophe Lombard * cxl_h_read_error_state - Reads the error state of the coherent 85444c4ba4SChristophe Lombard * platform function. 86444c4ba4SChristophe Lombard * R4 contains the error state 87444c4ba4SChristophe Lombard */ 88444c4ba4SChristophe Lombard long cxl_h_read_error_state(u64 unit_address, u64 *state); 89444c4ba4SChristophe Lombard 90444c4ba4SChristophe Lombard /** 91444c4ba4SChristophe Lombard * cxl_h_get_afu_err - collect the AFU error buffer 92444c4ba4SChristophe Lombard * Parameter1 = byte offset into error buffer to retrieve, valid values 93444c4ba4SChristophe Lombard * are between 0 and (ibm,error-buffer-size - 1) 94444c4ba4SChristophe Lombard * Parameter2 = 4K aligned real address of error buffer, to be filled in 95444c4ba4SChristophe Lombard * Parameter3 = length of error buffer, valid values are 4K or less 96444c4ba4SChristophe Lombard */ 97444c4ba4SChristophe Lombard long cxl_h_get_afu_err(u64 unit_address, u64 offset, u64 buf_address, u64 len); 98444c4ba4SChristophe Lombard 99444c4ba4SChristophe Lombard /** 100444c4ba4SChristophe Lombard * cxl_h_get_config - collect configuration record for the 101444c4ba4SChristophe Lombard * coherent platform function 102444c4ba4SChristophe Lombard * Parameter1 = # of configuration record to retrieve, valid values are 103444c4ba4SChristophe Lombard * between 0 and (ibm,#config-records - 1) 104444c4ba4SChristophe Lombard * Parameter2 = byte offset into configuration record to retrieve, 105444c4ba4SChristophe Lombard * valid values are between 0 and (ibm,config-record-size - 1) 106444c4ba4SChristophe Lombard * Parameter3 = 4K aligned real address of configuration record buffer, 107444c4ba4SChristophe Lombard * to be filled in 108444c4ba4SChristophe Lombard * Parameter4 = length of configuration buffer, valid values are 4K or less 109444c4ba4SChristophe Lombard */ 110444c4ba4SChristophe Lombard long cxl_h_get_config(u64 unit_address, u64 cr_num, u64 offset, 111444c4ba4SChristophe Lombard u64 buf_address, u64 len); 112444c4ba4SChristophe Lombard 113444c4ba4SChristophe Lombard /** 114444c4ba4SChristophe Lombard * cxl_h_terminate_process - Terminate the process before completion 115444c4ba4SChristophe Lombard * Parameter1 = process-token as returned from H_ATTACH_CA_PROCESS when 116444c4ba4SChristophe Lombard * process was attached. 117444c4ba4SChristophe Lombard */ 118444c4ba4SChristophe Lombard long cxl_h_terminate_process(u64 unit_address, u64 process_token); 119444c4ba4SChristophe Lombard 120444c4ba4SChristophe Lombard /** 121444c4ba4SChristophe Lombard * cxl_h_collect_vpd - Collect VPD for the coherent platform function. 122444c4ba4SChristophe Lombard * Parameter1 = # of VPD record to retrieve, valid values are between 0 123444c4ba4SChristophe Lombard * and (ibm,#config-records - 1). 124444c4ba4SChristophe Lombard * Parameter2 = 4K naturally aligned real buffer containing block 125444c4ba4SChristophe Lombard * list entries 126444c4ba4SChristophe Lombard * Parameter3 = number of block list entries in the block list, valid 127444c4ba4SChristophe Lombard * values are between 0 and 256 128444c4ba4SChristophe Lombard */ 129444c4ba4SChristophe Lombard long cxl_h_collect_vpd(u64 unit_address, u64 record, u64 list_address, 130444c4ba4SChristophe Lombard u64 num, u64 *out); 131444c4ba4SChristophe Lombard 132444c4ba4SChristophe Lombard /** 133444c4ba4SChristophe Lombard * cxl_h_get_fn_error_interrupt - Read the function-wide error data based on an interrupt 134444c4ba4SChristophe Lombard */ 135444c4ba4SChristophe Lombard long cxl_h_get_fn_error_interrupt(u64 unit_address, u64 *reg); 136444c4ba4SChristophe Lombard 137444c4ba4SChristophe Lombard /** 138444c4ba4SChristophe Lombard * cxl_h_ack_fn_error_interrupt - Acknowledge function-wide error data 139444c4ba4SChristophe Lombard * based on an interrupt 140444c4ba4SChristophe Lombard * Parameter1 = value to write to the function-wide error interrupt register 141444c4ba4SChristophe Lombard */ 142444c4ba4SChristophe Lombard long cxl_h_ack_fn_error_interrupt(u64 unit_address, u64 value); 143444c4ba4SChristophe Lombard 144444c4ba4SChristophe Lombard /** 145444c4ba4SChristophe Lombard * cxl_h_get_error_log - Retrieve the Platform Log ID (PLID) of 146444c4ba4SChristophe Lombard * an error log 147444c4ba4SChristophe Lombard */ 148444c4ba4SChristophe Lombard long cxl_h_get_error_log(u64 unit_address, u64 value); 149444c4ba4SChristophe Lombard 150444c4ba4SChristophe Lombard /** 151444c4ba4SChristophe Lombard * cxl_h_collect_int_info - Collect interrupt info about a coherent 152444c4ba4SChristophe Lombard * platform function after an interrupt occurred. 153444c4ba4SChristophe Lombard */ 154444c4ba4SChristophe Lombard long cxl_h_collect_int_info(u64 unit_address, u64 process_token, 155444c4ba4SChristophe Lombard struct cxl_irq_info *info); 156444c4ba4SChristophe Lombard 157444c4ba4SChristophe Lombard /** 158444c4ba4SChristophe Lombard * cxl_h_control_faults - Control the operation of a coherent platform 159444c4ba4SChristophe Lombard * function after a fault occurs. 160444c4ba4SChristophe Lombard * 161444c4ba4SChristophe Lombard * Parameters 162444c4ba4SChristophe Lombard * control-mask: value to control the faults 163444c4ba4SChristophe Lombard * looks like PSL_TFC_An shifted >> 32 164444c4ba4SChristophe Lombard * reset-mask: mask to control reset of function faults 165444c4ba4SChristophe Lombard * Set reset_mask = 1 to reset PSL errors 166444c4ba4SChristophe Lombard */ 167444c4ba4SChristophe Lombard long cxl_h_control_faults(u64 unit_address, u64 process_token, 168444c4ba4SChristophe Lombard u64 control_mask, u64 reset_mask); 169444c4ba4SChristophe Lombard 170444c4ba4SChristophe Lombard /** 171444c4ba4SChristophe Lombard * cxl_h_reset_adapter - Perform a reset to the coherent platform facility. 172444c4ba4SChristophe Lombard */ 173444c4ba4SChristophe Lombard long cxl_h_reset_adapter(u64 unit_address); 174444c4ba4SChristophe Lombard 175444c4ba4SChristophe Lombard /** 176444c4ba4SChristophe Lombard * cxl_h_collect_vpd - Collect VPD for the coherent platform function. 177444c4ba4SChristophe Lombard * Parameter1 = 4K naturally aligned real buffer containing block 178444c4ba4SChristophe Lombard * list entries 179444c4ba4SChristophe Lombard * Parameter2 = number of block list entries in the block list, valid 180444c4ba4SChristophe Lombard * values are between 0 and 256 181444c4ba4SChristophe Lombard */ 182444c4ba4SChristophe Lombard long cxl_h_collect_vpd_adapter(u64 unit_address, u64 list_address, 183444c4ba4SChristophe Lombard u64 num, u64 *out); 184444c4ba4SChristophe Lombard 185444c4ba4SChristophe Lombard /** 186444c4ba4SChristophe Lombard * cxl_h_download_adapter_image - Download the base image to the coherent 187444c4ba4SChristophe Lombard * platform facility. 188444c4ba4SChristophe Lombard */ 189444c4ba4SChristophe Lombard long cxl_h_download_adapter_image(u64 unit_address, 190444c4ba4SChristophe Lombard u64 list_address, u64 num, 191444c4ba4SChristophe Lombard u64 *out); 192444c4ba4SChristophe Lombard 193444c4ba4SChristophe Lombard /** 194444c4ba4SChristophe Lombard * cxl_h_validate_adapter_image - Validate the base image in the coherent 195444c4ba4SChristophe Lombard * platform facility. 196444c4ba4SChristophe Lombard */ 197444c4ba4SChristophe Lombard long cxl_h_validate_adapter_image(u64 unit_address, 198444c4ba4SChristophe Lombard u64 list_address, u64 num, 199444c4ba4SChristophe Lombard u64 *out); 200444c4ba4SChristophe Lombard #endif /* _HCALLS_H */ 201