1 /*
2  * SPDX-License-Identifier: MIT
3  *
4  * Copyright � 2008-2018 Intel Corporation
5  */
6 
7 #ifndef _I915_GPU_ERROR_H_
8 #define _I915_GPU_ERROR_H_
9 
10 #include <linux/atomic.h>
11 #include <linux/kref.h>
12 #include <linux/ktime.h>
13 #include <linux/sched.h>
14 
15 #include <drm/drm_mm.h>
16 
17 #include "gt/intel_engine.h"
18 #include "gt/uc/intel_uc_fw.h"
19 
20 #include "intel_device_info.h"
21 
22 #include "i915_gem.h"
23 #include "i915_gem_gtt.h"
24 #include "i915_params.h"
25 #include "i915_scheduler.h"
26 
27 struct drm_i915_private;
28 struct intel_overlay_error_state;
29 struct intel_display_error_state;
30 
31 struct i915_gpu_state {
32 	struct kref ref;
33 	ktime_t time;
34 	ktime_t boottime;
35 	ktime_t uptime;
36 	unsigned long capture;
37 	unsigned long epoch;
38 
39 	struct drm_i915_private *i915;
40 
41 	char error_msg[128];
42 	bool simulated;
43 	bool awake;
44 	bool wakelock;
45 	bool suspended;
46 	int iommu;
47 	u32 reset_count;
48 	u32 suspend_count;
49 	struct intel_device_info device_info;
50 	struct intel_runtime_info runtime_info;
51 	struct intel_driver_caps driver_caps;
52 	struct i915_params params;
53 
54 	struct i915_error_uc {
55 		struct intel_uc_fw guc_fw;
56 		struct intel_uc_fw huc_fw;
57 		struct drm_i915_error_object *guc_log;
58 	} uc;
59 
60 	/* Generic register state */
61 	u32 eir;
62 	u32 pgtbl_er;
63 	u32 ier;
64 	u32 gtier[6], ngtier;
65 	u32 ccid;
66 	u32 derrmr;
67 	u32 forcewake;
68 	u32 error; /* gen6+ */
69 	u32 err_int; /* gen7 */
70 	u32 fault_data0; /* gen8, gen9 */
71 	u32 fault_data1; /* gen8, gen9 */
72 	u32 done_reg;
73 	u32 gac_eco;
74 	u32 gam_ecochk;
75 	u32 gab_ctl;
76 	u32 gfx_mode;
77 	u32 gtt_cache;
78 
79 	u32 nfence;
80 	u64 fence[I915_MAX_NUM_FENCES];
81 	struct intel_overlay_error_state *overlay;
82 	struct intel_display_error_state *display;
83 
84 	struct drm_i915_error_engine {
85 		const struct intel_engine_cs *engine;
86 
87 		/* Software tracked state */
88 		bool idle;
89 		unsigned long hangcheck_timestamp;
90 		int num_requests;
91 		u32 reset_count;
92 
93 		/* position of active request inside the ring */
94 		u32 rq_head, rq_post, rq_tail;
95 
96 		/* our own tracking of ring head and tail */
97 		u32 cpu_ring_head;
98 		u32 cpu_ring_tail;
99 
100 		/* Register state */
101 		u32 start;
102 		u32 tail;
103 		u32 head;
104 		u32 ctl;
105 		u32 mode;
106 		u32 hws;
107 		u32 ipeir;
108 		u32 ipehr;
109 		u32 bbstate;
110 		u32 instpm;
111 		u32 instps;
112 		u64 bbaddr;
113 		u64 acthd;
114 		u32 fault_reg;
115 		u64 faddr;
116 		u32 rc_psmi; /* sleep state */
117 		struct intel_instdone instdone;
118 
119 		struct drm_i915_error_context {
120 			char comm[TASK_COMM_LEN];
121 			pid_t pid;
122 			int active;
123 			int guilty;
124 			struct i915_sched_attr sched_attr;
125 		} context;
126 
127 		struct drm_i915_error_object {
128 			u64 gtt_offset;
129 			u64 gtt_size;
130 			u32 gtt_page_sizes;
131 			int num_pages;
132 			int page_count;
133 			int unused;
134 			u32 *pages[0];
135 		} *ringbuffer, *batchbuffer, *wa_batchbuffer, *ctx, *hws_page;
136 
137 		struct drm_i915_error_object **user_bo;
138 		long user_bo_count;
139 
140 		struct drm_i915_error_object *wa_ctx;
141 		struct drm_i915_error_object *default_state;
142 
143 		struct drm_i915_error_request {
144 			unsigned long flags;
145 			long jiffies;
146 			pid_t pid;
147 			u32 context;
148 			u32 seqno;
149 			u32 start;
150 			u32 head;
151 			u32 tail;
152 			struct i915_sched_attr sched_attr;
153 		} *requests, execlist[EXECLIST_MAX_PORTS];
154 		unsigned int num_ports;
155 
156 		struct {
157 			u32 gfx_mode;
158 			union {
159 				u64 pdp[4];
160 				u32 pp_dir_base;
161 			};
162 		} vm_info;
163 
164 		struct drm_i915_error_engine *next;
165 	} *engine;
166 
167 	struct scatterlist *sgl, *fit;
168 };
169 
170 struct i915_gpu_error {
171 	/* For reset and error_state handling. */
172 	spinlock_t lock;
173 	/* Protected by the above dev->gpu_error.lock. */
174 	struct i915_gpu_state *first_error;
175 
176 	atomic_t pending_fb_pin;
177 
178 	/** Number of times the device has been reset (global) */
179 	atomic_t reset_count;
180 
181 	/** Number of times an engine has been reset */
182 	atomic_t reset_engine_count[I915_NUM_ENGINES];
183 };
184 
185 struct drm_i915_error_state_buf {
186 	struct drm_i915_private *i915;
187 	struct scatterlist *sgl, *cur, *end;
188 
189 	char *buf;
190 	size_t bytes;
191 	size_t size;
192 	loff_t iter;
193 
194 	int err;
195 };
196 
197 #if IS_ENABLED(CONFIG_DRM_I915_CAPTURE_ERROR)
198 
199 __printf(2, 3)
200 void i915_error_printf(struct drm_i915_error_state_buf *e, const char *f, ...);
201 
202 struct i915_gpu_state *i915_capture_gpu_state(struct drm_i915_private *i915);
203 void i915_capture_error_state(struct drm_i915_private *dev_priv,
204 			      intel_engine_mask_t engine_mask,
205 			      const char *error_msg);
206 
207 static inline struct i915_gpu_state *
208 i915_gpu_state_get(struct i915_gpu_state *gpu)
209 {
210 	kref_get(&gpu->ref);
211 	return gpu;
212 }
213 
214 ssize_t i915_gpu_state_copy_to_buffer(struct i915_gpu_state *error,
215 				      char *buf, loff_t offset, size_t count);
216 
217 void __i915_gpu_state_free(struct kref *kref);
218 static inline void i915_gpu_state_put(struct i915_gpu_state *gpu)
219 {
220 	if (gpu)
221 		kref_put(&gpu->ref, __i915_gpu_state_free);
222 }
223 
224 struct i915_gpu_state *i915_first_error_state(struct drm_i915_private *i915);
225 void i915_reset_error_state(struct drm_i915_private *i915);
226 void i915_disable_error_state(struct drm_i915_private *i915, int err);
227 
228 #else
229 
230 static inline void i915_capture_error_state(struct drm_i915_private *dev_priv,
231 					    u32 engine_mask,
232 					    const char *error_msg)
233 {
234 }
235 
236 static inline struct i915_gpu_state *
237 i915_first_error_state(struct drm_i915_private *i915)
238 {
239 	return ERR_PTR(-ENODEV);
240 }
241 
242 static inline void i915_reset_error_state(struct drm_i915_private *i915)
243 {
244 }
245 
246 static inline void i915_disable_error_state(struct drm_i915_private *i915,
247 					    int err)
248 {
249 }
250 
251 #endif /* IS_ENABLED(CONFIG_DRM_I915_CAPTURE_ERROR) */
252 
253 #endif /* _I915_GPU_ERROR_H_ */
254