STW TC1, User Manual

Page: 191 / 374

7 Teleservice Application Framework
User Manual 191/374
7.3.6.2 Dynamic mode
Header file: "DL_dbus_handler.h"
This header provides utility functions to use the dbus and the logger daemon in dynamic mode.
7.3.6.2.1 ylogd_create_log_job
Function Description
sint32 ylogd_create_log_job (const T_DBUS_Util *const opt_DBusInstance, const charn * const
opcn_LogJobName ,const uint32 ou32_LogFileFormat, const uint32 ou32_JobSize, const uint32
ou32_TimeStamp, const charn * const opcn_Comment, const uint32 ou32_SampleTime)
The function creates a new log job. It creates the data logger configuration (DLC) sub-folder under the base
path and also the basic logger job file (.dlc). The logger which should be created will log the values in the
ou32_LogJobFormat format. The maximum size of the logger is defined by ou32_LogJobSize. At the beginning
of every logjob dataset entry, a time stamp will be written if ou32_Timestamp is set to TRUE (1). Every
ou32_SampleTime milliseconds, the logger checks all values if they have changed. If they have changed, the
values will be updated to an internal structure. After the trigger time has elapsed, the internal structure will be
written into the logging file opcn_LogJobName.
Information Flow
Input Information
Parameter Range Description
opt_DBusInstance T_DBUS_Util holds all D-Bus information
opcn_LogJobName maximum
MAX_DL_NAME_LENGTH pointer to the name of the data log job
ou32_LogFileFormat 1 .. 5 Format option for log file
1 : ASCII_STD
2 : ASCII_TC1
3 : ASCII_CSV
4 : BINARY_C2C_LE
5 : BINARY_TC3_LE
ou32_JobSize internal: 0 .. 524287999 ( < 500
MB)
external: 0 .. 4 GByte
maximum size of the log job in bytes (internal /
external e.g. USB storage)
ou32_Timestamp 0 or 1 time stamp On or Off (0 | 1)
opcn_Comment maximum
MAX_DL_METANAME_LENGTH pointer to the comment buffer
ou32_SampleTime 1 .. uint32 interval in milliseconds between variable update
and trigger condition checks