1 // SPDX-License-Identifier: MIT
3 * Copyright © 2021 Intel Corporation
8 #include "intel_atomic.h"
10 #include "intel_display_types.h"
11 #include "intel_drrs.h"
12 #include "intel_frontbuffer.h"
13 #include "intel_panel.h"
16 * DOC: Display Refresh Rate Switching (DRRS)
18 * Display Refresh Rate Switching (DRRS) is a power conservation feature
19 * which enables swtching between low and high refresh rates,
20 * dynamically, based on the usage scenario. This feature is applicable
21 * for internal panels.
23 * Indication that the panel supports DRRS is given by the panel EDID, which
24 * would list multiple refresh rates for one resolution.
26 * DRRS is of 2 types - static and seamless.
27 * Static DRRS involves changing refresh rate (RR) by doing a full modeset
28 * (may appear as a blink on screen) and is used in dock-undock scenario.
29 * Seamless DRRS involves changing RR without any visual effect to the user
30 * and can be used during normal system usage. This is done by programming
33 * Support for static/seamless DRRS may be indicated in the VBT based on
34 * inputs from the panel spec.
36 * DRRS saves power by switching to low RR based on usage scenarios.
38 * The implementation is based on frontbuffer tracking implementation. When
39 * there is a disturbance on the screen triggered by user activity or a periodic
40 * system activity, DRRS is disabled (RR is changed to high RR). When there is
41 * no movement on screen, after a timeout of 1 second, a switch to low RR is
44 * For integration with frontbuffer tracking code, intel_drrs_invalidate()
45 * and intel_drrs_flush() are called.
47 * DRRS can be further extended to support other internal panels and also
48 * the scenario of video playback wherein RR is set based on the rate
49 * requested by userspace.
52 const char *intel_drrs_type_str(enum drrs_type drrs_type
)
54 static const char * const str
[] = {
55 [DRRS_TYPE_NONE
] = "none",
56 [DRRS_TYPE_STATIC
] = "static",
57 [DRRS_TYPE_SEAMLESS
] = "seamless",
60 if (drrs_type
>= ARRAY_SIZE(str
))
63 return str
[drrs_type
];
67 intel_drrs_set_refresh_rate_pipeconf(struct intel_crtc
*crtc
,
68 enum drrs_refresh_rate refresh_rate
)
70 struct drm_i915_private
*dev_priv
= to_i915(crtc
->base
.dev
);
71 enum transcoder cpu_transcoder
= crtc
->drrs
.cpu_transcoder
;
74 if (IS_VALLEYVIEW(dev_priv
) || IS_CHERRYVIEW(dev_priv
))
75 bit
= TRANSCONF_REFRESH_RATE_ALT_VLV
;
77 bit
= TRANSCONF_REFRESH_RATE_ALT_ILK
;
79 intel_de_rmw(dev_priv
, TRANSCONF(cpu_transcoder
),
80 bit
, refresh_rate
== DRRS_REFRESH_RATE_LOW
? bit
: 0);
84 intel_drrs_set_refresh_rate_m_n(struct intel_crtc
*crtc
,
85 enum drrs_refresh_rate refresh_rate
)
87 intel_cpu_transcoder_set_m1_n1(crtc
, crtc
->drrs
.cpu_transcoder
,
88 refresh_rate
== DRRS_REFRESH_RATE_LOW
?
89 &crtc
->drrs
.m2_n2
: &crtc
->drrs
.m_n
);
92 bool intel_drrs_is_active(struct intel_crtc
*crtc
)
94 return crtc
->drrs
.cpu_transcoder
!= INVALID_TRANSCODER
;
97 static void intel_drrs_set_state(struct intel_crtc
*crtc
,
98 enum drrs_refresh_rate refresh_rate
)
100 struct drm_i915_private
*dev_priv
= to_i915(crtc
->base
.dev
);
102 if (refresh_rate
== crtc
->drrs
.refresh_rate
)
105 if (intel_cpu_transcoder_has_m2_n2(dev_priv
, crtc
->drrs
.cpu_transcoder
))
106 intel_drrs_set_refresh_rate_pipeconf(crtc
, refresh_rate
);
108 intel_drrs_set_refresh_rate_m_n(crtc
, refresh_rate
);
110 crtc
->drrs
.refresh_rate
= refresh_rate
;
113 static void intel_drrs_schedule_work(struct intel_crtc
*crtc
)
115 struct drm_i915_private
*i915
= to_i915(crtc
->base
.dev
);
117 mod_delayed_work(i915
->unordered_wq
, &crtc
->drrs
.work
, msecs_to_jiffies(1000));
120 static unsigned int intel_drrs_frontbuffer_bits(const struct intel_crtc_state
*crtc_state
)
122 struct intel_crtc
*crtc
= to_intel_crtc(crtc_state
->uapi
.crtc
);
123 struct drm_i915_private
*i915
= to_i915(crtc
->base
.dev
);
124 unsigned int frontbuffer_bits
;
126 frontbuffer_bits
= INTEL_FRONTBUFFER_ALL_MASK(crtc
->pipe
);
128 for_each_intel_crtc_in_pipe_mask(&i915
->drm
, crtc
,
129 crtc_state
->bigjoiner_pipes
)
130 frontbuffer_bits
|= INTEL_FRONTBUFFER_ALL_MASK(crtc
->pipe
);
132 return frontbuffer_bits
;
136 * intel_drrs_activate - activate DRRS
137 * @crtc_state: the crtc state
139 * Activates DRRS on the crtc.
141 void intel_drrs_activate(const struct intel_crtc_state
*crtc_state
)
143 struct intel_crtc
*crtc
= to_intel_crtc(crtc_state
->uapi
.crtc
);
145 if (!crtc_state
->has_drrs
)
148 if (!crtc_state
->hw
.active
)
151 if (intel_crtc_is_bigjoiner_slave(crtc_state
))
154 mutex_lock(&crtc
->drrs
.mutex
);
156 crtc
->drrs
.cpu_transcoder
= crtc_state
->cpu_transcoder
;
157 crtc
->drrs
.m_n
= crtc_state
->dp_m_n
;
158 crtc
->drrs
.m2_n2
= crtc_state
->dp_m2_n2
;
159 crtc
->drrs
.frontbuffer_bits
= intel_drrs_frontbuffer_bits(crtc_state
);
160 crtc
->drrs
.busy_frontbuffer_bits
= 0;
162 intel_drrs_schedule_work(crtc
);
164 mutex_unlock(&crtc
->drrs
.mutex
);
168 * intel_drrs_deactivate - deactivate DRRS
169 * @old_crtc_state: the old crtc state
171 * Deactivates DRRS on the crtc.
173 void intel_drrs_deactivate(const struct intel_crtc_state
*old_crtc_state
)
175 struct intel_crtc
*crtc
= to_intel_crtc(old_crtc_state
->uapi
.crtc
);
177 if (!old_crtc_state
->has_drrs
)
180 if (!old_crtc_state
->hw
.active
)
183 if (intel_crtc_is_bigjoiner_slave(old_crtc_state
))
186 mutex_lock(&crtc
->drrs
.mutex
);
188 if (intel_drrs_is_active(crtc
))
189 intel_drrs_set_state(crtc
, DRRS_REFRESH_RATE_HIGH
);
191 crtc
->drrs
.cpu_transcoder
= INVALID_TRANSCODER
;
192 crtc
->drrs
.frontbuffer_bits
= 0;
193 crtc
->drrs
.busy_frontbuffer_bits
= 0;
195 mutex_unlock(&crtc
->drrs
.mutex
);
197 cancel_delayed_work_sync(&crtc
->drrs
.work
);
200 static void intel_drrs_downclock_work(struct work_struct
*work
)
202 struct intel_crtc
*crtc
= container_of(work
, typeof(*crtc
), drrs
.work
.work
);
204 mutex_lock(&crtc
->drrs
.mutex
);
206 if (intel_drrs_is_active(crtc
) && !crtc
->drrs
.busy_frontbuffer_bits
)
207 intel_drrs_set_state(crtc
, DRRS_REFRESH_RATE_LOW
);
209 mutex_unlock(&crtc
->drrs
.mutex
);
212 static void intel_drrs_frontbuffer_update(struct drm_i915_private
*dev_priv
,
213 unsigned int all_frontbuffer_bits
,
216 struct intel_crtc
*crtc
;
218 for_each_intel_crtc(&dev_priv
->drm
, crtc
) {
219 unsigned int frontbuffer_bits
;
221 mutex_lock(&crtc
->drrs
.mutex
);
223 frontbuffer_bits
= all_frontbuffer_bits
& crtc
->drrs
.frontbuffer_bits
;
224 if (!frontbuffer_bits
) {
225 mutex_unlock(&crtc
->drrs
.mutex
);
230 crtc
->drrs
.busy_frontbuffer_bits
|= frontbuffer_bits
;
232 crtc
->drrs
.busy_frontbuffer_bits
&= ~frontbuffer_bits
;
234 /* flush/invalidate means busy screen hence upclock */
235 intel_drrs_set_state(crtc
, DRRS_REFRESH_RATE_HIGH
);
238 * flush also means no more activity hence schedule downclock, if all
239 * other fbs are quiescent too
241 if (!crtc
->drrs
.busy_frontbuffer_bits
)
242 intel_drrs_schedule_work(crtc
);
244 cancel_delayed_work(&crtc
->drrs
.work
);
246 mutex_unlock(&crtc
->drrs
.mutex
);
251 * intel_drrs_invalidate - Disable Idleness DRRS
252 * @dev_priv: i915 device
253 * @frontbuffer_bits: frontbuffer plane tracking bits
255 * This function gets called everytime rendering on the given planes start.
256 * Hence DRRS needs to be Upclocked, i.e. (LOW_RR -> HIGH_RR).
258 * Dirty frontbuffers relevant to DRRS are tracked in busy_frontbuffer_bits.
260 void intel_drrs_invalidate(struct drm_i915_private
*dev_priv
,
261 unsigned int frontbuffer_bits
)
263 intel_drrs_frontbuffer_update(dev_priv
, frontbuffer_bits
, true);
267 * intel_drrs_flush - Restart Idleness DRRS
268 * @dev_priv: i915 device
269 * @frontbuffer_bits: frontbuffer plane tracking bits
271 * This function gets called every time rendering on the given planes has
272 * completed or flip on a crtc is completed. So DRRS should be upclocked
273 * (LOW_RR -> HIGH_RR). And also Idleness detection should be started again,
274 * if no other planes are dirty.
276 * Dirty frontbuffers relevant to DRRS are tracked in busy_frontbuffer_bits.
278 void intel_drrs_flush(struct drm_i915_private
*dev_priv
,
279 unsigned int frontbuffer_bits
)
281 intel_drrs_frontbuffer_update(dev_priv
, frontbuffer_bits
, false);
285 * intel_drrs_crtc_init - Init DRRS for CRTC
288 * This function is called only once at driver load to initialize basic
292 void intel_drrs_crtc_init(struct intel_crtc
*crtc
)
294 INIT_DELAYED_WORK(&crtc
->drrs
.work
, intel_drrs_downclock_work
);
295 mutex_init(&crtc
->drrs
.mutex
);
296 crtc
->drrs
.cpu_transcoder
= INVALID_TRANSCODER
;
299 static int intel_drrs_debugfs_status_show(struct seq_file
*m
, void *unused
)
301 struct intel_crtc
*crtc
= m
->private;
302 struct drm_i915_private
*i915
= to_i915(crtc
->base
.dev
);
303 const struct intel_crtc_state
*crtc_state
;
306 ret
= drm_modeset_lock_single_interruptible(&crtc
->base
.mutex
);
310 crtc_state
= to_intel_crtc_state(crtc
->base
.state
);
312 mutex_lock(&crtc
->drrs
.mutex
);
314 seq_printf(m
, "DRRS capable: %s\n",
315 str_yes_no(crtc_state
->has_drrs
||
316 HAS_DOUBLE_BUFFERED_M_N(i915
) ||
317 intel_cpu_transcoder_has_m2_n2(i915
, crtc_state
->cpu_transcoder
)));
319 seq_printf(m
, "DRRS enabled: %s\n",
320 str_yes_no(crtc_state
->has_drrs
));
322 seq_printf(m
, "DRRS active: %s\n",
323 str_yes_no(intel_drrs_is_active(crtc
)));
325 seq_printf(m
, "DRRS refresh rate: %s\n",
326 crtc
->drrs
.refresh_rate
== DRRS_REFRESH_RATE_LOW
?
329 seq_printf(m
, "DRRS busy frontbuffer bits: 0x%x\n",
330 crtc
->drrs
.busy_frontbuffer_bits
);
332 mutex_unlock(&crtc
->drrs
.mutex
);
334 drm_modeset_unlock(&crtc
->base
.mutex
);
339 DEFINE_SHOW_ATTRIBUTE(intel_drrs_debugfs_status
);
341 static int intel_drrs_debugfs_ctl_set(void *data
, u64 val
)
343 struct intel_crtc
*crtc
= data
;
344 struct drm_i915_private
*i915
= to_i915(crtc
->base
.dev
);
345 struct intel_crtc_state
*crtc_state
;
346 struct drm_crtc_commit
*commit
;
349 ret
= drm_modeset_lock_single_interruptible(&crtc
->base
.mutex
);
353 crtc_state
= to_intel_crtc_state(crtc
->base
.state
);
355 if (!crtc_state
->hw
.active
||
356 !crtc_state
->has_drrs
)
359 commit
= crtc_state
->uapi
.commit
;
361 ret
= wait_for_completion_interruptible(&commit
->hw_done
);
367 "Manually %sactivating DRRS\n", val
? "" : "de");
370 intel_drrs_activate(crtc_state
);
372 intel_drrs_deactivate(crtc_state
);
375 drm_modeset_unlock(&crtc
->base
.mutex
);
380 DEFINE_DEBUGFS_ATTRIBUTE(intel_drrs_debugfs_ctl_fops
,
381 NULL
, intel_drrs_debugfs_ctl_set
, "%llu\n");
383 void intel_drrs_crtc_debugfs_add(struct intel_crtc
*crtc
)
385 debugfs_create_file("i915_drrs_status", 0444, crtc
->base
.debugfs_entry
,
386 crtc
, &intel_drrs_debugfs_status_fops
);
388 debugfs_create_file_unsafe("i915_drrs_ctl", 0644, crtc
->base
.debugfs_entry
,
389 crtc
, &intel_drrs_debugfs_ctl_fops
);
392 static int intel_drrs_debugfs_type_show(struct seq_file
*m
, void *unused
)
394 struct intel_connector
*connector
= m
->private;
396 seq_printf(m
, "DRRS type: %s\n",
397 intel_drrs_type_str(intel_panel_drrs_type(connector
)));
402 DEFINE_SHOW_ATTRIBUTE(intel_drrs_debugfs_type
);
404 void intel_drrs_connector_debugfs_add(struct intel_connector
*connector
)
406 if (intel_panel_drrs_type(connector
) == DRRS_TYPE_NONE
)
409 debugfs_create_file("i915_drrs_type", 0444, connector
->base
.debugfs_entry
,
410 connector
, &intel_drrs_debugfs_type_fops
);