1 /* SPDX-License-Identifier: GPL-2.0 WITH Linux-syscall-note */
2 /*
3  * Header File for FPGA DFL User API
4  *
5  * Copyright (C) 2017-2018 Intel Corporation, Inc.
6  *
7  * Authors:
8  *   Kang Luwei <luwei.kang@intel.com>
9  *   Zhang Yi <yi.z.zhang@intel.com>
10  *   Wu Hao <hao.wu@intel.com>
11  *   Xiao Guangrong <guangrong.xiao@linux.intel.com>
12  */
13 
14 #ifndef _UAPI_LINUX_FPGA_DFL_H
15 #define _UAPI_LINUX_FPGA_DFL_H
16 
17 #include <linux/types.h>
18 #include <linux/ioctl.h>
19 
20 #define DFL_FPGA_API_VERSION 0
21 
22 /*
23  * The IOCTL interface for DFL based FPGA is designed for extensibility by
24  * embedding the structure length (argsz) and flags into structures passed
25  * between kernel and userspace. This design referenced the VFIO IOCTL
26  * interface (include/uapi/linux/vfio.h).
27  */
28 
29 #define DFL_FPGA_MAGIC 0xB6
30 
31 #define DFL_FPGA_BASE 0
32 #define DFL_PORT_BASE 0x40
33 #define DFL_FME_BASE 0x80
34 
35 /* Common IOCTLs for both FME and AFU file descriptor */
36 
37 /**
38  * DFL_FPGA_GET_API_VERSION - _IO(DFL_FPGA_MAGIC, DFL_FPGA_BASE + 0)
39  *
40  * Report the version of the driver API.
41  * Return: Driver API Version.
42  */
43 
44 #define DFL_FPGA_GET_API_VERSION	_IO(DFL_FPGA_MAGIC, DFL_FPGA_BASE + 0)
45 
46 /**
47  * DFL_FPGA_CHECK_EXTENSION - _IO(DFL_FPGA_MAGIC, DFL_FPGA_BASE + 1)
48  *
49  * Check whether an extension is supported.
50  * Return: 0 if not supported, otherwise the extension is supported.
51  */
52 
53 #define DFL_FPGA_CHECK_EXTENSION	_IO(DFL_FPGA_MAGIC, DFL_FPGA_BASE + 1)
54 
55 /* IOCTLs for AFU file descriptor */
56 
57 /**
58  * DFL_FPGA_PORT_RESET - _IO(DFL_FPGA_MAGIC, DFL_PORT_BASE + 0)
59  *
60  * Reset the FPGA Port and its AFU. No parameters are supported.
61  * Userspace can do Port reset at any time, e.g. during DMA or PR. But
62  * it should never cause any system level issue, only functional failure
63  * (e.g. DMA or PR operation failure) and be recoverable from the failure.
64  * Return: 0 on success, -errno of failure
65  */
66 
67 #define DFL_FPGA_PORT_RESET		_IO(DFL_FPGA_MAGIC, DFL_PORT_BASE + 0)
68 
69 /**
70  * DFL_FPGA_PORT_GET_INFO - _IOR(DFL_FPGA_MAGIC, DFL_PORT_BASE + 1,
71  *						struct dfl_fpga_port_info)
72  *
73  * Retrieve information about the fpga port.
74  * Driver fills the info in provided struct dfl_fpga_port_info.
75  * Return: 0 on success, -errno on failure.
76  */
77 struct dfl_fpga_port_info {
78 	/* Input */
79 	__u32 argsz;		/* Structure length */
80 	/* Output */
81 	__u32 flags;		/* Zero for now */
82 	__u32 num_regions;	/* The number of supported regions */
83 	__u32 num_umsgs;	/* The number of allocated umsgs */
84 };
85 
86 #define DFL_FPGA_PORT_GET_INFO		_IO(DFL_FPGA_MAGIC, DFL_PORT_BASE + 1)
87 
88 /**
89  * FPGA_PORT_GET_REGION_INFO - _IOWR(FPGA_MAGIC, PORT_BASE + 2,
90  *					struct dfl_fpga_port_region_info)
91  *
92  * Retrieve information about a device memory region.
93  * Caller provides struct dfl_fpga_port_region_info with index value set.
94  * Driver returns the region info in other fields.
95  * Return: 0 on success, -errno on failure.
96  */
97 struct dfl_fpga_port_region_info {
98 	/* input */
99 	__u32 argsz;		/* Structure length */
100 	/* Output */
101 	__u32 flags;		/* Access permission */
102 #define DFL_PORT_REGION_READ	(1 << 0)	/* Region is readable */
103 #define DFL_PORT_REGION_WRITE	(1 << 1)	/* Region is writable */
104 #define DFL_PORT_REGION_MMAP	(1 << 2)	/* Can be mmaped to userspace */
105 	/* Input */
106 	__u32 index;		/* Region index */
107 #define DFL_PORT_REGION_INDEX_AFU	0	/* AFU */
108 #define DFL_PORT_REGION_INDEX_STP	1	/* Signal Tap */
109 	__u32 padding;
110 	/* Output */
111 	__u64 size;		/* Region size (bytes) */
112 	__u64 offset;		/* Region offset from start of device fd */
113 };
114 
115 #define DFL_FPGA_PORT_GET_REGION_INFO	_IO(DFL_FPGA_MAGIC, DFL_PORT_BASE + 2)
116 
117 /**
118  * DFL_FPGA_PORT_DMA_MAP - _IOWR(DFL_FPGA_MAGIC, DFL_PORT_BASE + 3,
119  *						struct dfl_fpga_port_dma_map)
120  *
121  * Map the dma memory per user_addr and length which are provided by caller.
122  * Driver fills the iova in provided struct afu_port_dma_map.
123  * This interface only accepts page-size aligned user memory for dma mapping.
124  * Return: 0 on success, -errno on failure.
125  */
126 struct dfl_fpga_port_dma_map {
127 	/* Input */
128 	__u32 argsz;		/* Structure length */
129 	__u32 flags;		/* Zero for now */
130 	__u64 user_addr;        /* Process virtual address */
131 	__u64 length;           /* Length of mapping (bytes)*/
132 	/* Output */
133 	__u64 iova;             /* IO virtual address */
134 };
135 
136 #define DFL_FPGA_PORT_DMA_MAP		_IO(DFL_FPGA_MAGIC, DFL_PORT_BASE + 3)
137 
138 /**
139  * DFL_FPGA_PORT_DMA_UNMAP - _IOW(FPGA_MAGIC, PORT_BASE + 4,
140  *						struct dfl_fpga_port_dma_unmap)
141  *
142  * Unmap the dma memory per iova provided by caller.
143  * Return: 0 on success, -errno on failure.
144  */
145 struct dfl_fpga_port_dma_unmap {
146 	/* Input */
147 	__u32 argsz;		/* Structure length */
148 	__u32 flags;		/* Zero for now */
149 	__u64 iova;		/* IO virtual address */
150 };
151 
152 #define DFL_FPGA_PORT_DMA_UNMAP		_IO(DFL_FPGA_MAGIC, DFL_PORT_BASE + 4)
153 
154 /**
155  * struct dfl_fpga_irq_set - the argument for DFL_FPGA_XXX_SET_IRQ ioctl.
156  *
157  * @start: Index of the first irq.
158  * @count: The number of eventfd handler.
159  * @evtfds: Eventfd handlers.
160  */
161 struct dfl_fpga_irq_set {
162 	__u32 start;
163 	__u32 count;
164 	__s32 evtfds[];
165 };
166 
167 /**
168  * DFL_FPGA_PORT_ERR_GET_IRQ_NUM - _IOR(DFL_FPGA_MAGIC, DFL_PORT_BASE + 5,
169  *								__u32 num_irqs)
170  *
171  * Get the number of irqs supported by the fpga port error reporting private
172  * feature. Currently hardware supports up to 1 irq.
173  * Return: 0 on success, -errno on failure.
174  */
175 #define DFL_FPGA_PORT_ERR_GET_IRQ_NUM	_IOR(DFL_FPGA_MAGIC,	\
176 					     DFL_PORT_BASE + 5, __u32)
177 
178 /**
179  * DFL_FPGA_PORT_ERR_SET_IRQ - _IOW(DFL_FPGA_MAGIC, DFL_PORT_BASE + 6,
180  *						struct dfl_fpga_irq_set)
181  *
182  * Set fpga port error reporting interrupt trigger if evtfds[n] is valid.
183  * Unset related interrupt trigger if evtfds[n] is a negative value.
184  * Return: 0 on success, -errno on failure.
185  */
186 #define DFL_FPGA_PORT_ERR_SET_IRQ	_IOW(DFL_FPGA_MAGIC,	\
187 					     DFL_PORT_BASE + 6,	\
188 					     struct dfl_fpga_irq_set)
189 
190 /**
191  * DFL_FPGA_PORT_UINT_GET_IRQ_NUM - _IOR(DFL_FPGA_MAGIC, DFL_PORT_BASE + 7,
192  *								__u32 num_irqs)
193  *
194  * Get the number of irqs supported by the fpga AFU interrupt private
195  * feature.
196  * Return: 0 on success, -errno on failure.
197  */
198 #define DFL_FPGA_PORT_UINT_GET_IRQ_NUM	_IOR(DFL_FPGA_MAGIC,	\
199 					     DFL_PORT_BASE + 7, __u32)
200 
201 /**
202  * DFL_FPGA_PORT_UINT_SET_IRQ - _IOW(DFL_FPGA_MAGIC, DFL_PORT_BASE + 8,
203  *						struct dfl_fpga_irq_set)
204  *
205  * Set fpga AFU interrupt trigger if evtfds[n] is valid.
206  * Unset related interrupt trigger if evtfds[n] is a negative value.
207  * Return: 0 on success, -errno on failure.
208  */
209 #define DFL_FPGA_PORT_UINT_SET_IRQ	_IOW(DFL_FPGA_MAGIC,	\
210 					     DFL_PORT_BASE + 8,	\
211 					     struct dfl_fpga_irq_set)
212 
213 /* IOCTLs for FME file descriptor */
214 
215 /**
216  * DFL_FPGA_FME_PORT_PR - _IOW(DFL_FPGA_MAGIC, DFL_FME_BASE + 0,
217  *						struct dfl_fpga_fme_port_pr)
218  *
219  * Driver does Partial Reconfiguration based on Port ID and Buffer (Image)
220  * provided by caller.
221  * Return: 0 on success, -errno on failure.
222  * If DFL_FPGA_FME_PORT_PR returns -EIO, that indicates the HW has detected
223  * some errors during PR, under this case, the user can fetch HW error info
224  * from the status of FME's fpga manager.
225  */
226 
227 struct dfl_fpga_fme_port_pr {
228 	/* Input */
229 	__u32 argsz;		/* Structure length */
230 	__u32 flags;		/* Zero for now */
231 	__u32 port_id;
232 	__u32 buffer_size;
233 	__u64 buffer_address;	/* Userspace address to the buffer for PR */
234 };
235 
236 #define DFL_FPGA_FME_PORT_PR	_IO(DFL_FPGA_MAGIC, DFL_FME_BASE + 0)
237 
238 /**
239  * DFL_FPGA_FME_PORT_RELEASE - _IOW(DFL_FPGA_MAGIC, DFL_FME_BASE + 1,
240  *						int port_id)
241  *
242  * Driver releases the port per Port ID provided by caller.
243  * Return: 0 on success, -errno on failure.
244  */
245 #define DFL_FPGA_FME_PORT_RELEASE   _IOW(DFL_FPGA_MAGIC, DFL_FME_BASE + 1, int)
246 
247 /**
248  * DFL_FPGA_FME_PORT_ASSIGN - _IOW(DFL_FPGA_MAGIC, DFL_FME_BASE + 2,
249  *						int port_id)
250  *
251  * Driver assigns the port back per Port ID provided by caller.
252  * Return: 0 on success, -errno on failure.
253  */
254 #define DFL_FPGA_FME_PORT_ASSIGN     _IOW(DFL_FPGA_MAGIC, DFL_FME_BASE + 2, int)
255 
256 /**
257  * DFL_FPGA_FME_ERR_GET_IRQ_NUM - _IOR(DFL_FPGA_MAGIC, DFL_FME_BASE + 3,
258  *							__u32 num_irqs)
259  *
260  * Get the number of irqs supported by the fpga fme error reporting private
261  * feature. Currently hardware supports up to 1 irq.
262  * Return: 0 on success, -errno on failure.
263  */
264 #define DFL_FPGA_FME_ERR_GET_IRQ_NUM	_IOR(DFL_FPGA_MAGIC,	\
265 					     DFL_FME_BASE + 3, __u32)
266 
267 /**
268  * DFL_FPGA_FME_ERR_SET_IRQ - _IOW(DFL_FPGA_MAGIC, DFL_FME_BASE + 4,
269  *						struct dfl_fpga_irq_set)
270  *
271  * Set fpga fme error reporting interrupt trigger if evtfds[n] is valid.
272  * Unset related interrupt trigger if evtfds[n] is a negative value.
273  * Return: 0 on success, -errno on failure.
274  */
275 #define DFL_FPGA_FME_ERR_SET_IRQ	_IOW(DFL_FPGA_MAGIC,	\
276 					     DFL_FME_BASE + 4,	\
277 					     struct dfl_fpga_irq_set)
278 
279 #endif /* _UAPI_LINUX_FPGA_DFL_H */
280