libctru/libctru/include/3ds/services/ps.h

76 lines
2.2 KiB
C
Raw Normal View History

2014-10-27 06:17:56 +01:00
#pragma once
typedef enum
{
ps_CBC_ENC,
ps_CBC_DEC,
ps_CTR_ENC,
ps_CTR_DEC,
ps_CCM_ENC,
ps_CCM_DEC,
} ps_aes_algo;
typedef enum
{
ps_KEYSLOT_0D,
ps_KEYSLOT_2D,
ps_KEYSLOT_31,
ps_KEYSLOT_38,
ps_KEYSLOT_32,
ps_KEYSLOT_39,
ps_KEYSLOT_2E,
ps_KEYSLOT_INVALID,
ps_KEYSLOT_36
} ps_aes_keytypes;
/*
Requires access to "ps:ps" service
*/
Result psInit();
Result psExit();
/* PS_EncryptDecryptAes()
About: Is an interface for the AES Engine, you can only use predetermined keyslots though.
Note: Does not support AES CCM, see PS_EncryptSignDecryptVerifyAesCcm()
size size of data
in input buffer ptr
out output buffer ptr
aes_algo AES Algorithm to use, see ps_aes_algo
key_type see ps_aes_keytypes
iv ptr to the CTR/IV (This is updated before returning)
*/
Result PS_EncryptDecryptAes(u32 size, u8* in, u8* out, u32 aes_algo, u32 key_type, u8* iv);
/* PS_EncryptSignDecryptVerifyAesCcm()
About: Is an interface for the AES Engine (CCM Encrypt/Decrypt only), you can only use predetermined keyslots though.
Note: When encrypting, the output buffer size must include the MAC size, when decrypting, the input buffer size must include MAC size.
MAC: When decrypting, if the MAC is invalid, 0xC9010401 is returned. After encrypting the MAC is located at inputbufptr+(totalassocdata+totaldatasize)
in input buffer ptr
in_size size of input buffer
out output buffer ptr
out_size size of output buffer
data_len length of data to be crypted
mac_data_len length of data associated with MAC
mac_len length of MAC
aes_algo AES Algorithm to use, see ps_aes_algo
key_type see ps_aes_keytypes
nonce ptr to the nonce
*/
Result PS_EncryptSignDecryptVerifyAesCcm(u8* in, u32 in_size, u8* out, u32 out_size, u32 data_len, u32 mac_data_len, u32 mac_len, u32 aes_algo, u32 key_type, u8* nonce);
/* PS_GetLocalFriendCodeSeed()
About: Gets a 64bit console id, it's used for some key slot inits
seed ptr to where the seed is written to
*/
Result PS_GetLocalFriendCodeSeed(u64* seed);
/* PS_GetDeviceId()
About: Gets a 32bit device id, it's used for some key slot inits
device_id ptr to where the device id is written to
*/
Result PS_GetDeviceId(u32* device_id);