Awesome

TPP1

This repository aims to define and specify a GB/GBC mapper.

There is a test ROM available here. In order to build it, you will need RGBDS version 0.5.1 or later.

Once that is done, you can build the test ROM using the make command in the repository's main directory; the output will be called testrom.gb. Using make clean will remove the built files.

The compilation of the test ROM can be parameterized via four variables passed to make, those being ROMSIZE, RAMSIZE, RTC and RUMBLE. For instance, in order to set all of them to their maximum possible values, compile the test ROM as make ROMSIZE=F RAMSIZE=9 RTC=ON RUMBLE=MULTI.

The values these variables can take are as follows:

ROMSIZE: sets the size of the ROM. Default value is 9.

Value	Banks	Size
0	2	32 kiB
1	4	64 kiB
2	8	128 kiB
3	16	256 kiB
4	32	512 kiB
5	64	1 MiB
6	128	2 MiB
7	256	4 MiB
8	512	8 MiB
9	1,024	16 MiB
A	2,048	32 MiB
B	4,096	64 MiB
C	8,192	128 MiB
D	16,384	256 MiB
E	32,768	512 MiB
F	65,536	1 GiB

RAMSIZE: sets the size of the SRAM. Default value is 5.

Value	Banks	Size
0	0	no SRAM
1	1	8 kiB
2	2	16 kiB
3	4	32 kiB
4	8	64 kiB
5	16	128 kiB
6	32	256 kiB
7	64	512 kiB
8	128	1 MiB
9	256	2 MiB

RTC: enables or disables RTC support in the header. Any non-empty value will enable RTC support; set the variable to an empty value to disable it. Default value is on.

RUMBLE: sets the type of rumble supported in the header. Setting the variable to the value MULTI will enable three rumble speeds; any other non-empty value will enable a single speed, and an empty value will disable rumble altogether. Default is 3 speeds.