big merge

components/tools/tools.h

@@ -10,4 +10,59 @@
  
 #pragma once
 
-void utf8_decode(char *src);
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+#ifndef QUOTE
+#define QUOTE(name) #name
+#endif
+
+#ifndef STR
+#define STR(macro)  QUOTE(macro)
+#endif
+
+#ifndef STR_OR_ALT
+#define STR_OR_ALT(str,alt) (str?str:alt)
+#endif
+
+#ifndef STR_OR_BLANK
+#define STR_OR_BLANK(p) p == NULL ? "" : p
+#endif
+
+#define ESP_LOG_DEBUG_EVENT(tag,e) ESP_LOGD(tag,"evt: " e)
+
+#ifdef ENABLE_MEMTRACE
+#define MEMTRACE_PRINT_DELTA() memtrace_print_delta(NULL,TAG,__FUNCTION__);
+#define MEMTRACE_PRINT_DELTA_MESSAGE(x) memtrace_print_delta(x,TAG,__FUNCTION__);
+#else
+#define MEMTRACE_PRINT_DELTA()
+#define MEMTRACE_PRINT_DELTA_MESSAGE(x) ESP_LOGD(TAG,"%s",x);
+#endif
+
+#ifndef FREE_AND_NULL
+#define FREE_AND_NULL(x) if(x) { free(x); x=NULL; }
+#endif
+
+#ifndef CASE_TO_STR
+#define CASE_TO_STR(x) case x: return STR(x); break;
+#endif
+
+#define ENUM_TO_STRING(g) 	\
+    case g:    				\
+        return STR(g);    	\
+        break;
+
+void 		utf8_decode(char *src);
+void 		url_decode(char *url);
+void* 		malloc_init_external(size_t sz);
+void* 		clone_obj_psram(void * source, size_t source_sz);
+char* 		strdup_psram(const char * source);
+const char* str_or_unknown(const char * str);
+const char* str_or_null(const char * str);
+
+extern const char unknown_string_placeholder[];
+
+#ifdef __cplusplus
+}
+#endif