initial commit

Author: mrRobot62

Logging.cpp

@@ -0,0 +1,131 @@
+#include "Logging.h"
+
+Logging::Logging(int level, long baud) {
+    _level = constrain(level,LOG_LEVEL_NOOUTPUT,LOG_LEVEL_VERBOSE);
+    _baud = baud;
+} 
+
+
+void Logging::Init(){
+    Serial.begin(_baud);
+}
+
+void Logging::Error(char* msg, ...){
+    if (LOG_LEVEL_ERRORS <= _level) {   
+		print ("ERROR: ",0);
+        va_list args;
+        va_start(args, msg);
+        print(msg,args);
+    }
+}
+
+#if LOGLEVEL >= LOG_LEVEL_INFOS
+void Logging::Info(char* msg, ...){
+    if (LOG_LEVEL_INFOS <= _level) {
+        va_list args;
+        va_start(args, msg);
+        print(msg,args);
+    }
+}
+
+#if LOGLEVEL >= LOG_LEVEL_DEBUG
+void Logging::Debug(char* msg, ...){
+    if (LOG_LEVEL_DEBUG <= _level) {
+        va_list args;
+        va_start(args, msg);
+        print(msg,args);
+    }
+}
+
+#if LOGLEVEL >= LOG_LEVEL_VERBOSE
+void Logging::Verbose(char* msg, ...){
+    if (LOG_LEVEL_VERBOSE <= _level) {
+        va_list args;
+        va_start(args, msg);
+        print(msg,args);
+    }
+}
+#endif // LOG_LEVEL_VERBOSE
+#endif // LOG_LEVEL_DEBUG
+#endif // LOG_LEVEL_INFOS
+
+
+ void Logging::print(const char *format, va_list args) {
+    //
+    // loop through format string
+    for (; *format != 0; ++format) {
+        if (*format == '%') {
+            ++format;
+            if (*format == '\0') break;
+            if (*format == '%') {
+                Serial.print(*format);
+                continue;
+            }
+            if( *format == 's' ) {
+				register char *s = (char *)va_arg( args, int );
+				Serial.print(s);
+				continue;
+			}
+            if( *format == 'd' || *format == 'i') {
+				Serial.print(va_arg( args, int ),DEC);
+				continue;
+			}
+            if( *format == 'x' ) {
+				Serial.print(va_arg( args, int ),HEX);
+				continue;
+			}
+            if( *format == 'X' ) {
+				Serial.print("0x");
+				Serial.print(va_arg( args, int ),HEX);
+				continue;
+			}
+            if( *format == 'b' ) {
+				Serial.print(va_arg( args, int ),BIN);
+				continue;
+			}
+            if( *format == 'B' ) {
+				Serial.print("0b");
+				Serial.print(va_arg( args, int ),BIN);
+				continue;
+			}
+            if( *format == 'l' ) {
+				Serial.print(va_arg( args, long ),DEC);
+				continue;
+			}
+
+            if( *format == 'c' ) {
+				Serial.print(va_arg( args, int ));
+				continue;
+			}
+            if( *format == 't' ) {
+				if (va_arg( args, int ) == 1) {
+					Serial.print("T");
+				}
+				else {
+					Serial.print("F");				
+				}
+				continue;
+			}
+            if( *format == 'T' ) {
+				if (va_arg( args, int ) == 1) {
+					Serial.print("true");
+				}
+				else {
+					Serial.print("false");				
+				}
+				continue;
+			}
+
+        }
+        Serial.print(*format);
+    }
+ }
+ 
+
+ 
+ 
+  
+
+
+
+

Logging.h

