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 0x0000000000000001ULL |
63 | #define CXL_AI_ALL CXL_AI_NEED_HEADER |
64 | |
65 | #define 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 { |
103 | __u16 ; |
104 | __u16 ; |
105 | __u16 ; |
106 | __u16 ; |
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 ; |
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 | |