MAV'RIC
/home/travis/build/lis-epfl/MAVRIC_Library/hal/common/dbg.hpp
00001 /*******************************************************************************
00002  * Copyright (c) 2009-2016, MAV'RIC Development Team
00003  * All rights reserved.
00004  *
00005  * Redistribution and use in source and binary forms, with or without
00006  * modification, are permitted provided that the following conditions are met:
00007  *
00008  * 1. Redistributions of source code must retain the above copyright notice,
00009  * this list of conditions and the following disclaimer.
00010  *
00011  * 2. Redistributions in binary form must reproduce the above copyright notice,
00012  * this list of conditions and the following disclaimer in the documentation
00013  * and/or other materials provided with the distribution.
00014  *
00015  * 3. Neither the name of the copyright holder nor the names of its contributors
00016  * may be used to endorse or promote products derived from this software without
00017  * specific prior written permission.
00018  *
00019  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
00020  * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
00021  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
00022  * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
00023  * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
00024  * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
00025  * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
00026  * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
00027  * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
00028  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
00029  * POSSIBILITY OF SUCH DAMAGE.
00030  ******************************************************************************/
00031 
00032 /*******************************************************************************
00033  * \file    dbg.hpp
00034  *
00035  * \author  MAV'RIC Team
00036  *
00037  * \brief   Write debug messages
00038  *
00039  * Prints human-readable messages to a console.
00040  * The implementation of templated function is in dbg.hxx while the rest is in dbg.cpp
00041  * Before initialization, data is written to a dummy console.
00042  * dout() can be used for cout like syntax: 'dout() << "hello " << 123 << endl;'
00043  * To define '<<' operator for your own class, implement the follwing function
00044  * in the header of your class, outside of your class definition:
00045  * template<typename Writeable>
00046  *  Console<Writeable>& operator<< (Console<Writeable>& console, Yourclass& yourclass)
00047  *  {
00048  *      console.write(...);
00049  *      return console;
00050  *  }
00051  ******************************************************************************/
00052 
00053 #ifndef DBG_HPP_
00054 #define DBG_HPP_
00055 
00056 #include "hal/dummy/serial_dummy.hpp"
00057 #include "hal/common/console.hpp"
00058 #include <cstdint>
00059 
00060 namespace dbg
00061 {
00062 
00069 void init(Console<Serial>& console);
00070 
00078 Console<Serial>& dout();
00079 
00089 bool print(const uint8_t* data, uint32_t size);
00090 
00099 template<typename T>
00100 static bool print(T data);
00101 
00110 template<typename T>
00111 bool println(T data);
00112 };
00113 
00114 // Template implementation file
00115 #include "dbg.hxx"
00116 
00117 //Dbg& dout = Dbg::getInstance();
00118 #endif /* DBG_HPP_ */
 All Classes Files Functions Variables Typedefs Enumerations Enumerator Friends Defines