@@ -0,0 +1,145 @@
+#ifndef LOGGING_H
+#define LOGGING_H
+#include <inttypes.h>
+#include <stdarg.h>
+#if defined(ARDUINO) && ARDUINO >= 100
+	#include "Arduino.h"
+#else
+	#include "WProgram.h"
+#endif
+//#include "pins_arduino.h"
+extern "C" {
+  #include <avr/io.h>
+}
+
+
+#define LOG_LEVEL_NOOUTPUT 0 
+#define LOG_LEVEL_ERRORS 1
+#define LOG_LEVEL_INFOS 2
+#define LOG_LEVEL_DEBUG 3
+#define LOG_LEVEL_VERBOSE 4
+
+// default loglevel if nothing is set from user
+#define LOGLEVEL LOG_LEVEL_DEBUG 
+
+
+#define CR "\r\n"
+#define LOGGING_VERSION 1
+
+/*!
+* Logging is a helper class to output informations over
+* RS232. If you know log4j or log4net, this logging class
+* is more or less similar ;-) <br>
+* Different loglevels can be used to extend or reduce output
+* All methods are able to handle any number of output parameters.
+* All methods print out a formated string (like printf).<br>
+* To reduce output and program size, reduce loglevel.
+* <br>
+* Output format string can contain below wildcards. Every wildcard
+* must be start with percent sign (\%)
+*
+* <b>Depending on loglevel, source code is excluded from compile !</b><br>
+* <br>
+* <b>Wildcards</b><br>
+* <ul>
+* <li><b>\%s</b>	replace with an string (char*)</li>
+* <li><b>\%c</b>	replace with an character</li>
+* <li><b>\%d</b>	replace with an integer value</li>
+* <li><b>\%l</b>	replace with an long value</li>
+* <li><b>\%x</b>	replace and convert integer value into hex</li>
+* <li><b>\%X</b>	like %x but combine with <b>0x</b>123AB</li>
+* <li><b>\%b</b>	replace and convert integer value into binary</li>
+* <li><b>\%B</b>	like %x but combine with <b>0b</b>10100011</li>
+* <li><b>\%t</b>	replace and convert boolean value into <b>"t"</b> or <b>"f"</b></li>
+* <li><b>\%T</b>	like %t but convert into <b>"true"</b> or <b>"false"</b></li>
+* </ul><br>
+* <b>Loglevels</b><br>
+* <table border="0">
+* <tr><td>0</td><td>LOG_LEVEL_NOOUTPUT</td><td>no output </td></tr>
+* <tr><td>1</td><td>LOG_LEVEL_ERRORS</td><td>only errors </td></tr>
+* <tr><td>2</td><td>LOG_LEVEL_INFOS</td><td>errors and info </td></tr>
+* <tr><td>3</td><td>LOG_LEVEL_DEBUG</td><td>errors, info and debug </td></tr>
+* <tr><td>4</td><td>LOG_LEVEL_VERBOSE</td><td>all </td></tr>
+* </table>
+*/
+class Logging {
+private:
+    int _level;
+    long _baud;
+public:
+    /*! 
+	 * Constructor
+	 * initialize loglevel and set baud rate
+	 * \param level	possible loglevel between 0 - 4
+	 * \param baud baudrate for RS232
+	 * \return 
+	 *
+	 */
+    Logging(int level, long baud) ;
+	
+    /** 
+	* Initializing, must be called as first.
+	* \param void
+	* \return void
+	*
+	*/
+	void Init();
+	
+    /**
+	* Output an error message. Output message contains
+	* ERROR: followed by original msg
+	* Error messages are printed out, at every loglevel
+	* except 0 ;-)
+	* \param msg format string to output
+	* \param ... any number of variables
+	* \return void
+	*/
+    void Error(char* msg, ...);
+	
+    /**
+	* Output an info message. Output message contains
+	* Info messages are printed out at l
+	* loglevels >= LOG_LEVEL_INFOS
+	*
+	* \param msg format string to output
+	* \param ... any number of variables
+	* \return void
+	*/
+ #if LOGLEVEL >= LOG_LEVEL_INFOS
+   void Info(char* msg, ...);
+	
+    /**
+	* Output an debug message. Output message contains
+	* Debug messages are printed out at l
+	* loglevels >= LOG_LEVEL_DEBUG
+	*
+	* \param msg format string to output
+	* \param ... any number of variables
+	* \return void
+	*/
+#if LOGLEVEL >= LOG_LEVEL_DEBUG
+    void Debug(char* msg, ...);
+	
+    /**
+	* Output an verbose message. Output message contains
+	* Debug messages are printed out at l
+	* loglevels >= LOG_LEVEL_VERBOSE
+	*
+	* \param msg format string to output
+	* \param ... any number of variables
+	* \return void
+	*/
+#if LOGLEVEL >= LOG_LEVEL_VERBOSE
+    void Verbose(char* msg, ...);   
+#endif // LOG_LEVEL_VERBOSE
+#endif // LOG_LEVEL_DEBUG
+#endif // LOG_LEVEL_INFOS
+    
+private:
+    void print(const char *format, va_list args);
+};
+#endif
+
+
+
+

Logging_WikiPage.txt

@@ -0,0 +1,41 @@
+%define=box block bgcolor=#dddddd border="2px dotted white"%
+%define=wbox block bgcolor=#eeeeee color=#000000 border="1px dotted black" padding="2px"%
+
+
+%wbox%[@Logging library for Arudino
+by LunaX - 2010/2011
+@]%%
+
+!CURRENT VERSION
+
+0.8)14-FEB-2012 beta version.
+
+!HISTORY
+
+0.8) 14-FEB-2012 Initial Release\\
+
+
+!DESCRIPTION
+Easy to use logging library, like log4j or log4net. After getting a logger object, you will have
+methods like Error, Info, Warn, Debug, Verbose to log informations over RS232.
+Depending on the current loglevel lower logleves are not printed out.
+It is possible to work with variable argument lists during output.
+
+!HOW TO IMPORT/INSTALL
+Download here: [[Attach:Enerlib.zip|Enerlib 1.0.0]]
+
+Put the Logging folder in "libraries\".
+
+In the Arduino IDE, create a new sketch (or open one) and select from the menubar "Sketch->Import Library->Logging".
+Once the library is imported, a "#include <Logging.h>" line will appear at the top of your Sketch.
+
+!Methods
+!!void Error(
+
+!Loglevels
+
+!Example
+For more examples look into sub folder examples 
+
+
+@]%%