STW TC1, User Manual

Page: 250 / 374

7 Teleservice Application Framework
User Manual 250/374
7.3.11.3 ysignald_GPS_con_state
Function Description
sint32 ysignald_GPS_con_state (const T_DBUS_Util * const opt_DBusInstance, const charn *
const opcn_SignalArgument);
This function sends the desired GPS state via D-BUS.
To be able to use this function the UseExternalGPSState must be set to true.
UseExternalGPSState can be configured in the configuration file ysignald.config of the ysignal daemon (see
"
Signal daemon " on page 108).
Information Flow
Input Information
Parameter Range Description
opt_DBusInstance T_DBUS_Util holds all D-BUS information
opcn_SignalArgument "Valid"
"Invalid"
signalizes, received valid GPS data
signalizes, no valid GPS data received
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 No error, function runs successful
C_COM Communicated wrong signal state
C_RANGE Some of the function arguments are NULL pointer