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

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

7 Teleservice Application Framework
User Manual 137/374
Return Value Description
C_NO_ERR Function executed without error.
C_CONFIG Could not unregister from D-Bus
C_RANGE Parameter opt_DBusInstance is a NULL pointer
7.3.3.5 dbus_send_hallo_signal
Function Description
sint32 dbus_send_hallo_signal (const T_DBUS_Util * const opt_DBusInstance)
Call this function to inform other applications on the D-Bus about your application. It creates a signal (HELLO
signal) on the D-Bus to that other TAF applications can listen. The use of the HELLO signal is not mandatory
for applications but could be used to ensure the presence of cooperating applications.
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;
NOTE:
All TAF daemons send a HELLO signal on startup and on request (=dbus_who_is_there_signal).