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 | ||
|-style="background-color:#FEA15C" | |-style="background-color:#FEA15C" | ||
| || | | || Other || || | ||
|- | |- | ||
| --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 25: | ||
| --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 40: | ||
|- | |- | ||
| --samplesave || ? || ? || | | --samplesave || ? || ? || | ||
|- | |||
| --vramcopyback || 0, 10000000 || || --vramcopyback=45 | |||
|- | |||
| --msxxadhoc || true?, false? || ad hoc support ? || | |||
|-style="background-color:#ff99c2" | |-style="background-color:#ff99c2" | ||
| || Graphical fixes || || | | || Graphical fixes || || | ||
|- | |||
| --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 63: | ||
| --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 | ||
|- | |- | ||
| -- | | --anisolevel || 0, 100 || Anisotropic filtering level?? || | ||
|- | |- | ||
| -- | | --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 | ||
|-style="background-color:#D7EF54" | |||
| || Game fixes || || | |||
|- | |- | ||
| -- | | --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 || || | |||
| || Speedhacks | |||
|- | |- | ||
| --antialias || off || Turning Anti-Alias Off Improves Performance||--antialias=off | | --antialias || off || Turning Anti-Alias Off Improves Performance||--antialias=off | ||
Line 160: | Line 97: | ||
| --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 103: | ||
| --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 || || || | ||
|- | |- | ||
| -- | | --texmissingsave || || || | ||
|- | |- | ||
| -- | | --autoresampler || true, false|| Turns on the auto-resampler. Assumes textures in texreplace are at 8x resolution and resamples them at load, May only work on new LocoRoco Midnight Carnival emu || --autoresampler=true | ||
|- | |- | ||
| -- | | --texreplace || Directory || Set directory of texture replacement folder || --texreplace="host0:texreplace" | ||
|- | |- | ||
| -- | | --replacementfilter || true, false || This forces alpha blending to on for replaced textures. || --replacementfilter=true | ||
|- | |- | ||
| -- | | --replacementalpha || true, false || || --replacementalpha=true | ||
|- | |- | ||
| -- | |} | ||
===XXXXYYYYY_patches.lua=== | |||
Your lua can be placed as '''scripts\XXXXYYYYY_patches.lua''' | |||
<br>'''Requires Cleanup'''. | |||
====Emulator commands==== | |||
{| cellspacing="0" cellpadding="2" border="1" class="wikitable" style="text-align: center;" | |||
! Command !! Usage !! Notes - Example | |||
|- | |- | ||
| | |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 | ||
|- | |- | ||
| | |LoadSlideshow ||emuObj.LoadSlideshow()|| | ||
|- | |- | ||
| | |StartSlideshow ||emuObj.StartSlideshow()|| | ||
|- | |- | ||
| | |Log ||emuObj.Log()|| | ||
|- | |- | ||
| | | GetLanguage ||emuObj.GetLanguage()|| Get the language the ps4 is using | ||
|- | |- | ||
| GetNativeLanguage ||emuObj.GetNativeLanguage()|| | |||
| GetNativeLanguage ||emuObj.GetNativeLanguage()|| | |||
|- | |- | ||
|DisplayManual || emuObj.DisplayManual()|| | |DisplayManual || emuObj.DisplayManual()|| | ||
Line 259: | Line 172: | ||
| SaveState ||emuObj.SaveState()|| | | SaveState ||emuObj.SaveState()|| | ||
|- | |- | ||
| SetFDExtraDelay ||emuObj.SetFDExtraDelay()|| | | SetFDExtraDelay ||emuObj.SetFDExtraDelay()|| | ||
|- | |- | ||
| MeshSmooth ||emuObj.MeshSmooth()|| | | MeshSmooth ||emuObj.MeshSmooth()|| | ||
Line 292: | Line 205: | ||
|- | |- | ||
| PlayVideo||emuObj.PlayVideo()|| | | PlayVideo||emuObj.PlayVideo()|| | ||
|- | |||
| AddGPUHook ||emuObj.AddGPUHook()|| | |||
|- | |- | ||
| RescaleUForUpscale ||emuObj.RescaleUForUpscale()|| | | RescaleUForUpscale ||emuObj.RescaleUForUpscale()|| | ||
Line 328: | Line 243: | ||
|- | |- | ||
| CopyFB || emuObj.CopyFB() || | | CopyFB || emuObj.CopyFB() || | ||
|-style="background-color:#D7EF54" | |-style="background-color:#D7EF54" | ||
| Pad || || | | Pad || || | ||
Line 347: | Line 249: | ||
|- | |- | ||
|PadRead || emuObj.PadRead() || | |PadRead || emuObj.PadRead() || | ||
|- | |- | ||
|PadReadPitch || emuObj.PadReadPitch() || | |PadReadPitch || emuObj.PadReadPitch() || | ||
Line 371: | Line 256: | ||
|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 424: | Line 306: | ||
|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 460: | Line 342: | ||
|} | |} | ||
==== | ====Examples==== | ||
<br>''' | <br>'''''LUA example:''''' | ||
<br>"NPEZ00164" | <br> | ||
<br>Coconut Dodge "NPEZ00164" | |||
<pre> | <pre> | ||
local axObj = getAXObject() | local axObj = getAXObject() | ||
Line 469: | Line 352: | ||
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 gpr = require( "ax-gpr-alias" ) -- you can access Allegrex GPR by alias (gpr.a0 / gpr["a0"]) | |||
local gpr = require( "ax-gpr-alias" ) -- you can access Allegrex GPR by alias (gpr.a0 / gpr["a0"]) | |||
local emuObj = getEmuObject() -- emulator | local emuObj = getEmuObject() -- emulator | ||
local axObj = getAXObject() -- allegrex | local axObj = getAXObject() -- allegrex | ||
Line 969: | Line 765: | ||
== 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 782: | ||
|- | |- | ||
| 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(?) | ||
|- | |- | ||
| | |} | ||
==Register map== | |||
{| cellspacing="0" cellpadding="2" border="1" class="wikitable" style="text-align: center;" | |||
! Register !! Offset | |||
|- | |- | ||
| | | PC?? || 0x20B89FAE8 | ||
|- | |- | ||
| | |} | ||
= 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 | |||
gpr.t4 = 12 | |||
gpr.t5 = 13 | |||
=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.t5 = 13 | |||
gpr.t6 = 14 | gpr.t6 = 14 | ||
gpr.t7 = 15 | gpr.t7 = 15 | ||
Line 1,371: | Line 851: | ||
gpr.sp = 29 | gpr.sp = 29 | ||
gpr.fp = 30 | gpr.fp = 30 | ||
gpr.ra = 31 | gpr.ra = 31 | ||
return gpr | |||
</pre> | </pre> | ||
'''pad.lua''' | '''pad.lua''' | ||
<pre> | <pre> | ||
Line 1,592: | Line 911: | ||
├── lua_include | ├── lua_include | ||
│ ├── ax-gpr-alias.lua | │ ├── ax-gpr-alias.lua | ||
│ └── pad.lua | │ └── pad.lua | ||
├── scripts | ├── scripts | ||
Line 2,225: | Line 1,540: | ||
* 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:=== |