GPU/Commands - Revision history

Steveice10: Replaced content with "Merged with GPU/Internal_Registers"

2015-12-05T06:06:41Z

Replaced content with "Merged with GPU/Internal_Registers"

← Older revision		Revision as of 09:06, 5 December 2015
Line 1:		Line 1:
	This page describes the structure of the buffer submitted via the registers at [[GPU\|0x1EF018E0]] (or equivalently via [[GSP_Shared_Memory\|GX command]] 1). This buffer is used for GPU commands including functionality equivalent to OpenGL commands.		Merged with [[GPU/Internal_Registers]]

	~~=== Overview ===~~
	Each command is at least 8 bytes wide. The first word is the command parameter and the second word constitutes the command header. Optionally, more parameter words may follow (potentially including a padding word to align commands to multiples of 8 bytes).

	In the simplest case, a command is exactly 8 bytes wide. You can think of such a command as writing the parameter word to an internal register (the index of which is given in the command header). The more general case where more than one parameter word is given is equivalent to multiple simple commands (one for each parameter word). If consecutive writing mode is enabled in the command header, the current command index will be incremented after each parameter write. Otherwise, the parameters will be consecutively written to the same register.

	~~For example, the sequence "0xAAAAAAAA 0x802F011C 0xBBBBBBBB 0xCCCCCCCC" is equivalent to a call to commands 0xF011C~~ with parameter 0xAAAAAAAA, 0xF011D with parameter 0xBBBBBBBB and 0xF011E with parameter 0xCCCCCCCC. If consecutive writing mode were disabled, the command would be equivalent to three consecutive calls to 0xF011C (once with parameter 0xAAAAAAAA, once with 0xBBBBBBBB, and finally with 0xCCCCCCCC).

	~~Invalid GPU command parameters including NaN floats can cause the GPU to hang, which then causes the GSP module to hang as well.~~

	The size of GPU command buffers must be 0x10-byte aligned; the lower 3 bits of the size are cleared. A common pitfall is having the finalization command (write to register 0x0010) not executed because it was the last 8 bytes of a non-0x10 byte aligned command buffer, and having the GPU hang as a result.

	~~=== Command Header ===~~
	~~{\| class="wikitable" border="1"~~
	~~! Bit~~
	~~! Description~~
	\|-
	~~\| 15-0~~
	~~\| Command ID~~
	\|-
	~~\| 19-16~~
	~~\| Parameter mask~~
	\|-
	~~\| 30-20~~
	~~\| Number of extra parameters (may be zero)~~
	\|-
	~~\| 31~~
	~~\| Consecutive writing mode~~
	\|}

	~~=== Parameter masking ===~~

	Using a value other than 0xF, parts of a word in internal GPU memory can be updated without touching the other bits of it. For example, setting bit 16 to zero indicates that the least significant byte of the parameter will not be overwritten, setting bit 17 to zero indicates that the parameter's second LSB will not be overwritten, etc. This means that for instance commands 0x00010107 and 0x00020107 refer to the same thing but write different parts of the parameter.

	~~=== Command IDs ===~~

	~~See~~ [[GPU/Internal_Registers~~]].~~

	~~[[Category:GPU~~]]

Steveice10: moved GPU Commands to GPU/Commands

2015-12-05T03:42:08Z

moved GPU Commands to GPU/Commands

← Older revision		Revision as of 06:42, 5 December 2015
(No difference)

Steveice10 at 04:37, 5 December 2015

2015-12-05T03:37:07Z

Show changes

Steveice10 at 04:31, 5 December 2015

2015-12-05T03:31:40Z

← Older revision		Revision as of 06:31, 5 December 2015
Line 104:		Line 104:
	\| 0x0081		\| 0x0081
	\|		\|
	\| This is used to set the current texture info used for rendering~~, see command set [[GPU_Textures\|0x0081]]~~.		\| This is used to set the current texture info used for rendering.
	\|-		\|-
	\| 0x008E		\| 0x008E
	\| u32 color type		\| u32 color type
	\| This command sets the texture color type~~, see command set [[GPU_Textures\|0x0081]]~~.		\| This command sets the texture color type.
	\|-		\|-
	\| 0x0091		\| 0x0091
	\|		\|
	\| This sets current texture info~~, see command [[GPU_Textures\|0x0091]]~~.		\| This sets current texture info.
	\|-		\|-
	\| 0x0099		\| 0x0099
	\|		\|
	\| This sets current texture info~~, see command [[GPU_Textures\|0x0099]]~~.		\| This sets current texture info.
	\|-		\|-
	\| 0x00C3		\| 0x00C3
Line 440:		Line 440:

	===== Command 0x0081 =====		===== Command 0x0081 =====
	This sets current texture info~~, see [[GPU Textures\|GPU textures]]~~.		This sets current texture info.

	===== Command 0x0065 =====		===== Command 0x0065 =====

Cruel: Add combiner function definitions

2015-09-14T03:27:48Z

Add combiner function definitions

