trace.h

一个基于windows mobile 的GPS 接受IC 驱动程序。

#ifndef TRACE_H__       // { trace.h
#define TRACE_H__

#define ENABLE_TRACE
#undef  ENABLE_TRACE

#undef  ENABLE_STATS
#define ENABLE_STATS

extern void  traceDump(bool closeTrace);
extern void  traceInit(void);
extern void  traceStats(DWORD ticks);
extern void  traceResume(void);
extern void  traceSave(unsigned short line, char type, DWORD val);
extern DWORD traceCopy(PBYTE pBufOut, DWORD dwLenOut, int maj, int min);
extern void  traceParamSet(const PBYTE pBufIn, DWORD dwLenIn);
extern void  traceIsr(int isr, DWORD time);
extern void  traceTime(unsigned short line);

#ifdef  ENABLE_TRACE        // {

    #define TRACE(type,val)     traceSave(__LINE__,type,static_cast<DWORD>(val))
    #define TRACE_ISR(val,time) traceIsr(val,time)
    #define TRACE_TIME()        traceTime(__LINE__)

    #undef   _ENABLE_TRACE_
    #define  _ENABLE_TRACE_

    #define _TRACE_BODY_

#else

    #define TRACE(type,val)
    #define TRACE_ISR(val,time)
    #define TRACE_TIME()

#endif              // }

#ifdef  ENABLE_STATS        // {

#ifndef _TRACE_BODY_                // ENABLE_TRACE overrides this!
    #define _TRACE_BODY_
    #undef  _TRACE_BODY_            // ENABLE_STATS_SUMMARY_ONLY
#endif

    #define STATS_READ(n,time) \
                    traceSave(n,TR_STATS_READ,static_cast<DWORD>(time))
    #define STATS_WRITE(n,time) \
                    traceSave(n,TR_STATS_WRITE,static_cast<DWORD>(time))
    #define STATS_INT_ACK(val) \
                    traceSave(__LINE__,TR_INT_ACK,static_cast<DWORD>(val))
    #undef  TRACE_ISR
    #define TRACE_ISR(val,time)      traceIsr(val,time)

    #undef   _ENABLE_TRACE_
    #define  _ENABLE_TRACE_

#else

    #define STATS_READ(n,time)
    #define STATS_WRITE(n,time)
    #define STATS_INT_ACK(val)

#endif              // }

enum
{
    //  All these traces are terrific for debugging the SPI_Exchange_Bytes
    //  and lowest levels of the SPI device driver.
    TR_SPI_SR     = 1,
    TR_SW         = 2,
    TR_WR_CMD     = 3,
    TR_RD_STATUS  = 4,
    TR_WR_DATA    = 5,
    TR_RD_DATA    = 6,
    TR_REPEAT     = 7,
    TR_SPI_CMD    = 8,
    TR_TIME       = 9,
    TR_TRACE      = 10,     // meta information.

    //  These traces are for debugging the overall device driver performance.
    TR_STATS_READ  = 11,
    TR_STATS_WRITE = 12,
    TR_INT_ACK     = 13,
    TR_ISR         = 14
};

#endif                  // } TRACE_H__