README.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.