https://www.3dbrew.org/w/api.php?action=feedcontributions&feedformat=atom&user=Merry
3dbrew - User contributions [en]
2026-04-04T14:02:14Z
User contributions
MediaWiki 1.43.1
https://www.3dbrew.org/w/index.php?title=ARM7_Registers&diff=21512
ARM7 Registers
2021-04-12T09:39:27Z
<p>Merry: </p>
<hr />
<div>The 3DS utilizes an onboard ARM7 core to handle <code>TWL_FIRM</code> and <code>AGB_FIRM</code>'s ARM7 requirements. This is due to the fact that much of the hardware used by both ARM7 and ARM9 is (evidently) not physically hooked up to ARM11. Thus, ARM11 cannot simply emulate ARM7.<br />
<br />
ARM7 has the GBA BIOS implemented in hardware. The BIOS is completely identical to the original GBA BIOS. The system is booted silently by calling <code>SWI 0x1</code> (a.k.a. <code>RegisterRamReset</code>), followed by jumping to the code that does <code>SWI 0x0</code> (a.k.a. <code>SoftReset</code>) to finish booting. The boot splash is still in BIOS, however, and can be seen by calling or replacing one of the previous interrupts with <code>SWI 0x26</code> (a.k.a. <code>HardReset</code>).<br />
<br />
==Registers==<br />
ARM9 interfaces with the ARM7 through the following registers:<br />
<br />
{| class="wikitable"<br />
|-<br />
! Type<br />
! Address<br />
! Name<br />
! Size (bytes)<br />
|-<br />
| <code>u8</code><br />
| <code>0x10018000</code><br />
| <code>ARM7_CNT</code><br />
| 1 <br />
|-<br />
| Code<br />
| <code>0x10018080</code><br />
| <code>ARM7_CODE</code><br />
| 32<br />
|-<br />
| <code>u16</code><br />
| <code>0x10018100</code><br />
| <code>ARM7_SAVE_MODE</code><br />
| 2<br />
|-<br />
| <code>u16</code><br />
| <code>0x10018104</code><br />
| <code>ARM7_SAVE_MEMORY_CNT</code><br />
| 2<br />
|-<br />
| <code>u16</code><br />
| <code>0x10018108</code><br />
| <code>ARM7_RTC_CNT</code><br />
| 2<br />
|-<br />
| <code>u32</code><br />
| <code>0x10018110</code><br />
| <code>ARM7_RTC_VAL_DATE</code><br />
| 4<br />
|-<br />
| <code>u32</code><br />
| <code>0x10018114</code><br />
| <code>ARM7_RTC_VAL_TIME</code><br />
| 4<br />
|-<br />
| <code>u32</code><br />
| <code>0x10018118</code><br />
| <code>ARM7_RTC_VAL_SETTINGS</code><br />
| 4<br />
|-<br />
| <code>u32</code><br />
| <code>0x1001811C</code><br />
| <code>ARM7_RTC_VAL_ADJUST</code><br />
| 4<br />
|-<br />
| <code>u32</code><br />
| <code>0x10018120</code><br />
| <code>ARM7_SAVE_FLASH_CHIP_ERASE_CYCLES</code><br />
| 4<br />
|-<br />
| <code>u32</code><br />
| <code>0x10018124</code><br />
| <code>ARM7_SAVE_FLASH_SECTOR_ERASE_CYCLES</code><br />
| 4<br />
|-<br />
| <code>u32</code><br />
| <code>0x10018128</code><br />
| <code>ARM7_SAVE_FLASH_PROGRAM_CYCLES</code><br />
| 4<br />
|-<br />
| <code>u32</code><br />
| <code>0x1001812C</code><br />
| <code>ARM7_SAVE_EEPROM_WRITE_CYCLES</code><br />
| 4<br />
|}<br />
<br />
===ARM7_CNT===<br />
This seems to control the mode of the ARM7. 1 = TWL, 2 = GBA.<br />
<br />
===ARM7_CODE===<br />
This region is an arm7 bootrom overlay, over the vector table at address 0. Once the ARM7 is taken out of reset by <code>TwlProcess9</code>, the reset vector will be jumped to, beginning execution. <code>TwlProcess9</code> uses this to put ARM7 in a loop (TWL), and to set the <code>POSTFLG</code> and branch to more copied code (GBA). Execution is started by writing <code>0x8001</code> to [[PDN_Registers#LGY_MODE|LGY_MODE]] after setting the mode via <code>ARM7_CNT</code>. Later, this overlay is disabled by the ARM7 via the "biosprot" register (0x04000308).<br />
<br />
Reading uninitialized data in this 32-byte region leads to both screens displaying solid green (exception), and the CPU locking up.<br />
<br />
===ARM7_SAVE_MODE===<br />
This tells the save storage emulation hardware which device type to emulate (64k EEPROM, a 512k Flash chip model, and SRAM are all that have been used officially; several other 512k Flash chip models, two 1 Mbit Flash chip models and 4k EEPROM are also supported). This comes directly from the [[3DS_Virtual_Console#Footer|ROM footer]].<br />
<br />
===ARM7_SAVE_MEMORY_CNT===<br />
This register controls whether the GBA save memory region located at <code>0x08080000</code> is accessible to ARM9 or to the ARM7 (via the emulated save chip). When it's set to 0x0 ARM7 has access, while ARM9 has access when it's set to 0x1.<br />
<br />
===ARM7_RTC_CNT===<br />
This register controls the emulated RTC hardware and access to some of its registers.<br />
To set or read the data from ARM7_RTC_VAL_SETTINGS or ARM7_RTC_VAL_ADJUST, first <code>ARM7_RTC_CNT</code>'s bit 15 is waited on. Next <code>ARM7_RTC_CNT</code> is set to zero. <br />
<br />
For a write: the two registers are written, a 1 is written to <code>ARM7_RTC_CNT</code>, and it is waited on the same as before. Afterwards if bit 14 is not set in <code>ARM7_RTC_CNT</code>, the value was set successfully. This also starts the emulated RTC.<br />
<br />
For a read: a 2 is written to <code>ARM7_RTC_CNT</code>, it's waited on again. Afterwards, if bit 14 is not set, the aforementioned registers can be read. Presumably the hardware can be re-enabled by writing a zero to <code>ARM7_RTC_CNT</code> at this point, but <code>AGB_FIRM</code> does not.<br />
<br />
===ARM7_RTC_VAL_DATE / ARM7_RTC_VAL_TIME===<br />
These registers are set to the current LgyP9 date+time before the other RTC-related registers are used.<br />
They contain the following structure, set up on the stack then both u32 registers are written one after the other:<br />
<br />
s8 year_since_2000_bcd;<br />
s8 month_bcd;<br />
s8 day_bcd;<br />
s8 day_of_week;<br />
s8 hour_bcd;<br />
s8 minute_bcd;<br />
s8 second_bcd;<br />
<br />
===ARM7_RTC_VAL_SETTINGS===<br />
This register appears to contain the emulated RTC chip's configuration (accessible via the "control" register on real hardware), containing settings like 12/24-hour mode. Access is controlled by <code>ARM7_RTC_CNT</code> (see above).<br />
<br />
===ARM7_RTC_VAL_ADJUST===<br />
This register appears to contain the emulated RTC chip's time difference, relative to <code>ARM7_RTC_VAL_DATE</code> / <code>ARM7_RTC_VAL TIME</code>, in seconds. Access is controlled by <code>ARM7_RTC_CNT</code> (see above).<br />
<br />
===ARM7_SAVE_FLASH_CHIP_ERASE_CYCLES===<br />
This register seems to configure the emulated Flash chip to take a specified amount of time to complete a chip erase operation (relative to the DS' ARM7/bus speed). Two variations exist in officially released games, one meant for 512k Flash chips and one for 1 Mbit Flash chips. It is copied from from rom footer + <code>0x10</code>.<br />
<br />
===ARM7_SAVE_FLASH_SECTOR_ERASE_CYCLES===<br />
This register seems to configure the emulated Flash chip to take a specified amount of time to complete a sector erase operation (relative to the DS' ARM7/bus speed). Two variations exist in officially released games, one meant for 512k Flash chips and one for 1 Mbit Flash chips. It is copied from from rom footer + <code>0x14</code>.<br />
<br />
===ARM7_SAVE_FLASH_PROGRAM_CYCLES===<br />
This register seems to configure the emulated Flash chip to take a specified amount of time to complete a program operation (relative to the DS' ARM7/bus speed). Two variations exist in officially released games, one meant for 512k Flash chips and one for 1 Mbit Flash chips. It is copied from from rom footer + <code>0x18</code>.<br />
<br />
===ARM7_SAVE_EEPROM_WRITE_CYCLES===<br />
This register seems to configure the emulated EEPROM chip to take a specified amount of time to complete a write operation (relative to the DS' ARM7/bus speed). Two variations exist in officially released games, one meant for 64k EEPROM chips and one for 4k EEPROM chips. It is copied from from rom footer + <code>0x1C</code>.<br />
<br />
==Memory map==<br />
The virtual memory mapping for the ARM7 is the same as for the [[Memory_layout#TWL_FIRM_Userland_Memory|other core]]. However, it has additional internal memory mapped to it. Interestingly enough, much of this memory seems to lie within ARM9's own internal memory.<br />
<br />
* <code>0x08060000</code> → <code>0x03800000</code>, ARM7 WRAM (64KiB)<br />
* <code>0x080B0000</code> → <code>0x03000000</code>, GBA IWRAM (32KiB)<br />
* <code>0x08080000</code> → EEPROM/SRAM/Flash 512k/Flash 1Mbit (the 2 512k banks are contiguous in memory). Access is controlled by <code>ARM7_SAVE_MEMORY_CNT</code> (see above). <code>0x080C0000</code> holds a mirror which is used by LgyP9 on boot to read the SD savedata before the mode switch, the data is then copied.<br />
* <code>0x01FFC000</code> → <code>0x01000000</code>, ARM9 ITCM under TWL (16KiB)</div>
Merry
https://www.3dbrew.org/w/index.php?title=GPU/Shader_Instruction_Set&diff=20524
GPU/Shader Instruction Set
2017-12-28T17:49:22Z
<p>Merry: clarified constant</p>
<hr />
<div>[[Category:GPU]]<br />
<br />
== Overview ==<br />
A compiled shader binary is comprised of two parts : the main instruction sequence and the operand descriptor table. These are both sent to the GPU around the same time but using separate [[GPU/Internal_Registers|GPU Commands]]. Instructions (such as format 1 instruction) may reference operand descriptors. When such is the case, the operand descriptor ID is the offset, in words, of the descriptor within the table.<br />
Both instructions and descriptors are coded in little endian.<br />
Basic implementations of the following specification can be found at [https://github.com/smealum/aemstro] and [https://github.com/neobrain/nihstro].<br />
The instruction set seems to have been heavily inspired by Microsoft's vs_3_0 [http://msdn.microsoft.com/en-us/library/windows/desktop/bb172938%28v=vs.85%29.aspx] and the Direct3D shader code [https://msdn.microsoft.com/en-us/library/windows/hardware/ff552891%28v=vs.85%29.aspx].<br />
Please note that this page is being written as the instruction set is reverse engineered; as such it may very well contain mistakes.<br />
<br />
Debug information found in the code.bin of "Ironfall: Invasion" suggests that there may not be more than 512 instructions and 128 operand descriptors in a shader.<br />
<br />
== Nomenclature ==<br />
<br />
* opcode names with I appended to them are the same as their non-I version, except they use the inverted instruction format, giving 7 bits to SRC2 (and access to uniforms) and 5 bits to SRC1<br />
<br />
* opcode names with U appended to them are the same as their non-U version, except they are executed conditionally based on the value of a uniform boolean.<br />
<br />
* opcode names with C appended to them are the same as their non-C version, except they are executed conditionally based on a logical expression specified in the instruction.<br />
<br />
== Instruction formats ==<br />
<br />
Format 1 : (used for register operations)<br />
{| class="wikitable" border="1"<br />
|-<br />
! Offset<br />
! Size (bits)<br />
! Description<br />
|-<br />
| 0x0<br />
| 0x7<br />
| Operand descriptor ID (DESC)<br />
|-<br />
| 0x7<br />
| 0x5<br />
| Source 2 register (SRC2)<br />
|-<br />
| 0xC<br />
| 0x7<br />
| Source 1 register (SRC1)<br />
|-<br />
| 0x13<br />
| 0x2<br />
| Address register index for SRC1 (IDX_1)<br />
|-<br />
| 0x15<br />
| 0x5<br />
| Destination register (DST)<br />
|-<br />
| 0x1A<br />
| 0x6<br />
| Opcode<br />
|}<br />
<br />
Format 1i : (used for register operations)<br />
{| class="wikitable" border="1"<br />
|-<br />
! Offset<br />
! Size (bits)<br />
! Description<br />
|-<br />
| 0x0<br />
| 0x7<br />
| Operand descriptor ID (DESC)<br />
|-<br />
| 0x7<br />
| 0x7<br />
| Source 2 register (SRC2)<br />
|-<br />
| 0xE<br />
| 0x5<br />
| Source 1 register (SRC1)<br />
|-<br />
| 0x13<br />
| 0x2<br />
| Address register index for SRC2 (IDX_2)<br />
|-<br />
| 0x15<br />
| 0x5<br />
| Destination register (DST)<br />
|-<br />
| 0x1A<br />
| 0x6<br />
| Opcode<br />
|}<br />
<br />
Format 1u : (used for unary register operations)<br />
{| class="wikitable" border="1"<br />
|-<br />
! Offset<br />
! Size (bits)<br />
! Description<br />
|-<br />
| 0x0<br />
| 0x7<br />
| Operand descriptor ID (DESC)<br />
|-<br />
| 0xC<br />
| 0x7<br />
| Source 1 register (SRC1)<br />
|-<br />
| 0x13<br />
| 0x2<br />
| Address register index for SRC1 (IDX_1)<br />
|-<br />
| 0x15<br />
| 0x5<br />
| Destination register (DST)<br />
|-<br />
| 0x1A<br />
| 0x6<br />
| Opcode<br />
|}<br />
<br />
Format 1c : (used for comparison operations)<br />
{| class="wikitable" border="1"<br />
|-<br />
! Offset<br />
! Size (bits)<br />
! Description<br />
|-<br />
| 0x0<br />
| 0x7<br />
| Operand descriptor ID (DESC)<br />
|-<br />
| 0x7<br />
| 0x5<br />
| Source 2 register (SRC2)<br />
|-<br />
| 0xC<br />
| 0x7<br />
| Source 1 register (SRC1)<br />
|-<br />
| 0x13<br />
| 0x2<br />
| Address register index for SRC1 (IDX_1)<br />
|-<br />
| 0x15<br />
| 0x3<br />
| Comparison operator for Y (CMPY)<br />
|-<br />
| 0x18<br />
| 0x3<br />
| Comparison operator for X (CMPX)<br />
|-<br />
| 0x1B<br />
| 0x5<br />
| Opcode<br />
|}<br />
<br />
Format 2 : (used for flow control instructions)<br />
{| class="wikitable" border="1"<br />
|-<br />
! Offset<br />
! Size (bits)<br />
! Description<br />
|-<br />
| 0x0<br />
| 0x8<br />
| Number of instructions (NUM)<br />
|-<br />
| 0xA<br />
| 0xC<br />
| Destination offset (in words) (DST)<br />
|-<br />
| 0x16<br />
| 0x2<br />
| Condition boolean operator (CONDOP)<br />
|-<br />
| 0x18<br />
| 0x1<br />
| Y reference bit (REFY)<br />
|-<br />
| 0x19<br />
| 0x1<br />
| X reference bit (REFX)<br />
|-<br />
| 0x1A<br />
| 0x6<br />
| Opcode<br />
|}<br />
<br />
Format 3 : (used for uniform-based conditional flow control instructions)<br />
{| class="wikitable" border="1"<br />
|-<br />
! Offset<br />
! Size (bits)<br />
! Description<br />
|-<br />
| 0x0<br />
| 0x8<br />
| Number of instructions ? (NUM)<br />
|-<br />
| 0xA<br />
| 0xC<br />
| Destination offset (in words) (DST)<br />
|-<br />
| 0x16<br />
| 0x4<br />
| Uniform ID (BOOL/INT)<br />
|-<br />
| 0x1A<br />
| 0x6<br />
| Opcode<br />
|}<br />
<br />
Format 4 : (used for SETEMIT)<br />
{| class="wikitable" border="1"<br />
|-<br />
! Offset<br />
! Size (bits)<br />
! Description<br />
|-<br />
| 0x16<br />
| 0x1<br />
| Winding flag (FLAG_WINDING)<br />
|-<br />
| 0x17<br />
| 0x1<br />
| Primitive emit flag (FLAG_PRIMEMIT)<br />
|-<br />
| 0x18<br />
| 0x2<br />
| Vertex ID (VTXID)<br />
|-<br />
| 0x1A<br />
| 0x6<br />
| Opcode<br />
|}<br />
<br />
Format 5 : (used for MAD)<br />
{| class="wikitable" border="1"<br />
|-<br />
! Offset<br />
! Size (bits)<br />
! Description<br />
|-<br />
| 0x0<br />
| 0x5<br />
| Operand descriptor ID (DESC)<br />
|-<br />
| 0x5<br />
| 0x5<br />
| Source 3 register (SRC3)<br />
|-<br />
| 0xA<br />
| 0x7<br />
| Source 2 register (SRC2)<br />
|-<br />
| 0x11<br />
| 0x5<br />
| Source 1 register (SRC1)<br />
|-<br />
| 0x16<br />
| 0x2<br />
| Address register index for SRC2 (IDX_2)<br />
|-<br />
| 0x18<br />
| 0x5<br />
| Destination register (DST)<br />
|-<br />
| 0x1D<br />
| 0x3<br />
| Opcode<br />
|}<br />
<br />
Format 5i : (used for MADI)<br />
{| class="wikitable" border="1"<br />
|-<br />
! Offset<br />
! Size (bits)<br />
! Description<br />
|-<br />
| 0x0<br />
| 0x5<br />
| Operand descriptor ID (DESC)<br />
|-<br />
| 0x5<br />
| 0x7<br />
| Source 3 register (SRC3)<br />
|-<br />
| 0xC<br />
| 0x5<br />
| Source 2 register (SRC2)<br />
|-<br />
| 0x11<br />
| 0x5<br />
| Source 1 register (SRC1)<br />
|-<br />
| 0x16<br />
| 0x2<br />
| Address register index for SRC3 (IDX_3)<br />
|-<br />
| 0x18<br />
| 0x5<br />
| Destination register (DST)<br />
|-<br />
| 0x1D<br />
| 0x3<br />
| Opcode<br />
|}<br />
<br />
== Instructions ==<br />
Unless noted otherwise, SRC1 and SRC2 refer to their respectively indexed float[4] registers (after swizzling). Similarly, DST refers to its indexed register modulo destination component masking, i.e. an expression like DST=SRC1 might actually just set DST.y to SRC1.y.<br />
<br />
<br />
{| class="wikitable" border="1"<br />
|-<br />
! Opcode<br />
! Format<br />
! Name<br />
! Description<br />
|-<br />
| 0x00<br />
| 1<br />
| ADD<br />
| Adds two vectors component by component; DST[i] = SRC1[i]+SRC2[i] for all i<br />
|-<br />
| 0x01<br />
| 1<br />
| DP3<br />
| Computes dot product on 3-component vectors; DST = SRC1.SRC2<br />
|-<br />
| 0x02<br />
| 1<br />
| DP4<br />
| Computes dot product on 4-component vectors; DST = SRC1.SRC2<br />
|-<br />
| 0x03<br />
| 1<br />
| DPH<br />
| Computes dot product on a 3-component vector with 1.0 appended to it and a 4-component vector; DST = SRC1.SRC2 (with SRC1 homogenous)<br />
|-<br />
| 0x04<br />
| 1<br />
| DST<br />
| Equivalent to Microsoft's [https://msdn.microsoft.com/en-us/library/windows/desktop/bb219790.aspx dst] instruction: DST = {1, SRC1[1]*SRC2[1], SRC1[2], SRC2[3]}<br />
|-<br />
| 0x05<br />
| 1u<br />
| EX2<br />
| Computes SRC1's first component exponent with base 2; DST[i] = EXP2(SRC1[0]) for all i<br />
|-<br />
| 0x06<br />
| 1u<br />
| LG2<br />
| Computes SRC1's first component logarithm with base 2; DST[i] = LOG2(SRC1[0]) for all i<br />
|-<br />
| 0x07<br />
| 1u<br />
| LITP<br />
| Appears to be related to Microsoft's [https://msdn.microsoft.com/en-us/library/windows/desktop/bb174703.aspx lit] instruction; DST = clamp(SRC1, min={0, -127.9961, 0, 0}, max={inf, 127.9961, 0, inf}); n.b.: 127.9961 = 0x7FFF / 0x100<br />
|-<br />
| 0x08<br />
| 1<br />
| MUL<br />
| Multiplies two vectors component by component; DST[i] = SRC1[i].SRC2[i] for all i<br />
|-<br />
| 0x09<br />
| 1<br />
| SGE<br />
| Sets output if SRC1 is greater than or equal to SRC2; DST[i] = (SRC1[i] >= SRC2[i]) ? 1.0 : 0.0 for all i<br />
|-<br />
| 0x0A<br />
| 1<br />
| SLT<br />
| Sets output if SRC1 is strictly less than SRC2; DST[i] = (SRC1[i] < SRC2[i]) ? 1.0 : 0.0 for all i<br />
|-<br />
| 0x0B<br />
| 1u<br />
| FLR<br />
| Computes SRC1's floor component by component; DST[i] = FLOOR(SRC1[i]) for all i<br />
|-<br />
| 0x0C<br />
| 1<br />
| MAX<br />
| Takes the max of two vectors, component by component; DST[i] = MAX(SRC1[i], SRC2[i]) for all i<br />
|-<br />
| 0x0D<br />
| 1<br />
| MIN<br />
| Takes the min of two vectors, component by component; DST[i] = MIN(SRC1[i], SRC2[i]) for all i<br />
|-<br />
| 0x0E<br />
| 1u<br />
| RCP<br />
| Computes the reciprocal of the vector's first component; DST[i] = 1/SRC1[0] for all i<br />
|-<br />
| 0x0F<br />
| 1u<br />
| RSQ<br />
| Computes the reciprocal of the square root of the vector's first component; DST[i] = 1/sqrt(SRC1[0]) for all i<br />
|-<br />
| 0x10<br />
| ?<br />
| ???<br />
| ?<br />
|-<br />
| 0x11<br />
| ?<br />
| ???<br />
| ?<br />
|-<br />
| 0x12<br />
| 1u<br />
| MOVA<br />
| Move to address register; Casts the float uniform given by SRC1 to an integer (truncating the fractional part) and assigns the result to (a0.x, a0.y, _, _), respecting the destination component mask.<br />
|-<br />
| 0x13<br />
| 1u<br />
| MOV<br />
| Moves value from one register to another; DST = SRC1.<br />
|-<br />
| 0x14<br />
| ?<br />
| ???<br />
| ?<br />
|-<br />
| 0x15<br />
| ?<br />
| ???<br />
| ?<br />
|-<br />
| 0x16<br />
| ?<br />
| ???<br />
| ?<br />
|-<br />
| 0x17<br />
| ?<br />
| ???<br />
| ?<br />
|-<br />
| 0x18<br />
| 1i<br />
| DPHI<br />
| Computes dot product on a 3-component vector with 1.0 appended to it and a 4-component vector; DST = SRC1.SRC2 (with SRC1 homogenous)<br />
|-<br />
| 0x19<br />
| 1i<br />
| DSTI<br />
| DST with sources swapped.<br />
|-<br />
| 0x1A<br />
| 1i<br />
| SGEI<br />
| Sets output if SRC1 is greater than or equal to SRC2; DST[i] = (SRC1[i] >= SRC2[i]) ? 1.0 : 0.0 for all i<br />
|-<br />
| 0x1B<br />
| 1i<br />
| SLTI<br />
| Sets output if SRC1 is strictly less than SRC2; DST[i] = (SRC1[i] < SRC2[i]) ? 1.0 : 0.0 for all i<br />
|-<br />
| 0x1C<br />
| ?<br />
| ???<br />
| ?<br />
|-<br />
| 0x1D<br />
| ?<br />
| ???<br />
| ?<br />
|-<br />
| 0x1E<br />
| ?<br />
| ???<br />
| ?<br />
|-<br />
| 0x1F<br />
| ?<br />
| ???<br />
| ?<br />
|-<br />
| 0x20<br />
| 0<br />
| BREAK<br />
| Breaks out of LOOP block; do not use while in nested IF/CALL block inside LOOP block.<br />
|-<br />
| 0x21<br />
| 0<br />
| NOP<br />
| Does literally nothing.<br />
|-<br />
| 0x22<br />
| 0<br />
| END<br />
| Signals the shader unit that processing for this vertex/primitive is done.<br />
|-<br />
| 0x23<br />
| 2<br />
| BREAKC<br />
| If condition (see [[#Conditions|below]] for details) is true, then breaks out of LOOP block.<br />
|-<br />
| 0x24<br />
| 2<br />
| CALL<br />
| Jumps to DST and executes instructions until it reaches DST+NUM instructions<br />
|-<br />
| 0x25<br />
| 2<br />
| CALLC<br />
| If condition (see [[#Conditions|below]] for details) is true, then jumps to DST and executes instructions until it reaches DST+NUM instructions, else does nothing.<br />
|-<br />
| 0x26<br />
| 3<br />
| CALLU<br />
| Jumps to DST and executes instructions until it reaches DST+NUM instructions if BOOL is true<br />
|-<br />
| 0x27<br />
| 3<br />
| IFU<br />
| If condition BOOL is true, then executes instructions until DST, then jumps to DST+NUM; else, jumps to DST.<br />
|-<br />
| 0x28<br />
| 2<br />
| IFC<br />
| If condition (see [[#Conditions|below]] for details) is true, then executes instructions until DST, then jumps to DST+NUM; else, jumps to DST<br />
|-<br />
| 0x29<br />
| 3<br />
| LOOP<br />
| Loops over the code between itself and DST (inclusive), performing INT.x+1 iterations in total. First, aL is initialized to INT.y. After each iteration, aL is incremented by INT.z.<br />
|-<br />
| 0x2A<br />
| 0 (no param)<br />
| EMIT<br />
| (geometry shader only) Emits a vertex (and primitive if FLAG_PRIMEMIT was set in the corresponding SETEMIT). SETEMIT must be called before this.<br />
|-<br />
| 0x2B<br />
| 4<br />
| SETEMIT<br />
| (geometry shader only) Sets VTXID, FLAG_WINDING and FLAG_PRIMEMIT for the next EMIT instruction. VTXID is the ID of the vertex about to be emitted within the primitive, while FLAG_PRIMEMIT is zero if we are just emitting a single vertex and non-zero if are emitting a vertex and primitive simultaneously. FLAG_WINDING controls the output primitive's winding. Note that the output vertex buffer (which holds 4 vertices) is '''not''' cleared when the primitive is emitted, meaning that vertices from the previous primitive can be reused for the current one. (this is still a working hypothesis and unconfirmed)<br />
|-<br />
| 0x2C<br />
| 2<br />
| JMPC<br />
| If condition (see [[#Conditions|below]] for details) is true, then jumps to DST, else does nothing.<br />
|-<br />
| 0x2D<br />
| 3<br />
| JMPU<br />
| If condition BOOL is true, then jumps to DST, else does nothing. Having bit 0 of NUM = 1 will invert the test, jumping if BOOL is false instead.<br />
|-<br />
| 0x2E-0x2F<br />
| 1c<br />
| CMP<br />
| Sets booleans cmp.x and cmp.y based on the operand's x and y components and the CMPX and CMPY comparison operators respectively. See [[#Comparison_operator|below]] for details about operators. It's unknown whether CMP respects the destination component mask or not.<br />
|-<br />
| 0x30-0x37<br />
| 5i<br />
| MADI<br />
| Multiplies two vectors and adds a third one component by component; DST[i] = SRC3[i] + SRC2[i].SRC1[i] for all i; this is not an FMA, the intermediate result is rounded<br />
|-<br />
| 0x38-0x3F<br />
| 5<br />
| MAD<br />
| Multiplies two vectors and adds a third one component by component; DST[i] = SRC3[i] + SRC2[i].SRC1[i] for all i; this is not an FMA, the intermediate result is rounded<br />
|}<br />
<br />
== Operand descriptors ==<br />
Sizes below are in bits, not bytes.<br />
<br />
{| class="wikitable" border="1"<br />
|-<br />
! Offset<br />
! Size<br />
! Description<br />
|-<br />
| 0x0<br />
| 0x4<br />
| Destination component mask. Bit 3 = x, 2 = y, 1 = z, 0 = w.<br />
|-<br />
| 0x4<br />
| 0x1<br />
| Source 1 negation bit<br />
|-<br />
| 0x5<br />
| 0x8<br />
| Source 1 component selector<br />
|-<br />
| 0xD<br />
| 0x1<br />
| Source 2 negation bit<br />
|-<br />
| 0xE<br />
| 0x8<br />
| Source 2 component selector<br />
|-<br />
| 0x16<br />
| 0x1<br />
| Source 3 negation bit<br />
|-<br />
| 0x17<br />
| 0x8<br />
| Source 3 component selector<br />
|}<br />
<br />
Component selector :<br />
{| class="wikitable" border="1"<br />
|-<br />
! Offset<br />
! Size<br />
! Description<br />
|-<br />
| 0x0<br />
| 0x2<br />
| Component 3 value<br />
|-<br />
| 0x2<br />
| 0x2<br />
| Component 2 value<br />
|-<br />
| 0x4<br />
| 0x2<br />
| Component 1 value<br />
|-<br />
| 0x6<br />
| 0x2<br />
| Component 0 value<br />
|}<br />
<br />
{| class="wikitable" border="1"<br />
|-<br />
! Value<br />
! Component<br />
|-<br />
| 0x0<br />
| x<br />
|-<br />
| 0x1<br />
| y<br />
|-<br />
| 0x2<br />
| z<br />
|-<br />
| 0x3<br />
| w<br />
|}<br />
<br />
The component selector enables swizzling. For example, component selector 0x1B is equivalent to .xyzw, while 0x55 is equivalent to .yyyy.<br />
<br />
Depending on the current shader opcode, source components are disabled implicitly by setting the destination component mask. For example, ADD o0.xy, r0.xyzw, r1.xyzw will not make use of r0's or r1's z/w components, while DP4 o0.xy, r0.xyzw, r1.xyzw will use all input components regardless of the used destination component mask.<br />
<br />
== Relative addressing ==<br />
<br />
There are 3 address registers: a0.x, a0.y and aL (loop counter). For format 1 instructions, when IDX != 0, the value of the corresponding address register is added to SRC1's value. For example, if IDX = 2, a0.y = 3 and SRC1 = c8, then instead SRC1+a0.y = c11 will be used for the instruction. It is only possible to use address registers with vector uniform registers, attempting to use them with input attribute or temporary registers results in the address register being ignored (i.e. read as zero).<br />
<br />
a0.x and a0.y are set manually through the MOVA instruction by rounding a float value to integer precision. Hence, they may take negative values.<br />
<br />
aL can only be set indirectly by the LOOP instruction. It is still accessible and valid after exiting a LOOP block, though.<br />
<br />
== Comparison operator ==<br />
<br />
{| class="wikitable" border="1"<br />
|-<br />
! CMPX/CMPY raw value<br />
! Operator name<br />
! Expression<br />
|-<br />
| 0x0<br />
| EQ<br />
| src1 == src2<br />
|-<br />
| 0x1<br />
| NE<br />
| src1 != src2<br />
|-<br />
| 0x2<br />
| LT<br />
| src1 < src2<br />
|-<br />
| 0x3<br />
| LE<br />
| src1 <= src2<br />
|-<br />
| 0x4<br />
| GT<br />
| src1 > src2<br />
|-<br />
| 0x5<br />
| GE<br />
| src1 >= src2<br />
|-<br />
| 0x6<br />
| ??<br />
| true ?<br />
|-<br />
| 0x7<br />
| ??<br />
| true ?<br />
|}<br />
<br />
6 and 7 seem to always return true.<br />
<br />
== Conditions ==<br />
<br />
A number of format 2 instructions are executed conditionally. These conditions are based on two boolean registers which can be set with CMP : cmp.x and cmp.y.<br />
<br />
Conditional instructions include 3 parameters : CONDOP, REFX and REFY. REFX and REFY are reference values which are tested for equality against cmp.x and cmp.y, respectively. CONDOP describes how the final truth value is constructed from the results of the two tests. There are four conditional expression formats :<br />
<br />
{| class="wikitable" border="1"<br />
|-<br />
! CONDOP raw value<br />
! Expression<br />
! Description<br />
|-<br />
| 0x0<br />
| <nowiki>cmp.x == REFX || cmp.y == REFY</nowiki><br />
| OR<br />
|-<br />
| 0x1<br />
| <nowiki>cmp.x == REFX && cmp.y == REFY</nowiki><br />
| AND<br />
|-<br />
| 0x2<br />
| cmp.x == REFX<br />
| X<br />
|-<br />
| 0x3<br />
| cmp.y == REFY<br />
| Y<br />
|}<br />
<br />
== Registers ==<br />
Input attribute registers (v0-v7?) store the per-vertex data given by the CPU and hence are read-only.<br />
<br />
Output attribute registers (o0-o6) hold the data to be passed to the later GPU stages and are write-only. Each of the output attribute register components is assigned a semantic by setting the corresponding [[GPU_Internal_Registers]].<br />
<br />
Uniform registers hold user-specified data which is constant throughout all processed vertices. There are 96 float[4] uniform registers (c0-c95), eight boolean registers (b0-b7), and four int[4] registers (i0-i3).<br />
<br />
Temporary registers (r0-r15) can be used for intermediate calculations and can both be read and written.<br />
<br />
Many shader instructions which take float arguments have only 5 bits available for the second argument. They may hence only refer to input attributes or temporary registers. In particular, it's not possible to pass two float[4] uniforms to these instructions.<br />
<br />
It appears that writing twice to the same output register can cause problems (e.g. GPU hangs).<br />
<br />
DST mapping :<br />
<br />
{| class="wikitable" border="1"<br />
|-<br />
! DST raw value<br />
! Register name<br />
! Description<br />
|-<br />
| 0x0-0x6<br />
| o0-o6<br />
| Output registers.<br />
|-<br />
| 0x10-0x1F<br />
| r0-r15<br />
| Temporary registers.<br />
|}<br />
<br />
SRC mapping :<br />
<br />
{| class="wikitable" border="1"<br />
|-<br />
! SRC1 raw value<br />
! Register name<br />
! Description<br />
|-<br />
| 0x0-0x7<br />
| v0-v7<br />
| Input attribute registers.<br />
|-<br />
| 0x10-0x1F<br />
| r0-r15<br />
| Temporary registers.<br />
|-<br />
| 0x20-0x7F<br />
| c0-c95<br />
| Vector uniform registers.<br />
|}<br />
<br />
== Floating-Point Behavior ==<br />
<br />
The PICA200 is not IEEE-compliant. It has positive and negative infinities and NaN, but does not seem to have negative 0. Input and output subnormals are flushed to +0. The internal floating point format seems to be the same as used in shader binaries: 1 sign bit, 7 exponent bits, 16 (explicit) mantissa bits. Several instructions also have behavior that differs from the IEEE functions. Here are the results from some tests done on hardware (s = largest subnormal, n = smallest positive normal):<br />
<br />
{| class="wikitable" border="1"<br />
|-<br />
! Computation<br />
! Result<br />
! Notes<br />
|-<br />
| inf * 0<br />
| 0<br />
| Including inside MUL, MAD, DP4, etc.<br />
|-<br />
| NaN * 0<br />
| NaN<br />
| <br />
|-<br />
| +inf - +inf<br />
| NaN<br />
| Indicates +inf is real inf, not FLT_MAX<br />
|-<br />
| rsq(rcp(-inf))<br />
| +inf<br />
| Indicates that there isn't -0.0.<br />
<br />
|- style="border-top: double"<br />
| rcp(-0)<br />
| +inf<br />
| no -0 so differs from IEEE where rcp(-0) = -inf <br />
|-<br />
| rcp(0)<br />
| +inf<br />
| <br />
|-<br />
| rcp(+inf)<br />
| 0<br />
| <br />
|-<br />
| rcp(NaN)<br />
| NaN<br />
| <br />
<br />
|- style="border-top: double"<br />
| rsq(-0)<br />
| +inf<br />
| no -0 so differs from IEEE where rsq(-0) = -inf <br />
|-<br />
| rsq(-2)<br />
| NaN<br />
| <br />
|-<br />
| rsq(+inf)<br />
| 0<br />
| <br />
|-<br />
| rsq(-inf)<br />
| NaN<br />
| <br />
|-<br />
| rsq(NaN)<br />
| NaN<br />
| <br />
<br />
|- style="border-top: double"<br />
| max(0, +inf)<br />
| +inf<br />
| <br />
|-<br />
| max(0, -inf)<br />
| -inf<br />
| <br />
|-<br />
| max(0, NaN)<br />
| NaN<br />
| max violates IEEE but match GLSL spec<br />
|-<br />
| max(NaN, 0)<br />
| 0<br />
| <br />
|-<br />
| max(-inf, +inf)<br />
| +inf<br />
| <br />
<br />
|- style="border-top: double"<br />
| min(0, +inf)<br />
| 0<br />
| <br />
|-<br />
| min(0, -inf)<br />
| -inf<br />
| <br />
|-<br />
| min(0, NaN)<br />
| NaN<br />
| min violates IEEE but match GLSL spec<br />
|-<br />
| min(NaN, 0)<br />
| 0<br />
| <br />
|-<br />
| min(-inf, +inf)<br />
| -inf<br />
|<br />
<br />
|- style="border-top: double"<br />
| cmp(s, 0)<br />
| false<br />
| cmp does not flush input subnormals<br />
|-<br />
| max(s, 0)<br />
| s<br />
| max does not flush input or output subnormals<br />
|-<br />
| mul(s, 2)<br />
| 0<br />
| input subnormals are flushed in arithmetic instructions<br />
|-<br />
| mul(n, 0.5)<br />
| 0<br />
| output subnormals are flushed in arithmetic instructions<br />
|}<br />
<br />
1.0 can be multiplied 63 times by 0.5 until the result compares equal zero. This is consistent with a 7-bit exponent and output subnormal flushing.</div>
Merry
https://www.3dbrew.org/w/index.php?title=DSP&diff=20523
DSP
2017-12-28T17:46:03Z
<p>Merry: Redirected page to Category:DSP</p>
<hr />
<div>#REDIRECT [[Category:DSP]]</div>
Merry
https://www.3dbrew.org/w/index.php?title=Setting_up_Development_Environment&diff=19792
Setting up Development Environment
2017-04-01T16:20:46Z
<p>Merry: Correct shell syntax</p>
<hr />
<div>= Setup =<br />
* Install [http://devkitpro.org/ devkitARM]. If it's already installed, update it.<br />
** On Windows, there's a [http://sourceforge.net/projects/devkitpro/files/Automated%20Installer/ graphical installer].<br />
** On Unix-like platforms such as Linux/macOS, there's a [http://sourceforge.net/projects/devkitpro/files/Automated%20Installer/devkitARMupdate.pl/download Perl script]. Make sure you also select libctru and the 3ds examples when installing.<br />
* Depending on the kind of homebrew you want to develop, you may be interested in installing and using additional libraries and tools which don't ship alongside devkitARM/libctru. A list of them can be found in [[Homebrew Libraries and Tools]].<br />
<br />
==Windows==<br />
devkitPro provides Win32-native precompiled versions of devkitARM which can be run directly on Windows.<br />
* [http://sourceforge.net/projects/devkitpro/files/Automated%20Installer/ download the latest version of the graphical installer] from SourceForge and run it, following the instructions as you go.<br />
* An Internet connection is required.<br />
* You will want to make sure devkitARM is selected during the installation process to develop for the 3DS (and also the DS and GBA) - you can also install devkitPPC (for GameCube/Wii development) and devkitPSP (for PlayStation Portable development) if you wish.<br />
* Once the installer has finished, launch MSYS from:<br />
** Windows 7 and earlier: Start -> All Programs -> devkitPro -> MSYS<br />
** Windows 8 and 8.1: Right click on the Start screen and select 'All Apps'. You should find MSYS there.<br />
** Windows 10 (pre-Anniversary Update): Start -> All Apps -> devkitPro -> MSYS<br />
** Windows 10 (post-Anniversary Update): Start -> devkitPro -> MSYS<br />
<br />
Alternatively starting with Windows 10 Anniversary Update (Version 1607), the [https://msdn.microsoft.com/en-us/commandline/wsl/install_guide Windows Subsystem for Linux (WSL)] may also be used to run the Linux version of devkitARM. Unless you have some particular need for WSL it's recommended that you stick to a more standard environment. <br />
<br />
==Unix-like platforms==<br />
Currently devkitPro provides precompiled versions of devkitARM for the following Unix-like platforms: Linux (x86/x64), macOS (universal binary). Note that Linux x64 binaries are usable under WSL.<br />
<br />
* First, you need to install curl so the installer can download the devkitARM packages, and you should also install Git - you'll need it to update libctru or share your code on GitHub, among many other things. If you are running Linux, you'll also need wget; it comes preinstalled on most distributions, but not all.<br />
<br />
* Find your way into a shell (eg. by opening a Terminal window), and follow the instructions for your OS:<br />
** Debian/Ubuntu/Linux Mint/WSL: <code>sudo apt-get install git curl</code><br />
** Fedora/CentOS/RHEL: <code>sudo yum install git curl</code><br />
** openSUSE: <code>sudo zypper install git curl</code><br />
** Arch Linux: <code>sudo pacman -S git curl wget</code><br />
** macOS: Download Git from [http://git-scm.com/download/mac] and install it. Curl is included with the OS.<br />
<br />
* Next, we need to download, make executable and run the devkitARM updater (don't worry, the updater is also the installer.)<br />
<pre><br />
curl -L https://raw.githubusercontent.com/devkitPro/installer/master/perl/devkitARMupdate.pl -o devkitARMupdate.pl<br />
chmod +x ./devkitARMupdate.pl<br />
sudo ./devkitARMupdate.pl /opt/devkitpro<br />
</pre><br />
<br />
* Finally, we need to tell your shell where to find the devkitARM binaries.<br />
<pre><br />
echo "export DEVKITPRO=/opt/devkitpro" >> ~/.bashrc<br />
echo "export DEVKITARM=/opt/devkitpro/devkitARM" >> ~/.bashrc<br />
echo "export PATH=$PATH:/opt/devkitpro/devkitARM/bin" >> ~/.bashrc<br />
source ~/.bashrc<br />
</pre><br />
<br />
= Building the examples =<br />
3DS examples are still being created; however, there are a growing number of examples available from the [https://github.com/devkitPro/3ds-examples devkitPro/3ds-examples GitHub repository].<br />
There are now too many to list here in detail, so go ahead and browse them.<br />
<br />
* To download these, if you installed Git (as you will have if you followed the above instructions), simply type <code>git clone https://github.com/devkitPro/3ds-examples.git</code> into your shell in the directory you wish to store the 3ds-examples folder in.<br />
<br />
These can be built from the command line.<br />
<br />
To start a new homebrew project from the <code>bash</code> shell, simply type the following (replacing <code>'''~/projects/my3dsproject'''</code> with the place you would like your project to be stored, with <code>~</code> meaning your HOME directory):<br />
cp -r $DEVKITPRO/examples/3ds/templates/application '''~/projects/my3dsproject'''<br />
cd '''~/projects/my3dsproject'''<br />
<br />
The standard Makefile will use the folder as the name of the 3dsx that will be built. You can keep that behaviour or simply change the <code>TARGET := $(notdir $(CURDIR))</code> line in the Makefile to explicitly name your project.<br />
<br />
To compile it, type <code>make</code> in the project directory.<br />
<br />
==Running your code==<br />
To run it on your 3DS, start the Homebrew Launcher, press Y to open the network loader, then on your PC type: <code>$DEVKITARM/bin/3dslink '''my3dsproject'''.3dsx</code>, replacing '''my3dsproject''' with the name of the 3dsx file you want to run.)<br />
</code>.<br />
<br />
If all goes well, you'll soon see your application running on your 3DS.<br />
<br />
==Building the examples on Linux with Netbeans==<br />
* Go to File->New Project...<br />
* Select C/C++ Project with existing code<br />
* Navigate to the examples directory and select the folder for the project you want to build; eg. /home/vtsingaras/3ds/examples/app_launch<br />
* Leave Configuration Mode to 'Automatic' and click 'Finish'.<br />
* It will fail to build. Now edit Makefile and insert these two lines, adjusting for your devkitpro path, at the top:<br />
<pre>export DEVKITPRO=/opt/devkitpro<br />
export DEVKITARM=/opt/devkitpro/devkitARM</pre><br />
* Right-click the project and go to Properties->Code Assistance and click C Compiler.<br />
* In include directories enter <br />
<pre>/opt/devkitpro/devkitARM/include;/opt/devkitpro/libctru/include</pre><br />
adjusting again for your devkitPro path.<br />
* Do the same for 'C++ Compiler'.<br />
* Go to 'Run' and click 'Clean and Build Project'.<br />
* Now right-click on the project and select Code Assistance->Reparse Project.<br />
<br />
Now you can use Netbeans' code completion feature and build your project from the Run menu.<br />
<br />
= Building homebrew for distribution =<br />
To build your homebrew, open a Bash shell as described above, browse to the folder of the homebrew you wish to compile, and run <code>make</code>.<br />
<br />
* This will build a .elf file and a .3dsx file (the homebrew executable itself).<br />
** The Homebrew Launcher can only run homebrew in the 3DSX format.<br />
<br />
* To build a CIA file, you need to use makerom on it along with a RSF file describing the application:<br />
makerom -f cia -o [.cia file] -rsf [RSF file] -target t -exefslogo -elf [ELF file] -icon [icon file] -banner [banner file]<br />
<br />
= Troubleshooting =<br />
'''I get the "Please set DEVKITARM in your environment." error.'''<br />
<br />
Use the following command before installing [http://askubuntu.com/questions/573070/problem-setting-up-environment-for-make-command-execution]:<br />
sudo chown $USER /opt/devkitpro/ -R<br />
echo "export DEVKITPRO=\"/opt/devkitpro/\"" >> ~/.profile<br />
echo "export DEVKITARM=\"\${DEVKITPRO}/devkitARM/\"" >> ~/.profile<br />
source ~/.profile<br />
<br />
For WSL users, you need to close the Bash shell, then reopen it for WSL to reload all of the variables from a clean state.</div>
Merry
https://www.3dbrew.org/w/index.php?title=Setting_up_Development_Environment&diff=19791
Setting up Development Environment
2017-04-01T16:18:47Z
<p>Merry: </p>
<hr />
<div>= Setup =<br />
* Install [http://devkitpro.org/ devkitARM]. If it's already installed, update it.<br />
** On Windows, there's a [http://sourceforge.net/projects/devkitpro/files/Automated%20Installer/ graphical installer].<br />
** On Unix-like platforms such as Linux/macOS, there's a [http://sourceforge.net/projects/devkitpro/files/Automated%20Installer/devkitARMupdate.pl/download Perl script]. Make sure you also select libctru and the 3ds examples when installing.<br />
* Depending on the kind of homebrew you want to develop, you may be interested in installing and using additional libraries and tools which don't ship alongside devkitARM/libctru. A list of them can be found in [[Homebrew Libraries and Tools]].<br />
<br />
==Windows==<br />
devkitPro provides Win32-native precompiled versions of devkitARM which can be run directly on Windows.<br />
* [http://sourceforge.net/projects/devkitpro/files/Automated%20Installer/ download the latest version of the graphical installer] from SourceForge and run it, following the instructions as you go.<br />
* An Internet connection is required.<br />
* You will want to make sure devkitARM is selected during the installation process to develop for the 3DS (and also the DS and GBA) - you can also install devkitPPC (for GameCube/Wii development) and devkitPSP (for PlayStation Portable development) if you wish.<br />
* Once the installer has finished, launch MSYS from:<br />
** Windows 7 and earlier: Start -> All Programs -> devkitPro -> MSYS<br />
** Windows 8 and 8.1: Right click on the Start screen and select 'All Apps'. You should find MSYS there.<br />
** Windows 10 (pre-Anniversary Update): Start -> All Apps -> devkitPro -> MSYS<br />
** Windows 10 (post-Anniversary Update): Start -> devkitPro -> MSYS<br />
<br />
Alternatively starting with Windows 10 Anniversary Update (Version 1607), the [https://msdn.microsoft.com/en-us/commandline/wsl/install_guide Windows Subsystem for Linux (WSL)] may also be used to run the Linux version of devkitARM. Unless you have some particular need for WSL it's recommended that you stick to a more standard environment. <br />
<br />
==Unix-like platforms==<br />
Currently devkitPro provides precompiled versions of devkitARM for the following Unix-like platforms: Linux (x86/x64), macOS (universal binary). Note that Linux x64 binaries are usable under WSL.<br />
<br />
* First, you need to install curl so the installer can download the devkitARM packages, and you should also install Git - you'll need it to update libctru or share your code on GitHub, among many other things. If you are running Linux, you'll also need wget; it comes preinstalled on most distributions, but not all.<br />
<br />
* Find your way into a shell (eg. by opening a Terminal window), and follow the instructions for your OS:<br />
** Debian/Ubuntu/Linux Mint/WSL: <code>sudo apt-get install git curl</code><br />
** Fedora/CentOS/RHEL: <code>sudo yum install git curl</code><br />
** openSUSE: <code>sudo zypper install git curl</code><br />
** Arch Linux: <code>sudo pacman -S git curl wget</code><br />
** macOS: Download Git from [http://git-scm.com/download/mac] and install it. Curl is included with the OS.<br />
<br />
* Next, we need to download, make executable and run the devkitARM updater (don't worry, the updater is also the installer.)<br />
<pre><br />
curl -L https://raw.githubusercontent.com/devkitPro/installer/master/perl/devkitARMupdate.pl -o devkitARMupdate.pl<br />
chmod +x ./devkitARMupdate.pl<br />
sudo ./devkitARMupdate.pl /opt/devkitpro<br />
</pre><br />
<br />
* Finally, we need to tell your shell where to find the devkitARM binaries.<br />
<pre><br />
echo "export DEVKITPRO=/opt/devkitpro" >> ~/.bashrc<br />
echo "export DEVKITARM=/opt/devkitpro/devkitARM" >> ~/.bashrc<br />
echo "export PATH=$PATH:/opt/devkitpro/devkitARM/bin" >> ~/.bashrc<br />
source ~/.bashrc<br />
</pre><br />
<br />
= Building the examples =<br />
3DS examples are still being created; however, there are a growing number of examples available from the [https://github.com/devkitPro/3ds-examples devkitPro/3ds-examples GitHub repository].<br />
There are now too many to list here in detail, so go ahead and browse them.<br />
<br />
* To download these, if you installed Git (as you will have if you followed the above instructions), simply type <code>git clone https://github.com/devkitPro/3ds-examples.git</code> into your shell in the directory you wish to store the 3ds-examples folder in.<br />
<br />
These can be built from the command line.<br />
<br />
To start a new homebrew project from the <code>bash</code> shell, simply type the following (replacing <code>'''~/projects/my3dsproject'''</code> with the place you would like your project to be stored, with <code>~</code> meaning your HOME directory):<br />
cp -r $DEVKITPRO/examples/3ds/templates/application '''~/projects/my3dsproject'''<br />
cd '''~/projects/my3dsproject'''<br />
<br />
The standard Makefile will use the folder as the name of the 3dsx that will be built. You can keep that behaviour or simply change the <code>TARGET := $(notdir $(CURDIR))</code> line in the Makefile to explicitly name your project.<br />
<br />
To compile it, type <code>make</code> in the project directory.<br />
<br />
==Running your code==<br />
To run it on your 3DS, start the Homebrew Launcher, press Y to open the network loader, then on your PC type: <code>$DEVKITARM/bin/3dslink '''my3dsproject'''.3dsx</code>, replacing '''my3dsproject''' with the name of the 3dsx file you want to run.)<br />
</code>.<br />
<br />
If all goes well, you'll soon see your application running on your 3DS.<br />
<br />
==Building the examples on Linux with Netbeans==<br />
* Go to File->New Project...<br />
* Select C/C++ Project with existing code<br />
* Navigate to the examples directory and select the folder for the project you want to build; eg. /home/vtsingaras/3ds/examples/app_launch<br />
* Leave Configuration Mode to 'Automatic' and click 'Finish'.<br />
* It will fail to build. Now edit Makefile and insert these two lines, adjusting for your devkitpro path, at the top:<br />
<pre>export DEVKITPRO=/opt/devkitpro<br />
export DEVKITARM=/opt/devkitpro/devkitARM</pre><br />
* Right-click the project and go to Properties->Code Assistance and click C Compiler.<br />
* In include directories enter <br />
<pre>/opt/devkitpro/devkitARM/include;/opt/devkitpro/libctru/include</pre><br />
adjusting again for your devkitPro path.<br />
* Do the same for 'C++ Compiler'.<br />
* Go to 'Run' and click 'Clean and Build Project'.<br />
* Now right-click on the project and select Code Assistance->Reparse Project.<br />
<br />
Now you can use Netbeans' code completion feature and build your project from the Run menu.<br />
<br />
= Building homebrew for distribution =<br />
To build your homebrew, open a Bash shell as described above, browse to the folder of the homebrew you wish to compile, and run <code>make</code>.<br />
<br />
* This will build a .elf file and a .3dsx file (the homebrew executable itself).<br />
** The Homebrew Launcher can only run homebrew in the 3DSX format.<br />
<br />
* To build a CIA file, you need to use makerom on it along with a RSF file describing the application:<br />
makerom -f cia -o [.cia file] -rsf [RSF file] -target t -exefslogo -elf [ELF file] -icon [icon file] -banner [banner file]<br />
<br />
= Troubleshooting =<br />
'''I get the "Please set DEVKITARM in your environment." error.'''<br />
<br />
Use the following command before installing [http://askubuntu.com/questions/573070/problem-setting-up-environment-for-make-command-execution]:<br />
sudo chown $USER /opt/devkitpro/ -R<br />
echo "export DEVKITPRO="/opt/devkitpro/" >> ~/.profile<br />
echo "export DEVKITARM="${DEVKITPRO}/devkitARM/" >> ~/.profile<br />
source ~/.profile<br />
<br />
For WSL users, you need to close the Bash shell, then reopen it for WSL to reload all of the variables from a clean state.</div>
Merry
https://www.3dbrew.org/w/index.php?title=DSP_Memory_Region&diff=18013
DSP Memory Region
2016-09-01T20:18:38Z
<p>Merry: I don't own the page.</p>
<hr />
<div>''Note that everything below may vary depending on the exact DSP firmware used and different variants have slightly different behaviours.''<br />
<br />
The DSP communicates with the application through two shared memory areas 0x8000 bytes long each (at 0x1FF50000 and 0x1FF70000 respectively). The DSP alternates between the use of these two areas (much like a double-buffer). Each area has 15 structures within it. The location of these structures can be obtained by [[DSP:ReadPipe|reading channel 2 of the DSP pipe]]. A list of structures in the order the DSP addresses are read from the pipe follows:<br />
<br />
1. Frame count<br />
<br />
2. Input configurations<br />
<br />
3. Input status<br />
<br />
4. Input ADPCM coefficients<br />
<br />
5. DSP configuration<br />
<br />
6. DSP status<br />
<br />
7. Output samples<br />
<br />
8. Intermediate mix samples<br />
<br />
9. Compressor table<br />
<br />
10. DSP debug statistics<br />
<br />
11. Unknown Coefficients<br />
<br />
12. Unknown Coefficients<br />
<br />
13. Unknown Coefficients<br />
<br />
14. Surround sound biquad filter 1<br />
<br />
15. Surround sound biquad filter 2<br />
<br />
The DSP has 24 inputs, each of which are individually configurable. These 24 inputs each produce three sets of 4 audio channels (two left, two right). <br />
<br />
These four audio channels feed into three intermediate mixers. Two of these intermediate mixers are used for effects and aux.<br />
<br />
== Frame Count ==<br />
<br />
The frame count of the first region must be even and the frame count of the second region must be odd.<br />
<br />
The frame with the higher count is the "current region".<br />
<br />
The DSP firmware only responds if the first frame count is 4.<br />
<br />
== Input Config ==<br />
<br />
A 192 byte long structure. There are 24 of them.<br />
<br />
{| class="wikitable"<br />
|-<br />
| Offset<br />
| Type<br />
| Description<br />
|-<br />
| 0<br />
| u32<br />
| Dirty flags<br />
|-<br />
| 4<br />
| f32[3][2][2]<br />
| Input Gain (Each input has 12 channels)<br />
|-<br />
| 52<br />
| f32<br />
| Rate multiplier (1.0x == native DSP rate)<br />
|-<br />
| 56<br />
| u8<br />
| Interpolation mode<br />
|-<br />
| 57<br />
| u8<br />
| Polyphase filter select<br />
|-<br />
| 58<br />
| u16<br />
| bit[0]: Simple Filter enabled, bit[1]: Biquadratic Filter enabled<br />
|-<br />
| 60<br />
| SimpleFilter<br />
| Simple Filter (One pole normalized recursive linear filter)<br />
|-<br />
| 64<br />
| BiquadFilter<br />
| Biquadratic Filter (Two poles two zeros normalized recursive linear filter)<br />
|-<br />
| 74<br />
| u16<br />
| Bitmap of which buffers in queue are dirty<br />
|-<br />
| 76<br />
| Buffer[4]<br />
| Buffer queue<br />
|-<br />
| 156<br />
| u32<br />
| -<br />
|-<br />
| 160<br />
| u16<br />
| Is Active<br />
|-<br />
| 162<br />
| u16 <br />
| Sync Count<br />
|-<br />
| 164<br />
| u32<br />
| Play position<br />
|-<br />
| 168<br />
| 4<br />
| ?<br />
|-<br />
| 172<br />
| u32<br />
| Physical address of embedded buffer<br />
|-<br />
| 176<br />
| u32<br />
| Number of samples in embedded buffer<br />
|-<br />
| 180<br />
| u16<br />
| Format<br />
|-<br />
| 182<br />
| AdpcmData<br />
| ADPCM data associated with embedded buffer<br />
|-<br />
| 188<br />
| u16<br />
| bit[0]: ADPCM updated?; bit[1]: Is looping?r<br />
|-<br />
| 190<br />
| u16<br />
| Buffer Id of embedded buffer<br />
|}<br />
<br />
There is a 2 sample delay in this preprocessing stage, likely due to the interpolation step.<br />
<br />
=== Format ===<br />
<br />
This is a u16.<br />
<br />
{| class="wikitable"<br />
|-<br />
| Bits<br />
| Desciption<br />
|-<br />
| 0-1<br />
| Number of channels: 0,1,3 = mono; 2 = stereo<br />
|-<br />
| 2-3<br />
| Buffer codec: [[BCWAV#Encoding|0:PCM8; 1:PCM16; 2:ADPCM]]<br />
|-<br />
| 5 <br />
| Fade<br />
|}<br />
<br />
=== Buffer ===<br />
<br />
{| class="wikitable"<br />
|-<br />
| Offset<br />
| Type<br />
| Description<br />
|-<br />
| 0<br />
| u32<br />
| Physical Address<br />
|-<br />
| 4 <br />
| u32<br />
| Sample Count<br />
|-<br />
| 8<br />
| AdpcmData<br />
| ADPCM data<br />
|-<br />
| 14<br />
| u8<br />
| ADPCM data dirty?<br />
|-<br />
| 15<br />
| u8<br />
| Looping?<br />
|-<br />
| 16<br />
| u16<br />
| Buffer Id<br />
|-<br />
| 18<br />
| u16<br />
| -<br />
|}<br />
<br />
=== Adpcm Data === <br />
<br />
{| class="wikitable"<br />
|-<br />
| 0<br />
| u8<br />
| ADPCM predictor/scale<br />
|-<br />
| 1<br />
| u8<br />
| -<br />
|-<br />
| 2<br />
| s16<br />
| ADPCM y[n-1]<br />
|-<br />
| 4<br />
| s16<br />
| ADPCM y[n-2]<br />
|}<br />
<br />
<br />
=== Simple Filter ===<br />
<br />
This is a standard single-pole filter. The fall-off is 6dB per octave as you would expect.<br />
<br />
{| class="wikitable"<br />
|-<br />
| Offset<br />
| Type<br />
| Description<br />
|-<br />
| 0<br />
| s1.15<br />
| b0<br />
|-<br />
| 2<br />
| s1.15<br />
| a1 (negated)<br />
|}<br />
<br />
=== Biquad Filter ===<br />
<br />
This is a [[wikipedia:Digital_biquad_filter|biquadratic filter]].<br />
<br />
{| class="wikitable"<br />
|-<br />
| Offset<br />
| Type<br />
| Description<br />
|-<br />
| 0<br />
| s2.14<br />
| a2 (negated)<br />
|-<br />
| 2<br />
| s2.14<br />
| a1 (negated)<br />
|-<br />
| 4<br />
| s2.14<br />
| b2<br />
|-<br />
| 6<br />
| s2.14<br />
| b1<br />
|-<br />
| 8<br />
| s2.14<br />
| b0<br />
|}<br />
<br />
== Input status ==<br />
<br />
Read only. This structure is set by the DSP. This structure is 12 bytes long and there are 24 of them.<br />
<br />
{| class="wikitable"<br />
|-<br />
| Offset<br />
| Type<br />
| Description<br />
|-<br />
| 0<br />
| u8<br />
| Input Enabled?<br />
|-<br />
| 1<br />
| u8<br />
| Dirty flag for buffer id, set to 1 when buffer (after the first) starts playing<br />
|-<br />
| 2<br />
| u16<br />
| Sync count<br />
|-<br />
| 4<br />
| u32<br />
| Position (number of samples) into current buffer playback<br />
|-<br />
| 8<br />
| u16<br />
| Buffer id of the buffer that's just started playing.<br />
|-<br />
| 10<br />
| u16<br />
| -<br />
|}<br />
<br />
== Input ADPCM coefficients ==<br />
<br />
This is a 32 byte long structure. There are 24 of them.<br />
<br />
{| class="wikitable"<br />
|-<br />
| Offset<br />
| Type<br />
| Description<br />
|-<br />
| 0<br />
| s5.11[16]<br />
| ADPCM coefficents<br />
|}<br />
<br />
== DSP configuration ==<br />
<br />
=== Delay Effect ===<br />
<br />
Delay with feedback.<br />
<br />
Length of delay is expressed in terms of number of audio frames (there are 160 samples per audio frame).<br />
<br />
Feedback arm only has a gain on it. Under the feedback arm is a single-pole filter with the delay.<br />
<br />
=== Reverb Effect ===<br />
<br />
Reverb consists of two comb filters and one all-pass filter in standard configuration.<br />
<br />
== DSP status ==<br />
<br />
Read only.<br />
<br />
== Output samples ==<br />
<br />
Read only. This structure is 640 bytes long. Output is stereo (the 3DS has two speakers).<br />
<br />
{| class="wikitable"<br />
|-<br />
| Offset<br />
| Type<br />
| Description<br />
|-<br />
| 0<br />
| s16[160]<br />
| Left-channel Samples<br />
|-<br />
| 320<br />
| s16[160]<br />
| Right-channel Samples<br />
|}<br />
<br />
This structure has separate arrays for the left and right channels.<br />
<br />
== Intermediate mix samples ==<br />
<br />
Read/Write.<br />
<br />
PCM32. Also serves an aux function, allowing the ARM11 to apply custom effects to audio. Internal format of the DSP firmware is quadaphonic audio.<br />
<br />
This structure is 5120 bytes long.<br />
<br />
{| class="wikitable"<br />
|-<br />
| Offset<br />
| Type<br />
| Description<br />
|-<br />
| 0<br />
| IntermediateSample[160]<br />
| Samples<br />
|}<br />
<br />
In contrast to the final output samples, this structure has the left/right channels interleaved.<br />
<br />
=== Intermediate sample ===<br />
<br />
A quadraphonic sample.<br />
<br />
{| class="wikitable"<br />
|-<br />
| Offset<br />
| Type<br />
| Description<br />
|-<br />
| 0<br />
| s32<br />
| Left Channel A<br />
|-<br />
| 4<br />
| s32<br />
| Right Channel A<br />
|-<br />
| 8<br />
| s32<br />
| Left Channel B<br />
|-<br />
| 12<br />
| s32<br />
| Right Channel B<br />
|}<br />
<br />
== Compressor table ==<br />
<br />
A precomputed response curve lookup table for the compressor.<br />
<br />
[[Category:DSP]]</div>
Merry
https://www.3dbrew.org/w/index.php?title=DSP_Memory_Region&diff=17568
DSP Memory Region
2016-06-23T11:30:03Z
<p>Merry: </p>
<hr />
<div>'''Some of this is known to be incorrect. I'll correct this in a few months after a bit more RE work. [[User:Merry|Merry]] ([[User talk:Merry|talk]]) 21:10, 28 January 2016 (CET)'''<br />
<br />
----<br />
<br />
*Note that everything below will vary depending on the exact DSP firmware used and different variants have slightly different behaviours.*<br />
<br />
The DSP communicates with the application through two shared memory areas 0x8000 bytes long each (at 0x1FF50000 and 0x1FF70000 respectively). The DSP alternates between the use of these two areas (much like a double-buffer). Each area has 15 structures within it. The location of these structures can be obtained by [[DSP:ReadPipe|reading channel 2 of the DSP pipe]]. A list of structures in the order the DSP addresses are read from the pipe follows:<br />
<br />
1. Frame count<br />
<br />
2. Input configurations<br />
<br />
3. Input status<br />
<br />
4. Input ADPCM coefficients<br />
<br />
5. DSP configuration<br />
<br />
6. DSP status<br />
<br />
7. Output samples<br />
<br />
8. Intermediate mix samples<br />
<br />
9. Compressor table<br />
<br />
10. DSP debug statistics<br />
<br />
11. Unknown Coefficients<br />
<br />
12. Unknown Coefficients<br />
<br />
13. Unknown Coefficients<br />
<br />
14. Surround sound biquad filter 1<br />
<br />
15. Surround sound biquad filter 2<br />
<br />
The DSP has 24 inputs, each of which are individually configurable. These 24 inputs each produce three sets of 4 audio channels (two left, two right). <br />
<br />
These four audio channels feed into three intermediate mixers. Two of these intermediate mixers are used for effects and aux.<br />
<br />
== Frame Count ==<br />
<br />
The frame count of the first region must be even and the frame count of the second region must be odd.<br />
<br />
The frame with the higher count is the "current region".<br />
<br />
The DSP firmware only responds if the first frame count is 4.<br />
<br />
== Input Config ==<br />
<br />
A 192 byte long structure. There are 24 of them.<br />
<br />
{| class="wikitable"<br />
|-<br />
| Offset<br />
| Type<br />
| Description<br />
|-<br />
| 0<br />
| u32<br />
| Dirty flags<br />
|-<br />
| 4<br />
| f32[3][2][2]<br />
| Input Gain (Each input has 12 channels)<br />
|-<br />
| 52<br />
| f32<br />
| Rate multiplier (1.0x == native DSP rate)<br />
|-<br />
| 56<br />
| u8<br />
| Interpolation mode<br />
|-<br />
| 57<br />
| u8<br />
| Polyphase filter select<br />
|-<br />
| 58<br />
| u16<br />
| bit[0]: Simple Filter enabled, bit[1]: Biquadratic Filter enabled<br />
|-<br />
| 60<br />
| SimpleFilter<br />
| Simple Filter (One pole normalized recursive linear filter)<br />
|-<br />
| 64<br />
| BiquadFilter<br />
| Biquadratic Filter (Two poles two zeros normalized recursive linear filter)<br />
|-<br />
| 74<br />
| u16<br />
| Bitmap of which buffers in queue are dirty<br />
|-<br />
| 76<br />
| Buffer[4]<br />
| Buffer queue<br />
|-<br />
| 156<br />
| u32<br />
| -<br />
|-<br />
| 160<br />
| u16<br />
| Is Active<br />
|-<br />
| 162<br />
| u16 <br />
| Sync Count<br />
|-<br />
| 164<br />
| u32<br />
| Play position<br />
|-<br />
| 168<br />
| 4<br />
| ?<br />
|-<br />
| 172<br />
| u32<br />
| Physical address of embedded buffer<br />
|-<br />
| 176<br />
| u32<br />
| Number of samples in embedded buffer<br />
|-<br />
| 180<br />
| u16<br />
| Format<br />
|-<br />
| 182<br />
| AdpcmData<br />
| ADPCM data associated with embedded buffer<br />
|-<br />
| 188<br />
| u16<br />
| bit[0]: ADPCM updated?; bit[1]: Is looping?r<br />
|-<br />
| 190<br />
| u16<br />
| Buffer Id of embedded buffer<br />
|}<br />
<br />
There is a 2 sample delay in this preprocessing stage, likely due to the interpolation step.<br />
<br />
=== Format ===<br />
<br />
This is a u16.<br />
<br />
{| class="wikitable"<br />
|-<br />
| Bits<br />
| Desciption<br />
|-<br />
| 0-1<br />
| Number of channels: 0,1,3 = mono; 2 = stereo<br />
|-<br />
| 2-3<br />
| Buffer codec: [[BCWAV#Encoding|0:PCM8; 1:PCM16; 2:ADPCM]]<br />
|-<br />
| 5 <br />
| Fade<br />
|}<br />
<br />
=== Buffer ===<br />
<br />
{| class="wikitable"<br />
|-<br />
| Offset<br />
| Type<br />
| Description<br />
|-<br />
| 0<br />
| u32<br />
| Physical Address<br />
|-<br />
| 4 <br />
| u32<br />
| Sample Count<br />
|-<br />
| 8<br />
| AdpcmData<br />
| ADPCM data<br />
|-<br />
| 14<br />
| u8<br />
| ADPCM data dirty?<br />
|-<br />
| 15<br />
| u8<br />
| Looping?<br />
|-<br />
| 16<br />
| u16<br />
| Buffer Id<br />
|-<br />
| 18<br />
| u16<br />
| -<br />
|}<br />
<br />
=== Adpcm Data === <br />
<br />
{| class="wikitable"<br />
|-<br />
| 0<br />
| u8<br />
| ADPCM predictor/scale<br />
|-<br />
| 1<br />
| u8<br />
| -<br />
|-<br />
| 2<br />
| s16<br />
| ADPCM y[n-1]<br />
|-<br />
| 4<br />
| s16<br />
| ADPCM y[n-2]<br />
|}<br />
<br />
<br />
=== Simple Filter ===<br />
<br />
This is a standard single-pole filter. The fall-off is 6dB per octave as you would expect.<br />
<br />
{| class="wikitable"<br />
|-<br />
| Offset<br />
| Type<br />
| Description<br />
|-<br />
| 0<br />
| s1.15<br />
| b0<br />
|-<br />
| 2<br />
| s1.15<br />
| a1 (negated)<br />
|}<br />
<br />
=== Biquad Filter ===<br />
<br />
This is a [[wikipedia:Digital_biquad_filter|biquadratic filter]].<br />
<br />
{| class="wikitable"<br />
|-<br />
| Offset<br />
| Type<br />
| Description<br />
|-<br />
| 0<br />
| s2.14<br />
| a2 (negated)<br />
|-<br />
| 2<br />
| s2.14<br />
| a1 (negated)<br />
|-<br />
| 4<br />
| s2.14<br />
| b2<br />
|-<br />
| 6<br />
| s2.14<br />
| b1<br />
|-<br />
| 8<br />
| s2.14<br />
| b0<br />
|}<br />
<br />
== Input status ==<br />
<br />
Read only. This structure is set by the DSP. This structure is 12 bytes long and there are 24 of them.<br />
<br />
{| class="wikitable"<br />
|-<br />
| Offset<br />
| Type<br />
| Description<br />
|-<br />
| 0<br />
| u8<br />
| Input Enabled?<br />
|-<br />
| 1<br />
| u8<br />
| Dirty flag for buffer id, set to 1 when buffer (after the first) starts playing<br />
|-<br />
| 2<br />
| u16<br />
| Sync count<br />
|-<br />
| 4<br />
| u32<br />
| Position (number of samples) into current buffer playback<br />
|-<br />
| 8<br />
| u16<br />
| Buffer id of the buffer that's just started playing.<br />
|-<br />
| 10<br />
| u16<br />
| -<br />
|}<br />
<br />
== Input ADPCM coefficients ==<br />
<br />
This is a 32 byte long structure. There are 24 of them.<br />
<br />
{| class="wikitable"<br />
|-<br />
| Offset<br />
| Type<br />
| Description<br />
|-<br />
| 0<br />
| s5.11[16]<br />
| ADPCM coefficents<br />
|}<br />
<br />
== DSP configuration ==<br />
<br />
=== Delay Effect ===<br />
<br />
Delay with feedback.<br />
<br />
Length of delay is expressed in terms of number of audio frames (there are 160 samples per audio frame).<br />
<br />
Feedback arm only has a gain on it. Under the feedback arm is a single-pole filter with the delay.<br />
<br />
=== Reverb Effect ===<br />
<br />
Reverb consists of two comb filters and one all-pass filter in standard configuration.<br />
<br />
== DSP status ==<br />
<br />
Read only.<br />
<br />
== Output samples ==<br />
<br />
Read only. This structure is 640 bytes long. Output is stereo (the 3DS has two speakers).<br />
<br />
{| class="wikitable"<br />
|-<br />
| Offset<br />
| Type<br />
| Description<br />
|-<br />
| 0<br />
| s16[160]<br />
| Left-channel Samples<br />
|-<br />
| 320<br />
| s16[160]<br />
| Right-channel Samples<br />
|}<br />
<br />
This structure has separate arrays for the left and right channels.<br />
<br />
== Intermediate mix samples ==<br />
<br />
Read/Write.<br />
<br />
PCM32. Also serves an aux function, allowing the ARM11 to apply custom effects to audio. Internal format of the DSP firmware is quadaphonic audio.<br />
<br />
This structure is 5120 bytes long.<br />
<br />
{| class="wikitable"<br />
|-<br />
| Offset<br />
| Type<br />
| Description<br />
|-<br />
| 0<br />
| IntermediateSample[160]<br />
| Samples<br />
|}<br />
<br />
In contrast to the final output samples, this structure has the left/right channels interleaved.<br />
<br />
=== Intermediate sample ===<br />
<br />
A quadraphonic sample.<br />
<br />
{| class="wikitable"<br />
|-<br />
| Offset<br />
| Type<br />
| Description<br />
|-<br />
| 0<br />
| s32<br />
| Left Channel A<br />
|-<br />
| 4<br />
| s32<br />
| Right Channel A<br />
|-<br />
| 8<br />
| s32<br />
| Left Channel B<br />
|-<br />
| 12<br />
| s32<br />
| Right Channel B<br />
|}<br />
<br />
== Compressor table ==<br />
<br />
A precomputed response curve lookup table for the compressor.</div>
Merry
https://www.3dbrew.org/w/index.php?title=DSP_Memory_Region&diff=17567
DSP Memory Region
2016-06-23T11:24:07Z
<p>Merry: /* Intermediate mix samples */</p>
<hr />
<div>'''Some of this is known to be incorrect. I'll correct this in a few months after a bit more RE work. [[User:Merry|Merry]] ([[User talk:Merry|talk]]) 21:10, 28 January 2016 (CET)'''<br />
<br />
----<br />
<br />
*Note that everything below will vary depending on the exact DSP firmware used and different variants have slightly different behaviours.*<br />
<br />
The DSP communicates with the application through two shared memory areas 0x8000 bytes long each (at 0x1FF50000 and 0x1FF70000 respectively). The DSP alternates between the use of these two areas (much like a double-buffer). Each area has 15 structures within it. The location of these structures can be obtained by [[DSP:ReadPipe|reading channel 2 of the DSP pipe]]. A list of structures in the order the DSP addresses are read from the pipe follows:<br />
<br />
1. Frame count<br />
<br />
2. Input configurations<br />
<br />
3. Input status<br />
<br />
4. Input ADPCM coefficients<br />
<br />
5. DSP configuration<br />
<br />
6. DSP status<br />
<br />
7. Output samples<br />
<br />
8. Intermediate mix samples<br />
<br />
9. Compressor table<br />
<br />
10. DSP debug statistics<br />
<br />
11. Unknown Coefficients<br />
<br />
12. Unknown Coefficients<br />
<br />
13. Unknown Coefficients<br />
<br />
14. Surround sound biquad filter 1<br />
<br />
15. Surround sound biquad filter 2<br />
<br />
The DSP has 24 inputs, each of which are individually configurable. These 24 inputs each produce three sets of 4 audio channels (two left, two right). <br />
<br />
These four audio channels feed into three intermediate mixers. Two of these intermediate mixers are used for effects and aux.<br />
<br />
== Frame Count ==<br />
<br />
The frame count of the first region must be even and the frame count of the second region must be odd.<br />
<br />
The frame with the higher count is the "current region".<br />
<br />
The DSP firmware only responds if the first frame count is 4.<br />
<br />
== Input Config ==<br />
<br />
A 192 byte long structure. There are 24 of them.<br />
<br />
{| class="wikitable"<br />
|-<br />
| Offset<br />
| Type<br />
| Description<br />
|-<br />
| 0<br />
| u32<br />
| Dirty flags<br />
|-<br />
| 4<br />
| f32[3][2][2]<br />
| Input Gain (Each input has 12 channels)<br />
|-<br />
| 52<br />
| f32<br />
| Rate multiplier (1.0x == native DSP rate)<br />
|-<br />
| 56<br />
| u8<br />
| Interpolation mode<br />
|-<br />
| 57<br />
| u8<br />
| Polyphase filter select<br />
|-<br />
| 58<br />
| u16<br />
| bit[0]: Simple Filter enabled, bit[1]: Biquadratic Filter enabled<br />
|-<br />
| 60<br />
| SimpleFilter<br />
| Simple Filter (One pole normalized recursive linear filter)<br />
|-<br />
| 64<br />
| BiquadFilter<br />
| Biquadratic Filter (Two poles two zeros normalized recursive linear filter)<br />
|-<br />
| 74<br />
| u16<br />
| Bitmap of which buffers in queue are dirty<br />
|-<br />
| 76<br />
| Buffer[4]<br />
| Buffer queue<br />
|-<br />
| 156<br />
| u32<br />
| -<br />
|-<br />
| 160<br />
| u16<br />
| Is Active<br />
|-<br />
| 162<br />
| u16 <br />
| Sync Count<br />
|-<br />
| 164<br />
| u32<br />
| Play position<br />
|-<br />
| 168<br />
| 4<br />
| ?<br />
|-<br />
| 172<br />
| u32<br />
| Physical address of embedded buffer<br />
|-<br />
| 176<br />
| u32<br />
| Number of samples in embedded buffer<br />
|-<br />
| 180<br />
| u16<br />
| Format<br />
|-<br />
| 182<br />
| AdpcmData<br />
| ADPCM data associated with embedded buffer<br />
|-<br />
| 188<br />
| u16<br />
| bit[0]: ADPCM updated?; bit[1]: Is looping?r<br />
|-<br />
| 190<br />
| u16<br />
| Buffer Id of embedded buffer<br />
|}<br />
<br />
There is a 2 sample delay in this preprocessing stage, likely due to the interpolation step.<br />
<br />
=== Format ===<br />
<br />
This is a u16.<br />
<br />
{| class="wikitable"<br />
|-<br />
| Bits<br />
| Desciption<br />
|-<br />
| 0-1<br />
| Number of channels: 0,1,3 = mono; 2 = stereo<br />
|-<br />
| 2-3<br />
| Buffer codec: [[BCWAV#Encoding|0:PCM8; 1:PCM16; 2:ADPCM]]<br />
|-<br />
| 5 <br />
| Fade<br />
|}<br />
<br />
=== Buffer ===<br />
<br />
{| class="wikitable"<br />
|-<br />
| Offset<br />
| Type<br />
| Description<br />
|-<br />
| 0<br />
| u32<br />
| Physical Address<br />
|-<br />
| 4 <br />
| u32<br />
| Sample Count<br />
|-<br />
| 8<br />
| AdpcmData<br />
| ADPCM data<br />
|-<br />
| 14<br />
| u8<br />
| ADPCM data dirty?<br />
|-<br />
| 15<br />
| u8<br />
| Looping?<br />
|-<br />
| 16<br />
| u16<br />
| Buffer Id<br />
|-<br />
| 18<br />
| u16<br />
| -<br />
|}<br />
<br />
=== Adpcm Data === <br />
<br />
{| class="wikitable"<br />
|-<br />
| 0<br />
| u8<br />
| ADPCM predictor/scale<br />
|-<br />
| 1<br />
| u8<br />
| -<br />
|-<br />
| 2<br />
| s16<br />
| ADPCM y[n-1]<br />
|-<br />
| 4<br />
| s16<br />
| ADPCM y[n-2]<br />
|}<br />
<br />
<br />
=== Simple Filter ===<br />
<br />
This is a standard single-pole filter. The fall-off is 6dB per octave as you would expect.<br />
<br />
{| class="wikitable"<br />
|-<br />
| Offset<br />
| Type<br />
| Description<br />
|-<br />
| 0<br />
| s1.15<br />
| b0<br />
|-<br />
| 2<br />
| s1.15<br />
| a1 (negated)<br />
|}<br />
<br />
=== Biquad Filter ===<br />
<br />
This is a [[wikipedia:Digital_biquad_filter|biquadratic filter]].<br />
<br />
{| class="wikitable"<br />
|-<br />
| Offset<br />
| Type<br />
| Description<br />
|-<br />
| 0<br />
| s2.14<br />
| a2 (negated)<br />
|-<br />
| 2<br />
| s2.14<br />
| a1 (negated)<br />
|-<br />
| 4<br />
| s2.14<br />
| b2<br />
|-<br />
| 6<br />
| s2.14<br />
| b1<br />
|-<br />
| 8<br />
| s2.14<br />
| b0<br />
|}<br />
<br />
== Input status ==<br />
<br />
Read only. This structure is set by the DSP. This structure is 12 bytes long and there are 24 of them.<br />
<br />
{| class="wikitable"<br />
|-<br />
| Offset<br />
| Type<br />
| Description<br />
|-<br />
| 0<br />
| u8<br />
| Input Enabled?<br />
|-<br />
| 1<br />
| u8<br />
| Dirty flag for buffer id, set to 1 when buffer (after the first) starts playing<br />
|-<br />
| 2<br />
| u16<br />
| Sync count<br />
|-<br />
| 4<br />
| u32<br />
| Position (number of samples) into current buffer playback<br />
|-<br />
| 8<br />
| u16<br />
| Buffer id of the buffer that's just started playing.<br />
|-<br />
| 10<br />
| u16<br />
| -<br />
|}<br />
<br />
== Input ADPCM coefficients ==<br />
<br />
This is a 32 byte long structure. There are 24 of them.<br />
<br />
{| class="wikitable"<br />
|-<br />
| Offset<br />
| Type<br />
| Description<br />
|-<br />
| 0<br />
| s5.11[16]<br />
| ADPCM coefficents<br />
|}<br />
<br />
== DSP configuration ==<br />
<br />
=== Delay Effect ===<br />
<br />
Delay with feedback.<br />
<br />
Length of delay is expressed in terms of number of audio frames (there are 160 samples per audio frame).<br />
<br />
Feedback arm only has a gain on it. Under the feedback arm is a single-pole filter with the delay.<br />
<br />
=== Reverb Effect ===<br />
<br />
Reverb consists of two comb filters and one all-pass filter in standard configuration.<br />
<br />
== DSP status ==<br />
<br />
Read only.<br />
<br />
== Output samples ==<br />
<br />
Read only. This structure is 640 bytes long. Output is stereo (the 3DS has two speakers).<br />
<br />
{| class="wikitable"<br />
|-<br />
| Offset<br />
| Type<br />
| Description<br />
|-<br />
| 0<br />
| s16[160]<br />
| Left-channel Samples<br />
|-<br />
| 320<br />
| s16[160]<br />
| Right-channel Samples<br />
|}<br />
<br />
== Intermediate mix samples ==<br />
<br />
Read/Write.<br />
<br />
PCM32. Also serves an aux function, allowing the ARM11 to apply custom effects to audio. Internal format of the DSP firmware is quadaphonic audio.<br />
<br />
This structure is 5120 bytes long.<br />
<br />
{| class="wikitable"<br />
|-<br />
| Offset<br />
| Type<br />
| Description<br />
|-<br />
| 0<br />
| IntermediateSample[160]<br />
| Samples<br />
|}<br />
<br />
Yes, this has the dimensionality opposite to that of the output samples, that is not a mistake.<br />
<br />
=== Intermediate sample ===<br />
<br />
A quadraphonic sample.<br />
<br />
{| class="wikitable"<br />
|-<br />
| Offset<br />
| Type<br />
| Description<br />
|-<br />
| 0<br />
| s32<br />
| Left Channel A<br />
|-<br />
| 4<br />
| s32<br />
| Right Channel A<br />
|-<br />
| 8<br />
| s32<br />
| Left Channel B<br />
|-<br />
| 12<br />
| s32<br />
| Right Channel B<br />
|}<br />
<br />
== Compressor table ==<br />
<br />
A precomputed response curve lookup table for the compressor.</div>
Merry
https://www.3dbrew.org/w/index.php?title=DSP_Memory_Region&diff=17565
DSP Memory Region
2016-06-23T11:21:47Z
<p>Merry: </p>
<hr />
<div>'''Some of this is known to be incorrect. I'll correct this in a few months after a bit more RE work. [[User:Merry|Merry]] ([[User talk:Merry|talk]]) 21:10, 28 January 2016 (CET)'''<br />
<br />
----<br />
<br />
*Note that everything below will vary depending on the exact DSP firmware used and different variants have slightly different behaviours.*<br />
<br />
The DSP communicates with the application through two shared memory areas 0x8000 bytes long each (at 0x1FF50000 and 0x1FF70000 respectively). The DSP alternates between the use of these two areas (much like a double-buffer). Each area has 15 structures within it. The location of these structures can be obtained by [[DSP:ReadPipe|reading channel 2 of the DSP pipe]]. A list of structures in the order the DSP addresses are read from the pipe follows:<br />
<br />
1. Frame count<br />
<br />
2. Input configurations<br />
<br />
3. Input status<br />
<br />
4. Input ADPCM coefficients<br />
<br />
5. DSP configuration<br />
<br />
6. DSP status<br />
<br />
7. Output samples<br />
<br />
8. Intermediate mix samples<br />
<br />
9. Compressor table<br />
<br />
10. DSP debug statistics<br />
<br />
11. Unknown Coefficients<br />
<br />
12. Unknown Coefficients<br />
<br />
13. Unknown Coefficients<br />
<br />
14. Surround sound biquad filter 1<br />
<br />
15. Surround sound biquad filter 2<br />
<br />
The DSP has 24 inputs, each of which are individually configurable. These 24 inputs each produce three sets of 4 audio channels (two left, two right). <br />
<br />
These four audio channels feed into three intermediate mixers. Two of these intermediate mixers are used for effects and aux.<br />
<br />
== Frame Count ==<br />
<br />
The frame count of the first region must be even and the frame count of the second region must be odd.<br />
<br />
The frame with the higher count is the "current region".<br />
<br />
The DSP firmware only responds if the first frame count is 4.<br />
<br />
== Input Config ==<br />
<br />
A 192 byte long structure. There are 24 of them.<br />
<br />
{| class="wikitable"<br />
|-<br />
| Offset<br />
| Type<br />
| Description<br />
|-<br />
| 0<br />
| u32<br />
| Dirty flags<br />
|-<br />
| 4<br />
| f32[3][2][2]<br />
| Input Gain (Each input has 12 channels)<br />
|-<br />
| 52<br />
| f32<br />
| Rate multiplier (1.0x == native DSP rate)<br />
|-<br />
| 56<br />
| u8<br />
| Interpolation mode<br />
|-<br />
| 57<br />
| u8<br />
| Polyphase filter select<br />
|-<br />
| 58<br />
| u16<br />
| bit[0]: Simple Filter enabled, bit[1]: Biquadratic Filter enabled<br />
|-<br />
| 60<br />
| SimpleFilter<br />
| Simple Filter (One pole normalized recursive linear filter)<br />
|-<br />
| 64<br />
| BiquadFilter<br />
| Biquadratic Filter (Two poles two zeros normalized recursive linear filter)<br />
|-<br />
| 74<br />
| u16<br />
| Bitmap of which buffers in queue are dirty<br />
|-<br />
| 76<br />
| Buffer[4]<br />
| Buffer queue<br />
|-<br />
| 156<br />
| u32<br />
| -<br />
|-<br />
| 160<br />
| u16<br />
| Is Active<br />
|-<br />
| 162<br />
| u16 <br />
| Sync Count<br />
|-<br />
| 164<br />
| u32<br />
| Play position<br />
|-<br />
| 168<br />
| 4<br />
| ?<br />
|-<br />
| 172<br />
| u32<br />
| Physical address of embedded buffer<br />
|-<br />
| 176<br />
| u32<br />
| Number of samples in embedded buffer<br />
|-<br />
| 180<br />
| u16<br />
| Format<br />
|-<br />
| 182<br />
| AdpcmData<br />
| ADPCM data associated with embedded buffer<br />
|-<br />
| 188<br />
| u16<br />
| bit[0]: ADPCM updated?; bit[1]: Is looping?r<br />
|-<br />
| 190<br />
| u16<br />
| Buffer Id of embedded buffer<br />
|}<br />
<br />
There is a 2 sample delay in this preprocessing stage, likely due to the interpolation step.<br />
<br />
=== Format ===<br />
<br />
This is a u16.<br />
<br />
{| class="wikitable"<br />
|-<br />
| Bits<br />
| Desciption<br />
|-<br />
| 0-1<br />
| Number of channels: 0,1,3 = mono; 2 = stereo<br />
|-<br />
| 2-3<br />
| Buffer codec: [[BCWAV#Encoding|0:PCM8; 1:PCM16; 2:ADPCM]]<br />
|-<br />
| 5 <br />
| Fade<br />
|}<br />
<br />
=== Buffer ===<br />
<br />
{| class="wikitable"<br />
|-<br />
| Offset<br />
| Type<br />
| Description<br />
|-<br />
| 0<br />
| u32<br />
| Physical Address<br />
|-<br />
| 4 <br />
| u32<br />
| Sample Count<br />
|-<br />
| 8<br />
| AdpcmData<br />
| ADPCM data<br />
|-<br />
| 14<br />
| u8<br />
| ADPCM data dirty?<br />
|-<br />
| 15<br />
| u8<br />
| Looping?<br />
|-<br />
| 16<br />
| u16<br />
| Buffer Id<br />
|-<br />
| 18<br />
| u16<br />
| -<br />
|}<br />
<br />
=== Adpcm Data === <br />
<br />
{| class="wikitable"<br />
|-<br />
| 0<br />
| u8<br />
| ADPCM predictor/scale<br />
|-<br />
| 1<br />
| u8<br />
| -<br />
|-<br />
| 2<br />
| s16<br />
| ADPCM y[n-1]<br />
|-<br />
| 4<br />
| s16<br />
| ADPCM y[n-2]<br />
|}<br />
<br />
<br />
=== Simple Filter ===<br />
<br />
This is a standard single-pole filter. The fall-off is 6dB per octave as you would expect.<br />
<br />
{| class="wikitable"<br />
|-<br />
| Offset<br />
| Type<br />
| Description<br />
|-<br />
| 0<br />
| s1.15<br />
| b0<br />
|-<br />
| 2<br />
| s1.15<br />
| a1 (negated)<br />
|}<br />
<br />
=== Biquad Filter ===<br />
<br />
This is a [[wikipedia:Digital_biquad_filter|biquadratic filter]].<br />
<br />
{| class="wikitable"<br />
|-<br />
| Offset<br />
| Type<br />
| Description<br />
|-<br />
| 0<br />
| s2.14<br />
| a2 (negated)<br />
|-<br />
| 2<br />
| s2.14<br />
| a1 (negated)<br />
|-<br />
| 4<br />
| s2.14<br />
| b2<br />
|-<br />
| 6<br />
| s2.14<br />
| b1<br />
|-<br />
| 8<br />
| s2.14<br />
| b0<br />
|}<br />
<br />
== Input status ==<br />
<br />
Read only. This structure is set by the DSP. This structure is 12 bytes long and there are 24 of them.<br />
<br />
{| class="wikitable"<br />
|-<br />
| Offset<br />
| Type<br />
| Description<br />
|-<br />
| 0<br />
| u8<br />
| Input Enabled?<br />
|-<br />
| 1<br />
| u8<br />
| Dirty flag for buffer id, set to 1 when buffer (after the first) starts playing<br />
|-<br />
| 2<br />
| u16<br />
| Sync count<br />
|-<br />
| 4<br />
| u32<br />
| Position (number of samples) into current buffer playback<br />
|-<br />
| 8<br />
| u16<br />
| Buffer id of the buffer that's just started playing.<br />
|-<br />
| 10<br />
| u16<br />
| -<br />
|}<br />
<br />
== Input ADPCM coefficients ==<br />
<br />
This is a 32 byte long structure. There are 24 of them.<br />
<br />
{| class="wikitable"<br />
|-<br />
| Offset<br />
| Type<br />
| Description<br />
|-<br />
| 0<br />
| s5.11[16]<br />
| ADPCM coefficents<br />
|}<br />
<br />
== DSP configuration ==<br />
<br />
=== Delay Effect ===<br />
<br />
Delay with feedback.<br />
<br />
Length of delay is expressed in terms of number of audio frames (there are 160 samples per audio frame).<br />
<br />
Feedback arm only has a gain on it. Under the feedback arm is a single-pole filter with the delay.<br />
<br />
=== Reverb Effect ===<br />
<br />
Reverb consists of two comb filters and one all-pass filter in standard configuration.<br />
<br />
== DSP status ==<br />
<br />
Read only.<br />
<br />
== Output samples ==<br />
<br />
Read only. This structure is 640 bytes long. Output is stereo (the 3DS has two speakers).<br />
<br />
{| class="wikitable"<br />
|-<br />
| Offset<br />
| Type<br />
| Description<br />
|-<br />
| 0<br />
| s16[160]<br />
| Left-channel Samples<br />
|-<br />
| 320<br />
| s16[160]<br />
| Right-channel Samples<br />
|}<br />
<br />
== Intermediate mix samples ==<br />
<br />
Read/Write.<br />
<br />
PCM32. Also serves an aux function, allowing the ARM11 to apply custom effects to audio. Internal format of the DSP firmware is quadaphonic audio.<br />
<br />
This structure is 5120 bytes long.<br />
<br />
{| class="wikitable"<br />
|-<br />
| Offset<br />
| Type<br />
| Description<br />
|-<br />
| 0<br />
| IntermediateSample[160]<br />
| Samples. There are <br />
|}<br />
<br />
Yes, this has the dimensionality opposite to that of the output samples, that is not a mistake.<br />
<br />
=== Intermediate sample ===<br />
<br />
A quadraphonic sample.<br />
<br />
{| class="wikitable"<br />
|-<br />
| Offset<br />
| Type<br />
| Description<br />
|-<br />
| 0<br />
| s32<br />
| Left Channel A<br />
|-<br />
| 4<br />
| s32<br />
| Right Channel A<br />
|-<br />
| 8<br />
| s32<br />
| Left Channel B<br />
|-<br />
| 12<br />
| s32<br />
| Right Channel B<br />
|}<br />
<br />
== Compressor table ==<br />
<br />
A precomputed response curve lookup table for the compressor.</div>
Merry
https://www.3dbrew.org/w/index.php?title=DSP_Memory_Region&diff=17564
DSP Memory Region
2016-06-23T11:15:42Z
<p>Merry: /* Output samples */</p>
<hr />
<div>'''Some of this is known to be incorrect. I'll correct this in a few months after a bit more RE work. [[User:Merry|Merry]] ([[User talk:Merry|talk]]) 21:10, 28 January 2016 (CET)'''<br />
<br />
----<br />
<br />
*Note that everything below will vary depending on the exact DSP firmware used and different variants have slightly different behaviours.*<br />
<br />
The DSP communicates with the application through two shared memory areas 0x8000 bytes long each (at 0x1FF50000 and 0x1FF70000 respectively). The DSP alternates between the use of these two areas (much like a double-buffer). Each area has 15 structures within it. The location of these structures can be obtained by [[DSP:ReadPipe|reading channel 2 of the DSP pipe]]. A list of structures in the order the DSP addresses are read from the pipe follows:<br />
<br />
1. Frame count<br />
<br />
2. Input configurations<br />
<br />
3. Input status<br />
<br />
4. Input ADPCM coefficients<br />
<br />
5. DSP configuration<br />
<br />
6. DSP status<br />
<br />
7. Output samples<br />
<br />
8. Intermediate mix samples<br />
<br />
9. Compressor table<br />
<br />
10. DSP debug statistics<br />
<br />
11. Unknown Coefficients<br />
<br />
12. Unknown Coefficients<br />
<br />
13. Unknown Coefficients<br />
<br />
14. Surround sound biquad filter 1<br />
<br />
15. Surround sound biquad filter 2<br />
<br />
The DSP has 24 inputs, each of which are individually configurable. These 24 inputs each produce three sets of 4 audio channels (two left, two right). <br />
<br />
These four audio channels feed into three intermediate mixers. Two of these intermediate mixers are used for effects and aux.<br />
<br />
== Frame Count ==<br />
<br />
The frame count of the first region must be even and the frame count of the second region must be odd.<br />
<br />
The frame with the higher count is the "current region".<br />
<br />
The DSP firmware only responds if the first frame count is 4.<br />
<br />
== Input Config ==<br />
<br />
A 192 byte long structure. There are 24 of them.<br />
<br />
{| class="wikitable"<br />
|-<br />
| Offset<br />
| Type<br />
| Description<br />
|-<br />
| 0<br />
| u32<br />
| Dirty flags<br />
|-<br />
| 4<br />
| f32[3][2][2]<br />
| Input Gain (Each input has 12 channels)<br />
|-<br />
| 52<br />
| f32<br />
| Rate multiplier (1.0x == native DSP rate)<br />
|-<br />
| 56<br />
| u8<br />
| Interpolation mode<br />
|-<br />
| 57<br />
| u8<br />
| Polyphase filter select<br />
|-<br />
| 58<br />
| u16<br />
| bit[0]: Simple Filter enabled, bit[1]: Biquadratic Filter enabled<br />
|-<br />
| 60<br />
| SimpleFilter<br />
| Simple Filter (One pole normalized recursive linear filter)<br />
|-<br />
| 64<br />
| BiquadFilter<br />
| Biquadratic Filter (Two poles two zeros normalized recursive linear filter)<br />
|-<br />
| 74<br />
| u16<br />
| Bitmap of which buffers in queue are dirty<br />
|-<br />
| 76<br />
| Buffer[4]<br />
| Buffer queue<br />
|-<br />
| 156<br />
| u32<br />
| -<br />
|-<br />
| 160<br />
| u16<br />
| Is Active<br />
|-<br />
| 162<br />
| u16 <br />
| Sync Count<br />
|-<br />
| 164<br />
| u32<br />
| Play position<br />
|-<br />
| 168<br />
| 4<br />
| ?<br />
|-<br />
| 172<br />
| u32<br />
| Physical address of embedded buffer<br />
|-<br />
| 176<br />
| u32<br />
| Number of samples in embedded buffer<br />
|-<br />
| 180<br />
| u16<br />
| Format<br />
|-<br />
| 182<br />
| AdpcmData<br />
| ADPCM data associated with embedded buffer<br />
|-<br />
| 188<br />
| u16<br />
| bit[0]: ADPCM updated?; bit[1]: Is looping?r<br />
|-<br />
| 190<br />
| u16<br />
| Buffer Id of embedded buffer<br />
|}<br />
<br />
There is a 2 sample delay in this preprocessing stage, likely due to the interpolation step.<br />
<br />
=== Format ===<br />
<br />
This is a u16.<br />
<br />
{| class="wikitable"<br />
|-<br />
| Bits<br />
| Desciption<br />
|-<br />
| 0-1<br />
| Number of channels: 0,1,3 = mono; 2 = stereo<br />
|-<br />
| 2-3<br />
| Buffer codec: [[BCWAV#Encoding|0:PCM8; 1:PCM16; 2:ADPCM]]<br />
|-<br />
| 5 <br />
| Fade<br />
|}<br />
<br />
=== Buffer ===<br />
<br />
{| class="wikitable"<br />
|-<br />
| Offset<br />
| Type<br />
| Description<br />
|-<br />
| 0<br />
| u32<br />
| Physical Address<br />
|-<br />
| 4 <br />
| u32<br />
| Sample Count<br />
|-<br />
| 8<br />
| AdpcmData<br />
| ADPCM data<br />
|-<br />
| 14<br />
| u8<br />
| ADPCM data dirty?<br />
|-<br />
| 15<br />
| u8<br />
| Looping?<br />
|-<br />
| 16<br />
| u16<br />
| Buffer Id<br />
|-<br />
| 18<br />
| u16<br />
| -<br />
|}<br />
<br />
=== Adpcm Data === <br />
<br />
{| class="wikitable"<br />
|-<br />
| 0<br />
| u8<br />
| ADPCM predictor/scale<br />
|-<br />
| 1<br />
| u8<br />
| -<br />
|-<br />
| 2<br />
| s16<br />
| ADPCM y[n-1]<br />
|-<br />
| 4<br />
| s16<br />
| ADPCM y[n-2]<br />
|}<br />
<br />
<br />
=== Simple Filter ===<br />
<br />
This is a standard single-pole filter. The fall-off is 6dB per octave as you would expect.<br />
<br />
{| class="wikitable"<br />
|-<br />
| Offset<br />
| Type<br />
| Description<br />
|-<br />
| 0<br />
| s1.15<br />
| b0<br />
|-<br />
| 2<br />
| s1.15<br />
| a1 (negated)<br />
|}<br />
<br />
=== Biquad Filter ===<br />
<br />
This is a [[wikipedia:Digital_biquad_filter|biquadratic filter]].<br />
<br />
{| class="wikitable"<br />
|-<br />
| Offset<br />
| Type<br />
| Description<br />
|-<br />
| 0<br />
| s2.14<br />
| a2 (negated)<br />
|-<br />
| 2<br />
| s2.14<br />
| a1 (negated)<br />
|-<br />
| 4<br />
| s2.14<br />
| b2<br />
|-<br />
| 6<br />
| s2.14<br />
| b1<br />
|-<br />
| 8<br />
| s2.14<br />
| b0<br />
|}<br />
<br />
== Input status ==<br />
<br />
Read only. This structure is set by the DSP. This structure is 12 bytes long and there are 24 of them.<br />
<br />
{| class="wikitable"<br />
|-<br />
| Offset<br />
| Type<br />
| Description<br />
|-<br />
| 0<br />
| u8<br />
| Input Enabled?<br />
|-<br />
| 1<br />
| u8<br />
| Dirty flag for buffer id, set to 1 when buffer (after the first) starts playing<br />
|-<br />
| 2<br />
| u16<br />
| Sync count<br />
|-<br />
| 4<br />
| u32<br />
| Position (number of samples) into current buffer playback<br />
|-<br />
| 8<br />
| u16<br />
| Buffer id of the buffer that's just started playing.<br />
|-<br />
| 10<br />
| u16<br />
| -<br />
|}<br />
<br />
== Input ADPCM coefficients ==<br />
<br />
This is a 32 byte long structure. There are 24 of them.<br />
<br />
{| class="wikitable"<br />
|-<br />
| Offset<br />
| Type<br />
| Description<br />
|-<br />
| 0<br />
| s5.11[16]<br />
| ADPCM coefficents<br />
|}<br />
<br />
== DSP configuration ==<br />
<br />
=== Delay Effect ===<br />
<br />
Delay with feedback.<br />
<br />
Length of delay is expressed in terms of number of audio frames (there are 160 samples per audio frame).<br />
<br />
Feedback arm only has a gain on it. Under the feedback arm is a single-pole filter with the delay.<br />
<br />
=== Reverb Effect ===<br />
<br />
Reverb consists of two comb filters and one all-pass filter in standard configuration.<br />
<br />
== DSP status ==<br />
<br />
Read only.<br />
<br />
== Output samples ==<br />
<br />
Read only. This structure is 640 bytes long.<br />
<br />
{| class="wikitable"<br />
|-<br />
| Offset<br />
| Type<br />
| Description<br />
|-<br />
| 0<br />
| s16[160][2]<br />
| Samples (Stereo-output, 160 samples per channel)<br />
|}<br />
<br />
== Intermediate mix samples ==<br />
<br />
Read/Write.<br />
<br />
PCM32. Also serves an aux function, allowing the ARM11 to apply custom effects to audio.<br />
<br />
This structure is 5120 bytes long.<br />
<br />
{| class="wikitable"<br />
|-<br />
| Offset<br />
| Type<br />
| Description<br />
|-<br />
| 0<br />
| s32[2][4][160]<br />
| Samples<br />
|}<br />
<br />
== Compressor table ==<br />
<br />
A precomputed response curve lookup table for the compressor.</div>
Merry
https://www.3dbrew.org/w/index.php?title=DSP_Memory_Region&diff=17562
DSP Memory Region
2016-06-23T11:09:38Z
<p>Merry: /* Output samples */ oops</p>
<hr />
<div>'''Some of this is known to be incorrect. I'll correct this in a few months after a bit more RE work. [[User:Merry|Merry]] ([[User talk:Merry|talk]]) 21:10, 28 January 2016 (CET)'''<br />
<br />
----<br />
<br />
*Note that everything below will vary depending on the exact DSP firmware used and different variants have slightly different behaviours.*<br />
<br />
The DSP communicates with the application through two shared memory areas 0x8000 bytes long each (at 0x1FF50000 and 0x1FF70000 respectively). The DSP alternates between the use of these two areas (much like a double-buffer). Each area has 15 structures within it. The location of these structures can be obtained by [[DSP:ReadPipe|reading channel 2 of the DSP pipe]]. A list of structures in the order the DSP addresses are read from the pipe follows:<br />
<br />
1. Frame count<br />
<br />
2. Input configurations<br />
<br />
3. Input status<br />
<br />
4. Input ADPCM coefficients<br />
<br />
5. DSP configuration<br />
<br />
6. DSP status<br />
<br />
7. Output samples<br />
<br />
8. Intermediate mix samples<br />
<br />
9. Compressor table<br />
<br />
10. DSP debug statistics<br />
<br />
11. Unknown Coefficients<br />
<br />
12. Unknown Coefficients<br />
<br />
13. Unknown Coefficients<br />
<br />
14. Surround sound biquad filter 1<br />
<br />
15. Surround sound biquad filter 2<br />
<br />
The DSP has 24 inputs, each of which are individually configurable. These 24 inputs each produce three sets of 4 audio channels (two left, two right). <br />
<br />
These four audio channels feed into three intermediate mixers. Two of these intermediate mixers are used for effects and aux.<br />
<br />
== Frame Count ==<br />
<br />
The frame count of the first region must be even and the frame count of the second region must be odd.<br />
<br />
The frame with the higher count is the "current region".<br />
<br />
The DSP firmware only responds if the first frame count is 4.<br />
<br />
== Input Config ==<br />
<br />
A 192 byte long structure. There are 24 of them.<br />
<br />
{| class="wikitable"<br />
|-<br />
| Offset<br />
| Type<br />
| Description<br />
|-<br />
| 0<br />
| u32<br />
| Dirty flags<br />
|-<br />
| 4<br />
| f32[3][2][2]<br />
| Input Gain (Each input has 12 channels)<br />
|-<br />
| 52<br />
| f32<br />
| Rate multiplier (1.0x == native DSP rate)<br />
|-<br />
| 56<br />
| u8<br />
| Interpolation mode<br />
|-<br />
| 57<br />
| u8<br />
| Polyphase filter select<br />
|-<br />
| 58<br />
| u16<br />
| bit[0]: Simple Filter enabled, bit[1]: Biquadratic Filter enabled<br />
|-<br />
| 60<br />
| SimpleFilter<br />
| Simple Filter (One pole normalized recursive linear filter)<br />
|-<br />
| 64<br />
| BiquadFilter<br />
| Biquadratic Filter (Two poles two zeros normalized recursive linear filter)<br />
|-<br />
| 74<br />
| u16<br />
| Bitmap of which buffers in queue are dirty<br />
|-<br />
| 76<br />
| Buffer[4]<br />
| Buffer queue<br />
|-<br />
| 156<br />
| u32<br />
| -<br />
|-<br />
| 160<br />
| u16<br />
| Is Active<br />
|-<br />
| 162<br />
| u16 <br />
| Sync Count<br />
|-<br />
| 164<br />
| u32<br />
| Play position<br />
|-<br />
| 168<br />
| 4<br />
| ?<br />
|-<br />
| 172<br />
| u32<br />
| Physical address of embedded buffer<br />
|-<br />
| 176<br />
| u32<br />
| Number of samples in embedded buffer<br />
|-<br />
| 180<br />
| u16<br />
| Format<br />
|-<br />
| 182<br />
| AdpcmData<br />
| ADPCM data associated with embedded buffer<br />
|-<br />
| 188<br />
| u16<br />
| bit[0]: ADPCM updated?; bit[1]: Is looping?r<br />
|-<br />
| 190<br />
| u16<br />
| Buffer Id of embedded buffer<br />
|}<br />
<br />
There is a 2 sample delay in this preprocessing stage, likely due to the interpolation step.<br />
<br />
=== Format ===<br />
<br />
This is a u16.<br />
<br />
{| class="wikitable"<br />
|-<br />
| Bits<br />
| Desciption<br />
|-<br />
| 0-1<br />
| Number of channels: 0,1,3 = mono; 2 = stereo<br />
|-<br />
| 2-3<br />
| Buffer codec: [[BCWAV#Encoding|0:PCM8; 1:PCM16; 2:ADPCM]]<br />
|-<br />
| 5 <br />
| Fade<br />
|}<br />
<br />
=== Buffer ===<br />
<br />
{| class="wikitable"<br />
|-<br />
| Offset<br />
| Type<br />
| Description<br />
|-<br />
| 0<br />
| u32<br />
| Physical Address<br />
|-<br />
| 4 <br />
| u32<br />
| Sample Count<br />
|-<br />
| 8<br />
| AdpcmData<br />
| ADPCM data<br />
|-<br />
| 14<br />
| u8<br />
| ADPCM data dirty?<br />
|-<br />
| 15<br />
| u8<br />
| Looping?<br />
|-<br />
| 16<br />
| u16<br />
| Buffer Id<br />
|-<br />
| 18<br />
| u16<br />
| -<br />
|}<br />
<br />
=== Adpcm Data === <br />
<br />
{| class="wikitable"<br />
|-<br />
| 0<br />
| u8<br />
| ADPCM predictor/scale<br />
|-<br />
| 1<br />
| u8<br />
| -<br />
|-<br />
| 2<br />
| s16<br />
| ADPCM y[n-1]<br />
|-<br />
| 4<br />
| s16<br />
| ADPCM y[n-2]<br />
|}<br />
<br />
<br />
=== Simple Filter ===<br />
<br />
This is a standard single-pole filter. The fall-off is 6dB per octave as you would expect.<br />
<br />
{| class="wikitable"<br />
|-<br />
| Offset<br />
| Type<br />
| Description<br />
|-<br />
| 0<br />
| s1.15<br />
| b0<br />
|-<br />
| 2<br />
| s1.15<br />
| a1 (negated)<br />
|}<br />
<br />
=== Biquad Filter ===<br />
<br />
This is a [[wikipedia:Digital_biquad_filter|biquadratic filter]].<br />
<br />
{| class="wikitable"<br />
|-<br />
| Offset<br />
| Type<br />
| Description<br />
|-<br />
| 0<br />
| s2.14<br />
| a2 (negated)<br />
|-<br />
| 2<br />
| s2.14<br />
| a1 (negated)<br />
|-<br />
| 4<br />
| s2.14<br />
| b2<br />
|-<br />
| 6<br />
| s2.14<br />
| b1<br />
|-<br />
| 8<br />
| s2.14<br />
| b0<br />
|}<br />
<br />
== Input status ==<br />
<br />
Read only. This structure is set by the DSP. This structure is 12 bytes long and there are 24 of them.<br />
<br />
{| class="wikitable"<br />
|-<br />
| Offset<br />
| Type<br />
| Description<br />
|-<br />
| 0<br />
| u8<br />
| Input Enabled?<br />
|-<br />
| 1<br />
| u8<br />
| Dirty flag for buffer id, set to 1 when buffer (after the first) starts playing<br />
|-<br />
| 2<br />
| u16<br />
| Sync count<br />
|-<br />
| 4<br />
| u32<br />
| Position (number of samples) into current buffer playback<br />
|-<br />
| 8<br />
| u16<br />
| Buffer id of the buffer that's just started playing.<br />
|-<br />
| 10<br />
| u16<br />
| -<br />
|}<br />
<br />
== Input ADPCM coefficients ==<br />
<br />
This is a 32 byte long structure. There are 24 of them.<br />
<br />
{| class="wikitable"<br />
|-<br />
| Offset<br />
| Type<br />
| Description<br />
|-<br />
| 0<br />
| s5.11[16]<br />
| ADPCM coefficents<br />
|}<br />
<br />
== DSP configuration ==<br />
<br />
=== Delay Effect ===<br />
<br />
Delay with feedback.<br />
<br />
Length of delay is expressed in terms of number of audio frames (there are 160 samples per audio frame).<br />
<br />
Feedback arm only has a gain on it. Under the feedback arm is a single-pole filter with the delay.<br />
<br />
=== Reverb Effect ===<br />
<br />
Reverb consists of two comb filters and one all-pass filter in standard configuration.<br />
<br />
== DSP status ==<br />
<br />
Read only.<br />
<br />
== Output samples ==<br />
<br />
Read only. This structure is 640 bytes long.<br />
<br />
{| class="wikitable"<br />
|-<br />
| Offset<br />
| Type<br />
| Description<br />
|-<br />
| 0<br />
| s16[160][2]<br />
| Samples<br />
|}<br />
<br />
== Intermediate mix samples ==<br />
<br />
Read/Write.<br />
<br />
PCM32. Also serves an aux function, allowing the ARM11 to apply custom effects to audio.<br />
<br />
This structure is 5120 bytes long.<br />
<br />
{| class="wikitable"<br />
|-<br />
| Offset<br />
| Type<br />
| Description<br />
|-<br />
| 0<br />
| s32[2][4][160]<br />
| Samples<br />
|}<br />
<br />
== Compressor table ==<br />
<br />
A precomputed response curve lookup table for the compressor.</div>
Merry
https://www.3dbrew.org/w/index.php?title=DSP:GetSemaphoreEventHandle&diff=17369
DSP:GetSemaphoreEventHandle
2016-05-12T07:23:56Z
<p>Merry: </p>
<hr />
<div>=Request=<br />
{| class="wikitable" border="1"<br />
|-<br />
! Index Word<br />
! Description<br />
|-<br />
| 0<br />
| Header code [0x00160000]<br />
|}<br />
<br />
=Response=<br />
{| class="wikitable" border="1"<br />
|-<br />
! Index Word<br />
! Description<br />
|-<br />
| 0<br />
| Header code<br />
|-<br />
| 1<br />
| Resultcode<br />
|-<br />
| 2<br />
| n.a.?<br />
|-<br />
| 3<br />
| EventHandle<br />
|}<br />
<br />
==Semaphore==<br />
<br />
The ARM11 application signals this semaphore to indicate it has finished writing to the [[DSP Memory Region]] this audio frame.</div>
Merry
https://www.3dbrew.org/w/index.php?title=DSP_Binary&diff=16709
DSP Binary
2016-04-15T12:25:40Z
<p>Merry: </p>
<hr />
<div>[[Category:File formats]]<br />
<br />
{| class="wikitable" border="1"<br />
! Offset<br />
! Size<br />
! Description<br />
|-<br />
| 0x0<br />
| 0x100<br />
| RSA Signature over bytes 0x100-0x300<br />
|-<br />
| 0x100<br />
| 4<br />
| Magic ('DSP1')<br />
|-<br />
| 0x104<br />
| 4<br />
| DSP binary size<br />
|-<br />
| 0x108<br />
| 2<br />
| Memory layout (bits 0-7: Program ram, 8-15: Data ram). Each bit represents a memory region. The region is always 0x8000 bytes in size (the first region starts at 0x1FF00000; the next is a 0x1FF08000 and so on). The HW registers for DSP memory configuration are [[PDN_Registers#PDN_SHAREDWRAM_32K_DATA|PDN_SHAREDWRAM_32K_DATA]] and [[PDN_Registers#PDN_SHAREDWRAM_32K_CODE|PDN_SHAREDWRAM_32K_CODE]], located at physical address 0x10140000 (mapped to 0x1EC40000).<br />
|-<br />
| 0x10C<br />
| 1<br />
|?<br />
|-<br />
| 0x10D<br />
| 1<br />
| Special segment memory type (0=1=0x1FF00000(Program ram)+,2=0x1FF40000(Data ram)+)<br />
|-<br />
| 0x10E<br />
| 1<br />
| Num segments (must be 1-10)<br />
|-<br />
| 0x10F<br />
| 1<br />
| Flags (bit0=?, bit1=load special segment)<br />
|-<br />
| 0x110<br />
| 4<br />
| Special segment Start address in 16-bit words<br />
|-<br />
| 0x114<br />
| 4<br />
| Special segment size in bytes<br />
|-<br />
| 0x118<br />
| 8<br />
| Zero<br />
|-<br />
| 0x120<br />
| 0x30*10<br />
| Segment records<br />
|}<br />
<br />
If "special segment" flag is set, 0x214 bytes are read from [[CfgS:GetConfigInfoBlk8]] block 0x70000, and then copied to the special segment given. If the reading fails, zeroes are written in its place. The purpose of this segment is currently unknown. <br />
<br />
Each segment record:<br />
<br />
{| class="wikitable" border="1"<br />
! Offset<br />
! Size<br />
! Description<br />
|-<br />
| 0<br />
| 4<br />
| Offset data<br />
|-<br />
| 4<br />
| 4<br />
| Start address in 16-bit words (must be < 0x20000 for type 0, < 0x10000 for type 1,2)<br />
|-<br />
| 8<br />
| 4<br />
| Size in bytes<br />
|-<br />
| 15<br />
| 1<br />
| Memory type (0=1=0x1FF00000 (Program ram)+,2=0x1FF40000 (Data ram)+)<br />
|-<br />
| 16<br />
| 32<br />
| SHA256 hash of segment<br />
|}<br />
<br />
The normal ending of this files is *.cdc</div>
Merry
https://www.3dbrew.org/w/index.php?title=DSP_Binary&diff=16708
DSP Binary
2016-04-15T12:25:12Z
<p>Merry: </p>
<hr />
<div>[[Category:File formats]]<br />
<br />
{| class="wikitable" border="1"<br />
! Offset<br />
! Size<br />
! Description<br />
|-<br />
| 0x0<br />
| 0x100<br />
| RSA Signature over bytes 0x100-0x300<br />
|-<br />
| 0x100<br />
| 4<br />
| Magic ('DSP1')<br />
|-<br />
| 0x104<br />
| 4<br />
| DSP binary size<br />
|-<br />
| 0x108<br />
| 2<br />
| Memory layout (bits 0-7: Program ram, 8-15: Data ram). Each bit represents a memory region. The region is always 0x8000 bytes in size (the first region starts at 0x1FF00000; the next is a 0x1FF08000 and so on). The HW registers for DSP memory configuration are [[http://www.3dbrew.org/wiki/PDN_Registers#PDN_SHAREDWRAM_32K_DATA|PDN_SHAREDWRAM_32K_DATA]] and [[http://www.3dbrew.org/wiki/PDN_Registers#PDN_SHAREDWRAM_32K_CODE|PDN_SHAREDWRAM_32K_CODE]], located at physical address 0x10140000 (mapped to 0x1EC40000).<br />
|-<br />
| 0x10C<br />
| 1<br />
|?<br />
|-<br />
| 0x10D<br />
| 1<br />
| Special segment memory type (0=1=0x1FF00000(Program ram)+,2=0x1FF40000(Data ram)+)<br />
|-<br />
| 0x10E<br />
| 1<br />
| Num segments (must be 1-10)<br />
|-<br />
| 0x10F<br />
| 1<br />
| Flags (bit0=?, bit1=load special segment)<br />
|-<br />
| 0x110<br />
| 4<br />
| Special segment Start address in 16-bit words<br />
|-<br />
| 0x114<br />
| 4<br />
| Special segment size in bytes<br />
|-<br />
| 0x118<br />
| 8<br />
| Zero<br />
|-<br />
| 0x120<br />
| 0x30*10<br />
| Segment records<br />
|}<br />
<br />
If "special segment" flag is set, 0x214 bytes are read from [[CfgS:GetConfigInfoBlk8]] block 0x70000, and then copied to the special segment given. If the reading fails, zeroes are written in its place. The purpose of this segment is currently unknown. <br />
<br />
Each segment record:<br />
<br />
{| class="wikitable" border="1"<br />
! Offset<br />
! Size<br />
! Description<br />
|-<br />
| 0<br />
| 4<br />
| Offset data<br />
|-<br />
| 4<br />
| 4<br />
| Start address in 16-bit words (must be < 0x20000 for type 0, < 0x10000 for type 1,2)<br />
|-<br />
| 8<br />
| 4<br />
| Size in bytes<br />
|-<br />
| 15<br />
| 1<br />
| Memory type (0=1=0x1FF00000 (Program ram)+,2=0x1FF40000 (Data ram)+)<br />
|-<br />
| 16<br />
| 32<br />
| SHA256 hash of segment<br />
|}<br />
<br />
The normal ending of this files is *.cdc</div>
Merry
https://www.3dbrew.org/w/index.php?title=DSP:SendDataIsEmpty&diff=16707
DSP:SendDataIsEmpty
2016-04-15T11:22:35Z
<p>Merry: </p>
<hr />
<div>=Request=<br />
{| class="wikitable" border="1"<br />
|-<br />
! Index Word<br />
! Description<br />
|-<br />
| 0<br />
| Header code [0x00040040]<br />
|-<br />
| 1<br />
| [[DSP_Registers#DSP_CMDX|Register number]]<br />
|}<br />
<br />
=Response=<br />
{| class="wikitable" border="1"<br />
|-<br />
! Index Word<br />
! Description<br />
|-<br />
| 0<br />
| Header code<br />
|-<br />
| 1<br />
| Result code<br />
|-<br />
| 2<br />
| Command Register Read Flag (0 = not empty, 1 = empty)<br />
|}</div>
Merry
https://www.3dbrew.org/w/index.php?title=DSP:SendData&diff=16706
DSP:SendData
2016-04-15T11:21:55Z
<p>Merry: </p>
<hr />
<div>=Request=<br />
{| class="wikitable" border="1"<br />
|-<br />
! Index Word<br />
! Description<br />
|-<br />
| 0<br />
| Header code [0x00030080]<br />
|-<br />
| 1<br />
| [[DSP_Registers#DSP_CMDX|Register number]]<br />
|-<br />
| 2<br />
| Value<br />
|}<br />
<br />
=Response=<br />
{| class="wikitable" border="1"<br />
|-<br />
! Index Word<br />
! Description<br />
|-<br />
| 0<br />
| Header code<br />
|-<br />
| 1<br />
| Result code<br />
|}</div>
Merry
https://www.3dbrew.org/w/index.php?title=DSP:RecvData&diff=16705
DSP:RecvData
2016-04-15T11:21:21Z
<p>Merry: </p>
<hr />
<div>=Request=<br />
{| class="wikitable" border="1"<br />
|-<br />
! Index Word<br />
! Description<br />
|-<br />
| 0<br />
| Header code [0x00010040]<br />
|-<br />
| 1<br />
| [[DSP_Registers#DSP_REPX|Register number]]<br />
|}<br />
<br />
=Response=<br />
{| class="wikitable" border="1"<br />
|-<br />
! Index Word<br />
! Description<br />
|-<br />
| 0<br />
| Header code<br />
|-<br />
| 1<br />
| Result code<br />
|-<br />
| 2<br />
| u16, Register value<br />
|}</div>
Merry
https://www.3dbrew.org/w/index.php?title=DSP:RecvDataIsReady&diff=16704
DSP:RecvDataIsReady
2016-04-15T11:15:37Z
<p>Merry: </p>
<hr />
<div>=Request=<br />
{| class="wikitable" border="1"<br />
|-<br />
! Index Word<br />
! Description<br />
|-<br />
| 0<br />
| Header code [0x00020040]<br />
|-<br />
| 1<br />
| [[DSP_Registers#DSP_REPX|Register number]]<br />
|}<br />
<br />
=Response=<br />
{| class="wikitable" border="1"<br />
|-<br />
! Index Word<br />
! Description<br />
|-<br />
| 0<br />
| Header code<br />
|-<br />
| 1<br />
| Result code<br />
|-<br />
| 2<br />
| Reply Register Update Flag (0 = not ready, 1 = ready)<br />
|}</div>
Merry
https://www.3dbrew.org/w/index.php?title=DSP_Registers&diff=16702
DSP Registers
2016-04-15T10:24:38Z
<p>Merry: </p>
<hr />
<div>=Registers=<br />
<br />
{| class="wikitable" border="1"<br />
! Old3DS<br />
! Name<br />
! Physical Address<br />
! Width<br />
! Used by<br />
|-<br />
| style="background: green" | Yes<br />
| [[#DSP_PDATA|DSP_PDATA]]<br />
| 0x10203000<br />
| 2<br />
|<br />
|-<br />
| style="background: green" | Yes<br />
| [[#DSP_PADR|DSP_PADR]]<br />
| 0x10203004<br />
| 2<br />
|<br />
|-<br />
| style="background: green" | Yes<br />
| [[#DSP_PCFG|DSP_PCFG]]<br />
| 0x10203008<br />
| 2<br />
|<br />
|-<br />
| style="background: green" | Yes<br />
| [[#DSP_PSTS|DSP_PSTS]]<br />
| 0x1020300C<br />
| 2<br />
|<br />
|-<br />
| style="background: green" | Yes<br />
| [[#DSP_PSEM|DSP_PSEM]]<br />
| 0x10203010<br />
| 2<br />
|<br />
|-<br />
| style="background: green" | Yes<br />
| [[#DSP_PMASK|DSP_PMASK]]<br />
| 0x10203014<br />
| 2<br />
|<br />
|-<br />
| style="background: green" | Yes<br />
| [[#DSP_PCLEAR|DSP_PCLEAR]]<br />
| 0x10203018<br />
| 2<br />
|<br />
|-<br />
| style="background: green" | Yes<br />
| [[#DSP_SEM|DSP_SEM]]<br />
| 0x1020301C<br />
| 2<br />
|<br />
|-<br />
| style="background: green" | Yes<br />
| [[#DSP_CMD0|DSP_CMD0]]<br />
| 0x10203020<br />
| 2<br />
|<br />
|-<br />
| style="background: green" | Yes<br />
| [[#DSP_REP0|DSP_REP0]]<br />
| 0x10203024<br />
| 2<br />
|<br />
|-<br />
| style="background: green" | Yes<br />
| [[#DSP_CMD1|DSP_CMD1]]<br />
| 0x10203028<br />
| 2<br />
|<br />
|-<br />
| style="background: green" | Yes<br />
| [[#DSP_REP1|DSP_REP1]]<br />
| 0x1020302C<br />
| 2<br />
|<br />
|-<br />
| style="background: green" | Yes<br />
| [[#DSP_CMD2|DSP_CMD2]]<br />
| 0x10203030<br />
| 2<br />
|<br />
|-<br />
| style="background: green" | Yes<br />
| [[#DSP_REP2|DSP_REP2]]<br />
| 0x10203034<br />
| 2<br />
|<br />
|}<br />
<br />
== DSP_PDATA ==<br />
Data (one stage of the 16-stage Read FIFO).<br />
<br />
== DSP_PADR ==<br />
Lower 16bit of Address in DSP Memory. Note: The upper 16bit of Address must be configued in the DMA register (inside of the DSP).<br />
<br />
== DSP_PCFG - DSP Configuration (R/W) (16bit) ==<br />
<br />
{| class="wikitable" border="1"<br />
! Bits<br />
! Description<br />
|-<br />
| 0<br />
| DSP Reset (0=Release, 1=Reset) ;should be held "1" for 8 DSP clks<br />
|-<br />
| 1<br />
| Address Auto-Increment (0=Off, 1=On)<br />
|-<br />
| 2-3 <br />
| DSP Read Data Length (0=1 word, 1=8 words, 2=16 words, 3=Free-Run)<br />
|-<br />
| 4<br />
| DSP Read Start Flag (mem transfer via Read FIFO) (1=Start)<br />
|-<br />
| 5 <br />
| Interrupt Enable Read FIFO Full (0=Off, 1=On)<br />
|-<br />
| 6<br />
| Interrupt Enable Read FIFO Not-Empty (0=Off, 1=On)<br />
|-<br />
| 7<br />
| Interrupt Enable Write FIFO Full (0=Off, 1=On)<br />
|-<br />
| 8<br />
| Interrupt Enable Write FIFO Empty (0=Off, 1=On)<br />
|-<br />
| 9<br />
| Interrupt Enable Reply Register 0 (0=Off, 1=On)<br />
|-<br />
| 10<br />
| Interrupt Enable Reply Register 1 (0=Off, 1=On)<br />
|-<br />
| 11<br />
| Interrupt Enable Reply Register 2 (0=Off, 1=On)<br />
|-<br />
| 12-15<br />
| DSP Memory Transfer (0=Data Memory, 1=MMIO Register, 5=Program Memory)<br />
|}<br />
<br />
== DSP_PSTS ==<br />
{| class="wikitable" border="1"<br />
! Bits<br />
! Description<br />
|-<br />
| 0<br />
| Read Transfer Underway Flag (0=No, 1=Yes/From DSP Memory)<br />
|-<br />
| 1<br />
| Write Transfer Underway Flag (0=No, 1=Yes/To DSP Memory)<br />
|-<br />
| 2<br />
| Peripheral Reset Flag (0=No/Ready, 1=Reset/Busy)<br />
|-<br />
| 3-4<br />
| Unused<br />
|-<br />
| 5<br />
| Read FIFO Full Flag (0=No, 1=Yes)<br />
|-<br />
| 6<br />
| Read FIFO Not-Empty Flag (0=No, 1=Yes) ;ARM11 may read DSP_PDATA<br />
|-<br />
| 7<br />
| Write FIFO Full Flag (0=No, 1=Yes)<br />
|-<br />
| 8<br />
| Write FIFO Empty Flag (0=No, 1=Yes)<br />
|-<br />
| 9<br />
| Semaphore IRQ Flag (0=None, 1=IRQ)<br />
|-<br />
| 10<br />
| Reply Register 0 Update Flag (0=Was Written by DSP, 1=No)<br />
|-<br />
| 11<br />
| Reply Register 1 Update Flag (0=Was Written by DSP, 1=No)<br />
|-<br />
| 12<br />
| Reply Register 2 Update Flag (0=Was Written by DSP, 1=No)<br />
|-<br />
| 13<br />
| Command Register 0 Read Flag (0=Was Read by DSP, 1=No)<br />
|-<br />
| 14<br />
| Command Register 1 Read Flag (0=Was Read by DSP, 1=No)<br />
|-<br />
| 15<br />
| Command Register 2 Read Flag (0=Was Read by DSP, 1=No)<br />
|}<br />
Unknown if/when bit10-15 get reset... maybe after reading the status?<br />
<br />
== DSP_PSEM ==<br />
DSP-to-ARM11 Semaphore 0..15 Flags (0=Off, 1=On). Reportedly these flags are sent in ARM11-to-DSP direction. Confusingly, the other DSP_Pxxx registers are for opposite direction?<br />
<br />
== DSP_PMASK ==<br />
DSP-to-ARM11 Semaphore 0..15 Interrupt Disable (0=Enable, 1=Disable)<br />
<br />
== DSP_PCLEAR ==<br />
DSP-to-ARM11 Semaphore 0..15 Clear (0=No Change, 1=Clear). Reportedly clears bits in DSP_PSEM. [that's probably nonsense, clearing bits in DSP_SEM would make more sense]<br />
<br />
== DSP_SEM ==<br />
DSP-to-ARM11 Semaphore 0..15 Flags (0=Off, 1=On). Reportedly these flags are received in DSP-to-ARM11 direction.<br />
<br />
== DSP_CMDX ==<br />
Command/Data to DSP.<br />
<br />
== DSP_REPX ==<br />
Reply/Data from DSP.</div>
Merry
https://www.3dbrew.org/w/index.php?title=DSP_Memory_Region&diff=16253
DSP Memory Region
2016-03-28T12:04:54Z
<p>Merry: </p>
<hr />
<div>'''Some of this is known to be incorrect. I'll correct this in a few months after a bit more RE work. [[User:Merry|Merry]] ([[User talk:Merry|talk]]) 21:10, 28 January 2016 (CET)'''<br />
<br />
----<br />
<br />
*Note that everything below will vary depending on the exact DSP firmware used and different variants have slightly different behaviours.*<br />
<br />
The DSP communicates with the application through two shared memory areas 0x8000 bytes long each (at 0x1FF50000 and 0x1FF70000 respectively). The DSP alternates between the use of these two areas (much like a double-buffer). Each area has 15 structures within it. The location of these structures can be obtained by [[DSP:ReadPipe|reading channel 2 of the DSP pipe]]. A list of structures in the order the DSP addresses are read from the pipe follows:<br />
<br />
1. Frame count<br />
<br />
2. Input configurations<br />
<br />
3. Input status<br />
<br />
4. Input ADPCM coefficients<br />
<br />
5. DSP configuration<br />
<br />
6. DSP status<br />
<br />
7. Output samples<br />
<br />
8. Intermediate mix samples<br />
<br />
9. Compressor table<br />
<br />
10. DSP debug statistics<br />
<br />
11. Unknown Coefficients<br />
<br />
12. Unknown Coefficients<br />
<br />
13. Unknown Coefficients<br />
<br />
14. Surround sound biquad filter 1<br />
<br />
15. Surround sound biquad filter 2<br />
<br />
The DSP has 24 inputs, each of which are individually configurable. These 24 inputs each produce three sets of 4 audio channels (two left, two right). <br />
<br />
These four audio channels feed into three intermediate mixers. Two of these intermediate mixers are used for effects and aux.<br />
<br />
== Frame Count ==<br />
<br />
The frame count of the first region must be even and the frame count of the second region must be odd.<br />
<br />
The frame with the higher count is the "current region".<br />
<br />
The DSP firmware only responds if the first frame count is 4.<br />
<br />
== Input Config ==<br />
<br />
A 192 byte long structure. There are 24 of them.<br />
<br />
{| class="wikitable"<br />
|-<br />
| Offset<br />
| Type<br />
| Description<br />
|-<br />
| 0<br />
| u32<br />
| Dirty flags<br />
|-<br />
| 4<br />
| f32[3][2][2]<br />
| Input Gain (Each input has 12 channels)<br />
|-<br />
| 52<br />
| f32<br />
| Rate multiplier (1.0x == native DSP rate)<br />
|-<br />
| 56<br />
| u8<br />
| Interpolation mode<br />
|-<br />
| 57<br />
| u8<br />
| Polyphase filter select<br />
|-<br />
| 58<br />
| u16<br />
| bit[0]: Simple Filter enabled, bit[1]: Biquadratic Filter enabled<br />
|-<br />
| 60<br />
| SimpleFilter<br />
| Simple Filter (One pole normalized recursive linear filter)<br />
|-<br />
| 64<br />
| BiquadFilter<br />
| Biquadratic Filter (Two poles two zeros normalized recursive linear filter)<br />
|-<br />
| 74<br />
| u16<br />
| Bitmap of which buffers in queue are dirty<br />
|-<br />
| 76<br />
| Buffer[4]<br />
| Buffer queue<br />
|-<br />
| 156<br />
| u32<br />
| -<br />
|-<br />
| 160<br />
| u16<br />
| Is Active<br />
|-<br />
| 162<br />
| u16 <br />
| Sync Count<br />
|-<br />
| 164<br />
| u32<br />
| Play position<br />
|-<br />
| 168<br />
| 4<br />
| ?<br />
|-<br />
| 172<br />
| u32<br />
| Physical address of embedded buffer<br />
|-<br />
| 176<br />
| u32<br />
| Number of samples in embedded buffer<br />
|-<br />
| 180<br />
| u16<br />
| Format<br />
|-<br />
| 182<br />
| AdpcmData<br />
| ADPCM data associated with embedded buffer<br />
|-<br />
| 188<br />
| u16<br />
| bit[0]: ADPCM updated?; bit[1]: Is looping?r<br />
|-<br />
| 190<br />
| u16<br />
| Buffer Id of embedded buffer<br />
|}<br />
<br />
There is a 2 sample delay in this preprocessing stage, likely due to the interpolation step.<br />
<br />
=== Format ===<br />
<br />
This is a u16.<br />
<br />
{| class="wikitable"<br />
|-<br />
| Bits<br />
| Desciption<br />
|-<br />
| 0-1<br />
| Number of channels: 0,1,3 = mono; 2 = stereo<br />
|-<br />
| 2-3<br />
| Buffer codec: [[BCWAV#Encoding|0:PCM8; 1:PCM16; 2:ADPCM]]<br />
|-<br />
| 5 <br />
| Fade<br />
|}<br />
<br />
=== Buffer ===<br />
<br />
{| class="wikitable"<br />
|-<br />
| Offset<br />
| Type<br />
| Description<br />
|-<br />
| 0<br />
| u32<br />
| Physical Address<br />
|-<br />
| 4 <br />
| u32<br />
| Sample Count<br />
|-<br />
| 8<br />
| AdpcmData<br />
| ADPCM data<br />
|-<br />
| 14<br />
| u8<br />
| ADPCM data dirty?<br />
|-<br />
| 15<br />
| u8<br />
| Looping?<br />
|-<br />
| 16<br />
| u16<br />
| Buffer Id<br />
|-<br />
| 18<br />
| u16<br />
| -<br />
|}<br />
<br />
=== Adpcm Data === <br />
<br />
{| class="wikitable"<br />
|-<br />
| 0<br />
| u8<br />
| ADPCM predictor/scale<br />
|-<br />
| 1<br />
| u8<br />
| -<br />
|-<br />
| 2<br />
| s16<br />
| ADPCM y[n-1]<br />
|-<br />
| 4<br />
| s16<br />
| ADPCM y[n-2]<br />
|}<br />
<br />
<br />
=== Simple Filter ===<br />
<br />
This is a standard single-pole filter. The fall-off is 6dB per octave as you would expect.<br />
<br />
{| class="wikitable"<br />
|-<br />
| Offset<br />
| Type<br />
| Description<br />
|-<br />
| 0<br />
| s1.15<br />
| b0<br />
|-<br />
| 2<br />
| s1.15<br />
| a1 (negated)<br />
|}<br />
<br />
=== Biquad Filter ===<br />
<br />
This is a [[wikipedia:Digital_biquad_filter|biquadratic filter]].<br />
<br />
{| class="wikitable"<br />
|-<br />
| Offset<br />
| Type<br />
| Description<br />
|-<br />
| 0<br />
| s2.14<br />
| a2 (negated)<br />
|-<br />
| 2<br />
| s2.14<br />
| a1 (negated)<br />
|-<br />
| 4<br />
| s2.14<br />
| b2<br />
|-<br />
| 6<br />
| s2.14<br />
| b1<br />
|-<br />
| 8<br />
| s2.14<br />
| b0<br />
|}<br />
<br />
== Input status ==<br />
<br />
Read only. This structure is set by the DSP. This structure is 12 bytes long and there are 24 of them.<br />
<br />
{| class="wikitable"<br />
|-<br />
| Offset<br />
| Type<br />
| Description<br />
|-<br />
| 0<br />
| u8<br />
| Input Enabled?<br />
|-<br />
| 1<br />
| u8<br />
| Dirty flag for buffer id, set to 1 when buffer (after the first) starts playing<br />
|-<br />
| 2<br />
| u16<br />
| Sync count<br />
|-<br />
| 4<br />
| u32<br />
| Position (number of samples) into current buffer playback<br />
|-<br />
| 8<br />
| u16<br />
| Buffer id of the buffer that's just started playing.<br />
|-<br />
| 10<br />
| u16<br />
| -<br />
|}<br />
<br />
== Input ADPCM coefficients ==<br />
<br />
This is a 32 byte long structure. There are 24 of them.<br />
<br />
{| class="wikitable"<br />
|-<br />
| Offset<br />
| Type<br />
| Description<br />
|-<br />
| 0<br />
| s5.11[16]<br />
| ADPCM coefficents<br />
|}<br />
<br />
== DSP configuration ==<br />
<br />
=== Delay Effect ===<br />
<br />
Delay with feedback.<br />
<br />
Length of delay is expressed in terms of number of audio frames (there are 160 samples per audio frame).<br />
<br />
Feedback arm only has a gain on it. Under the feedback arm is a single-pole filter with the delay.<br />
<br />
=== Reverb Effect ===<br />
<br />
Reverb consists of two comb filters and one all-pass filter in standard configuration.<br />
<br />
== DSP status ==<br />
<br />
Read only.<br />
<br />
== Output samples ==<br />
<br />
Read only. This structure is 320 bytes long.<br />
<br />
{| class="wikitable"<br />
|-<br />
| Offset<br />
| Type<br />
| Description<br />
|-<br />
| 0<br />
| s16[160]<br />
| Samples<br />
|}<br />
<br />
== Intermediate mix samples ==<br />
<br />
Read/Write.<br />
<br />
PCM32. Also serves an aux function, allowing the ARM11 to apply custom effects to audio.<br />
<br />
This structure is 5120 bytes long.<br />
<br />
{| class="wikitable"<br />
|-<br />
| Offset<br />
| Type<br />
| Description<br />
|-<br />
| 0<br />
| s32[2][4][160]<br />
| Samples<br />
|}<br />
<br />
== Compressor table ==<br />
<br />
A precomputed response curve lookup table for the compressor.</div>
Merry
https://www.3dbrew.org/w/index.php?title=DSP_Memory_Region&diff=16216
DSP Memory Region
2016-03-25T20:20:19Z
<p>Merry: </p>
<hr />
<div>'''Some of this is known to be incorrect. I'll correct this in a few months after a bit more RE work. [[User:Merry|Merry]] ([[User talk:Merry|talk]]) 21:10, 28 January 2016 (CET)'''<br />
<br />
----<br />
<br />
*Note that everything below will vary depending on the exact DSP firmware used and different variants have slightly different behaviours.*<br />
<br />
The DSP communicates with the application through two shared memory areas 0x8000 bytes long each (at 0x1FF50000 and 0x1FF70000 respectively). The DSP alternates between the use of these two areas (much like a double-buffer). Each area has 15 structures within it. The location of these structures can be obtained by [[DSP:ReadPipe|reading channel 2 of the DSP pipe]]. A list of structures in the order the DSP addresses are read from the pipe follows:<br />
<br />
1. Frame count<br />
<br />
2. Input configurations<br />
<br />
3. Input status<br />
<br />
4. Input ADPCM coefficients<br />
<br />
5. DSP configuration<br />
<br />
6. DSP status<br />
<br />
7. Output samples<br />
<br />
8. Intermediate mix samples<br />
<br />
9. Compressor table<br />
<br />
10. DSP debug statistics<br />
<br />
11. Unknown Coefficients<br />
<br />
12. Unknown Coefficients<br />
<br />
13. Unknown Coefficients<br />
<br />
14. Surround sound biquad filter 1<br />
<br />
15. Surround sound biquad filter 2<br />
<br />
The DSP has 24 inputs, each of which are individually configurable. These 24 inputs each produce three sets of 4 audio channels (two left, two right). <br />
<br />
These four audio channels feed into three intermediate mixers. Two of these intermediate mixers are used for effects and aux.<br />
<br />
== Frame Count ==<br />
<br />
The frame count of the first region must be even and the frame count of the second region must be odd.<br />
<br />
The frame with the higher count is the "current region".<br />
<br />
The DSP firmware only responds if the first frame count is 4.<br />
<br />
== Input Config ==<br />
<br />
A 192 byte long structure. There are 24 of them.<br />
<br />
{| class="wikitable"<br />
|-<br />
| Offset<br />
| Type<br />
| Description<br />
|-<br />
| 0<br />
| u32<br />
| Dirty flags<br />
|-<br />
| 4<br />
| f32[3][2][2]<br />
| Input Gain (Each input has 12 channels)<br />
|-<br />
| 52<br />
| f32<br />
| Rate multiplier (1.0x == native DSP rate)<br />
|-<br />
| 56<br />
| u8<br />
| Interpolation mode<br />
|-<br />
| 57<br />
| u8<br />
| Polyphase filter select<br />
|-<br />
| 58<br />
| u16<br />
| bit[0]: Simple Filter enabled, bit[1]: Biquadratic Filter enabled<br />
|-<br />
| 60<br />
| SimpleFilter<br />
| Simple Filter (One pole normalized recursive linear filter)<br />
|-<br />
| 64<br />
| BiquadFilter<br />
| Biquadratic Filter (Two poles two zeros normalized recursive linear filter)<br />
|-<br />
| 74<br />
| u16<br />
| Bitmap of which buffers in queue are dirty<br />
|-<br />
| 76<br />
| Buffer[4]<br />
| Buffer queue<br />
|-<br />
| 156<br />
| u32<br />
| -<br />
|-<br />
| 160<br />
| u16<br />
| Is Active<br />
|-<br />
| 162<br />
| u16 <br />
| Sync Count<br />
|-<br />
| 164<br />
| u32<br />
| Play position<br />
|-<br />
| 168<br />
| 4<br />
| ?<br />
|-<br />
| 172<br />
| u32<br />
| Physical address of embedded buffer<br />
|-<br />
| 176<br />
| u32<br />
| Number of samples in embedded buffer<br />
|-<br />
| 180<br />
| u16<br />
| Format<br />
|-<br />
| 182<br />
| AdpcmData<br />
| ADPCM data associated with embedded buffer<br />
|-<br />
| 188<br />
| u16<br />
| bit[0]: ADPCM updated?; bit[1]: Is looping?r<br />
|-<br />
| 190<br />
| u16<br />
| Buffer Id of embedded buffer<br />
|}<br />
<br />
Activating the simple filter, the biquadratic filter or both causes a 2 sample delay.<br />
<br />
=== Format ===<br />
<br />
This is a u16.<br />
<br />
{| class="wikitable"<br />
|-<br />
| Bits<br />
| Desciption<br />
|-<br />
| 0-1<br />
| Number of channels: 0,1,3 = mono; 2 = stereo<br />
|-<br />
| 2-3<br />
| Buffer codec: [[BCWAV#Encoding|0:PCM8; 1:PCM16; 2:ADPCM]]<br />
|-<br />
| 5 <br />
| Fade<br />
|}<br />
<br />
=== Buffer ===<br />
<br />
{| class="wikitable"<br />
|-<br />
| Offset<br />
| Type<br />
| Description<br />
|-<br />
| 0<br />
| u32<br />
| Physical Address<br />
|-<br />
| 4 <br />
| u32<br />
| Sample Count<br />
|-<br />
| 8<br />
| AdpcmData<br />
| ADPCM data<br />
|-<br />
| 14<br />
| u8<br />
| ADPCM data dirty?<br />
|-<br />
| 15<br />
| u8<br />
| Looping?<br />
|-<br />
| 16<br />
| u16<br />
| Buffer Id<br />
|-<br />
| 18<br />
| u16<br />
| -<br />
|}<br />
<br />
=== Adpcm Data === <br />
<br />
{| class="wikitable"<br />
|-<br />
| 0<br />
| u8<br />
| ADPCM predictor/scale<br />
|-<br />
| 1<br />
| u8<br />
| -<br />
|-<br />
| 2<br />
| s16<br />
| ADPCM y[n-1]<br />
|-<br />
| 4<br />
| s16<br />
| ADPCM y[n-2]<br />
|}<br />
<br />
<br />
=== Simple Filter ===<br />
<br />
This is a standard single-pole filter. The fall-off is 6dB per octave as you would expect.<br />
<br />
{| class="wikitable"<br />
|-<br />
| Offset<br />
| Type<br />
| Description<br />
|-<br />
| 0<br />
| s1.15<br />
| b0<br />
|-<br />
| 2<br />
| s1.15<br />
| a1 (negated)<br />
|}<br />
<br />
=== Biquad Filter ===<br />
<br />
This is a [[wikipedia:Digital_biquad_filter|biquadratic filter]].<br />
<br />
{| class="wikitable"<br />
|-<br />
| Offset<br />
| Type<br />
| Description<br />
|-<br />
| 0<br />
| s2.14<br />
| a2 (negated)<br />
|-<br />
| 2<br />
| s2.14<br />
| a1 (negated)<br />
|-<br />
| 4<br />
| s2.14<br />
| b2<br />
|-<br />
| 6<br />
| s2.14<br />
| b1<br />
|-<br />
| 8<br />
| s2.14<br />
| b0<br />
|}<br />
<br />
== Input status ==<br />
<br />
Read only. This structure is set by the DSP. This structure is 12 bytes long and there are 24 of them.<br />
<br />
{| class="wikitable"<br />
|-<br />
| Offset<br />
| Type<br />
| Description<br />
|-<br />
| 0<br />
| u8<br />
| Input Enabled?<br />
|-<br />
| 1<br />
| u8<br />
| Dirty flag for buffer id, set to 1 when buffer (after the first) starts playing<br />
|-<br />
| 2<br />
| u16<br />
| Sync count<br />
|-<br />
| 4<br />
| u32<br />
| Position (number of samples) into current buffer playback<br />
|-<br />
| 8<br />
| u16<br />
| Buffer id of the buffer that's just started playing.<br />
|-<br />
| 10<br />
| u16<br />
| -<br />
|}<br />
<br />
== Input ADPCM coefficients ==<br />
<br />
This is a 32 byte long structure. There are 24 of them.<br />
<br />
{| class="wikitable"<br />
|-<br />
| Offset<br />
| Type<br />
| Description<br />
|-<br />
| 0<br />
| s5.11[16]<br />
| ADPCM coefficents<br />
|}<br />
<br />
== DSP configuration ==<br />
<br />
=== Delay Effect ===<br />
<br />
Delay with feedback.<br />
<br />
Length of delay is expressed in terms of number of audio frames (there are 160 samples per audio frame).<br />
<br />
Feedback arm only has a gain on it. Under the feedback arm is a single-pole filter with the delay.<br />
<br />
=== Reverb Effect ===<br />
<br />
Reverb consists of two comb filters and one all-pass filter in standard configuration.<br />
<br />
== DSP status ==<br />
<br />
Read only.<br />
<br />
== Output samples ==<br />
<br />
Read only. This structure is 320 bytes long.<br />
<br />
{| class="wikitable"<br />
|-<br />
| Offset<br />
| Type<br />
| Description<br />
|-<br />
| 0<br />
| s16[160]<br />
| Samples<br />
|}<br />
<br />
== Intermediate mix samples ==<br />
<br />
Read/Write.<br />
<br />
PCM32. Also serves an aux function, allowing the ARM11 to apply custom effects to audio.<br />
<br />
This structure is 5120 bytes long.<br />
<br />
{| class="wikitable"<br />
|-<br />
| Offset<br />
| Type<br />
| Description<br />
|-<br />
| 0<br />
| s32[2][4][160]<br />
| Samples<br />
|}<br />
<br />
== Compressor table ==<br />
<br />
A precomputed response curve lookup table for the compressor.</div>
Merry
https://www.3dbrew.org/w/index.php?title=DSP_Memory_Region&diff=16176
DSP Memory Region
2016-03-24T13:39:34Z
<p>Merry: /* Input Config */</p>
<hr />
<div>'''Some of this is known to be incorrect. I'll correct this in a few months after a bit more RE work. [[User:Merry|Merry]] ([[User talk:Merry|talk]]) 21:10, 28 January 2016 (CET)'''<br />
<br />
----<br />
<br />
*Note that everything below will vary depending on the exact DSP firmware used and different variants have slightly different behaviours.*<br />
<br />
The DSP communicates with the application through two shared memory areas 0x8000 bytes long each (at 0x1FF50000 and 0x1FF70000 respectively). The DSP alternates between the use of these two areas (much like a double-buffer). Each area has 15 structures within it. The location of these structures can be obtained by [[DSP:ReadPipe|reading channel 2 of the DSP pipe]]. A list of structures in the order the DSP addresses are read from the pipe follows:<br />
<br />
1. Frame count<br />
<br />
2. Input configurations<br />
<br />
3. Input status<br />
<br />
4. Input ADPCM coefficients<br />
<br />
5. DSP configuration<br />
<br />
6. DSP status<br />
<br />
7. Output samples<br />
<br />
8. Intermediate mix samples<br />
<br />
9. Compressor table<br />
<br />
10. DSP debug statistics<br />
<br />
11. Unknown Coefficients<br />
<br />
12. Unknown Coefficients<br />
<br />
13. Unknown Coefficients<br />
<br />
14. Surround sound biquad filter 1<br />
<br />
15. Surround sound biquad filter 2<br />
<br />
The DSP has 24 inputs, each of which are individually configurable. These 24 inputs each produce three sets of 4 audio channels (two left, two right). <br />
<br />
These four audio channels feed into three intermediate mixers. Two of these intermediate mixers are used for effects and aux.<br />
<br />
== Frame Count ==<br />
<br />
The frame count of the first region must be even and the frame count of the second region must be odd.<br />
<br />
The frame with the higher count is the "current region".<br />
<br />
The DSP firmware only responds if the first frame count is 4.<br />
<br />
== Input Config ==<br />
<br />
A 192 byte long structure. There are 24 of them.<br />
<br />
{| class="wikitable"<br />
|-<br />
| Offset<br />
| Type<br />
| Description<br />
|-<br />
| 0<br />
| u32<br />
| Dirty flags<br />
|-<br />
| 4<br />
| f32[3][2][2]<br />
| Input Gain (Each input has 12 channels)<br />
|-<br />
| 52<br />
| f32<br />
| Rate multiplier (1.0x == native DSP rate)<br />
|-<br />
| 56<br />
| u8<br />
| Interpolation mode<br />
|-<br />
| 57<br />
| u8<br />
| Polyphase filter select<br />
|-<br />
| 58<br />
| u16<br />
| bit[0]: Simple Filter enabled, bit[1]: Biquadratic Filter enabled<br />
|-<br />
| 60<br />
| SimpleFilter<br />
| Simple Filter (One pole normalized recursive linear filter)<br />
|-<br />
| 64<br />
| BiquadFilter<br />
| Biquadratic Filter (Two poles two zeros normalized recursive linear filter)<br />
|-<br />
| 74<br />
| u16<br />
| Bitmap of which buffers in queue are dirty<br />
|-<br />
| 76<br />
| Buffer[4]<br />
| Buffer queue<br />
|-<br />
| 156<br />
| u32<br />
| -<br />
|-<br />
| 160<br />
| u16<br />
| Is Active<br />
|-<br />
| 162<br />
| u16 <br />
| Sync Count<br />
|-<br />
| 164<br />
| u32<br />
| Play position<br />
|-<br />
| 168<br />
| 4<br />
| ?<br />
|-<br />
| 172<br />
| u32<br />
| Physical address of embedded buffer<br />
|-<br />
| 176<br />
| u32<br />
| Number of samples in embedded buffer<br />
|-<br />
| 180<br />
| u16<br />
| Format<br />
|-<br />
| 182<br />
| AdpcmData<br />
| ADPCM data associated with embedded buffer<br />
|-<br />
| 188<br />
| u16<br />
| bit[0]: ADPCM updated?; bit[1]: Is looping?r<br />
|-<br />
| 190<br />
| u16<br />
| Buffer Id of embedded buffer<br />
|}<br />
<br />
=== Format ===<br />
<br />
This is a u16.<br />
<br />
{| class="wikitable"<br />
|-<br />
| Bits<br />
| Desciption<br />
|-<br />
| 0-1<br />
| Number of channels: 0,1,3 = mono; 2 = stereo<br />
|-<br />
| 2-3<br />
| Buffer codec: [[BCWAV#Encoding|0:PCM8; 1:PCM16; 2:ADPCM]]<br />
|-<br />
| 5 <br />
| Fade<br />
|}<br />
<br />
=== Buffer ===<br />
<br />
{| class="wikitable"<br />
|-<br />
| Offset<br />
| Type<br />
| Description<br />
|-<br />
| 0<br />
| u32<br />
| Physical Address<br />
|-<br />
| 4 <br />
| u32<br />
| Sample Count<br />
|-<br />
| 8<br />
| AdpcmData<br />
| ADPCM data<br />
|-<br />
| 14<br />
| u8<br />
| ADPCM data dirty?<br />
|-<br />
| 15<br />
| u8<br />
| Looping?<br />
|-<br />
| 16<br />
| u16<br />
| Buffer Id<br />
|-<br />
| 18<br />
| u16<br />
| -<br />
|}<br />
<br />
=== Adpcm Data === <br />
<br />
{| class="wikitable"<br />
|-<br />
| 0<br />
| u8<br />
| ADPCM predictor/scale<br />
|-<br />
| 1<br />
| u8<br />
| -<br />
|-<br />
| 2<br />
| s16<br />
| ADPCM y[n-1]<br />
|-<br />
| 4<br />
| s16<br />
| ADPCM y[n-2]<br />
|}<br />
<br />
<br />
=== Simple Filter ===<br />
<br />
This is a standard single-pole filter. The fall-off is 6dB per octave as you would expect.<br />
<br />
{| class="wikitable"<br />
|-<br />
| Offset<br />
| Type<br />
| Description<br />
|-<br />
| 0<br />
| s1.15<br />
| b0<br />
|-<br />
| 2<br />
| s1.15<br />
| a1<br />
|}<br />
<br />
== Input status ==<br />
<br />
Read only. This structure is set by the DSP. This structure is 12 bytes long and there are 24 of them.<br />
<br />
{| class="wikitable"<br />
|-<br />
| Offset<br />
| Type<br />
| Description<br />
|-<br />
| 0<br />
| u8<br />
| Input Enabled?<br />
|-<br />
| 1<br />
| u8<br />
| Dirty flag for buffer id, set to 1 when buffer (after the first) starts playing<br />
|-<br />
| 2<br />
| u16<br />
| Sync count<br />
|-<br />
| 4<br />
| u32<br />
| Position (number of samples) into current buffer playback<br />
|-<br />
| 8<br />
| u16<br />
| Buffer id of the buffer that's just started playing.<br />
|-<br />
| 10<br />
| u16<br />
| -<br />
|}<br />
<br />
== Input ADPCM coefficients ==<br />
<br />
This is a 32 byte long structure. There are 24 of them.<br />
<br />
{| class="wikitable"<br />
|-<br />
| Offset<br />
| Type<br />
| Description<br />
|-<br />
| 0<br />
| s5.11[16]<br />
| ADPCM coefficents<br />
|}<br />
<br />
== DSP configuration ==<br />
<br />
=== Delay Effect ===<br />
<br />
Delay with feedback.<br />
<br />
Length of delay is expressed in terms of number of audio frames (there are 160 samples per audio frame).<br />
<br />
Feedback arm only has a gain on it. Under the feedback arm is a single-pole filter with the delay.<br />
<br />
=== Reverb Effect ===<br />
<br />
Reverb consists of two comb filters and one all-pass filter in standard configuration.<br />
<br />
== DSP status ==<br />
<br />
Read only.<br />
<br />
== Output samples ==<br />
<br />
Read only. This structure is 320 bytes long.<br />
<br />
{| class="wikitable"<br />
|-<br />
| Offset<br />
| Type<br />
| Description<br />
|-<br />
| 0<br />
| s16[160]<br />
| Samples<br />
|}<br />
<br />
== Intermediate mix samples ==<br />
<br />
Read/Write.<br />
<br />
PCM32. Also serves an aux function, allowing the ARM11 to apply custom effects to audio.<br />
<br />
This structure is 5120 bytes long.<br />
<br />
{| class="wikitable"<br />
|-<br />
| Offset<br />
| Type<br />
| Description<br />
|-<br />
| 0<br />
| s32[2][4][160]<br />
| Samples<br />
|}<br />
<br />
== Compressor table ==<br />
<br />
A precomputed response curve lookup table for the compressor.</div>
Merry
https://www.3dbrew.org/w/index.php?title=DSP_Memory_Region&diff=16175
DSP Memory Region
2016-03-24T13:34:57Z
<p>Merry: /* Frame Count */</p>
<hr />
<div>'''Some of this is known to be incorrect. I'll correct this in a few months after a bit more RE work. [[User:Merry|Merry]] ([[User talk:Merry|talk]]) 21:10, 28 January 2016 (CET)'''<br />
<br />
----<br />
<br />
*Note that everything below will vary depending on the exact DSP firmware used and different variants have slightly different behaviours.*<br />
<br />
The DSP communicates with the application through two shared memory areas 0x8000 bytes long each (at 0x1FF50000 and 0x1FF70000 respectively). The DSP alternates between the use of these two areas (much like a double-buffer). Each area has 15 structures within it. The location of these structures can be obtained by [[DSP:ReadPipe|reading channel 2 of the DSP pipe]]. A list of structures in the order the DSP addresses are read from the pipe follows:<br />
<br />
1. Frame count<br />
<br />
2. Input configurations<br />
<br />
3. Input status<br />
<br />
4. Input ADPCM coefficients<br />
<br />
5. DSP configuration<br />
<br />
6. DSP status<br />
<br />
7. Output samples<br />
<br />
8. Intermediate mix samples<br />
<br />
9. Compressor table<br />
<br />
10. DSP debug statistics<br />
<br />
11. Unknown Coefficients<br />
<br />
12. Unknown Coefficients<br />
<br />
13. Unknown Coefficients<br />
<br />
14. Surround sound biquad filter 1<br />
<br />
15. Surround sound biquad filter 2<br />
<br />
The DSP has 24 inputs, each of which are individually configurable. These 24 inputs each produce three sets of 4 audio channels (two left, two right). <br />
<br />
These four audio channels feed into three intermediate mixers. Two of these intermediate mixers are used for effects and aux.<br />
<br />
== Frame Count ==<br />
<br />
The frame count of the first region must be even and the frame count of the second region must be odd.<br />
<br />
The frame with the higher count is the "current region".<br />
<br />
The DSP firmware only responds if the first frame count is 4.<br />
<br />
== Input Config ==<br />
<br />
A 192 byte long structure. There are 24 of them.<br />
<br />
{| class="wikitable"<br />
|-<br />
| Offset<br />
| Type<br />
| Description<br />
|-<br />
| 0<br />
| u32<br />
| Dirty flags<br />
|-<br />
| 4<br />
| f32[3][2][2]<br />
| Input Gain (Each input has 12 channels)<br />
|-<br />
| 52<br />
| f32<br />
| Rate multiplier (1.0x == native DSP rate)<br />
|-<br />
| 56<br />
| u8<br />
| Interpolation mode<br />
|-<br />
| 57<br />
| u8<br />
| Polyphase filter select<br />
|-<br />
| 58<br />
| u16<br />
| bit[0]: Simple Filter enabled, bit[1]: Biquadratic Filter enabled<br />
|-<br />
| 60<br />
| SimpleFilter<br />
| Simple Filter (One pole normalized recursive linear filter)<br />
|-<br />
| 64<br />
| BiquadFilter<br />
| Biquadratic Filter (Two poles two zeros normalized recursive linear filter)<br />
|-<br />
| 74<br />
| u16<br />
| Bitmap of which buffers in queue are dirty<br />
|-<br />
| 76<br />
| Buffer[4]<br />
| Buffer queue<br />
|-<br />
| 156<br />
| u32<br />
| -<br />
|-<br />
| 160<br />
| u16<br />
| Is Active<br />
|-<br />
| 162<br />
| u16 <br />
| Sync Count<br />
|-<br />
| 164<br />
| u32<br />
| Play position<br />
|-<br />
| 168<br />
| 4<br />
| ?<br />
|-<br />
| 172<br />
| u32<br />
| Physical address of embedded buffer<br />
|-<br />
| 176<br />
| u32<br />
| Number of samples in embedded buffer<br />
|-<br />
| 180<br />
| u16<br />
| bits[0:1]: 1 = mono, 2 = stereo; bits[2:3]: buffer format, bits[5]: fade in<br />
|-<br />
| 182<br />
| AdpcmData<br />
| ADPCM data associated with embedded buffer<br />
|-<br />
| 188<br />
| u16<br />
| bit[0]: ADPCM updated?; bit[1]: Is looping?r<br />
|-<br />
| 190<br />
| u16<br />
| Buffer Id of embedded buffer<br />
|}<br />
<br />
=== Buffer ===<br />
<br />
{| class="wikitable"<br />
|-<br />
| Offset<br />
| Type<br />
| Description<br />
|-<br />
| 0<br />
| u32<br />
| Physical Address<br />
|-<br />
| 4 <br />
| u32<br />
| Sample Count<br />
|-<br />
| 8<br />
| AdpcmData<br />
| ADPCM data<br />
|-<br />
| 14<br />
| u8<br />
| ADPCM data dirty?<br />
|-<br />
| 15<br />
| u8<br />
| Looping?<br />
|-<br />
| 16<br />
| u16<br />
| Buffer Id<br />
|-<br />
| 18<br />
| u16<br />
| -<br />
|}<br />
<br />
=== Adpcm Data === <br />
<br />
{| class="wikitable"<br />
|-<br />
| 0<br />
| u8<br />
| ADPCM predictor/scale<br />
|-<br />
| 1<br />
| u8<br />
| -<br />
|-<br />
| 2<br />
| s16<br />
| ADPCM y[n-1]<br />
|-<br />
| 4<br />
| s16<br />
| ADPCM y[n-2]<br />
|}<br />
<br />
<br />
=== Simple Filter ===<br />
<br />
This is a standard single-pole filter. The fall-off is 6dB per octave as you would expect.<br />
<br />
{| class="wikitable"<br />
|-<br />
| Offset<br />
| Type<br />
| Description<br />
|-<br />
| 0<br />
| s1.15<br />
| b0<br />
|-<br />
| 2<br />
| s1.15<br />
| a1<br />
|}<br />
<br />
== Input status ==<br />
<br />
Read only. This structure is set by the DSP. This structure is 12 bytes long and there are 24 of them.<br />
<br />
{| class="wikitable"<br />
|-<br />
| Offset<br />
| Type<br />
| Description<br />
|-<br />
| 0<br />
| u8<br />
| Input Enabled?<br />
|-<br />
| 1<br />
| u8<br />
| Dirty flag for buffer id, set to 1 when buffer (after the first) starts playing<br />
|-<br />
| 2<br />
| u16<br />
| Sync count<br />
|-<br />
| 4<br />
| u32<br />
| Position (number of samples) into current buffer playback<br />
|-<br />
| 8<br />
| u16<br />
| Buffer id of the buffer that's just started playing.<br />
|-<br />
| 10<br />
| u16<br />
| -<br />
|}<br />
<br />
== Input ADPCM coefficients ==<br />
<br />
This is a 32 byte long structure. There are 24 of them.<br />
<br />
{| class="wikitable"<br />
|-<br />
| Offset<br />
| Type<br />
| Description<br />
|-<br />
| 0<br />
| s5.11[16]<br />
| ADPCM coefficents<br />
|}<br />
<br />
== DSP configuration ==<br />
<br />
=== Delay Effect ===<br />
<br />
Delay with feedback.<br />
<br />
Length of delay is expressed in terms of number of audio frames (there are 160 samples per audio frame).<br />
<br />
Feedback arm only has a gain on it. Under the feedback arm is a single-pole filter with the delay.<br />
<br />
=== Reverb Effect ===<br />
<br />
Reverb consists of two comb filters and one all-pass filter in standard configuration.<br />
<br />
== DSP status ==<br />
<br />
Read only.<br />
<br />
== Output samples ==<br />
<br />
Read only. This structure is 320 bytes long.<br />
<br />
{| class="wikitable"<br />
|-<br />
| Offset<br />
| Type<br />
| Description<br />
|-<br />
| 0<br />
| s16[160]<br />
| Samples<br />
|}<br />
<br />
== Intermediate mix samples ==<br />
<br />
Read/Write.<br />
<br />
PCM32. Also serves an aux function, allowing the ARM11 to apply custom effects to audio.<br />
<br />
This structure is 5120 bytes long.<br />
<br />
{| class="wikitable"<br />
|-<br />
| Offset<br />
| Type<br />
| Description<br />
|-<br />
| 0<br />
| s32[2][4][160]<br />
| Samples<br />
|}<br />
<br />
== Compressor table ==<br />
<br />
A precomputed response curve lookup table for the compressor.</div>
Merry
https://www.3dbrew.org/w/index.php?title=DSP_Memory_Region&diff=16174
DSP Memory Region
2016-03-24T13:29:44Z
<p>Merry: clarify buffer ids</p>
<hr />
<div>'''Some of this is known to be incorrect. I'll correct this in a few months after a bit more RE work. [[User:Merry|Merry]] ([[User talk:Merry|talk]]) 21:10, 28 January 2016 (CET)'''<br />
<br />
----<br />
<br />
*Note that everything below will vary depending on the exact DSP firmware used and different variants have slightly different behaviours.*<br />
<br />
The DSP communicates with the application through two shared memory areas 0x8000 bytes long each (at 0x1FF50000 and 0x1FF70000 respectively). The DSP alternates between the use of these two areas (much like a double-buffer). Each area has 15 structures within it. The location of these structures can be obtained by [[DSP:ReadPipe|reading channel 2 of the DSP pipe]]. A list of structures in the order the DSP addresses are read from the pipe follows:<br />
<br />
1. Frame count<br />
<br />
2. Input configurations<br />
<br />
3. Input status<br />
<br />
4. Input ADPCM coefficients<br />
<br />
5. DSP configuration<br />
<br />
6. DSP status<br />
<br />
7. Output samples<br />
<br />
8. Intermediate mix samples<br />
<br />
9. Compressor table<br />
<br />
10. DSP debug statistics<br />
<br />
11. Unknown Coefficients<br />
<br />
12. Unknown Coefficients<br />
<br />
13. Unknown Coefficients<br />
<br />
14. Surround sound biquad filter 1<br />
<br />
15. Surround sound biquad filter 2<br />
<br />
The DSP has 24 inputs, each of which are individually configurable. These 24 inputs each produce three sets of 4 audio channels (two left, two right). <br />
<br />
These four audio channels feed into three intermediate mixers. Two of these intermediate mixers are used for effects and aux.<br />
<br />
== Frame Count ==<br />
<br />
== Input Config ==<br />
<br />
A 192 byte long structure. There are 24 of them.<br />
<br />
{| class="wikitable"<br />
|-<br />
| Offset<br />
| Type<br />
| Description<br />
|-<br />
| 0<br />
| u32<br />
| Dirty flags<br />
|-<br />
| 4<br />
| f32[3][2][2]<br />
| Input Gain (Each input has 12 channels)<br />
|-<br />
| 52<br />
| f32<br />
| Rate multiplier (1.0x == native DSP rate)<br />
|-<br />
| 56<br />
| u8<br />
| Interpolation mode<br />
|-<br />
| 57<br />
| u8<br />
| Polyphase filter select<br />
|-<br />
| 58<br />
| u16<br />
| bit[0]: Simple Filter enabled, bit[1]: Biquadratic Filter enabled<br />
|-<br />
| 60<br />
| SimpleFilter<br />
| Simple Filter (One pole normalized recursive linear filter)<br />
|-<br />
| 64<br />
| BiquadFilter<br />
| Biquadratic Filter (Two poles two zeros normalized recursive linear filter)<br />
|-<br />
| 74<br />
| u16<br />
| Bitmap of which buffers in queue are dirty<br />
|-<br />
| 76<br />
| Buffer[4]<br />
| Buffer queue<br />
|-<br />
| 156<br />
| u32<br />
| -<br />
|-<br />
| 160<br />
| u16<br />
| Is Active<br />
|-<br />
| 162<br />
| u16 <br />
| Sync Count<br />
|-<br />
| 164<br />
| u32<br />
| Play position<br />
|-<br />
| 168<br />
| 4<br />
| ?<br />
|-<br />
| 172<br />
| u32<br />
| Physical address of embedded buffer<br />
|-<br />
| 176<br />
| u32<br />
| Number of samples in embedded buffer<br />
|-<br />
| 180<br />
| u16<br />
| bits[0:1]: 1 = mono, 2 = stereo; bits[2:3]: buffer format, bits[5]: fade in<br />
|-<br />
| 182<br />
| AdpcmData<br />
| ADPCM data associated with embedded buffer<br />
|-<br />
| 188<br />
| u16<br />
| bit[0]: ADPCM updated?; bit[1]: Is looping?r<br />
|-<br />
| 190<br />
| u16<br />
| Buffer Id of embedded buffer<br />
|}<br />
<br />
=== Buffer ===<br />
<br />
{| class="wikitable"<br />
|-<br />
| Offset<br />
| Type<br />
| Description<br />
|-<br />
| 0<br />
| u32<br />
| Physical Address<br />
|-<br />
| 4 <br />
| u32<br />
| Sample Count<br />
|-<br />
| 8<br />
| AdpcmData<br />
| ADPCM data<br />
|-<br />
| 14<br />
| u8<br />
| ADPCM data dirty?<br />
|-<br />
| 15<br />
| u8<br />
| Looping?<br />
|-<br />
| 16<br />
| u16<br />
| Buffer Id<br />
|-<br />
| 18<br />
| u16<br />
| -<br />
|}<br />
<br />
=== Adpcm Data === <br />
<br />
{| class="wikitable"<br />
|-<br />
| 0<br />
| u8<br />
| ADPCM predictor/scale<br />
|-<br />
| 1<br />
| u8<br />
| -<br />
|-<br />
| 2<br />
| s16<br />
| ADPCM y[n-1]<br />
|-<br />
| 4<br />
| s16<br />
| ADPCM y[n-2]<br />
|}<br />
<br />
<br />
=== Simple Filter ===<br />
<br />
This is a standard single-pole filter. The fall-off is 6dB per octave as you would expect.<br />
<br />
{| class="wikitable"<br />
|-<br />
| Offset<br />
| Type<br />
| Description<br />
|-<br />
| 0<br />
| s1.15<br />
| b0<br />
|-<br />
| 2<br />
| s1.15<br />
| a1<br />
|}<br />
<br />
== Input status ==<br />
<br />
Read only. This structure is set by the DSP. This structure is 12 bytes long and there are 24 of them.<br />
<br />
{| class="wikitable"<br />
|-<br />
| Offset<br />
| Type<br />
| Description<br />
|-<br />
| 0<br />
| u8<br />
| Input Enabled?<br />
|-<br />
| 1<br />
| u8<br />
| Dirty flag for buffer id, set to 1 when buffer (after the first) starts playing<br />
|-<br />
| 2<br />
| u16<br />
| Sync count<br />
|-<br />
| 4<br />
| u32<br />
| Position (number of samples) into current buffer playback<br />
|-<br />
| 8<br />
| u16<br />
| Buffer id of the buffer that's just started playing.<br />
|-<br />
| 10<br />
| u16<br />
| -<br />
|}<br />
<br />
== Input ADPCM coefficients ==<br />
<br />
This is a 32 byte long structure. There are 24 of them.<br />
<br />
{| class="wikitable"<br />
|-<br />
| Offset<br />
| Type<br />
| Description<br />
|-<br />
| 0<br />
| s5.11[16]<br />
| ADPCM coefficents<br />
|}<br />
<br />
== DSP configuration ==<br />
<br />
=== Delay Effect ===<br />
<br />
Delay with feedback.<br />
<br />
Length of delay is expressed in terms of number of audio frames (there are 160 samples per audio frame).<br />
<br />
Feedback arm only has a gain on it. Under the feedback arm is a single-pole filter with the delay.<br />
<br />
=== Reverb Effect ===<br />
<br />
Reverb consists of two comb filters and one all-pass filter in standard configuration.<br />
<br />
== DSP status ==<br />
<br />
Read only.<br />
<br />
== Output samples ==<br />
<br />
Read only. This structure is 320 bytes long.<br />
<br />
{| class="wikitable"<br />
|-<br />
| Offset<br />
| Type<br />
| Description<br />
|-<br />
| 0<br />
| s16[160]<br />
| Samples<br />
|}<br />
<br />
== Intermediate mix samples ==<br />
<br />
Read/Write.<br />
<br />
PCM32. Also serves an aux function, allowing the ARM11 to apply custom effects to audio.<br />
<br />
This structure is 5120 bytes long.<br />
<br />
{| class="wikitable"<br />
|-<br />
| Offset<br />
| Type<br />
| Description<br />
|-<br />
| 0<br />
| s32[2][4][160]<br />
| Samples<br />
|}<br />
<br />
== Compressor table ==<br />
<br />
A precomputed response curve lookup table for the compressor.</div>
Merry
https://www.3dbrew.org/w/index.php?title=DSP_Memory_Region&diff=16010
DSP Memory Region
2016-03-11T16:03:45Z
<p>Merry: /* Reverb Effect */</p>
<hr />
<div>'''Some of this is known to be incorrect. I'll correct this in a few months after a bit more RE work. [[User:Merry|Merry]] ([[User talk:Merry|talk]]) 21:10, 28 January 2016 (CET)'''<br />
<br />
----<br />
<br />
*Note that everything below will vary depending on the exact DSP firmware used and different variants have slightly different behaviours.*<br />
<br />
The DSP communicates with the application through two shared memory areas 0x8000 bytes long each (at 0x1FF50000 and 0x1FF70000 respectively). The DSP alternates between the use of these two areas (much like a double-buffer). Each area has 15 structures within it. The location of these structures can be obtained by [[DSP:ReadPipe|reading channel 2 of the DSP pipe]]. A list of structures in the order the DSP addresses are read from the pipe follows:<br />
<br />
1. Frame count<br />
<br />
2. Input configurations<br />
<br />
3. Input status<br />
<br />
4. Input ADPCM coefficients<br />
<br />
5. DSP configuration<br />
<br />
6. DSP status<br />
<br />
7. Output samples<br />
<br />
8. Intermediate mix samples<br />
<br />
9. Compressor table<br />
<br />
10. DSP debug statistics<br />
<br />
11. Unknown Coefficients<br />
<br />
12. Unknown Coefficients<br />
<br />
13. Unknown Coefficients<br />
<br />
14. Surround sound biquad filter 1<br />
<br />
15. Surround sound biquad filter 2<br />
<br />
The DSP has 24 inputs, each of which are individually configurable. These 24 inputs each produce three sets of 4 audio channels (two left, two right). <br />
<br />
These four audio channels feed into three intermediate mixers. Two of these intermediate mixers are used for effects and aux.<br />
<br />
== Frame Count ==<br />
<br />
== Input Config ==<br />
<br />
A 192 byte long structure. There are 24 of them.<br />
<br />
{| class="wikitable"<br />
|-<br />
| Offset<br />
| Type<br />
| Description<br />
|-<br />
| 0<br />
| u32<br />
| Dirty flags<br />
|-<br />
| 4<br />
| f32[3][2][2]<br />
| Input Gain (Each input has 12 channels)<br />
|-<br />
| 52<br />
| f32<br />
| Rate multiplier (1.0x == native DSP rate)<br />
|-<br />
| 56<br />
| u8<br />
| Interpolation mode<br />
|-<br />
| 57<br />
| u8<br />
| Polyphase filter select<br />
|-<br />
| 58<br />
| u16<br />
| bit[0]: Simple Filter enabled, bit[1]: Biquadratic Filter enabled<br />
|-<br />
| 60<br />
| SimpleFilter<br />
| Simple Filter (One pole normalized recursive linear filter)<br />
|-<br />
| 64<br />
| BiquadFilter<br />
| Biquadratic Filter (Two poles two zeros normalized recursive linear filter)<br />
|-<br />
| 74<br />
| u16<br />
| Bitmap of which buffers in queue are dirty<br />
|-<br />
| 76<br />
| Buffer[4]<br />
| Buffer queue<br />
|-<br />
| 156<br />
| u32<br />
| -<br />
|-<br />
| 160<br />
| u16<br />
| Is Active<br />
|-<br />
| 162<br />
| u16 <br />
| Sync Count<br />
|-<br />
| 164<br />
| u32<br />
| Play position<br />
|-<br />
| 168<br />
| 4<br />
| ?<br />
|-<br />
| 172<br />
| u32<br />
| Physical address of embedded buffer<br />
|-<br />
| 176<br />
| u32<br />
| Number of samples in embedded buffer<br />
|-<br />
| 180<br />
| u16<br />
| bits[0:1]: 1 = mono, 2 = stereo; bits[2:3]: buffer format, bits[5]: fade in<br />
|-<br />
| 182<br />
| AdpcmData<br />
| ADPCM data associated with embedded buffer<br />
|-<br />
| 188<br />
| u16<br />
| bit[0]: ADPCM updated?; bit[1]: Is looping?r<br />
|-<br />
| 190<br />
| u16<br />
| Buffer Id of embedded buffer<br />
|}<br />
<br />
=== Buffer ===<br />
<br />
{| class="wikitable"<br />
|-<br />
| Offset<br />
| Type<br />
| Description<br />
|-<br />
| 0<br />
| u32<br />
| Physical Address<br />
|-<br />
| 4 <br />
| u32<br />
| Sample Count<br />
|-<br />
| 8<br />
| AdpcmData<br />
| ADPCM data<br />
|-<br />
| 14<br />
| u8<br />
| ADPCM data dirty?<br />
|-<br />
| 15<br />
| u8<br />
| Looping?<br />
|-<br />
| 16<br />
| u16<br />
| Buffer Id<br />
|-<br />
| 18<br />
| u16<br />
| -<br />
|}<br />
<br />
=== Adpcm Data === <br />
<br />
{| class="wikitable"<br />
|-<br />
| 0<br />
| u8<br />
| ADPCM predictor/scale<br />
|-<br />
| 1<br />
| u8<br />
| -<br />
|-<br />
| 2<br />
| s16<br />
| ADPCM y[n-1]<br />
|-<br />
| 4<br />
| s16<br />
| ADPCM y[n-2]<br />
|}<br />
<br />
<br />
=== Simple Filter ===<br />
<br />
This is a standard single-pole filter. The fall-off is 6dB per octave as you would expect.<br />
<br />
{| class="wikitable"<br />
|-<br />
| Offset<br />
| Type<br />
| Description<br />
|-<br />
| 0<br />
| s1.15<br />
| b0<br />
|-<br />
| 2<br />
| s1.15<br />
| a1<br />
|}<br />
<br />
== Input status ==<br />
<br />
Read only. This structure is set by the DSP. This structure is 12 bytes long and there are 24 of them.<br />
<br />
{| class="wikitable"<br />
|-<br />
| Offset<br />
| Type<br />
| Description<br />
|-<br />
| 0<br />
| u8<br />
| Input Enabled?<br />
|-<br />
| 1<br />
| u8<br />
| Dirty flag for previous buffer id.<br />
|-<br />
| 2<br />
| u16<br />
| Sync count<br />
|-<br />
| 4<br />
| u32<br />
| Position (number of samples) into current buffer playback<br />
|-<br />
| 8<br />
| u16<br />
| Buffer id of last buffer that was played<br />
|-<br />
| 10<br />
| u16<br />
| -<br />
|}<br />
<br />
== Input ADPCM coefficients ==<br />
<br />
This is a 32 byte long structure. There are 24 of them.<br />
<br />
{| class="wikitable"<br />
|-<br />
| Offset<br />
| Type<br />
| Description<br />
|-<br />
| 0<br />
| s5.11[16]<br />
| ADPCM coefficents<br />
|}<br />
<br />
== DSP configuration ==<br />
<br />
=== Delay Effect ===<br />
<br />
Delay with feedback.<br />
<br />
Length of delay is expressed in terms of number of audio frames (there are 160 samples per audio frame).<br />
<br />
Feedback arm only has a gain on it. Under the feedback arm is a single-pole filter with the delay.<br />
<br />
=== Reverb Effect ===<br />
<br />
Reverb consists of two comb filters and one all-pass filter in standard configuration.<br />
<br />
== DSP status ==<br />
<br />
Read only.<br />
<br />
== Output samples ==<br />
<br />
Read only. This structure is 320 bytes long.<br />
<br />
{| class="wikitable"<br />
|-<br />
| Offset<br />
| Type<br />
| Description<br />
|-<br />
| 0<br />
| s16[160]<br />
| Samples<br />
|}<br />
<br />
== Intermediate mix samples ==<br />
<br />
Read/Write.<br />
<br />
PCM32. Also serves an aux function, allowing the ARM11 to apply custom effects to audio.<br />
<br />
This structure is 5120 bytes long.<br />
<br />
{| class="wikitable"<br />
|-<br />
| Offset<br />
| Type<br />
| Description<br />
|-<br />
| 0<br />
| s32[2][4][160]<br />
| Samples<br />
|}<br />
<br />
== Compressor table ==<br />
<br />
A precomputed response curve lookup table for the compressor.</div>
Merry
https://www.3dbrew.org/w/index.php?title=DSP:ReadPipe&diff=16009
DSP:ReadPipe
2016-03-11T15:55:15Z
<p>Merry: </p>
<hr />
<div>=Request=<br />
{| class="wikitable" border="1"<br />
|-<br />
! Index Word<br />
! Description<br />
|-<br />
| 0<br />
| Header code [0x000E00C0]<br />
|-<br />
| 1<br />
| Channel<br />
|-<br />
| 2<br />
| Peer<br />
|-<br />
| 3<br />
| u16, Size<br />
|}<br />
<br />
0x100 byte after the Request header<br />
{| class="wikitable" border="1"<br />
|-<br />
! Index Word<br />
! Description<br />
|-<br />
| 0<br />
| (Size << 14) <nowiki>|</nowiki> 0x2<br />
|-<br />
| 1<br />
| Buffer<br />
|}<br />
<br />
=Response=<br />
{| class="wikitable" border="1"<br />
|-<br />
! Index Word<br />
! Description<br />
|-<br />
| 0<br />
| Header code<br />
|-<br />
| 1<br />
| Result code<br />
|}<br />
<br />
=See Also=<br />
* [[DSP:ReadPipeIfPossible]]</div>
Merry
https://www.3dbrew.org/w/index.php?title=DSP_Memory_Region&diff=16008
DSP Memory Region
2016-03-11T15:50:34Z
<p>Merry: Surround sound biquad filters</p>
<hr />
<div>'''Some of this is known to be incorrect. I'll correct this in a few months after a bit more RE work. [[User:Merry|Merry]] ([[User talk:Merry|talk]]) 21:10, 28 January 2016 (CET)'''<br />
<br />
----<br />
<br />
*Note that everything below will vary depending on the exact DSP firmware used and different variants have slightly different behaviours.*<br />
<br />
The DSP communicates with the application through two shared memory areas 0x8000 bytes long each (at 0x1FF50000 and 0x1FF70000 respectively). The DSP alternates between the use of these two areas (much like a double-buffer). Each area has 15 structures within it. The location of these structures can be obtained by [[DSP:ReadPipe|reading channel 2 of the DSP pipe]]. A list of structures in the order the DSP addresses are read from the pipe follows:<br />
<br />
1. Frame count<br />
<br />
2. Input configurations<br />
<br />
3. Input status<br />
<br />
4. Input ADPCM coefficients<br />
<br />
5. DSP configuration<br />
<br />
6. DSP status<br />
<br />
7. Output samples<br />
<br />
8. Intermediate mix samples<br />
<br />
9. Compressor table<br />
<br />
10. DSP debug statistics<br />
<br />
11. Unknown Coefficients<br />
<br />
12. Unknown Coefficients<br />
<br />
13. Unknown Coefficients<br />
<br />
14. Surround sound biquad filter 1<br />
<br />
15. Surround sound biquad filter 2<br />
<br />
The DSP has 24 inputs, each of which are individually configurable. These 24 inputs each produce three sets of 4 audio channels (two left, two right). <br />
<br />
These four audio channels feed into three intermediate mixers. Two of these intermediate mixers are used for effects and aux.<br />
<br />
== Frame Count ==<br />
<br />
== Input Config ==<br />
<br />
A 192 byte long structure. There are 24 of them.<br />
<br />
{| class="wikitable"<br />
|-<br />
| Offset<br />
| Type<br />
| Description<br />
|-<br />
| 0<br />
| u32<br />
| Dirty flags<br />
|-<br />
| 4<br />
| f32[3][2][2]<br />
| Input Gain (Each input has 12 channels)<br />
|-<br />
| 52<br />
| f32<br />
| Rate multiplier (1.0x == native DSP rate)<br />
|-<br />
| 56<br />
| u8<br />
| Interpolation mode<br />
|-<br />
| 57<br />
| u8<br />
| Polyphase filter select<br />
|-<br />
| 58<br />
| u16<br />
| bit[0]: Simple Filter enabled, bit[1]: Biquadratic Filter enabled<br />
|-<br />
| 60<br />
| SimpleFilter<br />
| Simple Filter (One pole normalized recursive linear filter)<br />
|-<br />
| 64<br />
| BiquadFilter<br />
| Biquadratic Filter (Two poles two zeros normalized recursive linear filter)<br />
|-<br />
| 74<br />
| u16<br />
| Bitmap of which buffers in queue are dirty<br />
|-<br />
| 76<br />
| Buffer[4]<br />
| Buffer queue<br />
|-<br />
| 156<br />
| u32<br />
| -<br />
|-<br />
| 160<br />
| u16<br />
| Is Active<br />
|-<br />
| 162<br />
| u16 <br />
| Sync Count<br />
|-<br />
| 164<br />
| u32<br />
| Play position<br />
|-<br />
| 168<br />
| 4<br />
| ?<br />
|-<br />
| 172<br />
| u32<br />
| Physical address of embedded buffer<br />
|-<br />
| 176<br />
| u32<br />
| Number of samples in embedded buffer<br />
|-<br />
| 180<br />
| u16<br />
| bits[0:1]: 1 = mono, 2 = stereo; bits[2:3]: buffer format, bits[5]: fade in<br />
|-<br />
| 182<br />
| AdpcmData<br />
| ADPCM data associated with embedded buffer<br />
|-<br />
| 188<br />
| u16<br />
| bit[0]: ADPCM updated?; bit[1]: Is looping?r<br />
|-<br />
| 190<br />
| u16<br />
| Buffer Id of embedded buffer<br />
|}<br />
<br />
=== Buffer ===<br />
<br />
{| class="wikitable"<br />
|-<br />
| Offset<br />
| Type<br />
| Description<br />
|-<br />
| 0<br />
| u32<br />
| Physical Address<br />
|-<br />
| 4 <br />
| u32<br />
| Sample Count<br />
|-<br />
| 8<br />
| AdpcmData<br />
| ADPCM data<br />
|-<br />
| 14<br />
| u8<br />
| ADPCM data dirty?<br />
|-<br />
| 15<br />
| u8<br />
| Looping?<br />
|-<br />
| 16<br />
| u16<br />
| Buffer Id<br />
|-<br />
| 18<br />
| u16<br />
| -<br />
|}<br />
<br />
=== Adpcm Data === <br />
<br />
{| class="wikitable"<br />
|-<br />
| 0<br />
| u8<br />
| ADPCM predictor/scale<br />
|-<br />
| 1<br />
| u8<br />
| -<br />
|-<br />
| 2<br />
| s16<br />
| ADPCM y[n-1]<br />
|-<br />
| 4<br />
| s16<br />
| ADPCM y[n-2]<br />
|}<br />
<br />
<br />
=== Simple Filter ===<br />
<br />
This is a standard single-pole filter. The fall-off is 6dB per octave as you would expect.<br />
<br />
{| class="wikitable"<br />
|-<br />
| Offset<br />
| Type<br />
| Description<br />
|-<br />
| 0<br />
| s1.15<br />
| b0<br />
|-<br />
| 2<br />
| s1.15<br />
| a1<br />
|}<br />
<br />
== Input status ==<br />
<br />
Read only. This structure is set by the DSP. This structure is 12 bytes long and there are 24 of them.<br />
<br />
{| class="wikitable"<br />
|-<br />
| Offset<br />
| Type<br />
| Description<br />
|-<br />
| 0<br />
| u8<br />
| Input Enabled?<br />
|-<br />
| 1<br />
| u8<br />
| Dirty flag for previous buffer id.<br />
|-<br />
| 2<br />
| u16<br />
| Sync count<br />
|-<br />
| 4<br />
| u32<br />
| Position (number of samples) into current buffer playback<br />
|-<br />
| 8<br />
| u16<br />
| Buffer id of last buffer that was played<br />
|-<br />
| 10<br />
| u16<br />
| -<br />
|}<br />
<br />
== Input ADPCM coefficients ==<br />
<br />
This is a 32 byte long structure. There are 24 of them.<br />
<br />
{| class="wikitable"<br />
|-<br />
| Offset<br />
| Type<br />
| Description<br />
|-<br />
| 0<br />
| s5.11[16]<br />
| ADPCM coefficents<br />
|}<br />
<br />
== DSP configuration ==<br />
<br />
=== Delay Effect ===<br />
<br />
Delay with feedback.<br />
<br />
Length of delay is expressed in terms of number of audio frames (there are 160 samples per audio frame).<br />
<br />
Feedback arm only has a gain on it. Under the feedback arm is a single-pole filter with the delay.<br />
<br />
=== Reverb Effect ===<br />
<br />
== DSP status ==<br />
<br />
Read only.<br />
<br />
== Output samples ==<br />
<br />
Read only. This structure is 320 bytes long.<br />
<br />
{| class="wikitable"<br />
|-<br />
| Offset<br />
| Type<br />
| Description<br />
|-<br />
| 0<br />
| s16[160]<br />
| Samples<br />
|}<br />
<br />
== Intermediate mix samples ==<br />
<br />
Read/Write.<br />
<br />
PCM32. Also serves an aux function, allowing the ARM11 to apply custom effects to audio.<br />
<br />
This structure is 5120 bytes long.<br />
<br />
{| class="wikitable"<br />
|-<br />
| Offset<br />
| Type<br />
| Description<br />
|-<br />
| 0<br />
| s32[2][4][160]<br />
| Samples<br />
|}<br />
<br />
== Compressor table ==<br />
<br />
A precomputed response curve lookup table for the compressor.</div>
Merry
https://www.3dbrew.org/w/index.php?title=DSP:RegisterInterruptEvents&diff=15989
DSP:RegisterInterruptEvents
2016-03-07T20:44:31Z
<p>Merry: </p>
<hr />
<div>=Request=<br />
{| class="wikitable" border="1"<br />
|-<br />
! Index Word<br />
! Description<br />
|-<br />
| 0<br />
| Header code [0x00150082]<br />
|-<br />
| 1<br />
| Interrupt<br />
|-<br />
| 2<br />
| Channel<br />
|-<br />
| 3<br />
| 0x0<br />
|-<br />
| 4<br />
| Event handle (0 = unregister the event that was previous registered)<br />
|}<br />
<br />
=Response=<br />
{| class="wikitable" border="1"<br />
|-<br />
! Index Word<br />
! Description<br />
|-<br />
| 0<br />
| Header code [0x00150040]<br />
|-<br />
| 1<br />
| Result code<br />
|}<br />
<br />
=Description=<br />
Application should unregister the event by setting handle to zero. If the session was closed before the event was unregistered, it will cause a handle leak in DSP process.<br />
<br />
DSP can hold up to 6 concurrent registrations. More than that will cause registration to fail.<br />
<br />
Interrupts with interupt=2 are related to [[DSP:WriteProcessPipe|pipes]]. The channel argument is the same as the pipe channel argument. The interrupt is signalled when data is available on the related pipe or when a related event occurs.</div>
Merry
https://www.3dbrew.org/w/index.php?title=DSP:RegisterInterruptEvents&diff=15988
DSP:RegisterInterruptEvents
2016-03-07T20:44:15Z
<p>Merry: </p>
<hr />
<div>=Request=<br />
{| class="wikitable" border="1"<br />
|-<br />
! Index Word<br />
! Description<br />
|-<br />
| 0<br />
| Header code [0x00150082]<br />
|-<br />
| 1<br />
| Interrupt<br />
|-<br />
| 2<br />
| Channel<br />
|-<br />
| 3<br />
| 0x0<br />
|-<br />
| 4<br />
| Event handle (0 = unregister the event that was previous registered)<br />
|}<br />
<br />
=Response=<br />
{| class="wikitable" border="1"<br />
|-<br />
! Index Word<br />
! Description<br />
|-<br />
| 0<br />
| Header code [0x00150040]<br />
|-<br />
| 1<br />
| Result code<br />
|}<br />
<br />
=Description=<br />
Application should unregister the event by setting handle to zero. If the session was closed before the event was unregistered, it will cause a handle leak in DSP process.<br />
<br />
DSP can hold up to 6 concurrent registrations. More than that will cause registration to fail.<br />
<br />
Interrupts with interupt=2 are related to [[DSP:WriteProcessPipe|pipes]]. The channel argument is the same as the pipe channel argument. The interrupt is signalled when data is available on a pipe or when a related event occurs.</div>
Merry
https://www.3dbrew.org/w/index.php?title=DSP:WriteProcessPipe&diff=15987
DSP:WriteProcessPipe
2016-03-07T20:42:47Z
<p>Merry: </p>
<hr />
<div>=Request=<br />
{| class="wikitable" border="1"<br />
|-<br />
! Index Word<br />
! Description<br />
|-<br />
| 0<br />
| Header code [0x000D0082]<br />
|-<br />
| 1<br />
| Channel<br />
|-<br />
| 2<br />
| Size<br />
|-<br />
| 3<br />
| (Size << 14) <nowiki>|</nowiki> 0x402<br />
|-<br />
| 4<br />
| Buffer<br />
|}<br />
<br />
=Response=<br />
{| class="wikitable" border="1"<br />
|-<br />
! Index Word<br />
! Description<br />
|-<br />
| 0<br />
| Header code<br />
|-<br />
| 1<br />
| Result code<br />
|}<br />
<br />
=Usage Notes=<br />
<br />
One should call [[DSP:SetSemaphore]] with an argument of `0x4000`, then wait on the related [[DSP:RegisterInterruptEvents|interrupt event]].</div>
Merry
https://www.3dbrew.org/w/index.php?title=DSP:WriteProcessPipe&diff=15986
DSP:WriteProcessPipe
2016-03-07T20:42:14Z
<p>Merry: </p>
<hr />
<div>=Request=<br />
{| class="wikitable" border="1"<br />
|-<br />
! Index Word<br />
! Description<br />
|-<br />
| 0<br />
| Header code [0x000D0082]<br />
|-<br />
| 1<br />
| Channel<br />
|-<br />
| 2<br />
| Size<br />
|-<br />
| 3<br />
| (Size << 14) <nowiki>|</nowiki> 0x402<br />
|-<br />
| 4<br />
| Buffer<br />
|}<br />
<br />
=Response=<br />
{| class="wikitable" border="1"<br />
|-<br />
! Index Word<br />
! Description<br />
|-<br />
| 0<br />
| Header code<br />
|-<br />
| 1<br />
| Result code<br />
|}<br />
<br />
=Usage Notes=<br />
<br />
One should call [[DSP:SetSemaphore]] with an argument of `0x4000`, then wait on the related [[interrupt event|DSP:RegisterInterruptEvents]].</div>
Merry
https://www.3dbrew.org/w/index.php?title=DSP:ReadPipeIfPossible&diff=15985
DSP:ReadPipeIfPossible
2016-03-07T20:39:49Z
<p>Merry: </p>
<hr />
<div>=Request=<br />
{| class="wikitable" border="1"<br />
|-<br />
! Index Word<br />
! Description<br />
|-<br />
| 0<br />
| Header code [0x001000c0]<br />
|-<br />
| 1<br />
| Channel (0 - 7 0:Debug from DSP 1:P-DMA 2:audio 3:binary 4-7: free ?)<br />
|-<br />
| 2<br />
| Peer (0 = from DSP, 1 = from ARM)<br />
|-<br />
| 3<br />
| u16, Size<br />
|}<br />
<br />
0x100 byte after the Request header<br />
{| class="wikitable" border="1"<br />
|-<br />
! Index Word<br />
! Description<br />
|-<br />
| 0<br />
| (Size << 14) <nowiki>|</nowiki> 0x2<br />
|-<br />
| 1<br />
| Buffer<br />
|}<br />
<br />
=Response=<br />
{| class="wikitable" border="1"<br />
|-<br />
! Index Word<br />
! Description<br />
|-<br />
| 0<br />
| Header code<br />
|-<br />
| 1<br />
| Result code<br />
|-<br />
| 2<br />
| u16, Actual read size<br />
|}<br />
<br />
= Channels =<br />
<br />
== Channel 2 (Audio) ==<br />
<br />
Channel 2 returns the DSP DRAM addresses of structures located in the [[DSP Memory Region]]. [[DSP:ConvertProcessAddressFromDspDram]] can be used to convert these addresses into virtual memory addresses. The list of addresses and the length of the list vary depending on DSP firmware version.<br />
<br />
== Channel 3 (Binary) ==<br />
<br />
The purpose of channel 3 is unknown. The behaviour of this pipe varies depending on DSP firmware version. Observed behaviours include:<br />
<br />
* doing nothing.<br />
* echoing what is returned to it.<br />
* long strings of zeros.</div>
Merry
https://www.3dbrew.org/w/index.php?title=DSP:LoadComponent&diff=15977
DSP:LoadComponent
2016-03-05T23:19:10Z
<p>Merry: Updated with the two translated response params.</p>
<hr />
<div>=Request=<br />
{| class="wikitable" border="1"<br />
|-<br />
! Index Word<br />
! Description<br />
|-<br />
| 0<br />
| Header code [0x001100C2]<br />
|-<br />
| 1<br />
| Size<br />
|-<br />
| 2<br />
| Program Mask (observed 0x00FF) (Program ram blocks the component should be loaded into)<br />
|-<br />
| 3<br />
| Data Mask (observed 0x00FF) (Data ram blocks the component should be loaded into)<br />
|-<br />
| 4<br />
| (Size << 4) <nowiki>|</nowiki> 0xA<br />
|-<br />
| 5<br />
| Component Buffer<br />
|}<br />
<br />
=Response=<br />
{| class="wikitable" border="1"<br />
|-<br />
! Index Word<br />
! Description<br />
|-<br />
| 0<br />
| Header code [0x00110082]<br />
|-<br />
| 1<br />
| Result code<br />
|-<br />
| 2<br />
| u8, Component Loaded (0 = not loaded, 1 = loaded)<br />
|-<br />
| 3<br />
| (Size << 4) <nowiki>|</nowiki> 0xA<br />
|-<br />
| 4<br />
| Component Buffer<br />
|}<br />
<br />
=Description=<br />
This requires RSA-signed DSP firmware specified via the input buffer for this command, the firmware data is eventually written to DSPmem+0(0x1FF00000). This has been observed to call a subroutine which calls a string named "synthe".</div>
Merry
https://www.3dbrew.org/w/index.php?title=DSP_Memory_Region&diff=15831
DSP Memory Region
2016-02-19T20:07:40Z
<p>Merry: </p>
<hr />
<div>'''Some of this is known to be incorrect. I'll correct this in a few months after a bit more RE work. [[User:Merry|Merry]] ([[User talk:Merry|talk]]) 21:10, 28 January 2016 (CET)'''<br />
<br />
----<br />
<br />
*Note that everything below will vary depending on the exact DSP firmware used and different variants have slightly different behaviours.*<br />
<br />
The DSP communicates with the application through two shared memory areas 0x8000 bytes long each (at 0x1FF50000 and 0x1FF70000 respectively). The DSP alternates between the use of these two areas (much like a double-buffer). Each area has 15 structures within it. The location of these structures can be obtained by [[DSP:ReadPipe|reading channel 2 of the DSP pipe]]. A list of structures in the order the DSP addresses are read from the pipe follows:<br />
<br />
1. Frame count<br />
<br />
2. Input configurations<br />
<br />
3. Input status<br />
<br />
4. Input ADPCM coefficients<br />
<br />
5. DSP configuration<br />
<br />
6. DSP status<br />
<br />
7. Output samples<br />
<br />
8. Intermediate mix samples<br />
<br />
9. Compressor table<br />
<br />
10. DSP debug statistics<br />
<br />
11. Unknown Coefficients<br />
<br />
12. Unknown Coefficients<br />
<br />
13. Unknown Coefficients<br />
<br />
14. Unknown Coefficients<br />
<br />
15. Unknown Coefficients<br />
<br />
The DSP has 24 inputs, each of which are individually configurable. These 24 inputs each produce three sets of 4 audio channels (two left, two right). <br />
<br />
These four audio channels feed into three intermediate mixers. Two of these intermediate mixers are used for effects and aux.<br />
<br />
== Frame Count ==<br />
<br />
== Input Config ==<br />
<br />
A 192 byte long structure. There are 24 of them.<br />
<br />
{| class="wikitable"<br />
|-<br />
| Offset<br />
| Type<br />
| Description<br />
|-<br />
| 0<br />
| u32<br />
| Dirty flags<br />
|-<br />
| 4<br />
| f32[3][2][2]<br />
| Input Gain (Each input has 12 channels)<br />
|-<br />
| 52<br />
| f32<br />
| Rate multiplier (1.0x == native DSP rate)<br />
|-<br />
| 56<br />
| u8<br />
| Interpolation mode<br />
|-<br />
| 57<br />
| u8<br />
| Polyphase filter select<br />
|-<br />
| 58<br />
| u16<br />
| bit[0]: Simple Filter enabled, bit[1]: Biquadratic Filter enabled<br />
|-<br />
| 60<br />
| SimpleFilter<br />
| Simple Filter (One pole normalized recursive linear filter)<br />
|-<br />
| 64<br />
| BiquadFilter<br />
| Biquadratic Filter (Two poles two zeros normalized recursive linear filter)<br />
|-<br />
| 74<br />
| u16<br />
| Bitmap of which buffers in queue are dirty<br />
|-<br />
| 76<br />
| Buffer[4]<br />
| Buffer queue<br />
|-<br />
| 156<br />
| u32<br />
| -<br />
|-<br />
| 160<br />
| u16<br />
| Is Active<br />
|-<br />
| 162<br />
| u16 <br />
| Sync Count<br />
|-<br />
| 164<br />
| u32<br />
| Play position<br />
|-<br />
| 168<br />
| 4<br />
| ?<br />
|-<br />
| 172<br />
| u32<br />
| Physical address of embedded buffer<br />
|-<br />
| 176<br />
| u32<br />
| Number of samples in embedded buffer<br />
|-<br />
| 180<br />
| u16<br />
| bits[0:1]: 1 = mono, 2 = stereo; bits[2:3]: buffer format, bits[5]: fade in<br />
|-<br />
| 182<br />
| AdpcmData<br />
| ADPCM data associated with embedded buffer<br />
|-<br />
| 188<br />
| u16<br />
| bit[0]: ADPCM updated?; bit[1]: Is looping?r<br />
|-<br />
| 190<br />
| u16<br />
| Buffer Id of embedded buffer<br />
|}<br />
<br />
=== Buffer ===<br />
<br />
{| class="wikitable"<br />
|-<br />
| Offset<br />
| Type<br />
| Description<br />
|-<br />
| 0<br />
| u32<br />
| Physical Address<br />
|-<br />
| 4 <br />
| u32<br />
| Sample Count<br />
|-<br />
| 8<br />
| AdpcmData<br />
| ADPCM data<br />
|-<br />
| 14<br />
| u8<br />
| ADPCM data dirty?<br />
|-<br />
| 15<br />
| u8<br />
| Looping?<br />
|-<br />
| 16<br />
| u16<br />
| Buffer Id<br />
|-<br />
| 18<br />
| u16<br />
| -<br />
|}<br />
<br />
=== Adpcm Data === <br />
<br />
{| class="wikitable"<br />
|-<br />
| 0<br />
| u8<br />
| ADPCM predictor/scale<br />
|-<br />
| 1<br />
| u8<br />
| -<br />
|-<br />
| 2<br />
| s16<br />
| ADPCM y[n-1]<br />
|-<br />
| 4<br />
| s16<br />
| ADPCM y[n-2]<br />
|}<br />
<br />
<br />
=== Simple Filter ===<br />
<br />
This is a standard single-pole filter. The fall-off is 6dB per octave as you would expect.<br />
<br />
{| class="wikitable"<br />
|-<br />
| Offset<br />
| Type<br />
| Description<br />
|-<br />
| 0<br />
| s1.15<br />
| b0<br />
|-<br />
| 2<br />
| s1.15<br />
| a1<br />
|}<br />
<br />
== Input status ==<br />
<br />
Read only. This structure is set by the DSP. This structure is 12 bytes long and there are 24 of them.<br />
<br />
{| class="wikitable"<br />
|-<br />
| Offset<br />
| Type<br />
| Description<br />
|-<br />
| 0<br />
| u8<br />
| Input Enabled?<br />
|-<br />
| 1<br />
| u8<br />
| Dirty flag for previous buffer id.<br />
|-<br />
| 2<br />
| u16<br />
| Sync count<br />
|-<br />
| 4<br />
| u32<br />
| Position (number of samples) into current buffer playback<br />
|-<br />
| 8<br />
| u16<br />
| Buffer id of last buffer that was played<br />
|-<br />
| 10<br />
| u16<br />
| -<br />
|}<br />
<br />
== Input ADPCM coefficients ==<br />
<br />
This is a 32 byte long structure. There are 24 of them.<br />
<br />
{| class="wikitable"<br />
|-<br />
| Offset<br />
| Type<br />
| Description<br />
|-<br />
| 0<br />
| s5.11[16]<br />
| ADPCM coefficents<br />
|}<br />
<br />
== DSP configuration ==<br />
<br />
=== Delay Effect ===<br />
<br />
Delay with feedback.<br />
<br />
Length of delay is expressed in terms of number of audio frames (there are 160 samples per audio frame).<br />
<br />
Feedback arm only has a gain on it. Under the feedback arm is a single-pole filter with the delay.<br />
<br />
=== Reverb Effect ===<br />
<br />
== DSP status ==<br />
<br />
Read only.<br />
<br />
== Output samples ==<br />
<br />
Read only. This structure is 320 bytes long.<br />
<br />
{| class="wikitable"<br />
|-<br />
| Offset<br />
| Type<br />
| Description<br />
|-<br />
| 0<br />
| s16[160]<br />
| Samples<br />
|}<br />
<br />
== Intermediate mix samples ==<br />
<br />
Read/Write.<br />
<br />
PCM32. Also serves an aux function, allowing the ARM11 to apply custom effects to audio.<br />
<br />
This structure is 5120 bytes long.<br />
<br />
{| class="wikitable"<br />
|-<br />
| Offset<br />
| Type<br />
| Description<br />
|-<br />
| 0<br />
| s32[2][4][160]<br />
| Samples<br />
|}<br />
<br />
== Compressor table ==<br />
<br />
A precomputed response curve lookup table for the compressor.</div>
Merry
https://www.3dbrew.org/w/index.php?title=DSP_Memory_Region&diff=15827
DSP Memory Region
2016-02-18T21:42:29Z
<p>Merry: /* Input status */</p>
<hr />
<div>'''Some of this is known to be incorrect. I'll correct this in a few months after a bit more RE work. [[User:Merry|Merry]] ([[User talk:Merry|talk]]) 21:10, 28 January 2016 (CET)'''<br />
<br />
----<br />
<br />
*Note that everything below will vary depending on the exact DSP firmware used and different variants have slightly different behaviours.*<br />
<br />
The DSP communicates with the application through two shared memory areas 0x8000 bytes long each (at 0x1FF50000 and 0x1FF70000 respectively). The DSP alternates between the use of these two areas (much like a double-buffer). Each area has 15 structures within it. The location of these structures can be obtained by [[DSP:ReadPipe|reading channel 2 of the DSP pipe]]. A list of structures in the order the DSP addresses are read from the pipe follows:<br />
<br />
1. Frame count<br />
<br />
2. Input configurations<br />
<br />
3. Input status<br />
<br />
4. Input ADPCM coefficients<br />
<br />
5. DSP configuration<br />
<br />
6. DSP status<br />
<br />
7. Output samples<br />
<br />
8. Intermediate mix samples<br />
<br />
9. Compressor table<br />
<br />
10. DSP debug statistics<br />
<br />
11. Unknown Coefficients<br />
<br />
12. Unknown Coefficients<br />
<br />
13. Unknown Coefficients<br />
<br />
14. Unknown Coefficients<br />
<br />
15. Unknown Coefficients<br />
<br />
The DSP has 24 inputs, each of which are individually configurable. These 24 inputs each produce three sets of 4 audio channels (two left, two right). <br />
<br />
These four audio channels feed into three intermediate mixers. Two of these intermediate mixers are used for effects and aux.<br />
<br />
== Frame Count ==<br />
<br />
== Input Config ==<br />
<br />
A 192 byte long structure. There are 24 of them.<br />
<br />
{| class="wikitable"<br />
|-<br />
| Offset<br />
| Type<br />
| Description<br />
|-<br />
| 0<br />
| u32<br />
| Dirty flags<br />
|-<br />
| 4<br />
| f32[3][2][2]<br />
| Input Gain (Each input has 12 channels)<br />
|-<br />
| 52<br />
| f32<br />
| Rate multiplier (1.0x == native DSP rate)<br />
|-<br />
| 56<br />
| u8<br />
| Interpolation mode<br />
|-<br />
| 57<br />
| u8<br />
| Polyphase filter select<br />
|-<br />
| 58<br />
| u16<br />
| bit[0]: Simple Filter enabled, bit[1]: Biquadratic Filter enabled<br />
|-<br />
| 60<br />
| SimpleFilter<br />
| Simple Filter (One pole normalized recursive linear filter)<br />
|-<br />
| 64<br />
| BiquadFilter<br />
| Biquadratic Filter (Two poles two zeros normalized recursive linear filter)<br />
|-<br />
| 74<br />
| u16<br />
| Bitmap of which buffers in queue are dirty<br />
|-<br />
| 76<br />
| Buffer[4]<br />
| Buffer queue<br />
|-<br />
| 156<br />
| u32<br />
| -<br />
|-<br />
| 160<br />
| u16<br />
| Is Active<br />
|-<br />
| 162<br />
| u16 <br />
| Sync Count<br />
|-<br />
| 164<br />
| u32<br />
| Play position<br />
|-<br />
| 168<br />
| 4<br />
| ?<br />
|-<br />
| 172<br />
| u32<br />
| Physical address of embedded buffer<br />
|-<br />
| 176<br />
| u32<br />
| Number of samples in embedded buffer<br />
|-<br />
| 180<br />
| u16<br />
| bits[0:1]: 1 = mono, 2 = stereo; bits[2:3]: buffer format, bits[5]: fade in<br />
|-<br />
| 182<br />
| AdpcmData<br />
| ADPCM data associated with embedded buffer<br />
|-<br />
| 188<br />
| u16<br />
| bit[0]: ADPCM updated?; bit[1]: Is looping?r<br />
|-<br />
| 190<br />
| u16<br />
| Buffer Id of embedded buffer<br />
|}<br />
<br />
=== Buffer ===<br />
<br />
{| class="wikitable"<br />
|-<br />
| Offset<br />
| Type<br />
| Description<br />
|-<br />
| 0<br />
| u32<br />
| Physical Address<br />
|-<br />
| 4 <br />
| u32<br />
| Sample Count<br />
|-<br />
| 8<br />
| AdpcmData<br />
| ADPCM data<br />
|-<br />
| 14<br />
| u8<br />
| ADPCM data dirty?<br />
|-<br />
| 15<br />
| u8<br />
| Looping?<br />
|-<br />
| 16<br />
| u16<br />
| Buffer Id<br />
|-<br />
| 18<br />
| u16<br />
| -<br />
|}<br />
<br />
=== Adpcm Data === <br />
<br />
{| class="wikitable"<br />
|-<br />
| 0<br />
| u8<br />
| ADPCM predictor/scale<br />
|-<br />
| 1<br />
| u8<br />
| -<br />
|-<br />
| 2<br />
| s16<br />
| ADPCM y[n-1]<br />
|-<br />
| 4<br />
| s16<br />
| ADPCM y[n-2]<br />
|}<br />
<br />
<br />
=== Simple Filter ===<br />
<br />
This is a standard single-pole filter. The fall-off is 6dB per octave as you would expect.<br />
<br />
{| class="wikitable"<br />
|-<br />
| Offset<br />
| Type<br />
| Description<br />
|-<br />
| 0<br />
| s16<br />
| b0<br />
|-<br />
| 2<br />
| s16<br />
| a1<br />
|}<br />
<br />
== Input status ==<br />
<br />
Read only. This structure is set by the DSP. This structure is 12 bytes long and there are 24 of them.<br />
<br />
{| class="wikitable"<br />
|-<br />
| Offset<br />
| Type<br />
| Description<br />
|-<br />
| 0<br />
| u8<br />
| Input Enabled?<br />
|-<br />
| 1<br />
| u8<br />
| Dirty flag for previous buffer id.<br />
|-<br />
| 2<br />
| u16<br />
| Sync count<br />
|-<br />
| 4<br />
| u32<br />
| Position (number of samples) into current buffer playback<br />
|-<br />
| 8<br />
| u16<br />
| Buffer id of last buffer that was played<br />
|-<br />
| 10<br />
| u16<br />
| -<br />
|}<br />
<br />
== Input ADPCM coefficients ==<br />
<br />
== DSP configuration ==<br />
<br />
=== Delay Effect ===<br />
<br />
Delay with feedback.<br />
<br />
Length of delay is expressed in terms of number of audio frames (there are 160 samples per audio frame).<br />
<br />
Feedback arm only has a gain on it. Under the feedback arm is a single-pole filter with the delay.<br />
<br />
=== Reverb Effect ===<br />
<br />
== DSP status ==<br />
<br />
Read only.<br />
<br />
== Output samples ==<br />
<br />
Read only.<br />
<br />
PCM16.<br />
<br />
== Intermediate mix samples ==<br />
<br />
Read/Write.<br />
<br />
PCM32. Also serves an aux function, allowing the ARM11 to apply custom effects to audio.<br />
<br />
== Compressor table ==<br />
<br />
A precomputed response curve lookup table for the compressor.</div>
Merry
https://www.3dbrew.org/w/index.php?title=DSP_Memory_Region&diff=15826
DSP Memory Region
2016-02-18T21:41:42Z
<p>Merry: SourceStatus</p>
<hr />
<div>'''Some of this is known to be incorrect. I'll correct this in a few months after a bit more RE work. [[User:Merry|Merry]] ([[User talk:Merry|talk]]) 21:10, 28 January 2016 (CET)'''<br />
<br />
----<br />
<br />
*Note that everything below will vary depending on the exact DSP firmware used and different variants have slightly different behaviours.*<br />
<br />
The DSP communicates with the application through two shared memory areas 0x8000 bytes long each (at 0x1FF50000 and 0x1FF70000 respectively). The DSP alternates between the use of these two areas (much like a double-buffer). Each area has 15 structures within it. The location of these structures can be obtained by [[DSP:ReadPipe|reading channel 2 of the DSP pipe]]. A list of structures in the order the DSP addresses are read from the pipe follows:<br />
<br />
1. Frame count<br />
<br />
2. Input configurations<br />
<br />
3. Input status<br />
<br />
4. Input ADPCM coefficients<br />
<br />
5. DSP configuration<br />
<br />
6. DSP status<br />
<br />
7. Output samples<br />
<br />
8. Intermediate mix samples<br />
<br />
9. Compressor table<br />
<br />
10. DSP debug statistics<br />
<br />
11. Unknown Coefficients<br />
<br />
12. Unknown Coefficients<br />
<br />
13. Unknown Coefficients<br />
<br />
14. Unknown Coefficients<br />
<br />
15. Unknown Coefficients<br />
<br />
The DSP has 24 inputs, each of which are individually configurable. These 24 inputs each produce three sets of 4 audio channels (two left, two right). <br />
<br />
These four audio channels feed into three intermediate mixers. Two of these intermediate mixers are used for effects and aux.<br />
<br />
== Frame Count ==<br />
<br />
== Input Config ==<br />
<br />
A 192 byte long structure. There are 24 of them.<br />
<br />
{| class="wikitable"<br />
|-<br />
| Offset<br />
| Type<br />
| Description<br />
|-<br />
| 0<br />
| u32<br />
| Dirty flags<br />
|-<br />
| 4<br />
| f32[3][2][2]<br />
| Input Gain (Each input has 12 channels)<br />
|-<br />
| 52<br />
| f32<br />
| Rate multiplier (1.0x == native DSP rate)<br />
|-<br />
| 56<br />
| u8<br />
| Interpolation mode<br />
|-<br />
| 57<br />
| u8<br />
| Polyphase filter select<br />
|-<br />
| 58<br />
| u16<br />
| bit[0]: Simple Filter enabled, bit[1]: Biquadratic Filter enabled<br />
|-<br />
| 60<br />
| SimpleFilter<br />
| Simple Filter (One pole normalized recursive linear filter)<br />
|-<br />
| 64<br />
| BiquadFilter<br />
| Biquadratic Filter (Two poles two zeros normalized recursive linear filter)<br />
|-<br />
| 74<br />
| u16<br />
| Bitmap of which buffers in queue are dirty<br />
|-<br />
| 76<br />
| Buffer[4]<br />
| Buffer queue<br />
|-<br />
| 156<br />
| u32<br />
| -<br />
|-<br />
| 160<br />
| u16<br />
| Is Active<br />
|-<br />
| 162<br />
| u16 <br />
| Sync Count<br />
|-<br />
| 164<br />
| u32<br />
| Play position<br />
|-<br />
| 168<br />
| 4<br />
| ?<br />
|-<br />
| 172<br />
| u32<br />
| Physical address of embedded buffer<br />
|-<br />
| 176<br />
| u32<br />
| Number of samples in embedded buffer<br />
|-<br />
| 180<br />
| u16<br />
| bits[0:1]: 1 = mono, 2 = stereo; bits[2:3]: buffer format, bits[5]: fade in<br />
|-<br />
| 182<br />
| AdpcmData<br />
| ADPCM data associated with embedded buffer<br />
|-<br />
| 188<br />
| u16<br />
| bit[0]: ADPCM updated?; bit[1]: Is looping?r<br />
|-<br />
| 190<br />
| u16<br />
| Buffer Id of embedded buffer<br />
|}<br />
<br />
=== Buffer ===<br />
<br />
{| class="wikitable"<br />
|-<br />
| Offset<br />
| Type<br />
| Description<br />
|-<br />
| 0<br />
| u32<br />
| Physical Address<br />
|-<br />
| 4 <br />
| u32<br />
| Sample Count<br />
|-<br />
| 8<br />
| AdpcmData<br />
| ADPCM data<br />
|-<br />
| 14<br />
| u8<br />
| ADPCM data dirty?<br />
|-<br />
| 15<br />
| u8<br />
| Looping?<br />
|-<br />
| 16<br />
| u16<br />
| Buffer Id<br />
|-<br />
| 18<br />
| u16<br />
| -<br />
|}<br />
<br />
=== Adpcm Data === <br />
<br />
{| class="wikitable"<br />
|-<br />
| 0<br />
| u8<br />
| ADPCM predictor/scale<br />
|-<br />
| 1<br />
| u8<br />
| -<br />
|-<br />
| 2<br />
| s16<br />
| ADPCM y[n-1]<br />
|-<br />
| 4<br />
| s16<br />
| ADPCM y[n-2]<br />
|}<br />
<br />
<br />
=== Simple Filter ===<br />
<br />
This is a standard single-pole filter. The fall-off is 6dB per octave as you would expect.<br />
<br />
{| class="wikitable"<br />
|-<br />
| Offset<br />
| Type<br />
| Description<br />
|-<br />
| 0<br />
| s16<br />
| b0<br />
|-<br />
| 2<br />
| s16<br />
| a1<br />
|}<br />
<br />
== Input status ==<br />
<br />
Read only.<br />
<br />
{| class="wikitable"<br />
|-<br />
| Offset<br />
| Type<br />
| Description<br />
|-<br />
| 0<br />
| u8<br />
| Input Enabled?<br />
|-<br />
| 1<br />
| u8<br />
| Dirty flag for previous buffer id.<br />
|-<br />
| 2<br />
| u16<br />
| Sync count<br />
|-<br />
| 4<br />
| u32<br />
| Position (number of samples) into current buffer playback<br />
|-<br />
| 8<br />
| u16<br />
| Buffer id of last buffer that was played<br />
|-<br />
| 10<br />
| u16<br />
| -<br />
|}<br />
<br />
== Input ADPCM coefficients ==<br />
<br />
== DSP configuration ==<br />
<br />
=== Delay Effect ===<br />
<br />
Delay with feedback.<br />
<br />
Length of delay is expressed in terms of number of audio frames (there are 160 samples per audio frame).<br />
<br />
Feedback arm only has a gain on it. Under the feedback arm is a single-pole filter with the delay.<br />
<br />
=== Reverb Effect ===<br />
<br />
== DSP status ==<br />
<br />
Read only.<br />
<br />
== Output samples ==<br />
<br />
Read only.<br />
<br />
PCM16.<br />
<br />
== Intermediate mix samples ==<br />
<br />
Read/Write.<br />
<br />
PCM32. Also serves an aux function, allowing the ARM11 to apply custom effects to audio.<br />
<br />
== Compressor table ==<br />
<br />
A precomputed response curve lookup table for the compressor.</div>
Merry
https://www.3dbrew.org/w/index.php?title=DSP_Memory_Region&diff=15804
DSP Memory Region
2016-02-17T21:57:23Z
<p>Merry: </p>
<hr />
<div>'''Some of this is known to be incorrect. I'll correct this in a few months after a bit more RE work. [[User:Merry|Merry]] ([[User talk:Merry|talk]]) 21:10, 28 January 2016 (CET)'''<br />
<br />
----<br />
<br />
*Note that everything below will vary depending on the exact DSP firmware used and different variants have slightly different behaviours.*<br />
<br />
The DSP communicates with the application through two shared memory areas 0x8000 bytes long each (at 0x1FF50000 and 0x1FF70000 respectively). The DSP alternates between the use of these two areas (much like a double-buffer). Each area has 15 structures within it. The location of these structures can be obtained by [[DSP:ReadPipe|reading channel 2 of the DSP pipe]]. A list of structures in the order the DSP addresses are read from the pipe follows:<br />
<br />
1. Frame count<br />
<br />
2. Input configurations<br />
<br />
3. Input status<br />
<br />
4. Input ADPCM coefficients<br />
<br />
5. DSP configuration<br />
<br />
6. DSP status<br />
<br />
7. Output samples<br />
<br />
8. Intermediate mix samples<br />
<br />
9. Compressor table<br />
<br />
10. DSP debug statistics<br />
<br />
11. Unknown Coefficients<br />
<br />
12. Unknown Coefficients<br />
<br />
13. Unknown Coefficients<br />
<br />
14. Unknown Coefficients<br />
<br />
15. Unknown Coefficients<br />
<br />
The DSP has 24 inputs, each of which are individually configurable. These 24 inputs each produce three sets of 4 audio channels (two left, two right). <br />
<br />
These four audio channels feed into three intermediate mixers. Two of these intermediate mixers are used for effects and aux.<br />
<br />
== Frame Count ==<br />
<br />
== Input Config ==<br />
<br />
A 192 byte long structure. There are 24 of them.<br />
<br />
{| class="wikitable"<br />
|-<br />
| Offset<br />
| Type<br />
| Description<br />
|-<br />
| 0<br />
| u32<br />
| Dirty flags<br />
|-<br />
| 4<br />
| f32[3][2][2]<br />
| Input Gain (Each input has 12 channels)<br />
|-<br />
| 52<br />
| f32<br />
| Rate multiplier (1.0x == native DSP rate)<br />
|-<br />
| 56<br />
| u8<br />
| Interpolation mode<br />
|-<br />
| 57<br />
| u8<br />
| Polyphase filter select<br />
|-<br />
| 58<br />
| u16<br />
| bit[0]: Simple Filter enabled, bit[1]: Biquadratic Filter enabled<br />
|-<br />
| 60<br />
| SimpleFilter<br />
| Simple Filter (One pole normalized recursive linear filter)<br />
|-<br />
| 64<br />
| BiquadFilter<br />
| Biquadratic Filter (Two poles two zeros normalized recursive linear filter)<br />
|-<br />
| 74<br />
| u16<br />
| Bitmap of which buffers in queue are dirty<br />
|-<br />
| 76<br />
| Buffer[4]<br />
| Buffer queue<br />
|-<br />
| 156<br />
| u32<br />
| -<br />
|-<br />
| 160<br />
| u16<br />
| Is Active<br />
|-<br />
| 162<br />
| u16 <br />
| Sync Count<br />
|-<br />
| 164<br />
| u32<br />
| Play position<br />
|-<br />
| 168<br />
| 4<br />
| ?<br />
|-<br />
| 172<br />
| u32<br />
| Physical address of embedded buffer<br />
|-<br />
| 176<br />
| u32<br />
| Number of samples in embedded buffer<br />
|-<br />
| 180<br />
| u16<br />
| bits[0:1]: 1 = mono, 2 = stereo; bits[2:3]: buffer format, bits[5]: fade in<br />
|-<br />
| 182<br />
| AdpcmData<br />
| ADPCM data associated with embedded buffer<br />
|-<br />
| 188<br />
| u16<br />
| bit[0]: ADPCM updated?; bit[1]: Is looping?r<br />
|-<br />
| 190<br />
| u16<br />
| Buffer Id of embedded buffer<br />
|}<br />
<br />
=== Buffer ===<br />
<br />
{| class="wikitable"<br />
|-<br />
| Offset<br />
| Type<br />
| Description<br />
|-<br />
| 0<br />
| u32<br />
| Physical Address<br />
|-<br />
| 4 <br />
| u32<br />
| Sample Count<br />
|-<br />
| 8<br />
| AdpcmData<br />
| ADPCM data<br />
|-<br />
| 14<br />
| u8<br />
| ADPCM data dirty?<br />
|-<br />
| 15<br />
| u8<br />
| Looping?<br />
|-<br />
| 16<br />
| u16<br />
| Buffer Id<br />
|-<br />
| 18<br />
| u16<br />
| -<br />
|}<br />
<br />
=== Adpcm Data === <br />
<br />
{| class="wikitable"<br />
|-<br />
| 0<br />
| u8<br />
| ADPCM predictor/scale<br />
|-<br />
| 1<br />
| u8<br />
| -<br />
|-<br />
| 2<br />
| s16<br />
| ADPCM y[n-1]<br />
|-<br />
| 4<br />
| s16<br />
| ADPCM y[n-2]<br />
|}<br />
<br />
<br />
=== Simple Filter ===<br />
<br />
This is a standard single-pole filter. The fall-off is 6dB per octave as you would expect.<br />
<br />
{| class="wikitable"<br />
|-<br />
| Offset<br />
| Type<br />
| Description<br />
|-<br />
| 0<br />
| s16<br />
| b0<br />
|-<br />
| 2<br />
| s16<br />
| a1<br />
|}<br />
<br />
== Input status ==<br />
<br />
Read only.<br />
<br />
== Input ADPCM coefficients ==<br />
<br />
== DSP configuration ==<br />
<br />
=== Delay Effect ===<br />
<br />
Delay with feedback.<br />
<br />
Length of delay is expressed in terms of number of audio frames (there are 160 samples per audio frame).<br />
<br />
Feedback arm only has a gain on it. Under the feedback arm is a single-pole filter with the delay.<br />
<br />
=== Reverb Effect ===<br />
<br />
== DSP status ==<br />
<br />
Read only.<br />
<br />
== Output samples ==<br />
<br />
Read only.<br />
<br />
PCM16.<br />
<br />
== Intermediate mix samples ==<br />
<br />
Read/Write.<br />
<br />
PCM32. Also serves an aux function, allowing the ARM11 to apply custom effects to audio.<br />
<br />
== Compressor table ==<br />
<br />
A precomputed response curve lookup table for the compressor.</div>
Merry
https://www.3dbrew.org/w/index.php?title=DSP_Memory_Region&diff=15803
DSP Memory Region
2016-02-17T20:23:37Z
<p>Merry: /* Simple Filter */</p>
<hr />
<div>'''Some of this is known to be incorrect. I'll correct this in a few months after a bit more RE work. [[User:Merry|Merry]] ([[User talk:Merry|talk]]) 21:10, 28 January 2016 (CET)'''<br />
<br />
----<br />
<br />
*Note that everything below will vary depending on the exact DSP firmware used and different variants have slightly different behaviours.*<br />
<br />
The DSP communicates with the application through two shared memory areas 0x8000 bytes long each (at 0x1FF50000 and 0x1FF70000 respectively). The DSP alternates between the use of these two areas (much like a double-buffer). Each area has 15 structures within it. The location of these structures can be obtained by [[DSP:ReadPipe|reading channel 2 of the DSP pipe]]. A list of structures in the order the DSP addresses are read from the pipe follows:<br />
<br />
1. Frame count<br />
<br />
2. Input configurations<br />
<br />
3. Input status<br />
<br />
4. Input ADPCM coefficients<br />
<br />
5. DSP configuration<br />
<br />
6. DSP status<br />
<br />
7. Output samples<br />
<br />
8. Intermediate mix samples<br />
<br />
9. Compressor table<br />
<br />
10. DSP debug statistics<br />
<br />
11. Unknown Coefficients<br />
<br />
12. Unknown Coefficients<br />
<br />
13. Unknown Coefficients<br />
<br />
14. Unknown Coefficients<br />
<br />
15. Unknown Coefficients<br />
<br />
The DSP has 24 inputs, each of which are individually configurable. These 24 inputs each produce three sets of 4 audio channels (two left, two right). <br />
<br />
These four audio channels feed into three intermediate mixers. Two of these intermediate mixers are used for effects and aux.<br />
<br />
== Frame Count ==<br />
<br />
== Input Config ==<br />
<br />
A 192 byte long structure. There are 24 of them.<br />
<br />
{| class="wikitable"<br />
|-<br />
| Offset<br />
| Type<br />
| Description<br />
|-<br />
| 0<br />
| u32<br />
| Dirty flags<br />
|-<br />
| 4<br />
| f32[3][2][2]<br />
| Input Gain (Each input has 12 channels)<br />
|-<br />
| 52<br />
| f32<br />
| Rate multiplier (1.0x == native DSP rate)<br />
|-<br />
| 56<br />
| u8<br />
| Interpolation mode<br />
|-<br />
| 57<br />
| u8<br />
| Polyphase filter select<br />
|-<br />
| 58<br />
| u16<br />
| bit[0]: Simple Filter enabled, bit[1]: Biquadratic Filter enabled<br />
|-<br />
| 60<br />
| SimpleFilter<br />
| Simple Filter (One pole normalized recursive linear filter)<br />
|-<br />
| 64<br />
| BiquadFilter<br />
| Biquadratic Filter (Two poles two zeros normalized recursive linear filter)<br />
|-<br />
| 74<br />
| u16<br />
| Bitmap of which buffers in queue are dirty<br />
|-<br />
| 76<br />
| Buffer[4]<br />
| Buffer queue<br />
|-<br />
| 156<br />
| u32<br />
| -<br />
|-<br />
| 160<br />
| u16<br />
| Is Active<br />
|-<br />
| 162<br />
| u16 <br />
| Sync Count<br />
|-<br />
| 164<br />
| u32<br />
| Play position<br />
|-<br />
| 168<br />
| 4<br />
| ?<br />
|-<br />
| 172<br />
| u32<br />
| Physical address of embedded buffer<br />
|-<br />
| 176<br />
| u32<br />
| Number of samples in embedded buffer<br />
|-<br />
| 180<br />
| u16<br />
| bits[0:1]: 1 = mono, 2 = stereo; bits[2:3]: buffer format, bits[5]: fade in<br />
|-<br />
| 182<br />
| AdpcmData<br />
| ADPCM data associated with embedded buffer<br />
|-<br />
| 188<br />
| u16<br />
| bit[0]: ADPCM updated?; bit[1]: Is looping?r<br />
|-<br />
| 190<br />
| u16<br />
| Buffer Id of embedded buffer<br />
|}<br />
<br />
=== Buffer ===<br />
<br />
{| class="wikitable"<br />
|-<br />
| Offset<br />
| Type<br />
| Description<br />
|-<br />
| 0<br />
| u32<br />
| Physical Address<br />
|-<br />
| 4 <br />
| u32<br />
| Sample Count<br />
|-<br />
| 8<br />
| AdpcmData<br />
| ADPCM data<br />
|-<br />
| 14<br />
| u8<br />
| ADPCM data dirty?<br />
|-<br />
| 15<br />
| u8<br />
| Looping?<br />
|-<br />
| 16<br />
| u16<br />
| Buffer Id<br />
|-<br />
| 18<br />
| u16<br />
| -<br />
|}<br />
<br />
=== Adpcm Data === <br />
<br />
{| class="wikitable"<br />
|-<br />
| 0<br />
| u8<br />
| ADPCM predictor/scale<br />
|-<br />
| 1<br />
| u8<br />
| -<br />
|-<br />
| 2<br />
| s16<br />
| ADPCM y[n-1]<br />
|-<br />
| 4<br />
| s16<br />
| ADPCM y[n-2]<br />
|}<br />
<br />
<br />
=== Simple Filter ===<br />
<br />
This is a standard single-pole filter. The fall-off is 6dB per octave as you would expect.<br />
<br />
{| class="wikitable"<br />
|-<br />
| Offset<br />
| Type<br />
| Description<br />
|-<br />
| 0<br />
| s16<br />
| b0<br />
|-<br />
| 2<br />
| s16<br />
| a1<br />
|}<br />
<br />
== Input status ==<br />
<br />
Read only.<br />
<br />
== Input ADPCM coefficients ==<br />
<br />
== DSP configuration ==<br />
<br />
=== Delay Effect ===<br />
<br />
Delay with feedback.<br />
<br />
Length of delay is a multiple of audio frames. There are 160 samples per audioframe.<br />
<br />
Feedback arm only has a gain on it. Under the feedback arm is a single-pole filter with the delay.<br />
<br />
=== Reverb Effect ===<br />
<br />
== DSP status ==<br />
<br />
Read only.<br />
<br />
== Output samples ==<br />
<br />
Read only.<br />
<br />
PCM16.<br />
<br />
== Intermediate mix samples ==<br />
<br />
Read/Write.<br />
<br />
PCM32. Also serves an aux function, allowing the ARM11 to apply custom effects to audio.<br />
<br />
== Compressor table ==<br />
<br />
A precomputed response curve lookup table for the compressor.</div>
Merry
https://www.3dbrew.org/w/index.php?title=DSP_Memory_Region&diff=15802
DSP Memory Region
2016-02-17T20:16:31Z
<p>Merry: /* Input Config */</p>
<hr />
<div>'''Some of this is known to be incorrect. I'll correct this in a few months after a bit more RE work. [[User:Merry|Merry]] ([[User talk:Merry|talk]]) 21:10, 28 January 2016 (CET)'''<br />
<br />
----<br />
<br />
*Note that everything below will vary depending on the exact DSP firmware used and different variants have slightly different behaviours.*<br />
<br />
The DSP communicates with the application through two shared memory areas 0x8000 bytes long each (at 0x1FF50000 and 0x1FF70000 respectively). The DSP alternates between the use of these two areas (much like a double-buffer). Each area has 15 structures within it. The location of these structures can be obtained by [[DSP:ReadPipe|reading channel 2 of the DSP pipe]]. A list of structures in the order the DSP addresses are read from the pipe follows:<br />
<br />
1. Frame count<br />
<br />
2. Input configurations<br />
<br />
3. Input status<br />
<br />
4. Input ADPCM coefficients<br />
<br />
5. DSP configuration<br />
<br />
6. DSP status<br />
<br />
7. Output samples<br />
<br />
8. Intermediate mix samples<br />
<br />
9. Compressor table<br />
<br />
10. DSP debug statistics<br />
<br />
11. Unknown Coefficients<br />
<br />
12. Unknown Coefficients<br />
<br />
13. Unknown Coefficients<br />
<br />
14. Unknown Coefficients<br />
<br />
15. Unknown Coefficients<br />
<br />
The DSP has 24 inputs, each of which are individually configurable. These 24 inputs each produce three sets of 4 audio channels (two left, two right). <br />
<br />
These four audio channels feed into three intermediate mixers. Two of these intermediate mixers are used for effects and aux.<br />
<br />
== Frame Count ==<br />
<br />
== Input Config ==<br />
<br />
A 192 byte long structure. There are 24 of them.<br />
<br />
{| class="wikitable"<br />
|-<br />
| Offset<br />
| Type<br />
| Description<br />
|-<br />
| 0<br />
| u32<br />
| Dirty flags<br />
|-<br />
| 4<br />
| f32[3][2][2]<br />
| Input Gain (Each input has 12 channels)<br />
|-<br />
| 52<br />
| f32<br />
| Rate multiplier (1.0x == native DSP rate)<br />
|-<br />
| 56<br />
| u8<br />
| Interpolation mode<br />
|-<br />
| 57<br />
| u8<br />
| Polyphase filter select<br />
|-<br />
| 58<br />
| u16<br />
| bit[0]: Simple Filter enabled, bit[1]: Biquadratic Filter enabled<br />
|-<br />
| 60<br />
| SimpleFilter<br />
| Simple Filter (One pole normalized recursive linear filter)<br />
|-<br />
| 64<br />
| BiquadFilter<br />
| Biquadratic Filter (Two poles two zeros normalized recursive linear filter)<br />
|-<br />
| 74<br />
| u16<br />
| Bitmap of which buffers in queue are dirty<br />
|-<br />
| 76<br />
| Buffer[4]<br />
| Buffer queue<br />
|-<br />
| 156<br />
| u32<br />
| -<br />
|-<br />
| 160<br />
| u16<br />
| Is Active<br />
|-<br />
| 162<br />
| u16 <br />
| Sync Count<br />
|-<br />
| 164<br />
| u32<br />
| Play position<br />
|-<br />
| 168<br />
| 4<br />
| ?<br />
|-<br />
| 172<br />
| u32<br />
| Physical address of embedded buffer<br />
|-<br />
| 176<br />
| u32<br />
| Number of samples in embedded buffer<br />
|-<br />
| 180<br />
| u16<br />
| bits[0:1]: 1 = mono, 2 = stereo; bits[2:3]: buffer format, bits[5]: fade in<br />
|-<br />
| 182<br />
| AdpcmData<br />
| ADPCM data associated with embedded buffer<br />
|-<br />
| 188<br />
| u16<br />
| bit[0]: ADPCM updated?; bit[1]: Is looping?r<br />
|-<br />
| 190<br />
| u16<br />
| Buffer Id of embedded buffer<br />
|}<br />
<br />
=== Buffer ===<br />
<br />
{| class="wikitable"<br />
|-<br />
| Offset<br />
| Type<br />
| Description<br />
|-<br />
| 0<br />
| u32<br />
| Physical Address<br />
|-<br />
| 4 <br />
| u32<br />
| Sample Count<br />
|-<br />
| 8<br />
| AdpcmData<br />
| ADPCM data<br />
|-<br />
| 14<br />
| u8<br />
| ADPCM data dirty?<br />
|-<br />
| 15<br />
| u8<br />
| Looping?<br />
|-<br />
| 16<br />
| u16<br />
| Buffer Id<br />
|-<br />
| 18<br />
| u16<br />
| -<br />
|}<br />
<br />
=== Adpcm Data === <br />
<br />
{| class="wikitable"<br />
|-<br />
| 0<br />
| u8<br />
| ADPCM predictor/scale<br />
|-<br />
| 1<br />
| u8<br />
| -<br />
|-<br />
| 2<br />
| s16<br />
| ADPCM y[n-1]<br />
|-<br />
| 4<br />
| s16<br />
| ADPCM y[n-2]<br />
|}<br />
<br />
<br />
=== Simple Filter ===<br />
<br />
This is a standard single-pole filter. The fall-off is 6dB per octave as you would expect.<br />
<br />
{| class="wikitable"<br />
|-<br />
| Offset<br />
| Type<br />
| Description<br />
|-<br />
| 0<br />
| s16<br />
| b0<br />
|-<br />
| 0<br />
| s16<br />
| a1<br />
|}<br />
<br />
== Input status ==<br />
<br />
Read only.<br />
<br />
== Input ADPCM coefficients ==<br />
<br />
== DSP configuration ==<br />
<br />
=== Delay Effect ===<br />
<br />
Delay with feedback.<br />
<br />
Length of delay is a multiple of audio frames. There are 160 samples per audioframe.<br />
<br />
Feedback arm only has a gain on it. Under the feedback arm is a single-pole filter with the delay.<br />
<br />
=== Reverb Effect ===<br />
<br />
== DSP status ==<br />
<br />
Read only.<br />
<br />
== Output samples ==<br />
<br />
Read only.<br />
<br />
PCM16.<br />
<br />
== Intermediate mix samples ==<br />
<br />
Read/Write.<br />
<br />
PCM32. Also serves an aux function, allowing the ARM11 to apply custom effects to audio.<br />
<br />
== Compressor table ==<br />
<br />
A precomputed response curve lookup table for the compressor.</div>
Merry
https://www.3dbrew.org/w/index.php?title=DSP_Memory_Region&diff=15801
DSP Memory Region
2016-02-17T19:56:32Z
<p>Merry: </p>
<hr />
<div>'''Some of this is known to be incorrect. I'll correct this in a few months after a bit more RE work. [[User:Merry|Merry]] ([[User talk:Merry|talk]]) 21:10, 28 January 2016 (CET)'''<br />
<br />
----<br />
<br />
*Note that everything below will vary depending on the exact DSP firmware used and different variants have slightly different behaviours.*<br />
<br />
The DSP communicates with the application through two shared memory areas 0x8000 bytes long each (at 0x1FF50000 and 0x1FF70000 respectively). The DSP alternates between the use of these two areas (much like a double-buffer). Each area has 15 structures within it. The location of these structures can be obtained by [[DSP:ReadPipe|reading channel 2 of the DSP pipe]]. A list of structures in the order the DSP addresses are read from the pipe follows:<br />
<br />
1. Frame count<br />
<br />
2. Input configurations<br />
<br />
3. Input status<br />
<br />
4. Input ADPCM coefficients<br />
<br />
5. DSP configuration<br />
<br />
6. DSP status<br />
<br />
7. Output samples<br />
<br />
8. Intermediate mix samples<br />
<br />
9. Compressor table<br />
<br />
10. DSP debug statistics<br />
<br />
11. Unknown Coefficients<br />
<br />
12. Unknown Coefficients<br />
<br />
13. Unknown Coefficients<br />
<br />
14. Unknown Coefficients<br />
<br />
15. Unknown Coefficients<br />
<br />
The DSP has 24 inputs, each of which are individually configurable. These 24 inputs each produce three sets of 4 audio channels (two left, two right). <br />
<br />
These four audio channels feed into three intermediate mixers. Two of these intermediate mixers are used for effects and aux.<br />
<br />
== Frame Count ==<br />
<br />
== Input Config ==<br />
<br />
A 192 byte long structure. There are 24 of them.<br />
<br />
{| class="wikitable"<br />
|-<br />
| Offset<br />
| Type<br />
| Description<br />
|-<br />
| 0<br />
| u32<br />
| Dirty flags<br />
|-<br />
| 4<br />
| 70 bytes<br />
| TODO<br />
|-<br />
| 74<br />
| u16<br />
| Bitmap of which buffers in queue are dirty<br />
|-<br />
| 76<br />
| Buffer[4]<br />
| Buffer queue<br />
|-<br />
| 156<br />
| u32<br />
| -<br />
|-<br />
| 160<br />
| u16<br />
| Is Active<br />
|-<br />
| 162<br />
| u16 <br />
| Sync Count<br />
|-<br />
| 164<br />
| 8<br />
| TODO<br />
|-<br />
| 172<br />
| u32<br />
| Physical address of current buffer<br />
|-<br />
| 176<br />
| u32<br />
| Number of samples in current buffer<br />
|-<br />
| 180<br />
| u16<br />
| bits[0:1]: 1 = mono, 2 = stereo; bits[2:3]: buffer format, bits[5]: fade in<br />
|-<br />
| 182<br />
| u16<br />
| ADPCM predictor/scale<br />
|-<br />
| 184<br />
| s16<br />
| ADPCM y[n-1]<br />
|-<br />
| 186<br />
| s16<br />
| ADPCM y[n-2]<br />
|-<br />
| 188<br />
| u16<br />
| bit[0]: ADPCM updated?; bit[1]: Is looping?<br />
|-<br />
| 190<br />
| u16<br />
| Buffer Id of this current buffer<br />
|}<br />
<br />
=== Buffer ===<br />
<br />
{| class="wikitable"<br />
|-<br />
| Offset<br />
| Type<br />
| Description<br />
|-<br />
| 0<br />
| u32<br />
| Physical Address<br />
|-<br />
| 4 <br />
| u32<br />
| Sample Count<br />
|-<br />
| 8<br />
| u16<br />
| 4 bits: ADPCM Predictor, 4 bits: ADPCM Scale<br />
|-<br />
| 10<br />
| s16<br />
| ADPCM y[n-1]<br />
|-<br />
| 11<br />
| s16<br />
| ADPCM y[n-2]<br />
|-<br />
| 14<br />
| u8<br />
| ADPCM dirty?<br />
|-<br />
| 15<br />
| u8<br />
| Looping?<br />
|-<br />
| 16<br />
| u16<br />
| Buffer Id<br />
|-<br />
| 18<br />
| u16<br />
| -<br />
|}<br />
<br />
=== Simple Filter ===<br />
<br />
This is a standard single-pole filter. The fall-off is 6dB per octave as you would expect.<br />
<br />
{| class="wikitable"<br />
|-<br />
| Offset<br />
| Type<br />
| Description<br />
|-<br />
| 0<br />
| s16<br />
| b0<br />
|-<br />
| 0<br />
| s16<br />
| a1<br />
|}<br />
<br />
== Input status ==<br />
<br />
Read only.<br />
<br />
== Input ADPCM coefficients ==<br />
<br />
== DSP configuration ==<br />
<br />
=== Delay Effect ===<br />
<br />
Delay with feedback.<br />
<br />
Length of delay is a multiple of audio frames. There are 160 samples per audioframe.<br />
<br />
Feedback arm only has a gain on it. Under the feedback arm is a single-pole filter with the delay.<br />
<br />
=== Reverb Effect ===<br />
<br />
== DSP status ==<br />
<br />
Read only.<br />
<br />
== Output samples ==<br />
<br />
Read only.<br />
<br />
PCM16.<br />
<br />
== Intermediate mix samples ==<br />
<br />
Read/Write.<br />
<br />
PCM32. Also serves an aux function, allowing the ARM11 to apply custom effects to audio.<br />
<br />
== Compressor table ==<br />
<br />
A precomputed response curve lookup table for the compressor.</div>
Merry
https://www.3dbrew.org/w/index.php?title=DSP_Memory_Region&diff=15795
DSP Memory Region
2016-02-17T09:12:05Z
<p>Merry: </p>
<hr />
<div>'''Some of this is known to be incorrect. I'll correct this in a few months after a bit more RE work. [[User:Merry|Merry]] ([[User talk:Merry|talk]]) 21:10, 28 January 2016 (CET)'''<br />
<br />
----<br />
<br />
*Note that everything below will vary depending on the exact DSP firmware used and different variants have slightly different behaviours.*<br />
<br />
The DSP communicates with the application through two shared memory areas 0x8000 bytes long each (at 0x1FF50000 and 0x1FF70000 respectively). The DSP alternates between the use of these two areas (much like a double-buffer). Each area has 15 structures within it. The location of these structures can be obtained by [[DSP:ReadPipe|reading channel 2 of the DSP pipe]]. A list of structures in the order the DSP addresses are read from the pipe follows:<br />
<br />
1. Frame count<br />
<br />
2. Input configurations<br />
<br />
3. Input status<br />
<br />
4. Input ADPCM coefficients<br />
<br />
5. DSP configuration<br />
<br />
6. DSP status<br />
<br />
7. Output samples<br />
<br />
8. Intermediate mix samples<br />
<br />
9. Compressor table<br />
<br />
10. DSP debug statistics<br />
<br />
11. Unknown Coefficients<br />
<br />
12. Unknown Coefficients<br />
<br />
13. Unknown Coefficients<br />
<br />
14. Unknown Coefficients<br />
<br />
15. Unknown Coefficients<br />
<br />
The DSP has 24 inputs, each of which are individually configurable. These 24 inputs each produce three sets of 4 audio channels (two left, two right). <br />
<br />
These four audio channels feed into three intermediate mixers. Two of these intermediate mixers are used for effects and aux.<br />
<br />
== Channel Config ==<br />
<br />
A 192 byte long structure. There are 24 of them.<br />
<br />
{| class="wikitable"<br />
|-<br />
| Offset<br />
| Type<br />
| Description<br />
|-<br />
| 0<br />
| u32<br />
| Dirty flags<br />
|-<br />
| 4<br />
| 70 bytes<br />
| TODO<br />
|-<br />
| 74<br />
| u16<br />
| Bitmap of which buffers in queue are dirty<br />
|-<br />
| 76<br />
| Buffer[4]<br />
| Buffer queue<br />
|-<br />
| 156<br />
| u32<br />
| -<br />
|-<br />
| 160<br />
| u16<br />
| Is Active<br />
|-<br />
| 162<br />
| u16 <br />
| Sync Count<br />
|-<br />
| 164<br />
| 8<br />
| TODO<br />
|-<br />
| 172<br />
| u32<br />
| Physical address of current buffer<br />
|-<br />
| 176<br />
| u32<br />
| Number of samples in current buffer<br />
|-<br />
| 180<br />
| u16<br />
| bits[0:1]: 1 = mono, 2 = stereo; bits[2:3]: buffer format<br />
|-<br />
| 182<br />
| u16<br />
| ADPCM predictor<br />
|-<br />
| 184<br />
| s16<br />
| ADPCM yn1<br />
|-<br />
| 186<br />
| s16<br />
| ADPCM yn2<br />
|-<br />
| 188<br />
| u16<br />
| bit[0]: Has ADPCM data?; bit[1]: Is looping?<br />
|-<br />
| 190<br />
| u16<br />
| Buffer Id of this current buffer<br />
|}<br />
<br />
=== Buffer ===<br />
<br />
{| class="wikitable"<br />
|-<br />
| Offset<br />
| Type<br />
| Description<br />
|-<br />
| 0<br />
| u32<br />
| Physical Address<br />
|-<br />
| 4 <br />
| u32<br />
| Sample Count<br />
|-<br />
| 8<br />
| u16<br />
| ADPCM P/S<br />
|-<br />
| 10<br />
| s16[2]<br />
| ADPCM yn[1,2]<br />
|-<br />
| 14<br />
| u8<br />
| Has ADPCM?<br />
|-<br />
| 15<br />
| u8<br />
| Looping?<br />
|-<br />
| 16<br />
| u16<br />
| Buffer Id<br />
|-<br />
| 18<br />
| u16<br />
| -<br />
|}<br />
<br />
=== Simple Filter Configuration ===<br />
<br />
This is a standard single-pole filter. The fall-off is 6dB per octave as you would expect.<br />
<br />
{| class="wikitable"<br />
|-<br />
| Offset<br />
| Type<br />
| Description<br />
|-<br />
| 0<br />
| s16<br />
| b0<br />
|-<br />
| 0<br />
| s16<br />
| a1<br />
|}</div>
Merry
https://www.3dbrew.org/w/index.php?title=DSP_Memory_Region&diff=15791
DSP Memory Region
2016-02-16T22:08:05Z
<p>Merry: </p>
<hr />
<div>'''Some of this is known to be incorrect. I'll correct this in a few months after a bit more RE work. [[User:Merry|Merry]] ([[User talk:Merry|talk]]) 21:10, 28 January 2016 (CET)'''<br />
<br />
----<br />
<br />
*Note that everything below will vary depending on the exact DSP firmware used and different variants have slightly different behaviours.*<br />
<br />
The DSP communicates with the application through two shared memory areas 0x8000 bytes long each (at 0x1FF50000 and 0x1FF70000 respectively). The DSP alternates between the use of these two areas (much like a double-buffer). Each area has 15 structures within it. The location of these structures can be obtained by [[DSP:ReadPipe|reading channel 2 of the DSP pipe]]. A list of structures in the order the DSP addresses are read from the pipe follows:<br />
<br />
1. Frame count<br />
<br />
2. Input configurations<br />
<br />
3. Input status<br />
<br />
4. Input ADPCM coefficients<br />
<br />
5. DSP configuration<br />
<br />
6. DSP status<br />
<br />
7. Output samples<br />
<br />
8. Intermediate mix samples<br />
<br />
9. Unknown Coefficients<br />
<br />
10. DSP debug statistics<br />
<br />
11. Unknown Coefficients<br />
<br />
12. Unknown Coefficients<br />
<br />
13. Unknown Coefficients<br />
<br />
14. Unknown Coefficients<br />
<br />
15. Unknown Coefficients<br />
<br />
The DSP has 24 inputs, each of which are individually configurable. These 24 inputs each produce three sets of 4 audio channels (two left, two right). <br />
<br />
These four audio channels feed into three intermediate mixers. Two of these intermediate mixers are used for effects and aux.<br />
<br />
== Channel Config ==<br />
<br />
A 192 byte long structure. There are 24 of them.<br />
<br />
{| class="wikitable"<br />
|-<br />
| Offset<br />
| Type<br />
| Description<br />
|-<br />
| 0<br />
| u32<br />
| Dirty flags<br />
|-<br />
| 4<br />
| 70 bytes<br />
| TODO<br />
|-<br />
| 74<br />
| u16<br />
| Bitmap of which buffers in queue are dirty<br />
|-<br />
| 76<br />
| Buffer[4]<br />
| Buffer queue<br />
|-<br />
| 156<br />
| u32<br />
| -<br />
|-<br />
| 160<br />
| u16<br />
| Is Active<br />
|-<br />
| 162<br />
| u16 <br />
| Sync Count<br />
|-<br />
| 164<br />
| 8<br />
| TODO<br />
|-<br />
| 172<br />
| u32<br />
| Physical address of current buffer<br />
|-<br />
| 176<br />
| u32<br />
| Number of samples in current buffer<br />
|-<br />
| 180<br />
| u16<br />
| bits[0:1]: 1 = mono, 2 = stereo; bits[2:3]: buffer format<br />
|-<br />
| 182<br />
| u16<br />
| ADPCM predictor<br />
|-<br />
| 184<br />
| s16<br />
| ADPCM yn1<br />
|-<br />
| 186<br />
| s16<br />
| ADPCM yn2<br />
|-<br />
| 188<br />
| u16<br />
| bit[0]: Has ADPCM data?; bit[1]: Is looping?<br />
|-<br />
| 190<br />
| u16<br />
| Buffer Id of this current buffer<br />
|}<br />
<br />
=== Buffer ===<br />
<br />
{| class="wikitable"<br />
|-<br />
| Offset<br />
| Type<br />
| Description<br />
|-<br />
| 0<br />
| u32<br />
| Physical Address<br />
|-<br />
| 4 <br />
| u32<br />
| Sample Count<br />
|-<br />
| 8<br />
| u16<br />
| ADPCM P/S<br />
|-<br />
| 10<br />
| s16[2]<br />
| ADPCM yn[1,2]<br />
|-<br />
| 14<br />
| u8<br />
| Has ADPCM?<br />
|-<br />
| 15<br />
| u8<br />
| Looping?<br />
|-<br />
| 16<br />
| u16<br />
| Buffer Id<br />
|-<br />
| 18<br />
| u16<br />
| -<br />
|}<br />
<br />
=== Simple Filter Configuration ===<br />
<br />
This is a standard single-pole filter. The fall-off is 6dB per octave as you would expect.<br />
<br />
{| class="wikitable"<br />
|-<br />
| Offset<br />
| Type<br />
| Description<br />
|-<br />
| 0<br />
| s16<br />
| b0<br />
|-<br />
| 0<br />
| s16<br />
| a1<br />
|}</div>
Merry
https://www.3dbrew.org/w/index.php?title=DSP_Memory_Region&diff=15790
DSP Memory Region
2016-02-16T22:07:17Z
<p>Merry: </p>
<hr />
<div>'''Some of this is known to be incorrect. I'll correct this in a few months after a bit more RE work. [[User:Merry|Merry]] ([[User talk:Merry|talk]]) 21:10, 28 January 2016 (CET)'''<br />
<br />
----<br />
<br />
*Note that everything below will vary depending on the exact DSP firmware used and different variants have slightly different behaviours.*<br />
<br />
The DSP communicates with the application through two shared memory areas 0x8000 bytes long each (at 0x1FF50000 and 0x1FF70000 respectively). The DSP alternates between the use of these two areas (much like a double-buffer). Each area has 15 structures within it. The location of these structures can be obtained by [[DSP:ReadPipe|reading channel 2 of the DSP pipe]]. A list of structures in the order the DSP addresses are read from the pipe follows:<br />
<br />
1. Frame count<br />
2. Input configurations<br />
3. Input status<br />
4. Input ADPCM coefficients<br />
5. DSP configuration<br />
6. DSP status<br />
7. Output samples<br />
8. Intermediate mix samples<br />
9. Unknown Coefficients<br />
10. DSP debug statistics<br />
11. Unknown Coefficients<br />
12. Unknown Coefficients<br />
13. Unknown Coefficients<br />
14. Unknown Coefficients<br />
15. Unknown Coefficients<br />
<br />
The DSP has 24 inputs, each of which are individually configurable. These 24 inputs each produce three sets of 4 audio channels (two left, two right). <br />
<br />
These four audio channels feed into three intermediate mixers. Two of these intermediate mixers are used for effects and aux.<br />
<br />
== Channel Config ==<br />
<br />
A 192 byte long structure. There are 24 of them.<br />
<br />
{| class="wikitable"<br />
|-<br />
| Offset<br />
| Type<br />
| Description<br />
|-<br />
| 0<br />
| u32<br />
| Dirty flags<br />
|-<br />
| 4<br />
| 70 bytes<br />
| TODO<br />
|-<br />
| 74<br />
| u16<br />
| Bitmap of which buffers in queue are dirty<br />
|-<br />
| 76<br />
| Buffer[4]<br />
| Buffer queue<br />
|-<br />
| 156<br />
| u32<br />
| -<br />
|-<br />
| 160<br />
| u16<br />
| Is Active<br />
|-<br />
| 162<br />
| u16 <br />
| Sync Count<br />
|-<br />
| 164<br />
| 8<br />
| TODO<br />
|-<br />
| 172<br />
| u32<br />
| Physical address of current buffer<br />
|-<br />
| 176<br />
| u32<br />
| Number of samples in current buffer<br />
|-<br />
| 180<br />
| u16<br />
| bits[0:1]: 1 = mono, 2 = stereo; bits[2:3]: buffer format<br />
|-<br />
| 182<br />
| u16<br />
| ADPCM predictor<br />
|-<br />
| 184<br />
| s16<br />
| ADPCM yn1<br />
|-<br />
| 186<br />
| s16<br />
| ADPCM yn2<br />
|-<br />
| 188<br />
| u16<br />
| bit[0]: Has ADPCM data?; bit[1]: Is looping?<br />
|-<br />
| 190<br />
| u16<br />
| Buffer Id of this current buffer<br />
|}<br />
<br />
=== Buffer ===<br />
<br />
{| class="wikitable"<br />
|-<br />
| Offset<br />
| Type<br />
| Description<br />
|-<br />
| 0<br />
| u32<br />
| Physical Address<br />
|-<br />
| 4 <br />
| u32<br />
| Sample Count<br />
|-<br />
| 8<br />
| u16<br />
| ADPCM P/S<br />
|-<br />
| 10<br />
| s16[2]<br />
| ADPCM yn[1,2]<br />
|-<br />
| 14<br />
| u8<br />
| Has ADPCM?<br />
|-<br />
| 15<br />
| u8<br />
| Looping?<br />
|-<br />
| 16<br />
| u16<br />
| Buffer Id<br />
|-<br />
| 18<br />
| u16<br />
| -<br />
|}<br />
<br />
=== Simple Filter Configuration ===<br />
<br />
This is a standard single-pole filter. The fall-off is 6dB per octave as you would expect.<br />
<br />
{| class="wikitable"<br />
|-<br />
| Offset<br />
| Type<br />
| Description<br />
|-<br />
| 0<br />
| s16<br />
| b0<br />
|-<br />
| 0<br />
| s16<br />
| a1<br />
|}</div>
Merry
https://www.3dbrew.org/w/index.php?title=Services_API&diff=15789
Services API
2016-02-16T18:54:20Z
<p>Merry: </p>
<hr />
<div>Nintendo provides application developers with an API, which communicate with certain services. Services, in this sense, are [[Title_list#00040130_-_System_Modules|system processes running in the background]] which wait for incoming requests. When a process wants to communicate with a service, it first needs to get a handle to the named service, and then it can communicate with the service via interprocess communication. Each service has a name up to 8 characters, for example "nim:u".<br />
<br />
Handles for services are retrieved from the [[Services|service manager port]], "srv:". Services are an abstraction of ports, they operate the same way except regular ports can have their handles retrieved directly from a SVC.<br />
<br />
For a description of how commands and arguments are passed to services, see [[IPC Command Structure]].<br />
<br />
List of services (grouped by the process which provides them):<br />
{| class="wikitable" border="1"<br />
|-<br />
! Old3ds<br />
! Services<br />
! Service names<br />
! scope="col" width="200" | Notes<br />
|-<br />
| style="background: green" | Yes<br />
| [[Filesystem services]]<br />
| fs:USER, fs:LDR, fs:REG<br />
|<br />
|-<br />
| style="background: green" | Yes<br />
| [[Process Services]]<br />
| <br />
|<br />
|-<br />
| style="background: green" | Yes<br />
| [[PXI Services]]<br />
| PxiFS0, PxiFS1, PxiFSB, PxiFSR, PxiPM, pxi:am9, pxi:dev, pxi:mc, pxi:ps9<br />
|<br />
|-<br />
| style="background: green" | Yes<br />
| [[Application Manager Services]]<br />
| am:app, am:net, am:u, am:sys, am:pipe<br />
|<br />
|-<br />
| style="background: green" | Yes<br />
| [[Process Manager Services]]<br />
| pm:app, pm:dbg<br />
|<br />
|-<br />
| style="background: green" | Yes<br />
| [[NIM Services]]<br />
| nim:aoc, nim:ndm, nim:s, nim:u<br />
|<br />
|-<br />
| style="background: green" | Yes<br />
| [[Config Services]]<br />
| <br />
|<br />
|-<br />
| style="background: green" | Yes<br />
| [[NS|NS and APT Services]]<br />
| ns:s, ns:p, ns:c, APT:A, APT:S, APT:U<br />
|<br />
|-<br />
| style="background: green" | Yes<br />
| [[RO Services]]<br />
| ldr:ro<br />
|<br />
|-<br />
| style="background: green" | Yes<br />
| [[NDM Services]]<br />
| <br />
|<br />
|-<br />
| style="background: green" | Yes<br />
| [[CSND Services]]<br />
| csnd:SND<br />
|<br />
|-<br />
| style="background: green" | Yes<br />
| [[Camera Services]]<br />
| cam:u, y2r:u, cam:s, cam:c, cam:q (New3DS only)<br />
|<br />
|-<br />
| style="background: green" | Yes<br />
| [[Codec Services]]<br />
| cdc:HID, cdc:MIC, cdc:CSN, cdc:DSP, cdc:LGY, cdc:CHK<br />
|<br />
|-<br />
| style="background: green" | Yes<br />
| [[DLP Services]]<br />
| dlp:CLNT, dlp:FKCL, dlp:SRVR<br />
|<br />
|-<br />
| style="background: green" | Yes<br />
| [[DSP Services]]<br />
| dsp::DSP<br />
|<br />
|-<br />
| style="background: green" | Yes<br />
| [[GSP Services]]<br />
| gsp::Lcd, gsp::Gpu<br />
|<br />
|-<br />
| style="background: green" | Yes<br />
| [[BOSS Services]]<br />
| boss:U<br />
|<br />
|-<br />
| style="background: green" | Yes<br />
| [[CECD Services]]<br />
| cecd:u, cecd:s<br />
|<br />
|-<br />
| style="background: green" | Yes<br />
| [[IR Services]]<br />
| <br />
|<br />
|-<br />
| style="background: green" | Yes<br />
| [[I2C Services]]<br />
| i2c::MCU, i2c::CAM, i2c::LCD, i2c::DEB, i2c::HID, i2c::IR, i2c::EEP<br />
|<br />
|-<br />
| style="background: green" | Yes<br />
| [[GPIO Services]]<br />
| gpio:CDC, gpio:MCU, gpio:HID, gpio:NWM, gpio:IR<br />
|<br />
|-<br />
| style="background: green" | Yes<br />
| [[HID Services]]<br />
| hid:NFC, hid:QTM, hid:SPVR, hid:USER <br />
|<br />
|-<br />
| style="background: green" | Yes<br />
| [[PTM Services]]<br />
| ptm:gets, ptm:play, ptm:s, ptm:sets, ptm:sysm, ptm:u<br />
|<br />
|-<br />
| style="background: green" | Yes<br />
| [[NWM Services]]<br />
| nwm::UDS<br />
|<br />
|-<br />
| style="background: green" | Yes<br />
| [[HTTP Services]]<br />
| http:C<br />
|<br />
|-<br />
| style="background: green" | Yes<br />
| [[SSL Services]]<br />
| ssl:C<br />
|<br />
|-<br />
| style="background: green" | Yes<br />
| [[Socket Services]]<br />
| soc:P, soc:U<br />
|<br />
|-<br />
| style="background: green" | Yes<br />
| [[AC Services]]<br />
| ac:i, ac:u<br />
|<br />
|-<br />
| style="background: green" | Yes<br />
| [[Friend Services]]<br />
| frd:a, frd:u<br />
|<br />
|-<br />
| style="background: green" | Yes<br />
| [[News Services]]<br />
| <br />
|<br />
|-<br />
| style="background: green" | Yes<br />
| [[PDN Services]]<br />
| <br />
|<br />
|-<br />
| style="background: green" | Yes<br />
| [[SPI Services]]<br />
| <br />
|<br />
|-<br />
| style="background: green" | Yes<br />
| [[Loader Services]]<br />
| <br />
|<br />
|-<br />
| style="background: green" | Yes<br />
| [[MCU Services]]<br />
| mcu::CAM, mcu::GPU, mcu::HID, mcu::RTC, mcu::SND, mcu::NWM, mcu::HWC, mcu::PLS, mcu::CDC<br />
|<br />
|-<br />
| style="background: green" | Yes<br />
| [[MIC Services]]<br />
| mic:u<br />
|<br />
|-<br />
| style="background: green" | Yes<br />
| [[ACT Services]]<br />
| act:a, act:u<br />
|<br />
|-<br />
| style="background: red" | No<br />
| [[NFC Services]]<br />
| <br />
|<br />
|-<br />
| style="background: red" | No<br />
| [[MVD Services]]<br />
| <br />
|<br />
|-<br />
| style="background: red" | No<br />
| [[QTM Services]]<br />
| <br />
|<br />
|}<br />
<br />
List of PXI services:<br />
* [[Filesystem services PXI]]<br />
* [[Process Services PXI]]<br />
* [[Application Manager Services PXI]]<br />
* [[Process Manager Services PXI]]<br />
* [[Development Services PXI]]<br />
* [[Gamecard Services PXI]]<br />
* [[Legacy FIRM PXI]] (TWL_FIRM/AGB_FIRM)<br />
<br />
List of ports:<br />
* [[ErrDisp]]<br />
* [[Services]]<br />
<br />
<br />
See [[Error codes]].</div>
Merry
https://www.3dbrew.org/w/index.php?title=DSP_Memory_Region&diff=15788
DSP Memory Region
2016-02-16T14:47:02Z
<p>Merry: </p>
<hr />
<div>'''Some of this is known to be incorrect. I'll correct this in a few months after a bit more RE work. [[User:Merry|Merry]] ([[User talk:Merry|talk]]) 21:10, 28 January 2016 (CET)'''<br />
<br />
----<br />
<br />
<br />
The DSP communicates with userland through memory locations 0x1ff40000-0x1ff77fff. Within this region are two areas of structures that are exact duplicates of each other. The DSP alternates between the use of these two areas (much like a double-buffer). Each area has 15 structures within it. The location of these structures can be obtained by [[DSP:ReadPipe|reading channel 2 of the DSP pipe]].<br />
<br />
The mixer has 24 channels, each of which are individually configurable.<br />
<br />
{| class="wikitable"<br />
|-<br />
| Structure Number<br />
| DSP memory address<br />
| Size<br />
| Description<br />
|-<br />
| 5<br />
| 0x8400<br />
| 0x20<br />
| Status (?)<br />
|-<br />
| 9<br />
| 0x8410<br />
| 0x260<br />
| Debug (?)<br />
|-<br />
| 6<br />
| 0x8540<br />
| 0x280<br />
| Loopback Samples (PCM16)<br />
|-<br />
| 2<br />
| 0x8680<br />
| 0x120<br />
| Channel Status (x24)<br />
|-<br />
| 8 <br />
| 0x9710<br />
| 0x1A40<br />
| ?<br />
|-<br />
| 4<br />
| 0x9430<br />
| 0xC4<br />
| Main Configuration<br />
|-<br />
| 7<br />
| 0x9492<br />
| 0x1400<br />
| ?<br />
|-<br />
| 1<br />
| 0x9e92<br />
| 0x1200<br />
| Channel Config (x24)<br />
|-<br />
| 3<br />
| 0x9430<br />
| 0x300<br />
| GC-ADPCM Coefficients (x24)<br />
|-<br />
| 10<br />
| 0xa912<br />
| 0x200<br />
|<br />
|-<br />
| 11<br />
| 0xaa12<br />
| 0x180<br />
|<br />
|-<br />
| 12<br />
| 0xaad2<br />
| 0x300<br />
|<br />
|-<br />
| 13<br />
| 0xac52<br />
| 0x14<br />
|<br />
|-<br />
| 14<br />
| 0xac5c<br />
| 0x2476<br />
| -<br />
|-<br />
| 0<br />
| 0xbfff<br />
| 0x2<br />
| Frame Counter<br />
|}<br />
<br />
== Channel Config ==<br />
<br />
A 192 byte long structure. There are 24 of them.<br />
<br />
{| class="wikitable"<br />
|-<br />
| Offset<br />
| Type<br />
| Description<br />
|-<br />
| 0<br />
| u32<br />
| Dirty flags<br />
|-<br />
| 4<br />
| 70 bytes<br />
| TODO<br />
|-<br />
| 74<br />
| u16<br />
| Bitmap of which buffers in queue are dirty<br />
|-<br />
| 76<br />
| Buffer[4]<br />
| Buffer queue<br />
|-<br />
| 156<br />
| u32<br />
| -<br />
|-<br />
| 160<br />
| u16<br />
| Is Active<br />
|-<br />
| 162<br />
| u16 <br />
| Sync Count<br />
|-<br />
| 164<br />
| 8<br />
| TODO<br />
|-<br />
| 172<br />
| u32<br />
| Physical address of current buffer<br />
|-<br />
| 176<br />
| u32<br />
| Number of samples in current buffer<br />
|-<br />
| 180<br />
| u16<br />
| bits[0:1]: 1 = mono, 2 = stereo; bits[2:3]: buffer format<br />
|-<br />
| 182<br />
| u16<br />
| ADPCM predictor<br />
|-<br />
| 184<br />
| s16<br />
| ADPCM yn1<br />
|-<br />
| 186<br />
| s16<br />
| ADPCM yn2<br />
|-<br />
| 188<br />
| u16<br />
| bit[0]: Has ADPCM data?; bit[1]: Is looping?<br />
|-<br />
| 190<br />
| u16<br />
| Buffer Id of this current buffer<br />
|}<br />
<br />
=== Buffer ===<br />
<br />
{| class="wikitable"<br />
|-<br />
| Offset<br />
| Type<br />
| Description<br />
|-<br />
| 0<br />
| u32<br />
| Physical Address<br />
|-<br />
| 4 <br />
| u32<br />
| Sample Count<br />
|-<br />
| 8<br />
| u16<br />
| ADPCM P/S<br />
|-<br />
| 10<br />
| s16[2]<br />
| ADPCM yn[1,2]<br />
|-<br />
| 14<br />
| u8<br />
| Has ADPCM?<br />
|-<br />
| 15<br />
| u8<br />
| Looping?<br />
|-<br />
| 16<br />
| u16<br />
| Buffer Id<br />
|-<br />
| 18<br />
| u16<br />
| -<br />
|}<br />
<br />
=== Dirty Bits ===<br />
<br />
{| class="wikitable"<br />
|-<br />
| Bit<br />
| What Changed<br />
|-<br />
| 3<br />
| ADPCM Coefficients<br />
|-<br />
| 5<br />
| Embedded buffer<br />
|-<br />
| 13<br />
| Is Active<br />
|-<br />
| 18<br />
| Interpolation Type<br />
|-<br />
| 19<br />
| Rate<br />
|-<br />
| 20<br />
| Buffer Queue<br />
|-<br />
| 22<br />
| Embedded buffer<br />
|-<br />
| 23<br />
| IRR Filter Type<br />
|-<br />
| 25<br />
| Sync Count<br />
|-<br />
| 26-28<br />
| Mix<br />
|-<br />
| 30<br />
| First time init<br />
|-<br />
| 31<br />
| Embedded Buffer<br />
|}</div>
Merry
https://www.3dbrew.org/w/index.php?title=DSP_Memory_Region&diff=15678
DSP Memory Region
2016-01-28T19:10:17Z
<p>Merry: </p>
<hr />
<div>'''Some of this is known to be incorrect. I'll correct this in a few months after a bit more RE work. [[User:Merry|Merry]] ([[User talk:Merry|talk]]) 21:10, 28 January 2016 (CET)'''<br />
<br />
----<br />
<br />
<br />
The DSP communicates with userland through memory locations 0x1ff40000-0x1ff77fff. Within this region are two areas of structures that are exact duplicates of each other. The DSP alternates between the use of these two areas (much like a double-buffer). Each area has 15 structures within it. The location of these structures can be obtained by reading pipe 2.<br />
<br />
The mixer has 24 channels, each of which are individually configurable.<br />
<br />
{| class="wikitable"<br />
|-<br />
| Structure Number<br />
| DSP memory address<br />
| Size<br />
| Description<br />
|-<br />
| 5<br />
| 0x8400<br />
| 0x20<br />
| Status (?)<br />
|-<br />
| 9<br />
| 0x8410<br />
| 0x260<br />
| Debug (?)<br />
|-<br />
| 6<br />
| 0x8540<br />
| 0x280<br />
| Loopback Samples (PCM16)<br />
|-<br />
| 2<br />
| 0x8680<br />
| 0x120<br />
| Channel Status (x24)<br />
|-<br />
| 8 <br />
| 0x9710<br />
| 0x1A40<br />
| ?<br />
|-<br />
| 4<br />
| 0x9430<br />
| 0xC4<br />
| Main Configuration<br />
|-<br />
| 7<br />
| 0x9492<br />
| 0x1400<br />
| ?<br />
|-<br />
| 1<br />
| 0x9e92<br />
| 0x1200<br />
| Channel Config (x24)<br />
|-<br />
| 3<br />
| 0x9430<br />
| 0x300<br />
| GC-ADPCM Coefficients (x24)<br />
|-<br />
| 10<br />
| 0xa912<br />
| 0x200<br />
|<br />
|-<br />
| 11<br />
| 0xaa12<br />
| 0x180<br />
|<br />
|-<br />
| 12<br />
| 0xaad2<br />
| 0x300<br />
|<br />
|-<br />
| 13<br />
| 0xac52<br />
| 0x14<br />
|<br />
|-<br />
| 14<br />
| 0xac5c<br />
| 0x2476<br />
| -<br />
|-<br />
| 0<br />
| 0xbfff<br />
| 0x2<br />
| Frame Counter<br />
|}<br />
<br />
== Channel Config ==<br />
<br />
A 192 byte long structure. There are 24 of them.<br />
<br />
{| class="wikitable"<br />
|-<br />
| Offset<br />
| Type<br />
| Description<br />
|-<br />
| 0<br />
| u32<br />
| Dirty flags<br />
|-<br />
| 4<br />
| 70 bytes<br />
| TODO<br />
|-<br />
| 74<br />
| u16<br />
| Bitmap of which buffers in queue are dirty<br />
|-<br />
| 76<br />
| Buffer[4]<br />
| Buffer queue<br />
|-<br />
| 156<br />
| u32<br />
| -<br />
|-<br />
| 160<br />
| u16<br />
| Is Active<br />
|-<br />
| 162<br />
| u16 <br />
| Sync Count<br />
|-<br />
| 164<br />
| 8<br />
| TODO<br />
|-<br />
| 172<br />
| u32<br />
| Physical address of current buffer<br />
|-<br />
| 176<br />
| u32<br />
| Number of samples in current buffer<br />
|-<br />
| 180<br />
| u16<br />
| bits[0:1]: 1 = mono, 2 = stereo; bits[2:3]: buffer format<br />
|-<br />
| 182<br />
| u16<br />
| ADPCM predictor<br />
|-<br />
| 184<br />
| s16<br />
| ADPCM yn1<br />
|-<br />
| 186<br />
| s16<br />
| ADPCM yn2<br />
|-<br />
| 188<br />
| u16<br />
| bit[0]: Has ADPCM data?; bit[1]: Is looping?<br />
|-<br />
| 190<br />
| u16<br />
| Buffer Id of this current buffer<br />
|}<br />
<br />
=== Buffer ===<br />
<br />
{| class="wikitable"<br />
|-<br />
| Offset<br />
| Type<br />
| Description<br />
|-<br />
| 0<br />
| u32<br />
| Physical Address<br />
|-<br />
| 4 <br />
| u32<br />
| Sample Count<br />
|-<br />
| 8<br />
| u16<br />
| ADPCM P/S<br />
|-<br />
| 10<br />
| s16[2]<br />
| ADPCM yn[1,2]<br />
|-<br />
| 14<br />
| u8<br />
| Has ADPCM?<br />
|-<br />
| 15<br />
| u8<br />
| Looping?<br />
|-<br />
| 16<br />
| u16<br />
| Buffer Id<br />
|-<br />
| 18<br />
| u16<br />
| -<br />
|}<br />
<br />
=== Dirty Bits ===<br />
<br />
{| class="wikitable"<br />
|-<br />
| Bit<br />
| What Changed<br />
|-<br />
| 3<br />
| ADPCM Coefficients<br />
|-<br />
| 5<br />
| Embedded buffer<br />
|-<br />
| 13<br />
| Is Active<br />
|-<br />
| 18<br />
| Interpolation Type<br />
|-<br />
| 19<br />
| Rate<br />
|-<br />
| 20<br />
| Buffer Queue<br />
|-<br />
| 22<br />
| Embedded buffer<br />
|-<br />
| 23<br />
| IRR Filter Type<br />
|-<br />
| 25<br />
| Sync Count<br />
|-<br />
| 26-28<br />
| Mix<br />
|-<br />
| 30<br />
| First time init<br />
|-<br />
| 31<br />
| Embedded Buffer<br />
|}</div>
Merry
https://www.3dbrew.org/w/index.php?title=DSP_Memory_Region&diff=15596
DSP Memory Region
2016-01-23T20:54:18Z
<p>Merry: </p>
<hr />
<div>The DSP communicates with userland through memory locations 0x1ff40000-0x1ff77fff. Within this region are two areas of structures that are exact duplicates of each other. The DSP alternates between the use of these two areas (much like a double-buffer). Each area has 15 structures within it. The location of these structures can be obtained by reading pipe 2.<br />
<br />
The mixer has 24 channels, each of which are individually configurable.<br />
<br />
{| class="wikitable"<br />
|-<br />
| Structure Number<br />
| DSP memory address<br />
| Size<br />
| Description<br />
|-<br />
| 5<br />
| 0x8400<br />
| 0x20<br />
| Status (?)<br />
|-<br />
| 9<br />
| 0x8410<br />
| 0x260<br />
| Debug (?)<br />
|-<br />
| 6<br />
| 0x8540<br />
| 0x280<br />
| Loopback Samples (PCM16)<br />
|-<br />
| 2<br />
| 0x8680<br />
| 0x120<br />
| Channel Status (x24)<br />
|-<br />
| 8 <br />
| 0x9710<br />
| 0x1A40<br />
| ?<br />
|-<br />
| 4<br />
| 0x9430<br />
| 0xC4<br />
| Main Configuration<br />
|-<br />
| 7<br />
| 0x9492<br />
| 0x1400<br />
| ?<br />
|-<br />
| 1<br />
| 0x9e92<br />
| 0x1200<br />
| Channel Config (x24)<br />
|-<br />
| 3<br />
| 0x9430<br />
| 0x300<br />
| GC-ADPCM Coefficients (x24)<br />
|-<br />
| 10<br />
| 0xa912<br />
| 0x200<br />
|<br />
|-<br />
| 11<br />
| 0xaa12<br />
| 0x180<br />
|<br />
|-<br />
| 12<br />
| 0xaad2<br />
| 0x300<br />
|<br />
|-<br />
| 13<br />
| 0xac52<br />
| 0x14<br />
|<br />
|-<br />
| 14<br />
| 0xac5c<br />
| 0x2476<br />
| -<br />
|-<br />
| 0<br />
| 0xbfff<br />
| 0x2<br />
| Frame Counter<br />
|}<br />
<br />
== Channel Config ==<br />
<br />
A 192 byte long structure. There are 24 of them.<br />
<br />
{| class="wikitable"<br />
|-<br />
| Offset<br />
| Type<br />
| Description<br />
|-<br />
| 0<br />
| u32<br />
| Dirty flags<br />
|-<br />
| 4<br />
| 70 bytes<br />
| TODO<br />
|-<br />
| 74<br />
| u16<br />
| Bitmap of which buffers in queue are dirty<br />
|-<br />
| 76<br />
| Buffer[4]<br />
| Buffer queue<br />
|-<br />
| 156<br />
| u32<br />
| -<br />
|-<br />
| 160<br />
| u16<br />
| Is Active<br />
|-<br />
| 162<br />
| u16 <br />
| Sync Count<br />
|-<br />
| 164<br />
| 8<br />
| TODO<br />
|-<br />
| 172<br />
| u32<br />
| Physical address of current buffer<br />
|-<br />
| 176<br />
| u32<br />
| Number of samples in current buffer<br />
|-<br />
| 180<br />
| u16<br />
| bits[0:1]: 1 = mono, 2 = stereo; bits[2:3]: buffer format<br />
|-<br />
| 182<br />
| u16<br />
| ADPCM predictor<br />
|-<br />
| 184<br />
| s16<br />
| ADPCM yn1<br />
|-<br />
| 186<br />
| s16<br />
| ADPCM yn2<br />
|-<br />
| 188<br />
| u16<br />
| bit[0]: Has ADPCM data?; bit[1]: Is looping?<br />
|-<br />
| 190<br />
| u16<br />
| Buffer Id of this current buffer<br />
|}<br />
<br />
=== Buffer ===<br />
<br />
{| class="wikitable"<br />
|-<br />
| Offset<br />
| Type<br />
| Description<br />
|-<br />
| 0<br />
| u32<br />
| Physical Address<br />
|-<br />
| 4 <br />
| u32<br />
| Sample Count<br />
|-<br />
| 8<br />
| u16<br />
| ADPCM P/S<br />
|-<br />
| 10<br />
| s16[2]<br />
| ADPCM yn[1,2]<br />
|-<br />
| 14<br />
| u8<br />
| Has ADPCM?<br />
|-<br />
| 15<br />
| u8<br />
| Looping?<br />
|-<br />
| 16<br />
| u16<br />
| Buffer Id<br />
|-<br />
| 18<br />
| u16<br />
| -<br />
|}<br />
<br />
=== Dirty Bits ===<br />
<br />
{| class="wikitable"<br />
|-<br />
| Bit<br />
| What Changed<br />
|-<br />
| 3<br />
| ADPCM Coefficients<br />
|-<br />
| 5<br />
| Embedded buffer<br />
|-<br />
| 13<br />
| Is Active<br />
|-<br />
| 18<br />
| Interpolation Type<br />
|-<br />
| 19<br />
| Rate<br />
|-<br />
| 20<br />
| Buffer Queue<br />
|-<br />
| 22<br />
| Embedded buffer<br />
|-<br />
| 23<br />
| IRR Filter Type<br />
|-<br />
| 25<br />
| Sync Count<br />
|-<br />
| 26-28<br />
| Mix<br />
|-<br />
| 30<br />
| First time init<br />
|-<br />
| 31<br />
| Embedded Buffer<br />
|}</div>
Merry
https://www.3dbrew.org/w/index.php?title=DSP_Memory_Region&diff=15593
DSP Memory Region
2016-01-23T15:58:28Z
<p>Merry: Added Channel Context</p>
<hr />
<div>The DSP communicates with userland through memory locations 0x1ff40000-0x1ff77fff. Within this region are two areas of structures that are exact duplicates of each other. The DSP alternates between the use of these two areas (much like a double-buffer). Each area has 15 structures within it. The location of these structures can be obtained by reading pipe 2.<br />
<br />
The mixer has 24 channels, each of which are individually configurable.<br />
<br />
{| class="wikitable"<br />
|-<br />
| Structure Number<br />
| DSP memory address<br />
| Size<br />
| Description<br />
|-<br />
| 5<br />
| 0x8400<br />
| 0x20<br />
| Status (?)<br />
|-<br />
| 9<br />
| 0x8410<br />
| 0x260<br />
| Debug (?)<br />
|-<br />
| 6<br />
| 0x8540<br />
| 0x280<br />
| Loopback Samples (PCM16)<br />
|-<br />
| 2<br />
| 0x8680<br />
| 0x120<br />
| Channel Status (x24)<br />
|-<br />
| 8 <br />
| 0x9710<br />
| 0x1A40<br />
| ?<br />
|-<br />
| 4<br />
| 0x9430<br />
| 0xC4<br />
| Main Configuration<br />
|-<br />
| 7<br />
| 0x9492<br />
| 0x1400<br />
| ?<br />
|-<br />
| 1<br />
| 0x9e92<br />
| 0x1200<br />
| Channel Config (x24)<br />
|-<br />
| 3<br />
| 0x9430<br />
| 0x300<br />
| GC-ADPCM Coefficients (x24)<br />
|-<br />
| 10<br />
| 0xa912<br />
| 0x200<br />
|<br />
|-<br />
| 11<br />
| 0xaa12<br />
| 0x180<br />
|<br />
|-<br />
| 12<br />
| 0xaad2<br />
| 0x300<br />
|<br />
|-<br />
| 13<br />
| 0xac52<br />
| 0x14<br />
|<br />
|-<br />
| 14<br />
| 0xac5c<br />
| 0x2476<br />
| -<br />
|-<br />
| 0<br />
| 0xbfff<br />
| 0x2<br />
| Frame Counter<br />
|}<br />
<br />
== Channel Config ==<br />
<br />
A 192 byte long structure. There are 24 of them.<br />
<br />
{| class="wikitable"<br />
|-<br />
| Offset<br />
| Type<br />
| Description<br />
|-<br />
| 0<br />
| u32<br />
| Dirty flags<br />
|-<br />
| 4<br />
| 70 bytes<br />
| TODO<br />
|-<br />
| 74<br />
| u16<br />
| Bitmap of which buffers in queue are valid<br />
|-<br />
| 76<br />
| Buffer[4]<br />
| Buffer queue<br />
|-<br />
| 156<br />
| u32<br />
| -<br />
|-<br />
| 160<br />
| u16<br />
| Is Active<br />
|-<br />
| 162<br />
| u16 <br />
| Config Serial Number (Userland)<br />
|-<br />
| 164<br />
| 8<br />
| TODO<br />
|-<br />
| 172<br />
| u32<br />
| Physical address of current buffer<br />
|-<br />
| 176<br />
| u32<br />
| Number of samples in current buffer<br />
|-<br />
| 180<br />
| u16<br />
| bits[0:1]: 1 = mono, 2 = stereo; bits[2:3]: buffer format<br />
|-<br />
| 182<br />
| u16<br />
| ADPCM predictor<br />
|-<br />
| 184<br />
| s16<br />
| ADPCM yn1<br />
|-<br />
| 186<br />
| s16<br />
| ADPCM yn2<br />
|-<br />
| 188<br />
| u16<br />
| bit[0]: Has ADPCM data?; bit[1]: Is looping?<br />
|-<br />
| 190<br />
| u16<br />
| Buffer Id of this current buffer<br />
|}<br />
<br />
=== Buffer ===<br />
<br />
{| class="wikitable"<br />
|-<br />
| Offset<br />
| Type<br />
| Description<br />
|-<br />
| 0<br />
| u32<br />
| Physical Address<br />
|-<br />
| 4 <br />
| u32<br />
| Sample Count<br />
|-<br />
| 8<br />
| u16<br />
| ADPCM P/S<br />
|-<br />
| 10<br />
| s16[2]<br />
| ADPCM yn[1,2]<br />
|-<br />
| 14<br />
| u8<br />
| Has ADPCM?<br />
|-<br />
| 15<br />
| u8<br />
| Looping?<br />
|-<br />
| 16<br />
| u16<br />
| Buffer Id<br />
|-<br />
| 18<br />
| u16<br />
| -<br />
|}</div>
Merry
https://www.3dbrew.org/w/index.php?title=DSP_Memory_Region&diff=15582
DSP Memory Region
2016-01-22T20:13:07Z
<p>Merry: </p>
<hr />
<div>The DSP communicates with userland through memory locations 0x1ff40000-0x1ff77fff. Within this region are two areas of structures that are exact duplicates of each other. The DSP alternates between the use of these two areas (much like a double-buffer). Each area has 15 structures within it. The location of these structures can be obtained by reading pipe 2.<br />
<br />
The mixer has 24 channels, each of which are individually configurable.<br />
<br />
{| class="wikitable"<br />
|-<br />
| Structure Number<br />
| DSP memory address<br />
| Size<br />
| Description<br />
|-<br />
| 5<br />
| 0x8400<br />
| 0x20<br />
| Status (?)<br />
|-<br />
| 9<br />
| 0x8410<br />
| 0x260<br />
| Debug (?)<br />
|-<br />
| 6<br />
| 0x8540<br />
| 0x280<br />
| Loopback Samples (PCM16)<br />
|-<br />
| 2<br />
| 0x8680<br />
| 0x120<br />
| Channel Status (x24)<br />
|-<br />
| 8 <br />
| 0x9710<br />
| 0x1A40<br />
| ?<br />
|-<br />
| 4<br />
| 0x9430<br />
| 0xC4<br />
| Main Configuration<br />
|-<br />
| 7<br />
| 0x9492<br />
| 0x1400<br />
| ?<br />
|-<br />
| 1<br />
| 0x9e92<br />
| 0x1200<br />
| Channel Config (x24)<br />
|-<br />
| 3<br />
| 0x9430<br />
| 0x300<br />
| GC-ADPCM Coefficients (x24)<br />
|-<br />
| 10<br />
| 0xa912<br />
| 0x200<br />
|<br />
|-<br />
| 11<br />
| 0xaa12<br />
| 0x180<br />
|<br />
|-<br />
| 12<br />
| 0xaad2<br />
| 0x300<br />
|<br />
|-<br />
| 13<br />
| 0xac52<br />
| 0x14<br />
|<br />
|-<br />
| 14<br />
| 0xac5c<br />
| 0x2476<br />
| -<br />
|-<br />
| 0<br />
| 0xbfff<br />
| 0x2<br />
| Frame Counter<br />
|}</div>
Merry
https://www.3dbrew.org/w/index.php?title=DSP_Memory_Region&diff=15581
DSP Memory Region
2016-01-22T20:12:09Z
<p>Merry: Basic Area Table</p>
<hr />
<div>The DSP communicates with userland through memory locations 0x1ff40000-0x1ff77fff. Within this region are two areas of structures that are exact duplicates of each other. The DSP alternates between the use of these two areas (much like a double-buffer). Each area has 15 structures within it. The location of these structures can be obtained by reading pipe 2.<br />
<br />
The mixer has 24 channels, each of which are individually configurable.<br />
<br />
{| class="wikitable"<br />
|-<br />
| Structure Number<br />
| DSP memory address<br />
| Size<br />
| Description<br />
|-<br />
| 5<br />
| 0x8400<br />
| 0x20<br />
| Status (?)<br />
|-<br />
| 9<br />
| 0x8410<br />
| 0x260<br />
| Debug (?)<br />
|-<br />
| 6<br />
| 0x8540<br />
| 0x280<br />
| Loopback Samples (PCM16)<br />
|-<br />
| 2<br />
| 0x8680<br />
| 0x120<br />
| Channel Status (x24)<br />
|-<br />
| 8 <br />
| 0x9710<br />
| 0x1A40<br />
| ?<br />
|-<br />
| 4<br />
| 0x9430<br />
| 0xC4<br />
| Main Configuration<br />
|-<br />
| 7<br />
| 0x9492<br />
| 0x1400<br />
| ?<br />
|-<br />
| 1<br />
| 0x9e92<br />
| 0x1200<br />
| Channel Config (x24)<br />
|-<br />
| 3<br />
| 0x9430<br />
| 0x300<br />
| GC-ADPCM Coefficients (x24)|-<br />
|-<br />
| 10<br />
| 0xa912<br />
| 0x200<br />
|<br />
|-<br />
| 11<br />
| 0xaa12<br />
| 0x180<br />
|<br />
|-<br />
| 12<br />
| 0xaad2<br />
| 0x300<br />
|<br />
|-<br />
| 13<br />
| 0xac52<br />
| 0x14<br />
|<br />
|-<br />
| 14<br />
| 0xac5c<br />
| 0x2476<br />
| -<br />
|-<br />
| 0<br />
| 0xbfff<br />
| 0x2<br />
| Frame Counter<br />
|}</div>
Merry