2 * Copyright 2014 Advanced Micro Devices, Inc.
4 * Permission is hereby granted, free of charge, to any person obtaining a
5 * copy of this software and associated documentation files (the "Software"),
6 * to deal in the Software without restriction, including without limitation
7 * the rights to use, copy, modify, merge, publish, distribute, sublicense,
8 * and/or sell copies of the Software, and to permit persons to whom the
9 * Software is furnished to do so, subject to the following conditions:
11 * The above copyright notice and this permission notice shall be included in
12 * all copies or substantial portions of the Software.
14 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
15 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
16 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
17 * THE COPYRIGHT HOLDER(S) OR AUTHOR(S) BE LIABLE FOR ANY CLAIM, DAMAGES OR
18 * OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
19 * ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
20 * OTHER DEALINGS IN THE SOFTWARE.
24 #ifndef KFD_DEVICE_QUEUE_MANAGER_H_
25 #define KFD_DEVICE_QUEUE_MANAGER_H_
27 #include <linux/rwsem.h>
28 #include <linux/list.h>
30 #include "kfd_mqd_manager.h"
32 #define QUEUE_PREEMPT_DEFAULT_TIMEOUT_MS (500)
33 #define QUEUES_PER_PIPE (8)
34 #define PIPE_PER_ME_CP_SCHEDULING (3)
35 #define CIK_VMID_NUM (8)
36 #define KFD_VMID_START_OFFSET (8)
37 #define VMID_PER_DEVICE CIK_VMID_NUM
38 #define KFD_DQM_FIRST_PIPE (0)
40 struct device_process_node {
41 struct qcm_process_device *qpd;
42 struct list_head list;
46 * struct device_queue_manager
48 * @create_queue: Queue creation routine.
50 * @destroy_queue: Queue destruction routine.
52 * @update_queue: Queue update routine.
54 * @get_mqd_manager: Returns the mqd manager according to the mqd type.
56 * @exeute_queues: Dispatches the queues list to the H/W.
58 * @register_process: This routine associates a specific process with device.
60 * @unregister_process: destroys the associations between process to device.
62 * @initialize: Initializes the pipelines and memory module for that device.
64 * @start: Initializes the resources/modules the the device needs for queues
65 * execution. This function is called on device initialization and after the
66 * system woke up after suspension.
68 * @stop: This routine stops execution of all the active queue running on the
69 * H/W and basically this function called on system suspend.
71 * @uninitialize: Destroys all the device queue manager resources allocated in
74 * @create_kernel_queue: Creates kernel queue. Used for debug queue.
76 * @destroy_kernel_queue: Destroys kernel queue. Used for debug queue.
78 * @set_cache_memory_policy: Sets memory policy (cached/ non cached) for the
81 * This struct is a base class for the kfd queues scheduler in the
82 * device level. The device base class should expose the basic operations
83 * for queue creation and queue destruction. This base class hides the
84 * scheduling mode of the driver and the specific implementation of the
85 * concrete device. This class is the only class in the queues scheduler
86 * that configures the H/W.
89 struct device_queue_manager {
90 int (*create_queue)(struct device_queue_manager *dqm,
92 struct qcm_process_device *qpd,
94 int (*destroy_queue)(struct device_queue_manager *dqm,
95 struct qcm_process_device *qpd,
97 int (*update_queue)(struct device_queue_manager *dqm,
100 struct mqd_manager * (*get_mqd_manager)
101 (struct device_queue_manager *dqm,
102 enum KFD_MQD_TYPE type);
104 int (*register_process)(struct device_queue_manager *dqm,
105 struct qcm_process_device *qpd);
106 int (*unregister_process)(struct device_queue_manager *dqm,
107 struct qcm_process_device *qpd);
108 int (*initialize)(struct device_queue_manager *dqm);
109 int (*start)(struct device_queue_manager *dqm);
110 int (*stop)(struct device_queue_manager *dqm);
111 void (*uninitialize)(struct device_queue_manager *dqm);
112 int (*create_kernel_queue)(struct device_queue_manager *dqm,
113 struct kernel_queue *kq,
114 struct qcm_process_device *qpd);
115 void (*destroy_kernel_queue)(struct device_queue_manager *dqm,
116 struct kernel_queue *kq,
117 struct qcm_process_device *qpd);
118 bool (*set_cache_memory_policy)(struct device_queue_manager *dqm,
119 struct qcm_process_device *qpd,
120 enum cache_policy default_policy,
121 enum cache_policy alternate_policy,
122 void __user *alternate_aperture_base,
123 uint64_t alternate_aperture_size);
126 struct mqd_manager *mqds[KFD_MQD_TYPE_MAX];
127 struct packet_manager packets;
130 struct list_head queues;
131 unsigned int processes_count;
132 unsigned int queue_count;
133 unsigned int total_queue_count;
134 unsigned int next_pipe_to_allocate;
135 unsigned int *allocated_queues;
136 unsigned int vmid_bitmap;
137 uint64_t pipelines_addr;
138 struct kfd_mem_obj *pipeline_mem;
139 uint64_t fence_gpu_addr;
140 unsigned int *fence_addr;
141 struct kfd_mem_obj *fence_mem;
147 #endif /* KFD_DEVICE_QUEUE_MANAGER_H_ */