1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
|
/*
Vita Development Suite Libraries
*/
#ifndef _DOLCESDK_PSP2_TRIGGER_UTIL_H_
#define _DOLCESDK_PSP2_TRIGGER_UTIL_H_
#include <rtc.h>
#include <scetypes.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 ((int)0x80103601)
#define SCE_TRIGGER_UTIL_ERROR_NOT_FOUND_USER ((int)0x80103610)
#define SCE_TRIGGER_UTIL_ERROR_NOT_FOUND_SYSTEM ((int)0x80103612)
#define SCE_TRIGGER_UTIL_ERROR_NOT_REGISTERED ((int)0x80103620)
#define SCE_TRIGGER_UTIL_ERROR_EVENT_TYPE_MISMATCH ((int)0x80103623)
#define SCE_TRIGGER_UTIL_ERROR_INVALID_ARG ((int)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_ */
|
