Changes

Jump to navigation Jump to search

GSP Shared Memory (edit)

Revision as of 05:12, 11 December 2015

2,528 bytes added ,  05:12, 11 December 2015
m
→‎Trigger Command List Processing
Line 1: Line 1:  
This page describes the structure of the GSP [[GSPGPU:RegisterInterruptRelayQueue|shared]] memory. GX commands and framebuffer info is stored here, and other unknown data.
 
This page describes the structure of the GSP [[GSPGPU:RegisterInterruptRelayQueue|shared]] memory. GX commands and framebuffer info is stored here, and other unknown data.
 +
 +
 +
=Interrupt info=
 +
The Interrupt info structure is located at sharedmemvadr + process_gsp_index*0x40.
 +
 +
It is a list of interrupts (id's 0-6 exist).
 +
 +
{| class="wikitable" border="1"
 +
|-
 +
!  Index Byte
 +
!  Description
 +
|-
 +
| 0x0
 +
| Index of the last processed data (field size is 0x33) (must be updated manually)
 +
|-
 +
| 0x1
 +
| To be processed datafields, (max 0x20 for PDC interrupts else the missed PDC filds are used,max 0x34 for all other if more interrupts happen and the Errorflag is 0 the Errorflag is set to 1)
 +
|-
 +
| 0x2
 +
| Errorflag (if the first bit of Errorflag is set future PDC interrupts are ignored)
 +
|-
 +
| 0x3
 +
| not used
 +
|-
 +
| 0x4-0x7
 +
| missed PDC0
 +
|-
 +
| 0x8-0xB
 +
| missed PDC1
 +
|-
 +
| 0xC-0x3F
 +
| u8 Interrupttypefield (0=PSC0, 1=PSC1, 2=PDC0/VBlankTop (sent to all threads), 3=PDC1/VBlankBottom (sent to all threads), 4=PPF, 5=P3D, 6=DMA)
 +
|}
    
=Framebuffer info=
 
=Framebuffer info=
Line 24: Line 57:  
The two 0x1C-byte framebuffer info entries are located at framebufferinfo+4.
 
The two 0x1C-byte framebuffer info entries are located at framebufferinfo+4.
   −
=3D Slider=
+
=3D Slider and 3D [[GSPGPU:SetLedForceOff|LED]]=
 
See [[Configuration Memory]].
 
See [[Configuration Memory]].
    
=Command Buffer Header=
 
=Command Buffer Header=
 +
 +
The command buffer is located at sharedmem + 0x800 + [[GSPGPU:RegisterInterruptRelayQueue|threadindex]]*0x200. After writing the command data to shared memory, [[GSPGPU:TriggerCmdReqQueue|TriggerCmdReqQueue]] must be used to trigger GSP processing for the command when the total commands field is value 1.
 +
 
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
 
|-
 
|-
Line 48: Line 84:  
|  u32 Error code for the last GX command which failed
 
|  u32 Error code for the last GX command which failed
 
|}
 
|}
−
  −
The command buffer is located at sharedmem + 0x800 + [[GSPGPU:RegisterInterruptRelayQueue|threadindex]]*0x200. After writing the command data to shared memory, [[GSPGPU:TriggerCmdReqQueue|TriggerCmdReqQueue]] must be used to trigger GSP processing for the command when the total commands field is value 1.
      
=Command Header=
 
=Command Header=
Line 71: Line 105:  
=Commands=
 
=Commands=
   −
==GX RequestDma==
+
== Trigger DMA Request ==
 
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
 
|-
 
|-
Line 89: Line 123:  
| Size
 
| Size
 
|-
 
|-
−
| 7-4
+
| 6-4
 
| Unused
 
| Unused
 +
|-
 +
| 7
 +
| Flush source (0 = don't flush, 1 = flush)
 
|}
 
|}
   −
This command is normally used to DMA data from the application GSP [[Memory_layout|heap]] to VRAM.
+
This command is normally used to DMA data from the application GSP [[Memory_layout|heap]] to VRAM. When flushing is enabled and the source buffer is not located within VRAM, svcFlushProcessDataCache is used to flush the source buffer.
   −
==GX SetCommandList Last==
+
== Trigger Command List Processing ==
 
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
 
|-
 
|-
Line 111: Line 148:  
|-
 
|-
 
| 3
 
| 3
−
| Flag, bit0 is written to GSP module state
+
| Update gas additive blend results (0 = don't update, 1 = update)
 
|-
 
|-
 
| 6-4
 
| 6-4
Line 117: Line 154:  
|-
 
|-
 
| 7
 
| 7
−
| When non-zero, call svcFlushProcessDataCache() with the specified buffer
+
| Flush buffer (0 = don't flush, 1 = flush)
 
|}
 
|}
   −
This command converts the specified address to a physical address, then writes the physical address and size to the [[GPU]] registers at 0x1EF018E0. This buffer contains [[GPU_Commands|GPU commands]].
+
This command converts the specified address to a physical address, then writes the physical address and size to the [[GPU]] registers at 0x1EF018E0. This buffer contains [[GPU/Internal_Registers|GPU commands]]. When flushing is enabled, svcFlushProcessDataCache is used to flush the buffer.
   −
