STW TC1, User Manual

Page: 153 / 374

7 Teleservice Application Framework
User Manual 153/374
Output Information
Return Value Description
C_NO_ERR Function executed without error
C_UNKNOWN_ERR Could not sent trigger message
C_RANGE Parameter opt_DBusInstance is a NULL pointer
Example
// Global module
T_DBUS_Util mt_DBUS_Util;
sint32 s32_Retval;
s32_Retval = ysysd_trigger_watch_dog (&mt_DBUS_Util);
if (s32_Retval != C_NO_ERR)
{
// Handle error cases
}
7.3.4.4 ysysd_cancel_watch_dog
Function Description
sint32 ysysd_cancel_watch_dog (const T_DBUS_Util * const opt_DBusInstance)
This functions calls a method of the system daemon over the D-Bus that cancels the supervision of our
application. Make sure that this function is called whenever your applications ends, even by kill or ctrl+c.
Otherwise the system daemon will execute the acn_myCMDOnWatchdog command after the trigger time has
elapsed.
Information Flow
Input Information
Parameter Range Description
opt_DBusInstance T_DBUS_Util holds all D-Bus information
Structure T_DBUS_Util
typedef struct
{
DBusConnection* pt_dbus_conn;
// D-BUS connection instance
charn acn_myNameString[128]; // Name of the application, Don't use any
special
// characters, white spaces or new lines!
charn acn_myVersion[128]; // Additional value (for HELLO) signal (opt.)
charn acn_myStatus[128]; // Additional value (for HELLO) signal (opt.)
charn acn_myAddInfo[512]; // Additional value (for HELLO) signal (opt.)
sint32 s32_myTriginterval; // Time interval when the ysysd