drivers/gpu/drm/amd/amdkfd/kfd_device_queue_manager.h

   1 /*
   2  * Copyright 2014 Advanced Micro Devices, Inc.
   3  *
   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:
  10  *
  11  * The above copyright notice and this permission notice shall be included in
  12  * all copies or substantial portions of the Software.
  13  *
  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.
  21  *
  22  */
  23
  24 #ifndef KFD_DEVICE_QUEUE_MANAGER_H_
  25 #define KFD_DEVICE_QUEUE_MANAGER_H_
  26
  27 #include <linux/rwsem.h>
  28 #include <linux/list.h>
  29 #include "kfd_priv.h"
  30 #include "kfd_mqd_manager.h"
  31
  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)
  39
  40 struct device_process_node {
  41         struct qcm_process_device *qpd;
  42         struct list_head list;
  43 };
  44
  45 /**
  46  * struct device_queue_manager
  47  *
  48  * @create_queue: Queue creation routine.
  49  *
  50  * @destroy_queue: Queue destruction routine.
  51  *
  52  * @update_queue: Queue update routine.
  53  *
  54  * @get_mqd_manager: Returns the mqd manager according to the mqd type.
  55  *
  56  * @exeute_queues: Dispatches the queues list to the H/W.
  57  *
  58  * @register_process: This routine associates a specific process with device.
  59  *
  60  * @unregister_process: destroys the associations between process to device.
  61  *
  62  * @initialize: Initializes the pipelines and memory module for that device.
  63  *
  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.
  67  *
  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.
  70  *
  71  * @uninitialize: Destroys all the device queue manager resources allocated in
  72  * initialize routine.
  73  *
  74  * @create_kernel_queue: Creates kernel queue. Used for debug queue.
  75  *
  76  * @destroy_kernel_queue: Destroys kernel queue. Used for debug queue.
  77  *
  78  * @set_cache_memory_policy: Sets memory policy (cached/ non cached) for the
  79  * memory apertures.
  80  *
  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.
  87  */
  88
  89 struct device_queue_manager {
  90         int     (*create_queue)(struct device_queue_manager *dqm,
  91                                 struct queue *q,
  92                                 struct qcm_process_device *qpd,
  93                                 int *allocate_vmid);
  94         int     (*destroy_queue)(struct device_queue_manager *dqm,
  95                                 struct qcm_process_device *qpd,
  96                                 struct queue *q);
  97         int     (*update_queue)(struct device_queue_manager *dqm,
  98                                 struct queue *q);
  99
 100         struct mqd_manager * (*get_mqd_manager)
 101                                         (struct device_queue_manager *dqm,
 102                                         enum KFD_MQD_TYPE type);
 103
 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);
 124
 125
 126         struct mqd_manager      *mqds[KFD_MQD_TYPE_MAX];
 127         struct packet_manager   packets;
 128         struct kfd_dev          *dev;
 129         struct mutex            lock;
 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;
 142         bool                    active_runlist;
 143 };
 144
 145
 146
 147 #endif /* KFD_DEVICE_QUEUE_MANAGER_H_ */