Event Recording Configuration

Macros
#define	CONFIGURE_RECORD_EXTENSIONS_ENABLED
	This configuration option is a boolean feature define.
#define	CONFIGURE_RECORD_FATAL_DUMP_BASE64
	This configuration option is a boolean feature define.
#define	CONFIGURE_RECORD_FATAL_DUMP_BASE64_ZLIB
	This configuration option is a boolean feature define.
#define	CONFIGURE_RECORD_INTERRUPTS_ENABLED
	This configuration option is a boolean feature define.
#define	CONFIGURE_RECORD_PER_PROCESSOR_ITEMS
	This configuration option is an integer define.

Detailed Description

This section describes configuration options related to the event recording.

Macro Definition Documentation

CONFIGURE_RECORD_EXTENSIONS_ENABLED

#define CONFIGURE_RECORD_EXTENSIONS_ENABLED

This configuration option is a boolean feature define.

In case

• this configuration option is defined
• and CONFIGURE_RECORD_PER_PROCESSOR_ITEMS is properly defined,

then the event record extensions are enabled.

Default Configuration

If this configuration option is undefined, then the described feature is not enabled.

Notes

The record extensions capture thread create, start, restart, delete, switch, begin, exitted and terminate events.

CONFIGURE_RECORD_FATAL_DUMP_BASE64

#define CONFIGURE_RECORD_FATAL_DUMP_BASE64

This configuration option is a boolean feature define.

In case

• this configuration option is defined
• and CONFIGURE_RECORD_PER_PROCESSOR_ITEMS is properly defined,
• and CONFIGURE_RECORD_FATAL_DUMP_BASE64_ZLIB is undefined,

then the event records are dumped in Base64 encoding in a fatal error extension (see System Termination Procedure).

Default Configuration

If this configuration option is undefined, then the described feature is not enabled.

Notes

This extension can be used to produce crash dumps.

CONFIGURE_RECORD_FATAL_DUMP_BASE64_ZLIB

#define CONFIGURE_RECORD_FATAL_DUMP_BASE64_ZLIB

This configuration option is a boolean feature define.

In case

• this configuration option is defined
• and CONFIGURE_RECORD_PER_PROCESSOR_ITEMS is properly defined,

then the event records are compressed by zlib and dumped in Base64 encoding in a fatal error extension (see System Termination Procedure).

Default Configuration

If this configuration option is undefined, then the described feature is not enabled.

Notes

The zlib compression needs about 512KiB of RAM. This extension can be used to produce crash dumps.

CONFIGURE_RECORD_INTERRUPTS_ENABLED

#define CONFIGURE_RECORD_INTERRUPTS_ENABLED

This configuration option is a boolean feature define.

In case

• this configuration option is defined
• and CONFIGURE_RECORD_PER_PROCESSOR_ITEMS is properly defined,

then the interrupt event recording is enabled.

Default Configuration

If this configuration option is undefined, then the described feature is not enabled.

Notes

The interrupt event recording generates interrupt entry and exit events when interrupt entries are dispatched.

CONFIGURE_RECORD_PER_PROCESSOR_ITEMS

#define CONFIGURE_RECORD_PER_PROCESSOR_ITEMS

This configuration option is an integer define.

The value of this configuration option defines the event record item count per processor.

Default Value

The default value is 0.

Constraints

The following constraints apply to this configuration option:

• The value of the configuration option shall be greater than or equal to 16.
• The value of the configuration option shall be less than or equal to SIZE_MAX.
• The value of the configuration option shall be a power of two.
• The value of the configuration option shall be less than or equal to a BSP-specific and application-specific value which depends on the size of the memory available to the application.

Notes

The event record buffers are statically allocated for each configured processor (CONFIGURE_MAXIMUM_PROCESSORS). If the value of this configuration option is zero, then nothing is allocated.