Go back to Rebecca Heineman Engine
- 1 Communication with the SNES
- 2 Instrument Format
- 3 Voice Command Format
This is the earlier version that was used in one game, where the playback of music is done entirely on the SPC side.
The game in question is this:
|Game Name||VCMD Code Location||ROM Offset|
|Radical Psycho Machine Racing/RPM Racing||0x0618||0x098000 (all versions)|
The build sorting notes can be found here.
Communication with the SNES
All CPUIO registers have (mostly) the same set of commands. Each CPUIO register echoes the last value sent back to the SNES when it processes the command. The same command can be sent again by toggling the highest bit.
|Master Volume Fade Out|
|$29-$7F/$A9-$FF||Master Volume Fade In|
|Reset DSP Registers and Load New Data|
Play SFX (Command $01-$1F/$80-$9F)
- %xxxxx is the SFX ID.
Each SFX merely consists of taking up one instrument slot.
Play Sequence (Command $20-$27/$A0-$A7)
- %xxx is the sequence ID.
There is a limit of two sequences playing at once.
Master Volume Fade Out (Command $28/$A8)
Fades out the MVOL DSP registers to zero at a rate of 25/256 per timer 0 tick.
Master Volume Fade In (Command $29-$7F/$A9-$FF)
Fades in the master volume to $7F at a rate of 25/256 per timer 0 tick. The command doesn't actually function due to a bug in the implementation. Specifically, a byte in the master volume value (which is two bytes total) is made non-zero by the command code in order for the rest of the command to work, but the wrong byte is selected, causing a change so small that it doesn't even modify a MVOL DSP register value, then doing nothing afterwards.
Reset DSP Registers and Load New Data (Command $7F/$FF)
This command only works on the CPUIO0 register ($2140/$F4). Resets the DSP registers, then jumps to an IPL Boot ROM variant that is functionally identical to N-SPC/Kankichi's except for some smaller opcodes.
TODO document the transfer process (or refer to N-SPC's)
Instruments are stored as eight byte entires as following:
xx yy zz zz aa bb cc dd
- xx is a direct write to the VxVOLL DSP register.
- yy is a direct write to the VxVOLR DSP register.
- zz zz is a direct write to the VxPITCH DSP registers, stored in little endian.
- For music, these values are only referenced for pitch when dd is $80 (otherwise it uses a pitch table).
- For SFX, these values are always referred to.
- aa is a direct write to the VxSRCN DSP register.
- bb is a direct write to the VxADSR1 DSP register.
- cc is a direct write to the VxADSR2 DSP register.
- dd's purpose depends on whether it's being used for music or sound effects...
- For music, it defines an offset to a tuning table. The tuning table entry itself consists of a single 16-bit value to multiply the pitch by.
- For SFX, the byte is unused, and was either supposed to be gain or priority.
Voice Command Format
All sequences dynamically allocate their channels. SFX permanently deallocates one channel once they play on that channel.
|$FF||End of Sequence|
Note (VCMD $00-$FD)
%x??yzzzz aa (bb)
- %x, if set, causes bb to define a delay afterwards.
- %y, if set, keys off the note. Otherwise, the note is keyed on.
- %zzzz is an instrument ID.
- aa is the note. The default VxPITCH values are used if this is zero, or if the instrument has a tuning table offset of $80.
- bb, only present if %x is set, defines a delay in timer 0 ticks.
Jump (VCMD $FE)
$FE xx xx
- xx xx is a little endian pointer indicating where to jump to.
End of Sequence (VCMD $FF)
Terminates the sequence.