14a488a7aSOded Gabbay /* 24a488a7aSOded Gabbay * Copyright 2014 Advanced Micro Devices, Inc. 34a488a7aSOded Gabbay * 44a488a7aSOded Gabbay * Permission is hereby granted, free of charge, to any person obtaining a 54a488a7aSOded Gabbay * copy of this software and associated documentation files (the "Software"), 64a488a7aSOded Gabbay * to deal in the Software without restriction, including without limitation 74a488a7aSOded Gabbay * the rights to use, copy, modify, merge, publish, distribute, sublicense, 84a488a7aSOded Gabbay * and/or sell copies of the Software, and to permit persons to whom the 94a488a7aSOded Gabbay * Software is furnished to do so, subject to the following conditions: 104a488a7aSOded Gabbay * 114a488a7aSOded Gabbay * The above copyright notice and this permission notice shall be included in 124a488a7aSOded Gabbay * all copies or substantial portions of the Software. 134a488a7aSOded Gabbay * 144a488a7aSOded Gabbay * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR 154a488a7aSOded Gabbay * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, 164a488a7aSOded Gabbay * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL 174a488a7aSOded Gabbay * THE COPYRIGHT HOLDER(S) OR AUTHOR(S) BE LIABLE FOR ANY CLAIM, DAMAGES OR 184a488a7aSOded Gabbay * OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, 194a488a7aSOded Gabbay * ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR 204a488a7aSOded Gabbay * OTHER DEALINGS IN THE SOFTWARE. 214a488a7aSOded Gabbay */ 224a488a7aSOded Gabbay 234a488a7aSOded Gabbay #ifndef KFD_PRIV_H_INCLUDED 244a488a7aSOded Gabbay #define KFD_PRIV_H_INCLUDED 254a488a7aSOded Gabbay 264a488a7aSOded Gabbay #include <linux/hashtable.h> 274a488a7aSOded Gabbay #include <linux/mmu_notifier.h> 284a488a7aSOded Gabbay #include <linux/mutex.h> 294a488a7aSOded Gabbay #include <linux/types.h> 304a488a7aSOded Gabbay #include <linux/atomic.h> 314a488a7aSOded Gabbay #include <linux/workqueue.h> 324a488a7aSOded Gabbay #include <linux/spinlock.h> 3319f6d2a6SOded Gabbay #include <linux/kfd_ioctl.h> 34482f0777SFelix Kuehling #include <linux/idr.h> 3504ad47bdSAndres Rodriguez #include <linux/kfifo.h> 36851a645eSFelix Kuehling #include <linux/seq_file.h> 375ce10687SFelix Kuehling #include <linux/kref.h> 384a488a7aSOded Gabbay #include <kgd_kfd_interface.h> 394a488a7aSOded Gabbay 40e596b903SYong Zhao #include "amd_shared.h" 41e596b903SYong Zhao 42af47b390SLaura Abbott #define KFD_MAX_RING_ENTRY_SIZE 8 43af47b390SLaura Abbott 445b5c4e40SEvgeny Pinchuk #define KFD_SYSFS_FILE_MODE 0444 455b5c4e40SEvgeny Pinchuk 46df03ef93SHarish Kasiviswanathan /* GPU ID hash width in bits */ 47df03ef93SHarish Kasiviswanathan #define KFD_GPU_ID_HASH_WIDTH 16 48df03ef93SHarish Kasiviswanathan 49df03ef93SHarish Kasiviswanathan /* Use upper bits of mmap offset to store KFD driver specific information. 50df03ef93SHarish Kasiviswanathan * BITS[63:62] - Encode MMAP type 51df03ef93SHarish Kasiviswanathan * BITS[61:46] - Encode gpu_id. To identify to which GPU the offset belongs to 52df03ef93SHarish Kasiviswanathan * BITS[45:0] - MMAP offset value 53df03ef93SHarish Kasiviswanathan * 54df03ef93SHarish Kasiviswanathan * NOTE: struct vm_area_struct.vm_pgoff uses offset in pages. Hence, these 55df03ef93SHarish Kasiviswanathan * defines are w.r.t to PAGE_SIZE 56df03ef93SHarish Kasiviswanathan */ 57df03ef93SHarish Kasiviswanathan #define KFD_MMAP_TYPE_SHIFT (62 - PAGE_SHIFT) 58df03ef93SHarish Kasiviswanathan #define KFD_MMAP_TYPE_MASK (0x3ULL << KFD_MMAP_TYPE_SHIFT) 59df03ef93SHarish Kasiviswanathan #define KFD_MMAP_TYPE_DOORBELL (0x3ULL << KFD_MMAP_TYPE_SHIFT) 60df03ef93SHarish Kasiviswanathan #define KFD_MMAP_TYPE_EVENTS (0x2ULL << KFD_MMAP_TYPE_SHIFT) 61df03ef93SHarish Kasiviswanathan #define KFD_MMAP_TYPE_RESERVED_MEM (0x1ULL << KFD_MMAP_TYPE_SHIFT) 62d33ea570SOak Zeng #define KFD_MMAP_TYPE_MMIO (0x0ULL << KFD_MMAP_TYPE_SHIFT) 63df03ef93SHarish Kasiviswanathan 64df03ef93SHarish Kasiviswanathan #define KFD_MMAP_GPU_ID_SHIFT (46 - PAGE_SHIFT) 65df03ef93SHarish Kasiviswanathan #define KFD_MMAP_GPU_ID_MASK (((1ULL << KFD_GPU_ID_HASH_WIDTH) - 1) \ 66df03ef93SHarish Kasiviswanathan << KFD_MMAP_GPU_ID_SHIFT) 67df03ef93SHarish Kasiviswanathan #define KFD_MMAP_GPU_ID(gpu_id) ((((uint64_t)gpu_id) << KFD_MMAP_GPU_ID_SHIFT)\ 68df03ef93SHarish Kasiviswanathan & KFD_MMAP_GPU_ID_MASK) 69df03ef93SHarish Kasiviswanathan #define KFD_MMAP_GPU_ID_GET(offset) ((offset & KFD_MMAP_GPU_ID_MASK) \ 70df03ef93SHarish Kasiviswanathan >> KFD_MMAP_GPU_ID_SHIFT) 71df03ef93SHarish Kasiviswanathan 72df03ef93SHarish Kasiviswanathan #define KFD_MMAP_OFFSET_VALUE_MASK (0x3FFFFFFFFFFFULL >> PAGE_SHIFT) 73df03ef93SHarish Kasiviswanathan #define KFD_MMAP_OFFSET_VALUE_GET(offset) (offset & KFD_MMAP_OFFSET_VALUE_MASK) 74f3a39818SAndrew Lewycky 75ed6e6a34SBen Goz /* 76ed6e6a34SBen Goz * When working with cp scheduler we should assign the HIQ manually or via 77e7016d8eSYong Zhao * the amdgpu driver to a fixed hqd slot, here are the fixed HIQ hqd slot 78ed6e6a34SBen Goz * definitions for Kaveri. In Kaveri only the first ME queues participates 79ed6e6a34SBen Goz * in the cp scheduling taking that in mind we set the HIQ slot in the 80ed6e6a34SBen Goz * second ME. 81ed6e6a34SBen Goz */ 82ed6e6a34SBen Goz #define KFD_CIK_HIQ_PIPE 4 83ed6e6a34SBen Goz #define KFD_CIK_HIQ_QUEUE 0 84ed6e6a34SBen Goz 855b5c4e40SEvgeny Pinchuk /* Macro for allocating structures */ 865b5c4e40SEvgeny Pinchuk #define kfd_alloc_struct(ptr_to_struct) \ 875b5c4e40SEvgeny Pinchuk ((typeof(ptr_to_struct)) kzalloc(sizeof(*ptr_to_struct), GFP_KERNEL)) 885b5c4e40SEvgeny Pinchuk 8919f6d2a6SOded Gabbay #define KFD_MAX_NUM_OF_PROCESSES 512 90b8cbab04SOded Gabbay #define KFD_MAX_NUM_OF_QUEUES_PER_PROCESS 1024 9119f6d2a6SOded Gabbay 9219f6d2a6SOded Gabbay /* 93373d7080SFelix Kuehling * Size of the per-process TBA+TMA buffer: 2 pages 94373d7080SFelix Kuehling * 95373d7080SFelix Kuehling * The first page is the TBA used for the CWSR ISA code. The second 96373d7080SFelix Kuehling * page is used as TMA for daisy changing a user-mode trap handler. 97373d7080SFelix Kuehling */ 98373d7080SFelix Kuehling #define KFD_CWSR_TBA_TMA_SIZE (PAGE_SIZE * 2) 99373d7080SFelix Kuehling #define KFD_CWSR_TMA_OFFSET PAGE_SIZE 100373d7080SFelix Kuehling 10174523943SYong Zhao #define KFD_MAX_NUM_OF_QUEUES_PER_DEVICE \ 10274523943SYong Zhao (KFD_MAX_NUM_OF_PROCESSES * \ 10374523943SYong Zhao KFD_MAX_NUM_OF_QUEUES_PER_PROCESS) 10474523943SYong Zhao 10574523943SYong Zhao #define KFD_KERNEL_QUEUE_SIZE 2048 10674523943SYong Zhao 107373d7080SFelix Kuehling /* 1081f86805aSYong Zhao * 512 = 0x200 1091f86805aSYong Zhao * The doorbell index distance between SDMA RLC (2*i) and (2*i+1) in the 1101f86805aSYong Zhao * same SDMA engine on SOC15, which has 8-byte doorbells for SDMA. 1111f86805aSYong Zhao * 512 8-byte doorbell distance (i.e. one page away) ensures that SDMA RLC 1121f86805aSYong Zhao * (2*i+1) doorbells (in terms of the lower 12 bit address) lie exactly in 1131f86805aSYong Zhao * the OFFSET and SIZE set in registers like BIF_SDMA0_DOORBELL_RANGE. 1141f86805aSYong Zhao */ 1151f86805aSYong Zhao #define KFD_QUEUE_DOORBELL_MIRROR_OFFSET 512 1161f86805aSYong Zhao 1171f86805aSYong Zhao 1181f86805aSYong Zhao /* 119b8cbab04SOded Gabbay * Kernel module parameter to specify maximum number of supported queues per 120b8cbab04SOded Gabbay * device 12119f6d2a6SOded Gabbay */ 122b8cbab04SOded Gabbay extern int max_num_of_queues_per_device; 12319f6d2a6SOded Gabbay 124ed6e6a34SBen Goz 12531c21fecSBen Goz /* Kernel module parameter to specify the scheduling policy */ 12631c21fecSBen Goz extern int sched_policy; 12731c21fecSBen Goz 128a99c6d4fSFelix Kuehling /* 129a99c6d4fSFelix Kuehling * Kernel module parameter to specify the maximum process 130a99c6d4fSFelix Kuehling * number per HW scheduler 131a99c6d4fSFelix Kuehling */ 132a99c6d4fSFelix Kuehling extern int hws_max_conc_proc; 133a99c6d4fSFelix Kuehling 134373d7080SFelix Kuehling extern int cwsr_enable; 135373d7080SFelix Kuehling 13681663016SOded Gabbay /* 13781663016SOded Gabbay * Kernel module parameter to specify whether to send sigterm to HSA process on 13881663016SOded Gabbay * unhandled exception 13981663016SOded Gabbay */ 14081663016SOded Gabbay extern int send_sigterm; 14181663016SOded Gabbay 142ebcfd1e2SFelix Kuehling /* 143374200b1SFelix Kuehling * This kernel module is used to simulate large bar machine on non-large bar 144374200b1SFelix Kuehling * enabled machines. 145374200b1SFelix Kuehling */ 146374200b1SFelix Kuehling extern int debug_largebar; 147374200b1SFelix Kuehling 148374200b1SFelix Kuehling /* 149ebcfd1e2SFelix Kuehling * Ignore CRAT table during KFD initialization, can be used to work around 150ebcfd1e2SFelix Kuehling * broken CRAT tables on some AMD systems 151ebcfd1e2SFelix Kuehling */ 152ebcfd1e2SFelix Kuehling extern int ignore_crat; 153ebcfd1e2SFelix Kuehling 154bed4f110SFelix Kuehling /* 155bed4f110SFelix Kuehling * Set sh_mem_config.retry_disable on Vega10 156bed4f110SFelix Kuehling */ 1572b281977SYong Zhao extern int noretry; 158bed4f110SFelix Kuehling 1590e9a860cSYong Zhao /* 1600e9a860cSYong Zhao * Halt if HWS hang is detected 1610e9a860cSYong Zhao */ 1620e9a860cSYong Zhao extern int halt_if_hws_hang; 1630e9a860cSYong Zhao 16429e76462SOak Zeng /* 16529e76462SOak Zeng * Whether MEC FW support GWS barriers 16629e76462SOak Zeng */ 16729e76462SOak Zeng extern bool hws_gws_support; 16829e76462SOak Zeng 169ed6e6a34SBen Goz enum cache_policy { 170ed6e6a34SBen Goz cache_policy_coherent, 171ed6e6a34SBen Goz cache_policy_noncoherent 172ed6e6a34SBen Goz }; 173ed6e6a34SBen Goz 174ef568db7SFelix Kuehling #define KFD_IS_SOC15(chip) ((chip) >= CHIP_VEGA10) 175ef568db7SFelix Kuehling 176f3a39818SAndrew Lewycky struct kfd_event_interrupt_class { 177f3a39818SAndrew Lewycky bool (*interrupt_isr)(struct kfd_dev *dev, 17858e69886SLan Xiao const uint32_t *ih_ring_entry, uint32_t *patched_ihre, 17958e69886SLan Xiao bool *patched_flag); 180f3a39818SAndrew Lewycky void (*interrupt_wq)(struct kfd_dev *dev, 181f3a39818SAndrew Lewycky const uint32_t *ih_ring_entry); 182f3a39818SAndrew Lewycky }; 183f3a39818SAndrew Lewycky 1844a488a7aSOded Gabbay struct kfd_device_info { 185e596b903SYong Zhao enum amd_asic_type asic_family; 186f3a39818SAndrew Lewycky const struct kfd_event_interrupt_class *event_interrupt_class; 1874a488a7aSOded Gabbay unsigned int max_pasid_bits; 188992839adSYair Shachar unsigned int max_no_of_hqd; 189ada2b29cSFelix Kuehling unsigned int doorbell_size; 1904a488a7aSOded Gabbay size_t ih_ring_entry_size; 191f7c826adSAlexey Skidanov uint8_t num_of_watch_points; 19219f6d2a6SOded Gabbay uint16_t mqd_size_aligned; 193373d7080SFelix Kuehling bool supports_cwsr; 19464d1c3a4SFelix Kuehling bool needs_iommu_device; 1953ee2d00cSFelix Kuehling bool needs_pci_atomics; 19698bb9222SYong Zhao unsigned int num_sdma_engines; 1971b4670f6SOak Zeng unsigned int num_xgmi_sdma_engines; 198d5094189SShaoyun Liu unsigned int num_sdma_queues_per_engine; 1994a488a7aSOded Gabbay }; 2004a488a7aSOded Gabbay 20136b5c08fSOded Gabbay struct kfd_mem_obj { 20236b5c08fSOded Gabbay uint32_t range_start; 20336b5c08fSOded Gabbay uint32_t range_end; 20436b5c08fSOded Gabbay uint64_t gpu_addr; 20536b5c08fSOded Gabbay uint32_t *cpu_ptr; 206b91d43ddSFelix Kuehling void *gtt_mem; 20736b5c08fSOded Gabbay }; 20836b5c08fSOded Gabbay 20944008d7aSYong Zhao struct kfd_vmid_info { 21044008d7aSYong Zhao uint32_t first_vmid_kfd; 21144008d7aSYong Zhao uint32_t last_vmid_kfd; 21244008d7aSYong Zhao uint32_t vmid_num_kfd; 21344008d7aSYong Zhao }; 21444008d7aSYong Zhao 2154a488a7aSOded Gabbay struct kfd_dev { 2164a488a7aSOded Gabbay struct kgd_dev *kgd; 2174a488a7aSOded Gabbay 2184a488a7aSOded Gabbay const struct kfd_device_info *device_info; 2194a488a7aSOded Gabbay struct pci_dev *pdev; 2204a488a7aSOded Gabbay 2214a488a7aSOded Gabbay unsigned int id; /* topology stub index */ 2224a488a7aSOded Gabbay 22319f6d2a6SOded Gabbay phys_addr_t doorbell_base; /* Start of actual doorbells used by 22419f6d2a6SOded Gabbay * KFD. It is aligned for mapping 22519f6d2a6SOded Gabbay * into user mode 22619f6d2a6SOded Gabbay */ 22719f6d2a6SOded Gabbay size_t doorbell_id_offset; /* Doorbell offset (from KFD doorbell 22819f6d2a6SOded Gabbay * to HW doorbell, GFX reserved some 22919f6d2a6SOded Gabbay * at the start) 23019f6d2a6SOded Gabbay */ 23119f6d2a6SOded Gabbay u32 __iomem *doorbell_kernel_ptr; /* This is a pointer for a doorbells 23219f6d2a6SOded Gabbay * page used by kernel queue 23319f6d2a6SOded Gabbay */ 23419f6d2a6SOded Gabbay 2354a488a7aSOded Gabbay struct kgd2kfd_shared_resources shared_resources; 23644008d7aSYong Zhao struct kfd_vmid_info vm_info; 2374a488a7aSOded Gabbay 238cea405b1SXihan Zhang const struct kfd2kgd_calls *kfd2kgd; 239cea405b1SXihan Zhang struct mutex doorbell_mutex; 240f761d8bdSJoe Perches DECLARE_BITMAP(doorbell_available_index, 241f761d8bdSJoe Perches KFD_MAX_NUM_OF_QUEUES_PER_PROCESS); 242cea405b1SXihan Zhang 24336b5c08fSOded Gabbay void *gtt_mem; 24436b5c08fSOded Gabbay uint64_t gtt_start_gpu_addr; 24536b5c08fSOded Gabbay void *gtt_start_cpu_ptr; 24636b5c08fSOded Gabbay void *gtt_sa_bitmap; 24736b5c08fSOded Gabbay struct mutex gtt_sa_lock; 24836b5c08fSOded Gabbay unsigned int gtt_sa_chunk_size; 24936b5c08fSOded Gabbay unsigned int gtt_sa_num_of_chunks; 25036b5c08fSOded Gabbay 2512249d558SAndrew Lewycky /* Interrupts */ 25204ad47bdSAndres Rodriguez struct kfifo ih_fifo; 25348e876a2SAndres Rodriguez struct workqueue_struct *ih_wq; 2542249d558SAndrew Lewycky struct work_struct interrupt_work; 2552249d558SAndrew Lewycky spinlock_t interrupt_lock; 2562249d558SAndrew Lewycky 257ed6e6a34SBen Goz /* QCM Device instance */ 258ed6e6a34SBen Goz struct device_queue_manager *dqm; 2594a488a7aSOded Gabbay 260ed6e6a34SBen Goz bool init_complete; 2612249d558SAndrew Lewycky /* 2622249d558SAndrew Lewycky * Interrupts of interest to KFD are copied 2632249d558SAndrew Lewycky * from the HW ring into a SW ring. 2642249d558SAndrew Lewycky */ 2652249d558SAndrew Lewycky bool interrupts_active; 266fbeb661bSYair Shachar 267fbeb661bSYair Shachar /* Debug manager */ 268fbeb661bSYair Shachar struct kfd_dbgmgr *dbgmgr; 269373d7080SFelix Kuehling 2705ade6c9cSFelix Kuehling /* Firmware versions */ 2715ade6c9cSFelix Kuehling uint16_t mec_fw_version; 2725ade6c9cSFelix Kuehling uint16_t sdma_fw_version; 2735ade6c9cSFelix Kuehling 274a99c6d4fSFelix Kuehling /* Maximum process number mapped to HW scheduler */ 275a99c6d4fSFelix Kuehling unsigned int max_proc_per_quantum; 276a99c6d4fSFelix Kuehling 277373d7080SFelix Kuehling /* CWSR */ 278373d7080SFelix Kuehling bool cwsr_enabled; 279373d7080SFelix Kuehling const void *cwsr_isa; 280373d7080SFelix Kuehling unsigned int cwsr_isa_size; 2810c1690e3SShaoyun Liu 2820c1690e3SShaoyun Liu /* xGMI */ 2830c1690e3SShaoyun Liu uint64_t hive_id; 284d35f00d8SEric Huang 285d35f00d8SEric Huang bool pci_atomic_requested; 2869b54d201SEric Huang 2879b54d201SEric Huang /* SRAM ECC flag */ 2889b54d201SEric Huang atomic_t sram_ecc_flag; 289f756e631SHarish Kasiviswanathan 290f756e631SHarish Kasiviswanathan /* Compute Profile ref. count */ 291f756e631SHarish Kasiviswanathan atomic_t compute_profile; 292e09d4fc8SOak Zeng 293e09d4fc8SOak Zeng /* Global GWS resource shared b/t processes*/ 294e09d4fc8SOak Zeng void *gws; 2954a488a7aSOded Gabbay }; 2964a488a7aSOded Gabbay 29719f6d2a6SOded Gabbay enum kfd_mempool { 29819f6d2a6SOded Gabbay KFD_MEMPOOL_SYSTEM_CACHEABLE = 1, 29919f6d2a6SOded Gabbay KFD_MEMPOOL_SYSTEM_WRITECOMBINE = 2, 30019f6d2a6SOded Gabbay KFD_MEMPOOL_FRAMEBUFFER = 3, 30119f6d2a6SOded Gabbay }; 30219f6d2a6SOded Gabbay 3034a488a7aSOded Gabbay /* Character device interface */ 3044a488a7aSOded Gabbay int kfd_chardev_init(void); 3054a488a7aSOded Gabbay void kfd_chardev_exit(void); 3064a488a7aSOded Gabbay struct device *kfd_chardev(void); 3074a488a7aSOded Gabbay 308241f24f8SBen Goz /** 3097da2bcf8SYong Zhao * enum kfd_unmap_queues_filter 310241f24f8SBen Goz * 3117da2bcf8SYong Zhao * @KFD_UNMAP_QUEUES_FILTER_SINGLE_QUEUE: Preempts single queue. 312241f24f8SBen Goz * 3137da2bcf8SYong Zhao * @KFD_UNMAP_QUEUES_FILTER_ALL_QUEUES: Preempts all queues in the 314241f24f8SBen Goz * running queues list. 315241f24f8SBen Goz * 3167da2bcf8SYong Zhao * @KFD_UNMAP_QUEUES_FILTER_BY_PASID: Preempts queues that belongs to 317241f24f8SBen Goz * specific process. 318241f24f8SBen Goz * 319241f24f8SBen Goz */ 3207da2bcf8SYong Zhao enum kfd_unmap_queues_filter { 3217da2bcf8SYong Zhao KFD_UNMAP_QUEUES_FILTER_SINGLE_QUEUE, 3227da2bcf8SYong Zhao KFD_UNMAP_QUEUES_FILTER_ALL_QUEUES, 3237da2bcf8SYong Zhao KFD_UNMAP_QUEUES_FILTER_DYNAMIC_QUEUES, 3247da2bcf8SYong Zhao KFD_UNMAP_QUEUES_FILTER_BY_PASID 325241f24f8SBen Goz }; 32619f6d2a6SOded Gabbay 327ed8aab45SBen Goz /** 328ed8aab45SBen Goz * enum kfd_queue_type 329ed8aab45SBen Goz * 330ed8aab45SBen Goz * @KFD_QUEUE_TYPE_COMPUTE: Regular user mode queue type. 331ed8aab45SBen Goz * 332ed8aab45SBen Goz * @KFD_QUEUE_TYPE_SDMA: Sdma user mode queue type. 333ed8aab45SBen Goz * 334ed8aab45SBen Goz * @KFD_QUEUE_TYPE_HIQ: HIQ queue type. 335ed8aab45SBen Goz * 336ed8aab45SBen Goz * @KFD_QUEUE_TYPE_DIQ: DIQ queue type. 337ed8aab45SBen Goz */ 338ed8aab45SBen Goz enum kfd_queue_type { 339ed8aab45SBen Goz KFD_QUEUE_TYPE_COMPUTE, 340ed8aab45SBen Goz KFD_QUEUE_TYPE_SDMA, 341ed8aab45SBen Goz KFD_QUEUE_TYPE_HIQ, 3421b4670f6SOak Zeng KFD_QUEUE_TYPE_DIQ, 3431b4670f6SOak Zeng KFD_QUEUE_TYPE_SDMA_XGMI 344ed8aab45SBen Goz }; 345ed8aab45SBen Goz 3466e99df57SBen Goz enum kfd_queue_format { 3476e99df57SBen Goz KFD_QUEUE_FORMAT_PM4, 3486e99df57SBen Goz KFD_QUEUE_FORMAT_AQL 3496e99df57SBen Goz }; 3506e99df57SBen Goz 3510ccbc7cdSOak Zeng enum KFD_QUEUE_PRIORITY { 3520ccbc7cdSOak Zeng KFD_QUEUE_PRIORITY_MINIMUM = 0, 3530ccbc7cdSOak Zeng KFD_QUEUE_PRIORITY_MAXIMUM = 15 3540ccbc7cdSOak Zeng }; 3550ccbc7cdSOak Zeng 356ed8aab45SBen Goz /** 357ed8aab45SBen Goz * struct queue_properties 358ed8aab45SBen Goz * 359ed8aab45SBen Goz * @type: The queue type. 360ed8aab45SBen Goz * 361ed8aab45SBen Goz * @queue_id: Queue identifier. 362ed8aab45SBen Goz * 363ed8aab45SBen Goz * @queue_address: Queue ring buffer address. 364ed8aab45SBen Goz * 365ed8aab45SBen Goz * @queue_size: Queue ring buffer size. 366ed8aab45SBen Goz * 367ed8aab45SBen Goz * @priority: Defines the queue priority relative to other queues in the 368ed8aab45SBen Goz * process. 369ed8aab45SBen Goz * This is just an indication and HW scheduling may override the priority as 370ed8aab45SBen Goz * necessary while keeping the relative prioritization. 371ed8aab45SBen Goz * the priority granularity is from 0 to f which f is the highest priority. 372ed8aab45SBen Goz * currently all queues are initialized with the highest priority. 373ed8aab45SBen Goz * 374ed8aab45SBen Goz * @queue_percent: This field is partially implemented and currently a zero in 375ed8aab45SBen Goz * this field defines that the queue is non active. 376ed8aab45SBen Goz * 377ed8aab45SBen Goz * @read_ptr: User space address which points to the number of dwords the 378ed8aab45SBen Goz * cp read from the ring buffer. This field updates automatically by the H/W. 379ed8aab45SBen Goz * 380ed8aab45SBen Goz * @write_ptr: Defines the number of dwords written to the ring buffer. 381ed8aab45SBen Goz * 382ed8aab45SBen Goz * @doorbell_ptr: This field aim is to notify the H/W of new packet written to 3838eabaf54SKent Russell * the queue ring buffer. This field should be similar to write_ptr and the 3848eabaf54SKent Russell * user should update this field after he updated the write_ptr. 385ed8aab45SBen Goz * 386ed8aab45SBen Goz * @doorbell_off: The doorbell offset in the doorbell pci-bar. 387ed8aab45SBen Goz * 3888eabaf54SKent Russell * @is_interop: Defines if this is a interop queue. Interop queue means that 3898eabaf54SKent Russell * the queue can access both graphics and compute resources. 390ed8aab45SBen Goz * 39126103436SFelix Kuehling * @is_evicted: Defines if the queue is evicted. Only active queues 39226103436SFelix Kuehling * are evicted, rendering them inactive. 39326103436SFelix Kuehling * 39426103436SFelix Kuehling * @is_active: Defines if the queue is active or not. @is_active and 39526103436SFelix Kuehling * @is_evicted are protected by the DQM lock. 396ed8aab45SBen Goz * 397ed8aab45SBen Goz * @vmid: If the scheduling mode is no cp scheduling the field defines the vmid 398ed8aab45SBen Goz * of the queue. 399ed8aab45SBen Goz * 400ed8aab45SBen Goz * This structure represents the queue properties for each queue no matter if 401ed8aab45SBen Goz * it's user mode or kernel mode queue. 402ed8aab45SBen Goz * 403ed8aab45SBen Goz */ 404ed8aab45SBen Goz struct queue_properties { 405ed8aab45SBen Goz enum kfd_queue_type type; 4066e99df57SBen Goz enum kfd_queue_format format; 407ed8aab45SBen Goz unsigned int queue_id; 408ed8aab45SBen Goz uint64_t queue_address; 409ed8aab45SBen Goz uint64_t queue_size; 410ed8aab45SBen Goz uint32_t priority; 411ed8aab45SBen Goz uint32_t queue_percent; 412ed8aab45SBen Goz uint32_t *read_ptr; 413ed8aab45SBen Goz uint32_t *write_ptr; 414ada2b29cSFelix Kuehling void __iomem *doorbell_ptr; 415ed8aab45SBen Goz uint32_t doorbell_off; 416ed8aab45SBen Goz bool is_interop; 41726103436SFelix Kuehling bool is_evicted; 418ed8aab45SBen Goz bool is_active; 419ed8aab45SBen Goz /* Not relevant for user mode queues in cp scheduling */ 420ed8aab45SBen Goz unsigned int vmid; 42177669eb8SBen Goz /* Relevant only for sdma queues*/ 42277669eb8SBen Goz uint32_t sdma_engine_id; 42377669eb8SBen Goz uint32_t sdma_queue_id; 42477669eb8SBen Goz uint32_t sdma_vm_addr; 425ff3d04a1SBen Goz /* Relevant only for VI */ 426ff3d04a1SBen Goz uint64_t eop_ring_buffer_address; 427ff3d04a1SBen Goz uint32_t eop_ring_buffer_size; 428ff3d04a1SBen Goz uint64_t ctx_save_restore_area_address; 429ff3d04a1SBen Goz uint32_t ctx_save_restore_area_size; 430373d7080SFelix Kuehling uint32_t ctl_stack_size; 431373d7080SFelix Kuehling uint64_t tba_addr; 432373d7080SFelix Kuehling uint64_t tma_addr; 43339e7f331SFelix Kuehling /* Relevant for CU */ 43439e7f331SFelix Kuehling uint32_t cu_mask_count; /* Must be a multiple of 32 */ 43539e7f331SFelix Kuehling uint32_t *cu_mask; 436ed8aab45SBen Goz }; 437ed8aab45SBen Goz 438bb2d2128SFelix Kuehling #define QUEUE_IS_ACTIVE(q) ((q).queue_size > 0 && \ 439bb2d2128SFelix Kuehling (q).queue_address != 0 && \ 440bb2d2128SFelix Kuehling (q).queue_percent > 0 && \ 441bb2d2128SFelix Kuehling !(q).is_evicted) 442bb2d2128SFelix Kuehling 443ed8aab45SBen Goz /** 444ed8aab45SBen Goz * struct queue 445ed8aab45SBen Goz * 446ed8aab45SBen Goz * @list: Queue linked list. 447ed8aab45SBen Goz * 448ed8aab45SBen Goz * @mqd: The queue MQD. 449ed8aab45SBen Goz * 450ed8aab45SBen Goz * @mqd_mem_obj: The MQD local gpu memory object. 451ed8aab45SBen Goz * 452ed8aab45SBen Goz * @gart_mqd_addr: The MQD gart mc address. 453ed8aab45SBen Goz * 454ed8aab45SBen Goz * @properties: The queue properties. 455ed8aab45SBen Goz * 456ed8aab45SBen Goz * @mec: Used only in no cp scheduling mode and identifies to micro engine id 457ed8aab45SBen Goz * that the queue should be execute on. 458ed8aab45SBen Goz * 4598eabaf54SKent Russell * @pipe: Used only in no cp scheduling mode and identifies the queue's pipe 4608eabaf54SKent Russell * id. 461ed8aab45SBen Goz * 462ed8aab45SBen Goz * @queue: Used only in no cp scheduliong mode and identifies the queue's slot. 463ed8aab45SBen Goz * 464ed8aab45SBen Goz * @process: The kfd process that created this queue. 465ed8aab45SBen Goz * 466ed8aab45SBen Goz * @device: The kfd device that created this queue. 467ed8aab45SBen Goz * 468eb82da1dSOak Zeng * @gws: Pointing to gws kgd_mem if this is a gws control queue; NULL 469eb82da1dSOak Zeng * otherwise. 470eb82da1dSOak Zeng * 471ed8aab45SBen Goz * This structure represents user mode compute queues. 472ed8aab45SBen Goz * It contains all the necessary data to handle such queues. 473ed8aab45SBen Goz * 474ed8aab45SBen Goz */ 475ed8aab45SBen Goz 476ed8aab45SBen Goz struct queue { 477ed8aab45SBen Goz struct list_head list; 478ed8aab45SBen Goz void *mqd; 479ed8aab45SBen Goz struct kfd_mem_obj *mqd_mem_obj; 480ed8aab45SBen Goz uint64_t gart_mqd_addr; 481ed8aab45SBen Goz struct queue_properties properties; 482ed8aab45SBen Goz 483ed8aab45SBen Goz uint32_t mec; 484ed8aab45SBen Goz uint32_t pipe; 485ed8aab45SBen Goz uint32_t queue; 486ed8aab45SBen Goz 48777669eb8SBen Goz unsigned int sdma_id; 488ef568db7SFelix Kuehling unsigned int doorbell_id; 48977669eb8SBen Goz 490ed8aab45SBen Goz struct kfd_process *process; 491ed8aab45SBen Goz struct kfd_dev *device; 492eb82da1dSOak Zeng void *gws; 493ed8aab45SBen Goz }; 494ed8aab45SBen Goz 4956e99df57SBen Goz /* 4966e99df57SBen Goz * Please read the kfd_mqd_manager.h description. 4976e99df57SBen Goz */ 4986e99df57SBen Goz enum KFD_MQD_TYPE { 49985d258f9SBen Goz KFD_MQD_TYPE_COMPUTE = 0, /* for no cp scheduling */ 50085d258f9SBen Goz KFD_MQD_TYPE_HIQ, /* for hiq */ 50185d258f9SBen Goz KFD_MQD_TYPE_CP, /* for cp queues and diq */ 50285d258f9SBen Goz KFD_MQD_TYPE_SDMA, /* for sdma queues */ 50359f650a0SOak Zeng KFD_MQD_TYPE_DIQ, /* for diq */ 5046e99df57SBen Goz KFD_MQD_TYPE_MAX 5056e99df57SBen Goz }; 5066e99df57SBen Goz 5070ccbc7cdSOak Zeng enum KFD_PIPE_PRIORITY { 5080ccbc7cdSOak Zeng KFD_PIPE_PRIORITY_CS_LOW = 0, 5090ccbc7cdSOak Zeng KFD_PIPE_PRIORITY_CS_MEDIUM, 5100ccbc7cdSOak Zeng KFD_PIPE_PRIORITY_CS_HIGH 5110ccbc7cdSOak Zeng }; 5120ccbc7cdSOak Zeng 513241f24f8SBen Goz struct scheduling_resources { 514241f24f8SBen Goz unsigned int vmid_mask; 515241f24f8SBen Goz enum kfd_queue_type type; 516241f24f8SBen Goz uint64_t queue_mask; 517241f24f8SBen Goz uint64_t gws_mask; 518241f24f8SBen Goz uint32_t oac_mask; 519241f24f8SBen Goz uint32_t gds_heap_base; 520241f24f8SBen Goz uint32_t gds_heap_size; 521241f24f8SBen Goz }; 522241f24f8SBen Goz 523241f24f8SBen Goz struct process_queue_manager { 524241f24f8SBen Goz /* data */ 525241f24f8SBen Goz struct kfd_process *process; 526241f24f8SBen Goz struct list_head queues; 527241f24f8SBen Goz unsigned long *queue_slot_bitmap; 528241f24f8SBen Goz }; 529241f24f8SBen Goz 530241f24f8SBen Goz struct qcm_process_device { 531241f24f8SBen Goz /* The Device Queue Manager that owns this data */ 532241f24f8SBen Goz struct device_queue_manager *dqm; 533241f24f8SBen Goz struct process_queue_manager *pqm; 534241f24f8SBen Goz /* Queues list */ 535241f24f8SBen Goz struct list_head queues_list; 536241f24f8SBen Goz struct list_head priv_queue_list; 537241f24f8SBen Goz 538241f24f8SBen Goz unsigned int queue_count; 539241f24f8SBen Goz unsigned int vmid; 540241f24f8SBen Goz bool is_debug; 54126103436SFelix Kuehling unsigned int evicted; /* eviction counter, 0=active */ 5429fd3f1bfSFelix Kuehling 5439fd3f1bfSFelix Kuehling /* This flag tells if we should reset all wavefronts on 5449fd3f1bfSFelix Kuehling * process termination 5459fd3f1bfSFelix Kuehling */ 5469fd3f1bfSFelix Kuehling bool reset_wavefronts; 5479fd3f1bfSFelix Kuehling 548241f24f8SBen Goz /* 549241f24f8SBen Goz * All the memory management data should be here too 550241f24f8SBen Goz */ 551241f24f8SBen Goz uint64_t gds_context_area; 552435e2f97SYong Zhao /* Contains page table flags such as AMDGPU_PTE_VALID since gfx9 */ 553e715c6d0SShaoyun Liu uint64_t page_table_base; 554241f24f8SBen Goz uint32_t sh_mem_config; 555241f24f8SBen Goz uint32_t sh_mem_bases; 556241f24f8SBen Goz uint32_t sh_mem_ape1_base; 557241f24f8SBen Goz uint32_t sh_mem_ape1_limit; 558241f24f8SBen Goz uint32_t gds_size; 559241f24f8SBen Goz uint32_t num_gws; 560241f24f8SBen Goz uint32_t num_oac; 5616a1c9510SMoses Reuben uint32_t sh_hidden_private_base; 562373d7080SFelix Kuehling 563373d7080SFelix Kuehling /* CWSR memory */ 564373d7080SFelix Kuehling void *cwsr_kaddr; 565d01994c2SFelix Kuehling uint64_t cwsr_base; 566373d7080SFelix Kuehling uint64_t tba_addr; 567373d7080SFelix Kuehling uint64_t tma_addr; 568d01994c2SFelix Kuehling 569d01994c2SFelix Kuehling /* IB memory */ 570d01994c2SFelix Kuehling uint64_t ib_base; 571552764b6SFelix Kuehling void *ib_kaddr; 572ef568db7SFelix Kuehling 573ef568db7SFelix Kuehling /* doorbell resources per process per device */ 574ef568db7SFelix Kuehling unsigned long *doorbell_bitmap; 575241f24f8SBen Goz }; 576241f24f8SBen Goz 57726103436SFelix Kuehling /* KFD Memory Eviction */ 57826103436SFelix Kuehling 57926103436SFelix Kuehling /* Approx. wait time before attempting to restore evicted BOs */ 58026103436SFelix Kuehling #define PROCESS_RESTORE_TIME_MS 100 58126103436SFelix Kuehling /* Approx. back off time if restore fails due to lack of memory */ 58226103436SFelix Kuehling #define PROCESS_BACK_OFF_TIME_MS 100 58326103436SFelix Kuehling /* Approx. time before evicting the process again */ 58426103436SFelix Kuehling #define PROCESS_ACTIVE_TIME_MS 10 58526103436SFelix Kuehling 5865ec7e028SFelix Kuehling /* 8 byte handle containing GPU ID in the most significant 4 bytes and 5875ec7e028SFelix Kuehling * idr_handle in the least significant 4 bytes 5885ec7e028SFelix Kuehling */ 5895ec7e028SFelix Kuehling #define MAKE_HANDLE(gpu_id, idr_handle) \ 5905ec7e028SFelix Kuehling (((uint64_t)(gpu_id) << 32) + idr_handle) 5915ec7e028SFelix Kuehling #define GET_GPU_ID(handle) (handle >> 32) 5925ec7e028SFelix Kuehling #define GET_IDR_HANDLE(handle) (handle & 0xFFFFFFFF) 5935ec7e028SFelix Kuehling 594733fa1f7SYong Zhao enum kfd_pdd_bound { 595733fa1f7SYong Zhao PDD_UNBOUND = 0, 596733fa1f7SYong Zhao PDD_BOUND, 597733fa1f7SYong Zhao PDD_BOUND_SUSPENDED, 598733fa1f7SYong Zhao }; 599733fa1f7SYong Zhao 60019f6d2a6SOded Gabbay /* Data that is per-process-per device. */ 60119f6d2a6SOded Gabbay struct kfd_process_device { 60219f6d2a6SOded Gabbay /* 60319f6d2a6SOded Gabbay * List of all per-device data for a process. 60419f6d2a6SOded Gabbay * Starts from kfd_process.per_device_data. 60519f6d2a6SOded Gabbay */ 60619f6d2a6SOded Gabbay struct list_head per_device_list; 60719f6d2a6SOded Gabbay 60819f6d2a6SOded Gabbay /* The device that owns this data. */ 60919f6d2a6SOded Gabbay struct kfd_dev *dev; 61019f6d2a6SOded Gabbay 6119fd3f1bfSFelix Kuehling /* The process that owns this kfd_process_device. */ 6129fd3f1bfSFelix Kuehling struct kfd_process *process; 61319f6d2a6SOded Gabbay 61445102048SBen Goz /* per-process-per device QCM data structure */ 61545102048SBen Goz struct qcm_process_device qpd; 61645102048SBen Goz 61719f6d2a6SOded Gabbay /*Apertures*/ 61819f6d2a6SOded Gabbay uint64_t lds_base; 61919f6d2a6SOded Gabbay uint64_t lds_limit; 62019f6d2a6SOded Gabbay uint64_t gpuvm_base; 62119f6d2a6SOded Gabbay uint64_t gpuvm_limit; 62219f6d2a6SOded Gabbay uint64_t scratch_base; 62319f6d2a6SOded Gabbay uint64_t scratch_limit; 62419f6d2a6SOded Gabbay 625403575c4SFelix Kuehling /* VM context for GPUVM allocations */ 626b84394e2SFelix Kuehling struct file *drm_file; 627403575c4SFelix Kuehling void *vm; 628403575c4SFelix Kuehling 62952b29d73SFelix Kuehling /* GPUVM allocations storage */ 63052b29d73SFelix Kuehling struct idr alloc_idr; 63152b29d73SFelix Kuehling 6329fd3f1bfSFelix Kuehling /* Flag used to tell the pdd has dequeued from the dqm. 6339fd3f1bfSFelix Kuehling * This is used to prevent dev->dqm->ops.process_termination() from 6349fd3f1bfSFelix Kuehling * being called twice when it is already called in IOMMU callback 6359fd3f1bfSFelix Kuehling * function. 636a82918f1SBen Goz */ 6379fd3f1bfSFelix Kuehling bool already_dequeued; 63864d1c3a4SFelix Kuehling 63964d1c3a4SFelix Kuehling /* Is this process/pasid bound to this device? (amd_iommu_bind_pasid) */ 64064d1c3a4SFelix Kuehling enum kfd_pdd_bound bound; 64119f6d2a6SOded Gabbay }; 64219f6d2a6SOded Gabbay 64352a5fdceSAlexey Skidanov #define qpd_to_pdd(x) container_of(x, struct kfd_process_device, qpd) 64452a5fdceSAlexey Skidanov 6454a488a7aSOded Gabbay /* Process data */ 6464a488a7aSOded Gabbay struct kfd_process { 64719f6d2a6SOded Gabbay /* 64819f6d2a6SOded Gabbay * kfd_process are stored in an mm_struct*->kfd_process* 64919f6d2a6SOded Gabbay * hash table (kfd_processes in kfd_process.c) 65019f6d2a6SOded Gabbay */ 65119f6d2a6SOded Gabbay struct hlist_node kfd_processes; 65219f6d2a6SOded Gabbay 6539b56bb11SFelix Kuehling /* 6549b56bb11SFelix Kuehling * Opaque pointer to mm_struct. We don't hold a reference to 6559b56bb11SFelix Kuehling * it so it should never be dereferenced from here. This is 6569b56bb11SFelix Kuehling * only used for looking up processes by their mm. 6579b56bb11SFelix Kuehling */ 6589b56bb11SFelix Kuehling void *mm; 65919f6d2a6SOded Gabbay 6605ce10687SFelix Kuehling struct kref ref; 6615ce10687SFelix Kuehling struct work_struct release_work; 6625ce10687SFelix Kuehling 66319f6d2a6SOded Gabbay struct mutex mutex; 66419f6d2a6SOded Gabbay 66519f6d2a6SOded Gabbay /* 66619f6d2a6SOded Gabbay * In any process, the thread that started main() is the lead 66719f6d2a6SOded Gabbay * thread and outlives the rest. 66819f6d2a6SOded Gabbay * It is here because amd_iommu_bind_pasid wants a task_struct. 669894a8293SFelix Kuehling * It can also be used for safely getting a reference to the 670894a8293SFelix Kuehling * mm_struct of the process. 67119f6d2a6SOded Gabbay */ 67219f6d2a6SOded Gabbay struct task_struct *lead_thread; 67319f6d2a6SOded Gabbay 67419f6d2a6SOded Gabbay /* We want to receive a notification when the mm_struct is destroyed */ 67519f6d2a6SOded Gabbay struct mmu_notifier mmu_notifier; 67619f6d2a6SOded Gabbay 67719f6d2a6SOded Gabbay /* Use for delayed freeing of kfd_process structure */ 67819f6d2a6SOded Gabbay struct rcu_head rcu; 67919f6d2a6SOded Gabbay 68019f6d2a6SOded Gabbay unsigned int pasid; 681a91e70e3SFelix Kuehling unsigned int doorbell_index; 68219f6d2a6SOded Gabbay 68319f6d2a6SOded Gabbay /* 68419f6d2a6SOded Gabbay * List of kfd_process_device structures, 68519f6d2a6SOded Gabbay * one for each device the process is using. 68619f6d2a6SOded Gabbay */ 68719f6d2a6SOded Gabbay struct list_head per_device_data; 68819f6d2a6SOded Gabbay 68945102048SBen Goz struct process_queue_manager pqm; 69045102048SBen Goz 69119f6d2a6SOded Gabbay /*Is the user space process 32 bit?*/ 69219f6d2a6SOded Gabbay bool is_32bit_user_mode; 693f3a39818SAndrew Lewycky 694f3a39818SAndrew Lewycky /* Event-related data */ 695f3a39818SAndrew Lewycky struct mutex event_mutex; 696482f0777SFelix Kuehling /* Event ID allocator and lookup */ 697482f0777SFelix Kuehling struct idr event_idr; 69850cb7dd9SFelix Kuehling /* Event page */ 69950cb7dd9SFelix Kuehling struct kfd_signal_page *signal_page; 700b9a5d0a5SFelix Kuehling size_t signal_mapped_size; 701f3a39818SAndrew Lewycky size_t signal_event_count; 702c986169fSFelix Kuehling bool signal_event_limit_reached; 703403575c4SFelix Kuehling 704403575c4SFelix Kuehling /* Information used for memory eviction */ 705403575c4SFelix Kuehling void *kgd_process_info; 706403575c4SFelix Kuehling /* Eviction fence that is attached to all the BOs of this process. The 707403575c4SFelix Kuehling * fence will be triggered during eviction and new one will be created 708403575c4SFelix Kuehling * during restore 709403575c4SFelix Kuehling */ 710403575c4SFelix Kuehling struct dma_fence *ef; 71126103436SFelix Kuehling 71226103436SFelix Kuehling /* Work items for evicting and restoring BOs */ 71326103436SFelix Kuehling struct delayed_work eviction_work; 71426103436SFelix Kuehling struct delayed_work restore_work; 71526103436SFelix Kuehling /* seqno of the last scheduled eviction */ 71626103436SFelix Kuehling unsigned int last_eviction_seqno; 71726103436SFelix Kuehling /* Approx. the last timestamp (in jiffies) when the process was 71826103436SFelix Kuehling * restored after an eviction 71926103436SFelix Kuehling */ 72026103436SFelix Kuehling unsigned long last_restore_timestamp; 7214a488a7aSOded Gabbay }; 7224a488a7aSOded Gabbay 72364d1c3a4SFelix Kuehling #define KFD_PROCESS_TABLE_SIZE 5 /* bits: 32 entries */ 72464d1c3a4SFelix Kuehling extern DECLARE_HASHTABLE(kfd_processes_table, KFD_PROCESS_TABLE_SIZE); 72564d1c3a4SFelix Kuehling extern struct srcu_struct kfd_processes_srcu; 72664d1c3a4SFelix Kuehling 72776baee6cSOded Gabbay /** 72876baee6cSOded Gabbay * Ioctl function type. 72976baee6cSOded Gabbay * 73076baee6cSOded Gabbay * \param filep pointer to file structure. 73176baee6cSOded Gabbay * \param p amdkfd process pointer. 73276baee6cSOded Gabbay * \param data pointer to arg that was copied from user. 73376baee6cSOded Gabbay */ 73476baee6cSOded Gabbay typedef int amdkfd_ioctl_t(struct file *filep, struct kfd_process *p, 73576baee6cSOded Gabbay void *data); 73676baee6cSOded Gabbay 73776baee6cSOded Gabbay struct amdkfd_ioctl_desc { 73876baee6cSOded Gabbay unsigned int cmd; 73976baee6cSOded Gabbay int flags; 74076baee6cSOded Gabbay amdkfd_ioctl_t *func; 74176baee6cSOded Gabbay unsigned int cmd_drv; 74276baee6cSOded Gabbay const char *name; 74376baee6cSOded Gabbay }; 74467f7cf9fSshaoyunl bool kfd_dev_is_large_bar(struct kfd_dev *dev); 74576baee6cSOded Gabbay 7461679ae8fSFelix Kuehling int kfd_process_create_wq(void); 74719f6d2a6SOded Gabbay void kfd_process_destroy_wq(void); 748373d7080SFelix Kuehling struct kfd_process *kfd_create_process(struct file *filep); 74919f6d2a6SOded Gabbay struct kfd_process *kfd_get_process(const struct task_struct *); 750f3a39818SAndrew Lewycky struct kfd_process *kfd_lookup_process_by_pasid(unsigned int pasid); 75126103436SFelix Kuehling struct kfd_process *kfd_lookup_process_by_mm(const struct mm_struct *mm); 752abb208a8SFelix Kuehling void kfd_unref_process(struct kfd_process *p); 7536b95e797SFelix Kuehling int kfd_process_evict_queues(struct kfd_process *p); 7546b95e797SFelix Kuehling int kfd_process_restore_queues(struct kfd_process *p); 75526103436SFelix Kuehling void kfd_suspend_all_processes(void); 75626103436SFelix Kuehling int kfd_resume_all_processes(void); 75719f6d2a6SOded Gabbay 758b84394e2SFelix Kuehling int kfd_process_device_init_vm(struct kfd_process_device *pdd, 759b84394e2SFelix Kuehling struct file *drm_file); 76064c7f8cfSBen Goz struct kfd_process_device *kfd_bind_process_to_device(struct kfd_dev *dev, 76164c7f8cfSBen Goz struct kfd_process *p); 76219f6d2a6SOded Gabbay struct kfd_process_device *kfd_get_process_device_data(struct kfd_dev *dev, 763093c7d8cSAlexey Skidanov struct kfd_process *p); 764093c7d8cSAlexey Skidanov struct kfd_process_device *kfd_create_process_device_data(struct kfd_dev *dev, 765093c7d8cSAlexey Skidanov struct kfd_process *p); 76619f6d2a6SOded Gabbay 767df03ef93SHarish Kasiviswanathan int kfd_reserved_mem_mmap(struct kfd_dev *dev, struct kfd_process *process, 768373d7080SFelix Kuehling struct vm_area_struct *vma); 769373d7080SFelix Kuehling 77052b29d73SFelix Kuehling /* KFD process API for creating and translating handles */ 77152b29d73SFelix Kuehling int kfd_process_device_create_obj_handle(struct kfd_process_device *pdd, 77252b29d73SFelix Kuehling void *mem); 77352b29d73SFelix Kuehling void *kfd_process_device_translate_handle(struct kfd_process_device *p, 77452b29d73SFelix Kuehling int handle); 77552b29d73SFelix Kuehling void kfd_process_device_remove_obj_handle(struct kfd_process_device *pdd, 77652b29d73SFelix Kuehling int handle); 77752b29d73SFelix Kuehling 778775921edSAlexey Skidanov /* Process device data iterator */ 7798eabaf54SKent Russell struct kfd_process_device *kfd_get_first_process_device_data( 7808eabaf54SKent Russell struct kfd_process *p); 7818eabaf54SKent Russell struct kfd_process_device *kfd_get_next_process_device_data( 7828eabaf54SKent Russell struct kfd_process *p, 783775921edSAlexey Skidanov struct kfd_process_device *pdd); 784775921edSAlexey Skidanov bool kfd_has_process_device_data(struct kfd_process *p); 785775921edSAlexey Skidanov 78619f6d2a6SOded Gabbay /* PASIDs */ 78719f6d2a6SOded Gabbay int kfd_pasid_init(void); 78819f6d2a6SOded Gabbay void kfd_pasid_exit(void); 78919f6d2a6SOded Gabbay bool kfd_set_pasid_limit(unsigned int new_limit); 79019f6d2a6SOded Gabbay unsigned int kfd_get_pasid_limit(void); 79119f6d2a6SOded Gabbay unsigned int kfd_pasid_alloc(void); 79219f6d2a6SOded Gabbay void kfd_pasid_free(unsigned int pasid); 79319f6d2a6SOded Gabbay 79419f6d2a6SOded Gabbay /* Doorbells */ 795ef568db7SFelix Kuehling size_t kfd_doorbell_process_slice(struct kfd_dev *kfd); 796735df2baSFelix Kuehling int kfd_doorbell_init(struct kfd_dev *kfd); 797735df2baSFelix Kuehling void kfd_doorbell_fini(struct kfd_dev *kfd); 798df03ef93SHarish Kasiviswanathan int kfd_doorbell_mmap(struct kfd_dev *dev, struct kfd_process *process, 799df03ef93SHarish Kasiviswanathan struct vm_area_struct *vma); 800ada2b29cSFelix Kuehling void __iomem *kfd_get_kernel_doorbell(struct kfd_dev *kfd, 80119f6d2a6SOded Gabbay unsigned int *doorbell_off); 80219f6d2a6SOded Gabbay void kfd_release_kernel_doorbell(struct kfd_dev *kfd, u32 __iomem *db_addr); 80319f6d2a6SOded Gabbay u32 read_kernel_doorbell(u32 __iomem *db); 804ada2b29cSFelix Kuehling void write_kernel_doorbell(void __iomem *db, u32 value); 8059d7d0248SFelix Kuehling void write_kernel_doorbell64(void __iomem *db, u64 value); 806ef568db7SFelix Kuehling unsigned int kfd_doorbell_id_to_offset(struct kfd_dev *kfd, 80719f6d2a6SOded Gabbay struct kfd_process *process, 808ef568db7SFelix Kuehling unsigned int doorbell_id); 809a91e70e3SFelix Kuehling phys_addr_t kfd_get_process_doorbells(struct kfd_dev *dev, 810a91e70e3SFelix Kuehling struct kfd_process *process); 811a91e70e3SFelix Kuehling int kfd_alloc_process_doorbells(struct kfd_process *process); 812a91e70e3SFelix Kuehling void kfd_free_process_doorbells(struct kfd_process *process); 81319f6d2a6SOded Gabbay 8146e81090bSOded Gabbay /* GTT Sub-Allocator */ 8156e81090bSOded Gabbay 8166e81090bSOded Gabbay int kfd_gtt_sa_allocate(struct kfd_dev *kfd, unsigned int size, 8176e81090bSOded Gabbay struct kfd_mem_obj **mem_obj); 8186e81090bSOded Gabbay 8196e81090bSOded Gabbay int kfd_gtt_sa_free(struct kfd_dev *kfd, struct kfd_mem_obj *mem_obj); 8206e81090bSOded Gabbay 8214a488a7aSOded Gabbay extern struct device *kfd_device; 8224a488a7aSOded Gabbay 8235b5c4e40SEvgeny Pinchuk /* Topology */ 8245b5c4e40SEvgeny Pinchuk int kfd_topology_init(void); 8255b5c4e40SEvgeny Pinchuk void kfd_topology_shutdown(void); 8265b5c4e40SEvgeny Pinchuk int kfd_topology_add_device(struct kfd_dev *gpu); 8275b5c4e40SEvgeny Pinchuk int kfd_topology_remove_device(struct kfd_dev *gpu); 8283a87177eSHarish Kasiviswanathan struct kfd_topology_device *kfd_topology_device_by_proximity_domain( 8293a87177eSHarish Kasiviswanathan uint32_t proximity_domain); 83044d8cc6fSYong Zhao struct kfd_topology_device *kfd_topology_device_by_id(uint32_t gpu_id); 8315b5c4e40SEvgeny Pinchuk struct kfd_dev *kfd_device_by_id(uint32_t gpu_id); 8325b5c4e40SEvgeny Pinchuk struct kfd_dev *kfd_device_by_pci_dev(const struct pci_dev *pdev); 8331dde0ea9SFelix Kuehling struct kfd_dev *kfd_device_by_kgd(const struct kgd_dev *kgd); 8346d82eb0eSHarish Kasiviswanathan int kfd_topology_enum_kfd_devices(uint8_t idx, struct kfd_dev **kdev); 835520b8fb7SFelix Kuehling int kfd_numa_node_to_apic_id(int numa_node_id); 8365b5c4e40SEvgeny Pinchuk 8374a488a7aSOded Gabbay /* Interrupts */ 8382249d558SAndrew Lewycky int kfd_interrupt_init(struct kfd_dev *dev); 8392249d558SAndrew Lewycky void kfd_interrupt_exit(struct kfd_dev *dev); 8402249d558SAndrew Lewycky bool enqueue_ih_ring_entry(struct kfd_dev *kfd, const void *ih_ring_entry); 84158e69886SLan Xiao bool interrupt_is_wanted(struct kfd_dev *dev, 84258e69886SLan Xiao const uint32_t *ih_ring_entry, 84358e69886SLan Xiao uint32_t *patched_ihre, bool *flag); 8444a488a7aSOded Gabbay 84519f6d2a6SOded Gabbay /* amdkfd Apertures */ 84619f6d2a6SOded Gabbay int kfd_init_apertures(struct kfd_process *process); 84719f6d2a6SOded Gabbay 848ed6e6a34SBen Goz /* Queue Context Management */ 849e88a614cSEdward O'Callaghan int init_queue(struct queue **q, const struct queue_properties *properties); 850ed6e6a34SBen Goz void uninit_queue(struct queue *q); 85145102048SBen Goz void print_queue_properties(struct queue_properties *q); 852ed6e6a34SBen Goz void print_queue(struct queue *q); 853ed6e6a34SBen Goz 8544b8f589bSBen Goz struct mqd_manager *mqd_manager_init_cik(enum KFD_MQD_TYPE type, 8554b8f589bSBen Goz struct kfd_dev *dev); 856ee04955aSFelix Kuehling struct mqd_manager *mqd_manager_init_cik_hawaii(enum KFD_MQD_TYPE type, 857ee04955aSFelix Kuehling struct kfd_dev *dev); 8584b8f589bSBen Goz struct mqd_manager *mqd_manager_init_vi(enum KFD_MQD_TYPE type, 8594b8f589bSBen Goz struct kfd_dev *dev); 860ee04955aSFelix Kuehling struct mqd_manager *mqd_manager_init_vi_tonga(enum KFD_MQD_TYPE type, 861ee04955aSFelix Kuehling struct kfd_dev *dev); 862b91d43ddSFelix Kuehling struct mqd_manager *mqd_manager_init_v9(enum KFD_MQD_TYPE type, 863b91d43ddSFelix Kuehling struct kfd_dev *dev); 86464c7f8cfSBen Goz struct device_queue_manager *device_queue_manager_init(struct kfd_dev *dev); 86564c7f8cfSBen Goz void device_queue_manager_uninit(struct device_queue_manager *dqm); 866241f24f8SBen Goz struct kernel_queue *kernel_queue_init(struct kfd_dev *dev, 867241f24f8SBen Goz enum kfd_queue_type type); 868241f24f8SBen Goz void kernel_queue_uninit(struct kernel_queue *kq); 8692640c3faSshaoyunl int kfd_process_vm_fault(struct device_queue_manager *dqm, unsigned int pasid); 870241f24f8SBen Goz 87145102048SBen Goz /* Process Queue Manager */ 87245102048SBen Goz struct process_queue_node { 87345102048SBen Goz struct queue *q; 87445102048SBen Goz struct kernel_queue *kq; 87545102048SBen Goz struct list_head process_queue_list; 87645102048SBen Goz }; 87745102048SBen Goz 8789fd3f1bfSFelix Kuehling void kfd_process_dequeue_from_device(struct kfd_process_device *pdd); 8799fd3f1bfSFelix Kuehling void kfd_process_dequeue_from_all_devices(struct kfd_process *p); 88045102048SBen Goz int pqm_init(struct process_queue_manager *pqm, struct kfd_process *p); 88145102048SBen Goz void pqm_uninit(struct process_queue_manager *pqm); 88245102048SBen Goz int pqm_create_queue(struct process_queue_manager *pqm, 88345102048SBen Goz struct kfd_dev *dev, 88445102048SBen Goz struct file *f, 88545102048SBen Goz struct queue_properties *properties, 88645102048SBen Goz unsigned int *qid); 88745102048SBen Goz int pqm_destroy_queue(struct process_queue_manager *pqm, unsigned int qid); 88845102048SBen Goz int pqm_update_queue(struct process_queue_manager *pqm, unsigned int qid, 88945102048SBen Goz struct queue_properties *p); 89039e7f331SFelix Kuehling int pqm_set_cu_mask(struct process_queue_manager *pqm, unsigned int qid, 89139e7f331SFelix Kuehling struct queue_properties *p); 892eb82da1dSOak Zeng int pqm_set_gws(struct process_queue_manager *pqm, unsigned int qid, 893eb82da1dSOak Zeng void *gws); 894fbeb661bSYair Shachar struct kernel_queue *pqm_get_kernel_queue(struct process_queue_manager *pqm, 895fbeb661bSYair Shachar unsigned int qid); 8965df099e8SJay Cornwall int pqm_get_wave_state(struct process_queue_manager *pqm, 8975df099e8SJay Cornwall unsigned int qid, 8985df099e8SJay Cornwall void __user *ctl_stack, 8995df099e8SJay Cornwall u32 *ctl_stack_used_size, 9005df099e8SJay Cornwall u32 *save_area_used_size); 90145102048SBen Goz 902788bf83dSYair Shachar int amdkfd_fence_wait_timeout(unsigned int *fence_addr, 903788bf83dSYair Shachar unsigned int fence_value, 9048c72c3d7SYong Zhao unsigned int timeout_ms); 905788bf83dSYair Shachar 906ed6e6a34SBen Goz /* Packet Manager */ 907ed6e6a34SBen Goz 90864c7f8cfSBen Goz #define KFD_FENCE_COMPLETED (100) 90964c7f8cfSBen Goz #define KFD_FENCE_INIT (10) 910241f24f8SBen Goz 911ed6e6a34SBen Goz struct packet_manager { 912ed6e6a34SBen Goz struct device_queue_manager *dqm; 913ed6e6a34SBen Goz struct kernel_queue *priv_queue; 914ed6e6a34SBen Goz struct mutex lock; 915ed6e6a34SBen Goz bool allocated; 916ed6e6a34SBen Goz struct kfd_mem_obj *ib_buffer_obj; 917851a645eSFelix Kuehling unsigned int ib_size_bytes; 918f6e27ff1SFelix Kuehling 919f6e27ff1SFelix Kuehling const struct packet_manager_funcs *pmf; 920ed6e6a34SBen Goz }; 921ed6e6a34SBen Goz 922f6e27ff1SFelix Kuehling struct packet_manager_funcs { 923f6e27ff1SFelix Kuehling /* Support ASIC-specific packet formats for PM4 packets */ 924f6e27ff1SFelix Kuehling int (*map_process)(struct packet_manager *pm, uint32_t *buffer, 925f6e27ff1SFelix Kuehling struct qcm_process_device *qpd); 926f6e27ff1SFelix Kuehling int (*runlist)(struct packet_manager *pm, uint32_t *buffer, 927f6e27ff1SFelix Kuehling uint64_t ib, size_t ib_size_in_dwords, bool chain); 928f6e27ff1SFelix Kuehling int (*set_resources)(struct packet_manager *pm, uint32_t *buffer, 929f6e27ff1SFelix Kuehling struct scheduling_resources *res); 930f6e27ff1SFelix Kuehling int (*map_queues)(struct packet_manager *pm, uint32_t *buffer, 931f6e27ff1SFelix Kuehling struct queue *q, bool is_static); 932f6e27ff1SFelix Kuehling int (*unmap_queues)(struct packet_manager *pm, uint32_t *buffer, 933f6e27ff1SFelix Kuehling enum kfd_queue_type type, 934f6e27ff1SFelix Kuehling enum kfd_unmap_queues_filter mode, 935f6e27ff1SFelix Kuehling uint32_t filter_param, bool reset, 936f6e27ff1SFelix Kuehling unsigned int sdma_engine); 937f6e27ff1SFelix Kuehling int (*query_status)(struct packet_manager *pm, uint32_t *buffer, 938f6e27ff1SFelix Kuehling uint64_t fence_address, uint32_t fence_value); 939f6e27ff1SFelix Kuehling int (*release_mem)(uint64_t gpu_addr, uint32_t *buffer); 940f6e27ff1SFelix Kuehling 941f6e27ff1SFelix Kuehling /* Packet sizes */ 942f6e27ff1SFelix Kuehling int map_process_size; 943f6e27ff1SFelix Kuehling int runlist_size; 944f6e27ff1SFelix Kuehling int set_resources_size; 945f6e27ff1SFelix Kuehling int map_queues_size; 946f6e27ff1SFelix Kuehling int unmap_queues_size; 947f6e27ff1SFelix Kuehling int query_status_size; 948f6e27ff1SFelix Kuehling int release_mem_size; 949f6e27ff1SFelix Kuehling }; 950f6e27ff1SFelix Kuehling 951f6e27ff1SFelix Kuehling extern const struct packet_manager_funcs kfd_vi_pm_funcs; 952454150b1SFelix Kuehling extern const struct packet_manager_funcs kfd_v9_pm_funcs; 953f6e27ff1SFelix Kuehling 95464c7f8cfSBen Goz int pm_init(struct packet_manager *pm, struct device_queue_manager *dqm); 95564c7f8cfSBen Goz void pm_uninit(struct packet_manager *pm); 95664c7f8cfSBen Goz int pm_send_set_resources(struct packet_manager *pm, 95764c7f8cfSBen Goz struct scheduling_resources *res); 95864c7f8cfSBen Goz int pm_send_runlist(struct packet_manager *pm, struct list_head *dqm_queues); 95964c7f8cfSBen Goz int pm_send_query_status(struct packet_manager *pm, uint64_t fence_address, 96064c7f8cfSBen Goz uint32_t fence_value); 96164c7f8cfSBen Goz 96264c7f8cfSBen Goz int pm_send_unmap_queue(struct packet_manager *pm, enum kfd_queue_type type, 9637da2bcf8SYong Zhao enum kfd_unmap_queues_filter mode, 96464c7f8cfSBen Goz uint32_t filter_param, bool reset, 96564c7f8cfSBen Goz unsigned int sdma_engine); 96664c7f8cfSBen Goz 967241f24f8SBen Goz void pm_release_ib(struct packet_manager *pm); 968241f24f8SBen Goz 969454150b1SFelix Kuehling /* Following PM funcs can be shared among VI and AI */ 970454150b1SFelix Kuehling unsigned int pm_build_pm4_header(unsigned int opcode, size_t packet_size); 971454150b1SFelix Kuehling int pm_set_resources_vi(struct packet_manager *pm, uint32_t *buffer, 972454150b1SFelix Kuehling struct scheduling_resources *res); 973454150b1SFelix Kuehling 97419f6d2a6SOded Gabbay uint64_t kfd_get_number_elems(struct kfd_dev *kfd); 97519f6d2a6SOded Gabbay 976f3a39818SAndrew Lewycky /* Events */ 977f3a39818SAndrew Lewycky extern const struct kfd_event_interrupt_class event_interrupt_class_cik; 978ca750681SFelix Kuehling extern const struct kfd_event_interrupt_class event_interrupt_class_v9; 979ca750681SFelix Kuehling 980930c5ff4SAlexey Skidanov extern const struct kfd_device_global_init_class device_global_init_class_cik; 981f3a39818SAndrew Lewycky 982f3a39818SAndrew Lewycky void kfd_event_init_process(struct kfd_process *p); 983f3a39818SAndrew Lewycky void kfd_event_free_process(struct kfd_process *p); 984f3a39818SAndrew Lewycky int kfd_event_mmap(struct kfd_process *process, struct vm_area_struct *vma); 985f3a39818SAndrew Lewycky int kfd_wait_on_events(struct kfd_process *p, 98659d3e8beSAlexey Skidanov uint32_t num_events, void __user *data, 987f3a39818SAndrew Lewycky bool all, uint32_t user_timeout_ms, 988fdf0c833SFelix Kuehling uint32_t *wait_result); 989f3a39818SAndrew Lewycky void kfd_signal_event_interrupt(unsigned int pasid, uint32_t partial_id, 990f3a39818SAndrew Lewycky uint32_t valid_id_bits); 99159d3e8beSAlexey Skidanov void kfd_signal_iommu_event(struct kfd_dev *dev, 99259d3e8beSAlexey Skidanov unsigned int pasid, unsigned long address, 99359d3e8beSAlexey Skidanov bool is_write_requested, bool is_execute_requested); 994930c5ff4SAlexey Skidanov void kfd_signal_hw_exception_event(unsigned int pasid); 995f3a39818SAndrew Lewycky int kfd_set_event(struct kfd_process *p, uint32_t event_id); 996f3a39818SAndrew Lewycky int kfd_reset_event(struct kfd_process *p, uint32_t event_id); 9970fc8011fSFelix Kuehling int kfd_event_page_set(struct kfd_process *p, void *kernel_address, 9980fc8011fSFelix Kuehling uint64_t size); 999f3a39818SAndrew Lewycky int kfd_event_create(struct file *devkfd, struct kfd_process *p, 1000f3a39818SAndrew Lewycky uint32_t event_type, bool auto_reset, uint32_t node_id, 1001f3a39818SAndrew Lewycky uint32_t *event_id, uint32_t *event_trigger_data, 1002f3a39818SAndrew Lewycky uint64_t *event_page_offset, uint32_t *event_slot_index); 1003f3a39818SAndrew Lewycky int kfd_event_destroy(struct kfd_process *p, uint32_t event_id); 1004f3a39818SAndrew Lewycky 10052640c3faSshaoyunl void kfd_signal_vm_fault_event(struct kfd_dev *dev, unsigned int pasid, 10062640c3faSshaoyunl struct kfd_vm_fault_info *info); 10072640c3faSshaoyunl 1008e42051d2SShaoyun Liu void kfd_signal_reset_event(struct kfd_dev *dev); 1009e42051d2SShaoyun Liu 1010403575c4SFelix Kuehling void kfd_flush_tlb(struct kfd_process_device *pdd); 1011403575c4SFelix Kuehling 1012c3447e81SBen Goz int dbgdev_wave_reset_wavefronts(struct kfd_dev *dev, struct kfd_process *p); 1013c3447e81SBen Goz 1014e42051d2SShaoyun Liu bool kfd_is_locked(void); 1015e42051d2SShaoyun Liu 1016f756e631SHarish Kasiviswanathan /* Compute profile */ 1017f756e631SHarish Kasiviswanathan void kfd_inc_compute_active(struct kfd_dev *dev); 1018f756e631SHarish Kasiviswanathan void kfd_dec_compute_active(struct kfd_dev *dev); 1019f756e631SHarish Kasiviswanathan 1020851a645eSFelix Kuehling /* Debugfs */ 1021851a645eSFelix Kuehling #if defined(CONFIG_DEBUG_FS) 1022851a645eSFelix Kuehling 1023851a645eSFelix Kuehling void kfd_debugfs_init(void); 1024851a645eSFelix Kuehling void kfd_debugfs_fini(void); 1025851a645eSFelix Kuehling int kfd_debugfs_mqds_by_process(struct seq_file *m, void *data); 1026851a645eSFelix Kuehling int pqm_debugfs_mqds(struct seq_file *m, void *data); 1027851a645eSFelix Kuehling int kfd_debugfs_hqds_by_device(struct seq_file *m, void *data); 1028851a645eSFelix Kuehling int dqm_debugfs_hqds(struct seq_file *m, void *data); 1029851a645eSFelix Kuehling int kfd_debugfs_rls_by_device(struct seq_file *m, void *data); 1030851a645eSFelix Kuehling int pm_debugfs_runlist(struct seq_file *m, void *data); 1031851a645eSFelix Kuehling 1032a29ec470SShaoyun Liu int kfd_debugfs_hang_hws(struct kfd_dev *dev); 1033a29ec470SShaoyun Liu int pm_debugfs_hang_hws(struct packet_manager *pm); 1034a29ec470SShaoyun Liu int dqm_debugfs_execute_queues(struct device_queue_manager *dqm); 1035a29ec470SShaoyun Liu 1036851a645eSFelix Kuehling #else 1037851a645eSFelix Kuehling 1038851a645eSFelix Kuehling static inline void kfd_debugfs_init(void) {} 1039851a645eSFelix Kuehling static inline void kfd_debugfs_fini(void) {} 1040851a645eSFelix Kuehling 1041851a645eSFelix Kuehling #endif 1042851a645eSFelix Kuehling 10434a488a7aSOded Gabbay #endif 1044