pcsx2/fps2bios/kernel/iopload/include/romdir.h

116 lines
3.7 KiB
C
Raw Normal View History

#ifndef __ROMDIR_H__
#define __ROMDIR_H__
#include <tamtypes.h>
// an entry in a romdir table. a romdir table is an array of these.
// gets filled in by searchRomDir()
typedef struct romdir_entry {
char name[10]; //+00
short extSize; //+0A
int fileSize; //+0C
} __attribute__ ((packed)) ROMDIR_ENTRY;
// info about a file in a romdir
// gets filled in by searchFileInRom()
typedef struct {
ROMDIR_ENTRY* entry; // pointer to the file's ROMDIR_ENTRY
u32 fileData; // address of file contents
u32 extData; // address of file's ext info
} ROMFILE_INFO;
// info about the location of a romdir table
typedef struct {
u32 romPtr; //+00
ROMDIR_ENTRY* romdirPtr;//+04
u32 extinfoPtr; //+08
} ROMDIR_INFO;
typedef struct romfs {
char* filename; //+00
int fd; //+04
int size; //+08
ROMDIR_INFO romdirInfo; //+0C
} ROMFS;
// rounds off a value to the next multiple
#define ROUND_UP(num, multiple) (((num)+multiple-1) & (~(multiple-1)))
// searches between beginning and end addresses for a romdir structure.
// if found it returns info about it in romDirInfo.
//
// args: address to start searching from
// address to stop searching at
// gets filled in with info if found
// returns: a pointer to the filled in romDirInfo if successful
// NULL if error
extern ROMDIR_INFO* searchRomDir(const u32* searchStartAddr, const u32* searchEndAddr, ROMDIR_INFO* romDirInfo);
// find a file in the romdir table and return info about it
//
// args: info about romdir to search through
// filename to search for
// structure to get info about file into
// returns: a pointer to fileinfo if successful
// NULL otherwise
extern ROMFILE_INFO* searchFileInRom(const ROMDIR_INFO* romdirInfo, const char* filename, ROMFILE_INFO* fileinfo);
// gets a hex number from *addr and updates the pointer
//
// args: pointer to string buffer containing a hex number
// returns: the value of the hex number
extern u32 getHexNumber(char** addr);
/*
IOPBTCONF file format
=====================
each line is one of this:
1. loading address of IOP kernel
Format: @<HEXNUMBER>
Example: @800
Default: 0
Description: starting with <HEXNUMBER> (or 0 if not specified) the loader will
place modules in memory on 256 boundaries at +0x30 (the first 48 bytes are
reserved for info about the following module)
2. address of function to be called while loading of IOP kernel
Format: !addr <HEXNUMBER>
Description: the code indicated by <HEXNUMBER> will be run on kernel loading
3. name of (parent) included IOPBTCONF
Format: !include <NAME>
Description: allow to have another file with same format to be loaded
recursively; support for this is limited because of the BUGGY parsing;
Note: you can have such option only at the begining of IOPBTCONF and the
inclusion can be made without getting stucked in recursion like this:
ioprp1.img contains IOPBTCONF1 (!include IOPBTCON2) and IOPBTCONF11
ioprp2.img contains IOPBTCONF2 (!include IOPBTCONF1)
ioprp.img contains IOPBTCONF (!include IOPBTCONF2<EOL>!include IOPBTCONF11)
rom0 contains IOPBTCONF and IOPBTCON2
udnl cdrom0:ioprp1.img cdrom0:ioprp2.img cdrom0:ioprp.img
the starting of the chain can be named IOPBTCONF only
also you can include only from the previous romz
4. comment
Format: #<TEXT>
Example: #APPLOAD
Description: you can have comments on a line that starts with #
5. modules that have to be loaded after a reset
Format: <MODULENAME>
Example: SYSMEM
Description: each line of IOPBTCONF usualy have a module name; the order the
modules appear in the list is the order they are loaded as IOP kernel
--------------------------------
Notes:
- each line ends with <EOL>, that is 0x0A
- in the final loading list the first 2 positions must be SYSMEM and LOADCORE
*/
#endif /* __ROMDIR_H__ */