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 "display/intel_display_device.h"
18 #include "gt/intel_engine.h"
19 #include "gt/intel_engine_types.h"
20 #include "gt/intel_gt_types.h"
21 #include "gt/uc/intel_uc_fw.h"
23 #include "intel_device_info.h"
26 #include "i915_gem_gtt.h"
27 #include "i915_params.h"
28 #include "i915_scheduler.h"
30 struct drm_i915_private;
31 struct i915_vma_compress;
32 struct intel_engine_capture_vma;
33 struct intel_overlay_error_state;
35 struct i915_vma_coredump {
36 struct i915_vma_coredump *next;
45 struct list_head page_list;
48 struct i915_request_coredump {
55 struct i915_sched_attr sched_attr;
58 struct __guc_capture_parsed_output;
60 struct intel_engine_coredump {
61 const struct intel_engine_cs *engine;
67 /* position of active request inside the ring */
68 u32 rq_head, rq_post, rq_tail;
88 u32 rc_psmi; /* sleep state */
96 struct intel_instdone instdone;
98 /* GuC matched capture-lists info */
99 struct intel_guc_state_capture *guc_capture;
100 struct __guc_capture_parsed_output *guc_capture_node;
102 struct i915_gem_context_coredump {
103 char comm[TASK_COMM_LEN];
111 struct i915_sched_attr sched_attr;
115 struct i915_vma_coredump *vma;
117 struct i915_request_coredump execlist[EXECLIST_MAX_PORTS];
118 unsigned int num_ports;
128 struct intel_engine_coredump *next;
131 struct intel_ctb_coredump {
140 struct intel_gt_coredump {
141 const struct intel_gt *_gt;
145 struct intel_gt_info info;
147 /* Generic register state */
151 u32 gtier[6], ngtier;
153 u32 error; /* gen6+ */
154 u32 err_int; /* gen7 */
155 u32 fault_data0; /* gen8, gen9 */
156 u32 fault_data1; /* gen8, gen9 */
163 u32 aux_err; /* gen12 */
164 u32 gam_done; /* gen12 */
168 /* Display related */
170 u32 sfc_done[I915_MAX_SFC]; /* gen12 */
173 u64 fence[I915_MAX_NUM_FENCES];
175 struct intel_engine_coredump *engine;
177 struct intel_uc_coredump {
178 struct intel_uc_fw guc_fw;
179 struct intel_uc_fw huc_fw;
181 struct intel_ctb_coredump ctb[2];
182 struct i915_vma_coredump *vma_ctb;
183 struct i915_vma_coredump *vma_log;
190 struct intel_gt_coredump *next;
193 struct i915_gpu_coredump {
198 unsigned long capture;
200 struct drm_i915_private *i915;
202 struct intel_gt_coredump *gt;
212 struct intel_device_info device_info;
213 struct intel_runtime_info runtime_info;
214 struct intel_display_device_info display_device_info;
215 struct intel_display_runtime_info display_runtime_info;
216 struct intel_driver_caps driver_caps;
217 struct i915_params params;
219 struct intel_overlay_error_state *overlay;
221 struct scatterlist *sgl, *fit;
224 struct i915_gpu_error {
225 /* For reset and error_state handling. */
227 /* Protected by the above dev->gpu_error.lock. */
228 struct i915_gpu_coredump *first_error;
230 atomic_t pending_fb_pin;
232 /** Number of times the device has been reset (global) */
233 atomic_t reset_count;
235 /** Number of times an engine has been reset */
236 atomic_t reset_engine_count[MAX_ENGINE_CLASS];
239 struct drm_i915_error_state_buf {
240 struct drm_i915_private *i915;
241 struct scatterlist *sgl, *cur, *end;
251 static inline u32 i915_reset_count(struct i915_gpu_error *error)
253 return atomic_read(&error->reset_count);
256 static inline u32 i915_reset_engine_count(struct i915_gpu_error *error,
257 const struct intel_engine_cs *engine)
259 return atomic_read(&error->reset_engine_count[engine->class]);
263 i915_increase_reset_engine_count(struct i915_gpu_error *error,
264 const struct intel_engine_cs *engine)
266 atomic_inc(&error->reset_engine_count[engine->class]);
269 #define CORE_DUMP_FLAG_NONE 0x0
270 #define CORE_DUMP_FLAG_IS_GUC_CAPTURE BIT(0)
272 #if IS_ENABLED(CONFIG_DRM_I915_CAPTURE_ERROR) && IS_ENABLED(CONFIG_DRM_I915_DEBUG_GEM)
273 void intel_klog_error_capture(struct intel_gt *gt,
274 intel_engine_mask_t engine_mask);
276 static inline void intel_klog_error_capture(struct intel_gt *gt,
277 intel_engine_mask_t engine_mask)
282 #if IS_ENABLED(CONFIG_DRM_I915_CAPTURE_ERROR)
285 void i915_error_printf(struct drm_i915_error_state_buf *e, const char *f, ...);
286 void intel_gpu_error_print_vma(struct drm_i915_error_state_buf *m,
287 const struct intel_engine_cs *engine,
288 const struct i915_vma_coredump *vma);
289 struct i915_vma_coredump *
290 intel_gpu_error_find_batch(const struct intel_engine_coredump *ee);
292 struct i915_gpu_coredump *i915_gpu_coredump(struct intel_gt *gt,
293 intel_engine_mask_t engine_mask, u32 dump_flags);
294 void i915_capture_error_state(struct intel_gt *gt,
295 intel_engine_mask_t engine_mask, u32 dump_flags);
297 struct i915_gpu_coredump *
298 i915_gpu_coredump_alloc(struct drm_i915_private *i915, gfp_t gfp);
300 struct intel_gt_coredump *
301 intel_gt_coredump_alloc(struct intel_gt *gt, gfp_t gfp, u32 dump_flags);
303 struct intel_engine_coredump *
304 intel_engine_coredump_alloc(struct intel_engine_cs *engine, gfp_t gfp, u32 dump_flags);
306 struct intel_engine_capture_vma *
307 intel_engine_coredump_add_request(struct intel_engine_coredump *ee,
308 struct i915_request *rq,
311 void intel_engine_coredump_add_vma(struct intel_engine_coredump *ee,
312 struct intel_engine_capture_vma *capture,
313 struct i915_vma_compress *compress);
315 struct i915_vma_compress *
316 i915_vma_capture_prepare(struct intel_gt_coredump *gt);
318 void i915_vma_capture_finish(struct intel_gt_coredump *gt,
319 struct i915_vma_compress *compress);
321 void i915_error_state_store(struct i915_gpu_coredump *error);
323 static inline struct i915_gpu_coredump *
324 i915_gpu_coredump_get(struct i915_gpu_coredump *gpu)
331 i915_gpu_coredump_copy_to_buffer(struct i915_gpu_coredump *error,
332 char *buf, loff_t offset, size_t count);
334 void __i915_gpu_coredump_free(struct kref *kref);
335 static inline void i915_gpu_coredump_put(struct i915_gpu_coredump *gpu)
338 kref_put(&gpu->ref, __i915_gpu_coredump_free);
341 struct i915_gpu_coredump *i915_first_error_state(struct drm_i915_private *i915);
342 void i915_reset_error_state(struct drm_i915_private *i915);
343 void i915_disable_error_state(struct drm_i915_private *i915, int err);
349 i915_error_printf(struct drm_i915_error_state_buf *e, const char *f, ...)
354 i915_capture_error_state(struct intel_gt *gt, intel_engine_mask_t engine_mask, u32 dump_flags)
358 static inline struct i915_gpu_coredump *
359 i915_gpu_coredump_alloc(struct drm_i915_private *i915, gfp_t gfp)
364 static inline struct intel_gt_coredump *
365 intel_gt_coredump_alloc(struct intel_gt *gt, gfp_t gfp, u32 dump_flags)
370 static inline struct intel_engine_coredump *
371 intel_engine_coredump_alloc(struct intel_engine_cs *engine, gfp_t gfp, u32 dump_flags)
376 static inline struct intel_engine_capture_vma *
377 intel_engine_coredump_add_request(struct intel_engine_coredump *ee,
378 struct i915_request *rq,
385 intel_engine_coredump_add_vma(struct intel_engine_coredump *ee,
386 struct intel_engine_capture_vma *capture,
387 struct i915_vma_compress *compress)
391 static inline struct i915_vma_compress *
392 i915_vma_capture_prepare(struct intel_gt_coredump *gt)
398 i915_vma_capture_finish(struct intel_gt_coredump *gt,
399 struct i915_vma_compress *compress)
404 i915_error_state_store(struct i915_gpu_coredump *error)
408 static inline void i915_gpu_coredump_put(struct i915_gpu_coredump *gpu)
412 static inline struct i915_gpu_coredump *
413 i915_first_error_state(struct drm_i915_private *i915)
415 return ERR_PTR(-ENODEV);
418 static inline void i915_reset_error_state(struct drm_i915_private *i915)
422 static inline void i915_disable_error_state(struct drm_i915_private *i915,
427 #endif /* IS_ENABLED(CONFIG_DRM_I915_CAPTURE_ERROR) */
429 #endif /* _I915_GPU_ERROR_H_ */