diff options
Diffstat (limited to '')
| -rw-r--r-- | include/user/trigger_util.h | 232 |
1 files changed, 232 insertions, 0 deletions
diff --git a/include/user/trigger_util.h b/include/user/trigger_util.h new file mode 100644 index 0000000..3ac6e09 --- /dev/null +++ b/include/user/trigger_util.h @@ -0,0 +1,232 @@ +#ifndef _DOLCESDK_PSP2_TRIGGER_UTIL_H_ +#define _DOLCESDK_PSP2_TRIGGER_UTIL_H_ + +#include <psp2/kernel/clib.h> +#include <psp2/rtc.h> +#include <psp2/types.h> + +#ifdef __cplusplus +extern "C" { +#endif + +// NOTE1: Last two params in all of the functions are never used, probably callbacks since all sceTriggerUtil functions are non-blocking +// NOTE2: Max number of events (eventId) per application is 8 + +#define SCE_TRIGGER_UTIL_VERSION 0x3100000 + +/** + * Days of the week for use in repeatDays member of ::SceTriggerUtilEventParamDaily + */ +typedef enum SceTriggerUtilDays { + SCE_TRIGGER_UTIL_SUNDAY = 0x1, + SCE_TRIGGER_UTIL_MONDAY = 0x2, + SCE_TRIGGER_UTIL_TUESDAY = 0x4, + SCE_TRIGGER_UTIL_WEDNESDAY = 0x8, + SCE_TRIGGER_UTIL_THURSDAY = 0x10, + SCE_TRIGGER_UTIL_FRIDAY = 0x20, + SCE_TRIGGER_UTIL_SATURDAY = 0x40, +} SceTriggerUtilDays; + +/** + * Errors + */ +#define SCE_TRIGGER_UTIL_ERROR_BUSY 0x80103601 +#define SCE_TRIGGER_UTIL_ERROR_NOT_FOUND_USER 0x80103610 +#define SCE_TRIGGER_UTIL_ERROR_NOT_FOUND_SYSTEM 0x80103612 +#define SCE_TRIGGER_UTIL_ERROR_NOT_REGISTERED 0x80103620 +#define SCE_TRIGGER_UTIL_ERROR_EVENT_TYPE_MISMATCH 0x80103623 +#define SCE_TRIGGER_UTIL_ERROR_INVALID_ARG 0x80103650 + +typedef struct SceTriggerUtilEventParamDaily { // size is 0x50 + SceUInt32 ver; + SceInt32 triggerTime; // POSIX time + SceInt16 extraParam1; // set to 1 + SceInt16 extraParam2; // set to 0 + SceUInt16 repeatDays; // bitwise + SceChar8 reserved[0x40]; +} SceTriggerUtilEventParamDaily; + +typedef struct SceTriggerUtilEventParamOneTime { // size is 0x58 + SceUInt32 ver; + SceInt32 a2; + SceRtcTick triggerTime; // SceRtcTick, UTC + SceUInt8 extraParam1; // set to 1 + SceUInt8 extraParam2; // set to 0 + SceChar8 reserved[0x44]; +} SceTriggerUtilEventParamOneTime; + +typedef struct SceTriggerUtilUserAppInfo { // size is 0x46A + SceWChar16 name[0x34]; + SceChar8 iconPath[0x400]; + short unk; +} SceTriggerUtilUserAppInfo; + +typedef struct SceTriggerUtilSystemAppInfo { // size is 0x602 + SceWChar16 name[0x100]; + SceChar8 iconPath[0x400]; + char reserved[0x102]; +} SceTriggerUtilSystemAppInfo; + +/** + * Register application start event that will be repeated on certain days + * + * @param[in] titleid - title ID of application to register event for. + * @param[in] param - event parameters. + * @param[in] eventId - ID number of event. + * @param[in] a4 - Unknown, set to 0. + * @param[in] a5 - Unknown, set to 0. + * + * @return 0 on success, <0 otherwise. + */ +int sceTriggerUtilRegisterDailyEvent( + const char* titleid, + const SceTriggerUtilEventParamDaily* param, + int eventId, + int a4, + int a5); + +/** + * Register one time application start event + * + * @param[in] titleid - title ID of application to register event for. + * @param[in] param - event parameters. + * @param[in] eventId - ID number of event. + * @param[in] a4 - Unknown, set to 0. + * @param[in] a5 - Unknown, set to 0. + * + * @return 0 on success, <0 otherwise. + */ +int sceTriggerUtilRegisterOneTimeEvent( + const char* titleid, + const SceTriggerUtilEventParamOneTime* param, + int eventId, + int a4, + int a5); + +/** + * Unregister daily event for caller application + * + * @param[in] eventId - ID number of event to unregister. + * @param[in] a2 - Unknown, set to 0. + * @param[in] a3 - Unknown, set to 0. + * + * @return 0 on success, <0 otherwise. + */ +int sceTriggerUtilUnregisterDailyEvent(int eventId, int a2, int a3); + +/** + * Unregister one time event for caller application + * + * @param[in] eventId - ID number of event to unregister. + * @param[in] a2 - Unknown, set to 0. + * @param[in] a3 - Unknown, set to 0. + * + * @return 0 on success, <0 otherwise. + */ +int sceTriggerUtilUnregisterOneTimeEvent(int eventId, int a2, int a3); + +/** + * Get value from "Settings->System->Auto-Start Settings" for caller application. Required to be 1 to use sceTriggerUtil + * + * @param[out] status - auto-start status. Required to be 1 to use sceTriggerUtil. + * @param[in] a2 - Unknown, set to 0. + * @param[in] a3 - Unknown, set to 0. + * + * @return 0 on success, <0 otherwise. + */ +int sceTriggerUtilGetAutoStartStatus(int* status, int a2, int a3); + +/** + * Get one time event info for caller application + * + * @param[in] eventId - ID number of event to get information for. + * @param[out] triggerTime - SceRtcTick, UTC + * @param[out] unk_ptr - Unknown + * @param[in] a4 - Unknown, set to 0. + * @param[in] a5 - Unknown, set to 0. + * + * @return 0 on success, <0 otherwise. + */ +int sceTriggerUtilGetOneTimeEventInfo(int eventId, SceRtcTick* triggerTime, int* unk_ptr, int a4, int a5); + +/** + * Get daily event info for caller application + * + * @param[in] eventId - ID number of event to get information for. + * @param[out] unk_ptr - Unknown + * @param[out] param - event parameters. + * @param[out] timeUntilEvent - POSIX time until next event trigger + * @param[in] a5 - Unknown, set to 0. + * @param[in] a6 - Unknown, set to 0. + * + * @return 0 on success, <0 otherwise. + */ +int sceTriggerUtilGetDailyEventInfo( + int eventId, + int* unk_ptr, + SceTriggerUtilEventParamDaily* param, + SceInt32* timeUntilEvent, + int a5, + int a6); + +/** + * Get info for user application that has registered sceTriggerUtil events + * + * @param[in] titleid - title ID of application to get info for. + * @param[out] unk_ptr - Unknown + * @param[out] appInfo - application information + * @param[in] a4 - Unknown, set to 0. + * @param[in] a5 - Unknown, set to 0. + * + * @return 0 on success, <0 otherwise. + */ +int sceTriggerUtilGetUserAppInfo( + const char* titleid, + int* unk_ptr, + SceTriggerUtilUserAppInfo* appInfo, + int a4, + int a5); + +/** + * Get list of user applications that has registered sceTriggerUtil events. List contains null-separated title IDs + * + * @param[out] titleIdBuffer - pointer to buffer to recieve title ID list. Max size is 0x1000, min size is unlimited + * @param[out] numOfIds - number of title IDs stored in the list + * + * @return 0 on success, <0 otherwise. + */ +int sceTriggerUtilGetRegisteredUserTitleIdList(char* titleIdBuffer, int* numOfIds); + +/** + * Get info for system application that has registered sceTriggerUtil events + * + * @param[in] titleid - title ID of application to get info for. + * @param[out] unk_ptr - Unknown + * @param[out] appInfo - application information + * @param[in] a4 - Unknown, set to 0. + * @param[in] a5 - Unknown, set to 0. + * + * @return 0 on success, <0 otherwise. + */ +int sceTriggerUtilGetSystemAppInfo( + const char* titleid, + int* unk_ptr, + SceTriggerUtilSystemAppInfo* appInfo, + int a4, + int a5); + +/** + * Get list of system applications that has registered sceTriggerUtil events. List contains null-separated fake title IDs + * + * @param[out] titleIdBuffer - pointer to buffer to recieve fake title ID list. Max size is 0x140, min size is unlimited + * @param[out] numOfIds - number of fake title IDs stored in the list + * + * @return 0 on success, <0 otherwise. + */ +int sceTriggerUtilGetRegisteredSystemTitleIdList(char* buffer, int *numOfIds); + +#ifdef __cplusplus +} +#endif /* __cplusplus */ + +#endif /* _DOLCESDK_PSP2_TRIGGER_UTIL_H_ */ |