← Older revision		Revision as of 07:27, 14 September 2015
Line 1,117:		Line 1,117:
	\|-		\|-
	\| 0x8		\| 0x8
	\| ?		\| None: SRC0 × SRC1 + SRC2
	\|-		\|-
	\| 0x9		\| 0x9
	\| ?		\| None: (SRC0 + SRC1 clamped [0,1] range) × SRC2
	\|}		\|}

Line 1,150:		Line 1,150:
	\|-		\|-
	\| 0x7		\| 0x7
	\| ~~GL_DOT3_RGB~~		\| GL_DOT3_RGBA
	\|-		\|-
	\| 0x8		\| 0x8
	\| ?		\| None: SRC0 × SRC1 + SRC2
	\|-		\|-
	\| 0x9		\| 0x9
	\| ?		\| None: (SRC0 + SRC1 clamped [0,1] range) × SRC2
	\|}		\|}

			Note: Inputs and outputs of combiner stages are clamped to [0,1].

	==== Param4 format for command 0x00C0 ====		==== Param4 format for command 0x00C0 ====

Subv: /* Parameter value format for command 0x0106 */

2015-08-21T13:59:09Z

Parameter value format for command 0x0106

← Older revision		Revision as of 17:59, 21 August 2015
Line 1,465:		Line 1,465:
	\|-		\|-
	\| 1		\| 1
	\| ~~unknown~~		\| 0
	\|		\| GL_ZERO
	\|-		\|-
	\| 2		\| 2
Line 1,485:		Line 1,485:
	\|-		\|-
	\| 6		\| 6
	\| ~~unknown~~		\| old_stencil + 1
	\|		\| GL_INCR_WRAP
	\|-		\|-
	\| 7		\| 7
	\| ~~unknown~~		\| old_stencil - 1
	\|		\| GL_DECR_WRAP
	\|}		\|}

Subv: /* Parameter value format for command 0x0106 */

2015-08-19T02:09:29Z

Parameter value format for command 0x0106

← Older revision		Revision as of 06:09, 19 August 2015
Line 1,473:		Line 1,473:
	\|-		\|-
	\| 3		\| 3
	\| ~~max~~(old_stencil + 1, 255)		\| min(old_stencil + 1, 255)
	\| GL_INCR		\| GL_INCR
	\|-		\|-
	\| 4		\| 4
	\| ~~min~~(old_stencil - 1, 0)		\| max(old_stencil - 1, 0)
	\| GL_DECR		\| GL_DECR
	\|-		\|-

Subv: /* Parameter value format for command 0x0106 */

2015-08-19T02:07:28Z

Parameter value format for command 0x0106

← Older revision		Revision as of 06:07, 19 August 2015
Line 1,458:		Line 1,458:
	! Value		! Value
	! Final stencil value		! Final stencil value
			! OpenGL equivalent
	\|-		\|-
	\| 0		\| 0
	\| ~~destination~~		\| old_stencil
			\| GL_KEEP
	\|-		\|-
	\| 1		\| 1
	\| ~~destination & ~source~~		\| unknown
			\|
	\|-		\|-
	\| 2		\| 2
	\| ~~same as 1~~		\| reference
			\| GL_REPLACE
	\|-		\|-
	\| 3		\| 3
	\| ~~Weird operation.~~		\| max(old_stencil + 1, 255)
			\| GL_INCR
	\|-		\|-
	\| 4		\| 4
	\| ~~Weird operation. TODO: find out what it is exactly.~~		\| min(old_stencil - 1, 0)
			\| GL_DECR
	\|-		\|-
	\| 5		\| 5
	\| ~~destination ^ source~~		\| ~old_stencil
			\| GL_INVERT
	\|-		\|-
	\| 6		\| 6
	\| ~~Another weird operation.~~		\| unknown
			\|
	\|-		\|-
	\| 7		\| 7
	\| ~~same as 4~~		\| unknown
			\|
	\|}		\|}
	'~~destination~~' is the value present in the stencil buffer, '~~source~~' is the ~~replacement~~ value specified in command 0x0105.
			'old_stencil' is the value present in the stencil buffer, 'reference' is the reference value specified in command 0x0105.

	=== Parameter structure for command 0x004D ===		=== Parameter structure for command 0x004D ===

Subv: /* Parameter value format for command 0x0105 */

2015-08-19T02:03:48Z

Parameter value format for command 0x0105

← Older revision		Revision as of 06:03, 19 August 2015
Line 1,429:		Line 1,429:
	\|-		\|-
	\| 15-8		\| 15-8
	\| ~~Replacement value, used as specified by command 0x0106~~		\| Stencil buffer write mask
	\|-		\|-
	\| 23-16		\| 23-16

Yuriks: Add to GPU category

2015-08-14T17:07:07Z

Add to GPU category

← Older revision		Revision as of 21:07, 14 August 2015
Line 1,656:		Line 1,656:

	The matrices for types 0x00 and 0x04 use row-major order, instead of column-major order.		The matrices for types 0x00 and 0x04 use row-major order, instead of column-major order.

			[[Category:GPU]]