original files of m241
This commit is contained in:
neelimap
@@ -0,0 +1,245 @@
|
||||
/******************************************************************************
|
||||
|
||||
© 1995-2003, 2004, 2005-2010 Freescale Semiconductor, Inc.
|
||||
All rights reserved.
|
||||
|
||||
This is proprietary source code of Freescale Semiconductor Inc.,
|
||||
and its use is subject to the NetComm Device Drivers EULA.
|
||||
The copyright notice above does not evidence any actual or intended
|
||||
publication of such source code.
|
||||
|
||||
**************************************************************************/
|
||||
/**************************************************************************//**
|
||||
@File debug_ext.h
|
||||
|
||||
@Description Debug mode definitions.
|
||||
*//***************************************************************************/
|
||||
|
||||
#ifndef __DEBUG_EXT_H
|
||||
#define __DEBUG_EXT_H
|
||||
|
||||
#include "std_ext.h"
|
||||
#include "xx_ext.h"
|
||||
#include "memcpy_ext.h"
|
||||
#if (DEBUG_ERRORS > 0)
|
||||
#include "sprint_ext.h"
|
||||
#include "string_ext.h"
|
||||
#endif /* DEBUG_ERRORS > 0 */
|
||||
|
||||
|
||||
#if (DEBUG_ERRORS > 0)
|
||||
|
||||
/* Internally used macros */
|
||||
|
||||
#define DUMP_Print XX_Print
|
||||
#define DUMP_MAX_LEVELS 6
|
||||
#define DUMP_MAX_STR 64
|
||||
|
||||
|
||||
#define _CREATE_DUMP_SUBSTR(phrase) \
|
||||
dumpTmpLevel = 0; dumpSubStr[0] = '\0'; \
|
||||
sprintf(dumpTmpStr, "%s", #phrase); \
|
||||
p_DumpToken = strtok(dumpTmpStr, (dumpIsArr[0] ? "[" : ".")); \
|
||||
while (p_DumpToken != NULL) \
|
||||
{ \
|
||||
strcat(dumpSubStr, p_DumpToken); \
|
||||
if (dumpIsArr[dumpTmpLevel]) \
|
||||
{ \
|
||||
strcat(dumpSubStr, dumpIdxStr[dumpTmpLevel]); \
|
||||
p_DumpToken = strtok(NULL, "."); \
|
||||
} \
|
||||
if ((p_DumpToken = strtok(NULL, (dumpIsArr[++dumpTmpLevel] ? "[" : "."))) != 0) \
|
||||
strcat(dumpSubStr, "."); \
|
||||
}\
|
||||
|
||||
|
||||
/**************************************************************************//**
|
||||
@Group gen_id General Drivers Utilities
|
||||
|
||||
@Description External routines.
|
||||
|
||||
@{
|
||||
*//***************************************************************************/
|
||||
|
||||
/**************************************************************************//**
|
||||
@Group dump_id Memory and Registers Dump Mechanism
|
||||
|
||||
@Description Macros for dumping memory mapped structures.
|
||||
|
||||
@{
|
||||
*//***************************************************************************/
|
||||
|
||||
/**************************************************************************//**
|
||||
@Description Declaration of dump mechanism variables.
|
||||
|
||||
This macro must be declared at the beginning of each routine
|
||||
which uses the dump mechanism macros, before the routine's code
|
||||
starts.
|
||||
*//***************************************************************************/
|
||||
#define DECLARE_DUMP \
|
||||
char dumpIdxStr[DUMP_MAX_LEVELS + 1][6] = { "", }; \
|
||||
char dumpSubStr[DUMP_MAX_STR] = ""; \
|
||||
char dumpTmpStr[DUMP_MAX_STR] = ""; \
|
||||
char *p_DumpToken = NULL; \
|
||||
int dumpArrIdx = 0, dumpArrSize = 0, dumpVarSize = 0, dumpLevel = 0, dumpTmpLevel = 0; \
|
||||
uint8_t dumpIsArr[DUMP_MAX_LEVELS + 1] = { 0 }; \
|
||||
/* Prevent warnings if not all used */ \
|
||||
UNUSED(dumpIdxStr[0][0]); \
|
||||
UNUSED(dumpSubStr[0]); \
|
||||
UNUSED(dumpTmpStr[0]); \
|
||||
UNUSED(p_DumpToken); \
|
||||
UNUSED(dumpArrIdx); \
|
||||
UNUSED(dumpArrSize); \
|
||||
UNUSED(dumpVarSize); \
|
||||
UNUSED(dumpLevel); \
|
||||
UNUSED(dumpTmpLevel); \
|
||||
UNUSED(dumpIsArr[0]);
|
||||
|
||||
|
||||
/**************************************************************************//**
|
||||
@Description Prints a title for a subsequent dumped structure or memory.
|
||||
|
||||
The inputs for this macro are the structure/memory title and
|
||||
its base addresss.
|
||||
*//***************************************************************************/
|
||||
#define DUMP_TITLE(addr, msg) \
|
||||
DUMP_Print("\r\n"); DUMP_Print msg; \
|
||||
DUMP_Print(" (0x%08X)\r\n" \
|
||||
"---------------------------------------------------------\r\n", \
|
||||
(uint32_t)addr)
|
||||
|
||||
/**************************************************************************//**
|
||||
@Description Prints a subtitle for a subsequent dumped sub-structure (optional).
|
||||
|
||||
The inputs for this macro are the sub-structure subtitle.
|
||||
A separating line with this subtitle will be printed.
|
||||
*//***************************************************************************/
|
||||
#define DUMP_SUBTITLE(subtitle) \
|
||||
DUMP_Print("----------- "); DUMP_Print subtitle; DUMP_Print("\r\n")
|
||||
|
||||
|
||||
/**************************************************************************//**
|
||||
@Description Dumps a memory region in 4-bytes aligned format.
|
||||
|
||||
The inputs for this macro are the base addresss and size
|
||||
(in bytes) of the memory region.
|
||||
*//***************************************************************************/
|
||||
#define DUMP_MEMORY(addr, size) \
|
||||
MemDisp((uint8_t *)(addr), (int)(size))
|
||||
|
||||
|
||||
/**************************************************************************//**
|
||||
@Description Declares a dump loop, for dumping a sub-structure array.
|
||||
|
||||
The inputs for this macro are:
|
||||
- idx: an index variable, for indexing the sub-structure items
|
||||
inside the loop. This variable must be declared separately
|
||||
in the beginning of the routine.
|
||||
- cnt: the number of times to repeat the loop. This number should
|
||||
equal the number of items in the sub-structures array.
|
||||
|
||||
Note, that the body of the loop must be written inside brackets.
|
||||
*//***************************************************************************/
|
||||
#define DUMP_SUBSTRUCT_ARRAY(idx, cnt) \
|
||||
for (idx=0, dumpIsArr[dumpLevel++] = 1; \
|
||||
(idx < cnt) && sprintf(dumpIdxStr[dumpLevel-1], "[%d]", idx); \
|
||||
idx++, ((idx < cnt) || ((dumpIsArr[--dumpLevel] = 0) == 0)))
|
||||
|
||||
|
||||
/**************************************************************************//**
|
||||
@Description Dumps a structure's member variable.
|
||||
|
||||
The input for this macro is the full reference for the member
|
||||
variable, where the structure is referenced using a pointer.
|
||||
|
||||
Note, that a members array must be dumped using DUMP_ARR macro,
|
||||
rather than using this macro.
|
||||
|
||||
If the member variable is part of a sub-structure hierarchy,
|
||||
the full hierarchy (including array indexing) must be specified.
|
||||
|
||||
Examples: p_Struct->member
|
||||
p_Struct->sub.member
|
||||
p_Struct->sub[i].member
|
||||
*//***************************************************************************/
|
||||
#define DUMP_VAR(st, phrase) \
|
||||
do { \
|
||||
void *addr = (void *)&((st)->phrase); \
|
||||
_CREATE_DUMP_SUBSTR(phrase); \
|
||||
dumpVarSize = sizeof((st)->phrase); \
|
||||
switch (dumpVarSize) \
|
||||
{ \
|
||||
case 1: DUMP_Print("0x%08X: 0x%02x%14s\t%s\r\n", \
|
||||
addr, GET_UINT8((st)->phrase), "", dumpSubStr); break; \
|
||||
case 2: DUMP_Print("0x%08X: 0x%04x%12s\t%s\r\n", \
|
||||
addr, GET_UINT16((st)->phrase), "", dumpSubStr); break; \
|
||||
case 4: DUMP_Print("0x%08X: 0x%08x%8s\t%s\r\n", \
|
||||
addr, GET_UINT32((st)->phrase), "", dumpSubStr); break; \
|
||||
case 8: DUMP_Print("0x%08X: 0x%016llx\t%s\r\n", \
|
||||
addr, GET_UINT64((st)->phrase), dumpSubStr); break; \
|
||||
default: DUMP_Print("Bad size %d (" #st "->" #phrase ")\r\n", dumpVarSize); \
|
||||
} \
|
||||
} while (0)
|
||||
|
||||
|
||||
/**************************************************************************//**
|
||||
@Description Dumps a structure's members array.
|
||||
|
||||
The input for this macro is the full reference for the members
|
||||
array, where the structure is referenced using a pointer.
|
||||
|
||||
If the members array is part of a sub-structure hierarchy,
|
||||
the full hierarchy (including array indexing) must be specified.
|
||||
|
||||
Examples: p_Struct->array
|
||||
p_Struct->sub.array
|
||||
p_Struct->sub[i].array
|
||||
*//***************************************************************************/
|
||||
#define DUMP_ARR(st, phrase) \
|
||||
do { \
|
||||
_CREATE_DUMP_SUBSTR(phrase); \
|
||||
dumpArrSize = ARRAY_SIZE((st)->phrase); \
|
||||
dumpVarSize = sizeof((st)->phrase[0]); \
|
||||
switch (dumpVarSize) \
|
||||
{ \
|
||||
case 1: \
|
||||
for (dumpArrIdx=0; dumpArrIdx < dumpArrSize; dumpArrIdx++) { \
|
||||
DUMP_Print("0x%08X: 0x%02x%14s\t%s[%d]\r\n", \
|
||||
&((st)->phrase[dumpArrIdx]), GET_UINT8((st)->phrase[dumpArrIdx]), "", dumpSubStr, dumpArrIdx); \
|
||||
} break; \
|
||||
case 2: \
|
||||
for (dumpArrIdx=0; dumpArrIdx < dumpArrSize; dumpArrIdx++) { \
|
||||
DUMP_Print("0x%08X: 0x%04x%12s\t%s[%d]\r\n", \
|
||||
&((st)->phrase[dumpArrIdx]), GET_UINT16((st)->phrase[dumpArrIdx]), "", dumpSubStr, dumpArrIdx); \
|
||||
} break; \
|
||||
case 4: \
|
||||
for (dumpArrIdx=0; dumpArrIdx < dumpArrSize; dumpArrIdx++) { \
|
||||
DUMP_Print("0x%08X: 0x%08x%8s\t%s[%d]\r\n", \
|
||||
&((st)->phrase[dumpArrIdx]), GET_UINT32((st)->phrase[dumpArrIdx]), "", dumpSubStr, dumpArrIdx); \
|
||||
} break; \
|
||||
case 8: \
|
||||
for (dumpArrIdx=0; dumpArrIdx < dumpArrSize; dumpArrIdx++) { \
|
||||
DUMP_Print("0x%08X: 0x%016llx\t%s[%d]\r\n", \
|
||||
&((st)->phrase[dumpArrIdx]), GET_UINT64((st)->phrase[dumpArrIdx]), dumpSubStr, dumpArrIdx); \
|
||||
} break; \
|
||||
case 16: \
|
||||
for (dumpArrIdx=0; dumpArrIdx < dumpArrSize; dumpArrIdx++) { \
|
||||
DUMP_Print("0x%08X: 0x%016llx %016llx\t%s[%d]\r\n", \
|
||||
&((st)->phrase[dumpArrIdx]), \
|
||||
GET_UINT64((st)->phrase[dumpArrIdx]), \
|
||||
GET_UINT64(*(&((st)->phrase[dumpArrIdx]) + sizeof(UINT64))), dumpSubStr, dumpArrIdx); \
|
||||
} break; \
|
||||
default: DUMP_Print("Bad size %d (" #st "->" #phrase "[0])\r\n", dumpVarSize); \
|
||||
} \
|
||||
} while (0)
|
||||
|
||||
|
||||
#endif /* DEBUG_ERRORS > 0 */
|
||||
|
||||
|
||||
/** @} */ /* end of dump_id group */
|
||||
/** @} */ /* end of gen_id group */
|
||||
|
||||
|
||||
#endif /* __DEBUG_EXT_H */
|
||||
|
||||
Reference in New Issue
Block a user