dsmDbg.h

Go to the documentation of this file.

/*******************************************************************************
 * Copyright © 2014 The DTVKit Open Software Foundation Ltd (www.dtvkit.org)
 * Copyright © 2004 Ocean Blue Software Ltd
 *
 * This file is part of a DTVKit Software Component
 * You are permitted to copy, modify or distribute this file subject to the terms
 * of the DTVKit 1.0 Licence which can be found in licence.txt or at www.dtvkit.org
 * 
 * THIS CODE AND INFORMATION ARE PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND,
 * EITHER EXPRESSED OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE IMPLIED WARRANTIES
 * OF MERCHANTABILITY AND/OR FITNESS FOR A PARTICULAR PURPOSE.
 * 
 * If you or your organisation is not a member of DTVKit then you have access
 * to this source code outside of the terms of the licence agreement
 * and you are expected to delete this and any associated files immediately.
 * Further information on DTVKit, membership and terms can be found at www.dtvkit.org
 *******************************************************************************/
#ifndef _DSMDBG_H_
#define _DSMDBG_H_

/*-------------------------------- Includes ----------------------------------*/
#include <assert.h>
#include "cldsmdbg.h"

/*-------------------------------- Defines -----------------------------------*/
/* -- DEBUG PRINT DEFINITIONS */

/* -- All debug output goes to stdout (printf) only
***** Because currently we don't know how to use memory based DPs in DVP/MIPS!
*/

#if (defined(NDEBUG) || defined(NO_DP)) /* -- ie. retail and/or assert build */
  #define dsmAssert( assertion )
  #define ASSERT(condition)
  #ifdef DSM_DP_LEVEL
    #undef DSM_DP_LEVEL
  #endif
  #define DSM_DP_LEVEL 0
#else
  #define dsmAssert( assertion )    assert assertion
  #define ASSERT(condition)         assert(condition);
  #ifndef DSM_DP_LEVEL
    #define DSM_DP_LEVEL  ( 1 ) /* -- default */
  #endif
#endif

/* -- Level 1 Debug Print
*
* For fatal errors and conditions that should not occur frequently.
*
* eg.
* - Internal and API errors (optional since also assert)
* - Runtime errors
* - Fatal data errors
* - Critical debug info
*
* NB. Directed to a both debug print ports for high visibility.
*
*/
#if DSM_DP_LEVEL >= 1
  #define dsmDP1( x )     if (DBG_ErrorPrintfFunc) DBG_ErrorPrintfFunc x
  #define ERRPRINT(x, ...) \
      if (DBG_ErrorPrintfFunc) DBG_ErrorPrintfFunc("%s:%d " x "\n",__FUNCTION__,__LINE__, ##__VA_ARGS__);
  #define DBGERROR(f,x, ...) \
      if (DBG_ErrorPrintfFunc && (f & dsmDbgState)) DBG_ErrorPrintfFunc("%s:%d " x "\n",__FUNCTION__,__LINE__, ##__VA_ARGS__);
#else
  #define dsmDP1( x )
  #define ERRPRINT(x, ...)
  #define DBGERROR(f,x, ...)
#endif

/* -- Level 2 Debug Print
*
* For warnings, conditions etc. that may occur more frequently.
*
* eg.
* - Non-fatal data errors (ie. warnings)
* - API Function entry/exit print
*
*/
#if DSM_DP_LEVEL >= 2
  #define dsmDP2( x )     if (DBG_WarnPrintfFunc) DBG_WarnPrintfFunc x
  #define DBGWARN(f,x, ...) \
      if (DBG_WarnPrintfFunc && (f & dsmDbgState))  DBG_WarnPrintfFunc("%s:%d " x "\n",__FUNCTION__,__LINE__, ##__VA_ARGS__);
#else
  #define dsmDP2( x )
  #define DBGWARN(f,x, ...)
#endif


/* -- Level 3 Debug Print
*
* For general debug info and conditions that occur fairly frequently
* but only print limited output.
*
* eg. - Lower level function entry/exit points
*
*/
#if DSM_DP_LEVEL >= 3
  #define dsmDP3( x )   if (DBG_DebugPrintfFunc) DBG_DebugPrintfFunc x
  #define DBGPRINT(f,x, ...) \
      if (DBG_DebugPrintfFunc && (f & dsmDbgState)) DBG_DebugPrintfFunc("%s:%d " x "\n",__FUNCTION__,__LINE__, ##__VA_ARGS__);
#else
  #define dsmDP3( x )
  #define DBGPRINT(f,x, ...)
#endif


/* -- Level 4 Debug Print
*
* For detailed debug info and conditions that occur VERY frequently
* and/or print large amounts of output.
*
* eg. - Very low level function entry/exit points
*     - Data array values printed from loop
*
*/
#if DSM_DP_LEVEL >= 4
  #define dsmDP4( x )   if (DBG_InfoPrintfFunc) DBG_InfoPrintfFunc x
  #define DBGINFO(f,x, ...) \
      if (DBG_InfoPrintfFunc && (f & dsmDbgState))  DBG_InfoPrintfFunc("%s:%d " x "\n",__FUNCTION__,__LINE__, ##__VA_ARGS__);

#else
  #define dsmDP4( x )
  #define DBGINFO(f,x, ...)
#endif



/*-------------------------------- Types -------------------------------------*/


/*------------------------------  Exported Data  -----------------------------*/

#if (!defined(NDEBUG) && !defined(NO_DP))
extern clDsmPrintFunc_t DBG_ErrorPrintfFunc;
extern clDsmPrintFunc_t DBG_WarnPrintfFunc;
extern clDsmPrintFunc_t DBG_DebugPrintfFunc;
extern clDsmPrintFunc_t DBG_InfoPrintffunc;
extern U32BIT dsmDbgState;
#endif

/*------------------------------ Prototypes ----------------------------------*/


/*----------------------------------------------------------------------------*/

#endif /* _DSMDBG_H_ */