STW TC1, User Manual

Page: 159 / 374

7 Teleservice Application Framework
User Manual 159/374
7.3.5.2 Dynamic Mode
Header file: "DP_dbus_handler.h"
This header provides utility functions to use the dbus and data pool daemon in dynamic mode.
7.3.5.2.1 ydatad_create_variable_list
Function Description
sint32 ydatad_create_variable_list (const T_DBUS_Util *const opt_DBusInstance, const charn *
const opcn_Datapool , cosnt charn *const opcn_List, const charn * const opcn_Description,
const charn * const opcn_Creator)
The function creates a variable list opcn_List in the data pool opcn_Datapool. To describe the variables of the
list use opcn_Description. The name of the creator of the list can be added to the list with the parameter
opcn_Creator.
Information Flow
Input Information
Parameter Range Description
opt_DBusInstance T_DBUS_Util holds all D-Bus information
opcn_Datapool maximum
MAX_DP_NAME_LENGTH pointer to the name of the data pool
opcn_List maximum
MAX_DP_NAME_LENGTH pointer to the name of the variable that is listed
in the data pool.
opcn_Description maximum
MAX_DP_METANAME_LENGTH pointer to the description for the variable list
opcn_Creator maximum
MAX_DP_METANAME_LENGTH pointer to the name of the creator e.g. tool or
user
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;