STW TC1, Руководство пользователя

Страница: 152 / 374

7 Teleservice Application Framework
User Manual 152/374
Return Value Description
C_BUSY Error registering a watchdog service from the ysysd (pending call)
C_UNKNOWN_ERR Error registering a watchdog service from the ysysd (stealing reply)
C_CONFIG Error registering a watchdog service from the ysysd (Message has no arguments)
C_COM Error registering a watchdog service from the ysysd (Answer is not a string).
Example
// Global module
T_DBUS_Util mt_DBUS_Util;
sint32 s32_Retval;
s32_Retval = ysysd_register_watch_dog (&mt_DBUS_Util);
if (s32_Retval != C_NO_ERR)
{
// Handle error cases
}
7.3.4.3 ysysd_trigger_watch_dog
Function Description
sint32 ysysd_trigger_watch_dog (const T_DBUS_Util * const opt_DBusInstance)
Sends a trigger over the D-Bus to the system daemon to prevent it to kill the application. This functions needs
to be called within the registered time interval (set during the ysysd_register_watch_dog function call in the
parameter opt_DBusInstance).
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
// expects to be triggered
charn acn_myCMDOnWatchdog[2048]; // Bash cmd that must be executed
// by the ysysd in case no
// trigger signal occurred in time.
} T_DBUS_Util;