This source code  may damage your hardware.
It is *UNTESTED* and *BROKEN* !
Or, at least, some of it is.



R600_DEMO

	DRM/DRI exercise utility

	This is a bringup utility for learning how to program r6xx cards. It
	has no value for you if you are not a hardware driver hacker. Except
	for that it (hopefully) will draw a single triangle for you :-P

	Authors:
		Matthias Hopf <mhopf@suse.de>
		Alexander Deucher <Alexander.Deucher@amd.com>

	The original skeleton for r600_demo was r300_demo, but there's almost
	none (literally) code left from these days.

	The r600_demo code is provided without any warranty and in
	understanding that direct access to the hardware can lead to permanent
	damage to the hardware (or even damage to the user - say from locked up
	laser displays).
	The software is meant for experimentation and thus one should not
	expect it to be checked for compatibility or suitability for any
	purpose.


STATE

	- DRM state dump                                                     ok
	  DRM setup works - DRM shows some issues, still, GART
	  texture space has a wrong GPU address assigned, etc.
	- GPU state dump                                                     ok
	- CP setup + test                                        '.'         ok
	- CPU based clear screen                                 'c'         ok
	- More extensive CP tests                                'p'         ok
	- PM4 dump tests                                         'w' 'W' 'b' ok
	- Triangle tests                                         't' 'T'     ok
	- Texturing tests                                        'q'         ok
	- GPU reset                                              'r'         ok
	- EXA tests                                              'e' 'E'     ok
	- Register dump                                          <range>     ok
	- Register setting                                       <reg>=<val> ok
	- Various test                                           'x'         unknown

	Tested on R600, RV610, RV620, RV630, RV635, RV670, RV710, RV730, RV770


SETUP:

	Requirements:

	- r600_demo from git://anongit.freedesktop.org/git/mesa/r600_demo

	- An r6xx or r7xx card, testing happens mostly on
	  RV610, RV670, and RV770. R600 is probably the least supported.

	- Install + configure radeonhd:
	  Get the latest driver (1.2.4 is good enough). Explicitly enable
	  DRI and disable 2D acceleration:

	  Option "DRI"
	  Option "AccelMethod" "none"

	- Install DRM:
	  Get and install the r6xx-r7xx-support branch of DRM.


RUNNING:

	- Run the Xserver. No additional clients needed (r600_demo is not an X
	  client, so no server reset occurs).
	- Call r600_demo on the same machine as root(!).

	./r600_demo

	  This will print out the usage, including all options.

	./r600_demo ""

	  This will print out the state of DRM and the graphics card
	  (busy flags + ring and buffer states). Add '-v' to get a list of all
	  mapped memory regions and a more verbose state output.

	./r600_demo pc

	  Will test the CP, and clear the screen.

	./r600_demo t

	  Draws two Gouraud shaded triangles.

	./r600_demo r

	  This resets the engine. "./r600_demo rct" is a typical call, because
	  the 't' and 'q' tests do not invaldiate the shaders correctly yet.

	./r600_demo rcqE

	  Draws a textured quad, and then invokes the EXA copy test, which
	  copies the top left corner 3 times.

	./r600_demo "" 30000-3001c

	  Register dump: prints out the first two ALU constants
	  (SQ_ALU_CONSTANT0_0 - SQ_ALU_CONSTANT3_1). Any number of single
	  registers and ranges allowed.
	  You can lock up the whole machine when accessing non-existent
	  register space, so beware.

	make dump

	  Create a register dump of known registers.