STW TC1 - Page 153

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