1 /* SPDX-License-Identifier: GPL-2.0 WITH Linux-syscall-note 2 * 3 * Copyright (c) 2019-2020, The Linux Foundation. All rights reserved. 4 * Copyright (c) 2021-2023 Qualcomm Innovation Center, Inc. All rights reserved. 5 */ 6 7 #ifndef QAIC_ACCEL_H_ 8 #define QAIC_ACCEL_H_ 9 10 #include "drm.h" 11 12 #if defined(__cplusplus) 13 extern "C" { 14 #endif 15 16 /* The length(4K) includes len and count fields of qaic_manage_msg */ 17 #define QAIC_MANAGE_MAX_MSG_LENGTH SZ_4K 18 19 /* semaphore flags */ 20 #define QAIC_SEM_INSYNCFENCE 2 21 #define QAIC_SEM_OUTSYNCFENCE 1 22 23 /* Semaphore commands */ 24 #define QAIC_SEM_NOP 0 25 #define QAIC_SEM_INIT 1 26 #define QAIC_SEM_INC 2 27 #define QAIC_SEM_DEC 3 28 #define QAIC_SEM_WAIT_EQUAL 4 29 #define QAIC_SEM_WAIT_GT_EQ 5 /* Greater than or equal */ 30 #define QAIC_SEM_WAIT_GT_0 6 /* Greater than 0 */ 31 32 #define QAIC_TRANS_UNDEFINED 0 33 #define QAIC_TRANS_PASSTHROUGH_FROM_USR 1 34 #define QAIC_TRANS_PASSTHROUGH_TO_USR 2 35 #define QAIC_TRANS_PASSTHROUGH_FROM_DEV 3 36 #define QAIC_TRANS_PASSTHROUGH_TO_DEV 4 37 #define QAIC_TRANS_DMA_XFER_FROM_USR 5 38 #define QAIC_TRANS_DMA_XFER_TO_DEV 6 39 #define QAIC_TRANS_ACTIVATE_FROM_USR 7 40 #define QAIC_TRANS_ACTIVATE_FROM_DEV 8 41 #define QAIC_TRANS_ACTIVATE_TO_DEV 9 42 #define QAIC_TRANS_DEACTIVATE_FROM_USR 10 43 #define QAIC_TRANS_DEACTIVATE_FROM_DEV 11 44 #define QAIC_TRANS_STATUS_FROM_USR 12 45 #define QAIC_TRANS_STATUS_TO_USR 13 46 #define QAIC_TRANS_STATUS_FROM_DEV 14 47 #define QAIC_TRANS_STATUS_TO_DEV 15 48 #define QAIC_TRANS_TERMINATE_FROM_DEV 16 49 #define QAIC_TRANS_TERMINATE_TO_DEV 17 50 #define QAIC_TRANS_DMA_XFER_CONT 18 51 #define QAIC_TRANS_VALIDATE_PARTITION_FROM_DEV 19 52 #define QAIC_TRANS_VALIDATE_PARTITION_TO_DEV 20 53 54 /** 55 * struct qaic_manage_trans_hdr - Header for a transaction in a manage message. 56 * @type: In. Identifies this transaction. See QAIC_TRANS_* defines. 57 * @len: In. Length of this transaction, including this header. 58 */ 59 struct qaic_manage_trans_hdr { 60 __u32 type; 61 __u32 len; 62 }; 63 64 /** 65 * struct qaic_manage_trans_passthrough - Defines a passthrough transaction. 66 * @hdr: In. Header to identify this transaction. 67 * @data: In. Payload of this ransaction. Opaque to the driver. Userspace must 68 * encode in little endian and align/pad to 64-bit. 69 */ 70 struct qaic_manage_trans_passthrough { 71 struct qaic_manage_trans_hdr hdr; 72 __u8 data[]; 73 }; 74 75 /** 76 * struct qaic_manage_trans_dma_xfer - Defines a DMA transfer transaction. 77 * @hdr: In. Header to identify this transaction. 78 * @tag: In. Identified this transfer in other transactions. Opaque to the 79 * driver. 80 * @pad: Structure padding. 81 * @addr: In. Address of the data to DMA to the device. 82 * @size: In. Length of the data to DMA to the device. 83 */ 84 struct qaic_manage_trans_dma_xfer { 85 struct qaic_manage_trans_hdr hdr; 86 __u32 tag; 87 __u32 pad; 88 __u64 addr; 89 __u64 size; 90 }; 91 92 /** 93 * struct qaic_manage_trans_activate_to_dev - Defines an activate request. 94 * @hdr: In. Header to identify this transaction. 95 * @queue_size: In. Number of elements for DBC request and response queues. 96 * @eventfd: Unused. 97 * @options: In. Device specific options for this activate. 98 * @pad: Structure padding. Must be 0. 99 */ 100 struct qaic_manage_trans_activate_to_dev { 101 struct qaic_manage_trans_hdr hdr; 102 __u32 queue_size; 103 __u32 eventfd; 104 __u32 options; 105 __u32 pad; 106 }; 107 108 /** 109 * struct qaic_manage_trans_activate_from_dev - Defines an activate response. 110 * @hdr: Out. Header to identify this transaction. 111 * @status: Out. Return code of the request from the device. 112 * @dbc_id: Out. Id of the assigned DBC for successful request. 113 * @options: Out. Device specific options for this activate. 114 */ 115 struct qaic_manage_trans_activate_from_dev { 116 struct qaic_manage_trans_hdr hdr; 117 __u32 status; 118 __u32 dbc_id; 119 __u64 options; 120 }; 121 122 /** 123 * struct qaic_manage_trans_deactivate - Defines a deactivate request. 124 * @hdr: In. Header to identify this transaction. 125 * @dbc_id: In. Id of assigned DBC. 126 * @pad: Structure padding. Must be 0. 127 */ 128 struct qaic_manage_trans_deactivate { 129 struct qaic_manage_trans_hdr hdr; 130 __u32 dbc_id; 131 __u32 pad; 132 }; 133 134 /** 135 * struct qaic_manage_trans_status_to_dev - Defines a status request. 136 * @hdr: In. Header to identify this transaction. 137 */ 138 struct qaic_manage_trans_status_to_dev { 139 struct qaic_manage_trans_hdr hdr; 140 }; 141 142 /** 143 * struct qaic_manage_trans_status_from_dev - Defines a status response. 144 * @hdr: Out. Header to identify this transaction. 145 * @major: Out. NNC protocol version major number. 146 * @minor: Out. NNC protocol version minor number. 147 * @status: Out. Return code from device. 148 * @status_flags: Out. Flags from device. Bit 0 indicates if CRCs are required. 149 */ 150 struct qaic_manage_trans_status_from_dev { 151 struct qaic_manage_trans_hdr hdr; 152 __u16 major; 153 __u16 minor; 154 __u32 status; 155 __u64 status_flags; 156 }; 157 158 /** 159 * struct qaic_manage_msg - Defines a message to the device. 160 * @len: In. Length of all the transactions contained within this message. 161 * @count: In. Number of transactions in this message. 162 * @data: In. Address to an array where the transactions can be found. 163 */ 164 struct qaic_manage_msg { 165 __u32 len; 166 __u32 count; 167 __u64 data; 168 }; 169 170 /** 171 * struct qaic_create_bo - Defines a request to create a buffer object. 172 * @size: In. Size of the buffer in bytes. 173 * @handle: Out. GEM handle for the BO. 174 * @pad: Structure padding. Must be 0. 175 */ 176 struct qaic_create_bo { 177 __u64 size; 178 __u32 handle; 179 __u32 pad; 180 }; 181 182 /** 183 * struct qaic_mmap_bo - Defines a request to prepare a BO for mmap(). 184 * @handle: In. Handle of the GEM BO to prepare for mmap(). 185 * @pad: Structure padding. Must be 0. 186 * @offset: Out. Offset value to provide to mmap(). 187 */ 188 struct qaic_mmap_bo { 189 __u32 handle; 190 __u32 pad; 191 __u64 offset; 192 }; 193 194 /** 195 * struct qaic_sem - Defines a semaphore command for a BO slice. 196 * @val: In. Only lower 12 bits are valid. 197 * @index: In. Only lower 5 bits are valid. 198 * @presync: In. 1 if presync operation, 0 if postsync. 199 * @cmd: In. One of QAIC_SEM_*. 200 * @flags: In. Bitfield. See QAIC_SEM_INSYNCFENCE and QAIC_SEM_OUTSYNCFENCE 201 * @pad: Structure padding. Must be 0. 202 */ 203 struct qaic_sem { 204 __u16 val; 205 __u8 index; 206 __u8 presync; 207 __u8 cmd; 208 __u8 flags; 209 __u16 pad; 210 }; 211 212 /** 213 * struct qaic_attach_slice_entry - Defines a single BO slice. 214 * @size: In. Size of this slice in bytes. 215 * @sem0: In. Semaphore command 0. Must be 0 is not valid. 216 * @sem1: In. Semaphore command 1. Must be 0 is not valid. 217 * @sem2: In. Semaphore command 2. Must be 0 is not valid. 218 * @sem3: In. Semaphore command 3. Must be 0 is not valid. 219 * @dev_addr: In. Device address this slice pushes to or pulls from. 220 * @db_addr: In. Address of the doorbell to ring. 221 * @db_data: In. Data to write to the doorbell. 222 * @db_len: In. Size of the doorbell data in bits - 32, 16, or 8. 0 is for 223 * inactive doorbells. 224 * @offset: In. Start of this slice as an offset from the start of the BO. 225 */ 226 struct qaic_attach_slice_entry { 227 __u64 size; 228 struct qaic_sem sem0; 229 struct qaic_sem sem1; 230 struct qaic_sem sem2; 231 struct qaic_sem sem3; 232 __u64 dev_addr; 233 __u64 db_addr; 234 __u32 db_data; 235 __u32 db_len; 236 __u64 offset; 237 }; 238 239 /** 240 * struct qaic_attach_slice_hdr - Defines metadata for a set of BO slices. 241 * @count: In. Number of slices for this BO. 242 * @dbc_id: In. Associate the sliced BO with this DBC. 243 * @handle: In. GEM handle of the BO to slice. 244 * @dir: In. Direction of data flow. 1 = DMA_TO_DEVICE, 2 = DMA_FROM_DEVICE 245 * @size: In. Total length of BO being used. This should not exceed base 246 * size of BO (struct drm_gem_object.base) 247 * For BOs being allocated using DRM_IOCTL_QAIC_CREATE_BO, size of 248 * BO requested is PAGE_SIZE aligned then allocated hence allocated 249 * BO size maybe bigger. This size should not exceed the new 250 * PAGE_SIZE aligned BO size. 251 * @dev_addr: In. Device address this slice pushes to or pulls from. 252 * @db_addr: In. Address of the doorbell to ring. 253 * @db_data: In. Data to write to the doorbell. 254 * @db_len: In. Size of the doorbell data in bits - 32, 16, or 8. 0 is for 255 * inactive doorbells. 256 * @offset: In. Start of this slice as an offset from the start of the BO. 257 */ 258 struct qaic_attach_slice_hdr { 259 __u32 count; 260 __u32 dbc_id; 261 __u32 handle; 262 __u32 dir; 263 __u64 size; 264 }; 265 266 /** 267 * struct qaic_attach_slice - Defines a set of BO slices. 268 * @hdr: In. Metadata of the set of slices. 269 * @data: In. Pointer to an array containing the slice definitions. 270 */ 271 struct qaic_attach_slice { 272 struct qaic_attach_slice_hdr hdr; 273 __u64 data; 274 }; 275 276 /** 277 * struct qaic_execute_entry - Defines a BO to submit to the device. 278 * @handle: In. GEM handle of the BO to commit to the device. 279 * @dir: In. Direction of data. 1 = to device, 2 = from device. 280 */ 281 struct qaic_execute_entry { 282 __u32 handle; 283 __u32 dir; 284 }; 285 286 /** 287 * struct qaic_partial_execute_entry - Defines a BO to resize and submit. 288 * @handle: In. GEM handle of the BO to commit to the device. 289 * @dir: In. Direction of data. 1 = to device, 2 = from device. 290 * @resize: In. New size of the BO. Must be <= the original BO size. 291 * @resize as 0 would be interpreted as no DMA transfer is 292 * involved. 293 */ 294 struct qaic_partial_execute_entry { 295 __u32 handle; 296 __u32 dir; 297 __u64 resize; 298 }; 299 300 /** 301 * struct qaic_execute_hdr - Defines metadata for BO submission. 302 * @count: In. Number of BOs to submit. 303 * @dbc_id: In. DBC to submit the BOs on. 304 */ 305 struct qaic_execute_hdr { 306 __u32 count; 307 __u32 dbc_id; 308 }; 309 310 /** 311 * struct qaic_execute - Defines a list of BOs to submit to the device. 312 * @hdr: In. BO list metadata. 313 * @data: In. Pointer to an array of BOs to submit. 314 */ 315 struct qaic_execute { 316 struct qaic_execute_hdr hdr; 317 __u64 data; 318 }; 319 320 /** 321 * struct qaic_wait - Defines a blocking wait for BO execution. 322 * @handle: In. GEM handle of the BO to wait on. 323 * @timeout: In. Maximum time in ms to wait for the BO. 324 * @dbc_id: In. DBC the BO is submitted to. 325 * @pad: Structure padding. Must be 0. 326 */ 327 struct qaic_wait { 328 __u32 handle; 329 __u32 timeout; 330 __u32 dbc_id; 331 __u32 pad; 332 }; 333 334 /** 335 * struct qaic_perf_stats_hdr - Defines metadata for getting BO perf info. 336 * @count: In. Number of BOs requested. 337 * @pad: Structure padding. Must be 0. 338 * @dbc_id: In. DBC the BO are associated with. 339 */ 340 struct qaic_perf_stats_hdr { 341 __u16 count; 342 __u16 pad; 343 __u32 dbc_id; 344 }; 345 346 /** 347 * struct qaic_perf_stats - Defines a request for getting BO perf info. 348 * @hdr: In. Request metadata 349 * @data: In. Pointer to array of stats structures that will receive the data. 350 */ 351 struct qaic_perf_stats { 352 struct qaic_perf_stats_hdr hdr; 353 __u64 data; 354 }; 355 356 /** 357 * struct qaic_perf_stats_entry - Defines a BO perf info. 358 * @handle: In. GEM handle of the BO to get perf stats for. 359 * @queue_level_before: Out. Number of elements in the queue before this BO 360 * was submitted. 361 * @num_queue_element: Out. Number of elements added to the queue to submit 362 * this BO. 363 * @submit_latency_us: Out. Time taken by the driver to submit this BO. 364 * @device_latency_us: Out. Time taken by the device to execute this BO. 365 * @pad: Structure padding. Must be 0. 366 */ 367 struct qaic_perf_stats_entry { 368 __u32 handle; 369 __u32 queue_level_before; 370 __u32 num_queue_element; 371 __u32 submit_latency_us; 372 __u32 device_latency_us; 373 __u32 pad; 374 }; 375 376 /** 377 * struct qaic_detach_slice - Detaches slicing configuration from BO. 378 * @handle: In. GEM handle of the BO to detach slicing configuration. 379 * @pad: Structure padding. Must be 0. 380 */ 381 struct qaic_detach_slice { 382 __u32 handle; 383 __u32 pad; 384 }; 385 386 #define DRM_QAIC_MANAGE 0x00 387 #define DRM_QAIC_CREATE_BO 0x01 388 #define DRM_QAIC_MMAP_BO 0x02 389 #define DRM_QAIC_ATTACH_SLICE_BO 0x03 390 #define DRM_QAIC_EXECUTE_BO 0x04 391 #define DRM_QAIC_PARTIAL_EXECUTE_BO 0x05 392 #define DRM_QAIC_WAIT_BO 0x06 393 #define DRM_QAIC_PERF_STATS_BO 0x07 394 #define DRM_QAIC_DETACH_SLICE_BO 0x08 395 396 #define DRM_IOCTL_QAIC_MANAGE DRM_IOWR(DRM_COMMAND_BASE + DRM_QAIC_MANAGE, struct qaic_manage_msg) 397 #define DRM_IOCTL_QAIC_CREATE_BO DRM_IOWR(DRM_COMMAND_BASE + DRM_QAIC_CREATE_BO, struct qaic_create_bo) 398 #define DRM_IOCTL_QAIC_MMAP_BO DRM_IOWR(DRM_COMMAND_BASE + DRM_QAIC_MMAP_BO, struct qaic_mmap_bo) 399 #define DRM_IOCTL_QAIC_ATTACH_SLICE_BO DRM_IOW(DRM_COMMAND_BASE + DRM_QAIC_ATTACH_SLICE_BO, struct qaic_attach_slice) 400 #define DRM_IOCTL_QAIC_EXECUTE_BO DRM_IOW(DRM_COMMAND_BASE + DRM_QAIC_EXECUTE_BO, struct qaic_execute) 401 #define DRM_IOCTL_QAIC_PARTIAL_EXECUTE_BO DRM_IOW(DRM_COMMAND_BASE + DRM_QAIC_PARTIAL_EXECUTE_BO, struct qaic_execute) 402 #define DRM_IOCTL_QAIC_WAIT_BO DRM_IOW(DRM_COMMAND_BASE + DRM_QAIC_WAIT_BO, struct qaic_wait) 403 #define DRM_IOCTL_QAIC_PERF_STATS_BO DRM_IOWR(DRM_COMMAND_BASE + DRM_QAIC_PERF_STATS_BO, struct qaic_perf_stats) 404 #define DRM_IOCTL_QAIC_DETACH_SLICE_BO DRM_IOW(DRM_COMMAND_BASE + DRM_QAIC_DETACH_SLICE_BO, struct qaic_detach_slice) 405 406 #if defined(__cplusplus) 407 } 408 #endif 409 410 #endif /* QAIC_ACCEL_H_ */ 411