1 /* i915_drv.h -- Private header for the I915 driver -*- linux-c -*-
5 * Copyright 2003 Tungsten Graphics, Inc., Cedar Park, Texas.
8 * Permission is hereby granted, free of charge, to any person obtaining a
9 * copy of this software and associated documentation files (the
10 * "Software"), to deal in the Software without restriction, including
11 * without limitation the rights to use, copy, modify, merge, publish,
12 * distribute, sub license, and/or sell copies of the Software, and to
13 * permit persons to whom the Software is furnished to do so, subject to
14 * the following conditions:
16 * The above copyright notice and this permission notice (including the
17 * next paragraph) shall be included in all copies or substantial portions
20 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
21 * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
22 * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT.
23 * IN NO EVENT SHALL TUNGSTEN GRAPHICS AND/OR ITS SUPPLIERS BE LIABLE FOR
24 * ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
25 * TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
26 * SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
33 #include "dev/drm/i915_reg.h"
35 /* General customization:
38 #define DRIVER_AUTHOR "Tungsten Graphics, Inc."
40 #define DRIVER_NAME "i915"
41 #define DRIVER_DESC "Intel Graphics"
42 #define DRIVER_DATE "20080730"
49 #define I915_NUM_PIPE 2
54 * 1.2: Add Power Management
55 * 1.3: Add vblank support
56 * 1.4: Fix cmdbuffer path, add heap destroy
57 * 1.5: Add vblank pipe configuration
58 * 1.6: - New ioctl for scheduling buffer swaps on vertical blank
59 * - Support vertical blank on secondary display pipe
61 #define DRIVER_MAJOR 1
62 #define DRIVER_MINOR 6
63 #define DRIVER_PATCHLEVEL 0
65 #define WATCH_COHERENCY 0
70 #define WATCH_INACTIVE 0
71 #define WATCH_PWRITE 0
73 typedef struct _drm_i915_ring_buffer
{
81 struct drm_gem_object
*ring_obj
;
82 } drm_i915_ring_buffer_t
;
85 struct mem_block
*next
;
86 struct mem_block
*prev
;
89 struct drm_file
*file_priv
; /* NULL: free, -1: heap, other: real files */
92 struct opregion_header
;
94 struct opregion_swsci
;
97 struct intel_opregion
{
98 struct opregion_header
*header
;
99 struct opregion_acpi
*acpi
;
100 struct opregion_swsci
*swsci
;
101 struct opregion_asle
*asle
;
105 typedef struct drm_i915_private
{
106 struct drm_device
*dev
;
108 drm_local_map_t
*sarea
;
109 drm_local_map_t
*mmio_map
;
111 drm_i915_sarea_t
*sarea_priv
;
112 drm_i915_ring_buffer_t ring
;
114 drm_dma_handle_t
*status_page_dmah
;
115 void *hw_status_page
;
116 dma_addr_t dma_status_page
;
118 unsigned int status_gfx_addr
;
119 drm_local_map_t hws_map
;
120 struct drm_gem_object
*hws_obj
;
128 wait_queue_head_t irq_queue
;
129 /** Protects user_irq_refcount and irq_mask_reg */
130 DRM_SPINTYPE user_irq_lock
;
131 /** Refcount for i915_user_irq_get() versus i915_user_irq_put(). */
132 int user_irq_refcount
;
133 /** Cached value of IER to avoid reads in updating the bitfield */
137 int tex_lru_log_granularity
;
138 int allow_batchbuffer
;
139 struct mem_block
*agp_heap
;
140 unsigned int sr01
, adpa
, ppcr
, dvob
, dvoc
, lvds
;
143 struct intel_opregion opregion
;
150 u32 saveRENDERSTANDBY
;
174 u32 savePFIT_PGM_RATIOS
;
176 u32 saveBLC_PWM_CTL2
;
201 u32 savePP_ON_DELAYS
;
202 u32 savePP_OFF_DELAYS
;
210 u32 savePFIT_CONTROL
;
211 u32 save_palette_a
[256];
212 u32 save_palette_b
[256];
213 u32 saveFBC_CFB_BASE
;
216 u32 saveFBC_CONTROL2
;
220 u32 saveCACHE_MODE_0
;
223 u32 saveMI_ARB_STATE
;
237 struct drm_mm gtt_space
;
240 * List of objects currently involved in rendering from the
243 * A reference is held on the buffer while on this list.
245 struct list_head active_list
;
248 * List of objects which are not in the ringbuffer but which
249 * still have a write_domain which needs to be flushed before
252 * A reference is held on the buffer while on this list.
254 struct list_head flushing_list
;
257 * LRU list of objects which are not in the ringbuffer and
258 * are ready to unbind, but are still in the GTT.
260 * A reference is not held on the buffer while on this list,
261 * as merely being GTT-bound shouldn't prevent its being
262 * freed, and we'll pull it off the list in the free path.
264 struct list_head inactive_list
;
267 * List of breadcrumbs associated with GPU requests currently
270 struct list_head request_list
;
273 * We leave the user IRQ off as much as possible,
274 * but this means that requests will finish and never
275 * be retired once the system goes idle. Set a timer to
276 * fire periodically while the ring is running. When it
277 * fires, go retire requests.
279 struct delayed_work retire_work
;
281 uint32_t next_gem_seqno
;
284 * Waiting sequence number, if any
286 uint32_t waiting_gem_seqno
;
289 * Last seq seen at irq time
291 uint32_t irq_gem_seqno
;
294 * Flag if the X Server, and thus DRM, is not currently in
295 * control of the device.
297 * This is set between LeaveVT and EnterVT. It needs to be
298 * replaced with a semaphore. It also needs to be
299 * transitioned away from for kernel modesetting.
304 * Flag if the hardware appears to be wedged.
306 * This is set when attempts to idle the device timeout.
307 * It prevents command submission from occuring and makes
308 * every pending request fail
312 /** Bit 6 swizzling required for X tiling */
313 uint32_t bit_6_swizzle_x
;
314 /** Bit 6 swizzling required for Y tiling */
315 uint32_t bit_6_swizzle_y
;
317 } drm_i915_private_t
;
319 enum intel_chip_family
{
326 /** driver private structure attached to each drm_gem_object */
327 struct drm_i915_gem_object
{
328 struct drm_gem_object
*obj
;
330 /** Current space allocated to this object in the GTT, if any. */
331 struct drm_mm_node
*gtt_space
;
333 /** This object's place on the active/flushing/inactive lists */
334 struct list_head list
;
337 * This is set if the object is on the active or flushing lists
338 * (has pending rendering), and is not set if it's on inactive (ready
344 * This is set if the object has been written to since last bound
349 /** AGP memory structure for our GTT binding. */
350 DRM_AGP_MEM
*agp_mem
;
352 struct page
**page_list
;
355 * Current offset of the object in GTT space.
357 * This is the same as gtt_space->start
361 /** Boolean whether this object has a valid gtt offset. */
364 /** How many users have pinned this object in GTT space */
367 /** Breadcrumb of last rendering to the buffer. */
368 uint32_t last_rendering_seqno
;
370 /** Current tiling mode for the object. */
371 uint32_t tiling_mode
;
373 /** AGP mapping type (AGP_USER_MEMORY or AGP_USER_CACHED_MEMORY */
377 * Flagging of which individual pages are valid in GEM_DOMAIN_CPU when
378 * GEM_DOMAIN_CPU is not in the object's read domain.
380 uint8_t *page_cpu_valid
;
384 * Request queue structure.
386 * The request queue allows us to note sequence numbers that have been emitted
387 * and may be associated with active buffers to be retired.
389 * By keeping this list, we can avoid having to do questionable
390 * sequence-number comparisons on buffer last_rendering_seqnos, and associate
391 * an emission time with seqnos for tracking how far ahead of the GPU we are.
393 struct drm_i915_gem_request
{
394 /** GEM sequence number associated with this request. */
397 /** Time at which this request was emitted, in jiffies. */
398 unsigned long emitted_jiffies
;
400 /** Cache domains that were flushed at the start of the request. */
401 uint32_t flush_domains
;
403 struct list_head list
;
406 struct drm_i915_file_private
{
408 uint32_t last_gem_seqno
;
409 uint32_t last_gem_throttle_seqno
;
413 extern struct drm_ioctl_desc i915_ioctls
[];
414 extern int i915_max_ioctl
;
417 extern void i915_kernel_lost_context(struct drm_device
* dev
);
418 extern int i915_driver_load(struct drm_device
*, unsigned long flags
);
419 extern int i915_driver_unload(struct drm_device
*);
420 extern int i915_driver_open(struct drm_device
*dev
, struct drm_file
*file_priv
);
421 extern void i915_driver_lastclose(struct drm_device
* dev
);
422 extern void i915_driver_preclose(struct drm_device
*dev
,
423 struct drm_file
*file_priv
);
424 extern void i915_driver_postclose(struct drm_device
*dev
,
425 struct drm_file
*file_priv
);
426 extern int i915_driver_device_is_agp(struct drm_device
* dev
);
427 extern long i915_compat_ioctl(struct file
*filp
, unsigned int cmd
,
429 extern int i915_emit_box(struct drm_device
*dev
,
430 struct drm_clip_rect __user
*boxes
,
431 int i
, int DR1
, int DR4
);
434 extern int i915_irq_emit(struct drm_device
*dev
, void *data
,
435 struct drm_file
*file_priv
);
436 extern int i915_irq_wait(struct drm_device
*dev
, void *data
,
437 struct drm_file
*file_priv
);
438 void i915_user_irq_get(struct drm_device
*dev
);
439 void i915_user_irq_put(struct drm_device
*dev
);
441 extern irqreturn_t
i915_driver_irq_handler(DRM_IRQ_ARGS
);
442 extern void i915_driver_irq_preinstall(struct drm_device
* dev
);
443 extern int i915_driver_irq_postinstall(struct drm_device
*dev
);
444 extern void i915_driver_irq_uninstall(struct drm_device
* dev
);
445 extern int i915_vblank_pipe_set(struct drm_device
*dev
, void *data
,
446 struct drm_file
*file_priv
);
447 extern int i915_vblank_pipe_get(struct drm_device
*dev
, void *data
,
448 struct drm_file
*file_priv
);
449 extern int i915_enable_vblank(struct drm_device
*dev
, int crtc
);
450 extern void i915_disable_vblank(struct drm_device
*dev
, int crtc
);
451 extern u32
i915_get_vblank_counter(struct drm_device
*dev
, int crtc
);
452 extern u32
g45_get_vblank_counter(struct drm_device
*dev
, int crtc
);
453 extern int i915_vblank_swap(struct drm_device
*dev
, void *data
,
454 struct drm_file
*file_priv
);
457 i915_enable_pipestat(drm_i915_private_t
*dev_priv
, int pipe
, u32 mask
);
460 i915_disable_pipestat(drm_i915_private_t
*dev_priv
, int pipe
, u32 mask
);
464 extern int i915_mem_alloc(struct drm_device
*dev
, void *data
,
465 struct drm_file
*file_priv
);
466 extern int i915_mem_free(struct drm_device
*dev
, void *data
,
467 struct drm_file
*file_priv
);
468 extern int i915_mem_init_heap(struct drm_device
*dev
, void *data
,
469 struct drm_file
*file_priv
);
470 extern int i915_mem_destroy_heap(struct drm_device
*dev
, void *data
,
471 struct drm_file
*file_priv
);
472 extern void i915_mem_takedown(struct mem_block
**heap
);
473 extern void i915_mem_release(struct drm_device
* dev
,
474 struct drm_file
*file_priv
, struct mem_block
*heap
);
477 int i915_gem_init_ioctl(struct drm_device
*dev
, void *data
,
478 struct drm_file
*file_priv
);
479 int i915_gem_create_ioctl(struct drm_device
*dev
, void *data
,
480 struct drm_file
*file_priv
);
481 int i915_gem_pread_ioctl(struct drm_device
*dev
, void *data
,
482 struct drm_file
*file_priv
);
483 int i915_gem_pwrite_ioctl(struct drm_device
*dev
, void *data
,
484 struct drm_file
*file_priv
);
485 int i915_gem_mmap_ioctl(struct drm_device
*dev
, void *data
,
486 struct drm_file
*file_priv
);
487 int i915_gem_set_domain_ioctl(struct drm_device
*dev
, void *data
,
488 struct drm_file
*file_priv
);
489 int i915_gem_sw_finish_ioctl(struct drm_device
*dev
, void *data
,
490 struct drm_file
*file_priv
);
491 int i915_gem_execbuffer(struct drm_device
*dev
, void *data
,
492 struct drm_file
*file_priv
);
493 int i915_gem_pin_ioctl(struct drm_device
*dev
, void *data
,
494 struct drm_file
*file_priv
);
495 int i915_gem_unpin_ioctl(struct drm_device
*dev
, void *data
,
496 struct drm_file
*file_priv
);
497 int i915_gem_busy_ioctl(struct drm_device
*dev
, void *data
,
498 struct drm_file
*file_priv
);
499 int i915_gem_throttle_ioctl(struct drm_device
*dev
, void *data
,
500 struct drm_file
*file_priv
);
501 int i915_gem_entervt_ioctl(struct drm_device
*dev
, void *data
,
502 struct drm_file
*file_priv
);
503 int i915_gem_leavevt_ioctl(struct drm_device
*dev
, void *data
,
504 struct drm_file
*file_priv
);
505 int i915_gem_set_tiling(struct drm_device
*dev
, void *data
,
506 struct drm_file
*file_priv
);
507 int i915_gem_get_tiling(struct drm_device
*dev
, void *data
,
508 struct drm_file
*file_priv
);
509 void i915_gem_load(struct drm_device
*dev
);
510 int i915_gem_proc_init(struct drm_minor
*minor
);
511 void i915_gem_proc_cleanup(struct drm_minor
*minor
);
512 int i915_gem_init_object(struct drm_gem_object
*obj
);
513 void i915_gem_free_object(struct drm_gem_object
*obj
);
514 int i915_gem_object_pin(struct drm_gem_object
*obj
, uint32_t alignment
);
515 void i915_gem_object_unpin(struct drm_gem_object
*obj
);
516 void i915_gem_lastclose(struct drm_device
*dev
);
517 uint32_t i915_get_gem_seqno(struct drm_device
*dev
);
518 void i915_gem_retire_requests(struct drm_device
*dev
);
519 void i915_gem_retire_work_handler(struct work_struct
*work
);
520 void i915_gem_clflush_object(struct drm_gem_object
*obj
);
522 /* i915_gem_tiling.c */
523 void i915_gem_detect_bit_6_swizzle(struct drm_device
*dev
);
525 /* i915_gem_debug.c */
526 void i915_gem_dump_object(struct drm_gem_object
*obj
, int len
,
527 const char *where
, uint32_t mark
);
529 void i915_verify_inactive(struct drm_device
*dev
, char *file
, int line
);
531 #define i915_verify_inactive(dev, file, line)
533 void i915_gem_object_check_coherency(struct drm_gem_object
*obj
, int handle
);
534 void i915_gem_dump_object(struct drm_gem_object
*obj
, int len
,
535 const char *where
, uint32_t mark
);
536 void i915_dump_lru(struct drm_device
*dev
, const char *where
);
537 #endif /* I915_HAVE_GEM */
540 extern int i915_save_state(struct drm_device
*dev
);
541 extern int i915_restore_state(struct drm_device
*dev
);
543 /* i915_opregion.c */
544 extern int intel_opregion_init(struct drm_device
*dev
);
545 extern void intel_opregion_free(struct drm_device
*dev
);
546 extern void opregion_asle_intr(struct drm_device
*dev
);
547 extern void opregion_enable_asle(struct drm_device
*dev
);
550 * Lock test for when it's just for synchronization of ring access.
552 * In that case, we don't need to do it when GEM is initialized as nobody else
553 * has access to the ring.
555 #define RING_LOCK_TEST_WITH_RETURN(dev, file_priv) do { \
556 if (((drm_i915_private_t *)dev->dev_private)->ring.ring_obj == NULL) \
557 LOCK_TEST_WITH_RETURN(dev, file_priv); \
560 #if defined(__FreeBSD__) || defined(__DragonFly__)
561 typedef boolean_t
bool;
564 #define I915_READ(reg) DRM_READ32(dev_priv->mmio_map, (reg))
565 #define I915_WRITE(reg,val) DRM_WRITE32(dev_priv->mmio_map, (reg), (val))
566 #define I915_READ16(reg) DRM_READ16(dev_priv->mmio_map, (reg))
567 #define I915_WRITE16(reg,val) DRM_WRITE16(dev_priv->mmio_map, (reg), (val))
568 #define I915_READ8(reg) DRM_READ8(dev_priv->mmio_map, (reg))
569 #define I915_WRITE8(reg,val) DRM_WRITE8(dev_priv->mmio_map, (reg), (val))
571 #define I915_VERBOSE 0
573 #define RING_LOCALS unsigned int outring, ringmask, outcount; \
576 #define BEGIN_LP_RING(n) do { \
578 DRM_DEBUG("BEGIN_LP_RING(%d)\n", (n)); \
579 if (dev_priv->ring.space < (n)*4) \
580 i915_wait_ring(dev, (n)*4, __func__); \
582 outring = dev_priv->ring.tail; \
583 ringmask = dev_priv->ring.tail_mask; \
584 virt = dev_priv->ring.virtual_start; \
587 #define OUT_RING(n) do { \
588 if (I915_VERBOSE) DRM_DEBUG(" OUT_RING %x\n", (int)(n)); \
589 *(volatile unsigned int *)(virt + outring) = (n); \
592 outring &= ringmask; \
595 #define ADVANCE_LP_RING() do { \
596 if (I915_VERBOSE) DRM_DEBUG("ADVANCE_LP_RING %x\n", outring); \
597 dev_priv->ring.tail = outring; \
598 dev_priv->ring.space -= outcount * 4; \
599 I915_WRITE(PRB0_TAIL, outring); \
603 * Reads a dword out of the status page, which is written to from the command
604 * queue by automatic updates, MI_REPORT_HEAD, MI_STORE_DATA_INDEX, or
607 * The following dwords have a reserved meaning:
608 * 0x00: ISR copy, updated when an ISR bit not set in the HWSTAM changes.
609 * 0x04: ring 0 head pointer
610 * 0x05: ring 1 head pointer (915-class)
611 * 0x06: ring 2 head pointer (915-class)
612 * 0x10-0x1b: Context status DWords (GM45)
613 * 0x1f: Last written status offset. (GM45)
615 * The area from dword 0x20 to 0x3ff is available for driver usage.
617 #define READ_HWSP(dev_priv, reg) (((volatile u32*)(dev_priv->hw_status_page))[reg])
618 #define READ_BREADCRUMB(dev_priv) READ_HWSP(dev_priv, I915_BREADCRUMB_INDEX)
619 #define I915_GEM_HWS_INDEX 0x20
620 #define I915_BREADCRUMB_INDEX 0x21
622 extern int i915_wait_ring(struct drm_device
* dev
, int n
, const char *caller
);
624 #define IS_I830(dev) ((dev)->pci_device == 0x3577)
625 #define IS_845G(dev) ((dev)->pci_device == 0x2562)
626 #define IS_I85X(dev) ((dev)->pci_device == 0x3582)
627 #define IS_I855(dev) ((dev)->pci_device == 0x3582)
628 #define IS_I865G(dev) ((dev)->pci_device == 0x2572)
630 #define IS_I915G(dev) ((dev)->pci_device == 0x2582 || (dev)->pci_device == 0x258a)
631 #define IS_I915GM(dev) ((dev)->pci_device == 0x2592)
632 #define IS_I945G(dev) ((dev)->pci_device == 0x2772)
633 #define IS_I945GM(dev) ((dev)->pci_device == 0x27A2 ||\
634 (dev)->pci_device == 0x27AE)
635 #define IS_I965G(dev) ((dev)->pci_device == 0x2972 || \
636 (dev)->pci_device == 0x2982 || \
637 (dev)->pci_device == 0x2992 || \
638 (dev)->pci_device == 0x29A2 || \
639 (dev)->pci_device == 0x2A02 || \
640 (dev)->pci_device == 0x2A12 || \
641 (dev)->pci_device == 0x2A42 || \
642 (dev)->pci_device == 0x2E02 || \
643 (dev)->pci_device == 0x2E12 || \
644 (dev)->pci_device == 0x2E22 || \
645 (dev)->pci_device == 0x2E32)
647 #define IS_I965GM(dev) ((dev)->pci_device == 0x2A02)
649 #define IS_GM45(dev) ((dev)->pci_device == 0x2A42)
651 #define IS_G4X(dev) ((dev)->pci_device == 0x2E02 || \
652 (dev)->pci_device == 0x2E12 || \
653 (dev)->pci_device == 0x2E22 || \
654 (dev)->pci_device == 0x2E32 || \
657 #define IS_IGDG(dev) ((dev)->pci_device == 0xa001)
658 #define IS_IGDGM(dev) ((dev)->pci_device == 0xa011)
659 #define IS_IGD(dev) (IS_IGDG(dev) || IS_IGDGM(dev))
661 #define IS_G33(dev) ((dev)->pci_device == 0x29C2 || \
662 (dev)->pci_device == 0x29B2 || \
663 (dev)->pci_device == 0x29D2 || \
666 #define IS_I9XX(dev) (IS_I915G(dev) || IS_I915GM(dev) || IS_I945G(dev) || \
667 IS_I945GM(dev) || IS_I965G(dev) || IS_G33(dev))
669 #define IS_MOBILE(dev) (IS_I830(dev) || IS_I85X(dev) || IS_I915GM(dev) || \
670 IS_I945GM(dev) || IS_I965GM(dev) || IS_GM45(dev) || \
673 #define I915_NEED_GFX_HWS(dev) (IS_G33(dev) || IS_GM45(dev) || IS_G4X(dev))
675 #define PRIMARY_RINGBUFFER_SIZE (128*1024)