mirror of
https://github.com/rvtr/TwlIPL.git
synced 2025-10-31 06:01:12 -04:00
ab0344e274
一時バッファ利用版AES対応 (未検証) git-svn-id: file:///Users/lillianskinner/Downloads/platinum/twl/TwlIPL/trunk@328 b08762b0-b915-fc4b-9d8c-17b2551a87ff
200 lines
7.3 KiB
C
200 lines
7.3 KiB
C
/*---------------------------------------------------------------------------*
|
|
Project: TwlIPL - include - fs
|
|
File: fs.h
|
|
|
|
Copyright 2007 Nintendo. All rights reserved.
|
|
|
|
These coded instructions, statements, and computer programs contain
|
|
proprietary information of Nintendo of America Inc. and/or Nintendo
|
|
Company Ltd., and are protected by Federal copyright law. They may
|
|
not be disclosed to third parties or copied or duplicated in any form,
|
|
in whole or in part, without the prior written consent of Nintendo.
|
|
|
|
$Date:: 2007-09-06$
|
|
$Rev$
|
|
$Author$
|
|
*---------------------------------------------------------------------------*/
|
|
|
|
#ifndef FIRM_FS_FS_FIRM_H_
|
|
#define FIRM_FS_FS_FIRM_H_
|
|
|
|
#include <twl/types.h>
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
/*---------------------------------------------------------------------------*
|
|
Name: FS_InitFIRM
|
|
|
|
Description: initialize FS/FATFS for firm
|
|
|
|
Arguments: None
|
|
|
|
Returns: None
|
|
*---------------------------------------------------------------------------*/
|
|
void FS_InitFIRM( void );
|
|
|
|
/*---------------------------------------------------------------------------*
|
|
Name: FS_GetAesKeySeed
|
|
|
|
Description: retreive aes key seed in the signature
|
|
|
|
Arguments: None
|
|
|
|
Returns: pointer to seed
|
|
*---------------------------------------------------------------------------*/
|
|
AESKey* const FS_GetAesKeySeed( void );
|
|
|
|
/*---------------------------------------------------------------------------*
|
|
Name: FS_DeleteAesKeySeed
|
|
|
|
Description: delete aes key seed in the signature
|
|
|
|
Arguments: None
|
|
|
|
Returns: None
|
|
*---------------------------------------------------------------------------*/
|
|
void FS_DeleteAesKeySeed( void );
|
|
|
|
/*---------------------------------------------------------------------------*
|
|
Name: FS_ResolveSrl
|
|
|
|
Description: resolve srl filename and store to HW_TWL_FS_BOOT_SRL_PATH_BUF
|
|
|
|
Arguments: titleId title id for srl file
|
|
|
|
Returns: TRUE if success
|
|
*---------------------------------------------------------------------------*/
|
|
BOOL FS_ResolveSrl( u64 titleId );
|
|
|
|
/*---------------------------------------------------------------------------*
|
|
Name: FS_SetDigestKey
|
|
|
|
Description: set specified key or default key for HMAC-SHA-1
|
|
|
|
Arguments: digestKey pointer to key
|
|
if NULL, use default key
|
|
|
|
Returns: TRUE if success
|
|
*---------------------------------------------------------------------------*/
|
|
void FS_SetDigestKey( const u8* digestKey );
|
|
|
|
/*---------------------------------------------------------------------------*
|
|
Name: FS_LoadBuffer
|
|
|
|
Description: receive data from ARM7 via WRAM-B and store in destination address,
|
|
calculate SHA1 in parallel if ctx is specified
|
|
|
|
Arguments: dest destination address to read
|
|
size total length to read in bytes
|
|
ctx pointer to SHA1 context or NULL
|
|
|
|
Returns: TRUE if success
|
|
*---------------------------------------------------------------------------*/
|
|
BOOL FS_LoadBuffer( u8* dest, u32 size, SVCSHA1Context *ctx );
|
|
|
|
/*---------------------------------------------------------------------------*
|
|
Name: FS_LoadModule
|
|
|
|
Description: receive data from ARM7 via WRAM-B and store in destination address
|
|
in view of AES settings in the ROM header at HW_TWL_ROM_HEADER_BUF,
|
|
then verify the digest
|
|
|
|
Arguments: dest destination address to read
|
|
offset file offset to start to read in bytes
|
|
size total length to read in bytes
|
|
digest digest to verify
|
|
|
|
Returns: TRUE if success
|
|
*---------------------------------------------------------------------------*/
|
|
BOOL FS_LoadModule( u8* dest, u32 offset, u32 size, const u8 digest[SVC_SHA1_BLOCK_SIZE] );
|
|
|
|
/*---------------------------------------------------------------------------*
|
|
Name: FS_LoadHeader
|
|
|
|
Description: receive ROM header, store to HW_TWL_ROM_HEADER_BUF,
|
|
and verify signature
|
|
|
|
Arguments: pool heap context to call SVC_DecryptSign
|
|
rsa_key public key to verify the signature
|
|
|
|
Returns: TRUE if success
|
|
*---------------------------------------------------------------------------*/
|
|
BOOL FS_LoadHeader( SVCSignHeapContext* pool, const void* rsa_key );
|
|
|
|
/*---------------------------------------------------------------------------*
|
|
Name: FS_LoadStatic
|
|
|
|
Description: receive static regions from ARM6 via WRAM-B and store them
|
|
specified by ROM header at HW_TWL_ROM_HEADER_BUF
|
|
|
|
Arguments: None
|
|
|
|
Returns: TRUE if success
|
|
*---------------------------------------------------------------------------*/
|
|
BOOL FS_LoadStatic( void );
|
|
|
|
|
|
/*---------------------------------------------------------------------------*
|
|
Name: FS_LoadSrlModule
|
|
|
|
Description: receive data from ARM7 via WRAM-B and store in destination address
|
|
in view of AES settings in the ROM header at HW_TWL_ROM_HEADER_BUF,
|
|
then verify the digest
|
|
|
|
Arguments: pFile pointer to FSFile streucture
|
|
dest destination address to read
|
|
offset file offset to start to read in bytes
|
|
size total length to read in bytes
|
|
digest digest to verify
|
|
|
|
Returns: TRUE if success
|
|
*---------------------------------------------------------------------------*/
|
|
BOOL FS_LoadSrlModule( FSFile *pFile, u8* dest, u32 offset, u32 size, const u8 digest[SVC_SHA1_BLOCK_SIZE] );
|
|
|
|
/*---------------------------------------------------------------------------*
|
|
Name: FS_OpenSrl
|
|
|
|
Description: open srl file named at HW_TWL_FS_BOOT_SRL_PATH_BUF
|
|
|
|
Arguments: pFile pointer to FSFile streucture
|
|
|
|
Returns: TRUE if success
|
|
*---------------------------------------------------------------------------*/
|
|
BOOL FS_OpenSrl( FSFile *pFile );
|
|
|
|
/*---------------------------------------------------------------------------*
|
|
Name: FS_LoadSrlHeader
|
|
|
|
Description: load ROM header to HW_TWL_ROM_HEADER_BUF using normal FS,
|
|
and verify signature
|
|
|
|
Arguments: pFile pointer to FSFile streucture
|
|
pool heap context to call SVC_DecryptSign
|
|
rsa_key public key to verify the signature
|
|
|
|
Returns: TRUE if success
|
|
*---------------------------------------------------------------------------*/
|
|
BOOL FS_LoadSrlHeader( FSFile *pFile, SVCSignHeapContext* pool, const void* rsa_key );
|
|
|
|
/*---------------------------------------------------------------------------*
|
|
Name: FS_LoadSrlStatic
|
|
|
|
Description: receive static regions from ARM6 via WRAM-B and store them
|
|
specified by ROM header at HW_TWL_ROM_HEADER_BUF
|
|
|
|
Arguments: pFile pointer to FSFile streucture
|
|
|
|
Returns: TRUE if success
|
|
*---------------------------------------------------------------------------*/
|
|
BOOL FS_LoadSrlStatic( FSFile *pFile );
|
|
|
|
#ifdef __cplusplus
|
|
} /* extern "C" */
|
|
#endif
|
|
|
|
|
|
/* FIRM_FS_FS_FIRM_H_ */
|
|
#endif
|