mirror of
https://github.com/ApacheThunder/GBA-Exploader.git
synced 2025-06-18 19:45:39 -04:00
540515c7fc
* Can now use gbaframes specific to a gba rom being loaded to ram/flash. Have a bmp file with filename matching the game rom being flashed in GBA_SIGN path. If it finds a matching BMP it will use that before falling back to the default gbaframe.bmp paths. * nds-bootstrap now used for booting retail NDS roms from file browser. Note that currently GBA-Exploader does not create new save files so only games with existing save files (currently hardcoded to GBA_SAV path like with GBA games) can be booted with this.
310 lines
9.5 KiB
C
310 lines
9.5 KiB
C
/*---------------------------------------------------------------------------------
|
|
|
|
memory.h -- Declaration of memory regions
|
|
|
|
|
|
Copyright (C) 2005 Michael Noland (joat) and Jason Rogers (dovoto)
|
|
|
|
This software is provided 'as-is', without any express or implied
|
|
warranty. In no event will the authors be held liable for any
|
|
damages arising from the use of this software.
|
|
|
|
Permission is granted to anyone to use this software for any
|
|
purpose, including commercial applications, and to alter it and
|
|
redistribute it freely, subject to the following restrictions:
|
|
|
|
1. The origin of this software must not be misrepresented; you
|
|
must not claim that you wrote the original software. If you use
|
|
this software in a product, an acknowledgment in the product
|
|
documentation would be appreciated but is not required.
|
|
|
|
2. Altered source versions must be plainly marked as such, and
|
|
must not be misrepresented as being the original software.
|
|
|
|
3. This notice may not be removed or altered from any source
|
|
distribution.
|
|
|
|
---------------------------------------------------------------------------------*/
|
|
/*! \file memory.h
|
|
\brief Defines for many of the regions of memory on the DS as well as a few control functions for memory bus access
|
|
*/
|
|
|
|
#ifndef NDS_MEMORY_INCLUDE
|
|
#define NDS_MEMORY_INCLUDE
|
|
|
|
#include "ndstypes.h"
|
|
#include <assert.h>
|
|
|
|
|
|
#ifdef ARM9
|
|
#define REG_EXMEMCNT (*(vu16*)0x04000204)
|
|
#else
|
|
#define REG_EXMEMSTAT (*(vu16*)0x04000204)
|
|
#endif
|
|
|
|
#define ARM7_MAIN_RAM_PRIORITY BIT(15)
|
|
#define ARM7_OWNS_CARD BIT(11)
|
|
#define ARM7_OWNS_ROM BIT(7)
|
|
|
|
#define REG_MBK1 ((vu8*)0x04004040) /* WRAM_A 0..3 */
|
|
#define REG_MBK2 ((vu8*)0x04004044) /* WRAM_B 0..3 */
|
|
#define REG_MBK3 ((vu8*)0x04004048) /* WRAM_B 4..7 */
|
|
#define REG_MBK4 ((vu8*)0x0400404C) /* WRAM_C 0..3 */
|
|
#define REG_MBK5 ((vu8*)0x04004050) /* WRAM_C 4..7 */
|
|
#define REG_MBK6 (*(vu32*)0x04004054)
|
|
#define REG_MBK7 (*(vu32*)0x04004058)
|
|
#define REG_MBK8 (*(vu32*)0x0400405C)
|
|
#define REG_MBK9 (*(vu32*)0x04004060)
|
|
|
|
// Protection register (write-once sadly)
|
|
#ifdef ARM7
|
|
#define PROTECTION (*(vu32*)0x04000308)
|
|
#endif
|
|
|
|
//! 8 bit pointer to the start of all the ram.
|
|
#define ALLRAM ((u8*)0x00000000)
|
|
|
|
//! 8 bit pointer to main ram.
|
|
#define MAINRAM8 ((u8*)0x02000000)
|
|
//! 16 bit pointer to main ram.
|
|
#define MAINRAM16 ((u16*)0x02000000)
|
|
//! 32 bit pointer to main ram.
|
|
#define MAINRAM32 ((u32*)0x02000000)
|
|
|
|
|
|
// TODO: fixme: shared RAM
|
|
|
|
// GBA_BUS is volatile, while GBAROM is not
|
|
//! 16 bit volatile pointer to the GBA slot bus.
|
|
#define GBA_BUS ((vu16 *)(0x08000000))
|
|
//! 16 bit pointer to the GBA slot ROM.
|
|
#define GBAROM ((u16*)0x08000000)
|
|
|
|
//! 8 bit pointer to GBA slot Save ram.
|
|
#define SRAM ((u8*)0x0A000000)
|
|
|
|
|
|
#ifdef ARM7
|
|
#define VRAM ((u16*)0x06000000)
|
|
#endif
|
|
|
|
|
|
|
|
/*!
|
|
\brief the GBA file header format.
|
|
See gbatek for more info.
|
|
*/
|
|
typedef struct sGBAHeader {
|
|
u32 entryPoint; //!< 32 bits arm opcode to jump to executable code.
|
|
u8 logo[156]; //!< nintendo logo needed for booting the game.
|
|
char title[0xC]; //!< 12 characters for the game title.
|
|
char gamecode[0x4]; //!< 4 characters for the game code. first character is usally A or B, next 2 characters is a short title
|
|
//!< and last character is for destination/language.
|
|
u16 makercode; //!< identifies the (commercial) developer.
|
|
u8 is96h; //!< fixed value that is always 96h.
|
|
u8 unitcode; //!< identifies the required hardware.
|
|
u8 devicecode; //!< used by nintedo's hardware debuggers. normally 0.
|
|
u8 unused[7];
|
|
u8 version; //!< the version of the game.
|
|
u8 complement; //!< complement checksum of the gba header.
|
|
u16 checksum; //!< a 16 bit checksum? (gbatek says its unused/reserved).
|
|
} tGBAHeader;
|
|
|
|
#define GBA_HEADER (*(tGBAHeader *)0x08000000)
|
|
|
|
/*!
|
|
\brief the NDS file header format
|
|
See gbatek for more info.
|
|
*/
|
|
typedef struct sNDSHeader {
|
|
char gameTitle[12]; //!< 12 characters for the game title.
|
|
char gameCode[4]; //!< 4 characters for the game code.
|
|
char makercode[2]; //!< identifies the (commercial) developer.
|
|
u8 unitCode; //!< identifies the required hardware.
|
|
u8 deviceType; //!< type of device in the game card
|
|
u8 deviceSize; //!< capacity of the device (1 << n Mbit)
|
|
u8 reserved1[9];
|
|
u8 romversion; //!< version of the ROM.
|
|
u8 flags; //!< bit 2: auto-boot flag.
|
|
|
|
u32 arm9romOffset; //!< offset of the arm9 binary in the nds file.
|
|
void *arm9executeAddress; //!< adress that should be executed after the binary has been copied.
|
|
void *arm9destination; //!< destination address to where the arm9 binary should be copied.
|
|
u32 arm9binarySize; //!< size of the arm9 binary.
|
|
|
|
u32 arm7romOffset; //!< offset of the arm7 binary in the nds file.
|
|
void *arm7executeAddress; //!< adress that should be executed after the binary has been copied.
|
|
void *arm7destination; //!< destination address to where the arm7 binary should be copied.
|
|
u32 arm7binarySize; //!< size of the arm7 binary.
|
|
|
|
u32 filenameOffset; //!< File Name Table (FNT) offset.
|
|
u32 filenameSize; //!< File Name Table (FNT) size.
|
|
u32 fatOffset; //!< File Allocation Table (FAT) offset.
|
|
u32 fatSize; //!< File Allocation Table (FAT) size.
|
|
|
|
u32 arm9overlaySource; //!< File arm9 overlay offset.
|
|
u32 arm9overlaySize; //!< File arm9 overlay size.
|
|
u32 arm7overlaySource; //!< File arm7 overlay offset.
|
|
u32 arm7overlaySize; //!< File arm7 overlay size.
|
|
|
|
u32 cardControl13; //!< Port 40001A4h setting for normal commands (used in modes 1 and 3)
|
|
u32 cardControlBF; //!< Port 40001A4h setting for KEY1 commands (used in mode 2)
|
|
u32 bannerOffset; //!< offset to the banner with icon and titles etc.
|
|
|
|
u16 secureCRC16; //!< Secure Area Checksum, CRC-16.
|
|
|
|
u16 readTimeout; //!< Secure Area Loading Timeout.
|
|
|
|
u32 unknownRAM1; //!< ARM9 Auto Load List RAM Address (?)
|
|
u32 unknownRAM2; //!< ARM7 Auto Load List RAM Address (?)
|
|
|
|
u32 bfPrime1; //!< Secure Area Disable part 1.
|
|
u32 bfPrime2; //!< Secure Area Disable part 2.
|
|
u32 romSize; //!< total size of the ROM.
|
|
|
|
u32 headerSize; //!< ROM header size.
|
|
u32 zeros88[14];
|
|
u8 gbaLogo[156]; //!< Nintendo logo needed for booting the game.
|
|
u16 logoCRC16; //!< Nintendo Logo Checksum, CRC-16.
|
|
u16 headerCRC16; //!< header checksum, CRC-16.
|
|
|
|
} tNDSHeader;
|
|
|
|
typedef struct __DSiHeader {
|
|
tNDSHeader ndshdr;
|
|
u32 debugRomSource; //!< debug ROM offset.
|
|
u32 debugRomSize; //!< debug size.
|
|
u32 debugRomDestination; //!< debug RAM destination.
|
|
u32 offset_0x16C; //reserved?
|
|
|
|
u8 zero[0x10];
|
|
|
|
u8 global_mbk_setting[5][4];
|
|
u32 arm9_mbk_setting[3];
|
|
u32 arm7_mbk_setting[3];
|
|
u32 mbk9_wramcnt_setting;
|
|
|
|
u32 region_flags;
|
|
u32 access_control;
|
|
u32 scfg_ext_mask;
|
|
u8 offset_0x1BC[3];
|
|
u8 appflags;
|
|
|
|
void *arm9iromOffset;
|
|
u32 offset_0x1C4;
|
|
void *arm9idestination;
|
|
u32 arm9ibinarySize;
|
|
void *arm7iromOffset;
|
|
u32 offset_0x1D4;
|
|
void *arm7idestination;
|
|
u32 arm7ibinarySize;
|
|
|
|
u32 digest_ntr_start;
|
|
u32 digest_ntr_size;
|
|
u32 digest_twl_start;
|
|
u32 digest_twl_size;
|
|
u32 sector_hashtable_start;
|
|
u32 sector_hashtable_size;
|
|
u32 block_hashtable_start;
|
|
u32 block_hashtable_size;
|
|
u32 digest_sector_size;
|
|
u32 digest_block_sectorcount;
|
|
|
|
u32 banner_size;
|
|
u32 offset_0x20C;
|
|
u32 total_rom_size;
|
|
u32 offset_0x214;
|
|
u32 offset_0x218;
|
|
u32 offset_0x21C;
|
|
|
|
u32 modcrypt1_start;
|
|
u32 modcrypt1_size;
|
|
u32 modcrypt2_start;
|
|
u32 modcrypt2_size;
|
|
|
|
u32 tid_low;
|
|
u32 tid_high;
|
|
u32 public_sav_size;
|
|
u32 private_sav_size;
|
|
u8 reserved3[176];
|
|
u8 age_ratings[0x10];
|
|
|
|
u8 hmac_arm9[20];
|
|
u8 hmac_arm7[20];
|
|
u8 hmac_digest_master[20];
|
|
u8 hmac_icon_title[20];
|
|
u8 hmac_arm9i[20];
|
|
u8 hmac_arm7i[20];
|
|
u8 reserved4[40];
|
|
u8 hmac_arm9_no_secure[20];
|
|
u8 reserved5[2636];
|
|
u8 debug_args[0x180];
|
|
u8 rsa_signature[0x80];
|
|
|
|
} tDSiHeader;
|
|
|
|
|
|
#define __NDSHeader ((tNDSHeader *)0x02FFFE00)
|
|
#define __DSiHeader ((tDSiHeader *)0x02FFE000)
|
|
|
|
|
|
/*!
|
|
\brief the NDS banner format.
|
|
See gbatek for more information.
|
|
*/
|
|
typedef struct sNDSBanner {
|
|
u16 version; //!< version of the banner.
|
|
u16 crc; //!< 16 bit crc/checksum of the banner.
|
|
u8 reserved[28];
|
|
u8 icon[512]; //!< 32*32 icon of the game with 4 bit per pixel.
|
|
u16 palette[16]; //!< the pallete of the icon.
|
|
u16 titles[6][128]; //!< title of the game in 6 different languages.
|
|
} tNDSBanner;
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
#ifdef ARM9
|
|
#define BUS_OWNER_ARM9 true
|
|
#define BUS_OWNER_ARM7 false
|
|
|
|
|
|
static inline
|
|
/*! \fn void sysSetCartOwner(bool arm9)
|
|
\brief Sets the owner of the GBA cart. Both CPUs cannot have access to the gba cart (slot 2).
|
|
\param arm9 if true the arm9 is the owner, otherwise the arm7
|
|
*/
|
|
void sysSetCartOwner(bool arm9) {
|
|
REG_EXMEMCNT = (REG_EXMEMCNT & ~ARM7_OWNS_ROM) | (arm9 ? 0 : ARM7_OWNS_ROM);
|
|
}
|
|
|
|
static inline
|
|
/*! \fn void sysSetCardOwner(bool arm9)
|
|
\brief Sets the owner of the DS card bus. Both CPUs cannot have access to the DS card bus (slot 1).
|
|
* \param arm9 if true the arm9 is the owner, otherwise the arm7
|
|
*/
|
|
void sysSetCardOwner(bool arm9) {
|
|
REG_EXMEMCNT = (REG_EXMEMCNT & ~ARM7_OWNS_CARD) | (arm9 ? 0 : ARM7_OWNS_CARD);
|
|
}
|
|
|
|
static inline
|
|
/*! \fn void sysSetBusOwners(bool arm9rom, bool arm9card)
|
|
\brief Sets the owner of the DS card bus (slot 1) and gba cart bus (slot 2). Only one cpu may access the device at a time.
|
|
* \param arm9rom if true the arm9 is the owner of slot 2, otherwise the arm7
|
|
* \param arm9card if true the arm9 is the owner of slot 1, otherwise the arm7
|
|
*/
|
|
void sysSetBusOwners(bool arm9rom, bool arm9card) {
|
|
REG_EXMEMCNT = (REG_EXMEMCNT & ~(ARM7_OWNS_CARD|ARM7_OWNS_ROM)) |
|
|
(arm9card ? 0: ARM7_OWNS_CARD) |
|
|
(arm9rom ? 0: ARM7_OWNS_ROM );
|
|
}
|
|
#endif //ARM9
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
|
|
|
|
#endif
|