#define UCS_TR_ERROR

Trace macro to capture trace error events.

This macro is used to enable the capturing of trace error events. The macro must be mapped onto a user-defined function. To disable the trace error events, the macro must not be defined. The mapped user-defined function must adhere to the following function signature.

void (*Ucs_TraceCb_t)(void * ucs_user_ptr, const char module_str[], const char entry_str[], uint16_t vargs_cnt, ...);

• ucs_user_ptr
  Reference to the User argument
• module_str
  The name of the software module that has posted the trace
• entry_str
  The trace entry as formatted string
• vargs_cnt
  Number of trace arguments which will be passed within the variable argument list
• [...]
  Variable argument list to pass trace arguments

Note

The captured error events can be used for logging and as a first step for debugging unexpected behavior. However, the application must not derive any action when an error is indicated by the trace interface. An application must handle rely on result callback functions and handle "general.error_fptr()".

Example:

extern void App_UcsTraceError(void * ucs_user_ptr,
                              const char module_str[],
                              const char entry_str[],
                              uint16_t vargs_cnt,
                              ...);

#define UCS_TR_ERROR   App_UcsTraceError