Editing PSP Emulation
Jump to navigation
Jump to search
The edit can be undone. Please check the comparison below to verify that this is what you want to do, and then publish the changes below to finish undoing the edit.
Latest revision | Your text | ||
Line 1: | Line 1: | ||
=='''PSPHD'''== | =='''PSPHD'''== | ||
The new | The new ps plus psp emulator has a lot of undiscovered functionality. It even allows patches directly to the emulated Allegrex cpu. | ||
Sadly sony has not made it easy for users to use CLI commands. Since sony mostly uses lua patches for the psp releases, not many cli commands were added. Very few commands have a description to their usage inside of the eboot.bin. Everything else is just guesswork from the scene. The psp emulator has not gained the same popularity as the ps2 emulator because currently, there is an unofficial PPSSPP core in the unofficial retroarch port for the ps4. and as far as the compatibility and performance goes, the retroarch core is second to no one. This emulator may still hold potential, though sadly it does not seem to have support for gamedata installation. and that has led to many games becoming currently unusable. with an official retroarch release coming into ps4's way it seems delving deeper into the PSPHD emulator and the PS1's new psplus emulator is pretty useless. | |||
== Commands == | == Commands == | ||
'''Known functions:''' Require cleanup. | '''Known functions:''' Require cleanup. | ||
<br>The rest of the cli and lua commands can all be found inside of an emu's decrypted '''eboot.bin'''. | <br>The rest of the cli and lua commands can all be found inside of an emu's decrypted '''eboot.bin'''. | ||
=== | === config-emu-ps4.txt commands === | ||
''General purpose CLI commands, or unknown usage'' | |||
{| cellspacing="0" cellpadding="2" border="1" class="wikitable" style="text-align: center;" | {| cellspacing="0" cellpadding="2" border="1" class="wikitable" style="text-align: center;" | ||
! Command !! Values !! Notes !! Usage | ! Command !! Values !! Notes !! Usage | ||
|- | |- | ||
| --boot || || Set directory of psp game's boot.bin || [disc0:/PSP_GAME/SYSDIR/BOOT.BIN] | | --boot || || Set directory of psp game's boot.bin || [disc0:/PSP_GAME/SYSDIR/BOOT.BIN] | ||
|- | |- | ||
| --notrophies || || Enable/disable trophies|| | | --notrophies || || Enable/disable trophies|| | ||
|- | |- | ||
| --locale || || || | | --locale || || || | ||
Line 29: | Line 23: | ||
| --addon || || || | | --addon || || || | ||
|- | |- | ||
| --host || Sets host directory || --host="/hostapp/" | | --host || || Sets host directory || --host="/hostapp/" | ||
|- | |- | ||
| --loglevel || none, all, warn, info, error, debug, trace || debug logging | | --loglevel || none, all, warn, info, error, debug, trace || debug logging | ||
|- | |- | ||
| --xobuttonmode || oenter, ocancel || Switcher between x and circle button, made specifically for japanese gamers | | --xobuttonmode || oenter, ocancel || Switcher between x and circle button, made specifically for japanese gamers | ||
|- | |- | ||
| --lang || Including but not limited to "en" "jp" "fr" "it" || Language selector || --lang="en" | | --lang || Including but not limited to "en" "jp" "fr" "it" || Language selector || --lang="en" | ||
Line 44: | Line 38: | ||
|- | |- | ||
| --samplesave || ? || ? || | | --samplesave || ? || ? || | ||
|- | |- | ||
| -- | | --vramcopyback || 0, 10000000 || || --vramcopyback=45 | ||
|- | |- | ||
| -- | | --msxxadhoc || true?, false? || ad hoc support ? || | ||
|- | |- | ||
| -- | |} | ||
====Graphics==== | |||
''Commands that serve the purpose of improving / fixing graphics and textures'' | |||
{| cellspacing="0" cellpadding="2" border="1" class="wikitable" style="text-align: center;" | |||
! Command !! Values !! Notes !! Usage | |||
|- | |||
| --parappareplacecolor || The command expects 8 Hex values || (rgb?) || | |||
|- | |- | ||
| -- | | --antialias || off, MSAA4x, SSAA4x|| Anti-aliasing options || --antialias=off | ||
|- | |- | ||
| -- | | --clamp-line-thickness-min || ? || ? || | ||
|- | |- | ||
| -- | | --clamp-line-thickness-max || ? || ? || | ||
|- | |- | ||
| -- | | --texcachemode || patchworkheroes drawbounds, drawboundsloco, patchworkheroes, locoroco2, rondo || Seems to be a selector of texture caching method|| --texcachemode=patchworkheroes | ||
|- | |- | ||
| -- | | --texclutmode || filter, full || || --texclutmode=full | ||
|- | |- | ||
| -- | | --texloadmode || launch, ondemand_lz4 || Seems to be a selector of when to load textures, either before the game requires it, or once the game requires it || | ||
|- | |- | ||
| -- | | --depthscalehack || true?, false? || ||--depthscalehack=true | ||
|- | |- | ||
| --texloadcores || 0, 100 || textures to load || texloadcores=2 | | --texloadcores || 0, 100 || textures to load || texloadcores=2 | ||
Line 79: | Line 73: | ||
| --parappajapanesefonthack || true?, false? || Enables Support For Japanese Fonts ??|| --parappajapanesefonthack=true | | --parappajapanesefonthack || true?, false? || Enables Support For Japanese Fonts ??|| --parappajapanesefonthack=true | ||
|- | |- | ||
| -- | | --depthscalehack || true?, false? || ||--depthscalehack=true | ||
|- | |- | ||
| -- | | --locorocomeshsmooth || true, false || Custom mesh smoothing for loco roco games|| --locorocomeshsmooth=true | ||
|- | |- | ||
| -- | | --locorocomeshsmoothnonindexed || true, false || Non-indexed mesh smoothing ||--locorocomeshsmoothnonindexed=true | ||
|- | |- | ||
| -- | | --forcenobilinear || true, false || Turn bilinear filtering on/off, setting it to True will fix many graphical glitches in games that use 2D Images ||--forcenobilinear=true | ||
|- | |- | ||
| | |} | ||
|- | |||
| --umddelay || ? || Seems to be I/O timing method. | ==== Gamefixes / Hacks ==== | ||
''Commands that serve the purpose of fixing broken games'' | |||
{| cellspacing="0" cellpadding="2" border="1" class="wikitable" style="text-align: center;" | |||
! Command !! Values !! Notes !! Usage | |||
|- | |||
| --umddelay || ? || Seems to be I/O timing method, Some games need a delay to work properly. [https://github.com/hrydgard/ppsspp/issues/7647 More here] || | |||
|- | |- | ||
| -- | | --godofwarhack || true?, false? || Seems specifically made for god of war, unknown effect || --godofwarhack=true | ||
|- | |- | ||
|-style=" | | --parappaalphahack || true?, false? || || --parappaalphahack=true | ||
|- | |||
|} | |||
==== Speedhacks ==== | |||
''Commands that imrpove the game's performance, it can contain duplicate commands'' | |||
{| cellspacing="0" cellpadding="2" border="1" class="wikitable" style="text-align: center;" | |||
! Command !! Values !! Notes !! Usage | |||
|- | |- | ||
| --antialias || off || Turning Anti-Alias Off Improves Performance||--antialias=off | | --antialias || off || Turning Anti-Alias Off Improves Performance||--antialias=off | ||
Line 104: | Line 109: | ||
| --smoothlevel || 0 || Set mesh smooth level||--smoothlevel=0 | | --smoothlevel || 0 || Set mesh smooth level||--smoothlevel=0 | ||
|- | |- | ||
| --gputhread || true, false || | | --gputhread || true, false || Run the PSP GPU on a separate thread || --gputhread=true | ||
|- | |- | ||
| --texcachemode || patchworkheroes drawbounds, drawboundsloco, patchworkheroes, locoroco2, rondo || Set texture caching method ||--texcachemode=patchworkheroes | | --texcachemode || patchworkheroes drawbounds, drawboundsloco, patchworkheroes, locoroco2, rondo || Set texture caching method ||--texcachemode=patchworkheroes | ||
Line 110: | Line 115: | ||
| --anisolevel || 0, 100 || Anisotropic filtering level?? || | | --anisolevel || 0, 100 || Anisotropic filtering level?? || | ||
|- | |- | ||
| --present || vblankstart, setframebuf, drawsync|| | | --present || vblankstart, setframebuf, drawsync|| Display on draw to reduce latency ||--present=setframebuf | ||
|- | |- | ||
| --texrecent || true || Optimize texture hashes ||--texrecent=true | | --texrecent || true || Optimize texture hashes ||--texrecent=true | ||
|} | |} | ||
Line 169: | Line 141: | ||
===XXXXYYYYY_patches.lua=== | ===XXXXYYYYY_patches.lua=== | ||
Your lua can be placed as '''Image0\Patches\XXXXYYYYY\XXXXYYYYY_patches.lua''' | |||
<br>'''Requires Cleanup'''. | |||
{| cellspacing="0" cellpadding="2" border="1" class="wikitable" style="text-align: center;" | |||
! Command !! Usage !! Notes - Example | |||
|- | |||
| apiRequest || '''apiRequest(<api version>)''' || example: apiRequest(0.1) | |||
Calling api is mandatory. some commands require higher versions. | |||
|- | |||
====Emulator commands==== | ====Emulator commands==== | ||
Line 176: | Line 156: | ||
|- | |- | ||
|getEmuObject || '''local emuObj = getEmuObject()''' || Required for all functions using emuObj | |getEmuObject || '''local emuObj = getEmuObject()''' || Required for all functions using emuObj | ||
|- | |||
| AddVsyncHook ||emuObj.AddVsyncHook()|| Set function to be done on every vsync | |||
|- | |||
| RemoveVsyncHook ||emuObj.RemoveVsyncHook()|| Remove vsynchook | |||
|- | |||
| AddBootHook ||emuObj.AddBootHook()|| Set function to be done when the game boots up | |||
|- | |||
|RemoveBootHook||emuObj.RemoveBootHook()|| remove function to be done when the game boots up | |||
|- | |||
|PadRead || emuObj.PadRead() || | |||
|- | |||
|PadReadPitch || emuObj.PadReadPitch() || | |||
|- | |||
|PadReadRoll || emuObj.PadReadRoll()|| | |||
|- | |||
|PadRegisterSamples || emuObj.PadRegisterSamples()|| | |||
|- | |- | ||
|LoadSlideshow ||emuObj.LoadSlideshow()|| | |LoadSlideshow ||emuObj.LoadSlideshow()|| | ||
Line 203: | Line 199: | ||
| SaveState ||emuObj.SaveState()|| | | SaveState ||emuObj.SaveState()|| | ||
|- | |- | ||
| SetFDExtraDelay ||emuObj.SetFDExtraDelay()|| | | SetFDExtraDelay ||emuObj.SetFDExtraDelay()|| | ||
|- | |- | ||
| MeshSmooth ||emuObj.MeshSmooth()|| | | MeshSmooth ||emuObj.MeshSmooth()|| | ||
Line 236: | Line 232: | ||
|- | |- | ||
| PlayVideo||emuObj.PlayVideo()|| | | PlayVideo||emuObj.PlayVideo()|| | ||
|- | |||
| AddGPUHook ||emuObj.AddGPUHook()|| | |||
|- | |- | ||
| RescaleUForUpscale ||emuObj.RescaleUForUpscale()|| | | RescaleUForUpscale ||emuObj.RescaleUForUpscale()|| | ||
Line 248: | Line 246: | ||
|- | |- | ||
| OverrideFBSize||emuObj.OverrideFBSize()|| Override framebuffer size ? | | OverrideFBSize||emuObj.OverrideFBSize()|| Override framebuffer size ? | ||
|- | |||
| PadSetButtonsMode || emuObj.PadSetButtonsMode() || emuObj.PadSetButtonsMode(pad.BUTTONS_MODE_OPTION_IS_SELECT) | |||
|- | |- | ||
|RemapSavedata || emuObj.RemapSavedata() ||emuObj.RemapSavedata("UCUS98711", "CUSA06171", "504e802b04a1838c32b616abbe0b475fbea1c823825ef0df06cc2bad129ce2f7") | |RemapSavedata || emuObj.RemapSavedata() ||emuObj.RemapSavedata("UCUS98711", "CUSA06171", "504e802b04a1838c32b616abbe0b475fbea1c823825ef0df06cc2bad129ce2f7") | ||
|- | |||
| PadVibrate|| emuObj.PadVibrate() || emuObj.PadVibrate(5,180,180) | |||
|- | |- | ||
| NeoMode || emuObj.NeoMode() || Checks whether or not the ps4 is pro | | NeoMode || emuObj.NeoMode() || Checks whether or not the ps4 is pro | ||
|- | |- | ||
| ThrottleMax || emuObj.ThrottleMax() || Disable framelimiter | | ThrottleMax || emuObj.ThrottleMax() || Disable framelimiter During loading screens, This setting can sometimes be harmful when used globally in config files. Loading times are faster, but the game also runs faster than it should when the PS4 has enough free cpu power. | ||
|- | |- | ||
| ThrottleFast|| emuObj.ThrottleFast() || Faster than default, but exact value is unknown. | | ThrottleFast|| emuObj.ThrottleFast() || Faster than default, but exact value is unknown. | ||
Line 272: | Line 274: | ||
|- | |- | ||
| CopyFB || emuObj.CopyFB() || | | CopyFB || emuObj.CopyFB() || | ||
|- | |- | ||
| | |} | ||
====Allegrex commands==== | |||
{| cellspacing="0" cellpadding="2" border="1" class="wikitable" style="text-align: center;" | |||
! Command !! Usage !! Notes - Example | |||
|- | |- | ||
| | | getAXObject ||'''local axObj = getAXObject()''' || Required for all functions using AXObject | ||
|- | |- | ||
| | | AddHook || axObj.AddHook() || | ||
|- | |- | ||
| | | RemoveHook || axObj.RemoveHook() || | ||
|- | |- | ||
| | |SetPC|| axObj.SetPC() || | ||
|- | |- | ||
| | |GetPC|| axObj.GetPC() || | ||
|- | |- | ||
| | | ReadMem32 || axObj.ReadMem32() || Read 4 bytes from offset | ||
|- | |- | ||
| | | WriteMem32 || axObj.WriteMem32() || Write 4 bytes to offset | ||
|- | |- | ||
| | | ReadMem16 || axObj.ReadMem16() || Read 2 bytes from offset | ||
|- | |- | ||
| | | WriteMem16 || axObj.WriteMem16() || Write 2 bytes to offset | ||
|- | |- | ||
| | | ReadMem8 || axObj.ReadMem8() || Read 1 byte from offset | ||
|- | |- | ||
| | | WriteMem8 || axObj.WriteMem8() || Write 1 byte to offset | ||
|- | |- | ||
| | | ReadMemString || axObj.ReadMemString() || | ||
|- | |- | ||
| | | WriteMemString || axObj.WriteMemString() || | ||
|- | |||
| WriteMemStr16 || axObj.WriteMemStr16() || | |||
|- | |||
|WriteMemStr16Z ||axObj.WriteMemStr16Z() || | |||
|- | |- | ||
| | | WriteMemStringZ ||axobj.WriteMemStringZ || | ||
|- | |- | ||
| | |ReadMemFloat || axObj.ReadMemFloat() || | ||
|- | |- | ||
| | |WriteMemFloat || axObj.WriteMemFloat() || | ||
|- | |- | ||
| BurnCycles|| axobj.BurnCycles() || Could be an option to overclock cpu at a hooked offset | | BurnCycles|| axobj.BurnCycles() || Could be an option to overclock cpu at a hooked offset | ||
Line 339: | Line 321: | ||
|- | |- | ||
|Overlay ||axObj.Overlay()|| | |Overlay ||axObj.Overlay()|| | ||
|- | |- | ||
| gpr require || '''local gpr = require("ax-gpr-alias")''' || Required for any command that includes gpr registers | | gpr require || '''local gpr = require("ax-gpr-alias")''' || Required for any command that includes gpr registers | ||
|- | |- | ||
| GetGpr || axObj.GetGpr() || | | GetGpr || axObj.GetGpr() || | ||
Line 367: | Line 343: | ||
|- | |- | ||
|GetReg||axObj.GetReg()|| | |GetReg||axObj.GetReg()|| | ||
|- | |- | ||
! !! Other/Unknown/Standalone Commands !! | |||
|- | |- | ||
| | |FuncReplace || axFuncReplace() || axFuncReplace(0x8804670, "__ptmf_scall") Replace allegrex function. | ||
|- | |- | ||
| InsnReplace || axInsnReplace() || Replace allegrex memory | |||
| InsnReplace || axInsnReplace() || Replace allegrex memory | |||
|- | |- | ||
|} | |} | ||
=====Examples===== | |||
==== | ======User made lua====== | ||
''A custom lua made by a user'' | |||
<pre> | <pre> | ||
apiRequest(0.1) | |||
local axObj = getAXObject() | local axObj = getAXObject() | ||
local emuObj = getEmuObject() | local emuObj = getEmuObject() | ||
local patcher = function() | local patcher = function() | ||
axobj.WriteMem32(0x0053d5d4,0x21c828bd) | |||
end | end | ||
Line 420: | Line 365: | ||
</pre> | </pre> | ||
======Patches.lua====== | |||
=====Patches.lua | '''An official lua created by sony for Patapon 2''' | ||
<pre> | <pre> | ||
-- Lua 5.3 | -- Lua 5.3 | ||
Line 899: | Line 772: | ||
== Emulators == | == Emulators == | ||
<pre>Every emulator is programmed in a | <pre>Every emulator is programmed in a different way, sometimes choosing the right emulator is the only possible way to fix a game. Emulators are not provided pre-installed on the ps4, they have to be unpacked from a backup that's downloaded from the ps store from that specific game. this list includes The typical usage of some of The emulators.</pre> | ||
{| cellspacing="0" cellpadding="2" border="1" class="wikitable" style="text-align: center;" | {| cellspacing="0" cellpadding="2" border="1" class="wikitable" style="text-align: center;" | ||
! Emulator !! Usage !! API Version !! Similar emulators ( | ! Emulator !! Usage !! API Version !! Similar emulators (Usage) | ||
|- | |- | ||
| Echochrome || The default psp emulator for PSPFPKG tool at the time of writing and the best in terms of compatibility. || ? || ? | | Echochrome || The default psp emulator for PSPFPKG tool at the time of writing and the best in terms of compatibility. || ? || ? | ||
Line 916: | Line 789: | ||
|- | |- | ||
| PaRappa the Rapper || An unofficial emulator developed by sony with very bad compatibility || ? || ? | | PaRappa the Rapper || An unofficial emulator developed by sony with very bad compatibility || ? || ? | ||
|- | |- | ||
|} | |} | ||
==Memory mapping== | ==Memory mapping== | ||
{| cellspacing="0" cellpadding="2" border="1" class="wikitable" style="text-align: center;" | {| cellspacing="0" cellpadding="2" border="1" class="wikitable" style="text-align: center;" | ||
! | ! Offset From !! Offset To !! Name | ||
|- | |- | ||
| || | | 0x1008000000 || 0x10887FFFFF || Allegrex memory(?) | ||
|- | |- | ||
|} | |||
==Information== | |||
Note: Missing entries | |||
====Folder/File layout==== | |||
=====Echochrome===== | |||
<pre> | |||
├── assets | |||
├── iso | |||
├── lua_include | |||
├── sce_module | |||
├── sce_sys | |||
├── SIEA | |||
│ └── data | |||
│ └── USER_L0.IMG | |||
├── usermodule | |||
|} | │ └──libfont.lib | ||
├── sce_discmap.plt | |||
== | ├── config-title.txt | ||
├── package-ps4.conf | |||
├── eboot.bin | |||
├── revision.conf | |||
└── config-title.txt | |||
<pre> | |||
</pre> | </pre> | ||
=====Old emulators===== | |||
= | |||
== | |||
<pre> | <pre> | ||
├── assets | ├── assets | ||
├── flash0 | |||
├── iso | |||
├── | |||
├── lua_include | ├── lua_include | ||
├── Patches | |||
│ ├──XXXXYYYYY_patches.lua | │ ├──XXXXYYYYY_patches.lua | ||
│ ├──XXXXYYYYY_features.lua | │ ├──XXXXYYYYY_features.lua | ||
│ ├──XXXXYYYYY_tooling.lua | │ ├──XXXXYYYYY_tooling.lua | ||
│ └──XXXXYYYYY_trophies.lua | │ └──XXXXYYYYY_trophies.lua | ||
├── pspfonts | |||
├── sce_module | ├── sce_module | ||
├── sce_sys | ├── sce_sys | ||
├── trophy_data | ├── trophy_data | ||
├── usermodule | ├── usermodule | ||
Line 1,541: | Line 842: | ||
├── eboot.bin | ├── eboot.bin | ||
├── revision.conf | ├── revision.conf | ||
└── config-title.txt | └── config-title.txt | ||
</pre> | </pre> | ||
==Other== | ====Other==== | ||
<pre> | <pre> | ||
XXXXYYYYY_config.txt | XXXXYYYYY_config.txt | ||
Line 1,563: | Line 863: | ||
</pre> | </pre> | ||
==Sample== | ====Sample==== | ||
<pre>; PS4 configuration file for PSPHD | <pre>; PS4 configuration file for PSPHD | ||
Line 1,611: | Line 911: | ||
--parappaalphahack=true | --parappaalphahack=true | ||
</pre> | </pre> | ||
==NIDs in HLE== | ===NIDs in HLE=== | ||
<pre> | <pre> | ||
|HLEInterruptManager| | |HLEInterruptManager| | ||
Line 2,081: | Line 1,381: | ||
</pre> | </pre> | ||
==Unimplemented functions== | ===Unimplemented functions=== | ||
<pre> | <pre> | ||
sceIoChdir() unimplemented, ignoring | sceIoChdir() unimplemented, ignoring | ||
Line 2,141: | Line 1,441: | ||
</pre> | </pre> | ||
==Restricted== | ===Restricted=== | ||
<pre> | <pre> | ||
scePowerRegisterCallback - ignoring | scePowerRegisterCallback - ignoring | ||
Line 2,155: | Line 1,455: | ||
* https://forums.ppsspp.org/showthread.php?tid=11961 | * https://forums.ppsspp.org/showthread.php?tid=11961 | ||
* https://github.com/LunaMoo/PPSSPP_workarounds/blob/master/cheat.db | * https://github.com/LunaMoo/PPSSPP_workarounds/blob/master/cheat.db | ||
===More Information:=== | ===More Information:=== |