FF7/PSX/Sound/Code Map
From Final Fantasy Inside
Contents
Code Map
Introduces functions, variables and data related to sound, contained in SCUS_941.63 (game program of US version). Note that all symbol names below are for convenience only.
| PSX Address | Declaration | Description |
|---|---|---|
| 0x800293D0 | void _AkaoSpuTransferCallback(void) | |
| 0x800293F4 | void _AkaoSpuSetTransferCallback(void) | |
| 0x80029424 | unsigned int _AkaoTransferSamples(uint8_t *addr, unsigned int size) | |
| 0x800294A4 | void _AkaoWaitForSpuTransfer(void) | |
| 0x800294BC | void _AkaoReset(void) | |
| 0x800297A4 | void AkaoLoadInstrumentSet(const void *sampleSet, const void *instrumentSet) | Load standard instrument set (called transparently from 0x8002988C)
sampleSet: corresponding to SOUND/INSTR.ALL instrumentSet: corresponding to SOUND/INSTR.DAT |
| 0x80029818 | void AkaoLoadInstrumentSet2(const void *sampleSet, const void *instrumentSet) | Load additional instrument set
sampleSet: corresponding to SOUND/INSTR2.ALL instrumentSet: corresponding to SOUND/INSTR2.DAT |
| 0x8002988C | void AkaoInitialize(const void *sampleSet, const void *instrSet) | Initialize sound driver and load initial instruments
sampleSet: corresponding to SOUND/INSTR.ALL instrSet: corresponding to SOUND/INSTR.DAT |
| 0x8002DA7C | int AkaoLoadSeq(void) | Load and start playing new AKAO sequence
Parameters are given from a global structure Returns: 0 for success, 1 for already loaded, and -1 for invalid signature |
| 0x80030234 | int _AkaoCallback(void) | Callback event for sound, registered by OpenEvent BIOS function |
| 0x80030E7C | void _AkaoDispatchVoice(struct MusicPlayerTrack *track, void *a1, int a2) | Dispatch voice opcodes until the next note or end of track |
| 0x80049948 | const unsigned char VOICE_OPCODE_LENGTHS[0x60] | Length table for voice opcodes 0xa0-0xff
0 for end of track and branches |
| 0x80049AA8 | void (* const VOICE_OPCODES[0x60])(struct MusicPlayerTrack *, void *, int) | Address table for voice opcodes 0xa0-0xff |
| 0x80049C44 | const unsigned short VOLUME_TABLE_L[256] | See Opcode 0xAA for volume balance calculation |
| 0x80049E44 | const unsigned short VOLUME_TABLE_R[256] | See Opcode 0xAA for volume balance calculation |
| 0x80083580 | unsigned char g_AkaoSeqData[] | RAM area to load AKAO sequence data |
Runtime Library Functions
LIBSPU
| PSX Address | Declaration | Description |
|---|---|---|
| 0x80036298 | void SpuInit(void) | |
| 0x80036FFC | long SpuInitMalloc(long num, char *top) | |
| 0x800373AC | long SpuMallocWithStartAddr(unsigned long addr, long size) | |
| 0x80037964 | unsigned long SpuSetNoiseVoice(long on_off, unsigned long voice_bit) | |
| 0x80037B90 | long SpuSetNoiseClock(long n_clock) | |
| 0x80037BE0 | unsigned long SpuRead(unsigned char *addr, unsigned long size) | |
| 0x80037C40 | long SpuSetReverb(long on_off) | |
| 0x80037D90 | long SpuGetReverb(void) | |
| 0x80037E1C | long SpuSetReverbModeParam(SpuReverbAttr *attr) | |
| 0x800387FC | void SpuGetReverbModeParam (SpuReverbAttr *attr) | |
| 0x8003884C | long SpuSetReverbDepth(SpuReverbAttr *attr) | |
| 0x800388C4 | unsigned long SpuSetReverbVoice(long on_off, unsigned long voice_bit) | |
| 0x800388E8 | long SpuClearReverbWorkArea(long mode) | |
| 0x80038A84 | long SpuSetIRQ(long on_off) | |
| 0x80038BC4 | unsigned long SpuSetIRQAddr(unsigned long addr) | |
| 0x80038C04 | SpuIRQCallbackProc SpuSetIRQCallback(SpuIRQCallbackProc func) | |
| 0x80038C6C | void SpuSetKey(long on_off, unsigned long voice_bit) | |
| 0x80038F04 | unsigned long SpuWrite(unsigned char *addr, unsigned long size) | |
| 0x80038F64 | unsigned long SpuSetTransferStartAddr(unsigned long addr) | |
| 0x80038FB8 | long SpuSetTransferMode(long mode) | |
| 0x80038FEC | SpuTransferCallbackProc SpuSetTransferCallback(SpuTransferCallbackProc func) | |
| 0x80039010 | unsigned long SpuSetPitchLFOVoice(long on_off, unsigned long voice_bit) | |
| 0x80039034 | void SpuSetCommonAttr(SpuCommonAttr *attr) | |
| 0x800393C8 | void SpuSetVoiceVolume(int voiceNum, short volL, short volR) | |
| 0x80039450 | void SpuSetVoiceVolumeAttr(int voiceNum, short volL, short volR, short volModeL, short volModeR) | |
| 0x800395C8 | void SpuSetVoicePitch(int voiceNum, unsigned short pitch) | |
| 0x80039644 | void SpuSetVoiceStartAddr(int voiceNum, unsigned long startAddr) | |
| 0x800396C0 | void SpuSetVoiceLoopStartAddr(int voiceNum, unsigned long lsa) | |
| 0x8003973C | void SpuSetVoiceDR(int voiceNum, unsigned short DR) | |
| 0x800397C8 | void SpuSetVoiceSL(int voiceNum, unsigned short SL) | |
| 0x80039850 | void SpuSetVoiceARAttr(int voiceNum, unsigned short AR, long ARmode) | |
| 0x800398EC | void SpuSetVoiceSRAttr(int voiceNum, unsigned short SR, long SRmode) | |
| 0x800399D0 | void SpuSetVoiceRRAttr(int voiceNum, unsigned short RR, long RRmode) |
LIBETC
| PSX Address | Declaration | Description |
|---|---|---|
| 0x8003D0C0 | int ResetCallback(void) | |
| 0x8003D150 | int VSyncCallback(void (*func)(void)) | |
| 0x8003D1B4 | int StopCallback(void) | |
| 0x8003D214 | int CheckCallback(void) |
LIBAPI
| PSX Address | Declaration | Description |
|---|---|---|
| 0x800429F0 | void DeliverEvent(unsigned long ev1, unsigned long ev2) | |
| 0x80042A00 | long OpenEvent(unsigned long desc, long spec, long mode, long (*func)()) | |
| 0x80042A10 | long CloseEvent(long event) | |
| 0x80042A20 | long WaitEvent(long event) | |
| 0x80042A40 | long EnableEvent(long event) | |
| 0x80042A50 | long DisableEvent(long event) | |
| 0x80042BC0 | long SetRCnt(unsigned long spec, unsigned short target, long mode) | |
| 0x80042C60 | long GetRCnt(unsigned long spec) | |
| 0x80042C98 | long StartRCnt(unsigned long spec) | |
| 0x80042CCC | long StopRCnt(unsigned long spec) |
Structures
struct AkaoSpuVoiceAttr
{
uint32_t voice; // 0x00: voice number
uint32_t update_flags; // 0x04: bitset that indicates what SPU registers need to be updated
uint32_t addr; // 0x08: waveform data start address (SPU address)
uint32_t loop_addr; // 0x0c: loop start address (SPU address)
uint32_t a_mode; // 0x10: ADSR: attack rate mode
uint32_t s_mode; // 0x14: ADSR: sustain rate mode
uint32_t r_mode // 0x18: ADSR: release rate mode
uint16_t pitch; // 0x1c: pitch
uint16_t ar; // 0x1e: ADSR: attack rate
uint16_t dr; // 0x20: ADSR: decay rate
uint16_t sl; // 0x22: ADSR: sustain level
uint16_t sr; // 0x24: ADSR: sustain rate
uint16_t rr; // 0x26: ADSR: release rate
SpuVolume volume; // 0x28: volume (left and right)
};
struct AkaoPlayer // the music player instance exists at 0x8009A104
{
uint32_t stereo_mode; // 0x00: stereo mode (1: stereo, 4: surround, otherwise: mono)
uint32_t active_voices; // 0x04: bitset that indicates the voices currently in use
uint32_t key_on_voices; // 0x08: bitset that indicates the voices to key on
uint32_t keyed_voices; // 0x0c: bitset that indicates the voices currently keyed on
uint32_t key_off_voices; // 0x10: bitset that indicates the voices to key off
uint32_t saved_active_voices; // 0x14: unknown voice bitset
uint32_t tempo; // 0x18: tempo (Q16 fixed-point number)
int32_t tempo_slope; // 0x1c: slope of tempo slider (Q16 fixed-point number)
uint32_t time_counter; // 0x20: time counter (0x10000 = 1 tick)
uint32_t overlay_voices; // 0x24: bitset that indicates the sub-voices used for overlay (opcode 0xF4)
uint32_t alternate_voices; // 0x28: bitset that indicates the sub-voices used for alternate voice (opcode 0xF8)
uint32_t noise_voices; // 0x2c: bitset that indicates the voices with noise mode enabled
uint32_t reverb_voices; // 0x30: bitset that indicates the voices with reverb enabled
uint32_t pitch_lfo_voices; // 0x34: bitset that indicates the voices with pitch LFO (frequency modulation) mode enabled
uint32_t spucnt; // 0x38: SPUCNT shadow
uint32_t reverb_type; // 0x3c: reverb type
uint32_t reverb_depth; // 0x40: reverb depth (Q16 fixed-point number)
int32_t reverb_depth_slope; // 0x44: slope of reverb depth slider (Q16 fixed-point number)
uint16_t tempo_slide_length; // 0x48: tempo slide length
uint16_t song_id; // 0x4a: current song id
uint16_t condition_ack; // 0x4c: the last matched condition value (opcode 0xEF)
uint16_t condition; // 0x4e: condition variable for dynamic branching according to game status (opcode 0xEF)
uint16_t reverb_depth_slide_length; // 0x50: length of reverb depth slide
uint16_t noise_clock; // 0x52: noise clock frequency
uint16_t field_54; // 0x54: unknown
uint16_t beats_per_measure; // 0x56: beats per measure
uint16_t beat; // 0x58: current beat
uint16_t ticks_per_beat; // 0x5a: ticks per beat
uint16_t tick; // 0x5c: current ticks per beat
uint16_t measure; // 0x5e: current measure
};
struct AkaoPlayerTrack // the music player track instances exist at 0x80096608 + (N * 0x108)
{
uint8_t *addr; // 0x00
uint8_t *loop_addrs[4]; // 0x04
AkaoDrumKeyAttr *drum_addr; // 0x14
int16_t *vibrato_lfo_addr; // 0x18
int16_t *tremolo_lfo_addr; // 0x1C
int16_t *pan_lfo_addr; // 0x20
uint32_t overlay_voice_num; // 0x24
uint32_t alternate_voice_num; // 0x28
uint32_t master_volume; // 0x2C
uint32_t pitch_of_note; // 0x30
int32_t pitch_bend_slide_amplitude; // 0x34
uint16_t voice_effect_flags; // 0x38
uint16_t field_3A; // 0x3A
uint16_t field_3C; // 0x3C
uint16_t field_3E; // 0x3E
uint32_t field_40; // 0x40
uint32_t volume; // 0x44
int32_t volume_slope; // 0x48
int32_t pitch_bend_slope; // 0x4C
uint16_t field_50; // 0x50
uint16_t field_52; // 0x52
uint16_t field_54; // 0x54
uint8_t delta_time_counter; // 0x56
uint8_t gate_time_counter; // 0x57
uint16_t instrument; // 0x58
uint16_t field_5A; // 0x5A
uint16_t volume_slide_length_counter; // 0x5C
uint16_t overlay_balance_slide_length_counter; // 0x5E
uint16_t pan; // 0x60
uint16_t pan_slide_length; // 0x62
int16_t pitch_slide_length_counter; // 0x64
uint16_t octave; // 0x66
uint16_t pitch_slide_length; // 0x68
uint16_t previous_note_number; // 0x6A
uint16_t portamento_speed; // 0x6C
uint16_t legato_flags; // 0x6E
uint16_t field_70; // 0x70
uint16_t vibrato_lfo_delay; // 0x72
uint16_t vibrato_delay_counter; // 0x74
uint16_t vibrato_rate; // 0x76
uint16_t vibrato_rate_counter; // 0x78
uint16_t vibrato_form; // 0x7A
uint16_t vibrato_max_amplitude; // 0x7C
uint16_t vibrato_depth; // 0x7E
uint16_t vibrato_depth_slide_length_counter; // 0x80
int16_t vibrato_depth_slope; // 0x82
uint16_t field_84; // 0x84
uint16_t tremolo_delay; // 0x86
uint16_t tremolo_delay_counter; // 0x88
uint16_t tremolo_rate; // 0x8A
uint16_t tremolo_rate_counter; // 0x8C
uint16_t tremolo_form; // 0x8E
uint16_t tremolo_depth; // 0x90
uint16_t tremolo_depth_slide_length_counter; // 0x92
int16_t tremolo_depth_slope; // 0x94
uint16_t field_96; // 0x96
uint16_t pan_lfo_rate; // 0x98
uint16_t pan_lfo_rate_counter; // 0x9A
uint16_t pan_lfo_form; // 0x9C
uint16_t pan_lfo_depth; // 0x9E
uint16_t pan_lfo_depth_slide_length_counter; // 0xA0
int16_t pan_lfo_slope; // 0xA2
uint16_t noise_on_off_delay_counter; // 0xA4
uint16_t pitchmod_on_off_delay_counter; // 0xA6
uint8_t field_A8[16]; // 0xA8
uint16_t loop_layer; // 0xB8
uint16_t loop_counts[4]; // 0xBA
uint16_t previous_delta_time; // 0xC2
uint16_t forced_delta_time; // 0xC4
uint16_t overlay_balance; // 0xC6
int16_t overlay_balance_slope; // 0xC8
int16_t pan_slope; // 0xCA
int16_t transpose; // 0xCC
int16_t tuning; // 0xCE
uint16_t note; // 0xD0
int16_t pitch_slide_amount; // 0xD2
int16_t previous_transpose; // 0xD4
int16_t vibrato_lfo_amplitude; // 0xD6
int16_t tremolo_lfo_amplitude; // 0xD8
int16_t pan_lfo_amplitude; // 0xDA
AkaoSpuVoiceAttr spu_attr; // 0xDC
};
