2 * Copyright 2015 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 #include <linux/kthread.h>
25 #include <linux/wait.h>
26 #include <linux/sched.h>
28 #include "gpu_scheduler.h"
30 static void amd_sched_wakeup(struct amd_gpu_scheduler *sched);
32 /* Initialize a given run queue struct */
33 static void amd_sched_rq_init(struct amd_sched_rq *rq)
35 spin_lock_init(&rq->lock);
36 INIT_LIST_HEAD(&rq->entities);
37 rq->current_entity = NULL;
40 static void amd_sched_rq_add_entity(struct amd_sched_rq *rq,
41 struct amd_sched_entity *entity)
44 list_add_tail(&entity->list, &rq->entities);
45 spin_unlock(&rq->lock);
48 static void amd_sched_rq_remove_entity(struct amd_sched_rq *rq,
49 struct amd_sched_entity *entity)
52 list_del_init(&entity->list);
53 if (rq->current_entity == entity)
54 rq->current_entity = NULL;
55 spin_unlock(&rq->lock);
59 * Select next entity from a specified run queue with round robin policy.
60 * It could return the same entity as current one if current is the only
61 * available one in the queue. Return NULL if nothing available.
63 static struct amd_sched_entity *
64 amd_sched_rq_select_entity(struct amd_sched_rq *rq)
66 struct amd_sched_entity *entity;
70 entity = rq->current_entity;
72 list_for_each_entry_continue(entity, &rq->entities, list) {
73 if (!kfifo_is_empty(&entity->job_queue)) {
74 rq->current_entity = entity;
75 spin_unlock(&rq->lock);
76 return rq->current_entity;
81 list_for_each_entry(entity, &rq->entities, list) {
83 if (!kfifo_is_empty(&entity->job_queue)) {
84 rq->current_entity = entity;
85 spin_unlock(&rq->lock);
86 return rq->current_entity;
89 if (entity == rq->current_entity)
93 spin_unlock(&rq->lock);
99 * Init a context entity used by scheduler when submit to HW ring.
101 * @sched The pointer to the scheduler
102 * @entity The pointer to a valid amd_sched_entity
103 * @rq The run queue this entity belongs
104 * @kernel If this is an entity for the kernel
105 * @jobs The max number of jobs in the job queue
107 * return 0 if succeed. negative error code on failure
109 int amd_sched_entity_init(struct amd_gpu_scheduler *sched,
110 struct amd_sched_entity *entity,
111 struct amd_sched_rq *rq,
114 if (!(sched && entity && rq))
117 memset(entity, 0, sizeof(struct amd_sched_entity));
118 entity->belongto_rq = rq;
119 entity->scheduler = sched;
120 entity->fence_context = fence_context_alloc(1);
121 if(kfifo_alloc(&entity->job_queue,
122 jobs * sizeof(void *),
126 spin_lock_init(&entity->queue_lock);
127 atomic_set(&entity->fence_seq, 0);
129 /* Add the entity to the run queue */
130 amd_sched_rq_add_entity(rq, entity);
135 * Query if entity is initialized
137 * @sched Pointer to scheduler instance
138 * @entity The pointer to a valid scheduler entity
140 * return true if entity is initialized, false otherwise
142 static bool amd_sched_entity_is_initialized(struct amd_gpu_scheduler *sched,
143 struct amd_sched_entity *entity)
145 return entity->scheduler == sched &&
146 entity->belongto_rq != NULL;
150 * Check if entity is idle
152 * @entity The pointer to a valid scheduler entity
154 * Return true if entity don't has any unscheduled jobs.
156 static bool amd_sched_entity_is_idle(struct amd_sched_entity *entity)
159 if (kfifo_is_empty(&entity->job_queue))
166 * Destroy a context entity
168 * @sched Pointer to scheduler instance
169 * @entity The pointer to a valid scheduler entity
171 * Cleanup and free the allocated resources.
173 void amd_sched_entity_fini(struct amd_gpu_scheduler *sched,
174 struct amd_sched_entity *entity)
176 struct amd_sched_rq *rq = entity->belongto_rq;
178 if (!amd_sched_entity_is_initialized(sched, entity))
182 * The client will not queue more IBs during this fini, consume existing
185 wait_event(sched->job_scheduled, amd_sched_entity_is_idle(entity));
187 amd_sched_rq_remove_entity(rq, entity);
188 kfifo_free(&entity->job_queue);
192 * Helper to submit a job to the job queue
194 * @job The pointer to job required to submit
196 * Returns true if we could submit the job.
198 static bool amd_sched_entity_in(struct amd_sched_job *job)
200 struct amd_sched_entity *entity = job->s_entity;
201 bool added, first = false;
203 spin_lock(&entity->queue_lock);
204 added = kfifo_in(&entity->job_queue, &job, sizeof(job)) == sizeof(job);
206 if (added && kfifo_len(&entity->job_queue) == sizeof(job))
209 spin_unlock(&entity->queue_lock);
211 /* first job wakes up scheduler */
213 amd_sched_wakeup(job->sched);
219 * Submit a job to the job queue
221 * @job The pointer to job required to submit
223 * Returns 0 for success, negative error code otherwise.
225 int amd_sched_entity_push_job(struct amd_sched_job *sched_job)
227 struct amd_sched_entity *entity = sched_job->s_entity;
228 struct amd_sched_fence *fence = amd_sched_fence_create(
229 entity, sched_job->owner);
235 fence_get(&fence->base);
236 sched_job->s_fence = fence;
238 r = wait_event_interruptible(entity->scheduler->job_scheduled,
239 amd_sched_entity_in(sched_job));
245 * Return ture if we can push more jobs to the hw.
247 static bool amd_sched_ready(struct amd_gpu_scheduler *sched)
249 return atomic_read(&sched->hw_rq_count) <
250 sched->hw_submission_limit;
254 * Wake up the scheduler when it is ready
256 static void amd_sched_wakeup(struct amd_gpu_scheduler *sched)
258 if (amd_sched_ready(sched))
259 wake_up_interruptible(&sched->wake_up_worker);
263 * Select next entity containing real IB submissions
265 static struct amd_sched_entity *
266 amd_sched_select_context(struct amd_gpu_scheduler *sched)
268 struct amd_sched_entity *tmp;
270 if (!amd_sched_ready(sched))
273 /* Kernel run queue has higher priority than normal run queue*/
274 tmp = amd_sched_rq_select_entity(&sched->kernel_rq);
276 tmp = amd_sched_rq_select_entity(&sched->sched_rq);
281 static void amd_sched_process_job(struct fence *f, struct fence_cb *cb)
283 struct amd_sched_job *sched_job =
284 container_of(cb, struct amd_sched_job, cb);
285 struct amd_gpu_scheduler *sched;
287 sched = sched_job->sched;
288 amd_sched_fence_signal(sched_job->s_fence);
289 atomic_dec(&sched->hw_rq_count);
290 fence_put(&sched_job->s_fence->base);
291 sched->ops->process_job(sched_job);
292 wake_up_interruptible(&sched->wake_up_worker);
295 static int amd_sched_main(void *param)
297 struct sched_param sparam = {.sched_priority = 1};
298 struct amd_gpu_scheduler *sched = (struct amd_gpu_scheduler *)param;
301 sched_setscheduler(current, SCHED_FIFO, &sparam);
303 while (!kthread_should_stop()) {
304 struct amd_sched_entity *c_entity = NULL;
305 struct amd_sched_job *job;
308 wait_event_interruptible(sched->wake_up_worker,
309 kthread_should_stop() ||
310 (c_entity = amd_sched_select_context(sched)));
315 r = kfifo_out(&c_entity->job_queue, &job, sizeof(void *));
316 if (r != sizeof(void *))
318 atomic_inc(&sched->hw_rq_count);
320 fence = sched->ops->run_job(job);
322 r = fence_add_callback(fence, &job->cb,
323 amd_sched_process_job);
325 amd_sched_process_job(fence, &job->cb);
327 DRM_ERROR("fence add callback failed (%d)\n", r);
331 wake_up(&sched->job_scheduled);
337 * Create a gpu scheduler
339 * @ops The backend operations for this scheduler.
340 * @ring The the ring id for the scheduler.
341 * @hw_submissions Number of hw submissions to do.
343 * Return the pointer to scheduler for success, otherwise return NULL
345 struct amd_gpu_scheduler *amd_sched_create(struct amd_sched_backend_ops *ops,
346 unsigned ring, unsigned hw_submission,
349 struct amd_gpu_scheduler *sched;
351 sched = kzalloc(sizeof(struct amd_gpu_scheduler), GFP_KERNEL);
356 sched->ring_id = ring;
357 sched->hw_submission_limit = hw_submission;
359 snprintf(sched->name, sizeof(sched->name), "amdgpu[%d]", ring);
360 amd_sched_rq_init(&sched->sched_rq);
361 amd_sched_rq_init(&sched->kernel_rq);
363 init_waitqueue_head(&sched->wake_up_worker);
364 init_waitqueue_head(&sched->job_scheduled);
365 atomic_set(&sched->hw_rq_count, 0);
366 /* Each scheduler will run on a seperate kernel thread */
367 sched->thread = kthread_run(amd_sched_main, sched, sched->name);
368 if (IS_ERR(sched->thread)) {
369 DRM_ERROR("Failed to create scheduler for id %d.\n", ring);
378 * Destroy a gpu scheduler
380 * @sched The pointer to the scheduler
382 * return 0 if succeed. -1 if failed.
384 int amd_sched_destroy(struct amd_gpu_scheduler *sched)
386 kthread_stop(sched->thread);