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