STW TC1, User Manual

Page: 140 / 374

7 Teleservice Application Framework
User Manual 140/374
7.3.3.7 dbus_who_is_there_signal
Function Description
sint32 dbus_who_is_there_signal (const T_DBUS_Util * const opt_DBusInstance)
All TAF daemons send a HELLO signal on startup and on request. This function creates a WhoIsThere signal
on the D-Bus which then triggers all TAF daemons and the applications that are reacting on it, to answer with
HELLO signals. This mechanism can be handy when your applications relies on the presence and services of
certain TAF daemons or applications. It can be used to make sure that all required daemons are running before
your applications tries to use them.
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 with no error. The WhoIsThere signal was sent on the D-Bus
C_UNKNOWN_ERR Could not create the WhoIsThere signal
C_WARN Could not add the WhoIsThere signal on outgoing D-Bus queue
C_RANGE opt_DBusInstance is a NULL pointer