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 #define CIK_SDMA_QUEUES                         (4)
  40 #define CIK_SDMA_QUEUES_PER_ENGINE              (2)
  41 #define CIK_SDMA_ENGINE_NUM                     (2)
  42
  43 struct device_process_node {
  44         struct qcm_process_device *qpd;
  45         struct list_head list;
  46 };
  47
  48 /**
  49  * struct device_queue_manager
  50  *
  51  * @create_queue: Queue creation routine.
  52  *
  53  * @destroy_queue: Queue destruction routine.
  54  *
  55  * @update_queue: Queue update routine.
  56  *
  57  * @get_mqd_manager: Returns the mqd manager according to the mqd type.
  58  *
  59  * @exeute_queues: Dispatches the queues list to the H/W.
  60  *
  61  * @register_process: This routine associates a specific process with device.
  62  *
  63  * @unregister_process: destroys the associations between process to device.
  64  *
  65  * @initialize: Initializes the pipelines and memory module for that device.
  66  *
  67  * @start: Initializes the resources/modules the the device needs for queues
  68  * execution. This function is called on device initialization and after the
  69  * system woke up after suspension.
  70  *
  71  * @stop: This routine stops execution of all the active queue running on the
  72  * H/W and basically this function called on system suspend.
  73  *
  74  * @uninitialize: Destroys all the device queue manager resources allocated in
  75  * initialize routine.
  76  *
  77  * @create_kernel_queue: Creates kernel queue. Used for debug queue.
  78  *
  79  * @destroy_kernel_queue: Destroys kernel queue. Used for debug queue.
  80  *
  81  * @set_cache_memory_policy: Sets memory policy (cached/ non cached) for the
  82  * memory apertures.
  83  *
  84  * This struct is a base class for the kfd queues scheduler in the
  85  * device level. The device base class should expose the basic operations
  86  * for queue creation and queue destruction. This base class hides the
  87  * scheduling mode of the driver and the specific implementation of the
  88  * concrete device. This class is the only class in the queues scheduler
  89  * that configures the H/W.
  90  */
  91
  92 struct device_queue_manager {
  93         int     (*create_queue)(struct device_queue_manager *dqm,
  94                                 struct queue *q,
  95                                 struct qcm_process_device *qpd,
  96                                 int *allocate_vmid);
  97         int     (*destroy_queue)(struct device_queue_manager *dqm,
  98                                 struct qcm_process_device *qpd,
  99                                 struct queue *q);
 100         int     (*update_queue)(struct device_queue_manager *dqm,
 101                                 struct queue *q);
 102
 103         struct mqd_manager * (*get_mqd_manager)
 104                                         (struct device_queue_manager *dqm,
 105                                         enum KFD_MQD_TYPE type);
 106
 107         int     (*register_process)(struct device_queue_manager *dqm,
 108                                         struct qcm_process_device *qpd);
 109         int     (*unregister_process)(struct device_queue_manager *dqm,
 110                                         struct qcm_process_device *qpd);
 111         int     (*initialize)(struct device_queue_manager *dqm);
 112         int     (*start)(struct device_queue_manager *dqm);
 113         int     (*stop)(struct device_queue_manager *dqm);
 114         void    (*uninitialize)(struct device_queue_manager *dqm);
 115         int     (*create_kernel_queue)(struct device_queue_manager *dqm,
 116                                         struct kernel_queue *kq,
 117                                         struct qcm_process_device *qpd);
 118         void    (*destroy_kernel_queue)(struct device_queue_manager *dqm,
 119                                         struct kernel_queue *kq,
 120                                         struct qcm_process_device *qpd);
 121         bool    (*set_cache_memory_policy)(struct device_queue_manager *dqm,
 122                                            struct qcm_process_device *qpd,
 123                                            enum cache_policy default_policy,
 124                                            enum cache_policy alternate_policy,
 125                                            void __user *alternate_aperture_base,
 126                                            uint64_t alternate_aperture_size);
 127
 128
 129         struct mqd_manager      *mqds[KFD_MQD_TYPE_MAX];
 130         struct packet_manager   packets;
 131         struct kfd_dev          *dev;
 132         struct mutex            lock;
 133         struct list_head        queues;
 134         unsigned int            processes_count;
 135         unsigned int            queue_count;
 136         unsigned int            sdma_queue_count;
 137         unsigned int            next_pipe_to_allocate;
 138         unsigned int            *allocated_queues;
 139         unsigned int            sdma_bitmap;
 140         unsigned int            vmid_bitmap;
 141         uint64_t                pipelines_addr;
 142         struct kfd_mem_obj      *pipeline_mem;
 143         uint64_t                fence_gpu_addr;
 144         unsigned int            *fence_addr;
 145         struct kfd_mem_obj      *fence_mem;
 146         bool                    active_runlist;
 147 };
 148
 149
 150
 151 #endif /* KFD_DEVICE_QUEUE_MANAGER_H_ */