Skip to content

Commit

Permalink
Collapsible sections and minor changes
Browse files Browse the repository at this point in the history
  • Loading branch information
@israpps
israpps committed Jul 22, 2021
1 parent c081059 commit 71aea6c
Showing 1 changed file with 70 additions and 22 deletions.
92 changes: 70 additions & 22 deletions README.md
View file
Expand Up @@ -30,42 +30,57 @@ For an updated compatibility list, you can visit the OPL-CL site at:

<http://sx.sytes.net/oplcl/games.aspx>

## Release types

<details>
<summary> <b> Release types </b> </summary>
<p>

Open PS2 Loader bundle included several types of the same OPL version. These
types come with more or fewer features included.

| Type (can be a combination) | Description |
| --------------------------- | --------------------------------------------------------------------------------------- |
| "Release" | Regular OPL release with GSM, IGS, PADEMU, VMC, PS2RD Cheat Engine & Parental Controls. |
| "DTL_T10000" | OPL for TOOLs (DevKit PS2) |
| "IGS" | OPL with InGame Screenshot feature. |
| "PADEMU" | OPL with Pad Emulation for DS3 & DS4. |
| "RTL" | OPL with the right to left language support. |
| `Release` | Regular OPL release with GSM, IGS, PADEMU, VMC, PS2RD Cheat Engine & Parental Controls. |
| `DTL_T10000` | OPL for TOOLs (DevKit PS2) |
| `IGS` | OPL with InGame Screenshot feature. |
| `PADEMU` | OPL with Pad Emulation for DS3 & DS4. |
| `RTL` | OPL with the right to left language support. |

</p>
</details>

## How to use
<details>
<summary> <b> How to use </b> </summary>
<p>

OPL uses the following directory tree structure across HDD, SMB, and
USB modes:

| Folder | Description | Modes |
| ------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------- |
| "CD" | for games on CD media - i.e. blue-bottom discs | USB and SMB |
| "DVD" | for DVD5 and DVD9 images if using the NTFS file system on USB or SMB; DVD9 images must be split and placed into the device root if using the FAT32 file system on USB or SMB | USB and SMB |
| "VMC" | for Virtual Memory Card images - from 8MB up to 64MB | all |
| "CFG" | for saving per-game configuration files | all |
| "ART" | for game art images | all |
| "THM" | for themes support | all |
| "LNG" | for translation support | all |
| "CHT" | for cheats files | all |
| `CD` | for games on CD media - i.e. blue-bottom discs | USB and SMB |
| `DVD` | for DVD5 and DVD9 images if using the NTFS file system on USB or SMB; DVD9 images must be split and placed into the device root if using the FAT32 file system on USB or SMB | USB and SMB |
| `VMC` | for Virtual Memory Card images - from 8MB up to 64MB | all |
| `CFG` | for saving per-game configuration files | all |
| `ART` | for game art images | all |
| `THM` | for themes support | all |
| `LNG` | for translation support | all |
| `CHT` | for cheats files | all |

OPL will automatically create the above directory structure the first time you launch it and enable your favourite device.

For HDD users, OPL will read hdd0:\_\_common/OPL/conf_hdd.cfg for the config entry "hdd_partition" to use as your OPL partition.
If not found a config file and a 128Mb +OPL partition will be created. You can edit the config if you wish to use/create a different partition.
All partitions created by OPL will be 128Mb (it is not recommended to enlarge partitions as it will break LBAs, instead remove and recreate manually with uLaunchELF at a larger size if needed).

## USB
</p>
</details>


<details>
<summary> <b> USB </b> </summary>
<p>


Game files on USB must be perfectly defragmented either file by file or
by whole drive, and Dual Layer DVD9 images must be split to avoid the 4GB
Expand All @@ -76,7 +91,13 @@ Repeat it once you faced defragmenting problem again.
You also need a PC program to convert or split games into USB Advance/Extreme
format, such as USBUtil 2.0.

## SMB
</p>
</details>


<details>
<summary> <b> SMB </b> </summary>
<p>

For loading games by SMB protocol, you need to share a folder (ex: PS2SMB)
on the host machine or NAS device and make sure that it has full read and
Expand All @@ -85,15 +106,27 @@ are supported using the folder structure above with the bonus that
DVD9 images don't have to be split if your SMB device uses the NTFS or
EXT3/4 file system.

## HDD
</p>
</details>


<details>
<summary> <b> HDD </b> </summary>
<p>

For PS2, 48-bit LBA internal HDDs up to 2TB are supported. They have to be
formatted with either HDLoader or uLaunchELF (uLaunchELF is recommended).

To launch OPL, you can use any of the existing methods for loading an
executable elf.

## PS3
</p>
</details>


<details>
<summary> <b> PS3 </b> </summary>
<p>

On PS3, you need an original SwapMagic 3.6+ or 3.8 disc (at the moment
there aren't any other options). The steps for loading OPL on a PS3 are:
Expand All @@ -110,9 +143,24 @@ SMBOOT2.ELF = UP + R1
SMBOOT3.ELF = UP + R2

Note: on PS3, only USB and SMB modes are supported.
</p>
</details>


<details>
<summary> <b> Some notes for DEVS </b> </summary>
<p>

Open PS2 Loader needs the [__latest PS2SDK__](https://github.com/ps2dev/ps2sdk)

</p>
</details>

## Some notes for devs
<details>
<summary> <b> OPL Archive </b> </summary>
<p>

Open PS2 Loader needs the latest PS2SDK:
Since 5/07/2021 every OPL build dispatched to the release section of this repository will be uploaded to a mega account, you can access the archive by clicking the mega badge on top of this readme

<https://github.com/ps2dev/ps2sdk>
</p>
</details>

0 comments on commit 71aea6c

Please sign in to comment.