Linux Audio

Check our new training course

Linux BSP development engineering services

Need help to port Linux and bootloaders to your hardware?
Loading...
v5.14.15
  1// SPDX-License-Identifier: MIT
  2/*
  3 * Copyright © 2019 Intel Corporation
  4 *
  5 */
  6
 
 
  7#include "i915_drv.h"
 
  8#include "intel_de.h"
  9#include "intel_display_types.h"
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 10
 11#define DSB_BUF_SIZE    (2 * PAGE_SIZE)
 12
 13/**
 14 * DOC: DSB
 15 *
 16 * A DSB (Display State Buffer) is a queue of MMIO instructions in the memory
 17 * which can be offloaded to DSB HW in Display Controller. DSB HW is a DMA
 18 * engine that can be programmed to download the DSB from memory.
 19 * It allows driver to batch submit display HW programming. This helps to
 20 * reduce loading time and CPU activity, thereby making the context switch
 21 * faster. DSB Support added from Gen12 Intel graphics based platform.
 22 *
 23 * DSB's can access only the pipe, plane, and transcoder Data Island Packet
 24 * registers.
 25 *
 26 * DSB HW can support only register writes (both indexed and direct MMIO
 27 * writes). There are no registers reads possible with DSB HW engine.
 28 */
 29
 30/* DSB opcodes. */
 31#define DSB_OPCODE_SHIFT		24
 32#define DSB_OPCODE_MMIO_WRITE		0x1
 33#define DSB_OPCODE_INDEXED_WRITE	0x9
 34#define DSB_BYTE_EN			0xF
 35#define DSB_BYTE_EN_SHIFT		20
 36#define DSB_REG_VALUE_MASK		0xfffff
 37
 38static bool is_dsb_busy(struct drm_i915_private *i915, enum pipe pipe,
 39			enum dsb_id id)
 40{
 41	return DSB_STATUS & intel_de_read(i915, DSB_CTRL(pipe, id));
 42}
 43
 44static bool intel_dsb_enable_engine(struct drm_i915_private *i915,
 45				    enum pipe pipe, enum dsb_id id)
 46{
 47	u32 dsb_ctrl;
 48
 49	dsb_ctrl = intel_de_read(i915, DSB_CTRL(pipe, id));
 50	if (DSB_STATUS & dsb_ctrl) {
 51		drm_dbg_kms(&i915->drm, "DSB engine is busy.\n");
 52		return false;
 53	}
 54
 55	dsb_ctrl |= DSB_ENABLE;
 56	intel_de_write(i915, DSB_CTRL(pipe, id), dsb_ctrl);
 57
 58	intel_de_posting_read(i915, DSB_CTRL(pipe, id));
 59	return true;
 60}
 61
 62static bool intel_dsb_disable_engine(struct drm_i915_private *i915,
 63				     enum pipe pipe, enum dsb_id id)
 64{
 65	u32 dsb_ctrl;
 66
 67	dsb_ctrl = intel_de_read(i915, DSB_CTRL(pipe, id));
 68	if (DSB_STATUS & dsb_ctrl) {
 69		drm_dbg_kms(&i915->drm, "DSB engine is busy.\n");
 70		return false;
 71	}
 72
 73	dsb_ctrl &= ~DSB_ENABLE;
 74	intel_de_write(i915, DSB_CTRL(pipe, id), dsb_ctrl);
 75
 76	intel_de_posting_read(i915, DSB_CTRL(pipe, id));
 77	return true;
 78}
 79
 80/**
 81 * intel_dsb_indexed_reg_write() -Write to the DSB context for auto
 82 * increment register.
 83 * @crtc_state: intel_crtc_state structure
 84 * @reg: register address.
 85 * @val: value.
 86 *
 87 * This function is used for writing register-value pair in command
 88 * buffer of DSB for auto-increment register. During command buffer overflow,
 89 * a warning is thrown and rest all erroneous condition register programming
 90 * is done through mmio write.
 91 */
 92
 93void intel_dsb_indexed_reg_write(const struct intel_crtc_state *crtc_state,
 94				 i915_reg_t reg, u32 val)
 95{
 96	struct intel_dsb *dsb = crtc_state->dsb;
 97	struct intel_crtc *crtc = to_intel_crtc(crtc_state->uapi.crtc);
 98	struct drm_i915_private *dev_priv = to_i915(crtc->base.dev);
 99	u32 *buf;
100	u32 reg_val;
101
102	if (!dsb) {
103		intel_de_write(dev_priv, reg, val);
104		return;
105	}
106	buf = dsb->cmd_buf;
107	if (drm_WARN_ON(&dev_priv->drm, dsb->free_pos >= DSB_BUF_SIZE)) {
108		drm_dbg_kms(&dev_priv->drm, "DSB buffer overflow\n");
109		return;
110	}
111
112	/*
113	 * For example the buffer will look like below for 3 dwords for auto
114	 * increment register:
115	 * +--------------------------------------------------------+
116	 * | size = 3 | offset &| value1 | value2 | value3 | zero   |
117	 * |          | opcode  |        |        |        |        |
118	 * +--------------------------------------------------------+
119	 * +          +         +        +        +        +        +
120	 * 0          4         8        12       16       20       24
121	 * Byte
122	 *
123	 * As every instruction is 8 byte aligned the index of dsb instruction
124	 * will start always from even number while dealing with u32 array. If
125	 * we are writing odd no of dwords, Zeros will be added in the end for
126	 * padding.
127	 */
128	reg_val = buf[dsb->ins_start_offset + 1] & DSB_REG_VALUE_MASK;
129	if (reg_val != i915_mmio_reg_offset(reg)) {
130		/* Every instruction should be 8 byte aligned. */
131		dsb->free_pos = ALIGN(dsb->free_pos, 2);
132
133		dsb->ins_start_offset = dsb->free_pos;
134
135		/* Update the size. */
136		buf[dsb->free_pos++] = 1;
137
138		/* Update the opcode and reg. */
139		buf[dsb->free_pos++] = (DSB_OPCODE_INDEXED_WRITE  <<
140					DSB_OPCODE_SHIFT) |
141					i915_mmio_reg_offset(reg);
142
143		/* Update the value. */
144		buf[dsb->free_pos++] = val;
145	} else {
146		/* Update the new value. */
147		buf[dsb->free_pos++] = val;
148
149		/* Update the size. */
150		buf[dsb->ins_start_offset]++;
151	}
152
153	/* if number of data words is odd, then the last dword should be 0.*/
154	if (dsb->free_pos & 0x1)
155		buf[dsb->free_pos] = 0;
156}
157
158/**
159 * intel_dsb_reg_write() -Write to the DSB context for normal
160 * register.
161 * @crtc_state: intel_crtc_state structure
162 * @reg: register address.
163 * @val: value.
164 *
165 * This function is used for writing register-value pair in command
166 * buffer of DSB. During command buffer overflow, a warning  is thrown
167 * and rest all erroneous condition register programming is done
168 * through mmio write.
169 */
170void intel_dsb_reg_write(const struct intel_crtc_state *crtc_state,
171			 i915_reg_t reg, u32 val)
172{
173	struct intel_crtc *crtc = to_intel_crtc(crtc_state->uapi.crtc);
174	struct drm_i915_private *dev_priv = to_i915(crtc->base.dev);
175	struct intel_dsb *dsb;
176	u32 *buf;
177
178	dsb = crtc_state->dsb;
179	if (!dsb) {
180		intel_de_write(dev_priv, reg, val);
181		return;
182	}
183
184	buf = dsb->cmd_buf;
185	if (drm_WARN_ON(&dev_priv->drm, dsb->free_pos >= DSB_BUF_SIZE)) {
186		drm_dbg_kms(&dev_priv->drm, "DSB buffer overflow\n");
187		return;
188	}
189
190	dsb->ins_start_offset = dsb->free_pos;
191	buf[dsb->free_pos++] = val;
192	buf[dsb->free_pos++] = (DSB_OPCODE_MMIO_WRITE  << DSB_OPCODE_SHIFT) |
193			       (DSB_BYTE_EN << DSB_BYTE_EN_SHIFT) |
194			       i915_mmio_reg_offset(reg);
195}
196
197/**
198 * intel_dsb_commit() - Trigger workload execution of DSB.
199 * @crtc_state: intel_crtc_state structure
200 *
201 * This function is used to do actual write to hardware using DSB.
202 * On errors, fall back to MMIO. Also this function help to reset the context.
203 */
204void intel_dsb_commit(const struct intel_crtc_state *crtc_state)
205{
206	struct intel_dsb *dsb = crtc_state->dsb;
207	struct intel_crtc *crtc = to_intel_crtc(crtc_state->uapi.crtc);
208	struct drm_device *dev = crtc->base.dev;
209	struct drm_i915_private *dev_priv = to_i915(dev);
210	enum pipe pipe = crtc->pipe;
211	u32 tail;
212
213	if (!(dsb && dsb->free_pos))
214		return;
215
216	if (!intel_dsb_enable_engine(dev_priv, pipe, dsb->id))
217		goto reset;
218
219	if (is_dsb_busy(dev_priv, pipe, dsb->id)) {
220		drm_err(&dev_priv->drm,
221			"HEAD_PTR write failed - dsb engine is busy.\n");
222		goto reset;
223	}
224	intel_de_write(dev_priv, DSB_HEAD(pipe, dsb->id),
225		       i915_ggtt_offset(dsb->vma));
226
227	tail = ALIGN(dsb->free_pos * 4, CACHELINE_BYTES);
228	if (tail > dsb->free_pos * 4)
229		memset(&dsb->cmd_buf[dsb->free_pos], 0,
230		       (tail - dsb->free_pos * 4));
231
232	if (is_dsb_busy(dev_priv, pipe, dsb->id)) {
233		drm_err(&dev_priv->drm,
234			"TAIL_PTR write failed - dsb engine is busy.\n");
235		goto reset;
236	}
237	drm_dbg_kms(&dev_priv->drm,
238		    "DSB execution started - head 0x%x, tail 0x%x\n",
239		    i915_ggtt_offset(dsb->vma), tail);
240	intel_de_write(dev_priv, DSB_TAIL(pipe, dsb->id),
241		       i915_ggtt_offset(dsb->vma) + tail);
242	if (wait_for(!is_dsb_busy(dev_priv, pipe, dsb->id), 1)) {
243		drm_err(&dev_priv->drm,
244			"Timed out waiting for DSB workload completion.\n");
245		goto reset;
246	}
247
248reset:
249	dsb->free_pos = 0;
250	dsb->ins_start_offset = 0;
251	intel_dsb_disable_engine(dev_priv, pipe, dsb->id);
252}
253
254/**
255 * intel_dsb_prepare() - Allocate, pin and map the DSB command buffer.
256 * @crtc_state: intel_crtc_state structure to prepare associated dsb instance.
257 *
258 * This function prepare the command buffer which is used to store dsb
259 * instructions with data.
260 */
261void intel_dsb_prepare(struct intel_crtc_state *crtc_state)
262{
263	struct intel_crtc *crtc = to_intel_crtc(crtc_state->uapi.crtc);
264	struct drm_i915_private *i915 = to_i915(crtc->base.dev);
265	struct intel_dsb *dsb;
266	struct drm_i915_gem_object *obj;
267	struct i915_vma *vma;
268	u32 *buf;
269	intel_wakeref_t wakeref;
270
271	if (!HAS_DSB(i915))
272		return;
273
274	dsb = kmalloc(sizeof(*dsb), GFP_KERNEL);
275	if (!dsb) {
276		drm_err(&i915->drm, "DSB object creation failed\n");
277		return;
278	}
279
280	wakeref = intel_runtime_pm_get(&i915->runtime_pm);
281
282	obj = i915_gem_object_create_internal(i915, DSB_BUF_SIZE);
283	if (IS_ERR(obj)) {
284		drm_err(&i915->drm, "Gem object creation failed\n");
285		kfree(dsb);
286		goto out;
287	}
288
289	vma = i915_gem_object_ggtt_pin(obj, NULL, 0, 0, 0);
290	if (IS_ERR(vma)) {
291		drm_err(&i915->drm, "Vma creation failed\n");
292		i915_gem_object_put(obj);
293		kfree(dsb);
294		goto out;
295	}
296
297	buf = i915_gem_object_pin_map_unlocked(vma->obj, I915_MAP_WC);
298	if (IS_ERR(buf)) {
299		drm_err(&i915->drm, "Command buffer creation failed\n");
300		i915_vma_unpin_and_release(&vma, I915_VMA_RELEASE_MAP);
301		kfree(dsb);
302		goto out;
303	}
304
305	dsb->id = DSB1;
306	dsb->vma = vma;
307	dsb->cmd_buf = buf;
308	dsb->free_pos = 0;
309	dsb->ins_start_offset = 0;
310	crtc_state->dsb = dsb;
311out:
 
 
 
 
312	intel_runtime_pm_put(&i915->runtime_pm, wakeref);
313}
314
315/**
316 * intel_dsb_cleanup() - To cleanup DSB context.
317 * @crtc_state: intel_crtc_state structure to cleanup associated dsb instance.
318 *
319 * This function cleanup the DSB context by unpinning and releasing
320 * the VMA object associated with it.
321 */
322void intel_dsb_cleanup(struct intel_crtc_state *crtc_state)
323{
324	if (!crtc_state->dsb)
325		return;
326
327	i915_vma_unpin_and_release(&crtc_state->dsb->vma, I915_VMA_RELEASE_MAP);
328	kfree(crtc_state->dsb);
329	crtc_state->dsb = NULL;
330}
v6.2
  1// SPDX-License-Identifier: MIT
  2/*
  3 * Copyright © 2019 Intel Corporation
  4 *
  5 */
  6
  7#include "gem/i915_gem_internal.h"
  8
  9#include "i915_drv.h"
 10#include "i915_reg.h"
 11#include "intel_de.h"
 12#include "intel_display_types.h"
 13#include "intel_dsb.h"
 14
 15struct i915_vma;
 16
 17enum dsb_id {
 18	INVALID_DSB = -1,
 19	DSB1,
 20	DSB2,
 21	DSB3,
 22	MAX_DSB_PER_PIPE
 23};
 24
 25struct intel_dsb {
 26	enum dsb_id id;
 27	u32 *cmd_buf;
 28	struct i915_vma *vma;
 29
 30	/*
 31	 * free_pos will point the first free entry position
 32	 * and help in calculating tail of command buffer.
 33	 */
 34	int free_pos;
 35
 36	/*
 37	 * ins_start_offset will help to store start address of the dsb
 38	 * instuction and help in identifying the batch of auto-increment
 39	 * register.
 40	 */
 41	u32 ins_start_offset;
 42};
 43
 44#define DSB_BUF_SIZE    (2 * PAGE_SIZE)
 45
 46/**
 47 * DOC: DSB
 48 *
 49 * A DSB (Display State Buffer) is a queue of MMIO instructions in the memory
 50 * which can be offloaded to DSB HW in Display Controller. DSB HW is a DMA
 51 * engine that can be programmed to download the DSB from memory.
 52 * It allows driver to batch submit display HW programming. This helps to
 53 * reduce loading time and CPU activity, thereby making the context switch
 54 * faster. DSB Support added from Gen12 Intel graphics based platform.
 55 *
 56 * DSB's can access only the pipe, plane, and transcoder Data Island Packet
 57 * registers.
 58 *
 59 * DSB HW can support only register writes (both indexed and direct MMIO
 60 * writes). There are no registers reads possible with DSB HW engine.
 61 */
 62
 63/* DSB opcodes. */
 64#define DSB_OPCODE_SHIFT		24
 65#define DSB_OPCODE_MMIO_WRITE		0x1
 66#define DSB_OPCODE_INDEXED_WRITE	0x9
 67#define DSB_BYTE_EN			0xF
 68#define DSB_BYTE_EN_SHIFT		20
 69#define DSB_REG_VALUE_MASK		0xfffff
 70
 71static bool is_dsb_busy(struct drm_i915_private *i915, enum pipe pipe,
 72			enum dsb_id id)
 73{
 74	return DSB_STATUS & intel_de_read(i915, DSB_CTRL(pipe, id));
 75}
 76
 77static bool intel_dsb_enable_engine(struct drm_i915_private *i915,
 78				    enum pipe pipe, enum dsb_id id)
 79{
 80	u32 dsb_ctrl;
 81
 82	dsb_ctrl = intel_de_read(i915, DSB_CTRL(pipe, id));
 83	if (DSB_STATUS & dsb_ctrl) {
 84		drm_dbg_kms(&i915->drm, "DSB engine is busy.\n");
 85		return false;
 86	}
 87
 88	dsb_ctrl |= DSB_ENABLE;
 89	intel_de_write(i915, DSB_CTRL(pipe, id), dsb_ctrl);
 90
 91	intel_de_posting_read(i915, DSB_CTRL(pipe, id));
 92	return true;
 93}
 94
 95static bool intel_dsb_disable_engine(struct drm_i915_private *i915,
 96				     enum pipe pipe, enum dsb_id id)
 97{
 98	u32 dsb_ctrl;
 99
100	dsb_ctrl = intel_de_read(i915, DSB_CTRL(pipe, id));
101	if (DSB_STATUS & dsb_ctrl) {
102		drm_dbg_kms(&i915->drm, "DSB engine is busy.\n");
103		return false;
104	}
105
106	dsb_ctrl &= ~DSB_ENABLE;
107	intel_de_write(i915, DSB_CTRL(pipe, id), dsb_ctrl);
108
109	intel_de_posting_read(i915, DSB_CTRL(pipe, id));
110	return true;
111}
112
113/**
114 * intel_dsb_indexed_reg_write() -Write to the DSB context for auto
115 * increment register.
116 * @crtc_state: intel_crtc_state structure
117 * @reg: register address.
118 * @val: value.
119 *
120 * This function is used for writing register-value pair in command
121 * buffer of DSB for auto-increment register. During command buffer overflow,
122 * a warning is thrown and rest all erroneous condition register programming
123 * is done through mmio write.
124 */
125
126void intel_dsb_indexed_reg_write(const struct intel_crtc_state *crtc_state,
127				 i915_reg_t reg, u32 val)
128{
129	struct intel_dsb *dsb = crtc_state->dsb;
130	struct intel_crtc *crtc = to_intel_crtc(crtc_state->uapi.crtc);
131	struct drm_i915_private *dev_priv = to_i915(crtc->base.dev);
132	u32 *buf;
133	u32 reg_val;
134
135	if (!dsb) {
136		intel_de_write_fw(dev_priv, reg, val);
137		return;
138	}
139	buf = dsb->cmd_buf;
140	if (drm_WARN_ON(&dev_priv->drm, dsb->free_pos >= DSB_BUF_SIZE)) {
141		drm_dbg_kms(&dev_priv->drm, "DSB buffer overflow\n");
142		return;
143	}
144
145	/*
146	 * For example the buffer will look like below for 3 dwords for auto
147	 * increment register:
148	 * +--------------------------------------------------------+
149	 * | size = 3 | offset &| value1 | value2 | value3 | zero   |
150	 * |          | opcode  |        |        |        |        |
151	 * +--------------------------------------------------------+
152	 * +          +         +        +        +        +        +
153	 * 0          4         8        12       16       20       24
154	 * Byte
155	 *
156	 * As every instruction is 8 byte aligned the index of dsb instruction
157	 * will start always from even number while dealing with u32 array. If
158	 * we are writing odd no of dwords, Zeros will be added in the end for
159	 * padding.
160	 */
161	reg_val = buf[dsb->ins_start_offset + 1] & DSB_REG_VALUE_MASK;
162	if (reg_val != i915_mmio_reg_offset(reg)) {
163		/* Every instruction should be 8 byte aligned. */
164		dsb->free_pos = ALIGN(dsb->free_pos, 2);
165
166		dsb->ins_start_offset = dsb->free_pos;
167
168		/* Update the size. */
169		buf[dsb->free_pos++] = 1;
170
171		/* Update the opcode and reg. */
172		buf[dsb->free_pos++] = (DSB_OPCODE_INDEXED_WRITE  <<
173					DSB_OPCODE_SHIFT) |
174					i915_mmio_reg_offset(reg);
175
176		/* Update the value. */
177		buf[dsb->free_pos++] = val;
178	} else {
179		/* Update the new value. */
180		buf[dsb->free_pos++] = val;
181
182		/* Update the size. */
183		buf[dsb->ins_start_offset]++;
184	}
185
186	/* if number of data words is odd, then the last dword should be 0.*/
187	if (dsb->free_pos & 0x1)
188		buf[dsb->free_pos] = 0;
189}
190
191/**
192 * intel_dsb_reg_write() -Write to the DSB context for normal
193 * register.
194 * @crtc_state: intel_crtc_state structure
195 * @reg: register address.
196 * @val: value.
197 *
198 * This function is used for writing register-value pair in command
199 * buffer of DSB. During command buffer overflow, a warning  is thrown
200 * and rest all erroneous condition register programming is done
201 * through mmio write.
202 */
203void intel_dsb_reg_write(const struct intel_crtc_state *crtc_state,
204			 i915_reg_t reg, u32 val)
205{
206	struct intel_crtc *crtc = to_intel_crtc(crtc_state->uapi.crtc);
207	struct drm_i915_private *dev_priv = to_i915(crtc->base.dev);
208	struct intel_dsb *dsb;
209	u32 *buf;
210
211	dsb = crtc_state->dsb;
212	if (!dsb) {
213		intel_de_write_fw(dev_priv, reg, val);
214		return;
215	}
216
217	buf = dsb->cmd_buf;
218	if (drm_WARN_ON(&dev_priv->drm, dsb->free_pos >= DSB_BUF_SIZE)) {
219		drm_dbg_kms(&dev_priv->drm, "DSB buffer overflow\n");
220		return;
221	}
222
223	dsb->ins_start_offset = dsb->free_pos;
224	buf[dsb->free_pos++] = val;
225	buf[dsb->free_pos++] = (DSB_OPCODE_MMIO_WRITE  << DSB_OPCODE_SHIFT) |
226			       (DSB_BYTE_EN << DSB_BYTE_EN_SHIFT) |
227			       i915_mmio_reg_offset(reg);
228}
229
230/**
231 * intel_dsb_commit() - Trigger workload execution of DSB.
232 * @crtc_state: intel_crtc_state structure
233 *
234 * This function is used to do actual write to hardware using DSB.
235 * On errors, fall back to MMIO. Also this function help to reset the context.
236 */
237void intel_dsb_commit(const struct intel_crtc_state *crtc_state)
238{
239	struct intel_dsb *dsb = crtc_state->dsb;
240	struct intel_crtc *crtc = to_intel_crtc(crtc_state->uapi.crtc);
241	struct drm_device *dev = crtc->base.dev;
242	struct drm_i915_private *dev_priv = to_i915(dev);
243	enum pipe pipe = crtc->pipe;
244	u32 tail;
245
246	if (!(dsb && dsb->free_pos))
247		return;
248
249	if (!intel_dsb_enable_engine(dev_priv, pipe, dsb->id))
250		goto reset;
251
252	if (is_dsb_busy(dev_priv, pipe, dsb->id)) {
253		drm_err(&dev_priv->drm,
254			"HEAD_PTR write failed - dsb engine is busy.\n");
255		goto reset;
256	}
257	intel_de_write(dev_priv, DSB_HEAD(pipe, dsb->id),
258		       i915_ggtt_offset(dsb->vma));
259
260	tail = ALIGN(dsb->free_pos * 4, CACHELINE_BYTES);
261	if (tail > dsb->free_pos * 4)
262		memset(&dsb->cmd_buf[dsb->free_pos], 0,
263		       (tail - dsb->free_pos * 4));
264
265	if (is_dsb_busy(dev_priv, pipe, dsb->id)) {
266		drm_err(&dev_priv->drm,
267			"TAIL_PTR write failed - dsb engine is busy.\n");
268		goto reset;
269	}
270	drm_dbg_kms(&dev_priv->drm,
271		    "DSB execution started - head 0x%x, tail 0x%x\n",
272		    i915_ggtt_offset(dsb->vma), tail);
273	intel_de_write(dev_priv, DSB_TAIL(pipe, dsb->id),
274		       i915_ggtt_offset(dsb->vma) + tail);
275	if (wait_for(!is_dsb_busy(dev_priv, pipe, dsb->id), 1)) {
276		drm_err(&dev_priv->drm,
277			"Timed out waiting for DSB workload completion.\n");
278		goto reset;
279	}
280
281reset:
282	dsb->free_pos = 0;
283	dsb->ins_start_offset = 0;
284	intel_dsb_disable_engine(dev_priv, pipe, dsb->id);
285}
286
287/**
288 * intel_dsb_prepare() - Allocate, pin and map the DSB command buffer.
289 * @crtc_state: intel_crtc_state structure to prepare associated dsb instance.
290 *
291 * This function prepare the command buffer which is used to store dsb
292 * instructions with data.
293 */
294void intel_dsb_prepare(struct intel_crtc_state *crtc_state)
295{
296	struct intel_crtc *crtc = to_intel_crtc(crtc_state->uapi.crtc);
297	struct drm_i915_private *i915 = to_i915(crtc->base.dev);
298	struct intel_dsb *dsb;
299	struct drm_i915_gem_object *obj;
300	struct i915_vma *vma;
301	u32 *buf;
302	intel_wakeref_t wakeref;
303
304	if (!HAS_DSB(i915))
305		return;
306
307	dsb = kmalloc(sizeof(*dsb), GFP_KERNEL);
308	if (!dsb) {
309		drm_err(&i915->drm, "DSB object creation failed\n");
310		return;
311	}
312
313	wakeref = intel_runtime_pm_get(&i915->runtime_pm);
314
315	obj = i915_gem_object_create_internal(i915, DSB_BUF_SIZE);
316	if (IS_ERR(obj)) {
 
317		kfree(dsb);
318		goto out;
319	}
320
321	vma = i915_gem_object_ggtt_pin(obj, NULL, 0, 0, 0);
322	if (IS_ERR(vma)) {
 
323		i915_gem_object_put(obj);
324		kfree(dsb);
325		goto out;
326	}
327
328	buf = i915_gem_object_pin_map_unlocked(vma->obj, I915_MAP_WC);
329	if (IS_ERR(buf)) {
 
330		i915_vma_unpin_and_release(&vma, I915_VMA_RELEASE_MAP);
331		kfree(dsb);
332		goto out;
333	}
334
335	dsb->id = DSB1;
336	dsb->vma = vma;
337	dsb->cmd_buf = buf;
338	dsb->free_pos = 0;
339	dsb->ins_start_offset = 0;
340	crtc_state->dsb = dsb;
341out:
342	if (!crtc_state->dsb)
343		drm_info(&i915->drm,
344			 "DSB queue setup failed, will fallback to MMIO for display HW programming\n");
345
346	intel_runtime_pm_put(&i915->runtime_pm, wakeref);
347}
348
349/**
350 * intel_dsb_cleanup() - To cleanup DSB context.
351 * @crtc_state: intel_crtc_state structure to cleanup associated dsb instance.
352 *
353 * This function cleanup the DSB context by unpinning and releasing
354 * the VMA object associated with it.
355 */
356void intel_dsb_cleanup(struct intel_crtc_state *crtc_state)
357{
358	if (!crtc_state->dsb)
359		return;
360
361	i915_vma_unpin_and_release(&crtc_state->dsb->vma, I915_VMA_RELEASE_MAP);
362	kfree(crtc_state->dsb);
363	crtc_state->dsb = NULL;
364}