关于开启lwIP协议栈的调试输出LWIP_DEBUGF

我们在分析lwIP协议栈的时候，会经常看到LWIP_DEBUGF（）这个函数的身影。我想lwIP的作者可能为了便于人们去学习和使用lwIP而花了不少时间添加的。

其实对于初学者来说，要把lwIP协议栈分析清楚不是一件容易的事情，尤其是对TCP/IP协议原理不是很了解的人。文件较多，函数较多，宏较多，调用关系相比一般的C程序来说较复杂。

我个人认为，有些时候开启一下lwIP的调试信息输出功能，无论是对于我们学习还是查找以太网通信中的故障都是有帮助的。它能够lwIP协议栈中的一些内部函数调用关系，变量值，追踪信息等通过串口输出来。

总之，

1.可以查看函数的调用关系，跟踪程序流程。

2.查看各种协议的调试信息，关键变量的值。

3.通过以上掌握的很有针对性调试信息，我们可以以此为依据进一步地去优化我们的工程，保证各种资源的分配合理，了解到底是通信过程中的哪一个环节限制了网络的性能，然后加以改善。

 其实，我觉得lwIP协议栈的调试上，作者也是花了不少心思的。把要输出地调试信息分为按协议类型（TCP，UDP，ICMP，ARP....），调试信息类型（LWIP_DBG_TRACE，LWIP_DBG_STATE，LWIP_DBG_FRESH），调试信息级别（LWIP_DBG_LEVEL_OFF,LWIP_DBG_LEVEL_WARNING，LWIP_DBG_LEVEL_SERIOUS，LWIP_DBG_LEVEL_SEVERE）

之所以要这么做，其实就是对要输出的调试信息有一个更好的管理，当我们开启调试功能后，只输出相关的调试信息，无关的信息就不要输出了。

接下来以一个简单的例子，说一下，如何开启lwIP的调试功能。

1.找到debug.h,添加下面这个define。

#define LWIP_DEBUG

#ifdef LWIP_DEBUG

/** print debug message only if debug message type is enabled...

 *  AND is of correct type AND is at least LWIP_DBG_LEVEL

 */

#define LWIP_DEBUGF(debug, message) do { \

                               if ( \

                                   ((debug) & LWIP_DBG_ON) && \

                                   ((debug) & LWIP_DBG_TYPES_ON) && \

                                   ((s16_t)((debug) & LWIP_DBG_MASK_LEVEL) >= LWIP_DBG_MIN_LEVEL)) { \

                                 LWIP_PLATFORM_DIAG(message); \

                                 if ((debug) & LWIP_DBG_HALT) { \

                                   while(1); \

                                 } \

                               } \

                             } while(0)

#else  /* LWIP_DEBUG */

#define LWIP_DEBUGF(debug, message) 

#endif /* LWIP_DEBUG */

#endif /* __LWIP_DEBUG_H__ */

2.在lwIPopts.h的debug options部分，按如下设置，要调试什么就把前边的“//”注释去掉即可。

//*****************************************************************************

//

// ---------- Debugging options ----------

//

//*****************************************************************************

#if 1

#define U8_F "c"

#define S8_F "c"

#define X8_F "x"

#define U16_F "u"

#define S16_F "d"

#define X16_F "x"

#define U32_F "u"

#define S32_F "d"

#define X32_F "x"

extern void UARTprintf(const char *pcString, ...);

#define LWIP_PLATFORM_DIAG(x) {UARTprintf x;}

#define LWIP_DEBUG

#endif

#define LWIP_DBG_MIN_LEVEL              LWIP_DBG_LEVEL_OFF

//#define LWIP_DBG_MIN_LEVEL              LWIP_DBG_LEVEL_WARNING

//#define LWIP_DBG_MIN_LEVEL              LWIP_DBG_LEVEL_SERIOUS

//#define LWIP_DBG_MIN_LEVEL              LWIP_DBG_LEVEL_SEVERE

//#define LWIP_DBG_TYPES_ON               LWIP_DBG_ON

#define LWIP_DBG_TYPES_ON               (LWIP_DBG_ON|LWIP_DBG_TRACE|LWIP_DBG_STATE|LWIP_DBG_FRESH)

//#define ETHARP_DEBUG                    LWIP_DBG_ON     

//#define NETIF_DEBUG                     LWIP_DBG_ON     

//#define PBUF_DEBUG                      LWIP_DBG_ON

//#define API_LIB_DEBUG                   LWIP_DBG_ON

//#define API_MSG_DEBUG                   LWIP_DBG_ON

//#define SOCKETS_DEBUG                   LWIP_DBG_ON

//#define ICMP_DEBUG                      LWIP_DBG_ON

//#define IGMP_DEBUG                      LWIP_DBG_ON

//#define INET_DEBUG                      LWIP_DBG_ON

#define IP_DEBUG                        LWIP_DBG_ON     

//#define IP_REASS_DEBUG                  LWIP_DBG_ON

//#define RAW_DEBUG                       LWIP_DBG_ON

//#define MEM_DEBUG                       LWIP_DBG_ON

//#define MEMP_DEBUG                      LWIP_DBG_ON

//#define SYS_DEBUG                       LWIP_DBG_ON

#define TCP_DEBUG                       LWIP_DBG_ON

//#define TCP_INPUT_DEBUG                 LWIP_DBG_ON

//#define TCP_FR_DEBUG                    LWIP_DBG_ON

//#define TCP_RTO_DEBUG                   LWIP_DBG_ON

//#define TCP_CWND_DEBUG                  LWIP_DBG_ON

//#define TCP_WND_DEBUG                   LWIP_DBG_ON

#define TCP_OUTPUT_DEBUG                LWIP_DBG_ON

//#define TCP_RST_DEBUG                   LWIP_DBG_ON

//#define TCP_QLEN_DEBUG                  LWIP_DBG_ON

//#define UDP_DEBUG                       LWIP_DBG_ON     

//#define TCPIP_DEBUG                     LWIP_DBG_ON

//#define PPP_DEBUG                       LWIP_DBG_ON

//#define SLIP_DEBUG                      LWIP_DBG_ON

//#define DHCP_DEBUG                      LWIP_DBG_ON     

//#define AUTOIP_DEBUG                    LWIP_DBG_ON

//#define SNMP_MSG_DEBUG                  LWIP_DBG_ON

//#define SNMP_MIB_DEBUG                  LWIP_DBG_ON

//#define DNS_DEBUG                       LWIP_DBG_ON

#endif /* __LWIPOPTS_H__ */

3.当然通过串口输出的话，在main（）函数里边还要初始化串口。

4.通过以上三步基本就可以了，如果没有，看是否在用到>LWIP_DEBUGF（）函数的C文件中，#include "lwip/debug.h"，或者是include了包含此头文件的其它头文件，如opt.h。

转载自;http://bbs.eeworld.com.cn/thread-226628-1-1.html