aboutsummaryrefslogtreecommitdiff
path: root/libpsn00b/psxspu
diff options
context:
space:
mode:
Diffstat (limited to 'libpsn00b/psxspu')
-rw-r--r--libpsn00b/psxspu/common.c154
-rw-r--r--libpsn00b/psxspu/readme.txt21
-rw-r--r--libpsn00b/psxspu/spuinit.s124
-rw-r--r--libpsn00b/psxspu/spukeyon.s17
-rw-r--r--libpsn00b/psxspu/spureverbon.s16
-rw-r--r--libpsn00b/psxspu/spusetkey.s26
-rw-r--r--libpsn00b/psxspu/spusetreverb.s25
-rw-r--r--libpsn00b/psxspu/spusetreverbaddr.s25
-rw-r--r--libpsn00b/psxspu/spusetvoiceraw.s60
-rw-r--r--libpsn00b/psxspu/transfer.s108
10 files changed, 162 insertions, 414 deletions
diff --git a/libpsn00b/psxspu/common.c b/libpsn00b/psxspu/common.c
new file mode 100644
index 0000000..306cfd2
--- /dev/null
+++ b/libpsn00b/psxspu/common.c
@@ -0,0 +1,154 @@
+/*
+ * PSn00bSDK SPU library (common functions)
+ * (C) 2022 spicyjpeg - MPL licensed
+ */
+
+#include <stdint.h>
+#include <stdio.h>
+#include <psxspu.h>
+#include <hwregs_c.h>
+
+#define WRITABLE_AREA_ADDR 0x200
+#define DMA_CHUNK_LENGTH 16
+#define STATUS_TIMEOUT 0x100000
+
+/* Internal globals */
+
+static SPU_TransferMode _transfer_mode = SPU_TRANSFER_BY_DMA;
+static uint16_t _transfer_addr = WRITABLE_AREA_ADDR;
+
+/* SPU initialization */
+
+static void _wait_status(uint16_t mask, uint16_t value) {
+ for (int i = STATUS_TIMEOUT; i; i--) {
+ if ((SPU_STAT & mask) == value)
+ return;
+ }
+
+ printf("psxspu: status register timeout (0x%04x)\n", SPU_STAT);
+}
+
+void SpuInit(void) {
+ SPU_CTRL = 0x0000; // SPU disabled
+ _wait_status(0x001f, 0x0000);
+
+ SPU_MASTER_VOL_L = 0;
+ SPU_MASTER_VOL_R = 0;
+ SPU_REVERB_VOL_L = 0;
+ SPU_REVERB_VOL_R = 0;
+ SPU_KEY_OFF = 0x00ffffff;
+ SPU_FM_MODE = 0;
+ SPU_NOISE_MODE = 0;
+ SPU_REVERB_ON = 0;
+ SPU_REVERB_ADDR = 0xfffe;
+ SPU_CD_VOL_L = 0;
+ SPU_CD_VOL_R = 0;
+ SPU_EXT_VOL_L = 0;
+ SPU_EXT_VOL_R = 0;
+
+ for (int i = 0; i < 24; i++) {
+ SPU_CH_VOL_L(i) = 0;
+ SPU_CH_VOL_R(i) = 0;
+ SPU_CH_FREQ(i) = 0;
+ SPU_CH_ADDR(i) = 0;
+ }
+
+ DMA_DPCR |= 0x000b0000; // Enable DMA4
+ DMA_CHCR(4) = 0x00000201; // Stop DMA4
+
+ SPU_CTRL = 0xc011; // Enable SPU, DAC, CD audio, set manual transfer mode
+ _wait_status(0x001f, 0x0011);
+
+ // Upload a dummy ADPCM block to the first 16 bytes of SPU RAM. This may be
+ // freely used or overwritten.
+ SPU_ADDR = WRITABLE_AREA_ADDR;
+ _wait_status(0x0400, 0x0000);
+
+ SPU_DATA = 0x0500;
+ for (int i = 7; i; i--)
+ SPU_DATA = 0x0000;
+
+ // Sony's implementation leaves everything muted, however it makes sense to
+ // turn up at least the master and CD audio volume by default.
+ SPU_MASTER_VOL_L = 0x3fff;
+ SPU_MASTER_VOL_R = 0x3fff;
+ SPU_CD_VOL_L = 0x3fff;
+ SPU_CD_VOL_R = 0x3fff;
+}
+
+/* SPU RAM transfer API */
+
+static void _load_store_data(uint32_t *data, size_t length, int mode) {
+ if (length % 4)
+ printf("psxspu: can't transfer a number of bytes that isn't multiple of 4\n");
+
+ length /= 4;
+ if ((length >= DMA_CHUNK_LENGTH) && (length % DMA_CHUNK_LENGTH)) {
+ printf("psxspu: transfer data length (%d) is not a multiple of %d, rounding\n", length, DMA_CHUNK_LENGTH);
+ length += DMA_CHUNK_LENGTH - 1;
+ }
+
+ SPU_CTRL &= 0xffcf; // Disable DMA request
+ _wait_status(0x0030, 0x0000);
+
+ // Enable DMA request for writing (2) or reading (3)
+ SPU_ADDR = _transfer_addr;
+ SPU_CTRL |= mode << 4;
+ _wait_status(0x0400, 0x0000);
+
+ DMA_MADR(4) = (uint32_t) data;
+ if (length < DMA_CHUNK_LENGTH)
+ DMA_BCR(4) = 0x00010000 | length;
+ else
+ DMA_BCR(4) = DMA_CHUNK_LENGTH | ((length / DMA_CHUNK_LENGTH) << 16);
+
+ DMA_CHCR(4) = 0x01000200 | ((mode & 1) ^ 1);
+}
+
+void SpuRead(const uint32_t *data, size_t size) {
+ _load_store_data(data, size, 3);
+}
+
+void SpuWrite(const uint32_t *data, size_t size) {
+ if (_transfer_addr < WRITABLE_AREA_ADDR)
+ return;
+
+ // I/O transfer mode is not that useful, but whatever.
+ if (_transfer_mode) {
+ SPU_ADDR = _transfer_addr;
+ SPU_CTRL = (SPU_CTRL & 0xffcf) | 0x0010; // Manual transfer mode
+ _wait_status(0x0400, 0x0000);
+
+ for (int i = size; i; i -= 4) {
+ uint32_t value = *(data++);
+
+ SPU_DATA = (uint16_t) value;
+ SPU_DATA = (uint16_t) (value >> 16);
+ }
+
+ return;
+ }
+
+ _load_store_data(data, size, 2);
+}
+
+SPU_TransferMode SpuSetTransferMode(SPU_TransferMode mode) {
+ _transfer_mode = mode;
+ return mode;
+}
+
+uint32_t SpuSetTransferStartAddr(uint32_t addr) {
+ if (addr > 0x7ffff)
+ return 0;
+
+ _transfer_addr = (addr + 7) / 8;
+ return addr;
+}
+
+int SpuIsTransferCompleted(int mode) {
+ if (!mode)
+ return ((SPU_STAT >> 10) & 1) ^ 1;
+
+ _wait_status(0x0400, 0x0000);
+ return 1;
+}
diff --git a/libpsn00b/psxspu/readme.txt b/libpsn00b/psxspu/readme.txt
index 3ed90d0..07bbf97 100644
--- a/libpsn00b/psxspu/readme.txt
+++ b/libpsn00b/psxspu/readme.txt
@@ -3,29 +3,24 @@ PSX SPU Library, part of PSn00bSDK
Licensed under Mozilla Public License
- Open source implementation of the SPU library written mostly in MIPS
-assembly. Currently only supports SPU init, uploading sample data using DMA
-transfer and basic sample playback but is currently lacking a bunch of
-important functions.
-
- Very work in progress currently.
-
+Open source implementation of the SPU library written entirely in C. Currently
+only supports SPU initialization, reading/writing SPU RAM using DMA and basic
+sample playback. Most of the official API is not going to be implemented as the
+vast majority of it is just inefficient wrappers around accessing SPU registers
+directly, which can be done already using the macros defined in hwregs_c.h.
Library developer(s):
- Lameguy64
-
-
+ Lameguy64 (initial implementation in assembly)
+ spicyjpeg
+
Library header(s):
psxspu.h
-
Todo list:
* SPU RAM allocation routines yet to be implemented (heap must only be
stored in main RAM and not SPU RAM like in the official SDK).
- * SpuKeyOn() is actually not part of the official library.
-
* SPU reverb configuration functions yet to be implemented.
diff --git a/libpsn00b/psxspu/spuinit.s b/libpsn00b/psxspu/spuinit.s
deleted file mode 100644
index 6966213..0000000
--- a/libpsn00b/psxspu/spuinit.s
+++ /dev/null
@@ -1,124 +0,0 @@
-.set noreorder
-.set noat
-
-.include "hwregs_a.h"
-
-.section .text
-
-
-.global SpuInit
-.type SpuInit, @function
-SpuInit:
-
- addiu $sp, -4
- sw $ra, 0($sp)
-
- lui $v1, IOBASE
-
- # Stop and mute everything
-
- sh $0 , SPU_CTRL($v1) # Clear control settings
- jal SpuCtrlSync
- move $a0, $0
-
- sh $0 , SPU_MASTER_VOL_L($v1) # Clear master volume
- sh $0 , SPU_MASTER_VOL_R($v1)
-
- sh $0 , SPU_REVERB_VOL_L($v1) # Clear reverb volume
- sh $0 , SPU_REVERB_VOL_R($v1)
-
- sh $0 , SPU_CD_VOL_L($v1) # Clear CD volume
- sh $0 , SPU_CD_VOL_R($v1)
-
- sh $0 , SPU_EXT_VOL_L($v1) # Clear external audio volume
- sh $0 , SPU_EXT_VOL_R($v1)
-
- sw $0 , SPU_FM_MODE($v1) # Turn off FM modes
- sw $0 , SPU_NOISE_MODE($v1) # Turn off noise modes
- sw $0 , SPU_REVERB_ON($v1) # Turn off reverb modes
-
- li $v0, 0xfffe
- sh $v0, SPU_REVERB_ADDR($v1)
-
- lui $v0, 0x0200;
- ori $v0, 0x3fff;
-
- # Clear all voices
-
- addiu $a1, $sp, -20
- sw $0 , 0($a1)
- sw $0 , 4($a1)
- sw $0 , 8($a1)
- sw $0 , 12($a1)
-
- li $a2, 23
-
-.Lclear_voices:
- jal SpuSetVoiceRaw
- move $a0, $a2
- addiu $a2, -1
- bgez $a2, .Lclear_voices
- nop
-
- addiu $v0, $0, -1 # Set all keys to off
- sw $v0, SPU_KEY_OFF($v1)
-
- li $v0, 0x4 # Set SPU data transfer control
- sh $v0, SPU_DMA_CTRL($v1) # (usually always 0x4)
-
- lw $v0, DMA_DPCR($v1) # Enable DMA channel 4 (SPU DMA)
- lui $at, 0xb
- or $v0, $at
- sw $v0, DMA_DPCR($v1)
-
- li $v0, 0xC001 # Enable SPU
- sh $v0, SPU_CTRL($v1)
- jal SpuCtrlSync
- move $a0, $v0
-
- li $v0, 0x3fff # Activate master volume
- sh $v0, SPU_MASTER_VOL_L($v1)
- sh $v0, SPU_MASTER_VOL_R($v1)
-
- sh $v0, SPU_CD_VOL_L($v1) # Activate CD volume
- sh $v0, SPU_CD_VOL_R($v1)
-
- lw $ra, 0($sp)
- addiu $sp, 4
- jr $ra
- nop
-
-
-# Waits until bits 0-5 of SPUSTAT are equal to SPUCNT
-#
-# Destroys v0, v1, a0
-#
-.global SpuCtrlSync
-.type SpuCtrlSync, @function
-SpuCtrlSync:
- lui $v1, IOBASE
- andi $a0, 0x3f
-.Lctrl_wait:
- lhu $v0, SPU_STAT($v1) # Get SPUSTAT value
- nop
- andi $v0, 0x3f
- bne $v0, $a0, .Lctrl_wait # Wait until SPUCNT and SPUSTAT are equal
- nop
- jr $ra
- nop
-
-
-# Waits until SPU has finished transfers
-#
-.global SpuWait
-.type SpuWait, @function
-SpuWait:
- lui $v0, IOBASE
- lhu $v0, SPU_STAT($v0)
- nop
- andi $v0, 0x400
- bnez $v0, SpuWait
- nop
- jr $ra
- nop
- \ No newline at end of file
diff --git a/libpsn00b/psxspu/spukeyon.s b/libpsn00b/psxspu/spukeyon.s
deleted file mode 100644
index 33592c2..0000000
--- a/libpsn00b/psxspu/spukeyon.s
+++ /dev/null
@@ -1,17 +0,0 @@
-.set noreorder
-
-.include "hwregs_a.h"
-
-.section .data
-
-
-.global SpuKeyOn
-.type SpuKeyOn, @function
-SpuKeyOn:
- lui $v1, IOBASE
- li $v0, 1
- sll $v0, $a0
- sw $v0, SPU_KEY_ON($v1)
- sw $v0, SPU_KEY_ON($v1)
- jr $ra
- nop \ No newline at end of file
diff --git a/libpsn00b/psxspu/spureverbon.s b/libpsn00b/psxspu/spureverbon.s
deleted file mode 100644
index 635fac3..0000000
--- a/libpsn00b/psxspu/spureverbon.s
+++ /dev/null
@@ -1,16 +0,0 @@
-.set noreorder
-
-.include "hwregs_a.h"
-
-.section .data
-
-
-.global SpuReverbOn
-.type SpuReverbOn, @function
-SpuReverbOn:
- lui $v1, IOBASE
- li $v0, 1
- sll $v0, $a0
- sw $v0, SPU_REVERB_ON($v1)
- jr $ra
- nop \ No newline at end of file
diff --git a/libpsn00b/psxspu/spusetkey.s b/libpsn00b/psxspu/spusetkey.s
deleted file mode 100644
index 4ad0cff..0000000
--- a/libpsn00b/psxspu/spusetkey.s
+++ /dev/null
@@ -1,26 +0,0 @@
-.set noreorder
-
-.include "hwregs_a.h"
-
-.section .data
-
-
-.global SpuSetKey
-.type SpuSetKey, @function
-SpuSetKey:
- # a0 - 0: key off, 1: key on
- # a1 - Voice bit mask
-
- lui $a2, IOBASE
-
- beqz $a0, .Lkey_off
- nop
-
- jr $ra
- sw $a1, SPU_KEY_ON($a2)
-
-.Lkey_off:
-
- jr $ra
- sw $a1, SPU_KEY_OFF($a2)
- \ No newline at end of file
diff --git a/libpsn00b/psxspu/spusetreverb.s b/libpsn00b/psxspu/spusetreverb.s
deleted file mode 100644
index 8257812..0000000
--- a/libpsn00b/psxspu/spusetreverb.s
+++ /dev/null
@@ -1,25 +0,0 @@
-.set noreorder
-
-.include "hwregs_a.h"
-
-.section .data
-
-
-.global SpuSetReverb
-.type SpuSetReverb, @function
-SpuSetReverb:
- addiu $sp, -4
- sw $ra, 0($sp)
-
- lui $v1, IOBASE
- lhu $v0, SPU_CTRL($v1)
- nop
- ori $v0, 0x80 # Enable reverb
- sh $v0, SPU_CTRL($v1)
- jal SpuCtrlSync
- move $a0, $v0
-
- lw $ra, 0($sp)
- addiu $sp, 4
- jr $ra
- nop \ No newline at end of file
diff --git a/libpsn00b/psxspu/spusetreverbaddr.s b/libpsn00b/psxspu/spusetreverbaddr.s
deleted file mode 100644
index 089a91a..0000000
--- a/libpsn00b/psxspu/spusetreverbaddr.s
+++ /dev/null
@@ -1,25 +0,0 @@
-.set noreorder
-
-.include "hwregs_a.h"
-
-
-.section .text
-
-.global SpuSetReverbAddr
-.type SpuSetReverbAddr, @function
-SpuSetReverbAddr:
- lui $a3, IOBASE
- srl $a0, 3
- sh $a0, SPU_REVERB_ADDR($a3)
- jr $ra
- nop
-
-
-.global SpuSetReverbVolume
-.type SpuSetReverbVolume, @function
-SpuSetReverbVolume:
- lui $a3, IOBASE
- sh $a0, SPU_REVERB_VOL_L($a3)
- sh $a1, SPU_REVERB_VOL_R($a3)
- jr $ra
- nop \ No newline at end of file
diff --git a/libpsn00b/psxspu/spusetvoiceraw.s b/libpsn00b/psxspu/spusetvoiceraw.s
deleted file mode 100644
index 43450f6..0000000
--- a/libpsn00b/psxspu/spusetvoiceraw.s
+++ /dev/null
@@ -1,60 +0,0 @@
-.set noreorder
-
-.include "hwregs_a.h"
-
-
-.set PARAM_L, 0
-.set PARAM_R, 2
-.set PARAM_FREQ, 4
-.set PARAM_ADDR, 6
-.set PARAM_LOOP, 8
-.set PARAM_RES, 10
-.set PARAM_ADSR, 12
-
-
-.section .text
-
-.global SpuSetVoiceRaw
-.type SpuSetVoiceRaw, @function
-SpuSetVoiceRaw:
-
- # a0 - Voice number
- # a1 - Address to parameters
-
- sll $a0, 4
- addiu $a0, SPU_VOICE_BASE
-
- lui $v1, IOBASE
- or $a0, $v1
-
- lhu $v0, PARAM_L($a1)
- nop
- sh $v0, SPU_VOICE_VOL_L($a0)
-
- lhu $v0, PARAM_R($a1)
- nop
- sh $v0, SPU_VOICE_VOL_R($a0)
-
- lhu $v0, PARAM_FREQ($a1)
- nop
- sh $v0, SPU_VOICE_FREQ($a0)
-
- lhu $v0, PARAM_ADDR($a1)
- nop
- sh $v0, SPU_VOICE_ADDR($a0)
-
- lhu $v0, PARAM_LOOP($a1)
- nop
- sh $v0, SPU_VOICE_LOOP($a0)
-
-
- lw $v0, PARAM_ADSR($a1)
- nop
- sh $v0, SPU_VOICE_ADSR_L($a0)
- srl $v0, 16
- sh $v0, SPU_VOICE_ADSR_H($a0)
-
-
- jr $ra
- nop
- \ No newline at end of file
diff --git a/libpsn00b/psxspu/transfer.s b/libpsn00b/psxspu/transfer.s
deleted file mode 100644
index adcdb33..0000000
--- a/libpsn00b/psxspu/transfer.s
+++ /dev/null
@@ -1,108 +0,0 @@
-.set noreorder
-
-.include "hwregs_a.h"
-
-
-.section .text
-
-.global SpuSetTransferMode
-.type SpuSetTransferMode, @function
-SpuSetTransferMode:
- la $v0, _spu_transfer_mode
- sb $a0, 0($v0)
- jr $ra
- move $v0, $a0
-
-
-.global SpuSetTransferStartAddr
-.type SpuSetTransferStartAddr, @function
-SpuSetTransferStartAddr:
- li $v0, 0x1000 # Check if value is valid
- blt $a0, $v0, .Lbad_value
- nop
- lui $v0, 8 # 0x7ffff = (8<<16)-1
- addiu $v0, -1
- bgt $a0, $v0, .Lbad_value
- nop
-
- la $v1, _spu_transfer_addr
- srl $v0, $a0, 3 # Set transfer destination address
- sh $v0, 0($v1)
-
- jr $ra
- move $v0, $a0
-
-.Lbad_value:
- jr $ra
- move $v0, $0
-
-
-.global SpuWrite
-.type SpuWrite, @function
-SpuWrite:
- addiu $sp, -8
- sw $ra, 0($sp)
- sw $a0, 4($sp)
-
- lui $a3, IOBASE
-
- lhu $v0, SPU_CTRL($a3) # Set transfer mode to Stop
- nop
- andi $v0, 0xffcf
- sh $v0, SPU_CTRL($a3)
- jal SpuCtrlSync
- move $a0, $v0
-
- la $v1, _spu_transfer_addr # Set SPU write address
- lhu $v1, 0($v1)
- nop
- sh $v1, SPU_ADDR($a3)
-
- lhu $v0, SPU_CTRL($a3) # Set transfer mode to DMA write
- nop
- ori $v0, 0x20
- sh $v0, SPU_CTRL($a3)
- #jal SpuCtrlSync # Locks up on most emulators (bit 5 in
- #move $a0, $v0 # SPUSTAT likely not updating, seems to
- # be okay to not wait for it on real HW)
-
- lw $a0, 4($sp)
-
-.Ldma_wait: # Wait for SPU to be ready for DMA
- lhu $v0, SPU_STAT($a3)
- nop
- andi $v0, 0x400 # Bit 8 in SPUSTAT never changes to 1 on
- bnez $v0, .Ldma_wait # emulators so use bit 10 instead
- nop
-
- sw $a0, DMA4_MADR($a3) # Set DMA source address
-
- li $v0, 0x10 # 16 words per block (64 bytes)
- addiu $a1, 63 # Add by 63 to ensure all bytes get sent
- srl $a1, 6 # Equivalent to divide by 64
- andi $a1, 0xffff
- sll $a1, 16
- or $v0, $a1
- sw $v0, DMA4_BCR($a3)
-
- lui $v0, 0x0100 # Commence transfer
- ori $v0, 0x0201
- sw $v0, DMA4_CHCR($a3)
-
- lw $ra, 0($sp)
- addiu $sp, 8
- jr $ra
- nop
-
-
-.section .data
-
-.global _spu_transfer_mode
-.type _spu_transfer_mode, @object
-_spu_transfer_mode:
- .word 0x0
-
-.global _spu_transfer_addr
-.type _spu_transfer_addr, @object
-_spu_transfer_addr:
- .word 0x200 \ No newline at end of file