ph/INSTALL.md

Install

Contents:

• Prerequisites
• Build the ROM
  • Matching the base ROM
  • Building with non-matching code

Prerequisites

1. Use one of these platforms:
   • Windows (recommended)
   • Linux
2. Install the following:
   • Python 3.11+ and pip
   • GCC 9+
   • Ninja
   • On Linux: Wine/Wibo
3. Install the Python dependencies:

python -m pip install -r tools/requirements.txt

4. Install pre-commit hooks:

pre-commit install

5. Run the setup script:

python tools/setup.py

6. Run the Ninja configure script:

python tools/configure.py <eur|usa>

Important

Rerun configure.py often to ensure that all C/C++ code gets compiled.

Note

For Linux users: If you plan to use Wibo instead of Wine, run configure.py with -w <path/to/wibo>.

7. Put one or more base ROMs in the /extract/ directory of this repository.

Now you can run ninja to build a ROM for the chosen version.

Matching the base ROM

This is optional! You only need to follow these steps if you want a matching ROM.

First, extract the ARM7 BIOS from your DS device. Put the ARM7 BIOS in the root directory of this repository, and verify that your dumped BIOS matches the one below:

File name	SHA1
arm7_bios.bin	6ee830c7f552c5bf194c20a2c13d5bb44bdb5c03

Now, rerun configure.py so it can update build.ninja to build a matching ROM.