68
edits
Changes
Jump to navigation
Jump to search
Line 34:
Line 34: − + Line 47:
Line 47: − + Line 54:
Line 54: − User processes use this command prior to cmd3 for initializing looping.+ − + Line 78:
Line 78: − + Line 100:
Line 100: − + Line 113:
Line 113: − + − + − + − + Line 145:
Line 145: − + Line 154:
Line 154: − + Line 167:
Line 167: − + Line 176:
Line 176: − + Line 189:
Line 189: − + Line 198:
Line 198: − + − + Line 209:
Line 209: − + − + + + + + + + + + + Line 229:
Line 238: − + Line 241:
Line 250: − + − + + + + + − + − + + + + + − + − + Line 264:
Line 281: − + − + Line 275:
Line 292: − Like command 0xE, this writes the specified parameters to the [[CSND]] channel slot registers for the main audio-data physical address, and the register for the data byte-size.+ − + Line 301:
Line 318: − + − + Line 312:
Line 329: − + Line 327:
Line 344: − + − + + + + + + + + + + + + + + + + + + + Line 342:
Line 377: − + − + − + − + − + − + − + − + Line 376:
Line 411: − + − + + + + − + − + − + − + + + + Line 392:
Line 433: − + + + + + Line 399:
Line 444: − + − + − + Line 412:
Line 457: − + − + − + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Line 436:
Line 561: + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
no edit summary
=Type0 Commands=
=Type0 Commands=
=Command 0x0=
==Command 0x0==
{| class="wikitable" border="1"
{| class="wikitable" border="1"
|-
|-
| 0xC
| 0xC
| 4
| 4
| Flag, normally value 1.
| Value
|-
|-
| 0x10
| 0x10
|}
|}
Value=1 begins audio playback. Value=0 stops audio playback, and also seems to reset the audio channel [[CSND]] registers so that those registers need re-initialized before audio can be played from this channel again.
=Command 0x1=
==Command 0x1==
{| class="wikitable" border="1"
{| class="wikitable" border="1"
|-
|-
This command starts playing the audio channel with value=1. Once the audio channel is playing, value=0 pauses the audio channel playback, and value=1 resumes the audio channel playback. Value=1 has no affect when the audio channel is already playing, likewise for value=0 when the audio channel is not playing.
This command starts playing the audio channel with value=1. Once the audio channel is playing, value=0 pauses the audio channel playback, and value=1 resumes the audio channel playback. Value=1 has no affect when the audio channel is already playing, likewise for value=0 when the audio channel is not playing.
=Command 0x2=
==Command 0x2==
{| class="wikitable" border="1"
{| class="wikitable" border="1"
|-
|-
This sets the encoding field in the [[CSND]] channel CNT register(that field is cleared to zero first), command 0xE also sets this field.
This sets the encoding field in the [[CSND]] channel CNT register(that field is cleared to zero first), command 0xE also sets this field.
=Command 0x3=
==Command 0x3==
{| class="wikitable" border="1"
{| class="wikitable" border="1"
|-
|-
| 0xC
| 0xC
| 4
| 4
| Physical address of the first audio sample in the loop.
| Physical address of the second block of audio data
|-
|-
| 0x10
| 0x10
| 4
| 4
| Total byte-size of the loop sample-data.
| Total byte-size of the block
|}
|}
This initializes state for looping, when looping is used. This command is used immediately after command 0x8. CSND module writes these fields to the channel [[CSND|register]] for the second physical-address, and the channel register for the byte-size.
This sets the address and size of the second block of an audio channel. The CSND module writes these fields to the channel [[CSND|register]] for the physical address of the second block and the register for the block size.
=Command 0x4=
==Command 0x4==
{| class="wikitable" border="1"
{| class="wikitable" border="1"
|-
|-
=Command 0x5=
==Command 0x5==
{| class="wikitable" border="1"
{| class="wikitable" border="1"
|-
|-
| 0x2
| 0x2
| 2
| 2
| CmdID 0x4
| CmdID 0x5
|-
|-
| 0xC
| 0xC
When value=0, CSND module will clear bit7 in the channel CNT register. Otherwise, CSND module sets bit7 in the channel CNT register.
When value=0, CSND module will clear bit7 in the channel CNT register. Otherwise, CSND module sets bit7 in the channel CNT register.
=Command 0x6=
==Command 0x6==
{| class="wikitable" border="1"
{| class="wikitable" border="1"
|-
|-
| 0x2
| 0x2
| 2
| 2
| CmdID 0x4
| CmdID 0x6
|-
|-
| 0xC
| 0xC
This is the same as cmd5, except this updates channel CNT bit6 instead. CSND module will only update CNT here if bit15=0 in CNT.
This is the same as cmd5, except this updates channel CNT bit6 instead. CSND module will only update CNT here if bit15=0 in CNT.
=Command 0x7=
==Command 0x7==
{| class="wikitable" border="1"
{| class="wikitable" border="1"
|-
|-
| 0x2
| 0x2
| 2
| 2
| CmdID 0x4
| CmdID 0x7
|-
|-
| 0xC
| 0xC
| 1
| 1
| Value
| Duty value (3 bits), see below
|-
|-
| 0x10
| 0x10
|}
|}
This is similar to cmd2, except this updates channel CNT bit1-bit0.
This command updates bit0 through (at least) bit2 of the channel's CNT register. These bits control the duty of a PSG square wave:
=Command 0x8=
0 12.5% "_______-_______-_______-"
1 25.0% "______--______--______--"
2 37.5% "_____---_____---_____---"
3 50.0% "____----____----____----"
4 62.5% "___-----___-----___-----"
5 75.0% "__------__------__------"
6 87.5% "_-------_-------_-------"
7 0.0% "________________________"
==Command 0x8==
{| class="wikitable" border="1"
{| class="wikitable" border="1"
|-
|-
This sets the sample rate. This value is written to the channel CNT high-u16, which command 0xE also writes to. This command is used immediately after command 0xE.
This sets the sample rate. This value is written to the channel CNT high-u16, which command 0xE also writes to. This command is used immediately after command 0xE.
=Command 0x9=
==Command 0x9==
{| class="wikitable" border="1"
{| class="wikitable" border="1"
|-
|-
|-
|-
| 0xC
| 0xC
| 4
| 2
| Unknown
| Left channel volume
|-
| 0xE
| 2
| Right channel volume
|-
|-
| 0x10
| 0x10
| 0x10
| 2
| Usually zero?
| Left capture volume
|-
| 0x12
| 2
| Right capture volume
|}
|}
This command must be used after command 0x8(user processes use cmd8 a second time before using this command). The parameter values seem to have no affect when not using IMA-ADPCM encoding?
This sets the playback and capture volumes for the specified channel. This command is usually used after command 0x8(user processes use cmd8 a second time before using this command).
=Command 0xA=
==Command 0xA==
{| class="wikitable" border="1"
{| class="wikitable" border="1"
|-
|-
| 0xC
| 0xC
| 4
| 4
| Main physical address
| Physical address of the first block of audio data
|-
|-
| 0x10
| 0x10
| 0x4
| 0x4
| Audio data byte-size
| Total byte-size of the block
|-
|-
| 0x14
| 0x14
|}
|}
This sets the address and size of the first block of an audio channel. The CSND module writes these fields to the channel [[CSND|register]] for the physical address of the first block and the register for the block size.
=Command 0xB=
==Command 0xB==
{| class="wikitable" border="1"
{| class="wikitable" border="1"
|-
|-
|}
|}
This command is used for initializing IMA-ADPCM state(when IMA-ADPCM encoding is used), prior to using command 0xE. [[CSND]] <nowiki>channelslotregister+0x18 = (u16)cmdword[3] | ((cmdword[4] & 0xFF)<<16)</nowiki>. [[CSND]] channelslotregister+0x1C = 0.
This command is used for setting the IMA-ADPCM state used to play the first block (when IMA-ADPCM encoding is used), prior to using command 0xE. [[CSND]] <nowiki>channelslotregister+0x18 = (u16)cmdword[3] | ((cmdword[4] & 0xFF)<<16)</nowiki>. [[CSND]] channelslotregister+0x1C = 0.
=Command 0xC=
==Command 0xC==
{| class="wikitable" border="1"
{| class="wikitable" border="1"
|-
|-
| 0x2
| 0x2
| 2
| 2
| CmdID 0xB
| CmdID 0xC
|-
|-
| 0xC
| 0xC
|}
|}
This is used for initializing looping state for IMA-ADPCM encoding. <nowiki>channelslotregister+0x18 = (1<<31) | (u16)cmdword[3] | ((cmdword[4] & 0xFF)<<16)</nowiki>.
This is used for setting the IMA-ADPCM state used to play the second block (when IMA-ADPCM encoding is used). <nowiki>channelslotregister+0x1C = (1<<31) | (u16)cmdword[3] | ((cmdword[4] & 0xFF)<<16)</nowiki>.
=Command 0xE=
==Command 0xD==
{| class="wikitable" border="1"
|-
! Index Byte
! Size
! Description
|-
| 0x2
| 2
| CmdID 0xD
|-
| 0xC
| 1
| 0 = disable ADPCM state reload for the second block, 1 = enable.
|}
This command configures bit31 of <nowiki>channelslotregister+0x1C</nowiki>. This bit indicates whether the hardware will load ADPCM state from said register everytime the second block is to be played; or if it will continue using the same state used for the previously emitted sample.
==Command 0xE==
{| class="wikitable" border="1"
{| class="wikitable" border="1"
|-
|-
| 0x8
| 0x8
| 4
| 4
| See below.
| See below. (Flags + Timer)
|-
|-
| 0xC
| 0xC
| 4
| 4
| See below. Usually zero?
| See below. (Channel volume)
|-
|-
| 0x10
| 0x10
| 4
| 4
| See below. Usually zero?
| See below. (Capture volume)
|-
|-
| 0x14
| 0x14
| 4
| 4
| Physical address for the audio data, for the main channel.
| Physical address for the first block of audio data.
|-
|-
| 0x18
| 0x18
| 4
| 4
| Physical address for the audio data, for the second channel(only needs set if a flag is set which enables using this address).
| Physical address for the second block of audio data.
|-
|-
| 0x1C
| 0x1C
| 4
| 4
| Total byte-size for the audio data.
| Total byte-size of one block.
|}
|}
This initializes the [[CSND]] channel registers located at: 0x1EC03400 + (channel_index*0x20). Whether mono/stereo audio is used is determined via an unknown flag. When looping is used, audio playback initially begins with playing from the first physical address(using the byte-size from the channel register when audio playback was triggered). Once looping begins after the initial audio playback finishes, the second physical address is used for the beginning of the audio data instead(using the same byte-size used with the initial audio playback).
This initializes the [[CSND]] channel registers located at: 0x1EC03400 + (channel_index*0x20). It is unknown if stereo samples are supported. In manual mode, the hardware plays the audio data of the first block endlessly ignoring the size field. In one-shot mode, the hardware plays the first block with the specified size and then stops. When looping is enabled, the hardware plays the first block once and then repeats the second forever. Before playing a block, the hardware reads the corresponding address register in order to know where it is located. The block size is either read only once at the beginning (mode 3) or before each block (mode 1, normal looping).
==Parameter word 0x8==
===Parameter word 0x8===
{| class="wikitable" border="1"
{| class="wikitable" border="1"
|-
|-
| Channel index
| Channel index
|-
|-
| 9-6
| 6
| ?
| 0 = disable linear interpolation, 1 = enable linear interpolation.
|-
| 9-7
| Ignored
|-
|-
| 11-10
| 11-10
| 1 = enable looping, 2 = disable looping.
| Repeat mode: 0 = manual, 1 = normal looping, 2 = one-shot, 3 = looping with constant block size.
|-
|-
| 13-12
| 13-12
| This sets the encoding, the names for the following encodings are from [https://github.com/3dshax/ctr/blob/master/ctrtool/cwav.h here]. 0 = PCM8 and DSPADPCM, 1 = PCM16, 2 = IMAADPCM.
| This sets the encoding, some of the names for the following encodings are from [https://github.com/3dshax/ctr/blob/master/ctrtool/cwav.h here]. 0 = PCM8, 1 = PCM16, 2 = IMA-ADPCM. 3 = PSG, similar to DS.
|-
|-
| 15-14
| 14
| ?
| 0 = disable playback, 1 = enable playback
|-
| 15
| Ignored
|-
|-
| 31-16
| 31-16
|}
|}
==Parameter word 0xC==
Bits 0 through 5 are written as zero to the CNT register.
PSG: Channels 8 through 13 play a square tone that is 32 samples long. Channels 14 and 15 play noise. The duty of the square tones is set using command 0x7.
===Parameter word 0xC===
{| class="wikitable" border="1"
{| class="wikitable" border="1"
|-
|-
|-
|-
| 15-0
| 15-0
| Unknown, this value is clamped to the following range(by the user process): 0x0-0x8000.
| Left channel volume, this value is clamped to the following range(by the user process): 0x0-0x8000.
|-
|-
| 31-16
| 31-16
| Unknown, this value is clamped to the following range(by the user process): 0x0-0x8000.
| Right channel volume, this value is clamped to the following range(by the user process): 0x0-0x8000.
|}
|}
==Parameter word 0x10==
===Parameter word 0x10===
{| class="wikitable" border="1"
{| class="wikitable" border="1"
|-
|-
|-
|-
| 15-0
| 15-0
| Unknown, this value is clamped to the following range(by the user process): 0x0-0x8000.
| Left capture volume, this value is clamped to the following range(by the user process): 0x0-0x8000.
|-
|-
| 31-16
| 31-16
| Unknown, this value is clamped to the following range(by the user process): 0x0-0x8000.
| Right capture volume, this value is clamped to the following range(by the user process): 0x0-0x8000.
|}
|}
=Command 0x300=
==Command 0xF==
{| class="wikitable" border="1"
|-
! Index Byte
! Size
! Description
|-
| 0x2
| 2
| CmdID 0xF
|-
| 0x8
| 4
| Flags, as in command 0xE. Only the timer and the start/stop (bit14) bits are used.
|-
| 0xC
| 4
| Channel volume, same as in command 0xE.
|-
| 0x10
| 4
| Capture volume, same as in command 0xE.
|-
| 0x14
| 4
| Duty (see command 0x7).
|}
This channel is similar to command 0xE, but it is tailored for configuring PSG Tone channels (8, 9, 10, 11, 12, 13) as it contains a duty parameter. Channel format is set to PSG.
==Command 0x10==
{| class="wikitable" border="1"
|-
! Index Byte
! Size
! Description
|-
| 0x2
| 2
| CmdID 0xF
|-
| 0x8
| 4
| Flags, as in command 0xE. Only the timer and the start/stop (bit14) bits are used. Channel format is set to PSG.
|-
| 0xC
| 4
| Channel volume, same as in command 0xE.
|-
| 0x10
| 4
| Capture volume, same as in command 0xE.
|}
This channel is identical to command 0xF except for not having a duty parameter. Presumably used to configure PSG Noise channels (14, 15).
==Command 0x100==
Writes bit15 of (u16*)(0x1EC03800+16*X).
==Command 0x101==
Writes bit0 of (u16*)(0x1EC03800+16*X).
==Command 0x102==
Writes bit1 of (u16*)(0x1EC03800+16*X).
==Command 0x103==
Writes bit2 of (u16*)(0x1EC03800+16*X).
==Command 0x104==
Sets (u16*)(0x1EC03800+16*X+4) = -Y.
==Command 0x105==
Sets (u32*)(0x1EC03800+16*X+8) = Y, and (u32*)(0x1EC03800+16*X+12) = Z.
==Command 0x106==
Does the same thing as all 0x100-0x106 combined.
==Command 0x200==
Sends some interrupt to the DSP?
==Command 0x300==
{| class="wikitable" border="1"
{| class="wikitable" border="1"
|-
|-
CSND module writes state info(including state from [[CSND]] registers) for each audio channel to shared-memory for this command.
CSND module writes state info(including state from [[CSND]] registers) for each audio channel to shared-memory for this command.
=Offset1=
This section describes the structure of the data located at offset1(from [[CSND:Initialize]]) in shared-memory. This data is updated by command 0x300, and by commands which update the channel physical address registers. The following describes the format of the entries located here.
==Entry Format==
{| class="wikitable" border="1"
|-
! Index Byte
! Size
! Description
|-
| 0x0
| 1
| 0 = audio channel is not playing, 1 = audio channel is playing. CSND module sets this field to zero when bit14-bit15 in the channel CNT register are all-zero, otherwise CSND module sets this to value 1.
|-
| 0x1
| 3
| Padding
|-
| 0x4
| 2
| This is from the low 16-bits from chanregisterslot+0x18(see type0 cmd 0xB).
|-
| 0x6
| 1
| Value = (*(chanregisterslot+0x18) & 0x7F0000) >> 16(see type0 cmd 0xB).
|-
| 0x7
| 1
| Padding
|-
| 0x8
| 4
| This is the physical address from the main physical address channel-slot register. When the audio channel is playing, this is the address of the sample-data that was being played at the time this address was written here by CSND module.
|}