S-SMP: Difference between revisions

From SNESdev Wiki
Jump to navigationJump to search
(→‎Registers: documenting)
(→‎See Also: Add link to S-DSP_registers page)
 
(53 intermediate revisions by 3 users not shown)
Line 1: Line 1:
The SPC700 is the CPU portion of the S-SMP processor used to run the sound and music of the SNES. It is an 8-bit CPU with capabilities similar to the 6502.
The '''SHVC-SOUND''' module of the SNES includes several components:<ref>Super Nintendo (NTSC) Revision 2 Motherboard schematic by Jonathon W. Donaldson</ref>
 
* '''S-SMP''': Sony sub CPU
** Sony SPC-700 processor, clocked at 1.024MHz (see [[SPC-700 instruction set]])
** 3 timers, two running at 8kHz and one at 64kHz
** [[MMIO registers#APUIOn|APUIO]] and [[S-SMP#CPUIOx|CPUIOx]] registers for communication between the 65816 S-CPU and the SPC700 code
** [[#IPL Boot ROM|IPL Boot ROM]]
* '''S-DSP''': Sony sound chip (see [[S-DSP registers]])
** Digital signal processor that generates the sound data
** 8 voice channels
** Decodes [[BRR samples]] at a variable sample rate using 4-point Gaussian interpolation
** FIR filtered echo buffer
** Manages the clock of the S-DSP, S-SMP and DAC
*** Clocked by a 24.576MHz ceramic resonator
*** Generates 1 stereo sample every 768 resonator cycles
*** Internally clocked at 3.072MHz
** Bus Arbiter for the Audio-RAM.  The Audio-RAM is time-shared between the S-SMP and S-DSP, with 1 S-SMP memory access for every 2nd S-DSP memory access.
* '''Audio-RAM''': 64KiB RAM from two 32K x 8bit PSRAM chips. (Also known as ARAM.)
* µPD6376 16-bit stereo DAC
** Digital to analog converter, outputting the analog audio signal from the DSP's stereo 16-bit 32000 Hz digital audio
* Stereo Amplifier
** Mixes DAC output with the [[Cartridge connector]] analog audio input and the [[EXT connector]] analog audio input
** The amplifier can be disabled by the S-SMP's /MUTE pin (bit 6 of the [[S-DSP_registers#FLG]] S-DSP register)
** The output of the stereo amplifier is mixed into a mono output for the RF modulator and EXT connector
 
 
The SPC-700 is an 8-bit CPU that is almost like an extended MOS-6502.
 
The SPC-700 driven by a 1.024 MHz clock, though the SPC-700 instruction timing is very similar to a 6502 in that each instruction takes at least 2 cycles. The exact clock rate is independent from the rest of the SNES, and may drift slightly with temperature. The nominal 32000 Hz sample rate is actually 32 clocks per sample.
 
Related reference:
* [[SPC-700 instruction set]]
* [[S-DSP registers]]
* [[DSP envelopes]]
* [[BRR samples]]
 
The term SPC is also used to describe a [[SPC file format]] (.SPC) for storing SNES music. The S-DSP is not to be confused with the [[DSP-1]] cartridge expansion hardware. The term S-SMP is often contrasted with [[S-CPU]] when describing communication with the SNES main CPU.


== Memory Layout ==
== Memory Layout ==
Line 19: Line 55:
|}
|}


The region at '''$FFC0-FFFF''' will normally read from the 64-byte IPL ROM, but the underlying RAM can always be written to, and the undocumented test register '''$F0''' can be used to unmap the IPL ROM and allow read access to this RAM.
The region at '''$FFC0-FFFF''' will normally read from the 64-byte IPL ROM, but the underlying RAM can always be written to, and the high bit of the Control register '''$F1''' can be cleared to unmap the IPL ROM and allow read access to this RAM.


== Registers ==
== Registers ==
Aside from the SPC-700 CPU registers (see: [[SPC-700 instruction set]]), there are a collection of memory-mapped registers in the last 16 bytes of the zero-page.


{| class="wikitable"
{| class="wikitable"
! Name !! Address !! Bits !! Type !! Notes
|+ S-SMP register summary
|-
|-
! Test !! $F0
! colspan=2 | Name
| style="text-align: right" | <tt style="white-space: nowrap">.I.E TRWH</tt>
! Address
| W8
! Bits
| Undocumented test register. Internal and external wait-states (I,E), timers enable (T), RAM disable (R), RAM writable (W), timers disable (H).
! Type
|-
! Notes
! Control !! $F1
| style="text-align: right" | <tt style="white-space: nowrap">I.CC .210</tt>
| W8
| Enable IPL ROM (I), Clear data ports (C), timer enable (2,1,0).
|-
! Register Address !! $F2
| style="text-align: right" | <tt style="white-space: nowrap">.AAA AAAA</tt>
| RW8
| Selects a DSP register address.
|-
! Register Data !! $F3
| style="text-align: right" | <tt style="white-space: nowrap">VVVV VVVV</tt>
| RW8
| Reads or writes data to the selected DSP address.
|-
! Port 0 !! $F4
| style="text-align: right" | <tt style="white-space: nowrap">VVVV VVVV</tt>
| RW8
| Reads or writes data to [[MMIO registers#APUIO0|APUIO0]].
|-
! Port 1 !! $F5
| style="text-align: right" | <tt style="white-space: nowrap">VVVV VVVV</tt>
| RW8
| Reads or writes data to [[MMIO registers#APUIO1|APUIO1]].
|-
! Port 2 !! $F6
| style="text-align: right" | <tt style="white-space: nowrap">VVVV VVVV</tt>
| RW8
| Reads or writes data to [[MMIO registers#APUIO2|APUIO2]].
|-
|-
! Port 3 !! $F7
{{:APU register table/SMP}}
| style="text-align: right" | <tt style="white-space: nowrap">VVVV VVVV</tt>
| RW8
| Reads or writes data to [[MMIO registers#APUIO3|APUIO3]].
|-
|-
! --- !! $F8
! colspan=6 | <small>([[APU register table/SMP|table source]])</small>
| style="text-align: right" | <tt style="white-space: nowrap">.... ....</tt>
| RW8
| Unused (normal RAM).
|-
! --- !! $F9
| style="text-align: right" | <tt style="white-space: nowrap">.... ....</tt>
| RW8
| Unused (normal RAM).
|-
! Timer 0 !! $FA
| style="text-align: right" | <tt style="white-space: nowrap">TTTT TTTT</tt>
| W8
| 8KHz timer 0 interval.
|-
! Timer 1 !! $FB
| style="text-align: right" | <tt style="white-space: nowrap">TTTT TTTT</tt>
| W8
| 8KHz timer 1 interval.
|-
! Timer 2 !! $FC
| style="text-align: right" | <tt style="white-space: nowrap">TTTT TTTT</tt>
| W8
| 64KHz timer 2 interval.
|-
! Counter 0 !! $FD
| style="text-align: right" | <tt style="white-space: nowrap">.... CCCC</tt>
| R8
| Timer 0 count-up.
|-
! Counter 1 !! $FE
| style="text-align: right" | <tt style="white-space: nowrap">.... CCCC</tt>
| R8
| Timer 1 count-up.
|-
! Counter 2 !! $FF
| style="text-align: right" | <tt style="white-space: nowrap">.... CCCC</tt>
| R8
| Timer 2 count-up.
|}
|}


Write-only registers will read back as $00.
Write-only registers will read back as $00.


===$F0 Test===
 
{{Anchor|TEST}}
=== TEST - Undocumented test register ($F0, write-only) ===
7  bit  0
---- ----
IIEE TRWH
|||| ||||
|||| |||+- Halt timers
|||| ||+-- RAM writable
|||| |+--- Disable RAM reads
|||| +---- Enable timers
||++------ External wait state
++-------- Internal wait state
On power-on: TEST = $0A
 
 
'''DO NOT write to this register!!!'''
* Setting any of the wait state bits will slow the clock speed of the SPC-700 processor.
* Changing the wait state bits can cause crashes on real hardware.<ref>ares source code, <tt>[https://github.com/ares-emulator/ares/tree/master/ares/ares/sfc/smp/timing.cpp ares/sfc/smp/timing.cpp]</tt>, by Near</ref>
* The <tt>TEST</tt> register can disable Audio-RAM reads and/or writes.
* The <tt>TEST</tt> register can disable the timers.
 


This undocumented register responds to writes only when the P flag is clear.
This undocumented register responds to writes only when the P flag is clear.


===$F1 Control===
 
{{Anchor|CONTROL}}
 
=== CONTROL - Control register ($F1, write-only) ===
7  bit  0
---- ----
I.CC .210
| ||  |||
| ||  ||+- Enable timer 0
| ||  |+-- Enable timer 1
| ||  +--- Enable timer 2
| |+------ Clear CPUIO read ports 0 & 1
| +------- Clear CPUIO read ports 2 & 3
+--------- IPL ROM enable
On power-on: CONTROL = $B0
On reset:    CONTROL = $B0
 
 
This provides a way for the SPC-700 to reset the read ports ($F4-F7) without the SNES CPU having to write them externally. It also starts and stops the 3 timers.
This provides a way for the SPC-700 to reset the read ports ($F4-F7) without the SNES CPU having to write them externally. It also starts and stops the 3 timers.


* Bit 0 enables timer 0 when set. A transition from clear to set resets the internal interval counter to 0.
* 0/1/2 (bits 0-2) - Enables each of the 3 timers.
* Bit 1 enables timer 1.
** A transition from clear to set (0 -> 1) will reset the timer's internal counter and <tt>TxOUT</tt> to 0.
* Bit 2 enables timer 2.
* C (bit 4) - If set the <tt>CPUIO0</tt> and <tt>CPUIO1</tt> Data-from-CPU read registers ($F4, $F5) are reset to $00.
* Setting bit 4 will reset the value the SPC will read from ports 0 and 1 ($F4, $F5) to $00.
** <tt>CPUIOx</tt> Data-from-CPU is cleared on any <tt>CONTROL</tt> write with a clear bit set.
* Setting bit 5 will reset ports 2 and 3 ($F6, $F7).
** <tt>CPUIOx</tt> is only cleared on <tt>CONTROL</tt> writes.  Future APUIO writes to the APU will not be changed.
* Bit 7 will enable the IPL ROM if set.
** The 65816 S-CPU <tt>[[MMIO registers#APUIOn|APUIOn]]</tt> Data-from-APU registers will not be changed.
* C (bit 5) - If set the <tt>CPUIO2</tt> and <tt>CPUIO3</tt> Data-from-CPU read registers ($F6, $F7) are reset to $00.
* I (bit 7) - Enables the IPL ROM if set.
** This does not disable Audio-RAM writes to the IPL ROM memory addresses.
 


At reset this register is initialized as if $80 was written to it.
At reset this register is initialized as if $80 was written to it.


===$F2-F3 DSP===
The function of bit 7 enabling the IPL ROM is not documented in the [[SNES Development Manual]].
Write $F2 to select a DSP register, then a value can be read or written to that DSP register via $F3.


* Writing $F2 with the high bit set will select a DSP register according to the lower 7 bits, but it will be read-only.
* The high bit of $F2 will always read back as 0.


===$F4-F7 Port 0-3===
{{Anchor|DSPADDR}}
These 4 ports allow communication with the SNES CPU. There are 8 stored values, each is a one-way communication written from one side, and readable only from the other side. Each port therefore has two separate one-way values, each seen from only either the SNES CPU or the SPC-700.


If a port is read on the same cycle it is written, an incorrect value will result. For this reason, common practice is to read a port in a loop until the value changes, and then read it once more to ensure the correct value is read. (A single port can be used this way to indicate that a message is ready, and the other 3 ports could be safely read only once with the assumption that the other CPU will not write to them once the ready indication was given.)
=== DSPADDR - DSP register address ($F2) ===
7  bit  0
---- ----
RAAA AAAA
|||| ||||
|+++-++++- S-DSP register address
+--------- Read only flag


At reset these registers are initialized to $00.
Write $F2 to select a DSP register, then a value can be read or written to that DSP register via $F3.


===$FA-FC Timer 0-2===
* Writing $F2 with the high bit set will select a DSP register according to the lower 7 bits, but it will be read-only.
When enabled via $F1, the 3 timers will internally count at a rate of 8 KHz (timers 0,1) or 64 KHz (timer 2), and when this interval value has been exceeded, they will increment their external counter result ($FD-FF) and begin again.
* The high bit of $F2 will always read back as 0.


===$FD-FF Counter 0-2===
See: [[S-DSP_registers#Reading_and_writing_S-DSP_registers|Reading and writing S-DSP registers]] and [[S-DSP registers]]
The 4-bit result of the three timers counts up every time the interval is reached.


Reading these registers resets each counter to 0 immediately after the read. The upper 4 bits will always read as 0.


== DSP Registers ==
{{Anchor|DSPDATA}}
=== DSPDATA - DSP register data ($F3) ===
7  bit  0
---- ----
DDDD DDDD
|||| ||||
++++-++++- S-DSP register data
On write: if DSPADDR bit 7 clear: write to S-DSP address DSPADDR
On read: read from S-DSP register address DSPADDR


A DSP register can be selected with '''$F2''', after which it can be read or written at '''$F3'''. Often it is useful to load the register address into A, and the value to send in Y, so that '''MOV $F2, YA''' can be used to do both in one 16-bit instruction.
A DSP register can be selected with <tt>DSPADDR</tt> ($F2), after which it can be read or written at <tt>DSPDATA</tt> ($F3). Often it is useful to load the register address into A, and the value to send in Y, so that '''MOV $F2, YA''' can be used to do both in one 16-bit instruction.


=== Voices ===
The DSP register address space only has 7 bits. The high bit of <tt>DSPADDR</tt> ($F2), if set, will make the selected register read-only via <tt>DSPDATA</tt> ($F3).


There are 8 voices, numbered 0 to 7. Each voice X has 10 registers in the range $X0-$X9.
When initializing the DSP registers for the first time, take care not to accidentally enable echo writeback via <tt>[[S-DSP_registers#FLG|FLG]]</tt>, because it will immediately begin overwriting values in RAM.


{| class="wikitable"
See: [[S-DSP_registers#Reading_and_writing_S-DSP_registers|Reading and writing S-DSP registers]] and [[S-DSP registers]]
! Name
! Address
! Bits
! Notes
|-
! VOL (L)
! $X0
| style="text-align: right" | <tt style="white-space: nowrap">SVVV VVVV</tt>
| Left channel volume, signed.
|-
! VOL (R)
! $X1
| style="text-align: right" | <tt style="white-space: nowrap">SVVV VVVV</tt>
| Right channel volume, signed.
|-
! P (L)
! $X2
| style="text-align: right" | <tt style="white-space: nowrap">LLLL LLLL</tt>
| Low 8 bits of sample pitch.
|-
! P (H)
! $X3
| style="text-align: right" | <tt style="white-space: nowrap">--HH HHHH</tt>
| High 6 bits of sample pitch.
|-
! SCRN
! $X4
| style="text-align: right" | <tt style="white-space: nowrap">SSSS SSSS</tt>
| Selects a sample source entry from the directory (see DIR below).
|-
! ADSR (1)
! $X5
| style="text-align: right" | <tt style="white-space: nowrap">EDDD AAAA</tt>
| ADSR enable (E), decay rate (D), attack rate (A).
|-
! ADSR (2)
! $X6
| style="text-align: right" | <tt style="white-space: nowrap">LLLR RRRR</tt>
| Sustain level (L), sustain rate (R).
|-
! GAIN
! $X7
| style="text-align: right" | <tt style="white-space: nowrap">0VVV VVVV</tt><br/> <tt style="white-space: nowrap">1MMV VVVV</tt>
| Mode (M), value (V).
|-
! ENVX
! $X8
| style="text-align: right" | <tt style="white-space: nowrap">0VVV VVVV</tt>
| Reads current 7-bit value of ADSR/GAIN envelope.
|-
! OUTX
! $X9
| style="text-align: right" | <tt style="white-space: nowrap">SVVV VVVV</tt>
| Reads signed 8-bit value of current sample wave multiplied by ENVX, before applying VOL.
|}


==== P ====


Sample pitch is a 14-bit value controlling the rate the BRR sound sample will be played back.
{{Anchor|CPUIO}}


Rate: '''P x 32,000 Hz / $1000'''
=== CPUIOx - APU-to-Data register x ($F4 - $F7, write) ===
7  bit  0
---- ----
DDDD DDDD
|||| ||||
++++-++++- Data to CPU


A pitch of $1000 will play back the sample at the SNES native samplerate of 32,000 Hz.


The pitch can go as high as $3FFF, almost two octaves above $1000. Pitches above $1000 will be subject to some aliasing from samples that are skipped over.
=== CPUIOx - Data-from-CPU register x ($F4 - $F7, read) ===
7  bit  0
---- ----
DDDD DDDD
|||| ||||
++++-++++- Data from CPU


The pitch can go all the way down to 0, where it is halted. Pitches below $1000 will be lacking in higher frequencies, and there is not very much precision as the pitch value approaches 0.
These 4 ports allow communication with the SNES CPU. There are 8 stored values, each is a one-way communication written from one side, and readable only from the other side. Each port therefore has two separate one-way values, each seen from only either the SNES CPU or the SPC-700.


==== SCRN ====
If a port is read on the same cycle it is written, an incorrect value will result. For this reason, common practice is to read a port in a loop until the value changes, and then read it once more to ensure the correct value is read. (A single port can be used this way to indicate that a message is ready, and the other 3 ports could be safely read only once with the assumption that the other CPU will not write to them once the ready indication was given.)


This points to an entry in the sample source directory (DIR).
At reset these registers are initialized to $00.
Changing this will not immediately change the voice's sample without a key on (KON), but if a looping sample is playing it can be used to change the loop point without a key on.


==== ADSR ====


This controls an Attack-Decay-Sustain-Release envelope that automatically adjusts the sample's envelope volume (ENVX) over time.
{{Anchor|TxTARGET}}
=== TxTARGET - Timer x target ($FA - $FC, write-only) ===
7  bit  0
---- ----
TTTT TTTT
|||| ||||
++++-++++- Timer target
On power-on: TxTARGET = 0


* '''E''': 1 to enable ADSR envelope, otherwise 0 uses GAIN instead.
When enabled via $F1, the 3 timers will internally count at a rate of 8 KHz (timers 0,1) or 64 KHz (timer 2), and when this interval value has been exceeded, they will increment their external counter result ($FD-FF) and begin again.
* '''A''': Attack speed. $F for instant.
* '''D''': Decay speed, time to decay from full volume to the sustain level after the initial attack.
* '''L''': Sustain level.
* '''R''': Sustain release, speed of decay to 0 after note off.


==== GAIN ====


This register has 5 modes:
{{Anchor|TxOUT}}
=== TxOUT - Timer x output ($FD - $FF, read-only) ===
7  bit  0
---- ----
0000 CCCC
      ||||
      ++++- Timer counter
On power-on: TxOUT = 0
On reset:    TxOUT = 0
On read:    TxOUT = 0


* <tt>0VVV VVVV</tt> sets ENVX directly.
The 4-bit result of the three timers counts up every time the interval is reached.
* <tt>110V VVVV</tt> Linear slide up to 100% volume with rate V.
* <tt>111V VVVV</tt> Bent-line (fast to 75%, then slower to 100%) slide up with rate V.
* <tt>100V VVVV</tt> Linear slide down to 0% volume with rate V.
* <tt>101V VVVV</tt> Exponential slide down to 0% volume with rate V.


=== Global ===
Reading these registers resets each counter to 0 immediately after the read. The upper 4 bits will always read as 0.


Other DSP registers apply globally, rather than to a specific voice.


{| class="wikitable"
== IPL Boot ROM ==
! Name
! Address
! Bits
! Notes
|-
! MVOL (L)
! $0C
| style="text-align: right" | <tt style="white-space: nowrap">SVVV VVVV</tt>
| Left channel main volume, signed.
|-
! MVOL (R)
! $1C
| style="text-align: right" | <tt style="white-space: nowrap">SVVV VVVV</tt>
| Right channel main volume, signed.
|-
! EVOL (L)
! $2C
| style="text-align: right" | <tt style="white-space: nowrap">SVVV VVVV</tt>
| Left channel echo volume, signed.
|-
! EVOL (R)
! $3C
| style="text-align: right" | <tt style="white-space: nowrap">SVVV VVVV</tt>
| Right channel main volume, signed.
|-
! KON
! $4C
| style="text-align: right" | <tt style="white-space: nowrap">7654 3210</tt>
| Key on. Writing this with any bit set will start a new note for the corresponding voice.
|-
! KOF
! $5C
| style="text-align: right" | <tt style="white-space: nowrap">7654 3210</tt>
| Key off. Writing this with any bit set will put the corresponding voice into its release state.
|-
! FLG
! $6C
| style="text-align: right" | <tt style="white-space: nowrap">RMEN NNNN</tt>
| Flags: soft reset (R), mute all (M), echo disable (E), noise frequency (N).
|-
! ENDX
! $7C
| style="text-align: right" | <tt style="white-space: nowrap">7654 3210</tt>
| Read for end of sample flag for each channel.
|-
! EFB
! $0D
| style="text-align: right" | <tt style="white-space: nowrap">SVVV VVVV</tt>
| Echo feedback, signed.
|-
! -
! $1D
| style="text-align: right" | <tt style="white-space: nowrap">---- ----</tt>
| Unused.
|-
! PMON
! $2D
| style="text-align: right" | <tt style="white-space: nowrap">7654 321-</tt>
| Enables pitch modulation for each channel, controlled by OUTX of the next lower channel.
|-
! NON
! $3D
| style="text-align: right" | <tt style="white-space: nowrap">7654 3210</tt>
| For each channel, replaces the sample waveform with the noise generator output.
|-
! EON
! $4D
| style="text-align: right" | <tt style="white-space: nowrap">7654 3210</tt>
| For each channel, sends to the echo unit.
|-
! DIR
! $5D
| style="text-align: right" | <tt style="white-space: nowrap">DDDD DDDD</tt>
| Pointer to the sample source directory page at $DD00.
|-
! ESA
! $6D
| style="text-align: right" | <tt style="white-space: nowrap">EEEE EEEE</tt>
| Pointer to the start of the echo memory region at $EE00.
|-
! EDL
! $7D
| style="text-align: right" | <tt style="white-space: nowrap">---- DDDD</tt>
| Echo delay time (D).
|-
! C0
! $0F
| style="text-align: right" | <tt style="white-space: nowrap">SVVV VVVV</tt>
| Echo filter coefficient.
|-
! C1
! $1F
| style="text-align: right" | <tt style="white-space: nowrap">SVVV VVVV</tt>
| Echo filter coefficient.
|-
! C2
! $2F
| style="text-align: right" | <tt style="white-space: nowrap">SVVV VVVV</tt>
| Echo filter coefficient.
|-
! C3
! $3F
| style="text-align: right" | <tt style="white-space: nowrap">SVVV VVVV</tt>
| Echo filter coefficient.
|-
! C4
! $4F
| style="text-align: right" | <tt style="white-space: nowrap">SVVV VVVV</tt>
| Echo filter coefficient.
|-
! C5
! $5F
| style="text-align: right" | <tt style="white-space: nowrap">SVVV VVVV</tt>
| Echo filter coefficient.
|-
! C6
! $6F
| style="text-align: right" | <tt style="white-space: nowrap">SVVV VVVV</tt>
| Echo filter coefficient.
|-
! C7
! $7F
| style="text-align: right" | <tt style="white-space: nowrap">SVVV VVVV</tt>
| Echo filter coefficient.
|}


==== KON ====
'''See: [[Booting the SPC700]]'''


This immediately starts the sample from its beginning, as designated by SCRN. If ADSR is enabled, its envelope will also start from the beginning.
The IPL Boot ROM is a small built-in program responsible for initializing the SPC-700, and making it ready to transfer a program from the SNES CPU, then execute it. It normally resides at $FFC0, with its code beginning at this address, but if desired it can be unmapped using the $F1 control register, and replaced with the underlying RAM.


==== FLG ====
When the SNES is reset, the SPC-700 will also reset and begin executing the IPL.


* '''R''': soft reset prevents KON and mutes all voices.
IPL might stand for "Initial Program Load".
* '''M''': mutes all voices.
* '''E''': set to 1 to disable echo, if 0 the echo unit will actively overwrite memory in the echo region (ESA). Do not write 0 to this bit unless ESA/EDL have been prepared.
* '''N''': sets the noise generator frequency.


==== ENDX ====
The high level process of the IPL is described below:


Each bit will read as set once a voice has finished playing a BRR sample block with the Source End flag set.
# '''Reset''': Stack pointer = $EF. Zero-page from $00-$EF is set to $00. (Note: this leaves the top 16-bytes of the stack page unused by default.)
Writing any value to this register will reset all the bits to 0, otherwise they remain set until the voice receives a new note on (KON).
# '''Signal ready:''' Port 0 = $AA. Port 1 = $BB.
# '''Wait for signal:''' Loop until $CC is read from port 0.
# '''Read address:''' Read a 2 byte address from port 2 (low) and 3 (high).
# '''Acknowledge:''' Read value from port 0 and write it to port 0, confirming the signal was received.
# '''Begin:''' Read value from port 1, if 0 begin executing code at address read in '''step 4''', otherwise begin reading data ('''step 7''').
# '''Begin Transfer:''' Loop until read port 0 reads 0. Set 8-bit counter to 0, then proceed to '''step 8'''.
# '''Transfer Loop:'''
#* Read a byte from port 1 and write to the destination address.
#* Write the value read from port 0 to port 0 to acknowledge receipt of the byte.
#* Increment the destination address, and increment the 8-bit counter.
#* Wait until port 0 reads equal to the new counter (SNES will increment its own counter and send it to port 0 to signal the next byte), and repeat '''step 8''', otherwise...
#* If port 0 reads greater than the new counter (i.e. SNES increments by 2 or more before writing port 0): write back port 0 to acknowledge, transfer ends and return to '''step 4'''.


== Instruction Set ==
On the SNES side, to load your program into the SPC:


Official instruction names and syntax for SPC-700 instruction were provided by Sony. However, because of its architectural similarity to 6502, some prefer to rename and remap them using a 6502 style syntax. Both are provided here.
# Wait for the ready signal: port 0 = $AA, port 1 = $BB (IPL 2).
# Write the first destination address to ports 2+3, write any non-zero value to port 1, then write $CC to port 0 to begin (IPL 3).
# Wait for port 0 to read back $CC (IPL 5).
# Set an 8-bit counter to $00. Write the first byte of data to port 1, then write the counter value ($00) to port 0 (IPL 7). Read port 0 until it is equal to the counter $00.
# For each byte of data: write the data to port 1, increment the 8-bit counter and write it to port 0, then read port 0 until is becomes equal to the counter. Repeat until finished. (IPL 8)
# After the last byte is written, write the next destination address to ports 2+3, write $00 to port 1, then increment your counter twice and write it to port 0. (IPL 4)
# The SPC-700 will begin executing code at the destination address now.


{| class="wikitable sortable"
Most often only one data transfer is necessary, but by writing a non-zero value to port 1 in SNES '''step 6''', we can instead initiate another transfer at the new address.
|+ SPC-700 Instruction Set
When doing this, if your counter is 0 after incrementing twice, increment it a third time to be non-zero before writing it to port 0. This is because a value of 0 in port 0 will also signal the first byte of the transfer in the next step.
|-
! Instruction
! 6502-Style
! Opcode
! Bytes
! Cycles
! Flags
! Notes
|-
| colspan="7" | TODO
|}


== IPL Boot ROM ==
It is most common to place the data program at $0200, just above the stack page, and start execution from there, but this is not a requirement.
TODO


== BRR Samples ==
IPL loading takes about 520 master clocks per byte transferred. This allows about 650 bytes in a 60hz frame, if the CPU is dedicated to this activity.
TODO (See [[#Links|Links]] section below.)


== See Also ==
== See Also ==


* [[SPC-700 instruction set]]
* [[S-DSP registers]]
* [[DSP envelopes]]
* [[BRR samples]]
* [[Booting the SPC700]] - Guide for setting up the SPC program after reset.
* [[Booting the SPC700]] - Guide for setting up the SPC program after reset.
* [[Tools]] - Lists tools for building SPC700 code.
* [[Tools]] - Lists tools for building SPC700 code.
Line 429: Line 290:
* [http://snesmusic.org/files/spc700_documentation.html SPC 700 Documentation] - Article by Gau.
* [http://snesmusic.org/files/spc700_documentation.html SPC 700 Documentation] - Article by Gau.
* [https://wiki.superfamicom.org/spc700-reference SPC700 Reference] - Superfamicom.org wiki article.
* [https://wiki.superfamicom.org/spc700-reference SPC700 Reference] - Superfamicom.org wiki article.
* [https://wiki.superfamicom.org/bit-rate-reduction-(brr) Bit Rate Reduction] - Superfamicom.org wiki article, documents BRR sample format.
* [https://wiki.superfamicom.org/how-to-write-to-dsp-registers-without-any-spc-700-code How to Write to DSP Registers Without any SPC-700 Code] - Superfamicom.org wiki, demonstrating that the DSP can be written directly through the IPL.
* [http://problemkaputt.de/fullsnes.htm#snesapudspbrrsamples SNES APU DSP BRR Samples] - Fullsnes documentation of BRR sample format.
 
[[Category:Sound]]

Latest revision as of 22:20, 15 November 2024

The SHVC-SOUND module of the SNES includes several components:[1]

  • S-SMP: Sony sub CPU
  • S-DSP: Sony sound chip (see S-DSP registers)
    • Digital signal processor that generates the sound data
    • 8 voice channels
    • Decodes BRR samples at a variable sample rate using 4-point Gaussian interpolation
    • FIR filtered echo buffer
    • Manages the clock of the S-DSP, S-SMP and DAC
      • Clocked by a 24.576MHz ceramic resonator
      • Generates 1 stereo sample every 768 resonator cycles
      • Internally clocked at 3.072MHz
    • Bus Arbiter for the Audio-RAM. The Audio-RAM is time-shared between the S-SMP and S-DSP, with 1 S-SMP memory access for every 2nd S-DSP memory access.
  • Audio-RAM: 64KiB RAM from two 32K x 8bit PSRAM chips. (Also known as ARAM.)
  • µPD6376 16-bit stereo DAC
    • Digital to analog converter, outputting the analog audio signal from the DSP's stereo 16-bit 32000 Hz digital audio
  • Stereo Amplifier
    • Mixes DAC output with the Cartridge connector analog audio input and the EXT connector analog audio input
    • The amplifier can be disabled by the S-SMP's /MUTE pin (bit 6 of the S-DSP_registers#FLG S-DSP register)
    • The output of the stereo amplifier is mixed into a mono output for the RF modulator and EXT connector


The SPC-700 is an 8-bit CPU that is almost like an extended MOS-6502.

The SPC-700 driven by a 1.024 MHz clock, though the SPC-700 instruction timing is very similar to a 6502 in that each instruction takes at least 2 cycles. The exact clock rate is independent from the rest of the SNES, and may drift slightly with temperature. The nominal 32000 Hz sample rate is actually 32 clocks per sample.

Related reference:

The term SPC is also used to describe a SPC file format (.SPC) for storing SNES music. The S-DSP is not to be confused with the DSP-1 cartridge expansion hardware. The term S-SMP is often contrasted with S-CPU when describing communication with the SNES main CPU.

Memory Layout

64 kilobytes of RAM are mapped across the 16-bit memory space of the SPC-700. Some regions of this space are overlaid with special hardware functions.

Range Note
$0000-00EF Zero Page RAM
$00F0-00FF Sound CPU Registers
$0100-01FF Stack Page RAM
$0200-FFBF RAM
$FFC0-FFFF IPL ROM or RAM

The region at $FFC0-FFFF will normally read from the 64-byte IPL ROM, but the underlying RAM can always be written to, and the high bit of the Control register $F1 can be cleared to unmap the IPL ROM and allow read access to this RAM.

Registers

Aside from the SPC-700 CPU registers (see: SPC-700 instruction set), there are a collection of memory-mapped registers in the last 16 bytes of the zero-page.

S-SMP register summary
Name Address Bits Type Notes
TEST Test $F0 IIEE TRWH W8 Undocumented test register.
CONTROL Control $F1 I.CC .210 W8 Enable IPL ROM (I), Clear data ports (C), timer enable (2,1,0).
DSPADDR Register Address $F2 RAAA AAAA RW8 Selects a DSP register address.
DSPDATA Register Data $F3 DDDD DDDD RW8 Reads or writes data to the selected DSP address.
CPUIO0 Port 0 $F4 DDDD DDDD RW8 Reads or writes data to APUIO0.
CPUIO1 Port 1 $F5 DDDD DDDD RW8 Reads or writes data to APUIO1.
CPUIO2 Port 2 $F6 DDDD DDDD RW8 Reads or writes data to APUIO2.
CPUIO3 Port 3 $F7 DDDD DDDD RW8 Reads or writes data to APUIO3.
--- $F8 .... .... RW8 Unused (normal RAM).
--- $F9 .... .... RW8 Unused (normal RAM).
T0TARGET Timer 0 $FA TTTT TTTT W8 8KHz timer 0 interval.
T1TARGET Timer 1 $FB TTTT TTTT W8 8KHz timer 1 interval.
T2TARGET Timer 2 $FC TTTT TTTT W8 64KHz timer 2 interval.
T0OUT Counter 0 $FD 0000 CCCC R8 Timer 0 count-up.
T1OUT Counter 1 $FE 0000 CCCC R8 Timer 1 count-up.
T2OUT Counter 2 $FF 0000 CCCC R8 Timer 2 count-up.
(table source)

Write-only registers will read back as $00.


TEST - Undocumented test register ($F0, write-only)

7  bit  0
---- ----
IIEE TRWH
|||| ||||
|||| |||+- Halt timers
|||| ||+-- RAM writable
|||| |+--- Disable RAM reads
|||| +---- Enable timers
||++------ External wait state
++-------- Internal wait state

On power-on: TEST = $0A


DO NOT write to this register!!!

  • Setting any of the wait state bits will slow the clock speed of the SPC-700 processor.
  • Changing the wait state bits can cause crashes on real hardware.[2]
  • The TEST register can disable Audio-RAM reads and/or writes.
  • The TEST register can disable the timers.


This undocumented register responds to writes only when the P flag is clear.


CONTROL - Control register ($F1, write-only)

7  bit  0
---- ----
I.CC .210
| ||  |||
| ||  ||+- Enable timer 0
| ||  |+-- Enable timer 1
| ||  +--- Enable timer 2
| |+------ Clear CPUIO read ports 0 & 1
| +------- Clear CPUIO read ports 2 & 3
+--------- IPL ROM enable

On power-on: CONTROL = $B0
On reset:    CONTROL = $B0


This provides a way for the SPC-700 to reset the read ports ($F4-F7) without the SNES CPU having to write them externally. It also starts and stops the 3 timers.

  • 0/1/2 (bits 0-2) - Enables each of the 3 timers.
    • A transition from clear to set (0 -> 1) will reset the timer's internal counter and TxOUT to 0.
  • C (bit 4) - If set the CPUIO0 and CPUIO1 Data-from-CPU read registers ($F4, $F5) are reset to $00.
    • CPUIOx Data-from-CPU is cleared on any CONTROL write with a clear bit set.
    • CPUIOx is only cleared on CONTROL writes. Future APUIO writes to the APU will not be changed.
    • The 65816 S-CPU APUIOn Data-from-APU registers will not be changed.
  • C (bit 5) - If set the CPUIO2 and CPUIO3 Data-from-CPU read registers ($F6, $F7) are reset to $00.
  • I (bit 7) - Enables the IPL ROM if set.
    • This does not disable Audio-RAM writes to the IPL ROM memory addresses.


At reset this register is initialized as if $80 was written to it.

The function of bit 7 enabling the IPL ROM is not documented in the SNES Development Manual.


DSPADDR - DSP register address ($F2)

7  bit  0
---- ----
RAAA AAAA
|||| ||||
|+++-++++- S-DSP register address
+--------- Read only flag

Write $F2 to select a DSP register, then a value can be read or written to that DSP register via $F3.

  • Writing $F2 with the high bit set will select a DSP register according to the lower 7 bits, but it will be read-only.
  • The high bit of $F2 will always read back as 0.

See: Reading and writing S-DSP registers and S-DSP registers


DSPDATA - DSP register data ($F3)

7  bit  0
---- ----
DDDD DDDD
|||| ||||
++++-++++- S-DSP register data

On write: if DSPADDR bit 7 clear: write to S-DSP address DSPADDR

On read: read from S-DSP register address DSPADDR

A DSP register can be selected with DSPADDR ($F2), after which it can be read or written at DSPDATA ($F3). Often it is useful to load the register address into A, and the value to send in Y, so that MOV $F2, YA can be used to do both in one 16-bit instruction.

The DSP register address space only has 7 bits. The high bit of DSPADDR ($F2), if set, will make the selected register read-only via DSPDATA ($F3).

When initializing the DSP registers for the first time, take care not to accidentally enable echo writeback via FLG, because it will immediately begin overwriting values in RAM.

See: Reading and writing S-DSP registers and S-DSP registers


CPUIOx - APU-to-Data register x ($F4 - $F7, write)

7  bit  0
---- ----
DDDD DDDD
|||| ||||
++++-++++- Data to CPU


CPUIOx - Data-from-CPU register x ($F4 - $F7, read)

7  bit  0
---- ----
DDDD DDDD
|||| ||||
++++-++++- Data from CPU

These 4 ports allow communication with the SNES CPU. There are 8 stored values, each is a one-way communication written from one side, and readable only from the other side. Each port therefore has two separate one-way values, each seen from only either the SNES CPU or the SPC-700.

If a port is read on the same cycle it is written, an incorrect value will result. For this reason, common practice is to read a port in a loop until the value changes, and then read it once more to ensure the correct value is read. (A single port can be used this way to indicate that a message is ready, and the other 3 ports could be safely read only once with the assumption that the other CPU will not write to them once the ready indication was given.)

At reset these registers are initialized to $00.


TxTARGET - Timer x target ($FA - $FC, write-only)

7  bit  0
---- ----
TTTT TTTT
|||| ||||
++++-++++- Timer target

On power-on: TxTARGET = 0

When enabled via $F1, the 3 timers will internally count at a rate of 8 KHz (timers 0,1) or 64 KHz (timer 2), and when this interval value has been exceeded, they will increment their external counter result ($FD-FF) and begin again.


TxOUT - Timer x output ($FD - $FF, read-only)

7  bit  0
---- ----
0000 CCCC
     ||||
     ++++- Timer counter

On power-on: TxOUT = 0
On reset:    TxOUT = 0
On read:     TxOUT = 0

The 4-bit result of the three timers counts up every time the interval is reached.

Reading these registers resets each counter to 0 immediately after the read. The upper 4 bits will always read as 0.


IPL Boot ROM

See: Booting the SPC700

The IPL Boot ROM is a small built-in program responsible for initializing the SPC-700, and making it ready to transfer a program from the SNES CPU, then execute it. It normally resides at $FFC0, with its code beginning at this address, but if desired it can be unmapped using the $F1 control register, and replaced with the underlying RAM.

When the SNES is reset, the SPC-700 will also reset and begin executing the IPL.

IPL might stand for "Initial Program Load".

The high level process of the IPL is described below:

  1. Reset: Stack pointer = $EF. Zero-page from $00-$EF is set to $00. (Note: this leaves the top 16-bytes of the stack page unused by default.)
  2. Signal ready: Port 0 = $AA. Port 1 = $BB.
  3. Wait for signal: Loop until $CC is read from port 0.
  4. Read address: Read a 2 byte address from port 2 (low) and 3 (high).
  5. Acknowledge: Read value from port 0 and write it to port 0, confirming the signal was received.
  6. Begin: Read value from port 1, if 0 begin executing code at address read in step 4, otherwise begin reading data (step 7).
  7. Begin Transfer: Loop until read port 0 reads 0. Set 8-bit counter to 0, then proceed to step 8.
  8. Transfer Loop:
    • Read a byte from port 1 and write to the destination address.
    • Write the value read from port 0 to port 0 to acknowledge receipt of the byte.
    • Increment the destination address, and increment the 8-bit counter.
    • Wait until port 0 reads equal to the new counter (SNES will increment its own counter and send it to port 0 to signal the next byte), and repeat step 8, otherwise...
    • If port 0 reads greater than the new counter (i.e. SNES increments by 2 or more before writing port 0): write back port 0 to acknowledge, transfer ends and return to step 4.

On the SNES side, to load your program into the SPC:

  1. Wait for the ready signal: port 0 = $AA, port 1 = $BB (IPL 2).
  2. Write the first destination address to ports 2+3, write any non-zero value to port 1, then write $CC to port 0 to begin (IPL 3).
  3. Wait for port 0 to read back $CC (IPL 5).
  4. Set an 8-bit counter to $00. Write the first byte of data to port 1, then write the counter value ($00) to port 0 (IPL 7). Read port 0 until it is equal to the counter $00.
  5. For each byte of data: write the data to port 1, increment the 8-bit counter and write it to port 0, then read port 0 until is becomes equal to the counter. Repeat until finished. (IPL 8)
  6. After the last byte is written, write the next destination address to ports 2+3, write $00 to port 1, then increment your counter twice and write it to port 0. (IPL 4)
  7. The SPC-700 will begin executing code at the destination address now.

Most often only one data transfer is necessary, but by writing a non-zero value to port 1 in SNES step 6, we can instead initiate another transfer at the new address. When doing this, if your counter is 0 after incrementing twice, increment it a third time to be non-zero before writing it to port 0. This is because a value of 0 in port 0 will also signal the first byte of the transfer in the next step.

It is most common to place the data program at $0200, just above the stack page, and start execution from there, but this is not a requirement.

IPL loading takes about 520 master clocks per byte transferred. This allows about 650 bytes in a 60hz frame, if the CPU is dedicated to this activity.

See Also

Links

  1. Super Nintendo (NTSC) Revision 2 Motherboard schematic by Jonathon W. Donaldson
  2. ares source code, ares/sfc/smp/timing.cpp, by Near