Logo
UNICENS V2.1.0-3491
User Manual and API Reference
#define UCS_TR_INFO

Trace macro to capture trace info events.

This macro is used to enable the capturing of trace info events. The macro must be mapped onto a user-defined function. To disable the trace info 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
Warning
Do not assign UCS_TR_INFO in a production system. This has major effects on the CPU load and runtime. UCS_TR_INFO is intended for debugging software during development phase. Microchip Support might request you to assign of this macro to spy on internal events. Disable this macro definition after your support case is closed.

Example:

extern void App_UcsTraceInfo(void * ucs_user_ptr,
const char module_str[],
const char entry_str[],
uint16_t vargs_cnt,
...);
#define UCS_TR_INFO App_UcsTraceInfo