// ArduinoTrace - github.com/bblanchon/ArduinoTrace // Copyright Benoit Blanchon 2018-2020 // MIT License // // A simple tracing macro to debug you program. // // Recipe to find where the code crashes: // 1. sprinkle your code with TRACE() // 2. run the program // 3. view all traces in the Serial monitor // // Each trace includes the: // * the filename // * the line number // * the current function // * the template parameters (if any) #pragma once #include #ifndef ARDUINOTRACE_ENABLE #define ARDUINOTRACE_ENABLE 1 #endif #if ARDUINOTRACE_ENABLE == 1 #ifndef ARDUINOTRACE_SERIAL #define ARDUINOTRACE_SERIAL Serial #endif #ifndef ARDUINOTRACE_ENABLE_PROGMEM #ifdef PROGMEM #define ARDUINOTRACE_ENABLE_PROGMEM 1 #else #define ARDUINOTRACE_ENABLE_PROGMEM 0 #endif #endif #ifndef ARDUINOTRACE_ENABLE_FULLPATH #define ARDUINOTRACE_ENABLE_FULLPATH 0 #else #define ARDUINOTRACE_ENABLE_FULLPATH 1 #endif #ifndef ARDUINOTRACE_FUNCTION_NAME_IN_FLASH #if defined(ESP8266) #define ARDUINOTRACE_FUNCTION_NAME_IN_FLASH 1 #else #define ARDUINOTRACE_FUNCTION_NAME_IN_FLASH 0 #endif #endif namespace ArduinoTrace { constexpr size_t strlen(const char *str) { return str[0] ? strlen(str + 1) + 1 : 0; } template struct string { #if ARDUINOTRACE_ENABLE_PROGMEM const __FlashStringHelper *data() { static const char buffer[] PROGMEM = {chars...}; return reinterpret_cast(buffer); } #else const char *data() { static const char buffer[] = {chars...}; return buffer; } #endif }; template struct string_maker { using result = typename string_maker < TSourceString, remainingLength - 1, TSourceString::data()[remainingLength - 1], collectedChars... >::result; }; #if ARDUINOTRACE_ENABLE_FULLPATH == 0 template struct string_maker { using result = string; }; template struct string_maker { using result = string; }; #endif template struct string_maker { using result = string; }; template using make_string = typename string_maker::result; struct Initializer { template Initializer(TSerial &serial, int bauds) { serial.begin(bauds); while (!serial) continue; } }; template struct Printer { template Printer(TSerial &serial, const TValue &content) { serial.print(make_string {}.data()); serial.print(make_string {}.data()); serial.println(content); serial.flush(); } }; } // namespace ArduinoTrace #define ARDUINOTRACE_STRINGIFY(X) #X #define ARDUINOTRACE_CONCAT(X, Y) X##Y #if ARDUINOTRACE_ENABLE_PROGMEM #define ARDUINOTRACE_FLASHIFY(X) F(X) #else #define ARDUINOTRACE_FLASHIFY(X) X #endif #if ARDUINOTRACE_FUNCTION_NAME_IN_FLASH #define ARDUINOTRACE_FUNCTION_NAME \ reinterpret_cast(__PRETTY_FUNCTION__) #else #define ARDUINOTRACE_FUNCTION_NAME __PRETTY_FUNCTION__ #endif #define ARDUINOTRACE_PRINT(id, file, prefix, content) \ { \ struct __filename { \ constexpr static char const *data() { return file; } \ }; \ struct __prefix { \ constexpr static char const *data() { return prefix; } \ }; \ ArduinoTrace::Printer<__filename, __prefix> __tracer(ARDUINOTRACE_SERIAL, \ content); \ } #define ARDUINOTRACE_INITIALIZE(id, bauds) \ ArduinoTrace::Initializer ARDUINOTRACE_CONCAT(__initializer, id)( \ ARDUINOTRACE_SERIAL, bauds); #define ARDUINOTRACE_TRACE_PREFIX(line) ":" ARDUINOTRACE_STRINGIFY(line) ": " #define ARDUINOTRACE_DUMP_PREFIX(line, variable) \ ":" ARDUINOTRACE_STRINGIFY(line) ": " #variable " = " // Initializes the Serial port // // Use this macro only if you want to call TRACE() at global scope, // in other cases, call Serial.begin() in your setup() function, as usual. #define ARDUINOTRACE_INIT(bauds) ARDUINOTRACE_INITIALIZE(__COUNTER__, bauds); // Adds a trace in the Serial port // // Call this macro anywhere, including at global scope. // However, if you use it at global scope, you need to call ARDUINOTRACE_INIT() // first, otherwise, the Serial port will not be ready. #define TRACE() \ ARDUINOTRACE_PRINT(__COUNTER__, __FILE__, \ ARDUINOTRACE_TRACE_PREFIX(__LINE__), \ ARDUINOTRACE_FUNCTION_NAME) // Prints the value of a variable. // // This function will print the name and the value of the variable to the // Serial. If you use it at global scope, you need to call ARDUINOTRACE_INIT() // first, otherwise, the Serial port will not be ready. #define DUMP(variable) \ ARDUINOTRACE_PRINT(__COUNTER__, __FILE__, \ ARDUINOTRACE_DUMP_PREFIX(__LINE__, variable), variable) #else // ie ARDUINOTRACE_ENABLE == 0 #define ARDUINOTRACE_INIT(bauds) #define TRACE() #define DUMP(variable) #endif