STW TC1, User Manual

Page: 151 / 374

7 Teleservice Application Framework
User Manual 151/374
7.3.4 System
Header file: "System_handler.h"
7.3.4.1 Introduction
The TAF library system component uses the ysys daemon to provide all system relevant functions like register,
trigger or cancel the watchdog.
7.3.4.2 ysysd_register_watch_dog
Function Description
sint32 ysysd_register_watch_dog (const T_DBUS_Util * const opt_DBusInstance)
Requests a watchdog service from the ysysd over the D-Bus, which sets the parameters for future observations
of this application. The parameter opt_DBusInstance must contain all necessary parameters like the watchdog
trigger interval etc. before this function is called.
It is important to cancel (unregister) this service at the end of your application.
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;
Output Information
Return Value Description
C_NO_ERR Function executed without error.
C_WARN Error registering a watchdog service from the ysysd (out of memory)