logging.h

Go to the documentation of this file.

#pragma once
 
#include <stdarg.h>
#include <stdint.h>
 
#ifdef __cplusplus
extern "C" {
#endif
 
 
typedef uint8_t microstrain_log_level;
#define MICROSTRAIN_LOG_LEVEL_OFF   0  
#define MICROSTRAIN_LOG_LEVEL_FATAL 1  
#define MICROSTRAIN_LOG_LEVEL_ERROR 2  
#define MICROSTRAIN_LOG_LEVEL_WARN  3  
#define MICROSTRAIN_LOG_LEVEL_INFO  4  
#define MICROSTRAIN_LOG_LEVEL_DEBUG 5  
#define MICROSTRAIN_LOG_LEVEL_TRACE 6  
 
typedef void (*microstrain_log_callback)(void* user, const microstrain_log_level level, const char* fmt, va_list args);
 
void microstrain_logging_init(const microstrain_log_callback callback, const microstrain_log_level level, void* user);
 
microstrain_log_callback microstrain_logging_callback(void);
microstrain_log_level microstrain_logging_level(void);
void* microstrain_logging_user_data(void);
 
void microstrain_logging_log_v(const microstrain_log_level level, const char* fmt, va_list args);
void microstrain_logging_log  (const microstrain_log_level level, const char* fmt, ...);
 
const char* microstrain_logging_level_name(const microstrain_log_level level);
 
#ifdef MICROSTRAIN_ENABLE_LOGGING
#define MICROSTRAIN_LOG_INIT(callback, level, user) microstrain_logging_init(callback, level, user)
#else
#define MICROSTRAIN_LOG_INIT(callback, level, user) (void)0
#endif
 
#ifdef MICROSTRAIN_ENABLE_LOGGING
#define MICROSTRAIN_LOG_LOG(level, ...) microstrain_logging_log(level, __VA_ARGS__)
#define MICROSTRAIN_LOG_LOG_V(level, fmt, args) microstrain_logging_log_v(level, fmt, args)
#else
#define MICROSTRAIN_LOG_LOG(level, ...) (void)0
#define MICROSTRAIN_LOG_LOG_V(level, fmt, args) (void)0
#endif
 
#ifndef MICROSTRAIN_LOGGING_MAX_LEVEL
#define MICROSTRAIN_LOGGING_MAX_LEVEL MICROSTRAIN_LOG_LEVEL_WARN
#endif
 
#if MICROSTRAIN_LOGGING_MAX_LEVEL >= MICROSTRAIN_LOG_LEVEL_FATAL
#define MICROSTRAIN_LOG_FATAL(...) MICROSTRAIN_LOG_LOG(MICROSTRAIN_LOG_LEVEL_FATAL, __VA_ARGS__)
#define MICROSTRAIN_LOG_FATAL_V(fmt, args) MICROSTRAIN_LOG_LOG_V(MICROSTRAIN_LOG_LEVEL_FATAL, fmt, args)
#else
#define MICROSTRAIN_LOG_FATAL(...) (void)0
#define MICROSTRAIN_LOG_FATAL_V(fmt, args) (void)0
#endif
 
#if MICROSTRAIN_LOGGING_MAX_LEVEL >= MICROSTRAIN_LOG_LEVEL_ERROR
#define MICROSTRAIN_LOG_ERROR(...) MICROSTRAIN_LOG_LOG(MICROSTRAIN_LOG_LEVEL_ERROR, __VA_ARGS__)
#define MICROSTRAIN_LOG_ERROR_V(fmt, args) MICROSTRAIN_LOG_LOG_V(MICROSTRAIN_LOG_LEVEL_ERROR, fmt, args)
#else
#define MICROSTRAIN_LOG_ERROR(...) (void)0
#define MICROSTRAIN_LOG_ERROR_V(fmt, args) (void)0
#endif
 
#if MICROSTRAIN_LOGGING_MAX_LEVEL >= MICROSTRAIN_LOG_LEVEL_WARN
#define MICROSTRAIN_LOG_WARN(...) MICROSTRAIN_LOG_LOG(MICROSTRAIN_LOG_LEVEL_WARN, __VA_ARGS__)
#define MICROSTRAIN_LOG_WARN_V(fmt, args) MICROSTRAIN_LOG_LOG_V(MICROSTRAIN_LOG_LEVEL_WARN, fmt, args)
#else
#define MICROSTRAIN_LOG_WARN(...) (void)0
#define MICROSTRAIN_LOG_WARN_V(fmt, args) (void)0
#endif
 
#if MICROSTRAIN_LOGGING_MAX_LEVEL >= MICROSTRAIN_LOG_LEVEL_INFO
#define MICROSTRAIN_LOG_INFO(...) MICROSTRAIN_LOG_LOG(MICROSTRAIN_LOG_LEVEL_INFO, __VA_ARGS__)
#define MICROSTRAIN_LOG_INFO_V(fmt, args) MICROSTRAIN_LOG_LOG_V(MICROSTRAIN_LOG_LEVEL_INFO, fmt, args)
#else
#define MICROSTRAIN_LOG_INFO(...) (void)0
#define MICROSTRAIN_LOG_INFO_V(fmt, args) (void)0
#endif
 
#if MICROSTRAIN_LOGGING_MAX_LEVEL >= MICROSTRAIN_LOG_LEVEL_DEBUG
#define MICROSTRAIN_LOG_DEBUG(...) MICROSTRAIN_LOG_LOG(MICROSTRAIN_LOG_LEVEL_DEBUG, __VA_ARGS__)
#define MICROSTRAIN_LOG_DEBUG_V(fmt, args) MICROSTRAIN_LOG_LOG_V(MICROSTRAIN_LOG_LEVEL_DEBUG, fmt, args)
#else
#define MICROSTRAIN_LOG_DEBUG(...) (void)0
#define MICROSTRAIN_LOG_DEBUG_V(fmt, args) (void)0
#endif
 
#if MICROSTRAIN_LOGGING_MAX_LEVEL >= MICROSTRAIN_LOG_LEVEL_TRACE
#define MICROSTRAIN_LOG_TRACE(...) MICROSTRAIN_LOG_LOG(MICROSTRAIN_LOG_LEVEL_TRACE, __VA_ARGS__)
#define MICROSTRAIN_LOG_TRACE_V(fmt, args) MICROSTRAIN_LOG_LOG_V(MICROSTRAIN_LOG_LEVEL_TRACE, fmt, args)
#else
#define MICROSTRAIN_LOG_TRACE(...) (void)0
#define MICROSTRAIN_LOG_TRACE_V(fmt, args) (void)0
#endif
 
 
#define MICROSTRAIN_LOG_ERROR_WITH_ERRNO(msg) MICROSTRAIN_LOG_ERROR(msg ": %d %s\n", errno, strerror(errno))
 
#define MICROSTRAIN_LOG_ERROR_WITH_ERRNO_EX(msg, ...) MICROSTRAIN_LOG_ERROR(msg ": %d %s\n", __VA_ARGS__, errno, strerror(errno))
 
#define MICROSTRAIN_LOG_BYTES(level, buffer, length, ...) { \
  MICROSTRAIN_LOG_LOG(level, __VA_ARGS__);                  \
  for(size_t i=0; i<length; i++) {                          \
    MICROSTRAIN_LOG_LOG(level, " %02X", buffer[i]);                \
  }                                                         \
  MICROSTRAIN_LOG_LOG(level, "\n");                                \
}
 
 
#ifdef __cplusplus
} // extern "C"
#endif