1 /* 2 * Copyright 2014 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 _UAPI_MISC_CXL_H 11 #define _UAPI_MISC_CXL_H 12 13 #include <linux/types.h> 14 #include <linux/ioctl.h> 15 16 17 struct cxl_ioctl_start_work { 18 __u64 flags; 19 __u64 work_element_descriptor; 20 __u64 amr; 21 __s16 num_interrupts; 22 __s16 reserved1; 23 __s32 reserved2; 24 __u64 reserved3; 25 __u64 reserved4; 26 __u64 reserved5; 27 __u64 reserved6; 28 }; 29 30 #define CXL_START_WORK_AMR 0x0000000000000001ULL 31 #define CXL_START_WORK_NUM_IRQS 0x0000000000000002ULL 32 #define CXL_START_WORK_ERR_FF 0x0000000000000004ULL 33 #define CXL_START_WORK_ALL (CXL_START_WORK_AMR |\ 34 CXL_START_WORK_NUM_IRQS |\ 35 CXL_START_WORK_ERR_FF) 36 37 38 /* Possible modes that an afu can be in */ 39 #define CXL_MODE_DEDICATED 0x1 40 #define CXL_MODE_DIRECTED 0x2 41 42 /* possible flags for the cxl_afu_id flags field */ 43 #define CXL_AFUID_FLAG_SLAVE 0x1 /* In directed-mode afu is in slave mode */ 44 45 struct cxl_afu_id { 46 __u64 flags; /* One of CXL_AFUID_FLAG_X */ 47 __u32 card_id; 48 __u32 afu_offset; 49 __u32 afu_mode; /* one of the CXL_MODE_X */ 50 __u32 reserved1; 51 __u64 reserved2; 52 __u64 reserved3; 53 __u64 reserved4; 54 __u64 reserved5; 55 __u64 reserved6; 56 }; 57 58 /* base adapter image header is included in the image */ 59 #define CXL_AI_NEED_HEADER 0x0000000000000001ULL 60 #define CXL_AI_ALL CXL_AI_NEED_HEADER 61 62 #define CXL_AI_HEADER_SIZE 128 63 #define CXL_AI_BUFFER_SIZE 4096 64 #define CXL_AI_MAX_ENTRIES 256 65 #define CXL_AI_MAX_CHUNK_SIZE (CXL_AI_BUFFER_SIZE * CXL_AI_MAX_ENTRIES) 66 67 struct cxl_adapter_image { 68 __u64 flags; 69 __u64 data; 70 __u64 len_data; 71 __u64 len_image; 72 __u64 reserved1; 73 __u64 reserved2; 74 __u64 reserved3; 75 __u64 reserved4; 76 }; 77 78 /* ioctl numbers */ 79 #define CXL_MAGIC 0xCA 80 /* AFU devices */ 81 #define CXL_IOCTL_START_WORK _IOW(CXL_MAGIC, 0x00, struct cxl_ioctl_start_work) 82 #define CXL_IOCTL_GET_PROCESS_ELEMENT _IOR(CXL_MAGIC, 0x01, __u32) 83 #define CXL_IOCTL_GET_AFU_ID _IOR(CXL_MAGIC, 0x02, struct cxl_afu_id) 84 /* adapter devices */ 85 #define CXL_IOCTL_DOWNLOAD_IMAGE _IOW(CXL_MAGIC, 0x0A, struct cxl_adapter_image) 86 #define CXL_IOCTL_VALIDATE_IMAGE _IOW(CXL_MAGIC, 0x0B, struct cxl_adapter_image) 87 88 #define CXL_READ_MIN_SIZE 0x1000 /* 4K */ 89 90 /* Events from read() */ 91 enum cxl_event_type { 92 CXL_EVENT_RESERVED = 0, 93 CXL_EVENT_AFU_INTERRUPT = 1, 94 CXL_EVENT_DATA_STORAGE = 2, 95 CXL_EVENT_AFU_ERROR = 3, 96 CXL_EVENT_AFU_DRIVER = 4, 97 }; 98 99 struct cxl_event_header { 100 __u16 type; 101 __u16 size; 102 __u16 process_element; 103 __u16 reserved1; 104 }; 105 106 struct cxl_event_afu_interrupt { 107 __u16 flags; 108 __u16 irq; /* Raised AFU interrupt number */ 109 __u32 reserved1; 110 }; 111 112 struct cxl_event_data_storage { 113 __u16 flags; 114 __u16 reserved1; 115 __u32 reserved2; 116 __u64 addr; 117 __u64 dsisr; 118 __u64 reserved3; 119 }; 120 121 struct cxl_event_afu_error { 122 __u16 flags; 123 __u16 reserved1; 124 __u32 reserved2; 125 __u64 error; 126 }; 127 128 struct cxl_event_afu_driver_reserved { 129 /* 130 * Defines the buffer passed to the cxl driver by the AFU driver. 131 * 132 * This is not ABI since the event header.size passed to the user for 133 * existing events is set in the read call to sizeof(cxl_event_header) 134 * + sizeof(whatever event is being dispatched) and the user is already 135 * required to use a 4K buffer on the read call. 136 * 137 * Of course the contents will be ABI, but that's up the AFU driver. 138 */ 139 __u32 data_size; 140 __u8 data[]; 141 }; 142 143 struct cxl_event { 144 struct cxl_event_header header; 145 union { 146 struct cxl_event_afu_interrupt irq; 147 struct cxl_event_data_storage fault; 148 struct cxl_event_afu_error afu_error; 149 struct cxl_event_afu_driver_reserved afu_driver_event; 150 }; 151 }; 152 153 #endif /* _UAPI_MISC_CXL_H */ 154