cachepc-linux

Fork of AMDESE/linux with modifications for CachePC side-channel attack
git clone https://git.sinitax.com/sinitax/cachepc-linux
Log | Files | Refs | README | LICENSE | sfeed.txt

r128_drv.h (17671B)


      1/* r128_drv.h -- Private header for r128 driver -*- linux-c -*-
      2 * Created: Mon Dec 13 09:51:11 1999 by faith@precisioninsight.com
      3 */
      4/*
      5 * Copyright 1999 Precision Insight, Inc., Cedar Park, Texas.
      6 * Copyright 2000 VA Linux Systems, Inc., Sunnyvale, California.
      7 * All rights reserved.
      8 *
      9 * Permission is hereby granted, free of charge, to any person obtaining a
     10 * copy of this software and associated documentation files (the "Software"),
     11 * to deal in the Software without restriction, including without limitation
     12 * the rights to use, copy, modify, merge, publish, distribute, sublicense,
     13 * and/or sell copies of the Software, and to permit persons to whom the
     14 * Software is furnished to do so, subject to the following conditions:
     15 *
     16 * The above copyright notice and this permission notice (including the next
     17 * paragraph) shall be included in all copies or substantial portions of the
     18 * Software.
     19 *
     20 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
     21 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
     22 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL
     23 * PRECISION INSIGHT AND/OR ITS SUPPLIERS BE LIABLE FOR ANY CLAIM, DAMAGES OR
     24 * OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
     25 * ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
     26 * DEALINGS IN THE SOFTWARE.
     27 *
     28 * Authors:
     29 *    Rickard E. (Rik) Faith <faith@valinux.com>
     30 *    Kevin E. Martin <martin@valinux.com>
     31 *    Gareth Hughes <gareth@valinux.com>
     32 *    Michel Dänzer <daenzerm@student.ethz.ch>
     33 */
     34
     35#ifndef __R128_DRV_H__
     36#define __R128_DRV_H__
     37
     38#include <linux/delay.h>
     39#include <linux/io.h>
     40#include <linux/irqreturn.h>
     41
     42#include <drm/drm_ioctl.h>
     43#include <drm/drm_legacy.h>
     44#include <drm/r128_drm.h>
     45
     46#include "ati_pcigart.h"
     47
     48/* General customization:
     49 */
     50#define DRIVER_AUTHOR		"Gareth Hughes, VA Linux Systems Inc."
     51
     52#define DRIVER_NAME		"r128"
     53#define DRIVER_DESC		"ATI Rage 128"
     54#define DRIVER_DATE		"20030725"
     55
     56/* Interface history:
     57 *
     58 * ??  - ??
     59 * 2.4 - Add support for ycbcr textures (no new ioctls)
     60 * 2.5 - Add FLIP ioctl, disable FULLSCREEN.
     61 */
     62#define DRIVER_MAJOR		2
     63#define DRIVER_MINOR		5
     64#define DRIVER_PATCHLEVEL	0
     65
     66#define GET_RING_HEAD(dev_priv)		R128_READ(R128_PM4_BUFFER_DL_RPTR)
     67
     68typedef struct drm_r128_freelist {
     69	unsigned int age;
     70	struct drm_buf *buf;
     71	struct drm_r128_freelist *next;
     72	struct drm_r128_freelist *prev;
     73} drm_r128_freelist_t;
     74
     75typedef struct drm_r128_ring_buffer {
     76	u32 *start;
     77	u32 *end;
     78	int size;
     79	int size_l2qw;
     80
     81	u32 tail;
     82	u32 tail_mask;
     83	int space;
     84
     85	int high_mark;
     86} drm_r128_ring_buffer_t;
     87
     88typedef struct drm_r128_private {
     89	drm_r128_ring_buffer_t ring;
     90	drm_r128_sarea_t *sarea_priv;
     91
     92	int cce_mode;
     93	int cce_fifo_size;
     94	int cce_running;
     95
     96	drm_r128_freelist_t *head;
     97	drm_r128_freelist_t *tail;
     98
     99	int usec_timeout;
    100	int is_pci;
    101	unsigned long cce_buffers_offset;
    102
    103	atomic_t idle_count;
    104
    105	int page_flipping;
    106	int current_page;
    107	u32 crtc_offset;
    108	u32 crtc_offset_cntl;
    109
    110	atomic_t vbl_received;
    111
    112	u32 color_fmt;
    113	unsigned int front_offset;
    114	unsigned int front_pitch;
    115	unsigned int back_offset;
    116	unsigned int back_pitch;
    117
    118	u32 depth_fmt;
    119	unsigned int depth_offset;
    120	unsigned int depth_pitch;
    121	unsigned int span_offset;
    122
    123	u32 front_pitch_offset_c;
    124	u32 back_pitch_offset_c;
    125	u32 depth_pitch_offset_c;
    126	u32 span_pitch_offset_c;
    127
    128	drm_local_map_t *sarea;
    129	drm_local_map_t *mmio;
    130	drm_local_map_t *cce_ring;
    131	drm_local_map_t *ring_rptr;
    132	drm_local_map_t *agp_textures;
    133	struct drm_ati_pcigart_info gart_info;
    134} drm_r128_private_t;
    135
    136typedef struct drm_r128_buf_priv {
    137	u32 age;
    138	int prim;
    139	int discard;
    140	int dispatched;
    141	drm_r128_freelist_t *list_entry;
    142} drm_r128_buf_priv_t;
    143
    144extern const struct drm_ioctl_desc r128_ioctls[];
    145extern int r128_max_ioctl;
    146
    147				/* r128_cce.c */
    148extern int r128_cce_init(struct drm_device *dev, void *data, struct drm_file *file_priv);
    149extern int r128_cce_start(struct drm_device *dev, void *data, struct drm_file *file_priv);
    150extern int r128_cce_stop(struct drm_device *dev, void *data, struct drm_file *file_priv);
    151extern int r128_cce_reset(struct drm_device *dev, void *data, struct drm_file *file_priv);
    152extern int r128_cce_idle(struct drm_device *dev, void *data, struct drm_file *file_priv);
    153extern int r128_engine_reset(struct drm_device *dev, void *data, struct drm_file *file_priv);
    154extern int r128_fullscreen(struct drm_device *dev, void *data, struct drm_file *file_priv);
    155extern int r128_cce_buffers(struct drm_device *dev, void *data, struct drm_file *file_priv);
    156
    157extern int r128_cce_stipple(struct drm_device *dev, void *data, struct drm_file *file_priv);
    158extern int r128_cce_depth(struct drm_device *dev, void *data, struct drm_file *file_priv);
    159extern int r128_getparam(struct drm_device *dev, void *data, struct drm_file *file_priv);
    160
    161extern void r128_freelist_reset(struct drm_device *dev);
    162
    163extern int r128_wait_ring(drm_r128_private_t *dev_priv, int n);
    164
    165extern int r128_do_cce_idle(drm_r128_private_t *dev_priv);
    166extern int r128_do_cleanup_cce(struct drm_device *dev);
    167
    168extern int r128_enable_vblank(struct drm_device *dev, unsigned int pipe);
    169extern void r128_disable_vblank(struct drm_device *dev, unsigned int pipe);
    170extern u32 r128_get_vblank_counter(struct drm_device *dev, unsigned int pipe);
    171extern irqreturn_t r128_driver_irq_handler(int irq, void *arg);
    172extern void r128_driver_irq_preinstall(struct drm_device *dev);
    173extern int r128_driver_irq_postinstall(struct drm_device *dev);
    174extern void r128_driver_irq_uninstall(struct drm_device *dev);
    175extern void r128_driver_lastclose(struct drm_device *dev);
    176extern int r128_driver_load(struct drm_device *dev, unsigned long flags);
    177extern void r128_driver_preclose(struct drm_device *dev,
    178				 struct drm_file *file_priv);
    179
    180extern long r128_compat_ioctl(struct file *filp, unsigned int cmd,
    181			      unsigned long arg);
    182
    183/* Register definitions, register access macros and drmAddMap constants
    184 * for Rage 128 kernel driver.
    185 */
    186
    187#define R128_AUX_SC_CNTL		0x1660
    188#	define R128_AUX1_SC_EN			(1 << 0)
    189#	define R128_AUX1_SC_MODE_OR		(0 << 1)
    190#	define R128_AUX1_SC_MODE_NAND		(1 << 1)
    191#	define R128_AUX2_SC_EN			(1 << 2)
    192#	define R128_AUX2_SC_MODE_OR		(0 << 3)
    193#	define R128_AUX2_SC_MODE_NAND		(1 << 3)
    194#	define R128_AUX3_SC_EN			(1 << 4)
    195#	define R128_AUX3_SC_MODE_OR		(0 << 5)
    196#	define R128_AUX3_SC_MODE_NAND		(1 << 5)
    197#define R128_AUX1_SC_LEFT		0x1664
    198#define R128_AUX1_SC_RIGHT		0x1668
    199#define R128_AUX1_SC_TOP		0x166c
    200#define R128_AUX1_SC_BOTTOM		0x1670
    201#define R128_AUX2_SC_LEFT		0x1674
    202#define R128_AUX2_SC_RIGHT		0x1678
    203#define R128_AUX2_SC_TOP		0x167c
    204#define R128_AUX2_SC_BOTTOM		0x1680
    205#define R128_AUX3_SC_LEFT		0x1684
    206#define R128_AUX3_SC_RIGHT		0x1688
    207#define R128_AUX3_SC_TOP		0x168c
    208#define R128_AUX3_SC_BOTTOM		0x1690
    209
    210#define R128_BRUSH_DATA0		0x1480
    211#define R128_BUS_CNTL			0x0030
    212#	define R128_BUS_MASTER_DIS		(1 << 6)
    213
    214#define R128_CLOCK_CNTL_INDEX		0x0008
    215#define R128_CLOCK_CNTL_DATA		0x000c
    216#	define R128_PLL_WR_EN			(1 << 7)
    217#define R128_CONSTANT_COLOR_C		0x1d34
    218#define R128_CRTC_OFFSET		0x0224
    219#define R128_CRTC_OFFSET_CNTL		0x0228
    220#	define R128_CRTC_OFFSET_FLIP_CNTL	(1 << 16)
    221
    222#define R128_DP_GUI_MASTER_CNTL		0x146c
    223#       define R128_GMC_SRC_PITCH_OFFSET_CNTL	(1    <<  0)
    224#       define R128_GMC_DST_PITCH_OFFSET_CNTL	(1    <<  1)
    225#	define R128_GMC_BRUSH_SOLID_COLOR	(13   <<  4)
    226#	define R128_GMC_BRUSH_NONE		(15   <<  4)
    227#	define R128_GMC_DST_16BPP		(4    <<  8)
    228#	define R128_GMC_DST_24BPP		(5    <<  8)
    229#	define R128_GMC_DST_32BPP		(6    <<  8)
    230#       define R128_GMC_DST_DATATYPE_SHIFT	8
    231#	define R128_GMC_SRC_DATATYPE_COLOR	(3    << 12)
    232#	define R128_DP_SRC_SOURCE_MEMORY	(2    << 24)
    233#	define R128_DP_SRC_SOURCE_HOST_DATA	(3    << 24)
    234#	define R128_GMC_CLR_CMP_CNTL_DIS	(1    << 28)
    235#	define R128_GMC_AUX_CLIP_DIS		(1    << 29)
    236#	define R128_GMC_WR_MSK_DIS		(1    << 30)
    237#	define R128_ROP3_S			0x00cc0000
    238#	define R128_ROP3_P			0x00f00000
    239#define R128_DP_WRITE_MASK		0x16cc
    240#define R128_DST_PITCH_OFFSET_C		0x1c80
    241#	define R128_DST_TILE			(1 << 31)
    242
    243#define R128_GEN_INT_CNTL		0x0040
    244#	define R128_CRTC_VBLANK_INT_EN		(1 <<  0)
    245#define R128_GEN_INT_STATUS		0x0044
    246#	define R128_CRTC_VBLANK_INT		(1 <<  0)
    247#	define R128_CRTC_VBLANK_INT_AK		(1 <<  0)
    248#define R128_GEN_RESET_CNTL		0x00f0
    249#	define R128_SOFT_RESET_GUI		(1 <<  0)
    250
    251#define R128_GUI_SCRATCH_REG0		0x15e0
    252#define R128_GUI_SCRATCH_REG1		0x15e4
    253#define R128_GUI_SCRATCH_REG2		0x15e8
    254#define R128_GUI_SCRATCH_REG3		0x15ec
    255#define R128_GUI_SCRATCH_REG4		0x15f0
    256#define R128_GUI_SCRATCH_REG5		0x15f4
    257
    258#define R128_GUI_STAT			0x1740
    259#	define R128_GUI_FIFOCNT_MASK		0x0fff
    260#	define R128_GUI_ACTIVE			(1 << 31)
    261
    262#define R128_MCLK_CNTL			0x000f
    263#	define R128_FORCE_GCP			(1 << 16)
    264#	define R128_FORCE_PIPE3D_CP		(1 << 17)
    265#	define R128_FORCE_RCP			(1 << 18)
    266
    267#define R128_PC_GUI_CTLSTAT		0x1748
    268#define R128_PC_NGUI_CTLSTAT		0x0184
    269#	define R128_PC_FLUSH_GUI		(3 << 0)
    270#	define R128_PC_RI_GUI			(1 << 2)
    271#	define R128_PC_FLUSH_ALL		0x00ff
    272#	define R128_PC_BUSY			(1 << 31)
    273
    274#define R128_PCI_GART_PAGE		0x017c
    275#define R128_PRIM_TEX_CNTL_C		0x1cb0
    276
    277#define R128_SCALE_3D_CNTL		0x1a00
    278#define R128_SEC_TEX_CNTL_C		0x1d00
    279#define R128_SEC_TEXTURE_BORDER_COLOR_C	0x1d3c
    280#define R128_SETUP_CNTL			0x1bc4
    281#define R128_STEN_REF_MASK_C		0x1d40
    282
    283#define R128_TEX_CNTL_C			0x1c9c
    284#	define R128_TEX_CACHE_FLUSH		(1 << 23)
    285
    286#define R128_WAIT_UNTIL			0x1720
    287#	define R128_EVENT_CRTC_OFFSET		(1 << 0)
    288#define R128_WINDOW_XY_OFFSET		0x1bcc
    289
    290/* CCE registers
    291 */
    292#define R128_PM4_BUFFER_OFFSET		0x0700
    293#define R128_PM4_BUFFER_CNTL		0x0704
    294#	define R128_PM4_MASK			(15 << 28)
    295#	define R128_PM4_NONPM4			(0  << 28)
    296#	define R128_PM4_192PIO			(1  << 28)
    297#	define R128_PM4_192BM			(2  << 28)
    298#	define R128_PM4_128PIO_64INDBM		(3  << 28)
    299#	define R128_PM4_128BM_64INDBM		(4  << 28)
    300#	define R128_PM4_64PIO_128INDBM		(5  << 28)
    301#	define R128_PM4_64BM_128INDBM		(6  << 28)
    302#	define R128_PM4_64PIO_64VCBM_64INDBM	(7  << 28)
    303#	define R128_PM4_64BM_64VCBM_64INDBM	(8  << 28)
    304#	define R128_PM4_64PIO_64VCPIO_64INDPIO	(15 << 28)
    305#	define R128_PM4_BUFFER_CNTL_NOUPDATE	(1  << 27)
    306
    307#define R128_PM4_BUFFER_WM_CNTL		0x0708
    308#	define R128_WMA_SHIFT			0
    309#	define R128_WMB_SHIFT			8
    310#	define R128_WMC_SHIFT			16
    311#	define R128_WB_WM_SHIFT			24
    312
    313#define R128_PM4_BUFFER_DL_RPTR_ADDR	0x070c
    314#define R128_PM4_BUFFER_DL_RPTR		0x0710
    315#define R128_PM4_BUFFER_DL_WPTR		0x0714
    316#	define R128_PM4_BUFFER_DL_DONE		(1 << 31)
    317
    318#define R128_PM4_VC_FPU_SETUP		0x071c
    319
    320#define R128_PM4_IW_INDOFF		0x0738
    321#define R128_PM4_IW_INDSIZE		0x073c
    322
    323#define R128_PM4_STAT			0x07b8
    324#	define R128_PM4_FIFOCNT_MASK		0x0fff
    325#	define R128_PM4_BUSY			(1 << 16)
    326#	define R128_PM4_GUI_ACTIVE		(1 << 31)
    327
    328#define R128_PM4_MICROCODE_ADDR		0x07d4
    329#define R128_PM4_MICROCODE_RADDR	0x07d8
    330#define R128_PM4_MICROCODE_DATAH	0x07dc
    331#define R128_PM4_MICROCODE_DATAL	0x07e0
    332
    333#define R128_PM4_BUFFER_ADDR		0x07f0
    334#define R128_PM4_MICRO_CNTL		0x07fc
    335#	define R128_PM4_MICRO_FREERUN		(1 << 30)
    336
    337#define R128_PM4_FIFO_DATA_EVEN		0x1000
    338#define R128_PM4_FIFO_DATA_ODD		0x1004
    339
    340/* CCE command packets
    341 */
    342#define R128_CCE_PACKET0		0x00000000
    343#define R128_CCE_PACKET1		0x40000000
    344#define R128_CCE_PACKET2		0x80000000
    345#define R128_CCE_PACKET3		0xC0000000
    346#	define R128_CNTL_HOSTDATA_BLT		0x00009400
    347#	define R128_CNTL_PAINT_MULTI		0x00009A00
    348#	define R128_CNTL_BITBLT_MULTI		0x00009B00
    349#	define R128_3D_RNDR_GEN_INDX_PRIM	0x00002300
    350
    351#define R128_CCE_PACKET_MASK		0xC0000000
    352#define R128_CCE_PACKET_COUNT_MASK	0x3fff0000
    353#define R128_CCE_PACKET0_REG_MASK	0x000007ff
    354#define R128_CCE_PACKET1_REG0_MASK	0x000007ff
    355#define R128_CCE_PACKET1_REG1_MASK	0x003ff800
    356
    357#define R128_CCE_VC_CNTL_PRIM_TYPE_NONE		0x00000000
    358#define R128_CCE_VC_CNTL_PRIM_TYPE_POINT	0x00000001
    359#define R128_CCE_VC_CNTL_PRIM_TYPE_LINE		0x00000002
    360#define R128_CCE_VC_CNTL_PRIM_TYPE_POLY_LINE	0x00000003
    361#define R128_CCE_VC_CNTL_PRIM_TYPE_TRI_LIST	0x00000004
    362#define R128_CCE_VC_CNTL_PRIM_TYPE_TRI_FAN	0x00000005
    363#define R128_CCE_VC_CNTL_PRIM_TYPE_TRI_STRIP	0x00000006
    364#define R128_CCE_VC_CNTL_PRIM_TYPE_TRI_TYPE2	0x00000007
    365#define R128_CCE_VC_CNTL_PRIM_WALK_IND		0x00000010
    366#define R128_CCE_VC_CNTL_PRIM_WALK_LIST		0x00000020
    367#define R128_CCE_VC_CNTL_PRIM_WALK_RING		0x00000030
    368#define R128_CCE_VC_CNTL_NUM_SHIFT		16
    369
    370#define R128_DATATYPE_VQ		0
    371#define R128_DATATYPE_CI4		1
    372#define R128_DATATYPE_CI8		2
    373#define R128_DATATYPE_ARGB1555		3
    374#define R128_DATATYPE_RGB565		4
    375#define R128_DATATYPE_RGB888		5
    376#define R128_DATATYPE_ARGB8888		6
    377#define R128_DATATYPE_RGB332		7
    378#define R128_DATATYPE_Y8		8
    379#define R128_DATATYPE_RGB8		9
    380#define R128_DATATYPE_CI16		10
    381#define R128_DATATYPE_YVYU422		11
    382#define R128_DATATYPE_VYUY422		12
    383#define R128_DATATYPE_AYUV444		14
    384#define R128_DATATYPE_ARGB4444		15
    385
    386/* Constants */
    387#define R128_AGP_OFFSET			0x02000000
    388
    389#define R128_WATERMARK_L		16
    390#define R128_WATERMARK_M		8
    391#define R128_WATERMARK_N		8
    392#define R128_WATERMARK_K		128
    393
    394#define R128_MAX_USEC_TIMEOUT		100000	/* 100 ms */
    395
    396#define R128_LAST_FRAME_REG		R128_GUI_SCRATCH_REG0
    397#define R128_LAST_DISPATCH_REG		R128_GUI_SCRATCH_REG1
    398#define R128_MAX_VB_AGE			0x7fffffff
    399#define R128_MAX_VB_VERTS		(0xffff)
    400
    401#define R128_RING_HIGH_MARK		128
    402
    403#define R128_PERFORMANCE_BOXES		0
    404
    405#define R128_PCIGART_TABLE_SIZE         32768
    406
    407#define R128_READ(reg)		readl(((void __iomem *)dev_priv->mmio->handle) + (reg))
    408#define R128_WRITE(reg, val)	writel(val, ((void __iomem *)dev_priv->mmio->handle) + (reg))
    409#define R128_READ8(reg)		readb(((void __iomem *)dev_priv->mmio->handle) + (reg))
    410#define R128_WRITE8(reg, val)	writeb(val, ((void __iomem *)dev_priv->mmio->handle) + (reg))
    411
    412#define R128_WRITE_PLL(addr, val)					\
    413do {									\
    414	R128_WRITE8(R128_CLOCK_CNTL_INDEX,				\
    415		    ((addr) & 0x1f) | R128_PLL_WR_EN);			\
    416	R128_WRITE(R128_CLOCK_CNTL_DATA, (val));			\
    417} while (0)
    418
    419#define CCE_PACKET0(reg, n)		(R128_CCE_PACKET0 |		\
    420					 ((n) << 16) | ((reg) >> 2))
    421#define CCE_PACKET1(reg0, reg1)		(R128_CCE_PACKET1 |		\
    422					 (((reg1) >> 2) << 11) | ((reg0) >> 2))
    423#define CCE_PACKET2()			(R128_CCE_PACKET2)
    424#define CCE_PACKET3(pkt, n)		(R128_CCE_PACKET3 |		\
    425					 (pkt) | ((n) << 16))
    426
    427static __inline__ void r128_update_ring_snapshot(drm_r128_private_t *dev_priv)
    428{
    429	drm_r128_ring_buffer_t *ring = &dev_priv->ring;
    430	ring->space = (GET_RING_HEAD(dev_priv) - ring->tail) * sizeof(u32);
    431	if (ring->space <= 0)
    432		ring->space += ring->size;
    433}
    434
    435/* ================================================================
    436 * Misc helper macros
    437 */
    438
    439#define DEV_INIT_TEST_WITH_RETURN(_dev_priv)				\
    440do {									\
    441	if (!_dev_priv) {						\
    442		DRM_ERROR("called with no initialization\n");		\
    443		return -EINVAL;						\
    444	}								\
    445} while (0)
    446
    447#define RING_SPACE_TEST_WITH_RETURN(dev_priv)				\
    448do {									\
    449	drm_r128_ring_buffer_t *ring = &dev_priv->ring; int i;		\
    450	if (ring->space < ring->high_mark) {				\
    451		for (i = 0 ; i < dev_priv->usec_timeout ; i++) {	\
    452			r128_update_ring_snapshot(dev_priv);		\
    453			if (ring->space >= ring->high_mark)		\
    454				goto __ring_space_done;			\
    455			udelay(1);					\
    456		}							\
    457		DRM_ERROR("ring space check failed!\n");		\
    458		return -EBUSY;						\
    459	}								\
    460 __ring_space_done:							\
    461	;								\
    462} while (0)
    463
    464#define VB_AGE_TEST_WITH_RETURN(dev_priv)				\
    465do {									\
    466	drm_r128_sarea_t *sarea_priv = dev_priv->sarea_priv;		\
    467	if (sarea_priv->last_dispatch >= R128_MAX_VB_AGE) {		\
    468		int __ret = r128_do_cce_idle(dev_priv);			\
    469		if (__ret)						\
    470			return __ret;					\
    471		sarea_priv->last_dispatch = 0;				\
    472		r128_freelist_reset(dev);				\
    473	}								\
    474} while (0)
    475
    476#define R128_WAIT_UNTIL_PAGE_FLIPPED() do {				\
    477	OUT_RING(CCE_PACKET0(R128_WAIT_UNTIL, 0));			\
    478	OUT_RING(R128_EVENT_CRTC_OFFSET);				\
    479} while (0)
    480
    481/* ================================================================
    482 * Ring control
    483 */
    484
    485#define R128_VERBOSE	0
    486
    487#define RING_LOCALS							\
    488	int write, _nr; unsigned int tail_mask; volatile u32 *ring;
    489
    490#define BEGIN_RING(n) do {						\
    491	if (R128_VERBOSE)						\
    492		DRM_INFO("BEGIN_RING(%d)\n", (n));			\
    493	if (dev_priv->ring.space <= (n) * sizeof(u32)) {		\
    494		COMMIT_RING();						\
    495		r128_wait_ring(dev_priv, (n) * sizeof(u32));		\
    496	}								\
    497	_nr = n; dev_priv->ring.space -= (n) * sizeof(u32);		\
    498	ring = dev_priv->ring.start;					\
    499	write = dev_priv->ring.tail;					\
    500	tail_mask = dev_priv->ring.tail_mask;				\
    501} while (0)
    502
    503/* You can set this to zero if you want.  If the card locks up, you'll
    504 * need to keep this set.  It works around a bug in early revs of the
    505 * Rage 128 chipset, where the CCE would read 32 dwords past the end of
    506 * the ring buffer before wrapping around.
    507 */
    508#define R128_BROKEN_CCE	1
    509
    510#define ADVANCE_RING() do {						\
    511	if (R128_VERBOSE)						\
    512		DRM_INFO("ADVANCE_RING() wr=0x%06x tail=0x%06x\n",	\
    513			 write, dev_priv->ring.tail);			\
    514	if (R128_BROKEN_CCE && write < 32)				\
    515		memcpy(dev_priv->ring.end,				\
    516		       dev_priv->ring.start,				\
    517		       write * sizeof(u32));				\
    518	if (((dev_priv->ring.tail + _nr) & tail_mask) != write)		\
    519		DRM_ERROR(						\
    520			"ADVANCE_RING(): mismatch: nr: %x write: %x line: %d\n",	\
    521			((dev_priv->ring.tail + _nr) & tail_mask),	\
    522			write, __LINE__);				\
    523	else								\
    524		dev_priv->ring.tail = write;				\
    525} while (0)
    526
    527#define COMMIT_RING() do {						\
    528	if (R128_VERBOSE)						\
    529		DRM_INFO("COMMIT_RING() tail=0x%06x\n",			\
    530			 dev_priv->ring.tail);				\
    531	mb();						\
    532	R128_WRITE(R128_PM4_BUFFER_DL_WPTR, dev_priv->ring.tail);	\
    533	R128_READ(R128_PM4_BUFFER_DL_WPTR);				\
    534} while (0)
    535
    536#define OUT_RING(x) do {						\
    537	if (R128_VERBOSE)						\
    538		DRM_INFO("   OUT_RING( 0x%08x ) at 0x%x\n",		\
    539			 (unsigned int)(x), write);			\
    540	ring[write++] = cpu_to_le32(x);					\
    541	write &= tail_mask;						\
    542} while (0)
    543
    544#endif				/* __R128_DRV_H__ */