How to build - aalesv/2boost GitHub Wiki

Limitations

Build process currently tested under Debian Linux running on Windows Subsystem for Linux (WSL) version 2 and under Windows. If operating system is incorrectly detected (most likely it will happen when using Cygwin) set WINDOWS variable to 0 if environment is Unix-like and 1 for Windows-like environment. For example run make YOUR_CAL_ID WINDOWS=0 when using Cygwin.

Install required software

Install GCC 12.2 (preferred) and Binutils 2.4.0 (preferred) or install GNUSH toolchain (not recommended but supported).

If you have HEW (High-performance Embedded Workshop) by Renesas installed most likely GNUSH toolchain is already installed.

Install Swiss File Knife https://sourceforge.net/projects/swissfileknife/

Prepare environment

Add path to make utility to PATH environment variable

Get 2Boost sources

Edit Makefile:

  • Edit WINROOT (if you are using Windows) variable or NIXROOT (if you are using *nix) variable so that it contains full path to toolchain root folder. You can also set these variables in command line, for example make all NIXROOT=/usr/local/sh-toolchain

  • Edit SFK variable so that it contains full path to sfkx64.exe

Build

Copy your ROM to ROM\ folder of 2Boost sources and rename it with corresponding CAL id. For example if your ROM has CAL ID A8DK100P, rename it to A8DK100P.bin

Open command line and go to 2Boost sources folder

Run make your_cal_id DOPATCH=-yes

The result is build\your_cal_id-patched.bin file

Example:

make A8DK100P DOPATCH=-yes

will produce build\A8DK100P-patched.bin

N.B. Correct checksums before flashing!

Build (advanced)

If you do not specify DOPATCH=-yes, no patching is done.

You can specify orig-rom=path\to\your\rom.bin instead of copying it to ROM\ folder. The result will still be build\your_cal_id-patched.bin file.

Example:

make A8DK100P orig-rom=c:\temp\read-image.bin DOPATCH=-yes

will produce build\A8DK100P-patched.bin

N.B. Do not use orig-rom=path\to\your\rom.bin when running make all command

make targets

make all

Build all CAL IDs. Specify DOPATCH=-yes to patch your ROMs.

make CALID

Specify CALID to build only that target, for example make A8DK100P will build files only for A8DK100P. Specify DOPATCH=-yes to patch your ROM.

make clean

Clean build directory.

make help

Help message.

make list

List for possible CAL IDs.

make tests

Build test ROM. Specify CALID='CALID' to build only that target, or CALID=all to make all targets. Specify DOPATCH=-yes to patch your ROM.