Download 2.0 Eboot Loader v0.5 pour PSP

EBOOT loader v0.5  by Fanjita
  =============================

(based on excellent groundwork by Saotome)

NOTE : THIS PROGRAM ALLOWS YOU TO RUN HOMEBREW EBOOTs ON YOUR v2.0 PSP.
  IT CANNOT LOAD EBOOT.PBPs THAT CONTAIN FIRMWARE UPDATES.

This program builds on the work done by Saotome to load homebrew EBOOT.PBPs
into PSPs with v2.0 firmware, using the TIFF exploit.  It will not work
on any other firmware version - including v2.01.

It currently cannot run all known homebrew, but it uses a number of tricks
to get substantially further than ever before.  Known limitations are:

- Can't run kernel-mode applications.
- Some minor system calls are still unsupported.

It's also still very much in development, so the user interface isn't
very nice to look at, and a lot of the output is cryptic.


To use:
-------

- Extract all the files into the root folder (e.g. "F:\") of your memory
  stick.  You need these files to be in the right place:
  \PSP\PHOTO\EBOOT Loader\RUN_L.TIF
  \PSP\PHOTO\EBOOT Loader\AAA.PNG
  \PSP\PHOTO\EBOOT Loader 03\RUN_LALT.TIF
  \PSP\PHOTO\EBOOT Loader 03\AAA.PNG
  \L.BIN
  \L_ALT.BIN

- Copy the homebrew you want to run to your memory stick.  Usually, this
  means unzipping a directory that contains an EBOOT.PBP file to somewhere
  under \PSP\GAME\.  The exact location and folder name usually doesn't matter,
  but for best compatibility you should try to use the same names as
  originally shown in the homebrew ZIP file.

  If the instructions with the homebrew contain separate steps for v1.0 and
  v1.5 firmwares, then usually you'll get best results by following the
  v1.0 instructions.

- Make sure you have a custom wallpaper set.  Any image will do.

- Use the PSP's built-in photo viewer to open the "EBOOT loader" folder,
  this will cause the loader to start.  If your PSP hangs at this point,
  then try the following:
  - check your firmware version.  This loader is for v2.0 ONLY.
  - check that you have the loader files in the correct place (see above)
  - turn your PSP completely off, then back on again.  The loader works
  best on a freshly-rebooted PSP.
  - try setting a custom background - some people have reported that it
  works better if you use a custom wallpaper (any image).

- The loader displays a list of files in \PSP\GAME.  Use the up and down
  buttons to change the current selection (highlighted in red), and X to
  open an EBOOT.PBP file or browse into a folder.

- Once you select an EBOOT.PBP to load, after a few moments, the loader
  will either display an error message, or give you the option to run
  the application.

- To exit the application, you need to reboot your PSP.  You can do this
  by removing the battery, or holding the power switch for at least 10
  seconds.


Using multiple versions of EBOOT loader
---------------------------------------

At the moment, the Sega Master System emulator only works with EBOOT loader
v0.3, and is broken in later versions (for some reason it is extremely
sensitive to tiny changes in the code - at the start of v0.5 development,
it worked fine, but it broke again for no apparent reason).

This zip includes v0.3 in the folder "EBOOT loader 03" - just open this
folder instead of the main "EBOOT loader" folder, to run this specially-
modified version, that is designed to work alongside v0.5.


Troubleshooting
---------------

If you have problems with an individual EBOOT getting to the "Press X to
launch the program" screen, but crashing immediately after, here are a
few things to try:

- Check whether it is already on the list of non-working EBOOTs below.
- Make sure you are trying to run it as the first thing you do after a
  clean reboot of your PSP
- Use v1.0 EBOOTs in preference to v1.5.
- Make sure that you read any README supplied with the homebrew, and followed
  the installation instructions (for v1.0, preferably) carefully.
- Make sure that any support files (e.g. WAV files, graphics files)
  contained in the ZIP file are copied into the same place on the memory stick,
  relative to the EBOOT file.
- Experiment with the launcher options on the final confirmation screen:
  try starting with the square button, or with the left trigger button if
  the option is offered.
- Check the forums at pspupdates.com - someone might already have found a
  way to make this EBOOT work.
- For advanced users - try searching the EBOOT with a hex editor, looking
  for file paths - e.g. "ms0:/psp/game/sms" found in the SMS emulator.
  If you find a path like this, try moving the EBOOT into this folder
  on the memory stick.

If you find that one of these steps helps, then please send me details
on what you did to make the EBOOT work - I can build the workarounds
automatically into the next version of the loader.

NOTE: If the EBOOT loader aborted the process before reaching the "press X"
screen, then don't bother trying these steps - there's no way that EBOOT
will currently work, but please remember to send the details of the error
message to me, so that I can attempt to change the code to make it work.


Future plans:
-------------

- Improve compatibility
- Tidy up the UI and make it more exciting to look at
- Reduce the number of components (TIF, PNG, L.BIN), but this structure is
  easiest to work with at the moment.
- Try to work with LUAPlayer
- Improve off-switch handling (maybe even allow clean exit from applications
  using Abu's 'Hello World 2.0' ideas)
- Allow loading of EBOOTs via wi-fi


Compatibility Status:
---------------------

This is the list of known incompatible EBOOTs:
  - Flower demo by Moppi : kernel-mode
  - Tail Tale            : kernel-mode
  - Blinky's 'Clocks'    : kernel-mode
  - LUA Player           : kernel-mode (but there's a good chance this
  can be rebuilt to run in user-mode in the
  near future).
  - Nethack              : kernel-mode
  - ScummVM emulator     : kernel-mode
  - Bochs emulator       : kernel-mode
  - UMD emulators        : kernel-mode
  - ISO loaders          : kernel-mode
  - File Assistant       : kernel-mode
  - PSPRadio 0.34        : kernel-mode
  - PSPDA/Notepad        : kernel-mode
  - DosBox               : kernel-mode
  - Basilisk II          : Kernel-mode
  - Hackah Tetris        : kernel-mode
  - TEDZero Copier       : kernel-mode
  - Puzzle Sudoku v0.03  : Crashes loading into memory
  - Solitaire            : Crashes loading into memory
  - Arkanoid             : Crashes loading into memory
  - MAME                 : Starts, but fails when loading ROMs
  - NesterJ              : Starts, but fails when loading ROMs
  - PSP Pacman           : Starts, but fails to load its own files.
  - CrazyPaint v0.3      : crashes at launch
  - PSP Calculator v0.2  : crashes at launch
  - DoomPSP              : mixed reports, some say it works, some say
  it crashes at launch
  - RIN v1.32            : Crashes at launch
  - Puyo Puyo            : Crashes at launch
  - Aozora               : Crashes at launch
  - MikMod player        : Crashes at launch
  - Bookr 0.6            : Crashes at launch
  - PSPKick 2.0          : Crashes at launch
  - Beats of Rage        : Crashes at launch
  - Bookr 0.6.0          : Crashes at launch
  - Xynth                : Crashes at launch
  - SmashGPSP            : Crashes at launch
  - DualTetris           : Crashes at launch
  - PSPReader 1.1.2      : Crashes at launch
  - Attack of the Mutants 0.3 : Crashes at launch
  - Sega Master System / Game Gear emulator - crashes at launch
  - use EBOOT loader 0.3 for now.
  - PSPChess             : Missing NID 93440B11

(With the cooperation of the authors, it's possible that many of the
  kernel-mode apps can be converted to user-mode).

This is the list of known compatible EBOOTs:
  - 3D dot ball by Aerol33t                                  
  - Attack of the Mutants 0.2
  - BMP loader 0.2
  - Casino Addict
  - Ghost In The Matrix v0.2
  - Nem's Hello World
  - Original Tetris JP
  - PSP Blackjack
  - PSP Calc 0.1
  - PSP Mandel Explorer 1.0
  - PSP Quake                                 - must be placed in \psp\game\quake-psp
  - PSP Schedule 0.25
  - PSP SimpleTurn
  - PSP Sokoban 0.9
  - PSPaint
  - PSPectrum 0.1                             - must be placed in \psp\game\pspectrum
  - PSPong
  - PSPReader 1.1.2
  - PSPuzzle v0.7
  - Sega Master System / Game Gear emulator   - must be placed in \psp\game\sms
  and use loader 0.3 to run.
  - Simon v0.7
  - Tetris Portable 0.3
  - TextViewer 0.3
  - Various sample applications from PSPSDK

New Working EBOOTs in this release:
  - PSP Schedule 0.25
  - PSP Sokoban 0.9
  - Tetris Portable 0.3
  - Sega Master System / Game Gear emulator

EBOOTs broken with this release:
  - Sega Master System / Game Gear emulator - but workaround supplied.

EBOOTs with partial progress made in this release:
  - MAME                 : Starts, but fails when loading ROMs
  - NesterJ              : Starts, but fails when loading ROMs
  - PSP Pacman           : Starts, but fails to load its own files.

As you can see, I haven't tested a huge number yet, so please let me know
if you test and can confirm compatibility of other EBOOTs.

If you find an EBOOT that doesn't work, then please email me at

  fanjita@fanjita.org
  
  with details of:
  - the name of the EBOOT that failed, and where to get it from
  - the last message that was displayed on the PSP screen
  - your firmware version, and PSP region (US, EU, JP).

NOTE: Kernel-mode support is currently not possible on v2.0 firmware, until
someone finds a way to access the kernel memory space.


Acknowledgements:
-----------------
  
  This app wouldn't have been possible without the toc2rta TIFF exploit code,
or Saotome's hard work on the first beta EBOOT loader, or the support of
the fantastic folks at the ps2dev.org forums.

  If you have found this program useful and want to encourage further
development, please consider donating a small amount via paypal to
fanjita@fanjita.org.  To be able to work effectively on it, I need to
buy a second PSP (to understand the v1.5 environment more fully) and more
memory stick storage for testing.  As little as a $1 donation would be
enormously helpful.  Thanks.

Change history:
---------------

  v0.5 : More compatibility enhancements, bug fixes
  - Better argc/argv handling, prevents a common cause of startup
  crashes (e.g. PSP Schedule).
  - Made the 'return to chooser' function more stable.  It now shouldn't
  affect how well the next EBOOT loads.
  - Improved file scanning speed - large EBOOTs should load much faster.
  - Added 'alternate startup parameters', use this to run Sega Master System
  emulator which was broken in v0.4.
  - Introduced 'EBOOT signatures' : known workarounds for specific
  EBOOTs should now be turned on automatically, and install
  location can be automatically checked if a specific path is
  required.
  - Added support for .init sections, should help avoid a few more
  startup crashes.
  - Added option to return to EBOOT chooser on final confirmation menu.
  - Version number shown on screen fixed.
  - Lots more info in readme file.
  - Various minor bugfixes.

  v0.4 : Usability & reliability enhancements
  - Return to menu if possible after failed load.  NOTE : this is
  a bit flaky, and mainly designed for quick checks for kernel-mode
  apps, etc.  If something crashes after you ran through a few EBOOTs
  that wouldn't load, it's worth retrying it immediately after a
  reboot.
  - Experimented with exception handlers for extra diagnostics, but this
  is not possible in user-mode (and anyway the appropriate syscall code is
  unknown for v2.0).
  - Fixed overflow with more than 19 directory entries - now apps that
  failed just after EBOOT selection will get further.
  - Added set up of argv, argc to supply path arguments - helps for
  Ghost In The Matrix, possibly others.
  - Changed load address to 0x0860000, to allow more headroom for increased
  loader complexity.  Also begun integrating Abu's loader code with the
  TIF file.

  v0.3 : Compatibility enhancements
  - Allow browsing of multiple EBOOTs
  - Change directory to selected EBOOT location
  (adds sounds to Attack of the Mutants)
  - Restore screen mode before running EBOOT
  (improves reliability)
  - Allow multiple text segments in ELF

  v0.2 : Original version, ported to C from original v0.1 EBOOT loader by
  Saotome.