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 ps plus psp emulator has a lot of undiscovered functionalities. It even allows patches directly to the emulated Allegrex cpu. | |||
The | 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 | === 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 85: | 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 100: | Line 38: | ||
|- | |- | ||
| --samplesave || ? || ? || | | --samplesave || ? || ? || | ||
|-style=" | |- | ||
| || | | --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 | | --antialias || off, MSAA4x, SSAA4x|| Anti-aliasing options || --antialias=off | ||
|- | |- | ||
| --texcachemode || patchworkheroes drawbounds, drawboundsloco, patchworkheroes, locoroco2, rondo | | --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 | | --texclutmode || filter, full || || --texclutmode=full | ||
Line 113: | Line 65: | ||
| --depthscalehack || true?, false? || ||--depthscalehack=true | | --depthscalehack || true?, false? || ||--depthscalehack=true | ||
|- | |- | ||
| -- | | --texloadcores || 0, 100 || textures to load || texloadcores=2 | ||
|- | |- | ||
| --smoothlevel || 0, 100 || Mesh smoothing level? || --smoothlevel=0 | |||
| --smoothlevel || 0, 100 || Mesh smoothing level? || --smoothlevel=0 | |||
|- | |- | ||
| --anisolevel || 0, 100 || Anisotropic filtering level?? || | | --anisolevel || 0, 100 || Anisotropic filtering level?? || | ||
Line 135: | 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 | ||
|- | |- | ||
| -- | |} | ||
==== 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 | ||
|- | |- | ||
| -- | | --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 160: | 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 166: | 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 | ||
|} | |} | ||
==== | |||
====Texture replacement==== | |||
{| 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 | ||
|- | |- | ||
| -- | | --texswitch||true, false|| Enables Texture replacement || --texswitch=true | ||
|- | |- | ||
| --texsave || || || | |||
| --texsave || || || | |||
|- | |- | ||
| --texmissingsave || || || | | --texmissingsave || || || | ||
Line 225: | Line 141: | ||
===XXXXYYYYY_patches.lua=== | ===XXXXYYYYY_patches.lua=== | ||
Your lua can be placed as '''scripts\XXXXYYYYY_patches.lua''' | |||
<br>'''Requires Cleanup'''. | |||
====Emulator commands==== | ====Emulator commands==== | ||
Line 233: | Line 150: | ||
|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 | ||
|- | |- | ||
|StartSlideshow ||emuObj.StartSlideshow()|| | | 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 | |||
|- | |||
|LoadSlideshow ||emuObj.LoadSlideshow()|| | |||
|- | |||
|StartSlideshow ||emuObj.StartSlideshow()|| | |||
|- | |- | ||
|Log ||emuObj.Log()|| | |Log ||emuObj.Log()|| | ||
Line 259: | Line 184: | ||
| SaveState ||emuObj.SaveState()|| | | SaveState ||emuObj.SaveState()|| | ||
|- | |- | ||
| SetFDExtraDelay ||emuObj.SetFDExtraDelay()|| | | SetFDExtraDelay ||emuObj.SetFDExtraDelay()|| | ||
|- | |- | ||
| MeshSmooth ||emuObj.MeshSmooth()|| | | MeshSmooth ||emuObj.MeshSmooth()|| | ||
Line 292: | Line 217: | ||
|- | |- | ||
| PlayVideo||emuObj.PlayVideo()|| | | PlayVideo||emuObj.PlayVideo()|| | ||
|- | |||
| AddGPUHook ||emuObj.AddGPUHook()|| | |||
|- | |- | ||
| RescaleUForUpscale ||emuObj.RescaleUForUpscale()|| | | RescaleUForUpscale ||emuObj.RescaleUForUpscale()|| | ||
Line 309: | Line 236: | ||
| 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 328: | Line 255: | ||
|- | |- | ||
| CopyFB || emuObj.CopyFB() || | | CopyFB || emuObj.CopyFB() || | ||
|-style="background-color:#D7EF54" | |-style="background-color:#D7EF54" | ||
| Pad || || | | Pad || || | ||
|- | |- | ||
| Pad require || | | Pad require ||local pad = require("pad") || | ||
|- | |- | ||
|PadRead || emuObj.PadRead() || | |PadRead || emuObj.PadRead() || | ||
|- | |- | ||
|PadReadPitch || emuObj.PadReadPitch() || | |PadReadPitch || emuObj.PadReadPitch() || | ||
Line 371: | Line 268: | ||
|PadRegisterSamples || emuObj.PadRegisterSamples()|| | |PadRegisterSamples || emuObj.PadRegisterSamples()|| | ||
|- | |- | ||
| PadSetButtonsMode || emuObj.PadSetButtonsMode() || | | PadSetButtonsMode || emuObj.PadSetButtonsMode() || emuObj.PadSetButtonsMode(pad.BUTTONS_MODE_OPTION_IS_SELECT) | ||
|- | |- | ||
| PadVibrate|| emuObj.PadVibrate() || emuObj.PadVibrate(5,180,180) | | PadVibrate|| emuObj.PadVibrate() || emuObj.PadVibrate(5,180,180) | ||
Line 389: | Line 283: | ||
|- | |- | ||
| RemoveHook || axObj.RemoveHook() || | | RemoveHook || axObj.RemoveHook() || | ||
|- | |||
|SetPC|| axObj.SetPC() || | |||
|- | |||
|GetPC|| axObj.GetPC() || | |||
|- | |- | ||
| 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 400: | Line 298: | ||
| 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() || | ||
|- | |- | ||
| SetGpr ||axObj.SetGpr() || | |||
| SetGpr ||axObj.SetGpr() || | |||
|- | |- | ||
|SetFpr|| axObj.SetFpr() ||axObj.SetFpr(0) | |SetFpr|| axObj.SetFpr() ||axObj.SetFpr(0) | ||
Line 424: | Line 318: | ||
|GetReg||axObj.GetReg()|| | |GetReg||axObj.GetReg()|| | ||
|-style="background-color:#D7EF54" | |-style="background-color:#D7EF54" | ||
| Memory editing || || Do note that the offsets on PPSSPP are | | Memory editing || || Do note that the offsets on PPSSPP are different than the ones on the PS4 | ||
|- | |- | ||
| ReadMem32 || axObj.ReadMem32() || Read 4 bytes from offset | | ReadMem32 || axObj.ReadMem32() || Read 4 bytes from offset | ||
Line 459: | Line 353: | ||
|- | |- | ||
|} | |} | ||
====Examples==== | |||
<br>'''''LUA example:''''' | |||
<br>''' | <br> | ||
<br>"NPEZ00164" | <br>Coconut Dodge "NPEZ00164" | ||
<pre> | <pre> | ||
local axObj = getAXObject() | local axObj = getAXObject() | ||
Line 469: | Line 363: | ||
local patcher = function() | local patcher = function() | ||
--Infinite lives | --Infinite lives | ||
axObj.WriteMem32(0x8ACA1A4, 0x3) | axObj.WriteMem32(0x8ACA1A4, 0x3) | ||
end | end | ||
emuObj.AddVsyncHook(patcher) | emuObj.AddVsyncHook(patcher) | ||
</pre> | </pre> | ||
=====Patches.lua===== | |||
'''An official lua created by sony for Patapon 2''' | |||
<pre> | <pre> | ||
-- Lua 5.3 | -- Lua 5.3 | ||
-- Title: | -- Title: Patapon 2 PSP - UCUS-98732 (USA) | ||
-- | |||
apiRequest(1.0) -- request version 1.0 API. Calling apiRequest() is mandatory. | apiRequest(1.0) -- request version 1.0 API. Calling apiRequest() is mandatory. | ||
local emuObj = getEmuObject() | local gpr = require( "ax-gpr-alias" ) -- you can access Allegrex GPR by alias (gpr.a0 / gpr["a0"]) | ||
local | local emuObj = getEmuObject() -- emulator | ||
local axObj = getAXObject() -- allegrex | |||
local pad = require("pad") | |||
-- Hook memcpy to catch framebuffer effects | |||
axFuncReplace(0x881D194, "patapon_memcpy") | |||
-- Hook memcpy to catch framebuffer effects | |||
axFuncReplace(0x881D194, "patapon_memcpy") | |||
-- Accelerate some functions | -- Accelerate some functions | ||
Line 969: | Line 776: | ||
== 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 986: | Line 793: | ||
|- | |- | ||
| 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(?) | ||
|- | |- | ||
| | |} | ||
==Registers Map== | |||
{| cellspacing="0" cellpadding="2" border="1" class="wikitable" style="text-align: center;" | |||
! Register !! Offset | |||
|- | |- | ||
| | | - || - | ||
|- | |- | ||
| | |} | ||
= Known issues = | |||
{| cellspacing="0" cellpadding="2" border="1" class="wikitable" style="text-align: center;" | |||
| | ! Issue !! Games affected !! Solution !! Description | ||
|- | |- | ||
| | | - || || || | ||
|- | |- | ||
|} | |} | ||
=LUA include files= | |||
<br>Files that need to be placed in the '''/lua_include/''' folder | |||
'''ax-gpr-alias.lua''' | |||
<pre> | |||
-- Recommended method to import this module: | |||
-- local gpr = require("ax-gpr-alias") | |||
gpr = {} | |||
gpr.zero = 0 | |||
gpr.at = 1 | |||
gpr.v0 = 2 | |||
gpr.v1 = 3 | |||
gpr.a0 = 4 | |||
gpr.a1 = 5 | |||
gpr.a2 = 6 | |||
gpr.a3 = 7 | |||
gpr.t0 = 8 | |||
gpr.t1 = 9 | |||
gpr.t2 = 10 | |||
gpr.t3 = 11 | |||
=LUA include files= | |||
<br>Files that need to be placed in the '''/lua_include/''' folder | |||
'''ax-gpr-alias.lua''' | |||
<pre> | |||
-- Recommended method to import this module: | |||
-- local gpr = require("ax-gpr-alias") | |||
gpr = {} | |||
gpr.zero = 0 | |||
gpr.at = 1 | |||
gpr.v0 = 2 | |||
gpr.v1 = 3 | |||
gpr.a0 = 4 | |||
gpr.a1 = 5 | |||
gpr.a2 = 6 | |||
gpr.a3 = 7 | |||
gpr.t0 = 8 | |||
gpr.t1 = 9 | |||
gpr.t2 = 10 | |||
gpr.t3 = 11 | |||
gpr.t4 = 12 | gpr.t4 = 12 | ||
gpr.t5 = 13 | gpr.t5 = 13 | ||
Line 1,373: | Line 864: | ||
gpr.ra = 31 | gpr.ra = 31 | ||
return gpr | return gpr | ||
</pre> | </pre> | ||
'''pad.lua''' | '''pad.lua''' | ||
<pre> | <pre> | ||
Line 1,592: | Line 922: | ||
├── lua_include | ├── lua_include | ||
│ ├── ax-gpr-alias.lua | │ ├── ax-gpr-alias.lua | ||
│ └── pad.lua | │ └── pad.lua | ||
├── scripts | ├── scripts | ||
Line 2,225: | Line 1,551: | ||
* 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:=== |