Editing PS1 Emulation

== Description ==
Note: there are no PS1 emulators available in early Tool/DECR and Debug/DEX firmwares (does not have dev_flash/ps1emu or ps2emu folder. dev_flash/vsh/etc/version.txt & index.dat say: ¨ps1emu:NA@NA: ps2emu:NA@NA: ps2gxemu:NA@NA: emerald:NA@NA: bdp:NA@NA:¨).

{{Boxframe1|content='''Firmware changes related with PS1 emulation'''
*Firmware [[1.02_CEX|1.02]]:
**Added '''ps1_emu.self'''

*Firmware [[1.70_CEX|1.70]]:
**Added '''ps1_netemu.self'''
**Added the ability to play original PlayStation format games downloaded from the PlayStation Store.
**Added rumble functionality for USB accessories which support it when playing PS2 games.
**Saved data from PlayStation format software now usable on both PSP and PS3 systems.
**Backwards compatibility for PS1 and PS2 games was improved.

*Firmware [[1.80_CEX|1.80]]:
**Ability to upscale PS1 and PS2 games
**Ability to copy PS1/PS2 game saves from PS3 to Memory Cards using a Memory Card adapter.
**Backwards compatibility for PS1 and PS2 games was improved.

*Firmware [[2.10_CEX|2.10]]:
**Added '''ps1_newemu.self'''
**Added '''ps1_rom.bin'''
**Users can now play PS1 game discs on a PSP with remote play, PSP firmware version 3.50 or newer is required. (this feature was not announced).
**Backwards compatibility for PS1 and PS2 games was improved (Update was also unannounced but evident in Sony's backwards compatibility search site).
**Note: since 2.10++ all PS1 emulators, ps1_emu.self, ps1_netemu.self, ps1_newemu.self uses the since then added ps1_rom.bin bios file. In earlier firmwares file was embed into every emulator self file. File '''ps1_rom.bin''' is exactly the same file that was previously embed in all PS1 emulators.

*Firmware [[4.00_CEX|4.00]]
**Updated '''ps1_rom.bin'''. The new rom is stripped from PS2 related functions. As a result is 3565296 bytes smaller than previous version.
}}

== Files ==

=== Emulator versions ===
There is no accurate info in wiki about the different PS1 emulator .self revisions, if you want to collaborate documenting this info see the experimental table on {{talk}} page

=== Game formats ===
See: [[PSISOIMG0000]] and [[Iso.bin.edat]]

=== Savegames ===
*Location: /dev_hdd0/savedata/vmc
Note: capitalisation of filename is important: name it xxx.VM1 instead of xxxx.vm1 (e.g. Internal Memory Card.VM1 for PSX/PSone, Internal Memory Card.VM2 for PS2/PStwo)

The .VMx files appear to be raw memory card data:
* [[PS1_Savedata#Virtual_Memory_Card_PS1_.28.VM1.29 | .VM1 Playstation 1 Memory cards]] can be edited with [[PS1_Savedata#Memory_Card_Tools_PS1 | MemcardRex]]
* [[PS2_Savedata#Virtual_Memory_Card_PS2_.28.VM2.29 | .VM2 Playstation 2 Memory cards]] can be edited with [http://www.csclub.uwaterloo.ca:11068/mymc/ mymc]

== Arguments ==

=== ps1_emu.self ===

{| class="wikitable"
|+ps1_emu.self arguments
! 7 arguments !! Name !! Example !! Notes
|-
| argv[0] || self starting location || dev_flash/ps1emu/ps1_emu.self ||
|-
| argv[1] || VM1-1 location || dev_hdd0/savedata/vmc/filename1.VM1 ||
|-
| argv[2] || VM1-2 location || dev_hdd0/savedata/vmc/filename2.VM1 ||
|-
| argv[3] || Regionnumber/TargetID || 0082 ||
|-
| argv[4] || unknown || 1200 || <!-- Screen Resolution... related ? -->
|-
| argv[5] || unknown || 1 || '''[[XRegistry.sys]]/setting/game/emuUpConvert''' ? (full/normal/off = 2/1/0)
|-
| argv[6] || unknown || 0 || '''[[XRegistry.sys]]/setting/game/emuSmoothing''' ? (on/off = 1/0)
|-
|}

=== ps1_netemu.self ===

{| class="wikitable"
|+ps1_netemu.self arguments
! 7 arguments !! Name !! Example !! Notes
|-
| argv[0] || self starting location || dev_flash/ps1emu/ps1_netemu.self ||
|-
| argv[1] || ISO.BIN.EDAT location || ||
|-
| argv[2] || unknown || ||
|-
| argv[3] || unknown || ||
|-
| argv[4] || unknown || ||
|-
| argv[5] || unknown || ||
|-
| argv[6] || unknown || ||
|-
|}

=== ps1_newemu.self ===

{| class="wikitable"
|+ps1_newemu.self arguments
! 9 arguments !! Name !! Example !! Notes
|-
| argv[0] || self starting location || dev_flash/ps1emu/ps1_newemu.self ||
|-
| argv[1] || VM1-1 name || (dev_hdd0/savedata/vmc/)argv[1] ||
|-
| argv[2] || VM1-2 name || (dev_hdd0/savedata/vmc/)argv[2] ||
|-
| argv[3] || Regionnumber/TargetID || 0082 ||
|-
| argv[4] || unknown || 600 ||
|-
| argv[5] || path to ps1 game || /dev_hdd0/game/NPUJ01324 ||
|-
| argv[6] || unknown || 1 ||
|-
| argv[7] || unknown || 2 ||
|-
| argv[8] || unknown || 2 ||
|-
|}

==PS1 emulators workload comparison==

All emulators seems to use similar workload. Note that SPU 0-4 don't use JOB name per se, so is just info what they do.

{| border="1" cellspacing="0" cellpadding="5" border="#999" class="wikitable" style="border:1px solid #999; border-collapse: collapse;" 
! colspan="4" | ps1_emu
|-
! Core !! Job !! Source !! Notes
|-
| SPU0 || PS1 GPU SLI0 || SPU ASM || PS1 GPU software emulation
|-
| SPU1 || PS1 GPU SLI1 || SPU ASM || PS1 GPU software emulation
|-
| SPU2 || PS1 GPU SLI2 || SPU ASM || PS1 GPU software emulation
|-
| SPU3 || PS1 GPU SLI3 || SPU ASM || PS1 GPU software emulation
|-
| SPU4 || PS1 SPU || SPU ASM || PS1 SPU software emulation
|-
| SPU5 || _libadec_at3CellSpursKernel0  || SPU ASM || AT library from ps3 firmware
|-
| SPU6 || Isolation || C++ Raw SPU || Not PS1 emu specific
|-{{cellcolors|lightgrey}}
| SPU7 || - || - || Unavailable: Factory disabled SPU
|-
| PPU:0 || ? || ? ||
|-
| PPU:1 || ? || ? ||
|-
! colspan="4" | ps1_netemu
|-
! Core !! Job !! Source !! Notes
|-
| SPU0 || PS1 GPU SLI0 || SPU ASM || PS1 GPU software emulation
|-
| SPU1 || PS1 GPU SLI1 || SPU ASM || PS1 GPU software emulation
|-
| SPU2 || PS1 GPU SLI2 || SPU ASM || PS1 GPU software emulation
|-
| SPU3 || PS1 GPU SLI3 || SPU ASM || PS1 GPU software emulation
|-
| SPU4 || PS1 SPU || SPU ASM || PS1 SPU software emulation
|-
| SPU5 || _libadec_at3CellSpursKernel0  || SPU ASM || AT3 library from ps3 firmware
|-
| SPU6 || Isolation || C++ Raw SPU || Not PS1 emu specific
|-{{cellcolors|lightgrey}}
| SPU7 || - || - || Unavailable: Factory disabled SPU
|-
| PPU:0 || ? || ? ||
|-
| PPU:1 || ? || ? ||
|-
! colspan="4" | ps1_newemu
|-
! Core !! Job !! Source !! Notes
|-
| SPU0 || PS1 GPU SLI0 || SPU ASM || PS1 GPU software emulation
|-
| SPU1 || PS1 GPU SLI1 || SPU ASM || PS1 GPU software emulation
|-
| SPU2 || PS1 GPU SLI2 || SPU ASM || PS1 GPU software emulation
|-
| SPU3 || PS1 GPU SLI3 || SPU ASM || PS1 GPU software emulation
|-
| SPU4 || PS1 SPU || SPU ASM || PS1 SPU software emulation
|-
| SPU5 || _libadec_at3CellSpursKernel0  || SPU ASM || AT3 library from ps3 firmware
|-
| SPU6 || Isolation || C++ Raw SPU || Not PS1 emu specific
|-{{cellcolors|lightgrey}}
| SPU7 || - || - || Unavailable: Factory disabled SPU
|-
| PPU:0 || ? || ? ||
|-
| PPU:1 || ? || ? ||
|-
|}

==PS1 GPU emulation==

That part of all 3 emulators is quite impressive. Task is split between 4 SPE cores, but not in usual way.
Every core is responsible for different part of PS1 GPU command flow, which is done dynamically. All that is linked by so called sli (spu link?), and all SPE cores run exactly same elf file.
SPE program synchronize using sliTick, and sliTock functions with use of channels 16 - 24, and with help of PPU.
That way 4 different PS1 GPU emulators can proceed 4 different PS1 GPU commands at the same time, with synchronization enough to not override other PS1 GPU tasks.
As a example you can remove dithering by patch only on SPU0, and observe that only 1/4 of displayed lines will be missing dither pattern. 

==Game settings==

===Game settings hardcoded in PS1 emulators===
*Notes
**The value named "flags" is composed by 2 values unk1[4], unk2[4], located at a second depth level of  hierarchy structure. unk1[4] '''varies''' in between different ps1 emu versions (this variation indicates that <abbr title="but mostly a counter that could indicate a command ID indirectly from the "slot number" of another table>'''is not a command ID'''</abbr>), and unk2[4] have different purposes, sometimes contains a final value (so it represents the ending of a fork of the hierarchy) or an offset (to move one level deeper in the hierarchy), if the value is an offset also '''varies''' in between different ps1 emu versions
**Checksum is simple Adler32 calculated from 2048 bytes of disc data, starting from 0x9318 offset in raw image. Emulator perform check if that sector have CD001 string, if string is missing "unknown" string is used, and hash calculation is not performed. You can use tools like hashtab to easily calculate checksum for new game. 

<div class="mw-collapsible mw-collapsed" style="background:#ffb0b0; margin:5px 0px">'''TitleID settings hardcoded in ps1_emu.self'''
<div class="mw-collapsible-content" style="text-align:left">{{TitleID settings hardcoded in ps1_emu.self}}
</div></div>{{clear}}

{{TitleID settings hardcoded in ps1_netemu.self}}

<div class="mw-collapsible mw-collapsed" style="background:#b0b0ff; margin:5px 0px">'''TitleID settings hardcoded in ps1_newemu.self'''
<div class="mw-collapsible-content" style="text-align:left;">{{TitleID settings hardcoded in ps1_newemu.self}}
</div></div>{{clear}}

=== CONFIG ===
Created/loaded by ps1_newemu.self and ps1_netemu.self, at path: /USRDIR/CONFIG

Content: 
<pre>
00000000 1C 00 00 00 50 53 31 45 6D 75 43 6F 6E 66 69 67 ....PS1EmuConfig
00000010 46 69 6C 65 00 97 0A 54 04 00 00 00 01 00 00 00 File...T........
00000020 0F D4 CC B9 10 00 00 00 64 69 73 63 5F 6E 6F 00 ........disc_no.
00000030 04 00 00 00 00 00 00 00 93 D1 5B F8             ..........[.    
</pre>

{| class="wikitable"
|-
! Offset !! size !! data !! notes
|-{{cellcolors|lightgrey}}
| 0x00 || 0x04 || 1C 00 00 00 || size of the next 4 values
|-
| 0x04 || 0x10 || '''PS1EmuConfigFile''' || name/id
|-
| 0x14 || 0x04 || 00 97 0A 54 || ?
|-
| 0x18 || 0x04 || 04 00 00 00 || ?
|-
| 0x1C || 0x04 || 01 00 00 00 || ?
|-{{cellcolors|lightgrey}}
| 0x20 || 0x04 || 0F D4 CC B9 || crc32 of the previous 4 values
|-
| colspan="4" | 
|-{{cellcolors|lightgrey}}
| 0x24 || 0x04 || 10 00 00 00 || size of the next 3 values
|-
| 0x28 || 0x08 || '''disc_no''' || name/id
|-
| 0x30 || 0x04 || 04 00 00 00 || amount of discs
|-
| 0x34 || 0x04 || 00 00 00 00 || disc number
|-{{cellcolors|lightgrey}}
| 0x38 || 0x04 || 93 D1 5B F8 || crc32 of the previous 3 values
|-
|}

*Other posible entries/commands/id
**'''user_memory_size''' ? (in both ps1_newemu.elf and ps1_netemu.elf appears next to ''PS1EmuConfigFile'' and ''disc_no'')

==PS1 rom handling==
Current version of ps1_rom file is first 512KB of 1.90 PS2 rom. Previously it was exactly the same version but whole 4MB were supplied to emulator. 
===Region patch===
All 3 emulators perform bios patching right after file is loaded into memory. Patch is related to region lock, and is unknown that its responsible for anything else, like timings etc.<br>
There is a string in emulator JJJJAEJEAEJJEJJA which is selector for bios/rom region based on target ID ([[Product_Code]]). 
<pre>J    J    J    J    A    E    J    E    A    E    J    J    E    J    J    A
0x80 0x81 0x82 0x83 0x84 0x85 0x86 0x87 0x88 0x89 0x8A 0x8B 0x8C 0x8D 0x8E 0x8F</pre>
Patch apply to string in VERSTR, X is replaced with appropriate region:
<pre>System ROM Version 5.0 06/23/03 X
Copyright 1993-1999 (C) Sony Computer Entertainment Inc.
</pre>

Is worth to note that X is always on the same offset in ALL ps1 bios versions, and all ps2 bios images. So in case of bios swap 
 ([[Talk:PS1_Emulation#ps1_rom.bin]] ) correct region will be still set.<br>
Patched offset is 0x7FF52 in rom file itself. Cobra have region free patch that in the end make X set to A (America) region, which apparently make bios region free. This can be true as similar thing happen on PCSX2 in ps1 mode. US rom is able to run all regions games, while JPN/EU fail to load different regions.
==PS1 games management in multiman==
=== Manual starting SELF method ===
#Insert PSX/PSone disc (region/pressed doesn't matter)
#Start MultiMAN (e.g. 2.07.01++)
::*Since 02.07.05 the PSX and PS2 discs are properly detected. PSX discs will show in XMB Game Column and you can launch the PS1 game from there. It uses ps1_emu.self default (you can choose Load or Load (Net), latter uses ps1_netemu).
#Switch to filemanager mode
#Browse to /dev_flash/ps1emu
#Select either one of the ps1 emulation SELF files

Note: Some games run better with ps1_emu.self (e.g. Mortal Kombat) while others run better with ps1_netemu.self (e.g. Resident Evil 3). If it doesn't work, try another ps1 emulation SELF file.

Downside: memory card options are unavailable unless you created a Virtual Memorycard ''before'' starting MultiMAN (XMB::Category Game:: Memory Card Utility (PS/PS2) > Create a PS1 memory card. Set it to Slot 1 (Press Triangle while selecting the Memory Card, then Assign it). Note: naming it "Internal Memory Card" sometimes works better than other names. MultiMAN 02.07.07 seems to solve the savegame issues.

=== Changes in MultiMAN 2.07.00/01 for ps1_emu handling ===
These options where needed to make above work:
* Added: LV2 access rights to use LV1 Storage Manager (syscall 864)
* Added: LV1 patch for user access to sys_storage functions (syscalls 600 to 623)

=== Arguments handling===
From multiman.cpp source (line 2502) http://code.google.com/p/multiman/source/browse/source/multiman.cpp?r=8c5b662f1c54d4f95f646949cae3d033b15b1a2e
{{Boxcode|code=<syntaxhighlight lang="c">
{
	char* launchargv[9];
	memset(launchargv, 0, sizeof(launchargv));
	launchargv[0] = (char*)malloc(strlen(mc1)+1); strcpy(launchargv[0], mc1);
	launchargv[1] = (char*)malloc(strlen(mc2)+1); strcpy(launchargv[1], mc2);
	launchargv[2] = (char*)malloc( 5); strcpy(launchargv[2], "0082");
	launchargv[3] = (char*)malloc( 5); strcpy(launchargv[3], "1600");
	launchargv[4] = (char*)malloc(10); strcpy(launchargv[4], app_path);
	launchargv[5] = (char*)malloc( 2); strcpy(launchargv[5], "1");
	launchargv[6] = (char*)malloc( 2); strcpy(launchargv[6], "2");		// full screen	on/off	= 2/1
	launchargv[7] = (char*)malloc( 2); strcpy(launchargv[7], "1");		// smoothing	on/off	= 1/0
	launchargv[8] = NULL;
	unload_modules();
	exitspawn((const char*) "/dev_flash/ps1emu/ps1_netemu.self", (char* const*)launchargv, NULL, NULL, 0, 1001, SYS_PROCESS_PRIMARY_STACK_SIZE_1M);
}

{
	char* launchargv[7];
	memset(launchargv, 0, sizeof(launchargv));
	launchargv[0] = (char*)malloc(strlen(mc1)+1); strcpy(launchargv[0], mc1);
	launchargv[1] = (char*)malloc(strlen(mc2)+1); strcpy(launchargv[1], mc2);
	launchargv[2] = (char*)malloc( 5); strcpy(launchargv[2], "0082");	// region
	launchargv[3] = (char*)malloc( 5); strcpy(launchargv[3], "1200");
	launchargv[4] = (char*)malloc( 2); strcpy(launchargv[4], "1");		// full screen	on/off	= 2/1
	launchargv[5] = (char*)malloc( 2); strcpy(launchargv[5], "1");		// smoothing	on/off	= 1/0
	launchargv[6] = NULL;
	unload_modules();
	exitspawn((const char*) "/dev_flash/ps1emu/ps1_emu.self", (char* const*)launchargv, NULL, NULL, 0, 1001, SYS_PROCESS_PRIMARY_STACK_SIZE_1M);
}
</syntaxhighlight>}}
*Notes:
**The '''''full screen''''' commented argument seems to be the '''Upscaler''' setting available from XMB {{icon category settings}} ⇨ '''[Game Settings]''' ⇨ '''[PS/PS2 Upscaler]''', with values: '''full/normal/off = 2/1/0'''
{{Reverse engineering}}<noinclude>[[Category:Main]]</noinclude>