User`s manual

Dynamic C User’s Manual digi.com 123
8.3.2 Initialization and Defaults
An initialization of the error log occurs when the BIOS is compiled, when cloning takes place or when the
BIOS is loaded via the Rabbit Field Utility (RFU). By default, error logging is disabled.
The error log buffer contains header information as well as an entry for each run-time error. A debug start-
up will zero out this header structure, but the run-time error entries can still be examined from Dynamic C
using the static information in flash. The header is at the start of the error log buffer and contains:
• A status byte
• The number of errors since deployment
• The index of the last error
• The number of hardware resets since deployment
• The number of watchdog time-outs since deployment
• The number of software resets since deployment
• A checksum byte.
“Deployment” is defined as the first power up without the programming cable attached. Reprogramming
the board using the programming cable, the RFU, or a RabbitLink board and starting the program again
without the programming cable attached is a new deployment.
8.3.3 Configuration Macros
The macros listed below are defined at the top of Bios/RabbitBios.c prior to Dynamic C version
9.30 and in Lib\..\BIOSLIB\errlogconfig.lib thereafter. To change from the defaults you
must edit the #define statement either in the BIOS or the configuration library, depending on your version
of Dynamic C.
ENABLE_ERROR_LOGGING
Default: 0. Disables error logging. Changing this to “1” enables error logging.
ERRLOG_USE_REG_DUMP
Default: 1. Include a register dump in log entries. Changing this to zero excludes the register
dump in log entries.
ERRLOG_STACKDUMP_SIZE
Default: 16. Include a stack dump of size ERRLOG_STACKDUMP_SIZE in log entries. Chang-
ing this to zero excludes the stack dump in log entries.
ERRLOG_NUM_ENTRIES
Default: 78. This is the number of entries allowed in the log buffer.
ERRLOG_USE_MESSAGE
Default: 0. Exclude error messages from log entries. Changing this to “1” includes 8 byte
error messages in log entries The default error handler makes no use of this feature.