This class provides functionality useful for debugging sketches via printf-style statements.
Arduino_DebugUtils has 6 different debug levels (described descending from highest to lowest priority):
DBG_NONE- no debug output is shownDBG_ERROR- critical errorsDBG_WARNING- non-critical errorsDBG_INFO- informationDBG_DEBUG- more informationDBG_VERBOSE- most information
The desired debug level can be set via setDebugLevel(DBG_WARNING).
Debug messages are written via print which supports printf-style formatted output.
Example:
int i = 1;
float pi = 3.1459;
DEBUG_VERBOSE("i = %d, pi = %f", i, pi);Note: The output of floating point numbers (%f) does NOT work on ArduinoCore-avr.
If desired, timestamps can be prefixed to the debug message. Timestamp output can be enabled and disabled via timestampOn and timestampOff.
Normally all debug output is redirected to the primary serial output of each board (Serial). In case you want to redirect the output to another output stream you can make use of setDebugOutputStream(&Serial2).
Arduino_DebugUtils Object that will be used for calling member functions.
Parameter debug_level in order of lowest to highest priority are : DBG_NONE, DBG_ERROR, DBG_WARNING, DBG_INFO (default), DBG_DEBUG, and DBG_VERBOSE.
Return type: void.
Example:
Debug.setDebugLevel(DBG_VERBOSE);By default, Output Stream is Serial. In advanced cases other objects could be other serial ports (if available), or can be a Software Serial object.
Return type: void.
Example:
SoftwareSerial mySerial(10, 11); // RX, TX
Debug.setDebugOutputStream(&mySerial);Calling this function switches on the timestamp in the Debug.print() function call;
By default, printing timestamp is off, unless turned on using this function call.
Return type: void.
Example:
Debug.timestampOn();
DBG_VERBOSE("i = %d", i); //Output looks like : [ 21007 ] i = 21Calling this function switches off the timestamp in the Debug.print() function call;
Return type: void.
Example:
Debug.timestampOff();
DEBUG_VERBOSE("i = %d", i); //Output looks like : i = 21Calling this function ensures that a newline will be sent at the end of the Debug.print() function call;
By default, a newline is sent
Return type: void.
Example:
Debug.newlineOn();Calling this function ensure that a newline will NOT be sent at the end of the Debug.print() function call;
By default a newline is sent. Call this to shut that functionality off.
Return type: void.
Example:
Debug.timestampOff();This function prints the message if parameter debug_level in the Debug.print(debug_level, ...) function call belongs to the range: DBG_ERROR <= debug_level <= (<DBG_LEVEL> that has been set using setDebugLevel() function).
Return type: void.
Example:
Debug.setDebugLevel(DBG_VERBOSE);
int i = 0;
DEBUG_VERBOSE("DBG_VERBOSE i = %d", i);