==GX SetMemoryFill==
+
== Trigger Memory Fill ==
 
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
 
|-
 
|-
Line 132: Line 169:  
|-
 
|-
 
| 1
 
| 1
−
| Buf0 address
+
| Buf0 start address (0 = don't fill anything)
 
|-
 
|-
 
| 2
 
| 2
−
| Buf0 size
+
| Buf0 value
 
|-
 
|-
 
| 3
 
| 3
−
| Buf0 data
+
| Buf0 end address
 
|-
 
|-
 
| 4
 
| 4
−
| Buf1 address
+
| Buf1 start address (0 = don't fill anything)
 
|-
 
|-
 
| 5
 
| 5
−
| Buf1 size
+
| Buf1 value
 
|-
 
|-
 
| 6
 
| 6
−
| Buf1 data
+
| Buf1 end address
 
|-
 
|-
 
| 7
 
| 7
−
| The low u16 is width0, while the high u16 is width1
+
| Control0 <nowiki>|</nowiki> (Control1 << 16)
 
|}
 
|}
   −
This commands converts the specified addresses to physical addresses, then writes these addresses and the specified parameters to the [[GPU]] registers at 0x1EF00010 and 0x1EF00020. The associated buffer address must not be <= to the main buffer address, thus the associated buffer address must not be zero as well. When the bufX address is zero, processing for the bufX parameters is skipped.
+
This command converts the specified addresses to physical addresses, then writes these addresses and the specified parameters to the [[GPU]] registers at 0x1EF00010 and 0x1EF00020. Doing so fills the specified buffers with the associated 4-byte value. This is used to clear GPU framebuffers.
 +
The associated buffer address must not be <= to the main buffer address, thus the associated buffer address must not be zero as well. When the bufX address is zero, processing for the bufX parameters is skipped.
   −
==GX SetDisplayTransfer==
+
The values of Control0 and Control1 give information about the type of memory fill. See [[GPU/External_Registers#Memory Fill|here]] for more information about memory fill parameters.
 +
 
 +
== Trigger Display Transfer ==
 
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
 
|-
 
|-
Line 183: Line 223:  
|}
 
|}
   −
This command converts the specified addresses to physical addresses, then writes these physical addresses and parameters to the [[GPU]] registers at 0x1EF00C00. This command writes the rendered framebuffer data from the input framebuffer address to the specified output framebuffer. The input framebuffer is normally located in VRAM.
+
This command converts the specified addresses to physical addresses, then writes these physical addresses and parameters to the [[GPU]] registers at 0x1EF00C00. This GPU command copies the already rendered framebuffer data from the input GPU framebuffer address to the specified output LCD framebuffer. The input framebuffer is normally located in VRAM.
 +
 
 +
The GPU color buffer is stored in the same Z-curve (tiled) format as textures. By default, SetDisplayTransfer converts the given buffer from the tiled format to a linear format adapted to the LCD framebuffers.
 +
 
 +
Display transfers are performed asynchronously, so after requesting a display transfer you should wait for the PPF interrupt to fire before reading the output data.
 +
 
 +
Some color formats seem to require specific input / output sizes when performing a display transfer, doing an RGB5A1->RGBA4 display transfer would never fire the PPF interrupt with a 32x32 buffer, increasing the buffer to 128x128 made it fire correctly.
   −
==GX SetTextureCopy==
+
== Trigger Texture Copy ==
 
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
 
|-
 
|-
Line 195: Line 241:  
|-
 
|-
 
| 1
 
| 1
−
| Buf0 address
+
| Input buffer address.
 
|-
 
|-
 
| 2
 
| 2
−
| Buf1 address
+
| Output buffer address.
 
|-
 
|-
 
| 3
 
| 3
−
| Size?
+
| Total bytes to copy, not including gaps.
 
|-
 
|-
 
| 4
 
| 4
−
| Buf0 [[GPU|dimensions]]?
+
| Bits 0-15: Size of input line, in bytes. Bits 16-31: Gap between input lines, in bytes.
 
|-
 
|-
 
| 5
 
| 5
−
| Buf1 dimensions?
+
| Same as 4, but for the output.
 
|-
 
|-
 
| 6
 
| 6
−
| Flags, normally this is 0x8, with bit2 optionally set when either of the dimensions fields are set.
+
| Flags, corresponding to the [[GPU/External_Registers#Transfer_Engine|Transfer Engine flags]]. However, for TextureCopy commands, bit 3 is always set, bit 2 is set if any output dimension is smaller than the input, and other bits are always 0.
 
|-
 
|-
 
| 7
 
| 7
Line 216: Line 262:  
|}
 
|}
   −
This command is similar to cmd3, this command also writes to the [[GPU]] registers at 0x1EF00C00.
+
This command is similar to cmd3. It also triggers the [[GPU/External_Registers#Transfer_Engine|GPU Transfer Engine]], but setting the TextureCopy parameters.
   −
==GX SetCommandList First ==
+
== Flush Cache Regions ==
 
{| class="wikitable" border="1"
 
{| class="wikitable" border="1"
 
|-
 
|-
Steveice10
1,434

edits

Retrieved from "https://www.3dbrew.org/wiki/Special:MobileDiff/5610...14966"

Navigation menu