blackbeard420/esp-idf
1
0
Fork 0
mirror of https://github.com/espressif/esp-idf synced 2025-03-10 09:39:10 -04:00
Code Issues Projects Releases Wiki Activity
esp-idf/components/log/include/esp_log.h

282 lines
20 KiB
C
Raw Normal View History

log: update copyright year
2021-04-12 08:02:59 +02:00
/*
feat(log): Refactoring buffer log APIs
2024-03-11 15:44:33 +02:00
* SPDX-FileCopyrightText: 2015-2024 Espressif Systems (Shanghai) CO LTD
log: update copyright year
2021-04-12 08:02:59 +02:00
*
* SPDX-License-Identifier: Apache-2.0
*/
components/log: add API header for logging library TW6703
2016-09-08 20:02:26 +08:00
feat(log): Refactoring tag level check APIs
2024-02-28 20:33:12 +02:00
#pragma once
components/log: add API header for logging library TW6703
2016-09-08 20:02:26 +08:00
#include <stdint.h>
components/log: add implementation, update a few components to use it This also removes logging implementation from bootloader and replaces it with the one provided by the log component. Some occurrences of printf and ets_printf have been changed to ESP_LOGx APIs.
2016-09-15 00:53:33 +08:00
#include <stdarg.h>
log: fix -Wformat issue when uint32_t == unsigned long
2022-01-31 20:09:06 +01:00
#include <inttypes.h>
components/log: add implementation, update a few components to use it This also removes logging implementation from bootloader and replaces it with the one provided by the log component. Some occurrences of printf and ets_printf have been changed to ESP_LOGx APIs.
2016-09-15 00:53:33 +08:00
#include "sdkconfig.h"
[log]: Normal log works on Linux now * also removed strlcpy dependency from log * added Kconfig option for linux target Closes IDF-3245
2021-05-13 17:04:31 +08:00
#include "esp_rom_sys.h"
feat(log): Use esp_log func in all LOG macros
2024-05-17 22:43:41 +03:00
#include "esp_log_config.h"
feat(log): Refactoring buffer log APIs
2024-03-11 15:44:33 +02:00
#include "esp_log_level.h"
feat(log): Refactoring color macros
2024-05-02 15:09:52 +03:00
#include "esp_log_color.h"
feat(log): Refactoring buffer log APIs
2024-03-11 15:44:33 +02:00
#include "esp_log_buffer.h"
feat(log): Refactoring timestamp APIs (move only)
2024-05-02 12:24:23 +03:00
#include "esp_log_timestamp.h"
feat(log): Move esp_log_write APIs out of esp_log.h
2024-05-17 19:15:23 +03:00
#include "esp_log_write.h"
feat(log): Move LOG_FORMAT macros out of esp_log.h
2024-05-17 22:52:19 +03:00
#include "esp_log_format.h"
Refactor existing bootloader common functionality into bootloader_support component
2016-11-02 10:41:58 +11:00
components/log: add API header for logging library TW6703
2016-09-08 20:02:26 +08:00
#ifdef __cplusplus
extern "C" {
#endif
feat(log): Use esp_log func in all LOG macros
2024-05-17 22:43:41 +03:00
/**
* @brief Logs a formatted message using the provided log message configs and a variable argument list.
*
* @param config Configuration and level of the log message.
* @param tag The tag string used to indicate the component from which to log.
* It is also used to check whether logging is enabled for that tag (depends on CONFIG_LOG_TAG_LEVEL_IMPL).
* If NULL then the tag is not printed.
* @param format The format string for the log message.
* @param ... Optional arguments to be formatted according to the format string.
*/
void esp_log(esp_log_config_t config, const char* tag, const char* format, ...);
/**
* @brief Logs a formatted message using the provided log message configs and a variable argument list.
*
* @param config Configuration and level of the log message.
* @param tag The tag string used to indicate the component from which to log.
* It is also used to check whether logging is enabled for that tag (depends on CONFIG_LOG_TAG_LEVEL_IMPL).
* If NULL then the tag is not printed.
* @param format The format string for the log message.
* @param args List of arguments.
*/
void esp_log_va(esp_log_config_t config, const char *tag, const char *format, va_list args);
docs: update programming guide for esp32s3 chip independent system chapters This commit updates the chip independent system chapters of the programming guide for esp32s3. Signed-off-by: Sudeep Mohanty <sudeep.mohanty@espressif.com>
2021-11-17 09:36:01 +05:30
/// macro to output logs in startup code, before heap allocator and syscalls have been initialized.
/// Log at ``ESP_LOG_ERROR`` level. @see ``printf``,``ESP_LOGE``,``ESP_DRAM_LOGE``
[cxx]: No ##__VA_ARGS__ in public header files * ##__VA_ARGS__ is replaced by __VA_OPT__(,) and __VA_ARGS if C++20 is used. * Affected header files are: esp_log.h, portmacro.h and esp_check.h * Closes https://github.com/espressif/esp-idf/pull/6692
2021-05-21 11:09:20 +08:00
/**
docs: added new C++ language standard
2023-04-12 09:41:44 +08:00
* In the future, we want to become compatible with clang.
[cxx]: No ##__VA_ARGS__ in public header files * ##__VA_ARGS__ is replaced by __VA_OPT__(,) and __VA_ARGS if C++20 is used. * Affected header files are: esp_log.h, portmacro.h and esp_check.h * Closes https://github.com/espressif/esp-idf/pull/6692
2021-05-21 11:09:20 +08:00
* Hence, we provide two versions of the following macros which are using variadic arguments.
feat(log): Use esp_log func in all LOG macros
2024-05-17 22:43:41 +03:00
* The first one is using the GNU extension ``##__VA_ARGS__``. The second one is using the C++20 feature ``__VA_OPT__(,)``.
[cxx]: No ##__VA_ARGS__ in public header files * ##__VA_ARGS__ is replaced by __VA_OPT__(,) and __VA_ARGS if C++20 is used. * Affected header files are: esp_log.h, portmacro.h and esp_check.h * Closes https://github.com/espressif/esp-idf/pull/6692
2021-05-21 11:09:20 +08:00
* This allows users to compile their code with standard C++20 enabled instead of the GNU extension.
feat(log): Use esp_log func in all LOG macros
2024-05-17 22:43:41 +03:00
* Below C++20, we haven't found any good alternative to using ``##__VA_ARGS__``.
[cxx]: No ##__VA_ARGS__ in public header files * ##__VA_ARGS__ is replaced by __VA_OPT__(,) and __VA_ARGS if C++20 is used. * Affected header files are: esp_log.h, portmacro.h and esp_check.h * Closes https://github.com/espressif/esp-idf/pull/6692
2021-05-21 11:09:20 +08:00
*/
#if defined(__cplusplus) && (__cplusplus > 201703L)
feat(log): Use esp_log func in all LOG macros
2024-05-17 22:43:41 +03:00
/** @cond */
#define ESP_EARLY_LOGE(tag, format, ...) do { ESP_LOG_EARLY_IMPL(tag, format, ESP_LOG_ERROR, E __VA_OPT__(,) __VA_ARGS__); } while(0)
#define ESP_EARLY_LOGW(tag, format, ...) do { ESP_LOG_EARLY_IMPL(tag, format, ESP_LOG_WARN, W __VA_OPT__(,) __VA_ARGS__); } while(0)
#define ESP_EARLY_LOGI(tag, format, ...) do { ESP_LOG_EARLY_IMPL(tag, format, ESP_LOG_INFO, I __VA_OPT__(,) __VA_ARGS__); } while(0)
#define ESP_EARLY_LOGD(tag, format, ...) do { ESP_LOG_EARLY_IMPL(tag, format, ESP_LOG_DEBUG, D __VA_OPT__(,) __VA_ARGS__); } while(0)
#define ESP_EARLY_LOGV(tag, format, ...) do { ESP_LOG_EARLY_IMPL(tag, format, ESP_LOG_VERBOSE, V __VA_OPT__(,) __VA_ARGS__); } while(0)
log: Make ESP_LOGx macros into single statements Requires a semicolon after any use (previously this was optional due to trailing } after expansion) Closes https://github.com/espressif/esp-idf/issues/1757
2018-04-20 13:41:11 +10:00
feat(log): Use esp_log func in all LOG macros
2024-05-17 22:43:41 +03:00
#if ESP_LOG_VERSION == 1 && NON_OS_BUILD
#define ESP_LOGE(tag, format, ...) do { ESP_EARLY_LOGE(tag, format __VA_OPT__(,) __VA_ARGS__); } while(0)
#define ESP_LOGW(tag, format, ...) do { ESP_EARLY_LOGW(tag, format __VA_OPT__(,) __VA_ARGS__); } while(0)
#define ESP_LOGI(tag, format, ...) do { ESP_EARLY_LOGI(tag, format __VA_OPT__(,) __VA_ARGS__); } while(0)
#define ESP_LOGD(tag, format, ...) do { ESP_EARLY_LOGD(tag, format __VA_OPT__(,) __VA_ARGS__); } while(0)
#define ESP_LOGV(tag, format, ...) do { ESP_EARLY_LOGV(tag, format __VA_OPT__(,) __VA_ARGS__); } while(0)
#else
#define ESP_LOGE(tag, format, ...) do { ESP_LOG_LEVEL_LOCAL(ESP_LOG_ERROR, tag, format __VA_OPT__(,) __VA_ARGS__); } while(0)
#define ESP_LOGW(tag, format, ...) do { ESP_LOG_LEVEL_LOCAL(ESP_LOG_WARN, tag, format __VA_OPT__(,) __VA_ARGS__); } while(0)
#define ESP_LOGI(tag, format, ...) do { ESP_LOG_LEVEL_LOCAL(ESP_LOG_INFO, tag, format __VA_OPT__(,) __VA_ARGS__); } while(0)
#define ESP_LOGD(tag, format, ...) do { ESP_LOG_LEVEL_LOCAL(ESP_LOG_DEBUG, tag, format __VA_OPT__(,) __VA_ARGS__); } while(0)
#define ESP_LOGV(tag, format, ...) do { ESP_LOG_LEVEL_LOCAL(ESP_LOG_VERBOSE, tag, format __VA_OPT__(,) __VA_ARGS__); } while(0)
#endif
components/log: regroup macros for better readability
2016-09-19 08:53:09 +08:00
feat(log): Use esp_log func in all LOG macros
2024-05-17 22:43:41 +03:00
#define ESP_DRAM_LOGE(tag, format, ...) do { ESP_DRAM_LOG_IMPL(tag, format, ESP_LOG_ERROR, E __VA_OPT__(,) __VA_ARGS__); } while(0)
#define ESP_DRAM_LOGW(tag, format, ...) do { ESP_DRAM_LOG_IMPL(tag, format, ESP_LOG_WARN, W __VA_OPT__(,) __VA_ARGS__); } while(0)
#define ESP_DRAM_LOGI(tag, format, ...) do { ESP_DRAM_LOG_IMPL(tag, format, ESP_LOG_INFO, I __VA_OPT__(,) __VA_ARGS__); } while(0)
#define ESP_DRAM_LOGD(tag, format, ...) do { ESP_DRAM_LOG_IMPL(tag, format, ESP_LOG_DEBUG, D __VA_OPT__(,) __VA_ARGS__); } while(0)
#define ESP_DRAM_LOGV(tag, format, ...) do { ESP_DRAM_LOG_IMPL(tag, format, ESP_LOG_VERBOSE, V __VA_OPT__(,) __VA_ARGS__); } while(0)
/** @endcond */
[cxx]: No ##__VA_ARGS__ in public header files * ##__VA_ARGS__ is replaced by __VA_OPT__(,) and __VA_ARGS if C++20 is used. * Affected header files are: esp_log.h, portmacro.h and esp_check.h * Closes https://github.com/espressif/esp-idf/pull/6692
2021-05-21 11:09:20 +08:00
#else // !(defined(__cplusplus) && (__cplusplus > 201703L))
feat(log): Use esp_log func in all LOG macros
2024-05-17 22:43:41 +03:00
/**
* @brief Early log macros to output logs in startup code, before heap allocator and syscalls have been initialized.
* The log level can be changed per-tag using ``esp_log_level_set(TAG, level)``.
*/
/// macro to output logs in startup code at ``ESP_LOG_ERROR`` level.
#define ESP_EARLY_LOGE(tag, format, ...) do { ESP_LOG_EARLY_IMPL(tag, format, ESP_LOG_ERROR, E, ##__VA_ARGS__); } while(0)
/// macro to output logs in startup code at ``ESP_LOG_WARN`` level.
#define ESP_EARLY_LOGW(tag, format, ...) do { ESP_LOG_EARLY_IMPL(tag, format, ESP_LOG_WARN, W, ##__VA_ARGS__); } while(0)
/// macro to output logs in startup code at ``ESP_LOG_INFO`` level.
#define ESP_EARLY_LOGI(tag, format, ...) do { ESP_LOG_EARLY_IMPL(tag, format, ESP_LOG_INFO, I, ##__VA_ARGS__); } while(0)
/// macro to output logs in startup code at ``ESP_LOG_DEBUG`` level.
#define ESP_EARLY_LOGD(tag, format, ...) do { ESP_LOG_EARLY_IMPL(tag, format, ESP_LOG_DEBUG, D, ##__VA_ARGS__); } while(0)
/// macro to output logs in startup code at ``ESP_LOG_VERBOSE`` level.
#define ESP_EARLY_LOGV(tag, format, ...) do { ESP_LOG_EARLY_IMPL(tag, format, ESP_LOG_VERBOSE, V, ##__VA_ARGS__); } while(0)
/**
* @brief Normal logging macros to output logs.
* The log level can be changed per-tag using ``esp_log_level_set(TAG, level)``.
*/
#if ESP_LOG_VERSION == 1 && NON_OS_BUILD
/// macro to output logs at ``ESP_LOG_ERROR`` level.
#define ESP_LOGE(tag, format, ...) do { ESP_EARLY_LOGE(tag, format, ##__VA_ARGS__); } while(0)
/// macro to output logs at ``ESP_LOG_WARN`` level.
#define ESP_LOGW(tag, format, ...) do { ESP_EARLY_LOGW(tag, format, ##__VA_ARGS__); } while(0)
/// macro to output logs at ``ESP_LOG_INFO`` level.
#define ESP_LOGI(tag, format, ...) do { ESP_EARLY_LOGI(tag, format, ##__VA_ARGS__); } while(0)
/// macro to output logs at ``ESP_LOG_DEBUG`` level.
#define ESP_LOGD(tag, format, ...) do { ESP_EARLY_LOGD(tag, format, ##__VA_ARGS__); } while(0)
/// macro to output logs at ``ESP_LOG_VERBOSE`` level.
#define ESP_LOGV(tag, format, ...) do { ESP_EARLY_LOGV(tag, format, ##__VA_ARGS__); } while(0)
components/log: add implementation, update a few components to use it This also removes logging implementation from bootloader and replaces it with the one provided by the log component. Some occurrences of printf and ets_printf have been changed to ESP_LOGx APIs.
2016-09-15 00:53:33 +08:00
#else
feat(log): Use esp_log func in all LOG macros
2024-05-17 22:43:41 +03:00
/// macro to output logs at ``ESP_LOG_ERROR`` level.
#define ESP_LOGE(tag, format, ...) do { ESP_LOG_LEVEL_LOCAL(ESP_LOG_ERROR, tag, format, ##__VA_ARGS__); } while(0)
/// macro to output logs at ``ESP_LOG_WARN`` level.
#define ESP_LOGW(tag, format, ...) do { ESP_LOG_LEVEL_LOCAL(ESP_LOG_WARN, tag, format, ##__VA_ARGS__); } while(0)
/// macro to output logs at ``ESP_LOG_INFO`` level.
#define ESP_LOGI(tag, format, ...) do { ESP_LOG_LEVEL_LOCAL(ESP_LOG_INFO, tag, format, ##__VA_ARGS__); } while(0)
/// macro to output logs at ``ESP_LOG_DEBUG`` level.
#define ESP_LOGD(tag, format, ...) do { ESP_LOG_LEVEL_LOCAL(ESP_LOG_DEBUG, tag, format, ##__VA_ARGS__); } while(0)
/// macro to output logs at ``ESP_LOG_VERBOSE`` level.
#define ESP_LOGV(tag, format, ...) do { ESP_LOG_LEVEL_LOCAL(ESP_LOG_VERBOSE, tag, format, ##__VA_ARGS__); } while(0)
#endif
[cxx]: No ##__VA_ARGS__ in public header files * ##__VA_ARGS__ is replaced by __VA_OPT__(,) and __VA_ARGS if C++20 is used. * Affected header files are: esp_log.h, portmacro.h and esp_check.h * Closes https://github.com/espressif/esp-idf/pull/6692
2021-05-21 11:09:20 +08:00
doc(log): document the log macros.
2017-08-24 16:53:16 +08:00
/**
feat(log): Use esp_log func in all LOG macros
2024-05-17 22:43:41 +03:00
* @brief Macros to output logs when the cache is disabled.
* Unlike normal logging macros, it's possible to use this macro when interrupts are disabled or inside an ISR.
* Placing log strings in DRAM reduces available DRAM, so only use when absolutely essential.
doc(log): document the log macros.
2017-08-24 16:53:16 +08:00
*
feat(log): Use esp_log func in all LOG macros
2024-05-17 22:43:41 +03:00
* Usage: `ESP_DRAM_LOGE(DRAM_STR("my_tag"), "format", ...), or `ESP_DRAM_LOGE(TAG, "format", ...)`,
* where TAG is a char* that points to a str in the DRAM.
doc(log): document the log macros.
2017-08-24 16:53:16 +08:00
*/
feat(log): Use esp_log func in all LOG macros
2024-05-17 22:43:41 +03:00
/// macro to output logs when the cache is disabled at ``ESP_LOG_ERROR`` level.
#define ESP_DRAM_LOGE(tag, format, ...) do { ESP_DRAM_LOG_IMPL(tag, format, ESP_LOG_ERROR, E, ##__VA_ARGS__); } while(0)
/// macro to output logs when the cache is disabled at ``ESP_LOG_WARN`` level.
#define ESP_DRAM_LOGW(tag, format, ...) do { ESP_DRAM_LOG_IMPL(tag, format, ESP_LOG_WARN, W, ##__VA_ARGS__); } while(0)
/// macro to output logs when the cache is disabled at ``ESP_LOG_INFO`` level.
#define ESP_DRAM_LOGI(tag, format, ...) do { ESP_DRAM_LOG_IMPL(tag, format, ESP_LOG_INFO, I, ##__VA_ARGS__); } while(0)
/// macro to output logs when the cache is disabled at ``ESP_LOG_DEBUG`` level.
#define ESP_DRAM_LOGD(tag, format, ...) do { ESP_DRAM_LOG_IMPL(tag, format, ESP_LOG_DEBUG, D, ##__VA_ARGS__); } while(0)
/// macro to output logs when the cache is disabled at ``ESP_LOG_VERBOSE`` level.
#define ESP_DRAM_LOGV(tag, format, ...) do { ESP_DRAM_LOG_IMPL(tag, format, ESP_LOG_VERBOSE, V, ##__VA_ARGS__); } while(0)
#endif // !(defined(__cplusplus) && (__cplusplus > 201703L))
/// runtime macro to output logs at a specified configs. Also check the level with ``LOG_LOCAL_LEVEL``.
#if ESP_LOG_VERSION == 2
#if defined(__cplusplus) && (__cplusplus > 201703L)
#define ESP_LOG_LEVEL_LOCAL(configs, tag, format, ...) do { if (ESP_LOG_ENABLED(configs)) { ESP_LOG_LEVEL(configs, tag, format __VA_OPT__(,) __VA_ARGS__); } } while(0)
#else // !(defined(__cplusplus) && (__cplusplus > 201703L))
#define ESP_LOG_LEVEL_LOCAL(configs, tag, format, ...) do { if (ESP_LOG_ENABLED(configs)) { ESP_LOG_LEVEL(configs, tag, format, ##__VA_ARGS__); } } while(0)
#endif // !(defined(__cplusplus) && (__cplusplus > 201703L))
#else // ESP_LOG_VERSION == 1
[cxx]: No ##__VA_ARGS__ in public header files * ##__VA_ARGS__ is replaced by __VA_OPT__(,) and __VA_ARGS if C++20 is used. * Affected header files are: esp_log.h, portmacro.h and esp_check.h * Closes https://github.com/espressif/esp-idf/pull/6692
2021-05-21 11:09:20 +08:00
#if defined(__cplusplus) && (__cplusplus > 201703L)
feat(log): Use esp_log func in all LOG macros
2024-05-17 22:43:41 +03:00
#define ESP_LOG_LEVEL_LOCAL(configs, tag, format, ...) do { if (_ESP_LOG_ENABLED(configs)) { ESP_LOG_LEVEL(configs, tag, format __VA_OPT__(,) __VA_ARGS__); } } while(0)
[cxx]: No ##__VA_ARGS__ in public header files * ##__VA_ARGS__ is replaced by __VA_OPT__(,) and __VA_ARGS if C++20 is used. * Affected header files are: esp_log.h, portmacro.h and esp_check.h * Closes https://github.com/espressif/esp-idf/pull/6692
2021-05-21 11:09:20 +08:00
#else // !(defined(__cplusplus) && (__cplusplus > 201703L))
feat(log): Use esp_log func in all LOG macros
2024-05-17 22:43:41 +03:00
#define ESP_LOG_LEVEL_LOCAL(configs, tag, format, ...) do { if (_ESP_LOG_ENABLED(configs)) { ESP_LOG_LEVEL(configs, tag, format, ##__VA_ARGS__); } } while(0)
[cxx]: No ##__VA_ARGS__ in public header files * ##__VA_ARGS__ is replaced by __VA_OPT__(,) and __VA_ARGS if C++20 is used. * Affected header files are: esp_log.h, portmacro.h and esp_check.h * Closes https://github.com/espressif/esp-idf/pull/6692
2021-05-21 11:09:20 +08:00
#endif // !(defined(__cplusplus) && (__cplusplus > 201703L))
feat(log): Use esp_log func in all LOG macros
2024-05-17 22:43:41 +03:00
#endif // ESP_LOG_VERSION == 1
components/log: add API header for logging library TW6703
2016-09-08 20:02:26 +08:00
feat(log): Use esp_log func in all LOG macros
2024-05-17 22:43:41 +03:00
/** runtime macro to output logs at a specified level and with ESP_LOG_CONFIGS_DEFAULT.
build and link hello-world for esp32s2beta
2019-06-06 10:57:29 +08:00
*
feat(log): Use esp_log func in all LOG macros
2024-05-17 22:43:41 +03:00
* @param configs it includes level and other log configurations.
feat(log): add new function to log buffer with level and hex dump.
2017-08-21 22:03:53 +08:00
* @param tag tag of the log, which can be used to change the log level by ``esp_log_level_set`` at runtime.
docs: update programming guide for esp32s3 chip independent system chapters This commit updates the chip independent system chapters of the programming guide for esp32s3. Signed-off-by: Sudeep Mohanty <sudeep.mohanty@espressif.com>
2021-11-17 09:36:01 +05:30
* @param format format of the output log. See ``printf``
* @param ... variables to be replaced into the log. See ``printf``
feat(log): add new function to log buffer with level and hex dump.
2017-08-21 22:03:53 +08:00
*
* @see ``printf``
*/
feat(log): Use esp_log func in all LOG macros
2024-05-17 22:43:41 +03:00
#if ESP_LOG_VERSION == 2
#if defined(__cplusplus) && (__cplusplus > 201703L)
#define ESP_LOG_LEVEL(configs, tag, format, ...) do { \
esp_log(ESP_LOG_CONFIG_INIT(configs | ESP_LOG_CONFIGS_DEFAULT), tag, format __VA_OPT__(,) __VA_ARGS__); \
} while(0)
#else // !(defined(__cplusplus) && (__cplusplus > 201703L))
#define ESP_LOG_LEVEL(configs, tag, format, ...) do { \
esp_log(ESP_LOG_CONFIG_INIT(configs | ESP_LOG_CONFIGS_DEFAULT), tag, format, ##__VA_ARGS__); \
} while(0)
#endif // !(defined(__cplusplus) && (__cplusplus > 201703L))
#else // ESP_LOG_VERSION == 1
[cxx]: No ##__VA_ARGS__ in public header files * ##__VA_ARGS__ is replaced by __VA_OPT__(,) and __VA_ARGS if C++20 is used. * Affected header files are: esp_log.h, portmacro.h and esp_check.h * Closes https://github.com/espressif/esp-idf/pull/6692
2021-05-21 11:09:20 +08:00
#if defined(__cplusplus) && (__cplusplus > 201703L)
#if CONFIG_LOG_TIMESTAMP_SOURCE_RTOS
feat(log): Use esp_log func in all LOG macros
2024-05-17 22:43:41 +03:00
#define ESP_LOG_LEVEL(configs, tag, format, ...) do { \
if (ESP_LOG_GET_LEVEL(configs)==ESP_LOG_ERROR) { esp_log(ESP_LOG_CONFIG_INIT(ESP_LOG_ERROR), tag, LOG_FORMAT(E, format), esp_log_timestamp(), tag __VA_OPT__(,) __VA_ARGS__); } \
else if (ESP_LOG_GET_LEVEL(configs)==ESP_LOG_WARN) { esp_log(ESP_LOG_CONFIG_INIT(ESP_LOG_WARN), tag, LOG_FORMAT(W, format), esp_log_timestamp(), tag __VA_OPT__(,) __VA_ARGS__); } \
else if (ESP_LOG_GET_LEVEL(configs)==ESP_LOG_DEBUG) { esp_log(ESP_LOG_CONFIG_INIT(ESP_LOG_DEBUG), tag, LOG_FORMAT(D, format), esp_log_timestamp(), tag __VA_OPT__(,) __VA_ARGS__); } \
else if (ESP_LOG_GET_LEVEL(configs)==ESP_LOG_VERBOSE) { esp_log(ESP_LOG_CONFIG_INIT(ESP_LOG_VERBOSE), tag, LOG_FORMAT(V, format), esp_log_timestamp(), tag __VA_OPT__(,) __VA_ARGS__); } \
else { esp_log(ESP_LOG_CONFIG_INIT(ESP_LOG_INFO), tag, LOG_FORMAT(I, format), esp_log_timestamp(), tag __VA_OPT__(,) __VA_ARGS__); } \
[cxx]: No ##__VA_ARGS__ in public header files * ##__VA_ARGS__ is replaced by __VA_OPT__(,) and __VA_ARGS if C++20 is used. * Affected header files are: esp_log.h, portmacro.h and esp_check.h * Closes https://github.com/espressif/esp-idf/pull/6692
2021-05-21 11:09:20 +08:00
} while(0)
#elif CONFIG_LOG_TIMESTAMP_SOURCE_SYSTEM
feat(log): Use esp_log func in all LOG macros
2024-05-17 22:43:41 +03:00
#define ESP_LOG_LEVEL(configs, tag, format, ...) do { \
if (ESP_LOG_GET_LEVEL(configs)==ESP_LOG_ERROR) { esp_log(ESP_LOG_CONFIG_INIT(ESP_LOG_ERROR), tag, LOG_SYSTEM_TIME_FORMAT(E, format), esp_log_system_timestamp(), tag __VA_OPT__(,) __VA_ARGS__); } \
else if (ESP_LOG_GET_LEVEL(configs)==ESP_LOG_WARN) { esp_log(ESP_LOG_CONFIG_INIT(ESP_LOG_WARN), tag, LOG_SYSTEM_TIME_FORMAT(W, format), esp_log_system_timestamp(), tag __VA_OPT__(,) __VA_ARGS__); } \
else if (ESP_LOG_GET_LEVEL(configs)==ESP_LOG_DEBUG) { esp_log(ESP_LOG_CONFIG_INIT(ESP_LOG_DEBUG), tag, LOG_SYSTEM_TIME_FORMAT(D, format), esp_log_system_timestamp(), tag __VA_OPT__(,) __VA_ARGS__); } \
else if (ESP_LOG_GET_LEVEL(configs)==ESP_LOG_VERBOSE) { esp_log(ESP_LOG_CONFIG_INIT(ESP_LOG_VERBOSE), tag, LOG_SYSTEM_TIME_FORMAT(V, format), esp_log_system_timestamp(), tag __VA_OPT__(,) __VA_ARGS__); } \
else { esp_log(ESP_LOG_CONFIG_INIT(ESP_LOG_INFO), tag, LOG_SYSTEM_TIME_FORMAT(I, format), esp_log_system_timestamp(), tag __VA_OPT__(,) __VA_ARGS__); } \
} while(0)
#elif NON_OS_BUILD
#define ESP_LOG_LEVEL(configs, tag, format, ...) do { \
if (ESP_LOG_GET_LEVEL(configs)==ESP_LOG_ERROR) { ESP_EARLY_LOGE(tag, format __VA_OPT__(,) __VA_ARGS__); } \
else if (ESP_LOG_GET_LEVEL(configs)==ESP_LOG_WARN) { ESP_EARLY_LOGW(tag, format __VA_OPT__(,) __VA_ARGS__); } \
else if (ESP_LOG_GET_LEVEL(configs)==ESP_LOG_DEBUG) { ESP_EARLY_LOGD(tag, format __VA_OPT__(,) __VA_ARGS__); } \
else if (ESP_LOG_GET_LEVEL(configs)==ESP_LOG_VERBOSE) { ESP_EARLY_LOGV(tag, format __VA_OPT__(,) __VA_ARGS__); } \
else { ESP_EARLY_LOGI(tag, format __VA_OPT__(,) __VA_ARGS__); } \
[cxx]: No ##__VA_ARGS__ in public header files * ##__VA_ARGS__ is replaced by __VA_OPT__(,) and __VA_ARGS if C++20 is used. * Affected header files are: esp_log.h, portmacro.h and esp_check.h * Closes https://github.com/espressif/esp-idf/pull/6692
2021-05-21 11:09:20 +08:00
} while(0)
#endif //CONFIG_LOG_TIMESTAMP_SOURCE_xxx
#else // !(defined(__cplusplus) && (__cplusplus > 201703L))
log: Add menuconfig option to log system time rather than RTOS time Merges https://github.com/espressif/esp-idf/pull/3958
2019-08-22 17:44:09 +01:00
#if CONFIG_LOG_TIMESTAMP_SOURCE_RTOS
feat(log): Use esp_log func in all LOG macros
2024-05-17 22:43:41 +03:00
#define ESP_LOG_LEVEL(configs, tag, format, ...) do { \
if (ESP_LOG_GET_LEVEL(configs)==ESP_LOG_ERROR) { esp_log(ESP_LOG_CONFIG_INIT(ESP_LOG_ERROR), tag, LOG_FORMAT(E, format), esp_log_timestamp(), tag, ##__VA_ARGS__); } \
else if (ESP_LOG_GET_LEVEL(configs)==ESP_LOG_WARN) { esp_log(ESP_LOG_CONFIG_INIT(ESP_LOG_WARN), tag, LOG_FORMAT(W, format), esp_log_timestamp(), tag, ##__VA_ARGS__); } \
else if (ESP_LOG_GET_LEVEL(configs)==ESP_LOG_DEBUG) { esp_log(ESP_LOG_CONFIG_INIT(ESP_LOG_DEBUG), tag, LOG_FORMAT(D, format), esp_log_timestamp(), tag, ##__VA_ARGS__); } \
else if (ESP_LOG_GET_LEVEL(configs)==ESP_LOG_VERBOSE) { esp_log(ESP_LOG_CONFIG_INIT(ESP_LOG_VERBOSE), tag, LOG_FORMAT(V, format), esp_log_timestamp(), tag, ##__VA_ARGS__); } \
else { esp_log(ESP_LOG_CONFIG_INIT(ESP_LOG_INFO), tag, LOG_FORMAT(I, format), esp_log_timestamp(), tag, ##__VA_ARGS__); } \
log: Make ESP_LOGx macros into single statements Requires a semicolon after any use (previously this was optional due to trailing } after expansion) Closes https://github.com/espressif/esp-idf/issues/1757
2018-04-20 13:41:11 +10:00
} while(0)
log: Add menuconfig option to log system time rather than RTOS time Merges https://github.com/espressif/esp-idf/pull/3958
2019-08-22 17:44:09 +01:00
#elif CONFIG_LOG_TIMESTAMP_SOURCE_SYSTEM
feat(log): Use esp_log func in all LOG macros
2024-05-17 22:43:41 +03:00
#define ESP_LOG_LEVEL(configs, tag, format, ...) do { \
if (ESP_LOG_GET_LEVEL(configs)==ESP_LOG_ERROR) { esp_log(ESP_LOG_CONFIG_INIT(ESP_LOG_ERROR), tag, LOG_SYSTEM_TIME_FORMAT(E, format), esp_log_system_timestamp(), tag, ##__VA_ARGS__); } \
else if (ESP_LOG_GET_LEVEL(configs)==ESP_LOG_WARN) { esp_log(ESP_LOG_CONFIG_INIT(ESP_LOG_WARN), tag, LOG_SYSTEM_TIME_FORMAT(W, format), esp_log_system_timestamp(), tag, ##__VA_ARGS__); } \
else if (ESP_LOG_GET_LEVEL(configs)==ESP_LOG_DEBUG) { esp_log(ESP_LOG_CONFIG_INIT(ESP_LOG_DEBUG), tag, LOG_SYSTEM_TIME_FORMAT(D, format), esp_log_system_timestamp(), tag, ##__VA_ARGS__); } \
else if (ESP_LOG_GET_LEVEL(configs)==ESP_LOG_VERBOSE) { esp_log(ESP_LOG_CONFIG_INIT(ESP_LOG_VERBOSE), tag, LOG_SYSTEM_TIME_FORMAT(V, format), esp_log_system_timestamp(), tag, ##__VA_ARGS__); } \
else { esp_log(ESP_LOG_CONFIG_INIT(ESP_LOG_INFO), tag, LOG_SYSTEM_TIME_FORMAT(I, format), esp_log_system_timestamp(), tag, ##__VA_ARGS__); } \
} while(0)
#elif NON_OS_BUILD
#define ESP_LOG_LEVEL(configs, tag, format, ...) do { \
if (ESP_LOG_GET_LEVEL(configs)==ESP_LOG_ERROR) { ESP_EARLY_LOGE(tag, format, ##__VA_ARGS__); } \
else if (ESP_LOG_GET_LEVEL(configs)==ESP_LOG_WARN) { ESP_EARLY_LOGW(tag, format, ##__VA_ARGS__); } \
else if (ESP_LOG_GET_LEVEL(configs)==ESP_LOG_DEBUG) { ESP_EARLY_LOGD(tag, format, ##__VA_ARGS__); } \
else if (ESP_LOG_GET_LEVEL(configs)==ESP_LOG_VERBOSE) { ESP_EARLY_LOGV(tag, format, ##__VA_ARGS__); } \
else { ESP_EARLY_LOGI(tag, format, ##__VA_ARGS__); } \
log: Add menuconfig option to log system time rather than RTOS time Merges https://github.com/espressif/esp-idf/pull/3958
2019-08-22 17:44:09 +01:00
} while(0)
#endif //CONFIG_LOG_TIMESTAMP_SOURCE_xxx
[cxx]: No ##__VA_ARGS__ in public header files * ##__VA_ARGS__ is replaced by __VA_OPT__(,) and __VA_ARGS if C++20 is used. * Affected header files are: esp_log.h, portmacro.h and esp_check.h * Closes https://github.com/espressif/esp-idf/pull/6692
2021-05-21 11:09:20 +08:00
#endif // !(defined(__cplusplus) && (__cplusplus > 201703L))
feat(log): Use esp_log func in all LOG macros
2024-05-17 22:43:41 +03:00
#endif // ESP_LOG_VERSION == 1
feat(log): add new function to log buffer with level and hex dump.
2017-08-21 22:03:53 +08:00
feat(log): Use esp_log func in all LOG macros
2024-05-17 22:43:41 +03:00
/** @cond */
log: new macros to log when the cache is disabled
2020-03-27 17:31:36 +08:00
[cxx]: No ##__VA_ARGS__ in public header files * ##__VA_ARGS__ is replaced by __VA_OPT__(,) and __VA_ARGS if C++20 is used. * Affected header files are: esp_log.h, portmacro.h and esp_check.h * Closes https://github.com/espressif/esp-idf/pull/6692
2021-05-21 11:09:20 +08:00
#if defined(__cplusplus) && (__cplusplus > 201703L)
feat(log): Use esp_log func in all LOG macros
2024-05-17 22:43:41 +03:00
#define ESP_LOG_EARLY_IMPL(tag, format, configs, log_tag_letter, ...) do { \
if (ESP_LOG_VERSION == 1) { \
if (_ESP_LOG_EARLY_ENABLED(configs)) { esp_rom_printf(LOG_FORMAT(log_tag_letter, format), esp_log_timestamp(), tag __VA_OPT__(,) __VA_ARGS__); } \
} else { \
if (ESP_LOG_ENABLED(configs)) { esp_log(ESP_LOG_CONFIG_INIT(configs | ESP_LOG_CONFIGS_DEFAULT | ESP_LOG_CONFIG_CONSTRAINED_ENV), tag, format __VA_OPT__(,) __VA_ARGS__); } \
} } while(0)
[cxx]: No ##__VA_ARGS__ in public header files * ##__VA_ARGS__ is replaced by __VA_OPT__(,) and __VA_ARGS if C++20 is used. * Affected header files are: esp_log.h, portmacro.h and esp_check.h * Closes https://github.com/espressif/esp-idf/pull/6692
2021-05-21 11:09:20 +08:00
#else // !(defined(__cplusplus) && (__cplusplus > 201703L))
feat(log): Use esp_log func in all LOG macros
2024-05-17 22:43:41 +03:00
#define ESP_LOG_EARLY_IMPL(tag, format, configs, log_tag_letter, ...) do { \
if (ESP_LOG_VERSION == 1) { \
if (_ESP_LOG_EARLY_ENABLED(configs)) { esp_rom_printf(LOG_FORMAT(log_tag_letter, format), esp_log_timestamp(), tag, ##__VA_ARGS__); } \
} else { \
if (ESP_LOG_ENABLED(configs)) { esp_log(ESP_LOG_CONFIG_INIT(configs | ESP_LOG_CONFIGS_DEFAULT | ESP_LOG_CONFIG_CONSTRAINED_ENV), tag, format, ##__VA_ARGS__); } \
} } while(0)
[cxx]: No ##__VA_ARGS__ in public header files * ##__VA_ARGS__ is replaced by __VA_OPT__(,) and __VA_ARGS if C++20 is used. * Affected header files are: esp_log.h, portmacro.h and esp_check.h * Closes https://github.com/espressif/esp-idf/pull/6692
2021-05-21 11:09:20 +08:00
#endif // !(defined(__cplusplus) && (__cplusplus > 201703L))
log: new macros to log when the cache is disabled
2020-03-27 17:31:36 +08:00
[cxx]: No ##__VA_ARGS__ in public header files * ##__VA_ARGS__ is replaced by __VA_OPT__(,) and __VA_ARGS if C++20 is used. * Affected header files are: esp_log.h, portmacro.h and esp_check.h * Closes https://github.com/espressif/esp-idf/pull/6692
2021-05-21 11:09:20 +08:00
#if defined(__cplusplus) && (__cplusplus > 201703L)
feat(log): Use esp_log func in all LOG macros
2024-05-17 22:43:41 +03:00
#define ESP_DRAM_LOG_IMPL(tag, format, configs, log_tag_letter, ...) do { \
if (ESP_LOG_VERSION == 1) { \
if (_ESP_LOG_EARLY_ENABLED(configs)) { esp_rom_printf(_ESP_LOG_DRAM_LOG_FORMAT(log_tag_letter, format), tag __VA_OPT__(,) __VA_ARGS__); } \
} else { \
if (ESP_LOG_ENABLED(configs)) { esp_log(ESP_LOG_CONFIG_INIT(configs | ESP_LOG_CONFIGS_DEFAULT | ESP_LOG_CONFIG_CONSTRAINED_ENV | ESP_LOG_CONFIG_DIS_COLOR | ESP_LOG_CONFIG_DIS_TIMESTAMP), tag, DRAM_STR(format) __VA_OPT__(,) __VA_ARGS__); } \
} } while(0)
[cxx]: No ##__VA_ARGS__ in public header files * ##__VA_ARGS__ is replaced by __VA_OPT__(,) and __VA_ARGS if C++20 is used. * Affected header files are: esp_log.h, portmacro.h and esp_check.h * Closes https://github.com/espressif/esp-idf/pull/6692
2021-05-21 11:09:20 +08:00
#else // !(defined(__cplusplus) && (__cplusplus > 201703L))
feat(log): Use esp_log func in all LOG macros
2024-05-17 22:43:41 +03:00
#define ESP_DRAM_LOG_IMPL(tag, format, configs, log_tag_letter, ...) do { \
if (ESP_LOG_VERSION == 1) { \
if (_ESP_LOG_EARLY_ENABLED(configs)) { esp_rom_printf(_ESP_LOG_DRAM_LOG_FORMAT(log_tag_letter, format), tag, ##__VA_ARGS__); } \
} else { \
if (ESP_LOG_ENABLED(configs)) { esp_log(ESP_LOG_CONFIG_INIT(configs | ESP_LOG_CONFIGS_DEFAULT | ESP_LOG_CONFIG_CONSTRAINED_ENV | ESP_LOG_CONFIG_DIS_COLOR | ESP_LOG_CONFIG_DIS_TIMESTAMP), tag, DRAM_STR(format), ##__VA_ARGS__); } \
} } while(0)
[cxx]: No ##__VA_ARGS__ in public header files * ##__VA_ARGS__ is replaced by __VA_OPT__(,) and __VA_ARGS if C++20 is used. * Affected header files are: esp_log.h, portmacro.h and esp_check.h * Closes https://github.com/espressif/esp-idf/pull/6692
2021-05-21 11:09:20 +08:00
#endif // !(defined(__cplusplus) && (__cplusplus > 201703L))
log: new macros to log when the cache is disabled
2020-03-27 17:31:36 +08:00
/** @endcond */
components/log: add API header for logging library TW6703
2016-09-08 20:02:26 +08:00
#ifdef __cplusplus
}
#endif
Reference in New Issue Copy Permalink