RAM map (Boktai 1)

This is the RAM map for Boktai 1 (U). Go to ROM map.

EWRAM

Address	Type	Description
0x020011c0	i32	Solar sensor: Calibrated level (0=dark, 140=max brightness. Calibrated level = calibration - raw level, then clamp to 0-140)
0x020011c2	i32	Solar sensor: Bars. Calculated from calibrated level (0=dark, 8=max brightness)
0x0203c800	u16[1024]	RNG table (generated by the bootstrap RNG once on power-on)
0x0203d800	byte[?]	#Stat struct
0x0203e000	byte[?]	Stat struct - backup (created on screen transitions, reloaded on death, saved to save file when saving)
0x0203e800	byte[?]	#World struct
0x0203ec00	byte[?]	World struct - backup
0x0203f000	byte[?]	#Scratch struct

Stat struct

Address	Type	Description
0x0203d80a	i16[7]	Grenade amounts
0x0203d88c	i16	Equipped lens
0x0203d88e	i16	Equipped frame
0x0203d892	i16	Equipped grenades
0x0203d892	i16	Equipped battery
0x0203d8b0	i32	Unlock Astro battery (must be set to *(*0x03001c90 + 0x7dc))
0x0203d8f0	i16[3]	Django position
0x0203d91e	i32	Solar sensor: Calibrated level (see 0x020011c0)
0x0203dc18	i16	Item inventory size
0x0203dc1a	i16[42]	Item inventory IDs
0x0203dc6e	i16[42]	Item inventory amounts
0x0203dcc4	i32	Lens inventory (bitmask, 1 bit per lens and level)
0x0203dcc8	i32	Frame inventory (bitmask)
0x0203dcd0	i32	Battery inventory (bitmask)
0x0203dcd8	i16[8]	Lens EXP

World struct

Address	Type	Description
0x0203e8c5:6	bit[64]	"Chest opened" flags for current area (resets on area change)

Scratch struct

Address	Type	Description
0x0203f1b4	u8[13]	Carmilla: Pattern list - one of 4 hardcoded lists will be chosen at random when starting the fight
0x0203f1c1	u8[3]	Carmilla: Pattern pool (indices into pattern list)
0x0203f1c4	u8[3]	Carmilla: ???
0x0203f1c7	u8	Carmilla: Next pool value
0x0203f1c8	u8	Carmilla: Pattern index (index into pattern pool) - the (current/next?) pattern is pattern_list[pattern_pool[next_pool_value]]

IWRAM

Address	Type	Description
0x03000630	i32	Solar sensor interface: State (0=measuring, 1=resetting, 2=idle)
0x03000634	i32	Solar sensor interface: Counter (0-511, counts half-cycles of the 74LV4040 counter chip)
0x0300063c	i32	Solar sensor interface: shift out (next value to be written to GPIO_DATA)
0x03000648	void*	Script directory: Script index pointer
0x03000648	void*	Script directory: Script count
0x03000108	treasure_data*	Pointer to this map's #Treasure data (NULL if map has no treasures)
0x03001c2c	i16	Solar sensor: Bars. See 0x020011c2.
0x03001c90	void*	Pointer to Django's actor data?
+ 0x18	i32	Current lens level
+ 0x7dc	i32	Astro battery unlock password
0x03001cc8	void*	Pointer to linked list of bat enemies?
0x03004478	i32	Bootstrap RNG seed
0x030044f8	i32	Solar sensor interface: Is enabled (true/false)
0x030044fc	i32	Solar sensor interface: Last result (GPIO_DATA & 8)
0x03004508	i32	Solar sensor interface: Raw level (counter / 2 when GPIO_DATA & 8 becomes nonzero. 0=max brightness, 255=dark)
0x03004520	void*	Bytecode: Program counter
0x03004524	void*	Bytecode: Return value
0x0300450c	i32	Solar sensor interface: Timer interval (TM3CNT_LO will be set to -this value)
0x03004610	struct*	Pointer to current Map file descriptor (usually/always 0x02000010)
+ 0x00	i32	Number of Zones
+ 0x04	void*	Pointer to map file tile data
+ 0x0c	void*	Pointer to map file zones
+ 0x10	void*	Pointer to map file unknown block 1
+ 0x14	void*	Pointer to map file unknown block 2
+ 0x24	zone_callback[]	List of zone callbacks: struct zone_callback { /* offset 0x08 */ u16 zone_id; /* offset 0x24 */ void* bytecode_ptr; // Generally points into a Script };
0x03004620	i32	RNG index
0x030046a8	struct*	Pointer to #Save data header (usually/always? 0x03000768)
0x030046c4	struct*	Pointer to #Global save data (always 0x03000750)
0x030046e8	i16[3]	Camera position

Save data header

Offset	Type	Description
0x2c	char[?]	Player name

Global save data

Offset	Type	Description
0x00	i32	Global frame counter
0x04	i32	Solar sensor calibration (raw level - 2 at time of calibration)

Other structs

Treasure data

// pointer to this struct is at 0x03000108
struct treasure_data {
  /* offset 0x24 */ treasure_node* list_head;
};

struct treasure_node {
  /* offset 0x14 */ treasure_trigger* trigger;
  /* offset 0x28 */ u32 callback_script_id;
  /* offset 0x2c */ u32 callback_args[?];
  /* offset 0xb8 */ treasure_node* list_next;
};

struct treasure_trigger {
  /* offset 0x20 */ i16 position[3];
};

EEPROM

Byte address	Byte size	Description
0x0000	0x18	#Global save data
0x00c0	0x28	Slot 1: #Save data header
0x0200	0x28	Slot 2: #Save data header
0x0340	0x400	Slot 1: #World struct
0x0780	0x418	Slot 1: #Stat struct
0x0dc0	0x400	Slot 2: #World struct
0x1200	0x418	Slot 2: #Stat struct
0x1840	0x168
0x1a40	0x168

Each block is followed by its checksum, see Save data checksums.