addrom

Simple tool for adding a rom entry to a Pandora's Box 3 list.dat
Log | Files | Refs | README | LICENSE

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.