| 1 |
585 |
jeremybenn |
/******************************************************************************
|
| 2 |
|
|
* File Name : trace.h
|
| 3 |
|
|
* Version : 1.0
|
| 4 |
|
|
* Device(s) : Renesas
|
| 5 |
|
|
* Tool-Chain : Renesas SH2A V9+
|
| 6 |
|
|
* OS : None
|
| 7 |
|
|
* H/W Platform : SH2A
|
| 8 |
|
|
* Description : Debug formatted output routine
|
| 9 |
|
|
* TRACE print function enabled with define _TRACE_ON_
|
| 10 |
|
|
*******************************************************************************
|
| 11 |
|
|
* History : DD.MM.YYYY Ver. Description
|
| 12 |
|
|
* : 01.08.2009 1.00 MAB First Release
|
| 13 |
|
|
******************************************************************************/
|
| 14 |
|
|
|
| 15 |
|
|
/******************************************************************************
|
| 16 |
|
|
* DISCLAIMER
|
| 17 |
|
|
* This software is supplied by Renesas Technology Corp. and is only
|
| 18 |
|
|
* intended for use with Renesas products. No other uses are authorized.
|
| 19 |
|
|
* This software is owned by Renesas Technology Corp. and is protected under
|
| 20 |
|
|
* all applicable laws, including copyright laws.
|
| 21 |
|
|
* THIS SOFTWARE IS PROVIDED "AS IS" AND RENESAS MAKES NO WARRANTIES
|
| 22 |
|
|
* REGARDING THIS SOFTWARE, WHETHER EXPRESS, IMPLIED OR STATUTORY,
|
| 23 |
|
|
* INCLUDING BUT NOT LIMITED TO WARRANTIES OF MERCHANTABILITY, FITNESS FOR A
|
| 24 |
|
|
* PARTICULAR PURPOSE AND NON-INFRINGEMENT. ALL SUCH WARRANTIES ARE EXPRESSLY
|
| 25 |
|
|
* DISCLAIMED.
|
| 26 |
|
|
* TO THE MAXIMUM EXTENT PERMITTED NOT PROHIBITED BY LAW, NEITHER RENESAS
|
| 27 |
|
|
* TECHNOLOGY CORP. NOR ANY OF ITS AFFILIATED COMPANIES SHALL BE LIABLE
|
| 28 |
|
|
* FOR ANY DIRECT, INDIRECT, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES
|
| 29 |
|
|
* FOR ANY REASON RELATED TO THE THIS SOFTWARE, EVEN IF RENESAS OR ITS
|
| 30 |
|
|
* AFFILIATES HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
|
| 31 |
|
|
* Renesas reserves the right, without notice, to make changes to this
|
| 32 |
|
|
* software and to discontinue the availability of this software.
|
| 33 |
|
|
* By using this software, you agree to the additional terms and
|
| 34 |
|
|
* conditions found by accessing the following link:
|
| 35 |
|
|
* http://www.renesas.com/disclaimer
|
| 36 |
|
|
******************************************************************************/
|
| 37 |
|
|
/* Copyright (C) 2008. Renesas Technology Corp., All Rights Reserved. */
|
| 38 |
|
|
/* Copyright (C) 2009. Renesas Technology Europe Ltd., All Rights Reserved. */
|
| 39 |
|
|
/*****************************************************************************/
|
| 40 |
|
|
|
| 41 |
|
|
#ifndef TRACE_H_INCLUDED
|
| 42 |
|
|
#define TRACE_H_INCLUDED
|
| 43 |
|
|
|
| 44 |
|
|
/******************************************************************************
|
| 45 |
|
|
User Includes
|
| 46 |
|
|
******************************************************************************/
|
| 47 |
|
|
|
| 48 |
|
|
#include "types.h"
|
| 49 |
|
|
|
| 50 |
|
|
/******************************************************************************
|
| 51 |
|
|
Function Macros
|
| 52 |
|
|
******************************************************************************/
|
| 53 |
|
|
|
| 54 |
|
|
/* Some function macros for TRACE output
|
| 55 |
|
|
NOTE: debugging TRACE statements require double braces
|
| 56 |
|
|
so the debug strings can be removed from the output load module:
|
| 57 |
|
|
TRACE(("My Variable = %u\r\n", uiMyVariable));
|
| 58 |
|
|
See ANSI C formatted output for more detail on the format specifiers */
|
| 59 |
|
|
|
| 60 |
|
|
#ifdef _TRACE_ON_ /* Trace ON */
|
| 61 |
|
|
#define TRACE(_x_) Trace _x_
|
| 62 |
|
|
#else /* _NO_TRACE_ON_ */
|
| 63 |
|
|
#define TRACE(_x_) /* TRACE REMOVED */
|
| 64 |
|
|
#endif /* _TRACE_ON_ */
|
| 65 |
|
|
|
| 66 |
|
|
/******************************************************************************
|
| 67 |
|
|
Public Functions
|
| 68 |
|
|
******************************************************************************/
|
| 69 |
|
|
|
| 70 |
|
|
#ifdef __cplusplus
|
| 71 |
|
|
extern "C" {
|
| 72 |
|
|
#endif
|
| 73 |
|
|
|
| 74 |
|
|
/******************************************************************************
|
| 75 |
|
|
Function Name: Trace
|
| 76 |
|
|
Description: Function to perform a formatted print output for debugging
|
| 77 |
|
|
Parameters: IN pszFormat - Pointer to a null terminated format string
|
| 78 |
|
|
I/O ... - The parameters
|
| 79 |
|
|
Return value: The number of chars output
|
| 80 |
|
|
******************************************************************************/
|
| 81 |
|
|
#ifdef _TRACE_ON_ /* Trace ON */
|
| 82 |
|
|
extern int Trace(const char *pszFormat, ...);
|
| 83 |
|
|
#endif
|
| 84 |
|
|
|
| 85 |
|
|
/******************************************************************************
|
| 86 |
|
|
Function Name: dbgPrintBuffer
|
| 87 |
|
|
Description: Function to print a data buffer in hex format
|
| 88 |
|
|
Parameters: IN pbyBuffer - Pointer to the buffer
|
| 89 |
|
|
IN stLength - The length of the buffer
|
| 90 |
|
|
Return value: none
|
| 91 |
|
|
******************************************************************************/
|
| 92 |
|
|
#ifdef _TRACE_ON_ /* Trace ON */
|
| 93 |
|
|
extern void dbgPrintBuffer(PBYTE pbyBuffer, size_t stLength);
|
| 94 |
|
|
#endif
|
| 95 |
|
|
|
| 96 |
|
|
#ifdef __cplusplus
|
| 97 |
|
|
}
|
| 98 |
|
|
#endif
|
| 99 |
|
|
|
| 100 |
|
|
#endif /* TRACE_H_INCLUDED */
|
| 101 |
|
|
|
| 102 |
|
|
/******************************************************************************
|
| 103 |
|
|
End Of File
|
| 104 |
|
|
******************************************************************************/
|
