sl_log.h

Go to the documentation of this file.

/******************************************************************************
 * # License
 * <b>Copyright 2021 Silicon Laboratories Inc. www.silabs.com</b>
 ******************************************************************************
 * The licensor of this software is Silicon Laboratories Inc. Your use of this
 * software is governed by the terms of Silicon Labs Master Software License
 * Agreement (MSLA) available at
 * www.silabs.com/about-us/legal/master-software-license-agreement. This
 * software is distributed to you in Source Code format and is governed by the
 * sections of the MSLA applicable to Source Code.
 *
 *****************************************************************************/
 
#ifndef LOG_H
#define LOG_H
#include <stdio.h>
#include "sl_status.h"
 
#ifdef __cplusplus
extern "C" {
#endif
 
typedef enum sl_log_level {
  SL_LOG_DEBUG,
  SL_LOG_INFO,
  SL_LOG_WARNING,
  SL_LOG_ERROR,
  SL_LOG_CRITICAL
} sl_log_level_t;
 
// TODO: move array to string(hex) to utility function instead
#define sl_log_byte_arr(tag, lvl, _arr, _arr_len)                             \
  {                                                                           \
    char _tmp_log_arr[_arr_len * 2 + 1] = {0};                                \
    char *_cur_log_arr_idx              = _tmp_log_arr;                       \
    for (unsigned int _log_arr_count = 0; _log_arr_count < _arr_len;          \
         _log_arr_count++) {                                                  \
      _cur_log_arr_idx                                                        \
        += snprintf(_cur_log_arr_idx,                                         \
                    sizeof(_tmp_log_arr) - (_cur_log_arr_idx - _tmp_log_arr), \
                    "%02X",                                                   \
                    (_arr)[_log_arr_count]);                                  \
    }                                                                         \
    sl_log(tag, lvl, "%s\n", _tmp_log_arr);                                   \
  }
 
#ifdef ZWAVE_BUILD_SYSTEM
 
#include "sl_log_gecko.h"
 
#else
 
void sl_log_set_level(sl_log_level_t level);
 
sl_log_level_t sl_log_get_level();
 
void sl_log_set_tag_level(const char *tag, sl_log_level_t level);
 
void sl_log_unset_tag_level(const char *tag);
 
sl_status_t sl_log_level_from_string(const char *level, sl_log_level_t *result);
 
void sl_log_read_config();
 
void sl_log(const char *const tag,
            sl_log_level_t level,
            const char *fmtstr,
            ...);
 
#define COLOR_START "\033[32;1m"
#define COLOR_END   "\033[0m"
// Logging macros for calling sl_log with levels
#define sl_log_debug(tag, fmtstr, ...) \
  sl_log(tag, SL_LOG_DEBUG, fmtstr, ##__VA_ARGS__)
#define sl_log_info(tag, fmtstr, ...) \
  sl_log(tag, SL_LOG_INFO, fmtstr, ##__VA_ARGS__)
#define sl_log_warning(tag, fmtstr, ...) \
  sl_log(tag, SL_LOG_WARNING, fmtstr, ##__VA_ARGS__)
#define sl_log_error(tag, fmtstr, ...) \
  sl_log(tag, SL_LOG_ERROR, fmtstr, ##__VA_ARGS__)
#define sl_log_critical(tag, fmtstr, ...) \
  sl_log(tag, SL_LOG_CRITICAL, fmtstr, ##__VA_ARGS__)
 
#endif  // ZWAVE_BUILD_SYSTEM
 
#ifdef __cplusplus
}
#endif
 
#endif  //LOG_H