ESP32C3 API学习笔记_1

错误处理

官方文档直通车：

错误处理 - ESP32-C3 - — ESP-IDF 编程指南 release-v5.1 文档 (espressif.com)

多数 ESP-IDF API 会返回由 esp_err_t 类型定义的错误代码

错误码定义位置：esp_err.h

错误代码并不直观，因此 ESP-IDF 还可以使用 esp_err_to_name() 或者 esp_err_to_name_r() 函数，将错误代码转换为具体的错误消息；如果出现找不到的情况，函数 esp_err_to_name_r() 则会尝试将错误码作为一种 标准 POSIX 错误代码 进行解释。

样例：

sdmmc_card_t* card = calloc(1, sizeof(sdmmc_card_t));
if (card == NULL) {
    return ESP_ERR_NO_MEM;
}
esp_err_t err = sdmmc_card_init(host, &card);
if (err != ESP_OK) {
    // 释放内存
    free(card);
    // 将错误码传递给上层（例如通知用户）
    // 或者，应用程序可以自定义错误代码并返回
    return err;
}

结构体

ESP-IDF 中的初始化、配置和安装函数（通常以 ..._init()、 ..._config() 和 ..._install() 命名）都需要一个指向配置结构体的指针作为参数。

正确的初始化:

const esp_timer_create_args_t my_timer_args = {
    .callback = &my_timer_callback,
    .arg = callback_arg,
    .name = "my_timer"
};
esp_timer_handle_t my_timer;
esp_err_t err = esp_timer_create(&my_timer_args, &my_timer);

不正确的写法

esp_timer_create_args_t my_timer_args;
my_timer_args.callback = &my_timer_callback;
/* 错误! 字段 .arg 和 .name 未初始化 */
esp_timer_create(&my_timer_args, &my_timer);

缺省宏的初始化

httpd_config_t config = HTTPD_DEFAULT_CONFIG();
/* HTTPD_DEFAULT_CONFIG 扩展到一个指定的初始化器。此时，所有字段均已设置为默认值，且支持编辑：*/
config.server_port = 8081;
httpd_handle_t server;
esp_err_t err = httpd_start(&server, &config);

---

我公司承接各类技术服务，主要聚焦于：stm32、单片机、嵌入式、QT应用开发、Web+Python+Django应用开发。欢迎合作。