]> git.proxmox.com Git - mirror_ubuntu-artful-kernel.git/blame - drivers/gpu/drm/drm_irq.c
drm/nv50-: trigger update after all connectors disabled
[mirror_ubuntu-artful-kernel.git] / drivers / gpu / drm / drm_irq.c
CommitLineData
f5752b38
DV
1/*
2 * drm_irq.c IRQ and vblank support
1da177e4
LT
3 *
4 * \author Rickard E. (Rik) Faith <faith@valinux.com>
5 * \author Gareth Hughes <gareth@valinux.com>
6 */
7
8/*
9 * Created: Fri Mar 19 14:30:16 1999 by faith@valinux.com
10 *
11 * Copyright 1999, 2000 Precision Insight, Inc., Cedar Park, Texas.
12 * Copyright 2000 VA Linux Systems, Inc., Sunnyvale, California.
13 * All Rights Reserved.
14 *
15 * Permission is hereby granted, free of charge, to any person obtaining a
16 * copy of this software and associated documentation files (the "Software"),
17 * to deal in the Software without restriction, including without limitation
18 * the rights to use, copy, modify, merge, publish, distribute, sublicense,
19 * and/or sell copies of the Software, and to permit persons to whom the
20 * Software is furnished to do so, subject to the following conditions:
21 *
22 * The above copyright notice and this permission notice (including the next
23 * paragraph) shall be included in all copies or substantial portions of the
24 * Software.
25 *
26 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
27 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
28 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
29 * VA LINUX SYSTEMS AND/OR ITS SUPPLIERS BE LIABLE FOR ANY CLAIM, DAMAGES OR
30 * OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
31 * ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
32 * OTHER DEALINGS IN THE SOFTWARE.
33 */
34
760285e7 35#include <drm/drmP.h>
ac2874b9 36#include "drm_trace.h"
1da177e4
LT
37
38#include <linux/interrupt.h> /* For task queue support */
5a0e3ad6 39#include <linux/slab.h>
1da177e4 40
28d52043 41#include <linux/vgaarb.h>
2d1a8a48 42#include <linux/export.h>
27641c3f
MK
43
44/* Access macro for slots in vblank timestamp ringbuffer. */
5380e929
VS
45#define vblanktimestamp(dev, crtc, count) \
46 ((dev)->vblank[crtc].time[(count) % DRM_VBLANKTIME_RBSIZE])
27641c3f
MK
47
48/* Retry timestamp calculation up to 3 times to satisfy
49 * drm_timestamp_precision before giving up.
50 */
51#define DRM_TIMESTAMP_MAXRETRIES 3
52
53/* Threshold in nanoseconds for detection of redundant
54 * vblank irq in drm_handle_vblank(). 1 msec should be ok.
55 */
56#define DRM_REDUNDANT_VBLIRQ_THRESH_NS 1000000
57
27641c3f
MK
58/*
59 * Clear vblank timestamp buffer for a crtc.
60 */
61static void clear_vblank_timestamps(struct drm_device *dev, int crtc)
62{
5380e929 63 memset(dev->vblank[crtc].time, 0, sizeof(dev->vblank[crtc].time));
27641c3f
MK
64}
65
66/*
67 * Disable vblank irq's on crtc, make sure that last vblank count
68 * of hardware and corresponding consistent software vblank counter
69 * are preserved, even if there are any spurious vblank irq's after
70 * disable.
71 */
72static void vblank_disable_and_save(struct drm_device *dev, int crtc)
73{
74 unsigned long irqflags;
75 u32 vblcount;
76 s64 diff_ns;
77 int vblrc;
78 struct timeval tvblank;
0355cf3a 79 int count = DRM_TIMESTAMP_MAXRETRIES;
27641c3f
MK
80
81 /* Prevent vblank irq processing while disabling vblank irqs,
82 * so no updates of timestamps or count can happen after we've
83 * disabled. Needed to prevent races in case of delayed irq's.
27641c3f 84 */
27641c3f
MK
85 spin_lock_irqsave(&dev->vblank_time_lock, irqflags);
86
87 dev->driver->disable_vblank(dev, crtc);
5380e929 88 dev->vblank[crtc].enabled = false;
27641c3f
MK
89
90 /* No further vblank irq's will be processed after
91 * this point. Get current hardware vblank count and
92 * vblank timestamp, repeat until they are consistent.
93 *
94 * FIXME: There is still a race condition here and in
95 * drm_update_vblank_count() which can cause off-by-one
96 * reinitialization of software vblank counter. If gpu
97 * vblank counter doesn't increment exactly at the leading
98 * edge of a vblank interval, then we can lose 1 count if
99 * we happen to execute between start of vblank and the
100 * delayed gpu counter increment.
101 */
102 do {
5380e929 103 dev->vblank[crtc].last = dev->driver->get_vblank_counter(dev, crtc);
27641c3f 104 vblrc = drm_get_last_vbltimestamp(dev, crtc, &tvblank, 0);
5380e929 105 } while (dev->vblank[crtc].last != dev->driver->get_vblank_counter(dev, crtc) && (--count) && vblrc);
0355cf3a
EE
106
107 if (!count)
108 vblrc = 0;
27641c3f
MK
109
110 /* Compute time difference to stored timestamp of last vblank
111 * as updated by last invocation of drm_handle_vblank() in vblank irq.
112 */
5380e929 113 vblcount = atomic_read(&dev->vblank[crtc].count);
27641c3f
MK
114 diff_ns = timeval_to_ns(&tvblank) -
115 timeval_to_ns(&vblanktimestamp(dev, crtc, vblcount));
116
117 /* If there is at least 1 msec difference between the last stored
118 * timestamp and tvblank, then we are currently executing our
119 * disable inside a new vblank interval, the tvblank timestamp
120 * corresponds to this new vblank interval and the irq handler
121 * for this vblank didn't run yet and won't run due to our disable.
122 * Therefore we need to do the job of drm_handle_vblank() and
123 * increment the vblank counter by one to account for this vblank.
124 *
125 * Skip this step if there isn't any high precision timestamp
126 * available. In that case we can't account for this and just
127 * hope for the best.
128 */
bc215128 129 if ((vblrc > 0) && (abs64(diff_ns) > 1000000)) {
5380e929 130 atomic_inc(&dev->vblank[crtc].count);
bc215128
MK
131 smp_mb__after_atomic_inc();
132 }
27641c3f
MK
133
134 /* Invalidate all timestamps while vblank irq's are off. */
135 clear_vblank_timestamps(dev, crtc);
136
137 spin_unlock_irqrestore(&dev->vblank_time_lock, irqflags);
27641c3f
MK
138}
139
0a3e67a4
JB
140static void vblank_disable_fn(unsigned long arg)
141{
e69595c2
VS
142 struct drm_vblank_crtc *vblank = (void *)arg;
143 struct drm_device *dev = vblank->dev;
0a3e67a4 144 unsigned long irqflags;
e69595c2 145 int crtc = vblank->crtc;
0a3e67a4
JB
146
147 if (!dev->vblank_disable_allowed)
148 return;
149
e69595c2
VS
150 spin_lock_irqsave(&dev->vbl_lock, irqflags);
151 if (atomic_read(&vblank->refcount) == 0 && vblank->enabled) {
152 DRM_DEBUG("disabling vblank on crtc %d\n", crtc);
153 vblank_disable_and_save(dev, crtc);
0a3e67a4 154 }
e69595c2 155 spin_unlock_irqrestore(&dev->vbl_lock, irqflags);
0a3e67a4
JB
156}
157
f5752b38
DV
158/**
159 * drm_vblank_cleanup - cleanup vblank support
160 * @dev: DRM device
161 *
162 * This function cleans up any resources allocated in drm_vblank_init.
163 */
52440211 164void drm_vblank_cleanup(struct drm_device *dev)
0a3e67a4 165{
e69595c2
VS
166 int crtc;
167
0a3e67a4
JB
168 /* Bail if the driver didn't call drm_vblank_init() */
169 if (dev->num_crtcs == 0)
170 return;
171
e69595c2
VS
172 for (crtc = 0; crtc < dev->num_crtcs; crtc++) {
173 del_timer_sync(&dev->vblank[crtc].disable_timer);
174 vblank_disable_fn((unsigned long)&dev->vblank[crtc]);
175 }
0a3e67a4 176
5380e929 177 kfree(dev->vblank);
0a3e67a4
JB
178
179 dev->num_crtcs = 0;
180}
e77cef9c 181EXPORT_SYMBOL(drm_vblank_cleanup);
0a3e67a4 182
f5752b38
DV
183/**
184 * drm_vblank_init - initialize vblank support
185 * @dev: drm_device
186 * @num_crtcs: number of crtcs supported by @dev
187 *
188 * This function initializes vblank support for @num_crtcs display pipelines.
189 *
190 * Returns:
191 * Zero on success or a negative error code on failure.
192 */
0a3e67a4
JB
193int drm_vblank_init(struct drm_device *dev, int num_crtcs)
194{
195 int i, ret = -ENOMEM;
196
0a3e67a4 197 spin_lock_init(&dev->vbl_lock);
27641c3f
MK
198 spin_lock_init(&dev->vblank_time_lock);
199
0a3e67a4
JB
200 dev->num_crtcs = num_crtcs;
201
5380e929
VS
202 dev->vblank = kcalloc(num_crtcs, sizeof(*dev->vblank), GFP_KERNEL);
203 if (!dev->vblank)
0a3e67a4
JB
204 goto err;
205
e69595c2
VS
206 for (i = 0; i < num_crtcs; i++) {
207 dev->vblank[i].dev = dev;
208 dev->vblank[i].crtc = i;
5380e929 209 init_waitqueue_head(&dev->vblank[i].queue);
e69595c2
VS
210 setup_timer(&dev->vblank[i].disable_timer, vblank_disable_fn,
211 (unsigned long)&dev->vblank[i]);
212 }
27641c3f 213
8f6fce03 214 DRM_INFO("Supports vblank timestamp caching Rev 2 (21.10.2013).\n");
27641c3f
MK
215
216 /* Driver specific high-precision vblank timestamping supported? */
217 if (dev->driver->get_vblank_timestamp)
218 DRM_INFO("Driver supports precise vblank timestamp query.\n");
219 else
220 DRM_INFO("No driver support for vblank timestamp query.\n");
221
ba0bf120
VS
222 dev->vblank_disable_allowed = false;
223
0a3e67a4
JB
224 return 0;
225
226err:
227 drm_vblank_cleanup(dev);
228 return ret;
229}
230EXPORT_SYMBOL(drm_vblank_init);
231
28d52043
DA
232static void drm_irq_vgaarb_nokms(void *cookie, bool state)
233{
234 struct drm_device *dev = cookie;
235
236 if (dev->driver->vgaarb_irq) {
237 dev->driver->vgaarb_irq(dev, state);
238 return;
239 }
240
241 if (!dev->irq_enabled)
242 return;
243
5037f8ac
JS
244 if (state) {
245 if (dev->driver->irq_uninstall)
246 dev->driver->irq_uninstall(dev);
247 } else {
248 if (dev->driver->irq_preinstall)
249 dev->driver->irq_preinstall(dev);
250 if (dev->driver->irq_postinstall)
251 dev->driver->irq_postinstall(dev);
28d52043
DA
252 }
253}
254
1da177e4 255/**
f5752b38
DV
256 * drm_irq_install - install IRQ handler
257 * @dev: DRM device
258 * @irq: IRQ number to install the handler for
1da177e4 259 *
0a3e67a4 260 * Initializes the IRQ related data. Installs the handler, calling the driver
f5752b38
DV
261 * irq_preinstall() and irq_postinstall() functions before and after the
262 * installation.
263 *
264 * This is the simplified helper interface provided for drivers with no special
265 * needs. Drivers which need to install interrupt handlers for multiple
266 * interrupts must instead set drm_device->irq_enabled to signal the DRM core
267 * that vblank interrupts are available.
268 *
269 * Returns:
270 * Zero on success or a negative error code on failure.
1da177e4 271 */
bb0f1b5c 272int drm_irq_install(struct drm_device *dev, int irq)
1da177e4 273{
bb0f1b5c 274 int ret;
b5e89ed5 275 unsigned long sh_flags = 0;
1da177e4
LT
276
277 if (!drm_core_check_feature(dev, DRIVER_HAVE_IRQ))
278 return -EINVAL;
279
7c1a38e3 280 if (irq == 0)
1da177e4
LT
281 return -EINVAL;
282
1da177e4 283 /* Driver must have been initialized */
e090c53b 284 if (!dev->dev_private)
1da177e4 285 return -EINVAL;
1da177e4 286
e090c53b 287 if (dev->irq_enabled)
1da177e4 288 return -EBUSY;
4423843c 289 dev->irq_enabled = true;
1da177e4 290
7c1a38e3 291 DRM_DEBUG("irq=%d\n", irq);
1da177e4 292
b5e89ed5 293 /* Before installing handler */
5037f8ac
JS
294 if (dev->driver->irq_preinstall)
295 dev->driver->irq_preinstall(dev);
1da177e4 296
b5e89ed5 297 /* Install handler */
1da177e4 298 if (drm_core_check_feature(dev, DRIVER_IRQ_SHARED))
935f6e3a 299 sh_flags = IRQF_SHARED;
b5e89ed5 300
7c1a38e3 301 ret = request_irq(irq, dev->driver->irq_handler,
5829d183 302 sh_flags, dev->driver->name, dev);
9bfbd5cb 303
b5e89ed5 304 if (ret < 0) {
4423843c 305 dev->irq_enabled = false;
1da177e4
LT
306 return ret;
307 }
308
28d52043
DA
309 if (!drm_core_check_feature(dev, DRIVER_MODESET))
310 vga_client_register(dev->pdev, (void *)dev, drm_irq_vgaarb_nokms, NULL);
311
b5e89ed5 312 /* After installing handler */
5037f8ac
JS
313 if (dev->driver->irq_postinstall)
314 ret = dev->driver->irq_postinstall(dev);
315
0a3e67a4 316 if (ret < 0) {
4423843c 317 dev->irq_enabled = false;
e1c44acc
JS
318 if (!drm_core_check_feature(dev, DRIVER_MODESET))
319 vga_client_register(dev->pdev, NULL, NULL, NULL);
7c1a38e3
DV
320 free_irq(irq, dev);
321 } else {
322 dev->irq = irq;
0a3e67a4 323 }
1da177e4 324
0a3e67a4 325 return ret;
1da177e4 326}
0a3e67a4 327EXPORT_SYMBOL(drm_irq_install);
1da177e4
LT
328
329/**
f5752b38
DV
330 * drm_irq_uninstall - uninstall the IRQ handler
331 * @dev: DRM device
332 *
333 * Calls the driver's irq_uninstall() function and unregisters the IRQ handler.
334 * This should only be called by drivers which used drm_irq_install() to set up
335 * their interrupt handler. Other drivers must only reset
336 * drm_device->irq_enabled to false.
1da177e4 337 *
f5752b38
DV
338 * Note that for kernel modesetting drivers it is a bug if this function fails.
339 * The sanity checks are only to catch buggy user modesetting drivers which call
340 * the same function through an ioctl.
1da177e4 341 *
f5752b38
DV
342 * Returns:
343 * Zero on success or a negative error code on failure.
1da177e4 344 */
27641c3f 345int drm_irq_uninstall(struct drm_device *dev)
1da177e4 346{
dc1336ff 347 unsigned long irqflags;
4423843c
VS
348 bool irq_enabled;
349 int i;
1da177e4
LT
350
351 if (!drm_core_check_feature(dev, DRIVER_HAVE_IRQ))
352 return -EINVAL;
353
1da177e4 354 irq_enabled = dev->irq_enabled;
4423843c 355 dev->irq_enabled = false;
1da177e4 356
dc1336ff
JB
357 /*
358 * Wake up any waiters so they don't hang.
359 */
bde4889a
BS
360 if (dev->num_crtcs) {
361 spin_lock_irqsave(&dev->vbl_lock, irqflags);
362 for (i = 0; i < dev->num_crtcs; i++) {
57ed0f7b 363 wake_up(&dev->vblank[i].queue);
5380e929
VS
364 dev->vblank[i].enabled = false;
365 dev->vblank[i].last =
bde4889a
BS
366 dev->driver->get_vblank_counter(dev, i);
367 }
368 spin_unlock_irqrestore(&dev->vbl_lock, irqflags);
dc1336ff 369 }
dc1336ff 370
b5e89ed5 371 if (!irq_enabled)
1da177e4
LT
372 return -EINVAL;
373
7c1a38e3 374 DRM_DEBUG("irq=%d\n", dev->irq);
1da177e4 375
28d52043
DA
376 if (!drm_core_check_feature(dev, DRIVER_MODESET))
377 vga_client_register(dev->pdev, NULL, NULL, NULL);
378
5037f8ac
JS
379 if (dev->driver->irq_uninstall)
380 dev->driver->irq_uninstall(dev);
1da177e4 381
7c1a38e3 382 free_irq(dev->irq, dev);
1da177e4
LT
383
384 return 0;
385}
386EXPORT_SYMBOL(drm_irq_uninstall);
387
f5752b38 388/*
1da177e4
LT
389 * IRQ control ioctl.
390 *
391 * \param inode device inode.
6c340eac 392 * \param file_priv DRM file private.
1da177e4
LT
393 * \param cmd command.
394 * \param arg user argument, pointing to a drm_control structure.
395 * \return zero on success or a negative number on failure.
396 *
397 * Calls irq_install() or irq_uninstall() according to \p arg.
398 */
c153f45f
EA
399int drm_control(struct drm_device *dev, void *data,
400 struct drm_file *file_priv)
1da177e4 401{
c153f45f 402 struct drm_control *ctl = data;
a319c1a4 403 int ret = 0, irq;
b5e89ed5 404
27641c3f
MK
405 /* if we haven't irq we fallback for compatibility reasons -
406 * this used to be a separate function in drm_dma.h
407 */
1da177e4 408
22471cf6
DV
409 if (!drm_core_check_feature(dev, DRIVER_HAVE_IRQ))
410 return 0;
411 if (drm_core_check_feature(dev, DRIVER_MODESET))
412 return 0;
413 /* UMS was only ever support on pci devices. */
414 if (WARN_ON(!dev->pdev))
415 return -EINVAL;
1da177e4 416
c153f45f 417 switch (ctl->func) {
1da177e4 418 case DRM_INST_HANDLER:
a319c1a4
DV
419 irq = dev->pdev->irq;
420
1da177e4 421 if (dev->if_version < DRM_IF_VERSION(1, 2) &&
a319c1a4 422 ctl->irq != irq)
1da177e4 423 return -EINVAL;
e090c53b 424 mutex_lock(&dev->struct_mutex);
bb0f1b5c 425 ret = drm_irq_install(dev, irq);
e090c53b
DV
426 mutex_unlock(&dev->struct_mutex);
427
428 return ret;
1da177e4 429 case DRM_UNINST_HANDLER:
e090c53b
DV
430 mutex_lock(&dev->struct_mutex);
431 ret = drm_irq_uninstall(dev);
432 mutex_unlock(&dev->struct_mutex);
433
434 return ret;
1da177e4
LT
435 default:
436 return -EINVAL;
437 }
438}
439
27641c3f 440/**
f5752b38
DV
441 * drm_calc_timestamping_constants - calculate vblank timestamp constants
442 * @crtc: drm_crtc whose timestamp constants should be updated.
443 * @mode: display mode containing the scanout timings
27641c3f 444 *
21b21560
VS
445 * Calculate and store various constants which are later
446 * needed by vblank and swap-completion timestamping, e.g,
447 * by drm_calc_vbltimestamp_from_scanoutpos(). They are
f5752b38 448 * derived from CRTC's true scanout timing, so they take
21b21560 449 * things like panel scaling or other adjustments into account.
27641c3f 450 */
545cdd55
VS
451void drm_calc_timestamping_constants(struct drm_crtc *crtc,
452 const struct drm_display_mode *mode)
27641c3f 453{
3c184f69 454 int linedur_ns = 0, pixeldur_ns = 0, framedur_ns = 0;
77666b72 455 int dotclock = mode->crtc_clock;
27641c3f
MK
456
457 /* Valid dotclock? */
458 if (dotclock > 0) {
0dae35a3
VS
459 int frame_size = mode->crtc_htotal * mode->crtc_vtotal;
460
461 /*
462 * Convert scanline length in pixels and video
463 * dot clock to line duration, frame duration
464 * and pixel duration in nanoseconds:
27641c3f 465 */
0dae35a3
VS
466 pixeldur_ns = 1000000 / dotclock;
467 linedur_ns = div_u64((u64) mode->crtc_htotal * 1000000, dotclock);
468 framedur_ns = div_u64((u64) frame_size * 1000000, dotclock);
c0ae24c1
VS
469
470 /*
471 * Fields of interlaced scanout modes are only half a frame duration.
472 */
473 if (mode->flags & DRM_MODE_FLAG_INTERLACE)
474 framedur_ns /= 2;
27641c3f
MK
475 } else
476 DRM_ERROR("crtc %d: Can't calculate constants, dotclock = 0!\n",
477 crtc->base.id);
478
479 crtc->pixeldur_ns = pixeldur_ns;
480 crtc->linedur_ns = linedur_ns;
481 crtc->framedur_ns = framedur_ns;
482
483 DRM_DEBUG("crtc %d: hwmode: htotal %d, vtotal %d, vdisplay %d\n",
545cdd55
VS
484 crtc->base.id, mode->crtc_htotal,
485 mode->crtc_vtotal, mode->crtc_vdisplay);
27641c3f 486 DRM_DEBUG("crtc %d: clock %d kHz framedur %d linedur %d, pixeldur %d\n",
3c184f69
VS
487 crtc->base.id, dotclock, framedur_ns,
488 linedur_ns, pixeldur_ns);
27641c3f
MK
489}
490EXPORT_SYMBOL(drm_calc_timestamping_constants);
491
492/**
f5752b38
DV
493 * drm_calc_vbltimestamp_from_scanoutpos - precise vblank timestamp helper
494 * @dev: DRM device
495 * @crtc: Which CRTC's vblank timestamp to retrieve
496 * @max_error: Desired maximum allowable error in timestamps (nanosecs)
497 * On return contains true maximum error of timestamp
498 * @vblank_time: Pointer to struct timeval which should receive the timestamp
499 * @flags: Flags to pass to driver:
500 * 0 = Default,
501 * DRM_CALLED_FROM_VBLIRQ = If function is called from vbl IRQ handler
502 * @refcrtc: CRTC which defines scanout timing
503 * @mode: mode which defines the scanout timings
504 *
505 * Implements calculation of exact vblank timestamps from given drm_display_mode
506 * timings and current video scanout position of a CRTC. This can be called from
507 * within get_vblank_timestamp() implementation of a kms driver to implement the
508 * actual timestamping.
27641c3f
MK
509 *
510 * Should return timestamps conforming to the OML_sync_control OpenML
511 * extension specification. The timestamp corresponds to the end of
512 * the vblank interval, aka start of scanout of topmost-leftmost display
513 * pixel in the following video frame.
514 *
515 * Requires support for optional dev->driver->get_scanout_position()
516 * in kms driver, plus a bit of setup code to provide a drm_display_mode
517 * that corresponds to the true scanout timing.
518 *
519 * The current implementation only handles standard video modes. It
520 * returns as no operation if a doublescan or interlaced video mode is
521 * active. Higher level code is expected to handle this.
522 *
f5752b38
DV
523 * Returns:
524 * Negative value on error, failure or if not supported in current
27641c3f
MK
525 * video mode:
526 *
f5752b38 527 * -EINVAL - Invalid CRTC.
27641c3f
MK
528 * -EAGAIN - Temporary unavailable, e.g., called before initial modeset.
529 * -ENOTSUPP - Function not supported in current display mode.
530 * -EIO - Failed, e.g., due to failed scanout position query.
531 *
532 * Returns or'ed positive status flags on success:
533 *
534 * DRM_VBLANKTIME_SCANOUTPOS_METHOD - Signal this method used for timestamping.
535 * DRM_VBLANKTIME_INVBL - Timestamp taken while scanout was in vblank interval.
536 *
537 */
538int drm_calc_vbltimestamp_from_scanoutpos(struct drm_device *dev, int crtc,
539 int *max_error,
540 struct timeval *vblank_time,
541 unsigned flags,
7da903ef
VS
542 const struct drm_crtc *refcrtc,
543 const struct drm_display_mode *mode)
27641c3f 544{
e62f2f5a
ID
545 ktime_t stime, etime, mono_time_offset;
546 struct timeval tv_etime;
8072bfa6 547 int vbl_status;
27641c3f 548 int vpos, hpos, i;
3c184f69 549 int framedur_ns, linedur_ns, pixeldur_ns, delta_ns, duration_ns;
27641c3f
MK
550 bool invbl;
551
552 if (crtc < 0 || crtc >= dev->num_crtcs) {
553 DRM_ERROR("Invalid crtc %d\n", crtc);
554 return -EINVAL;
555 }
556
557 /* Scanout position query not supported? Should not happen. */
558 if (!dev->driver->get_scanout_position) {
559 DRM_ERROR("Called from driver w/o get_scanout_position()!?\n");
560 return -EIO;
561 }
562
27641c3f
MK
563 /* Durations of frames, lines, pixels in nanoseconds. */
564 framedur_ns = refcrtc->framedur_ns;
565 linedur_ns = refcrtc->linedur_ns;
566 pixeldur_ns = refcrtc->pixeldur_ns;
567
568 /* If mode timing undefined, just return as no-op:
569 * Happens during initial modesetting of a crtc.
570 */
8072bfa6 571 if (framedur_ns == 0) {
27641c3f
MK
572 DRM_DEBUG("crtc %d: Noop due to uninitialized mode.\n", crtc);
573 return -EAGAIN;
574 }
575
27641c3f
MK
576 /* Get current scanout position with system timestamp.
577 * Repeat query up to DRM_TIMESTAMP_MAXRETRIES times
578 * if single query takes longer than max_error nanoseconds.
579 *
580 * This guarantees a tight bound on maximum error if
581 * code gets preempted or delayed for some reason.
582 */
583 for (i = 0; i < DRM_TIMESTAMP_MAXRETRIES; i++) {
8f6fce03
MK
584 /*
585 * Get vertical and horizontal scanout position vpos, hpos,
586 * and bounding timestamps stime, etime, pre/post query.
587 */
abca9e45 588 vbl_status = dev->driver->get_scanout_position(dev, crtc, flags, &vpos,
8f6fce03 589 &hpos, &stime, &etime);
27641c3f 590
8f6fce03
MK
591 /*
592 * Get correction for CLOCK_MONOTONIC -> CLOCK_REALTIME if
593 * CLOCK_REALTIME is requested.
594 */
c61eef72
ID
595 if (!drm_timestamp_monotonic)
596 mono_time_offset = ktime_get_monotonic_offset();
27641c3f 597
27641c3f
MK
598 /* Return as no-op if scanout query unsupported or failed. */
599 if (!(vbl_status & DRM_SCANOUTPOS_VALID)) {
600 DRM_DEBUG("crtc %d : scanoutpos query failed [%d].\n",
601 crtc, vbl_status);
602 return -EIO;
603 }
604
8f6fce03 605 /* Compute uncertainty in timestamp of scanout position query. */
e62f2f5a 606 duration_ns = ktime_to_ns(etime) - ktime_to_ns(stime);
27641c3f
MK
607
608 /* Accept result with < max_error nsecs timing uncertainty. */
3c184f69 609 if (duration_ns <= *max_error)
27641c3f
MK
610 break;
611 }
612
613 /* Noisy system timing? */
614 if (i == DRM_TIMESTAMP_MAXRETRIES) {
615 DRM_DEBUG("crtc %d: Noisy timestamp %d us > %d us [%d reps].\n",
3c184f69 616 crtc, duration_ns/1000, *max_error/1000, i);
27641c3f
MK
617 }
618
619 /* Return upper bound of timestamp precision error. */
3c184f69 620 *max_error = duration_ns;
27641c3f
MK
621
622 /* Check if in vblank area:
623 * vpos is >=0 in video scanout area, but negative
624 * within vblank area, counting down the number of lines until
625 * start of scanout.
626 */
627 invbl = vbl_status & DRM_SCANOUTPOS_INVBL;
628
629 /* Convert scanout position into elapsed time at raw_time query
630 * since start of scanout at first display scanline. delta_ns
631 * can be negative if start of scanout hasn't happened yet.
632 */
3c184f69 633 delta_ns = vpos * linedur_ns + hpos * pixeldur_ns;
27641c3f 634
c61eef72
ID
635 if (!drm_timestamp_monotonic)
636 etime = ktime_sub(etime, mono_time_offset);
637
e62f2f5a
ID
638 /* save this only for debugging purposes */
639 tv_etime = ktime_to_timeval(etime);
27641c3f
MK
640 /* Subtract time delta from raw timestamp to get final
641 * vblank_time timestamp for end of vblank.
642 */
e91abf80
MD
643 if (delta_ns < 0)
644 etime = ktime_add_ns(etime, -delta_ns);
645 else
646 etime = ktime_sub_ns(etime, delta_ns);
e62f2f5a 647 *vblank_time = ktime_to_timeval(etime);
27641c3f 648
bbb0aef5
JP
649 DRM_DEBUG("crtc %d : v %d p(%d,%d)@ %ld.%ld -> %ld.%ld [e %d us, %d rep]\n",
650 crtc, (int)vbl_status, hpos, vpos,
e62f2f5a 651 (long)tv_etime.tv_sec, (long)tv_etime.tv_usec,
bbb0aef5 652 (long)vblank_time->tv_sec, (long)vblank_time->tv_usec,
3c184f69 653 duration_ns/1000, i);
27641c3f
MK
654
655 vbl_status = DRM_VBLANKTIME_SCANOUTPOS_METHOD;
656 if (invbl)
657 vbl_status |= DRM_VBLANKTIME_INVBL;
658
659 return vbl_status;
660}
661EXPORT_SYMBOL(drm_calc_vbltimestamp_from_scanoutpos);
662
c61eef72
ID
663static struct timeval get_drm_timestamp(void)
664{
665 ktime_t now;
666
667 now = ktime_get();
668 if (!drm_timestamp_monotonic)
669 now = ktime_sub(now, ktime_get_monotonic_offset());
670
671 return ktime_to_timeval(now);
672}
673
27641c3f
MK
674/**
675 * drm_get_last_vbltimestamp - retrieve raw timestamp for the most recent
f5752b38 676 * vblank interval
27641c3f 677 * @dev: DRM device
f5752b38 678 * @crtc: which CRTC's vblank timestamp to retrieve
27641c3f
MK
679 * @tvblank: Pointer to target struct timeval which should receive the timestamp
680 * @flags: Flags to pass to driver:
f5752b38
DV
681 * 0 = Default,
682 * DRM_CALLED_FROM_VBLIRQ = If function is called from vbl IRQ handler
27641c3f
MK
683 *
684 * Fetches the system timestamp corresponding to the time of the most recent
f5752b38 685 * vblank interval on specified CRTC. May call into kms-driver to
27641c3f
MK
686 * compute the timestamp with a high-precision GPU specific method.
687 *
688 * Returns zero if timestamp originates from uncorrected do_gettimeofday()
689 * call, i.e., it isn't very precisely locked to the true vblank.
690 *
f5752b38
DV
691 * Returns:
692 * Non-zero if timestamp is considered to be very precise, zero otherwise.
27641c3f
MK
693 */
694u32 drm_get_last_vbltimestamp(struct drm_device *dev, int crtc,
695 struct timeval *tvblank, unsigned flags)
696{
4a1b0714 697 int ret;
27641c3f
MK
698
699 /* Define requested maximum error on timestamps (nanoseconds). */
700 int max_error = (int) drm_timestamp_precision * 1000;
701
702 /* Query driver if possible and precision timestamping enabled. */
703 if (dev->driver->get_vblank_timestamp && (max_error > 0)) {
704 ret = dev->driver->get_vblank_timestamp(dev, crtc, &max_error,
705 tvblank, flags);
706 if (ret > 0)
707 return (u32) ret;
708 }
709
710 /* GPU high precision timestamp query unsupported or failed.
c61eef72 711 * Return current monotonic/gettimeofday timestamp as best estimate.
27641c3f 712 */
c61eef72 713 *tvblank = get_drm_timestamp();
27641c3f
MK
714
715 return 0;
716}
717EXPORT_SYMBOL(drm_get_last_vbltimestamp);
718
0a3e67a4
JB
719/**
720 * drm_vblank_count - retrieve "cooked" vblank counter value
721 * @dev: DRM device
722 * @crtc: which counter to retrieve
723 *
724 * Fetches the "cooked" vblank count value that represents the number of
725 * vblank events since the system was booted, including lost events due to
726 * modesetting activity.
f5752b38
DV
727 *
728 * Returns:
729 * The software vblank counter.
0a3e67a4
JB
730 */
731u32 drm_vblank_count(struct drm_device *dev, int crtc)
732{
5380e929 733 return atomic_read(&dev->vblank[crtc].count);
0a3e67a4
JB
734}
735EXPORT_SYMBOL(drm_vblank_count);
736
27641c3f
MK
737/**
738 * drm_vblank_count_and_time - retrieve "cooked" vblank counter value
739 * and the system timestamp corresponding to that vblank counter value.
740 *
741 * @dev: DRM device
742 * @crtc: which counter to retrieve
743 * @vblanktime: Pointer to struct timeval to receive the vblank timestamp.
744 *
745 * Fetches the "cooked" vblank count value that represents the number of
746 * vblank events since the system was booted, including lost events due to
747 * modesetting activity. Returns corresponding system timestamp of the time
f5752b38 748 * of the vblank interval that corresponds to the current vblank counter value.
27641c3f
MK
749 */
750u32 drm_vblank_count_and_time(struct drm_device *dev, int crtc,
751 struct timeval *vblanktime)
752{
753 u32 cur_vblank;
754
755 /* Read timestamp from slot of _vblank_time ringbuffer
756 * that corresponds to current vblank count. Retry if
757 * count has incremented during readout. This works like
758 * a seqlock.
759 */
760 do {
5380e929 761 cur_vblank = atomic_read(&dev->vblank[crtc].count);
27641c3f
MK
762 *vblanktime = vblanktimestamp(dev, crtc, cur_vblank);
763 smp_rmb();
5380e929 764 } while (cur_vblank != atomic_read(&dev->vblank[crtc].count));
27641c3f
MK
765
766 return cur_vblank;
767}
768EXPORT_SYMBOL(drm_vblank_count_and_time);
769
c6eefa17
RC
770static void send_vblank_event(struct drm_device *dev,
771 struct drm_pending_vblank_event *e,
772 unsigned long seq, struct timeval *now)
773{
774 WARN_ON_SMP(!spin_is_locked(&dev->event_lock));
775 e->event.sequence = seq;
776 e->event.tv_sec = now->tv_sec;
777 e->event.tv_usec = now->tv_usec;
778
779 list_add_tail(&e->base.link,
780 &e->base.file_priv->event_list);
781 wake_up_interruptible(&e->base.file_priv->event_wait);
782 trace_drm_vblank_event_delivered(e->base.pid, e->pipe,
783 e->event.sequence);
784}
785
786/**
787 * drm_send_vblank_event - helper to send vblank event after pageflip
788 * @dev: DRM device
789 * @crtc: CRTC in question
790 * @e: the event to send
791 *
792 * Updates sequence # and timestamp on event, and sends it to userspace.
793 * Caller must hold event lock.
794 */
795void drm_send_vblank_event(struct drm_device *dev, int crtc,
796 struct drm_pending_vblank_event *e)
797{
798 struct timeval now;
799 unsigned int seq;
800 if (crtc >= 0) {
801 seq = drm_vblank_count_and_time(dev, crtc, &now);
802 } else {
803 seq = 0;
c61eef72
ID
804
805 now = get_drm_timestamp();
c6eefa17 806 }
21a245d2 807 e->pipe = crtc;
c6eefa17
RC
808 send_vblank_event(dev, e, seq, &now);
809}
810EXPORT_SYMBOL(drm_send_vblank_event);
811
0a3e67a4
JB
812/**
813 * drm_update_vblank_count - update the master vblank counter
814 * @dev: DRM device
815 * @crtc: counter to update
816 *
817 * Call back into the driver to update the appropriate vblank counter
818 * (specified by @crtc). Deal with wraparound, if it occurred, and
819 * update the last read value so we can deal with wraparound on the next
820 * call if necessary.
821 *
822 * Only necessary when going from off->on, to account for frames we
823 * didn't get an interrupt for.
824 *
825 * Note: caller must hold dev->vbl_lock since this reads & writes
826 * device vblank fields.
827 */
828static void drm_update_vblank_count(struct drm_device *dev, int crtc)
829{
27641c3f
MK
830 u32 cur_vblank, diff, tslot, rc;
831 struct timeval t_vblank;
0a3e67a4
JB
832
833 /*
834 * Interrupts were disabled prior to this call, so deal with counter
835 * wrap if needed.
836 * NOTE! It's possible we lost a full dev->max_vblank_count events
837 * here if the register is small or we had vblank interrupts off for
838 * a long time.
27641c3f
MK
839 *
840 * We repeat the hardware vblank counter & timestamp query until
841 * we get consistent results. This to prevent races between gpu
842 * updating its hardware counter while we are retrieving the
843 * corresponding vblank timestamp.
0a3e67a4 844 */
27641c3f
MK
845 do {
846 cur_vblank = dev->driver->get_vblank_counter(dev, crtc);
847 rc = drm_get_last_vbltimestamp(dev, crtc, &t_vblank, 0);
848 } while (cur_vblank != dev->driver->get_vblank_counter(dev, crtc));
849
850 /* Deal with counter wrap */
5380e929
VS
851 diff = cur_vblank - dev->vblank[crtc].last;
852 if (cur_vblank < dev->vblank[crtc].last) {
0a3e67a4
JB
853 diff += dev->max_vblank_count;
854
855 DRM_DEBUG("last_vblank[%d]=0x%x, cur_vblank=0x%x => diff=0x%x\n",
5380e929 856 crtc, dev->vblank[crtc].last, cur_vblank, diff);
0a3e67a4
JB
857 }
858
859 DRM_DEBUG("enabling vblank interrupts on crtc %d, missed %d\n",
860 crtc, diff);
861
27641c3f
MK
862 /* Reinitialize corresponding vblank timestamp if high-precision query
863 * available. Skip this step if query unsupported or failed. Will
864 * reinitialize delayed at next vblank interrupt in that case.
865 */
866 if (rc) {
5380e929 867 tslot = atomic_read(&dev->vblank[crtc].count) + diff;
27641c3f 868 vblanktimestamp(dev, crtc, tslot) = t_vblank;
27641c3f
MK
869 }
870
bc215128 871 smp_mb__before_atomic_inc();
5380e929 872 atomic_add(diff, &dev->vblank[crtc].count);
bc215128 873 smp_mb__after_atomic_inc();
0a3e67a4
JB
874}
875
f2752282
VS
876/**
877 * drm_vblank_enable - enable the vblank interrupt on a CRTC
878 * @dev: DRM device
879 * @crtc: CRTC in question
880 */
881static int drm_vblank_enable(struct drm_device *dev, int crtc)
882{
883 int ret = 0;
884
885 assert_spin_locked(&dev->vbl_lock);
886
887 spin_lock(&dev->vblank_time_lock);
888
889 if (!dev->vblank[crtc].enabled) {
1cfb80b1
DV
890 /*
891 * Enable vblank irqs under vblank_time_lock protection.
f2752282
VS
892 * All vblank count & timestamp updates are held off
893 * until we are done reinitializing master counter and
894 * timestamps. Filtercode in drm_handle_vblank() will
895 * prevent double-accounting of same vblank interval.
896 */
897 ret = dev->driver->enable_vblank(dev, crtc);
898 DRM_DEBUG("enabling vblank on crtc %d, ret: %d\n", crtc, ret);
899 if (ret)
900 atomic_dec(&dev->vblank[crtc].refcount);
901 else {
902 dev->vblank[crtc].enabled = true;
903 drm_update_vblank_count(dev, crtc);
904 }
905 }
906
907 spin_unlock(&dev->vblank_time_lock);
908
909 return ret;
910}
911
0a3e67a4
JB
912/**
913 * drm_vblank_get - get a reference count on vblank events
914 * @dev: DRM device
915 * @crtc: which CRTC to own
916 *
917 * Acquire a reference count on vblank events to avoid having them disabled
918 * while in use.
919 *
89dd6a4b
DV
920 * This is the legacy version of drm_crtc_vblank_get().
921 *
f5752b38 922 * Returns:
0a3e67a4
JB
923 * Zero on success, nonzero on failure.
924 */
925int drm_vblank_get(struct drm_device *dev, int crtc)
926{
97cbc883 927 unsigned long irqflags;
0a3e67a4
JB
928 int ret = 0;
929
930 spin_lock_irqsave(&dev->vbl_lock, irqflags);
931 /* Going from 0->1 means we have to enable interrupts again */
5380e929 932 if (atomic_add_return(1, &dev->vblank[crtc].refcount) == 1) {
f2752282 933 ret = drm_vblank_enable(dev, crtc);
778c9026 934 } else {
5380e929
VS
935 if (!dev->vblank[crtc].enabled) {
936 atomic_dec(&dev->vblank[crtc].refcount);
778c9026 937 ret = -EINVAL;
0a3e67a4
JB
938 }
939 }
940 spin_unlock_irqrestore(&dev->vbl_lock, irqflags);
941
942 return ret;
943}
944EXPORT_SYMBOL(drm_vblank_get);
945
89dd6a4b
DV
946/**
947 * drm_crtc_vblank_get - get a reference count on vblank events
948 * @crtc: which CRTC to own
949 *
950 * Acquire a reference count on vblank events to avoid having them disabled
951 * while in use.
952 *
953 * This is the native kms version of drm_vblank_off().
954 *
955 * Returns:
956 * Zero on success, nonzero on failure.
957 */
958int drm_crtc_vblank_get(struct drm_crtc *crtc)
959{
960 return drm_vblank_get(crtc->dev, drm_crtc_index(crtc));
961}
962EXPORT_SYMBOL(drm_crtc_vblank_get);
963
0a3e67a4
JB
964/**
965 * drm_vblank_put - give up ownership of vblank events
966 * @dev: DRM device
967 * @crtc: which counter to give up
968 *
969 * Release ownership of a given vblank counter, turning off interrupts
27641c3f 970 * if possible. Disable interrupts after drm_vblank_offdelay milliseconds.
89dd6a4b
DV
971 *
972 * This is the legacy version of drm_crtc_vblank_put().
0a3e67a4
JB
973 */
974void drm_vblank_put(struct drm_device *dev, int crtc)
975{
5380e929 976 BUG_ON(atomic_read(&dev->vblank[crtc].refcount) == 0);
b3f5e732 977
0a3e67a4 978 /* Last user schedules interrupt disable */
5380e929 979 if (atomic_dec_and_test(&dev->vblank[crtc].refcount) &&
27641c3f 980 (drm_vblank_offdelay > 0))
e69595c2 981 mod_timer(&dev->vblank[crtc].disable_timer,
bfd8303a 982 jiffies + ((drm_vblank_offdelay * HZ)/1000));
0a3e67a4
JB
983}
984EXPORT_SYMBOL(drm_vblank_put);
985
89dd6a4b
DV
986/**
987 * drm_crtc_vblank_put - give up ownership of vblank events
988 * @crtc: which counter to give up
989 *
990 * Release ownership of a given vblank counter, turning off interrupts
991 * if possible. Disable interrupts after drm_vblank_offdelay milliseconds.
992 *
993 * This is the native kms version of drm_vblank_put().
994 */
995void drm_crtc_vblank_put(struct drm_crtc *crtc)
996{
997 drm_vblank_put(crtc->dev, drm_crtc_index(crtc));
998}
999EXPORT_SYMBOL(drm_crtc_vblank_put);
1000
c6eefa17
RC
1001/**
1002 * drm_vblank_off - disable vblank events on a CRTC
1003 * @dev: DRM device
1004 * @crtc: CRTC in question
f5752b38
DV
1005 *
1006 * Drivers can use this function to shut down the vblank interrupt handling when
1007 * disabling a crtc. This function ensures that the latest vblank frame count is
1008 * stored so that drm_vblank_on() can restore it again.
1009 *
1010 * Drivers must use this function when the hardware vblank counter can get
1011 * reset, e.g. when suspending.
89dd6a4b
DV
1012 *
1013 * This is the legacy version of drm_crtc_vblank_off().
c6eefa17 1014 */
778c9026
LP
1015void drm_vblank_off(struct drm_device *dev, int crtc)
1016{
498548ec
CJHR
1017 struct drm_pending_vblank_event *e, *t;
1018 struct timeval now;
778c9026 1019 unsigned long irqflags;
498548ec 1020 unsigned int seq;
778c9026
LP
1021
1022 spin_lock_irqsave(&dev->vbl_lock, irqflags);
27641c3f 1023 vblank_disable_and_save(dev, crtc);
57ed0f7b 1024 wake_up(&dev->vblank[crtc].queue);
498548ec
CJHR
1025
1026 /* Send any queued vblank events, lest the natives grow disquiet */
1027 seq = drm_vblank_count_and_time(dev, crtc, &now);
e7783ba3
ID
1028
1029 spin_lock(&dev->event_lock);
498548ec
CJHR
1030 list_for_each_entry_safe(e, t, &dev->vblank_event_list, base.link) {
1031 if (e->pipe != crtc)
1032 continue;
1033 DRM_DEBUG("Sending premature vblank event on disable: \
1034 wanted %d, current %d\n",
1035 e->event.sequence, seq);
c6eefa17 1036 list_del(&e->base.link);
498548ec 1037 drm_vblank_put(dev, e->pipe);
c6eefa17 1038 send_vblank_event(dev, e, seq, &now);
498548ec 1039 }
e7783ba3 1040 spin_unlock(&dev->event_lock);
498548ec 1041
778c9026
LP
1042 spin_unlock_irqrestore(&dev->vbl_lock, irqflags);
1043}
1044EXPORT_SYMBOL(drm_vblank_off);
1045
89dd6a4b
DV
1046/**
1047 * drm_crtc_vblank_off - disable vblank events on a CRTC
1048 * @crtc: CRTC in question
1049 *
1050 * Drivers can use this function to shut down the vblank interrupt handling when
1051 * disabling a crtc. This function ensures that the latest vblank frame count is
1052 * stored so that drm_vblank_on can restore it again.
1053 *
1054 * Drivers must use this function when the hardware vblank counter can get
1055 * reset, e.g. when suspending.
1056 *
1057 * This is the native kms version of drm_vblank_off().
1058 */
1059void drm_crtc_vblank_off(struct drm_crtc *crtc)
1060{
1061 drm_vblank_off(crtc->dev, drm_crtc_index(crtc));
1062}
1063EXPORT_SYMBOL(drm_crtc_vblank_off);
1064
f2752282
VS
1065/**
1066 * drm_vblank_on - enable vblank events on a CRTC
1067 * @dev: DRM device
1068 * @crtc: CRTC in question
f5752b38
DV
1069 *
1070 * This functions restores the vblank interrupt state captured with
1071 * drm_vblank_off() again. Note that calls to drm_vblank_on() and
1072 * drm_vblank_off() can be unbalanced and so can also be unconditionaly called
1073 * in driver load code to reflect the current hardware state of the crtc.
89dd6a4b
DV
1074 *
1075 * This is the legacy version of drm_crtc_vblank_on().
f2752282
VS
1076 */
1077void drm_vblank_on(struct drm_device *dev, int crtc)
1078{
1079 unsigned long irqflags;
1080
1081 spin_lock_irqsave(&dev->vbl_lock, irqflags);
1082 /* re-enable interrupts if there's are users left */
1083 if (atomic_read(&dev->vblank[crtc].refcount) != 0)
1084 WARN_ON(drm_vblank_enable(dev, crtc));
1085 spin_unlock_irqrestore(&dev->vbl_lock, irqflags);
1086}
1087EXPORT_SYMBOL(drm_vblank_on);
1088
89dd6a4b
DV
1089/**
1090 * drm_crtc_vblank_on - enable vblank events on a CRTC
1091 * @crtc: CRTC in question
1092 *
1093 * This functions restores the vblank interrupt state captured with
1094 * drm_vblank_off() again. Note that calls to drm_vblank_on() and
1095 * drm_vblank_off() can be unbalanced and so can also be unconditionaly called
1096 * in driver load code to reflect the current hardware state of the crtc.
1097 *
1098 * This is the native kms version of drm_vblank_on().
1099 */
1100void drm_crtc_vblank_on(struct drm_crtc *crtc)
1101{
1102 drm_vblank_on(crtc->dev, drm_crtc_index(crtc));
1103}
1104EXPORT_SYMBOL(drm_crtc_vblank_on);
1105
f453ba04
DA
1106/**
1107 * drm_vblank_pre_modeset - account for vblanks across mode sets
1108 * @dev: DRM device
1109 * @crtc: CRTC in question
f453ba04
DA
1110 *
1111 * Account for vblank events across mode setting events, which will likely
1112 * reset the hardware frame counter.
f5752b38
DV
1113 *
1114 * This is done by grabbing a temporary vblank reference to ensure that the
1115 * vblank interrupt keeps running across the modeset sequence. With this the
1116 * software-side vblank frame counting will ensure that there are no jumps or
1117 * discontinuities.
1118 *
1119 * Unfortunately this approach is racy and also doesn't work when the vblank
1120 * interrupt stops running, e.g. across system suspend resume. It is therefore
1121 * highly recommended that drivers use the newer drm_vblank_off() and
1122 * drm_vblank_on() instead. drm_vblank_pre_modeset() only works correctly when
1123 * using "cooked" software vblank frame counters and not relying on any hardware
1124 * counters.
1125 *
1126 * Drivers must call drm_vblank_post_modeset() when re-enabling the same crtc
1127 * again.
f453ba04
DA
1128 */
1129void drm_vblank_pre_modeset(struct drm_device *dev, int crtc)
1130{
b7ea85a4 1131 /* vblank is not initialized (IRQ not installed ?), or has been freed */
e77cef9c
JG
1132 if (!dev->num_crtcs)
1133 return;
f453ba04
DA
1134 /*
1135 * To avoid all the problems that might happen if interrupts
1136 * were enabled/disabled around or between these calls, we just
1137 * have the kernel take a reference on the CRTC (just once though
1138 * to avoid corrupting the count if multiple, mismatch calls occur),
1139 * so that interrupts remain enabled in the interim.
1140 */
5380e929
VS
1141 if (!dev->vblank[crtc].inmodeset) {
1142 dev->vblank[crtc].inmodeset = 0x1;
b3f5e732 1143 if (drm_vblank_get(dev, crtc) == 0)
5380e929 1144 dev->vblank[crtc].inmodeset |= 0x2;
f453ba04
DA
1145 }
1146}
1147EXPORT_SYMBOL(drm_vblank_pre_modeset);
1148
f5752b38
DV
1149/**
1150 * drm_vblank_post_modeset - undo drm_vblank_pre_modeset changes
1151 * @dev: DRM device
1152 * @crtc: CRTC in question
1153 *
1154 * This function again drops the temporary vblank reference acquired in
1155 * drm_vblank_pre_modeset.
1156 */
f453ba04
DA
1157void drm_vblank_post_modeset(struct drm_device *dev, int crtc)
1158{
1159 unsigned long irqflags;
1160
b7ea85a4
HC
1161 /* vblank is not initialized (IRQ not installed ?), or has been freed */
1162 if (!dev->num_crtcs)
1163 return;
1164
5380e929 1165 if (dev->vblank[crtc].inmodeset) {
f453ba04 1166 spin_lock_irqsave(&dev->vbl_lock, irqflags);
ba0bf120 1167 dev->vblank_disable_allowed = true;
f453ba04 1168 spin_unlock_irqrestore(&dev->vbl_lock, irqflags);
b3f5e732 1169
5380e929 1170 if (dev->vblank[crtc].inmodeset & 0x2)
b3f5e732
CW
1171 drm_vblank_put(dev, crtc);
1172
5380e929 1173 dev->vblank[crtc].inmodeset = 0;
f453ba04
DA
1174 }
1175}
1176EXPORT_SYMBOL(drm_vblank_post_modeset);
1177
f5752b38 1178/*
0a3e67a4
JB
1179 * drm_modeset_ctl - handle vblank event counter changes across mode switch
1180 * @DRM_IOCTL_ARGS: standard ioctl arguments
1181 *
1182 * Applications should call the %_DRM_PRE_MODESET and %_DRM_POST_MODESET
1183 * ioctls around modesetting so that any lost vblank events are accounted for.
1184 *
1185 * Generally the counter will reset across mode sets. If interrupts are
1186 * enabled around this call, we don't have to do anything since the counter
1187 * will have already been incremented.
1188 */
1189int drm_modeset_ctl(struct drm_device *dev, void *data,
1190 struct drm_file *file_priv)
1191{
1192 struct drm_modeset_ctl *modeset = data;
19227561 1193 unsigned int crtc;
0a3e67a4
JB
1194
1195 /* If drm_vblank_init() hasn't been called yet, just no-op */
1196 if (!dev->num_crtcs)
4a1b0714 1197 return 0;
0a3e67a4 1198
29935554
LP
1199 /* KMS drivers handle this internally */
1200 if (drm_core_check_feature(dev, DRIVER_MODESET))
1201 return 0;
1202
0a3e67a4 1203 crtc = modeset->crtc;
4a1b0714
LP
1204 if (crtc >= dev->num_crtcs)
1205 return -EINVAL;
0a3e67a4 1206
0a3e67a4
JB
1207 switch (modeset->cmd) {
1208 case _DRM_PRE_MODESET:
f453ba04 1209 drm_vblank_pre_modeset(dev, crtc);
0a3e67a4
JB
1210 break;
1211 case _DRM_POST_MODESET:
f453ba04 1212 drm_vblank_post_modeset(dev, crtc);
0a3e67a4
JB
1213 break;
1214 default:
4a1b0714 1215 return -EINVAL;
0a3e67a4
JB
1216 }
1217
4a1b0714 1218 return 0;
0a3e67a4
JB
1219}
1220
c9a9c5e0
KH
1221static int drm_queue_vblank_event(struct drm_device *dev, int pipe,
1222 union drm_wait_vblank *vblwait,
1223 struct drm_file *file_priv)
1224{
1225 struct drm_pending_vblank_event *e;
1226 struct timeval now;
1227 unsigned long flags;
1228 unsigned int seq;
ea5d552c 1229 int ret;
c9a9c5e0
KH
1230
1231 e = kzalloc(sizeof *e, GFP_KERNEL);
ea5d552c
CW
1232 if (e == NULL) {
1233 ret = -ENOMEM;
1234 goto err_put;
1235 }
c9a9c5e0
KH
1236
1237 e->pipe = pipe;
b9c2c9ae 1238 e->base.pid = current->pid;
c9a9c5e0
KH
1239 e->event.base.type = DRM_EVENT_VBLANK;
1240 e->event.base.length = sizeof e->event;
1241 e->event.user_data = vblwait->request.signal;
1242 e->base.event = &e->event.base;
1243 e->base.file_priv = file_priv;
1244 e->base.destroy = (void (*) (struct drm_pending_event *)) kfree;
1245
c9a9c5e0
KH
1246 spin_lock_irqsave(&dev->event_lock, flags);
1247
1248 if (file_priv->event_space < sizeof e->event) {
ea5d552c
CW
1249 ret = -EBUSY;
1250 goto err_unlock;
c9a9c5e0
KH
1251 }
1252
1253 file_priv->event_space -= sizeof e->event;
27641c3f
MK
1254 seq = drm_vblank_count_and_time(dev, pipe, &now);
1255
c9a9c5e0
KH
1256 if ((vblwait->request.type & _DRM_VBLANK_NEXTONMISS) &&
1257 (seq - vblwait->request.sequence) <= (1 << 23)) {
1258 vblwait->request.sequence = seq + 1;
4a921645 1259 vblwait->reply.sequence = vblwait->request.sequence;
c9a9c5e0
KH
1260 }
1261
1262 DRM_DEBUG("event on vblank count %d, current %d, crtc %d\n",
1263 vblwait->request.sequence, seq, pipe);
1264
b9c2c9ae
JB
1265 trace_drm_vblank_event_queued(current->pid, pipe,
1266 vblwait->request.sequence);
1267
c9a9c5e0
KH
1268 e->event.sequence = vblwait->request.sequence;
1269 if ((seq - vblwait->request.sequence) <= (1 << 23)) {
6f331623 1270 drm_vblank_put(dev, pipe);
c6eefa17 1271 send_vblank_event(dev, e, seq, &now);
000fa7cf 1272 vblwait->reply.sequence = seq;
c9a9c5e0 1273 } else {
a6778e9e 1274 /* drm_handle_vblank_events will call drm_vblank_put */
c9a9c5e0 1275 list_add_tail(&e->base.link, &dev->vblank_event_list);
000fa7cf 1276 vblwait->reply.sequence = vblwait->request.sequence;
c9a9c5e0
KH
1277 }
1278
1279 spin_unlock_irqrestore(&dev->event_lock, flags);
1280
1281 return 0;
ea5d552c
CW
1282
1283err_unlock:
1284 spin_unlock_irqrestore(&dev->event_lock, flags);
1285 kfree(e);
1286err_put:
6f331623 1287 drm_vblank_put(dev, pipe);
ea5d552c 1288 return ret;
c9a9c5e0
KH
1289}
1290
f5752b38 1291/*
1da177e4
LT
1292 * Wait for VBLANK.
1293 *
1294 * \param inode device inode.
6c340eac 1295 * \param file_priv DRM file private.
1da177e4
LT
1296 * \param cmd command.
1297 * \param data user argument, pointing to a drm_wait_vblank structure.
1298 * \return zero on success or a negative number on failure.
1299 *
30b23634
EA
1300 * This function enables the vblank interrupt on the pipe requested, then
1301 * sleeps waiting for the requested sequence number to occur, and drops
f5752b38 1302 * the vblank interrupt refcount afterwards. (vblank IRQ disable follows that
30b23634 1303 * after a timeout with no further vblank waits scheduled).
1da177e4 1304 */
0a3e67a4
JB
1305int drm_wait_vblank(struct drm_device *dev, void *data,
1306 struct drm_file *file_priv)
1da177e4 1307{
c153f45f 1308 union drm_wait_vblank *vblwait = data;
4a1b0714 1309 int ret;
19b01b5f 1310 unsigned int flags, seq, crtc, high_crtc;
1da177e4 1311
4984979b
DV
1312 if (!dev->irq_enabled)
1313 return -EINVAL;
1da177e4 1314
30b23634
EA
1315 if (vblwait->request.type & _DRM_VBLANK_SIGNAL)
1316 return -EINVAL;
1317
c153f45f 1318 if (vblwait->request.type &
19b01b5f
IH
1319 ~(_DRM_VBLANK_TYPES_MASK | _DRM_VBLANK_FLAGS_MASK |
1320 _DRM_VBLANK_HIGH_CRTC_MASK)) {
776c9443 1321 DRM_ERROR("Unsupported type value 0x%x, supported mask 0x%x\n",
c153f45f 1322 vblwait->request.type,
19b01b5f
IH
1323 (_DRM_VBLANK_TYPES_MASK | _DRM_VBLANK_FLAGS_MASK |
1324 _DRM_VBLANK_HIGH_CRTC_MASK));
776c9443
MD
1325 return -EINVAL;
1326 }
1327
c153f45f 1328 flags = vblwait->request.type & _DRM_VBLANK_FLAGS_MASK;
19b01b5f
IH
1329 high_crtc = (vblwait->request.type & _DRM_VBLANK_HIGH_CRTC_MASK);
1330 if (high_crtc)
1331 crtc = high_crtc >> _DRM_VBLANK_HIGH_CRTC_SHIFT;
1332 else
1333 crtc = flags & _DRM_VBLANK_SECONDARY ? 1 : 0;
0a3e67a4 1334 if (crtc >= dev->num_crtcs)
776c9443
MD
1335 return -EINVAL;
1336
0a3e67a4
JB
1337 ret = drm_vblank_get(dev, crtc);
1338 if (ret) {
8d3457ec 1339 DRM_DEBUG("failed to acquire vblank counter, %d\n", ret);
0a3e67a4
JB
1340 return ret;
1341 }
1342 seq = drm_vblank_count(dev, crtc);
776c9443 1343
c153f45f 1344 switch (vblwait->request.type & _DRM_VBLANK_TYPES_MASK) {
1da177e4 1345 case _DRM_VBLANK_RELATIVE:
c153f45f
EA
1346 vblwait->request.sequence += seq;
1347 vblwait->request.type &= ~_DRM_VBLANK_RELATIVE;
1da177e4
LT
1348 case _DRM_VBLANK_ABSOLUTE:
1349 break;
1350 default:
0a3e67a4
JB
1351 ret = -EINVAL;
1352 goto done;
1da177e4
LT
1353 }
1354
a6778e9e
IH
1355 if (flags & _DRM_VBLANK_EVENT) {
1356 /* must hold on to the vblank ref until the event fires
1357 * drm_vblank_put will be called asynchronously
1358 */
c9a9c5e0 1359 return drm_queue_vblank_event(dev, crtc, vblwait, file_priv);
a6778e9e 1360 }
c9a9c5e0 1361
ab285d74 1362 if ((flags & _DRM_VBLANK_NEXTONMISS) &&
c153f45f
EA
1363 (seq - vblwait->request.sequence) <= (1<<23)) {
1364 vblwait->request.sequence = seq + 1;
ab285d74
MD
1365 }
1366
30b23634
EA
1367 DRM_DEBUG("waiting on vblank count %d, crtc %d\n",
1368 vblwait->request.sequence, crtc);
5380e929 1369 dev->vblank[crtc].last_wait = vblwait->request.sequence;
bfd8303a 1370 DRM_WAIT_ON(ret, dev->vblank[crtc].queue, 3 * HZ,
30b23634
EA
1371 (((drm_vblank_count(dev, crtc) -
1372 vblwait->request.sequence) <= (1 << 23)) ||
3212a22f 1373 !dev->vblank[crtc].enabled ||
30b23634 1374 !dev->irq_enabled));
1da177e4 1375
30b23634
EA
1376 if (ret != -EINTR) {
1377 struct timeval now;
1da177e4 1378
27641c3f 1379 vblwait->reply.sequence = drm_vblank_count_and_time(dev, crtc, &now);
30b23634
EA
1380 vblwait->reply.tval_sec = now.tv_sec;
1381 vblwait->reply.tval_usec = now.tv_usec;
27641c3f 1382
30b23634
EA
1383 DRM_DEBUG("returning %d to client\n",
1384 vblwait->reply.sequence);
1da177e4 1385 } else {
30b23634 1386 DRM_DEBUG("vblank wait interrupted by signal\n");
1da177e4
LT
1387 }
1388
0a3e67a4
JB
1389done:
1390 drm_vblank_put(dev, crtc);
1da177e4
LT
1391 return ret;
1392}
1393
ea7f7abc 1394static void drm_handle_vblank_events(struct drm_device *dev, int crtc)
c9a9c5e0
KH
1395{
1396 struct drm_pending_vblank_event *e, *t;
1397 struct timeval now;
1398 unsigned long flags;
1399 unsigned int seq;
1400
27641c3f 1401 seq = drm_vblank_count_and_time(dev, crtc, &now);
c9a9c5e0
KH
1402
1403 spin_lock_irqsave(&dev->event_lock, flags);
1404
1405 list_for_each_entry_safe(e, t, &dev->vblank_event_list, base.link) {
1406 if (e->pipe != crtc)
1407 continue;
1408 if ((seq - e->event.sequence) > (1<<23))
1409 continue;
1410
1411 DRM_DEBUG("vblank event on %d, current %d\n",
1412 e->event.sequence, seq);
1413
c6eefa17 1414 list_del(&e->base.link);
c9a9c5e0 1415 drm_vblank_put(dev, e->pipe);
c6eefa17 1416 send_vblank_event(dev, e, seq, &now);
c9a9c5e0
KH
1417 }
1418
1419 spin_unlock_irqrestore(&dev->event_lock, flags);
ac2874b9
JB
1420
1421 trace_drm_vblank_event(crtc, seq);
c9a9c5e0
KH
1422}
1423
0a3e67a4
JB
1424/**
1425 * drm_handle_vblank - handle a vblank event
1426 * @dev: DRM device
1427 * @crtc: where this event occurred
1428 *
1429 * Drivers should call this routine in their vblank interrupt handlers to
1430 * update the vblank counter and send any signals that may be pending.
1431 */
78c6e170 1432bool drm_handle_vblank(struct drm_device *dev, int crtc)
0a3e67a4 1433{
27641c3f
MK
1434 u32 vblcount;
1435 s64 diff_ns;
1436 struct timeval tvblank;
1437 unsigned long irqflags;
1438
c9a9c5e0 1439 if (!dev->num_crtcs)
78c6e170 1440 return false;
c9a9c5e0 1441
27641c3f
MK
1442 /* Need timestamp lock to prevent concurrent execution with
1443 * vblank enable/disable, as this would cause inconsistent
1444 * or corrupted timestamps and vblank counts.
1445 */
1446 spin_lock_irqsave(&dev->vblank_time_lock, irqflags);
1447
1448 /* Vblank irq handling disabled. Nothing to do. */
5380e929 1449 if (!dev->vblank[crtc].enabled) {
27641c3f 1450 spin_unlock_irqrestore(&dev->vblank_time_lock, irqflags);
78c6e170 1451 return false;
27641c3f
MK
1452 }
1453
1454 /* Fetch corresponding timestamp for this vblank interval from
1455 * driver and store it in proper slot of timestamp ringbuffer.
1456 */
1457
1458 /* Get current timestamp and count. */
5380e929 1459 vblcount = atomic_read(&dev->vblank[crtc].count);
27641c3f
MK
1460 drm_get_last_vbltimestamp(dev, crtc, &tvblank, DRM_CALLED_FROM_VBLIRQ);
1461
1462 /* Compute time difference to timestamp of last vblank */
1463 diff_ns = timeval_to_ns(&tvblank) -
1464 timeval_to_ns(&vblanktimestamp(dev, crtc, vblcount));
1465
1466 /* Update vblank timestamp and count if at least
1467 * DRM_REDUNDANT_VBLIRQ_THRESH_NS nanoseconds
1468 * difference between last stored timestamp and current
1469 * timestamp. A smaller difference means basically
1470 * identical timestamps. Happens if this vblank has
1471 * been already processed and this is a redundant call,
1472 * e.g., due to spurious vblank interrupts. We need to
1473 * ignore those for accounting.
1474 */
c4cc3839 1475 if (abs64(diff_ns) > DRM_REDUNDANT_VBLIRQ_THRESH_NS) {
27641c3f
MK
1476 /* Store new timestamp in ringbuffer. */
1477 vblanktimestamp(dev, crtc, vblcount + 1) = tvblank;
27641c3f
MK
1478
1479 /* Increment cooked vblank count. This also atomically commits
1480 * the timestamp computed above.
1481 */
bc215128 1482 smp_mb__before_atomic_inc();
5380e929 1483 atomic_inc(&dev->vblank[crtc].count);
bc215128 1484 smp_mb__after_atomic_inc();
27641c3f
MK
1485 } else {
1486 DRM_DEBUG("crtc %d: Redundant vblirq ignored. diff_ns = %d\n",
1487 crtc, (int) diff_ns);
1488 }
1489
57ed0f7b 1490 wake_up(&dev->vblank[crtc].queue);
c9a9c5e0 1491 drm_handle_vblank_events(dev, crtc);
27641c3f
MK
1492
1493 spin_unlock_irqrestore(&dev->vblank_time_lock, irqflags);
78c6e170 1494 return true;
0a3e67a4
JB
1495}
1496EXPORT_SYMBOL(drm_handle_vblank);