How to build - aalesv/2boost GitHub Wiki

Limitations

Build process currently tested under Cygwin, Debian Linux running on Windows Subsystem for Linux (WSL) version 2 and under Windows. If operating system is incorrectly detected, 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 Unix-like environment.

Install required software

Install 2Boost Toolchain (preferred) - download and unpack to a directory. Then please skip to the next chapter.

If you don't want to use 2Boost Toolchain, please install GCC 12.3 and Binutils 2.4.0 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 (not needed if you installed 2Boost Toolchain):

  • 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

  • Edit PYTHON_PATH and/or PYTHON_BIN variables so that they contain full path to python binary and ints name. You can also do it in command line, for example make all PYTHON=C:\python3.9\python.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:

If you are using 2Boost Toolchain:

make A8DK100P orig-rom=/cygdrive/c/temp/read-image.bin DOPATCH=-yes

If you are using GNU SH toolchain

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.