Supported platforms: CODESYS 2.3, CODESYS 3.5

List of Event Log Library's Global Variables

Global Constants

Status flag bit numbers:

 

Name of the Constant

Data Type

Bit (x)

Value

Description

EL_EventState

INT

0 (2#0000 000x)

1

Follows event status after filter delay

EL_StateNotAcknowledged

INT

1 (2#0000 00x0)

2

Set on rising edge, if config bit is set EL_Config_Acknowledge

EL_PopupNotAcknowledged

INT

2 (2#0000 0x00)

4

Set on rising edge, if config bit is set EL_Config_Popup

EL_EventToLog

INT

3 (2#0000 x000)

8

Add event to log

EL_EventActive

INT

4 (2#000x 0000)

16

Event is active

EL_OptionExtSystem

INT

5 (2#00x0 0000)

32

Log line after this, has optional information for the event

EL_ExtSystemFrame

INT

6 (2#0x00 0000)

64

This log line is optional information for the event

EL_TimeStamp_Bit17

INT

7 (2#x000 0000)

128

Extra bit for timestamp calculation of delays (EL_Update)

 

Name of the Constant

Data Type

Default value

Description

G_EL_MAXEVENTTRANSLATORS

WORD

10

Maximum number of event translators (internal array size)

G_EL_MAXVISIBLELOGLINES

INT

20

Line count of events in log view used by EL_ReadLog

EL_END_OF_EVENTS

WORD

100

Number of this device's application events

G_EL_NUMBER_OF_SOURCES

WORD

1

Number of source devices (address 0..255) of events

G_EL_EventLogbufferSize

WORD

200

Size of temporal (internal) ringbuffer for event (in bytes).

Used with control unit that has no NVRAM for log.

G_EL_SortedEventItemCount

WORD

2000

Reservation for double linked list of sorted events

G_EL_COPYExtEVENTS

BOOL

TRUE

Control flag to log and transfer extended events

G_EL_Producer

BOOL

TRUE

EL_Update's input parameter i_ToIntEventLog does not affect, when true. Event is still added to temporal log for transfer in logging unit. If i_ToIntEventLog is false, only the status of the event is stored to the data structure

G_EL_CountOfTypes

WORD

5

Number of different event types in application.

G_EL_DISABLE_NEW_LINE

BOOL

FALSE

TRUE = The new event log line is not generated if same event

occurs repeatedly. Only event counter is increased.

FALSE = The new even log line is generated even if same event occurs repeatedly.

Note! this parameter affects only in event consumer side.

G_EL_EVENT_COUNTER_TYPE

BYTE

0

0 = Event counter is reset when a different event ID occurs,

1 = Event counter is reset after unit reboot,

2 = Event counter is not reset. Application handles resetting.   

Note! this parameter affects only in event consumer side.

G_EL_SET_EVENT_FALLING_EDGE

BOOL

FALSE

TRUE = Library automatically generates falling edges to the events which were active when the control unit was previously shutdown.

FALSE = Falling edges are not generated

Note! This parameter affects only in event consumer side.

G_EL_NUMBER_OF_READLOG_INSTANCES

BYTE

1

The number of EL_ReadLog instances used in application.

Global Variables

CODESYS 2.3CODESYS 2.3

Name of the Global

Data Type

Description

G_EVENTLOG_Log

POINTER TO EL_EventLog

Pointer to event log structure, read from firmware

G_EVENTLOG_SizeOfLog

UINT

Initial log size is set to 0

G_EL_EventLogBuffer

ARRAY [1..G_EL_EventLogbufferSize] OF BYTE

Event log ring buffer

G_EL_EventCnfg

ARRAY [0..G_EL_NUMBER_OF_SOURCES] OF EL_EventSource

Event data (configuration) array

G_EL_EventStates

EL_EventArray

Status and time stamp for events

G_EL_Translators

ARRAY[1..G_EL_MAXEVENTTRANSLATORS] OF EL_Translators

Event translator array

G_EL_EVENT_ID

WORD

Translated Event ID, return values from callback program

G_EL_pEvent

POINTER TO EL_Event

Input pointer to event structure

G_EL_pEventExt

POINTER TO EL_EventExt

Input pointer to extended event structure

G_EL_pEventTranslator

POINTER TO EL_Translators

Input translator pointer for callback program

G_EL_Argument

DWORD

Input argument for translator callback program

G_EL_DisableCounterResetBitFunc

BOOL

Function EL_SetCounterResetBitToLogLine execution is disabled = TRUE

 

 

CODESYS 3.5CODESYS 3.5

Name of the Global

Data Type

Description

G_EVENTLOG_Log

POINTER TO EL_EventLog

Pointer to event log structure, read from firmware

G_EVENTLOG_SizeOfLog

UINT

Initial log size is set to 0

G_EL_EventLogBuffer

ARRAY [1..G_EL_EventLogbufferSize] OF BYTE

Event log ring buffer

G_EL_EventCnfg

ARRAY [0..G_EL_NUMBER_OF_SOURCES] OF EL_EventSource

Event data (configuration) array

G_EL_EventStates

EL_EventArray

Status and time stamp for events

G_EL_Translators

ARRAY[1..G_EL_MAXEVENTTRANSLATORS] OF EL_Translators

Event translator array

G_EL_EVENT_ID

WORD

Translated Event ID, return values from callback program

G_EL_pEvent

POINTER TO EL_Event

Input pointer to event structure

G_EL_pEventExt

POINTER TO EL_EventExt

Input pointer to extended event structure

G_EL_pEventTranslator

POINTER TO EL_Translators

Input translator pointer for callback program

G_EL_Argument

DWORD

Input argument for translator callback program

G_EL_pLibEventTypes

POINTER TO ARRAY[-32768..EL_END_OF_LIBRARY_EVENTS] OF BYTE

Array to set type of library events

G_EL_pAppEventTypes

POINTER TO ARRAY[0..EL_END_OF_EVENTS] OF BYTE

Array to set type of application events

G_EL_EventTypeConfig

ARRAY [0..G_EL_CountOfTypes] OF EL_EventTypeConfigs

Event type configs (event type and count) array.

G_EL_DisableCounterResetBitFunc

BOOL

Function EL_SetCounterResetBitToLogLine execution is disabled = TRUE

 

 

 

Source file Topic000747.htm

Last updated 13-Jun-2024