2 * SPDX-License-Identifier: MIT
4 * Copyright © 2008-2018 Intel Corporation
7 #ifndef _I915_GPU_ERROR_H_
8 #define _I915_GPU_ERROR_H_
10 #include <linux/atomic.h>
11 #include <linux/kref.h>
12 #include <linux/ktime.h>
13 #include <linux/sched.h>
15 #include <drm/drm_mm.h>
17 #include "gt/intel_engine.h"
18 #include "gt/intel_engine_types.h"
19 #include "gt/intel_gt_types.h"
20 #include "gt/uc/intel_uc_fw.h"
22 #include "intel_device_info.h"
25 #include "i915_gem_gtt.h"
26 #include "i915_params.h"
27 #include "i915_scheduler.h"
29 struct drm_i915_private;
30 struct i915_vma_compress;
31 struct intel_engine_capture_vma;
32 struct intel_display_snapshot;
34 struct i915_vma_coredump {
35 struct i915_vma_coredump *next;
44 struct list_head page_list;
47 struct i915_request_coredump {
54 struct i915_sched_attr sched_attr;
57 struct __guc_capture_parsed_output;
59 struct intel_engine_coredump {
60 const struct intel_engine_cs *engine;
66 /* position of active request inside the ring */
67 u32 rq_head, rq_post, rq_tail;
87 u32 rc_psmi; /* sleep state */
95 struct intel_instdone instdone;
97 /* GuC matched capture-lists info */
98 struct intel_guc_state_capture *guc_capture;
99 struct __guc_capture_parsed_output *guc_capture_node;
101 struct i915_gem_context_coredump {
102 char comm[TASK_COMM_LEN];
110 struct i915_sched_attr sched_attr;
114 struct i915_vma_coredump *vma;
116 struct i915_request_coredump execlist[EXECLIST_MAX_PORTS];
117 unsigned int num_ports;
127 struct intel_engine_coredump *next;
130 struct intel_ctb_coredump {
139 struct intel_gt_coredump {
140 const struct intel_gt *_gt;
144 struct intel_gt_info info;
146 /* Generic register state */
150 u32 gtier[6], ngtier;
152 u32 error; /* gen6+ */
153 u32 err_int; /* gen7 */
154 u32 fault_data0; /* gen8, gen9 */
155 u32 fault_data1; /* gen8, gen9 */
162 u32 aux_err; /* gen12 */
163 u32 gam_done; /* gen12 */
167 /* Display related */
169 u32 sfc_done[I915_MAX_SFC]; /* gen12 */
172 u64 fence[I915_MAX_NUM_FENCES];
174 struct intel_engine_coredump *engine;
176 struct intel_uc_coredump {
177 struct intel_uc_fw guc_fw;
178 struct intel_uc_fw huc_fw;
180 struct intel_ctb_coredump ctb[2];
181 struct i915_vma_coredump *vma_ctb;
182 struct i915_vma_coredump *vma_log;
189 struct intel_gt_coredump *next;
192 struct i915_gpu_coredump {
197 unsigned long capture;
199 struct drm_i915_private *i915;
201 struct intel_gt_coredump *gt;
211 struct intel_device_info device_info;
212 struct intel_runtime_info runtime_info;
213 struct intel_driver_caps driver_caps;
214 struct i915_params params;
216 struct scatterlist *sgl, *fit;
218 struct intel_display_snapshot *display_snapshot;
221 struct i915_gpu_error {
222 /* For reset and error_state handling. */
224 /* Protected by the above dev->gpu_error.lock. */
225 struct i915_gpu_coredump *first_error;
227 atomic_t pending_fb_pin;
229 /** Number of times the device has been reset (global) */
230 atomic_t reset_count;
232 /** Number of times an engine has been reset */
233 atomic_t reset_engine_count[MAX_ENGINE_CLASS];
236 struct drm_i915_error_state_buf {
237 struct drm_i915_private *i915;
238 struct scatterlist *sgl, *cur, *end;
248 static inline u32 i915_reset_count(struct i915_gpu_error *error)
250 return atomic_read(&error->reset_count);
253 static inline u32 i915_reset_engine_count(struct i915_gpu_error *error,
254 const struct intel_engine_cs *engine)
256 return atomic_read(&error->reset_engine_count[engine->class]);
260 i915_increase_reset_engine_count(struct i915_gpu_error *error,
261 const struct intel_engine_cs *engine)
263 atomic_inc(&error->reset_engine_count[engine->class]);
266 #define CORE_DUMP_FLAG_NONE 0x0
267 #define CORE_DUMP_FLAG_IS_GUC_CAPTURE BIT(0)
269 #if IS_ENABLED(CONFIG_DRM_I915_CAPTURE_ERROR) && IS_ENABLED(CONFIG_DRM_I915_DEBUG_GEM)
270 void intel_klog_error_capture(struct intel_gt *gt,
271 intel_engine_mask_t engine_mask);
273 static inline void intel_klog_error_capture(struct intel_gt *gt,
274 intel_engine_mask_t engine_mask)
279 #if IS_ENABLED(CONFIG_DRM_I915_CAPTURE_ERROR)
282 void i915_error_printf(struct drm_i915_error_state_buf *e, const char *f, ...);
284 void i915_capture_error_state(struct intel_gt *gt,
285 intel_engine_mask_t engine_mask, u32 dump_flags);
287 struct i915_gpu_coredump *
288 i915_gpu_coredump_alloc(struct drm_i915_private *i915, gfp_t gfp);
290 struct intel_gt_coredump *
291 intel_gt_coredump_alloc(struct intel_gt *gt, gfp_t gfp, u32 dump_flags);
293 struct intel_engine_coredump *
294 intel_engine_coredump_alloc(struct intel_engine_cs *engine, gfp_t gfp, u32 dump_flags);
296 struct intel_engine_capture_vma *
297 intel_engine_coredump_add_request(struct intel_engine_coredump *ee,
298 struct i915_request *rq,
301 void intel_engine_coredump_add_vma(struct intel_engine_coredump *ee,
302 struct intel_engine_capture_vma *capture,
303 struct i915_vma_compress *compress);
305 struct i915_vma_compress *
306 i915_vma_capture_prepare(struct intel_gt_coredump *gt);
308 void i915_vma_capture_finish(struct intel_gt_coredump *gt,
309 struct i915_vma_compress *compress);
311 void i915_error_state_store(struct i915_gpu_coredump *error);
313 static inline struct i915_gpu_coredump *
314 i915_gpu_coredump_get(struct i915_gpu_coredump *gpu)
321 i915_gpu_coredump_copy_to_buffer(struct i915_gpu_coredump *error,
322 char *buf, loff_t offset, size_t count);
324 void __i915_gpu_coredump_free(struct kref *kref);
325 static inline void i915_gpu_coredump_put(struct i915_gpu_coredump *gpu)
328 kref_put(&gpu->ref, __i915_gpu_coredump_free);
331 void i915_reset_error_state(struct drm_i915_private *i915);
332 void i915_disable_error_state(struct drm_i915_private *i915, int err);
334 void i915_gpu_error_debugfs_register(struct drm_i915_private *i915);
335 void i915_gpu_error_sysfs_setup(struct drm_i915_private *i915);
336 void i915_gpu_error_sysfs_teardown(struct drm_i915_private *i915);
342 i915_error_printf(struct drm_i915_error_state_buf *e, const char *f, ...)
347 i915_capture_error_state(struct intel_gt *gt, intel_engine_mask_t engine_mask, u32 dump_flags)
351 static inline struct i915_gpu_coredump *
352 i915_gpu_coredump_alloc(struct drm_i915_private *i915, gfp_t gfp)
357 static inline struct intel_gt_coredump *
358 intel_gt_coredump_alloc(struct intel_gt *gt, gfp_t gfp, u32 dump_flags)
363 static inline struct intel_engine_coredump *
364 intel_engine_coredump_alloc(struct intel_engine_cs *engine, gfp_t gfp, u32 dump_flags)
369 static inline struct intel_engine_capture_vma *
370 intel_engine_coredump_add_request(struct intel_engine_coredump *ee,
371 struct i915_request *rq,
378 intel_engine_coredump_add_vma(struct intel_engine_coredump *ee,
379 struct intel_engine_capture_vma *capture,
380 struct i915_vma_compress *compress)
384 static inline struct i915_vma_compress *
385 i915_vma_capture_prepare(struct intel_gt_coredump *gt)
391 i915_vma_capture_finish(struct intel_gt_coredump *gt,
392 struct i915_vma_compress *compress)
397 i915_error_state_store(struct i915_gpu_coredump *error)
401 static inline void i915_gpu_coredump_put(struct i915_gpu_coredump *gpu)
405 static inline void i915_reset_error_state(struct drm_i915_private *i915)
409 static inline void i915_disable_error_state(struct drm_i915_private *i915,
414 static inline void i915_gpu_error_debugfs_register(struct drm_i915_private *i915)
418 static inline void i915_gpu_error_sysfs_setup(struct drm_i915_private *i915)
422 static inline void i915_gpu_error_sysfs_teardown(struct drm_i915_private *i915)
426 #endif /* IS_ENABLED(CONFIG_DRM_I915_CAPTURE_ERROR) */
428 #endif /* _I915_GPU_ERROR_H_ */