squeezelite-esp32/components/tools/tools.h

/* 
 *  Tools 
 *
 *      Philippe G. 2019, philippe_44@outlook.com
 *
 *  This software is released under the MIT License.
 *  https://opensource.org/licenses/MIT
 *
 */
 
#pragma once
#include "freertos/FreeRTOS.h"
#include "freertos/task.h"
#include "cJSON.h"

#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)

#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);
void        dump_json_content(const char* prefix, cJSON* json, int level);

#ifndef gettime_ms
// body is provided somewhere else...
uint32_t _gettime_ms_(void);
#define gettime_ms _gettime_ms_
#endif

typedef void (*http_download_cb_t)(uint8_t* data, size_t len, void *context);
void		http_download(char *url, size_t max, http_download_cb_t callback, void *context);

/* Use these to dynamically create tasks whose stack is on EXTRAM. Be aware that it 
 * requires configNUM_THREAD_LOCAL_STORAGE_POINTERS to bet set to 2 at least (index 0
 * is used by pthread and this uses index 1, obviously
 */
BaseType_t xTaskCreateEXTRAM( TaskFunction_t pvTaskCode,
                            const char * const pcName,
                            configSTACK_DEPTH_TYPE usStackDepth,
                            void *pvParameters,
                            UBaseType_t uxPriority,
                            TaskHandle_t *pxCreatedTask);
void vTaskDeleteEXTRAM(TaskHandle_t xTask);                            

extern const char unknown_string_placeholder[];

#ifdef __cplusplus
}
#endif