mirror of
https://github.com/espressif/esp-idf.git
synced 2026-07-13 14:33:06 +03:00
d670774f5c
Refactor the esp_err_to_name() system to decouple esp_common from higher-level components. Instead of a monolithic generated table, each component registers its error codes into a dedicated linker section (.esp_err_msg_table) via idf_define_esp_err_codes() in its CMakeLists.txt. New files: - tools/err_codes_extract.py: extract ESP_ERR_* defines from headers to CSV - tools/err_codes_to_c.py: generate C source placing entries into linker section - tools/err_codes_to_rst.py: generate RST documentation from error codes - tools/cmake/err_codes.cmake: CMake module providing idf_define_esp_err_codes() - components/esp_common/include/esp_err_codes.h: esp_err_msg_t typedef - components/esp_common/src/esp_err_to_name_new.c: new lookup using link-time array - tools/test_apps/build_system/err_codes_check/: CI test app Changes: - Remove all optional component dependencies from esp_common/CMakeLists.txt - Add .esp_err_msg_table section to all 5 linker scripts - Register error codes in 18 components via idf_define_esp_err_codes() - Add new scripts to .gitlab/ci/rules.yml build_check patterns - use new scripts to generate doc and add CI validation - Update esp_err.rst to add description of composable code registration
148 lines
6.5 KiB
C
148 lines
6.5 KiB
C
/*
|
|
* SPDX-FileCopyrightText: 2015-2026 Espressif Systems (Shanghai) CO LTD
|
|
*
|
|
* SPDX-License-Identifier: Apache-2.0
|
|
*/
|
|
|
|
#pragma once
|
|
|
|
#include <stdint.h>
|
|
#include <stdio.h>
|
|
#include <assert.h>
|
|
#include <stdlib.h>
|
|
#include "esp_compiler.h"
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
typedef int esp_err_t;
|
|
|
|
/* Definitions for error constants. */
|
|
#define ESP_OK 0 /*!< esp_err_t value indicating success (no error) */
|
|
#define ESP_FAIL -1 /*!< Generic esp_err_t code indicating failure */
|
|
|
|
#define ESP_ERR_NO_MEM 0x101 /*!< Out of memory */
|
|
#define ESP_ERR_INVALID_ARG 0x102 /*!< Invalid argument */
|
|
#define ESP_ERR_INVALID_STATE 0x103 /*!< Invalid state */
|
|
#define ESP_ERR_INVALID_SIZE 0x104 /*!< Invalid size */
|
|
#define ESP_ERR_NOT_FOUND 0x105 /*!< Requested resource not found */
|
|
#define ESP_ERR_NOT_SUPPORTED 0x106 /*!< Operation or feature not supported */
|
|
#define ESP_ERR_TIMEOUT 0x107 /*!< Operation timed out */
|
|
#define ESP_ERR_INVALID_RESPONSE 0x108 /*!< Received response was invalid */
|
|
#define ESP_ERR_INVALID_CRC 0x109 /*!< CRC or checksum was invalid */
|
|
#define ESP_ERR_INVALID_VERSION 0x10A /*!< Version was invalid */
|
|
#define ESP_ERR_INVALID_MAC 0x10B /*!< MAC address was invalid */
|
|
#define ESP_ERR_NOT_FINISHED 0x10C /*!< Operation has not fully completed */
|
|
#define ESP_ERR_NOT_ALLOWED 0x10D /*!< Operation is not allowed */
|
|
|
|
#define ESP_ERR_WIFI_BASE 0x3000 /*!< Starting number of WiFi error codes */
|
|
#define ESP_ERR_MESH_BASE 0x4000 /*!< Starting number of MESH error codes */
|
|
#define ESP_ERR_FLASH_BASE 0x6000 /*!< Starting number of flash error codes */
|
|
#define ESP_ERR_HW_CRYPTO_BASE 0xc000 /*!< Starting number of HW cryptography module error codes */
|
|
#define ESP_ERR_MEMPROT_BASE 0xd000 /*!< Starting number of Memory Protection API error codes */
|
|
|
|
/**
|
|
* @brief Returns string for esp_err_t error codes
|
|
*
|
|
* This function finds the error code in a lookup-table populated at link time
|
|
* and returns its string representation.
|
|
*
|
|
* Components register their error codes by calling idf_define_esp_err_codes()
|
|
* in their CMakeLists.txt. The build system extracts error codes from the
|
|
* specified headers and generates entries placed in the .esp_err_msg_tbl
|
|
* linker section.
|
|
*
|
|
* @param code esp_err_t error code
|
|
* @return string error message
|
|
*/
|
|
const char *esp_err_to_name(esp_err_t code);
|
|
|
|
/**
|
|
* @brief Returns string for esp_err_t and system error codes
|
|
*
|
|
* This function finds the error code in a lookup-table populated at link time
|
|
* and returns its string representation. If the error code is not found then
|
|
* it is attempted to be found among system errors.
|
|
*
|
|
* Components register their error codes by calling idf_define_esp_err_codes()
|
|
* in their CMakeLists.txt.
|
|
*
|
|
* @param code esp_err_t error code
|
|
* @param[out] buf buffer where the error message should be written
|
|
* @param buflen Size of buffer buf. At most buflen bytes are written into the buf buffer (including the terminating null byte).
|
|
* @return buf containing the string error message
|
|
*/
|
|
const char *esp_err_to_name_r(esp_err_t code, char *buf, size_t buflen);
|
|
|
|
/** @cond */
|
|
void _esp_error_check_failed(esp_err_t rc, const char *file, int line, const char *function, const char *expression) __attribute__((__noreturn__));
|
|
|
|
void _esp_error_check_failed_without_abort(esp_err_t rc, const char *file, int line, const char *function, const char *expression);
|
|
|
|
#ifndef __ASSERT_FUNC
|
|
/* This won't happen on IDF, which defines __ASSERT_FUNC in assert.h, but it does happen when building on the host which
|
|
uses /usr/include/assert.h or equivalent.
|
|
*/
|
|
#ifdef __ASSERT_FUNCTION
|
|
#define __ASSERT_FUNC __ASSERT_FUNCTION /* used in glibc assert.h */
|
|
#else
|
|
#define __ASSERT_FUNC "??"
|
|
#endif
|
|
#endif
|
|
/** @endcond */
|
|
|
|
/**
|
|
* Macro which can be used to check the error code,
|
|
* and terminate the program in case the code is not ESP_OK.
|
|
* Prints the error code, error location, and the failed statement to serial output.
|
|
*
|
|
* Disabled if assertions are disabled.
|
|
*/
|
|
#ifdef NDEBUG
|
|
#define ESP_ERROR_CHECK(x) do { \
|
|
esp_err_t err_rc_ = (x); \
|
|
(void) sizeof(err_rc_); \
|
|
} while(0)
|
|
#elif defined(CONFIG_COMPILER_OPTIMIZATION_ASSERTIONS_SILENT)
|
|
#define ESP_ERROR_CHECK(x) do { \
|
|
esp_err_t err_rc_ = (x); \
|
|
if (unlikely(err_rc_ != ESP_OK)) { \
|
|
abort(); \
|
|
} \
|
|
} while(0)
|
|
#else
|
|
#define ESP_ERROR_CHECK(x) do { \
|
|
esp_err_t err_rc_ = (x); \
|
|
if (unlikely(err_rc_ != ESP_OK)) { \
|
|
_esp_error_check_failed(err_rc_, __FILE__, __LINE__, \
|
|
__ASSERT_FUNC, #x); \
|
|
} \
|
|
} while(0)
|
|
#endif
|
|
|
|
/**
|
|
* Macro which can be used to check the error code. Prints the error code, error location, and the failed statement to
|
|
* serial output.
|
|
* In comparison with ESP_ERROR_CHECK(), this prints the same error message but isn't terminating the program.
|
|
*/
|
|
#if defined NDEBUG || defined CONFIG_COMPILER_OPTIMIZATION_ASSERTIONS_SILENT
|
|
#define ESP_ERROR_CHECK_WITHOUT_ABORT(x) ({ \
|
|
esp_err_t err_rc_ = (x); \
|
|
err_rc_; \
|
|
})
|
|
#else
|
|
#define ESP_ERROR_CHECK_WITHOUT_ABORT(x) ({ \
|
|
esp_err_t err_rc_ = (x); \
|
|
if (unlikely(err_rc_ != ESP_OK)) { \
|
|
_esp_error_check_failed_without_abort(err_rc_, __FILE__, __LINE__, \
|
|
__ASSERT_FUNC, #x); \
|
|
} \
|
|
err_rc_; \
|
|
})
|
|
#endif //NDEBUG
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|