STW TC1 User Manual

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

STW TC1 Specifications

General

Brand	STW
Model	TC1
Category	Controller
Language	English