#ifndef __GLUE_DEBUG_H #define __GLUE_DEBUG_H ///////////////////////////////////////////////////////////////////////////// // user-definable // this is needed separately from lwipopts.h // because it is shared by both sides of glue #define UDEBUG 0 // 0 or 1 (glue debug) #define UDUMP 0 // 0 or 1 (glue / dump packet) #define UDEBUGINDEX 0 // 0 or 1 (show debug line number) #define UDEBUGSTORE 0 // 0 or 1 (store debug into buffer until doprint_allow=1=serial-available) #define ULWIPDEBUG 0 // 0 or 1 (trigger lwip debug) #define ULWIPASSERT 0 // 0 or 1 (trigger lwip self-check, 0 saves flash) #define STRING_IN_FLASH 0 // *print("fmt is stored in flash") #define ROTBUFLEN_BIT 11 // (UDEBUGSTORE=1) doprint()'s buffer: 11=2048B #if ULWIPDEBUG //#define LWIP_DBG_TYPES_ON (LWIP_DBG_ON|LWIP_DBG_TRACE|LWIP_DBG_STATE|LWIP_DBG_FRESH|LWIP_DBG_HALT) //#define LWIP_DBG_TYPES_ON (LWIP_DBG_ON|LWIP_DBG_TRACE|LWIP_DBG_STATE|LWIP_DBG_FRESH) #define LWIP_DBG_TYPES_ON (LWIP_DBG_ON) #endif ///////////////////////////////////////////////////////////////////////////// #if UDEBUG && UDEBUGSTORE #warning use 'doprint_allow=1' right after Serial is enabled extern int doprint_allow; #endif // print definitions: // uprint(): always used by glue, defined as doprint() in debug mode or nothing() // os_printf(): can be redefined as doprint() // doprint(): always print, can be os_printf_plus() or defined in doprint.c (buffered) // in buffered mode: doprint_allow=1 is needed after Serial.begin #if STRING_IN_FLASH && !defined(USE_OPTIMIZE_PRINTF) #define USE_OPTIMIZE_PRINTF // at least used in arduino/esp8266 #endif // os_printf_plus() missing in osapi.h (fixed in arduino's sdk-2.1): extern int os_printf_plus (const char * format, ...) __attribute__ ((format (printf, 1, 2))); #include // os_printf* definitions + ICACHE_RODATA_ATTR #if UDEBUG && (UDEBUGINDEX || UDEBUGSTORE) // doprint() is used #undef os_printf #define os_printf(x...) do { doprint(x); } while (0) #if STRING_IN_FLASH #define doprint(fmt, ...) \ do { \ static const char flash_str[] ICACHE_RODATA_ATTR STORE_ATTR = fmt; \ doprint_minus(flash_str, ##__VA_ARGS__); \ } while(0) #else // !STRING_IN_FLASH #define doprint(fmt, ...) doprint_minus(fmt, ##__VA_ARGS__) #endif // !STRING_IN_FLASH int doprint_minus (const char* format, ...) __attribute__ ((format (printf, 1, 2))); // format in flash #else // !( UDEBUG && (UDEBUGINDEX || UDEBUGSTORE) ) #define doprint(x...) do { os_printf(x); } while (0) #endif // !( UDEBUG && (UDEBUGINDEX || UDEBUGSTORE) ) #if UDEBUG #define uprint(x...) do { doprint(x); } while (0) #else #define uprint(x...) do { (void)0; } while (0) #endif #define uerror(x...) do { doprint(x); } while (0) #define uassert(assertion...) do { if ((assertion) == 0) { os_printf_plus("assert fail: " #assertion " @%s:%d\n", __FILE__, __LINE__); uhalt(); } } while (0) #define uhalt() do { *((int*)0) = 0; /* this triggers gdb */ } while (0) #define nl() do { uprint("\n"); } while (0) #endif