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