tREADME.md - addrom - Simple tool for adding a rom entry to a Pandora's Box 3 list.dat
DIR Log
DIR Files
DIR Refs
DIR README
DIR LICENSE
---
tREADME.md (1657B)
---
1 addrom
2 ======
3
4 Simple tool to add a rom entry to a PB3 list.dat.
5
6 addrom lets you add a rom entry into a Pandora's Box 3 list.dat rom file.
7 It reads an input file or starts from scratch, writes rom fields according the
8 file format, calculates the total number of entries and modifies that reference
9 in the file, and writes the resulting new file to the input file or another
10 output file.
11
12 Works only for Pandora's Box 3 520+20/540 in 1 (jamma).
13
14 Installation
15 ------------
16 Edit config.mk for customizing compilation options and installation paths.
17
18 make (building)
19 make install (install, may need privileges, default in /usr/local)
20 make clean (cleaning)
21
22 Usage
23 -----
24 Read the manual page.
25
26 File format
27 -----------
28 The file is composed of a header and a concatenation of rom entries
29 with the following fields:
30
31 HEADER 16B
32 Header size 4B
33 Number of games 4B
34 ENTRY 120B
35 Chinese name 64B
36 English name 32B
37 ROM name 16B
38 Magic number (?) 8B
39 ENTRY...
40
41 The number of games field is calculated in the following manner:
42
43 Field = (decimal number of games << 32 << 6) / 0x88888888
44
45 You can reverse the calculation with this:
46
47 Decimal number of games = (field * 0x88888889) >> 32 >> 6
48
49 Thanks
50 ------
51 To Meng Xipeng <mengxipeng@gmail.com> for the instructions about the list.dat
52 file format.
53
54 To Maastaz Raïk ([Youtube channel](https://www.youtube.com/user/maastahraik))
55 for testing on real hardware the correctness of the generated list.dat files.