Initial import of Secret of Mana MSU-1

Author: mlarouche

README.txt

@@ -0,0 +1,59 @@
+Secret of Mana (U) MSU-1
+Version 1.0
+by DarkShock
+
+This hack adds CD quality audio to Secret of Mana (U) using the MSU-1 chip invented by byuu.
+The hack has been tested on SD2SNES, BSNES 075 and higan 094. The patched ROM needs to be named som_msu1.sfc.
+
+===============
+= Using BSNES =
+===============
+1. Patch the ROM
+2. Generate the .pcm
+3. Launch the game
+
+===============
+= Using higan =
+===============
+1. Patch the ROM
+2. Launch it using higan
+3. Go to %USERPROFILE%\Emulation\Super Famicom\topgear2s_msu1.sfc in Windows Explorer.
+4. Copy manifest.bml and the .pcm file there
+5. Run the game
+
+====================
+= Using on SD2SNES =
+====================
+Drop the ROM file, topgear2_msu1.msu and the .pcm files in any folder. (I really suggest creating a folder)
+Launch the game and voil�, enjoy !
+
+===========
+= Credits =
+===========
+* DarkShock - ASM hacking & coding, Music editing
+* David Thomas - Music compilation
+
+=========
+= Music =
+=========
+
+
+=============
+= Compiling =
+=============
+Source is availabe on GitHub: https://github.com/mlarouche/SecretOfMana-MSU1
+
+To compile the hack you need
+
+* bass v14 (https://web.archive.org/web/20140710190910/http://byuu.org/files/bass_v14.tar.xz)
+* wav2msu (https://github.com/mlarouche/wav2msu)
+
+To distribute the hack you need
+
+* uCON64 (http://ucon64.sourceforge.net/)
+* 7-Zip (http://www.7-zip.org/)
+
+make.bat assemble the patch
+create_pcm.bat create the .pcm from the WAV files
+distribute.bat distribute the patch
+make_all.bat does everything

create_pcm.bat

@@ -0,0 +1,5 @@
+@ECHO OFF
+
+del *.pcm
+
+wav2msu -o som_msu1-1.pcm som_01_angel_fear.wav

distribute.bat

@@ -0,0 +1,19 @@
+@ECHO OFF
+
+del /q SecretOfMana_MSU1.zip
+del /q SecretOfMana_MSU1_Music.7z
+
+mkdir SecretOfMana_MSU1
+ucon64 -q --snes --chk som_msu1.sfc
+ucon64 -q --mki=topgear2_original.sfc som_msu1.sfc
+copy som_msu1.ips SecretOfMana_MSU1
+copy README.txt SecretOfMana_MSU1
+copy som_msu1.msu SecretOfMana_MSU1
+copy som_msu1.xml SecretOfMana_MSU1
+copy manifest.bml SecretOfMana_MSU1
+"C:\Program Files\7-Zip\7z" a -r SecretOfMana_MSU1.zip SecretOfMana_MSU1
+
+"C:\Program Files\7-Zip\7z" a SecretOfMana_MSU1_Music.7z *.pcm
+
+del /q som_msu1.ips
+rmdir /s /q SecretOfMana_MSU1

make.bat

@@ -0,0 +1,9 @@
+@ECHO OFF
+del som_msu1.sfc
+
+copy som_original.sfc som_msu1.sfc
+
+set BASS_ARG=
+if "%~1" == "emu" set BASS_ARG=-d EMULATOR_VOLUME
+
+bass %BASS_ARG% -o som_msu1.sfc secret_of_mana_msu1.asm

make_all.bat

@@ -0,0 +1,3 @@
+@ECHO OFF
+
+make && create_pcm && distribute

secret_of_mana_msu1.asm

@@ -0,0 +1,38 @@
+arch snes.cpu
+
+// MSU memory map I/O
+constant MSU_STATUS($2000)
+constant MSU_ID($2002)
+constant MSU_AUDIO_TRACK_LO($2004)
+constant MSU_AUDIO_TRACK_HI($2005)
+constant MSU_AUDIO_VOLUME($2006)
+constant MSU_AUDIO_CONTROL($2007)
+
+// SPC communication ports
+constant SPC_COMM_0($2140)
+constant SPC_COMM_1($2141)
+constant SPC_COMM_2($2142)
+constant SPC_COMM_3($2143)
+
+// MSU_STATUS possible values
+constant MSU_STATUS_TRACK_MISSING($8)
+constant MSU_STATUS_AUDIO_PLAYING(%00010000)
+constant MSU_STATUS_AUDIO_REPEAT(%00100000)
+constant MSU_STATUS_AUDIO_BUSY($40)
+constant MSU_STATUS_DATA_BUSY(%10000000)
+
+// Constants
+if {defined EMULATOR_VOLUME} {
+	constant FULL_VOLUME($60)
+} else {
+	constant FULL_VOLUME($FF)
+}
+
+// **********
+// * Macros *
+// **********
+// seek converts SNES HiROM address to physical address
+macro seek(variable offset) {
+  origin (offset & $3FFFFF)
+  base offset
+}