1b27e35aeSChris Wilsonconfig DRM_I915_USERFAULT_AUTOSUSPEND 2b27e35aeSChris Wilson int "Runtime autosuspend delay for userspace GGTT mmaps (ms)" 3b27e35aeSChris Wilson default 250 # milliseconds 4b27e35aeSChris Wilson help 5b27e35aeSChris Wilson On runtime suspend, as we suspend the device, we have to revoke 6b27e35aeSChris Wilson userspace GGTT mmaps and force userspace to take a pagefault on 7b27e35aeSChris Wilson their next access. The revocation and subsequent recreation of 8b27e35aeSChris Wilson the GGTT mmap can be very slow and so we impose a small hysteris 9b27e35aeSChris Wilson that complements the runtime-pm autosuspend and provides a lower 10b27e35aeSChris Wilson floor on the autosuspend delay. 11b27e35aeSChris Wilson 12b27e35aeSChris Wilson May be 0 to disable the extra delay and solely use the device level 13b27e35aeSChris Wilson runtime pm autosuspend delay tunable. 14b27e35aeSChris Wilson 15058179e7SChris Wilsonconfig DRM_I915_HEARTBEAT_INTERVAL 16058179e7SChris Wilson int "Interval between heartbeat pulses (ms)" 17058179e7SChris Wilson default 2500 # milliseconds 18058179e7SChris Wilson help 19058179e7SChris Wilson The driver sends a periodic heartbeat down all active engines to 20058179e7SChris Wilson check the health of the GPU and undertake regular house-keeping of 21058179e7SChris Wilson internal driver state. 22058179e7SChris Wilson 239a40bdddSChris Wilson This is adjustable via 249a40bdddSChris Wilson /sys/class/drm/card?/engine/*/heartbeat_interval_ms 259a40bdddSChris Wilson 26058179e7SChris Wilson May be 0 to disable heartbeats and therefore disable automatic GPU 27058179e7SChris Wilson hang detection. 28058179e7SChris Wilson 293a7a92abSChris Wilsonconfig DRM_I915_PREEMPT_TIMEOUT 303a7a92abSChris Wilson int "Preempt timeout (ms, jiffy granularity)" 315766a5ffSChris Wilson default 640 # milliseconds 323a7a92abSChris Wilson help 333a7a92abSChris Wilson How long to wait (in milliseconds) for a preemption event to occur 343a7a92abSChris Wilson when submitting a new context via execlists. If the current context 353a7a92abSChris Wilson does not hit an arbitration point and yield to HW before the timer 363a7a92abSChris Wilson expires, the HW will be reset to allow the more important context 373a7a92abSChris Wilson to execute. 383a7a92abSChris Wilson 39db3d8338SChris Wilson This is adjustable via 40db3d8338SChris Wilson /sys/class/drm/card?/engine/*/preempt_timeout_ms 41db3d8338SChris Wilson 423a7a92abSChris Wilson May be 0 to disable the timeout. 433a7a92abSChris Wilson 44*07bcfd12STvrtko Ursulin The compiled in default may get overridden at driver probe time on 45*07bcfd12STvrtko Ursulin certain platforms and certain engines which will be reflected in the 46*07bcfd12STvrtko Ursulin sysfs control. 47*07bcfd12STvrtko Ursulin 48062444bbSChris Wilsonconfig DRM_I915_MAX_REQUEST_BUSYWAIT 49062444bbSChris Wilson int "Busywait for request completion limit (ns)" 50062444bbSChris Wilson default 8000 # nanoseconds 517ce99d24SChris Wilson help 527ce99d24SChris Wilson Before sleeping waiting for a request (GPU operation) to complete, 537ce99d24SChris Wilson we may spend some time polling for its completion. As the IRQ may 547ce99d24SChris Wilson take a non-negligible time to setup, we do a short spin first to 557ce99d24SChris Wilson check if the request will complete in the time it would have taken 567ce99d24SChris Wilson us to enable the interrupt. 577ce99d24SChris Wilson 58062444bbSChris Wilson This is adjustable via 59062444bbSChris Wilson /sys/class/drm/card?/engine/*/max_busywait_duration_ns 60062444bbSChris Wilson 617ce99d24SChris Wilson May be 0 to disable the initial spin. In practice, we estimate 627ce99d24SChris Wilson the cost of enabling the interrupt (if currently disabled) to be 637ce99d24SChris Wilson a few microseconds. 64a8c51ed2SChris Wilson 65a8c51ed2SChris Wilsonconfig DRM_I915_STOP_TIMEOUT 66a8c51ed2SChris Wilson int "How long to wait for an engine to quiesce gracefully before reset (ms)" 67a8c51ed2SChris Wilson default 100 # milliseconds 68a8c51ed2SChris Wilson help 69a8c51ed2SChris Wilson By stopping submission and sleeping for a short time before resetting 70a8c51ed2SChris Wilson the GPU, we allow the innocent contexts also on the system to quiesce. 71a8c51ed2SChris Wilson It is then less likely for a hanging context to cause collateral 72a8c51ed2SChris Wilson damage as the system is reset in order to recover. The corollary is 73a8c51ed2SChris Wilson that the reset itself may take longer and so be more disruptive to 74a8c51ed2SChris Wilson interactive or low latency workloads. 75b79029b2SChris Wilson 7672338a1fSChris Wilson This is adjustable via 7772338a1fSChris Wilson /sys/class/drm/card?/engine/*/stop_timeout_ms 7872338a1fSChris Wilson 79b79029b2SChris Wilsonconfig DRM_I915_TIMESLICE_DURATION 80b79029b2SChris Wilson int "Scheduling quantum for userspace batches (ms, jiffy granularity)" 81b79029b2SChris Wilson default 1 # milliseconds 82b79029b2SChris Wilson help 83b79029b2SChris Wilson When two user batches of equal priority are executing, we will 84b79029b2SChris Wilson alternate execution of each batch to ensure forward progress of 85b79029b2SChris Wilson all users. This is necessary in some cases where there may be 86b79029b2SChris Wilson an implicit dependency between those batches that requires 87b79029b2SChris Wilson concurrent execution in order for them to proceed, e.g. they 88b79029b2SChris Wilson interact with each other via userspace semaphores. Each context 89b79029b2SChris Wilson is scheduled for execution for the timeslice duration, before 90b79029b2SChris Wilson switching to the next context. 91b79029b2SChris Wilson 921a2695a7SChris Wilson This is adjustable via 931a2695a7SChris Wilson /sys/class/drm/card?/engine/*/timeslice_duration_ms 941a2695a7SChris Wilson 95b79029b2SChris Wilson May be 0 to disable timeslicing. 96