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

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

7 Teleservice Application Framework
User Manual 156/374
7.3.4.6 ysysd_request_stay_alive
Function Description
sint32 ysysd_request_stay_alive (const T_DBUS_Util * const opt_DBusInstance, const uint32
ou32_DurationSec
)
With this function the system daemon receives over the D-Bus the command not to shutdown the system, for at
least the demanded amount of time in seconds.
If the state of the ignition pin switches to low and the configured time has elapsed, the system shuts down.
If your application is in a crucial task that must not be interrupted (e.g. saving data to flash, transferring data to
the server), then use this function so that the TC1 stays alive for the time specified with ou32_DurationSec,
until this crucial task is finished.
Information Flow
Input Information
Parameter Range Description
opt_DBusInstance T_DBUS_Util holds all D-Bus information
ou32_DurationSec minimum 1 time in seconds, the system should stay alive
from now on
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 system daemon accepted the command
C_UNKNOWN_ERR Could not sent the stay alive request to the system daemon (right ysysd version,
daemon running?)
C_RANGE requested duration is 0 or opt_DBusInstance is a NULL pointer