ESP32-IDF 分区表

最新推荐文章于 2025-03-12 09:59:56 发布
最新推荐文章于 2025-03-12 09:59:56 发布
阅读量5.3k 收藏 30
点赞数 38
分类专栏： # ESP32 文章标签： 嵌入式 esp32-idf
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/Teminator_/article/details/143067754
版权

目录

一、基本介绍

使用时要添加头文件 #include "esp_partition.h"。

1、配置结构体

1.1 esp_partition_t

typedef struct {
    esp_flash_t* flash_chip;            /*!< SPI flash chip on which the partition resides */
    esp_partition_type_t type;          /*!< partition type (app/data) */
    esp_partition_subtype_t subtype;    /*!< partition subtype */
    uint32_t address;                   /*!< starting address of the partition in flash */
    uint32_t size;                      /*!< size of the partition, in bytes */
    uint32_t erase_size;                /*!< size the erase operation should be aligned to */
    char label[17];                     /*!< partition label, zero-terminated ASCII string */
    bool encrypted;                     /*!< flag is set to true if partition is encrypted */
    bool readonly;                      /*!< flag is set to true if partition is read-only */
} esp_partition_t;

该结构体存储的是分区信息，使用的是 API 的格式，而不是 Flash 中的格式，该格式是 esp_partition_info_t。

  • flash_chip：分区所在的 SPI 闪存芯片
  • type：分区类型 （app/data）
  • subtype：partition subtype partition 子类型
  • address：Flash 中分区的起始地址
  • size：分区的大小（以字节为单位）
  • erase_size：擦除操作所应对齐的大小
  • label：分区标签，以零结尾的 ASCII 字符串
  • encrypted：如果分区已加密，则 flag 设置为 true
  • readonly：如果 partition 是只读的，则 flag 设置为 true

1.2 esp_partition_iterator_t

用于遍历分区表的迭代器：

typedef struct esp_partition_iterator_opaque_* esp_partition_iterator_t;

...

typedef struct esp_partition_iterator_opaque_ {
    esp_partition_type_t type;                      // requested type
    esp_partition_subtype_t subtype;                // requested subtype
    const char *label;                              // requested label (can be NULL)
    partition_list_item_t *next_item;               // next item to iterate to
    esp_partition_t *info;                          // pointer to info (it is redundant, but makes code more readable)
} esp_partition_iterator_opaque_t;

2、常用 API

2.1 esp_partition_find

esp_partition_iterator_t esp_partition_find(esp_partition_type_t type, esp_partition_subtype_t subtype, const char *label)
  • 参数
    • type：分区类型，参考 esp_partition_type_t
    • subtype：分区子类型，参考 esp_partition_subtype_t
    • label：可选）分区标签。如果查找具有特定名称的分区，请设置此值。否则传递 NULL。
  • 作用
    • 根据一个或多个参数查找分区。
  • 返回值
    • esp_partition_iterator_t ：可用于枚举找到的所有分区的迭代器；如果未找到分区，则为 NULL。通过此函数获取的 Iterator 在不再使用时必须使用 esp_partition_iterator_release 释放。

2.2 esp_partition_find_first

const esp_partition_t *esp_partition_find_first(esp_partition_type_t type, esp_partition_subtype_t subtype, const char *label)
  • 参数
    • type：分区类型，参考 esp_partition_type_t
    • subtype：分区子类型，参考 esp_partition_subtype_t
    • label：可选）分区标签。如果查找具有特定名称的分区，请设置此值。否则传递 NULL。
  • 作用
    • 根据一个或多个参数查找第一个分区。
  • 返回值
    • esp_partition_iterator_t ：指向 esp_partition_t 结构的指针，如果未找到分区，则为 NULL。此指针在应用程序的生存期内有效。

2.3 esp_partition_get

const esp_partition_t *esp_partition_get(esp_partition_iterator_t iterator)
  • 参数
    • iterator：通过 esp_partition_find 获取的迭代器。必须为非 NULL。
  • 作用
    • 获取给定分区 esp_partition_t 结构。
  • 返回值
    • esp_partition_t ：指向 esp_partition_t 结构的指针。此指针在应用程序的生存期内有效。

2.4 esp_partition_next

esp_partition_iterator_t esp_partition_next(esp_partition_iterator_t iterator)
  • 参数
    • iterator：通过 esp_partition_find 获取的迭代器。必须为非 NULL。
  • 作用
    • 将 partition iterator 移动到找到的下一个分区。
  • 返回值
    • esp_partition_t ：如果未找到分区，则为 NULL，否则为有效的 esp_partition_iterator_t。

2.5 esp_partition_iterator_release

void esp_partition_iterator_release(esp_partition_iterator_t iterator)
  • 参数
    • iterator：使用 esp_partition_find 获取的迭代器。迭代器允许为 NULL，因此在调用此函数之前无需检查其值。
  • 作用
    • 释放 partition 迭代器。

2.6 esp_partition_verify

const esp_partition_t *esp_partition_verify(const esp_partition_t *partition)
  • 参数
    • partition：指向要验证的分区数据的指针。必须为非 NULL。此结构的所有字段必须与 flash 中的分区表条目匹配，此函数才能返回成功匹配。
  • 作用
    • 验证分区数据。
  • 返回值
    • 如果未找到分区，则返回 NULL。
    • 如果找到，则返回指向 flash 中 esp_partition_t 结构的指针。此指针在应用程序的生存期内始终有效。

2.7 esp_partition_read

esp_err_t esp_partition_read(const esp_partition_t *partition, size_t src_offset, void *dst, size_t size)
  • 参数
    • partition：指向使用 esp_partition_find_first 或 esp_partition_get 获取的分区结构的指针。必须为非 NULL。
    • src_offset：要读取的数据的地址，相对于分区的开头。
    • dst：向应存储数据的缓冲区的指针。指针必须为非 NULL，并且缓冲区必须至少为 ‘size’ 字节长。
    • size：要读取的数据的大小，以字节为单位。
  • 作用
    • 从分区中读取数据。
  • 返回值
    • ESP_OK，如果数据读取成功
    • ESP_ERR_INVALID_ARG：参数错误，比如 src_offset 超过分区大小
    • ESP_ERR_INVALID_SIZE：如果读取将超出分区的边界

2.8 esp_partition_write

esp_err_t esp_partition_write(const esp_partition_t *partition, size_t dst_offset, const void *src, size_t size)
  • 参数
    • partition：指向使用 esp_partition_find_first 或 esp_partition_get 获取的分区结构的指针。必须为非 NULL。
    • dst_offset：相对于分区开头应写入数据的地址。
    • src：指向源缓冲区的指针。指针必须为非 NULL，并且缓冲区必须至少为 ‘size’ 字节长。
    • size：要写入的数据的大小，以字节为单位。
  • 作用
    • 从将数据写入分区。
  • 返回值
    • ESP_OK，如果数据读取成功
    • ESP_ERR_INVALID_ARG：参数错误，比如 dst_offset 超过分区大小
    • ESP_ERR_INVALID_SIZE：如果 write 会超出分区的边界
    • ESP_ERR_NOT_ALLOWED：如果分区是只读的

在将数据写入 flash 之前，需要擦除 flash 的相应区域。这可以使用 esp_partition_erase_range 函数来完成。

2.9 esp_partition_erase_range

esp_err_t esp_partition_erase_range(const esp_partition_t *partition, size_t offset, size_t size)
  • 参数
    • partition：指向使用 esp_partition_find_first 或 esp_partition_get 获取的分区结构的指针。必须为非 NULL。
    • offset：从擦除操作应开始的分区开头开始的偏移量。必须与 partition->erase_size 对齐。
    • size：应擦除的范围大小，以字节为单位。必须能被 partition->erase_size 整除。
  • 作用
    • 擦除分区的一部分。
  • 返回值
    • ESP_OK，如果数据读取成功
    • ESP_ERR_INVALID_ARG：参数错误，比如 iterator 或 dst 为 NULL
    • ESP_ERR_INVALID_SIZE：如果 erase 会超出分区的边界
    • ESP_ERR_NOT_ALLOWED：如果分区是只读的

2.10 esp_partition_get_main_flash_sector_size

uint32_t esp_partition_get_main_flash_sector_size(void)
  • 参数
    • partition：指向使用 esp_partition_find_first 或 esp_partition_get 获取的分区结构的指针。必须为非 NULL。
    • offset：从擦除操作应开始的分区开头开始的偏移量。必须与 partition->erase_size 对齐。
    • size：应擦除的范围大小，以字节为单位。必须能被 partition->erase_size 整除。
  • 作用
    • 获取主闪存扇区大小。
  • 返回值
    • SPI_FLASH_SEC_SIZE：用于 esp32xx 目标
    • ESP_PARTITION_EMULATED_SECTOR_SIZE：对于 Linux 目标

2.11 esp_partition_copy

esp_err_t esp_partition_copy(const esp_partition_t *dest_part, uint32_t dest_offset, const esp_partition_t *src_part, uint32_t src_offset, size_t size)
  • 参数
    • dest_part：指向目标分区的指针。
    • dest_offset：应写入数据的目标分区中的偏移量 （必须与 SPI_FLASH_SEC_SIZE = 0x1000 对齐）。
    • src_part：指向源分区的指针（必须位于内部 Flash 上）。
    • src_offset：应从中读取数据的源分区中的偏移量。
    • size：要从源分区复制到目标分区的字节数。如果 size == SIZE_MAX，则该函数将从 src_offset 复制到源分区的末尾，并擦除整个目标分区（从 dest_offset 开始）。
  • 作用
    • 将数据从特定偏移量的源分区复制到特定偏移量的目标分区。
  • 返回值
    • SPI_FLASH_SEC_SIZE：用于 esp32xx 目标

目标偏移量必须与 Flash 扇区大小 （SPI_FLASH_SEC_SIZE = 0x1000） 对齐。如果 size == SIZE_MAX ，则整个目标分区（从 dest_offset 开始）将被擦除，并且该函数会将从 src_offset 开始的所有源分区复制到目标分区。该函数确保在扇区边界上擦除目标分区（擦除大小SPI_FLASH_SEC_SIZE 对齐）。

3、枚举类型

3.1 esp_partition_type_t

分区表类型 Type，具体见第二节介绍：

typedef enum {
    ESP_PARTITION_TYPE_APP = 0x00,       //!< Application partition type
    ESP_PARTITION_TYPE_DATA = 0x01,      //!< Data partition type

    ESP_PARTITION_TYPE_ANY = 0xff,       //!< Used to search for partitions with any type
} esp_partition_type_t;

3.2 esp_partition_subtype_t

分区表子类型 SubType，具体见第二节介绍：

typedef enum {
    ESP_PARTITION_SUBTYPE_APP_FACTORY = 0x00,                                 //!< Factory application partition
    ESP_PARTITION_SUBTYPE_APP_OTA_MIN = 0x10,                                 //!< Base for OTA partition subtypes
    ESP_PARTITION_SUBTYPE_APP_OTA_0 = ESP_PARTITION_SUBTYPE_APP_OTA_MIN + 0,  //!< OTA partition 0
    ESP_PARTITION_SUBTYPE_APP_OTA_1 = ESP_PARTITION_SUBTYPE_APP_OTA_MIN + 1,  //!< OTA partition 1
    ESP_PARTITION_SUBTYPE_APP_OTA_2 = ESP_PARTITION_SUBTYPE_APP_OTA_MIN + 2,  //!< OTA partition 2
    ESP_PARTITION_SUBTYPE_APP_OTA_3 = ESP_PARTITION_SUBTYPE_APP_OTA_MIN + 3,  //!< OTA partition 3
    ESP_PARTITION_SUBTYPE_APP_OTA_4 = ESP_PARTITION_SUBTYPE_APP_OTA_MIN + 4,  //!< OTA partition 4
    ESP_PARTITION_SUBTYPE_APP_OTA_5 = ESP_PARTITION_SUBTYPE_APP_OTA_MIN + 5,  //!< OTA partition 5
    ESP_PARTITION_SUBTYPE_APP_OTA_6 = ESP_PARTITION_SUBTYPE_APP_OTA_MIN + 6,  //!< OTA partition 6
    ESP_PARTITION_SUBTYPE_APP_OTA_7 = ESP_PARTITION_SUBTYPE_APP_OTA_MIN + 7,  //!< OTA partition 7
    ESP_PARTITION_SUBTYPE_APP_OTA_8 = ESP_PARTITION_SUBTYPE_APP_OTA_MIN + 8,  //!< OTA partition 8
    ESP_PARTITION_SUBTYPE_APP_OTA_9 = ESP_PARTITION_SUBTYPE_APP_OTA_MIN + 9,  //!< OTA partition 9
    ESP_PARTITION_SUBTYPE_APP_OTA_10 = ESP_PARTITION_SUBTYPE_APP_OTA_MIN + 10,//!< OTA partition 10
    ESP_PARTITION_SUBTYPE_APP_OTA_11 = ESP_PARTITION_SUBTYPE_APP_OTA_MIN + 11,//!< OTA partition 11
    ESP_PARTITION_SUBTYPE_APP_OTA_12 = ESP_PARTITION_SUBTYPE_APP_OTA_MIN + 12,//!< OTA partition 12
    ESP_PARTITION_SUBTYPE_APP_OTA_13 = ESP_PARTITION_SUBTYPE_APP_OTA_MIN + 13,//!< OTA partition 13
    ESP_PARTITION_SUBTYPE_APP_OTA_14 = ESP_PARTITION_SUBTYPE_APP_OTA_MIN + 14,//!< OTA partition 14
    ESP_PARTITION_SUBTYPE_APP_OTA_15 = ESP_PARTITION_SUBTYPE_APP_OTA_MIN + 15,//!< OTA partition 15
    ESP_PARTITION_SUBTYPE_APP_OTA_MAX = ESP_PARTITION_SUBTYPE_APP_OTA_MIN + 16,//!< Max subtype of OTA partition
    ESP_PARTITION_SUBTYPE_APP_TEST = 0x20,                                    //!< Test application partition

    ESP_PARTITION_SUBTYPE_DATA_OTA = 0x00,                                    //!< OTA selection partition
    ESP_PARTITION_SUBTYPE_DATA_PHY = 0x01,                                    //!< PHY init data partition
    ESP_PARTITION_SUBTYPE_DATA_NVS = 0x02,                                    //!< NVS partition
    ESP_PARTITION_SUBTYPE_DATA_COREDUMP = 0x03,                               //!< COREDUMP partition
    ESP_PARTITION_SUBTYPE_DATA_NVS_KEYS = 0x04,                               //!< Partition for NVS keys
    ESP_PARTITION_SUBTYPE_DATA_EFUSE_EM = 0x05,                               //!< Partition for emulate eFuse bits
    ESP_PARTITION_SUBTYPE_DATA_UNDEFINED = 0x06,                              //!< Undefined (or unspecified) data partition

    ESP_PARTITION_SUBTYPE_DATA_ESPHTTPD = 0x80,                               //!< ESPHTTPD partition
    ESP_PARTITION_SUBTYPE_DATA_FAT = 0x81,                                    //!< FAT partition
    ESP_PARTITION_SUBTYPE_DATA_SPIFFS = 0x82,                                 //!< SPIFFS partition
    ESP_PARTITION_SUBTYPE_DATA_LITTLEFS = 0x83,                               //!< LITTLEFS partition

#if __has_include("extra_partition_subtypes.inc")
    #include "extra_partition_subtypes.inc"
#endif

    ESP_PARTITION_SUBTYPE_ANY = 0xff,                                         //!< Used to search for partitions with any subtype
} esp_partition_subtype_t;

二、ESP32 Partition

1、概述

每片 ESP32-C3 的 flash 可以包含多个应用程序，以及多种不同类型的数据（例如校准数据、文件系统数据、参数存储数据等）。因此，我们在 flash 的 默认偏移地址 0x8000 处烧写一张分区表。

分区表的长度为 0xC00 字节，最多可以保存 95 条分区表条目。MD5 校验和附加在分区表之后，用于在运行时验证分区表的完整性。分区表占据了整个 flash 扇区，大小为 0x1000 (4 KB)。因此，它后面的任何分区至少需要位于 (默认偏移地址) + 0x1000 处。

分区表中的每个条目都包括以下几个部分：Name（标签）、Type（app、data 等）、SubType 以及在 flash 中的偏移量（分区的加载地址）。

在使用分区表时，最简单的方法就是打开项目配置菜单（使用命令 idf.py menuconfig），并在 CONFIG_PARTITION_TABLE_TYPE 下选择一个预定义的分区表：

"Single factory app, no OTA"
"Single factory app(large), no OTA"
"Factory app, two OTA definitions"

在以上三种选项(自定义分区后面会讲)中，出厂应用程序均将被烧录至 flash 的 0x10000 偏移地址处。这时，运行 idf.py partition-table，即可以打印当前使用分区表的信息摘要。

2、分区表格式

2.1 partition_table

我们先讲一下分区表的组成：

# Name,   Type, SubType, Offset,  Size, Flags

一共有五个字段，下面分别来看一下。

2.1.1 Name

Name 字段可以是任何有意义的名称，但不能超过 16 个字节，其中包括一个空字节（之后的内容将被截断）。该字段对 ESP32-C3 并不是特别重要。

2.1.2 Type

Type 字段可以指定为 app (0x00) 或者 data (0x01)，也可以直接使用数字 0-254（或者十六进制 0x00-0xFE）。

注意，0x00-0x3F 不得使用（预留给 esp-idf 的核心功能）。

如果你的应用程序需要以 ESP-IDF 尚未支持的格式存储数据，请在 0x40-0xFE 内添加一个自定义分区类型。

这里可以参考一下 esp_partition_type_t（见第一节）关于 app 和 data 分区的枚举定义。

注意，启动加载器将忽略 app (0x00) 和 data (0x01) 以外的其他分区类型。

2.1.3 SubType

SubType 字段长度为 8 bit，内容与具体分区 Type 有关，也可以看作 Type 的具体分类。目前，esp-idf 仅仅规定了 app 和 data 两种分区类型的子类型含义。

可以参考 esp_partition_subtype_t，以了解 ESP-IDF 定义的全部子类型列表，包括：

  • 当 Type 定义为 app 时，SubType 字段可以指定为 factory (0x00)、 ota_0 (0x10) ~ ota_15 (0x1F) 或者 test (0x20)。
    • factory (0x00) 是默认的 app 分区。启动加载器将默认加载该应用程序。但如果存在类型为 data/ota 分区，则启动加载器将加载 data/ota 分区中的数据，进而判断启动哪个 OTA 镜像文件。
      • OTA 升级永远都不会更新 factory 分区中的内容。
      • 如果你希望在 OTA 项目中预留更多 flash，可以删除 factory 分区，转而使用 ota_0 分区。
    • ota_0 (0x10) ~ ota_15 (0x1F) 为 OTA 应用程序分区，启动加载器将根据 OTA 数据分区中的数据来决定加载哪个 OTA 应用程序分区中的程序。在使用 OTA 功能时，应用程序应至少拥有 2 个 OTA 应用程序分区（ota_0 和 ota_1）。
    • test (0x20) 为预留的子类型，用于工厂测试流程。如果没有其他有效 app 分区，test 将作为备选启动分区使用。也可以配置启动加载器在每次启动时读取 GPIO，如果 GPIO 被拉低则启动该分区。
  • 当 Type 定义为 data 时，SubType 字段可以指定为 ota (0x00)、phy (0x01)、nvs (0x02)、nvs_keys (0x04) 或者其他组件特定的子类型（请参考 子类型枚举).
    • ota (0) 即 OTA 数据分区 ，用于存储当前所选的 OTA 应用程序的信息。这个分区的大小需要设定为 0x2000。
    • phy (1) 分区用于存放 PHY 初始化数据，从而保证可以为每个设备单独配置 PHY，而非必须采用固件中的统一 PHY 初始化数据。
      • 默认配置下，phy 分区并不启用，而是直接将 phy 初始化数据编译至应用程序中，从而节省分区表空间（直接将此分区删掉）。
      • 如果需要从此分区加载 phy 初始化数据，则打开项目配置菜单（idf.py menuconfig），并且使能CONFIG_ESP_PHY_INIT_DATA_IN_PARTITION 选项。此时，还需要手动将 phy 初始化数据烧至设备 flash（esp-idf 编译系统并不会自动完成该操作）。
    • nvs (2) 是专门给 非易失性存储 (NVS) API 使用的分区。
      • 用于存储每台设备的 PHY 校准数据（注意，并不是 PHY 初始化数据）。
      • 用于存储 Wi-Fi 数据（如果使用了 esp_wifi_set_storage(WIFI_STORAGE_FLASH) 初始化函数）。
      • NVS API 还可以用于其他应用程序数据。强烈建议为 NVS 分区分配至少 0 x 3000 0x3000 0x3000 字节空间。
      • 如果使用 NVS API 存储大量数据，请增加 NVS 分区的大小（默认是 0 x 6000 0x6000 0x6000 字节）。
    • nvs_keys (4) 是 NVS 秘钥分区。
      • 用于存储加密密钥（如果启用了 NVS 加密 功能）。
      • 此分区应至少设定为 4096 字节。

NVS 的内容下一篇文章会讲到

ESP-IDF 还支持其他用于数据存储的预定义子类型，包括：

  • coredump (0x03) 用于在使用自定义分区表 CSV 文件时存储核心转储。
  • efuse (0x05) 使用 虚拟 eFuse 模拟 eFuse 位。
  • undefined (0x06) 隐式用于未指定子类型（即子类型为空）的数据分区，但也可显式将其标记为未定义。
  • fat (0x81) 用于 FAT 文件系统。
  • spiffs (0x82) 用于 SPIFFS 文件系统。
  • littlefs (0x83) 用于 LittleFS 文件系统。

如果分区类型是由应用程序定义的任意值 (0x40-0xFE)，那么 subtype 字段可以是由应用程序选择的任何值 (0x00-0xFE)。

额外 SubType 字段

组件可以通过设置 EXTRA_PARTITION_SUBTYPES 属性来定义额外的分区子类型。 EXTRA_PARTITION_SUBTYPES 是一个 CMake 列表，其中的每个条目由字符串组成，以逗号为分隔，格式为 <type>、<subtype>、<value>。构建系统通过该属性会自动添加额外的子类型，并在 esp_partition_subtype_t 中插入名为 ESP_PARTITION_SUBTYPE_<type>_<subtype> 的字段。项目可以使用这个子类型来定义分区表 CSV 文件中的分区，并使用 esp_partition_subtype_t 中的新字段。

2.1.4 Offset 和 Size

  • 偏移地址表示 SPI flash 中的分区地址，扇区大小为 0x1000 (4 KB)。因此，偏移地址必须是 4 KB 的倍数。

  • 若 CSV 文件中的分区偏移地址为空，则该分区会接在前一个分区之后；若为首个分区，则将接在分区表之后。

  • app 分区的偏移地址必须与 0x10000 (64 KB) 对齐。如果偏移字段留空，则 gen_esp32part.py 工具会自动计算得到一个满足对齐要求的偏移地址。如果 app 分区的偏移地址没有与 0x10000 (64 KB) 对齐，则该工具会报错。(所以大部分情况下 Offset 字段都是留空)

  • app 分区的大小必须与 flash 扇区大小对齐。为 app 分区指定未对齐的大小将返回错误。

  • app 分区的大小和偏移地址可以采用十进制数或是以 0x 为前缀的十六进制数，且支持 K 或 M 的倍数单位（K 和 M 分别代表 1024 和 1024*1024 字节）。

如果你希望允许分区表中的分区采用任意起始偏移量 (CONFIG_PARTITION_TABLE_OFFSET)，请将分区表（CSV 文件）中所有分区的偏移字段都留空。注意，此时，如果你更改了分区表中任意分区的偏移地址，则其他分区的偏移地址也会跟着改变。这种情况下，如果你之前还曾设定某个分区采用固定偏移地址，则可能造成分区表冲突，从而导致报错。

2.1.5 Flags

目前支持 encrypted 和 readonly 标记：

  • 如果 Flags 字段设置为 encrypted，且已启用 flash 加密 功能，则该分区将会被加密。
  • 如果 Flags 字段设置为 readonly，则该分区为只读分区。readonly 标记仅支持除 ota 和 coredump 子类型外的 data 分区。使用该标记，防止意外写入如出厂数据分区等包含关键设备特定配置数据的分区。
  • 无论是否设置 Flags 字段，app 分区都将保持加密。
  • 可以使用冒号连接不同的标记，来同时指定多个标记，如 encrypted:readonly。

2.2 内置分区表

结果刚才的介绍，下面来看一下官方提供的分区表文件：

下程序取自：esp-idf/components/partition_table/partitions_singleapp.csv，也就是上面提到的选项 "Single factory app, no OTA"：

# Name,   Type, SubType, Offset,  Size, Flags
# Note: if you have increased the bootloader size, make sure to update the offsets to avoid overlap
nvs,      data, nvs,     ,        0x6000,
phy_init, data, phy,     ,        0x1000,
factory,  app,  factory, ,        1M,
  • flash 的 0x10000 (64 KB) 偏移地址处存放一个标记为 “factory” 的二进制应用程序，且启动加载器将默认加载这个应用程序。
  • 分区表中还定义了两个数据区域，分别用于存储 NVS 库专用分区和 PHY 初始化数据。

下面是带两个 OTA 分区的，esp-idf/components/partition_table/partitions_two_ota.csv：

# Name,   Type, SubType, Offset,   Size, Flags
# Note: if you have increased the bootloader size, make sure to update the offsets to avoid overlap
nvs,      data, nvs,     ,        0x4000,
otadata,  data, ota,     ,        0x2000,
phy_init, data, phy,     ,        0x1000,
factory,  app,  factory, ,        1M,
ota_0,    app,  ota_0,   ,        1M,
ota_1,    app,  ota_1,   ,        1M,
  • 分区表中定义了三个应用程序分区，这三个分区的类型都被设置为 “app”，但具体 app 类型不同。其中，位于 0x10000 偏移地址处的为出厂应用程序 (factory)，其余两个为 OTA 应用程序（ota_0，ota_1）。
  • 新增了一个名为 “otadata” 的数据分区，用于保存 OTA 升级时需要的数据。启动加载器会查询该分区的数据，以判断该从哪个 OTA 应用程序分区加载程序。如果 “otadata” 分区为空，则会执行出厂程序。

2.3 生成二进制分区表

烧写到 ESP32-C3 中的分区表采用二进制的 bin 文件，而不是 CSV 文件本身。此时，esp-idf/components/partition_table/gen_esp32part.py 工具可以实现 CSV 和 bin 之间的转换。

如果你在项目配置菜单（idf.py menuconfig）中设置了分区表 CSV 文件的名称，然后构建项目或执行 idf.py partition-table。这时，转换将在编译过程中自动完成。

当我们选择了自定义分区表文件后，这里就会新出现一个选项，让我们填写自定义的分区表文件的名称。

注意，这个分区表文件必须在你的项目的顶层目录下，名称也必须对应，否则会找不到。例如：

# 手动将 CSV 文件转换为二进制文件
python gen_esp32part.py input_partitions.csv binary_partitions.bin

# 手动将二进制文件转换为 CSV 文件
python gen_esp32part.py binary_partitions.bin input_partitions.csv

# 在标准输出 (stdout) 上，打印二进制分区表的内容（运行 idf.py partition-table 时展示的信息摘要也是这样生成的）
python gen_esp32part.py binary_partitions.bin

2.4 MD5 校验和

bin 格式的分区表中含有一个 MD5 校验和。这个 MD5 校验和是根据分区表内容计算的，可在设备启动阶段，用于验证分区表的完整性。

用户可通过 gen_esp32part.py 的 --disable-md5sum 选项或者 CONFIG_PARTITION_TABLE_MD5 选项关闭 MD5 校验。

2.5 烧写分区表

  • idf.py partition-table-flash ：使用 esptool.py 工具烧写分区表。
  • idf.py flash ：会烧写所有内容，包括分区表。

在执行 idf.py partition-table 命令时，手动烧写分区表的命令也将打印在终端上。

分区表的更新并不会擦除根据旧分区表存储的数据。此时，可以使用 idf.py erase-flash 命令或者 esptool.py erase_flash 命令来擦除 flash 中的所有内容。

三、实例操作

1、例一——基本读写流程

本例简单演示了如何对特定分区 storage 进行写入和读取，需要注意的是，在将数据写入 flash 之前，必须向用 esp_partition_erase_range 函数擦除 flash 的相应区域。

void app_main(void)
{
    const esp_partition_t *partition_ptr = esp_partition_find_first(ESP_PARTITION_TYPE_DATA, ESP_PARTITION_SUBTYPE_ANY, "storage");
    assert(partition_ptr!= NULL);

    static char store_data[] = "ESP-IDF Paritition Operations Example (Read, Erase, Write)";
    static char read_data[sizeof(store_data)];

    memset(read_data, 0xFF, sizeof(read_data));
    ESP_ERROR_CHECK(esp_partition_erase_range(partition_ptr, 0, partition_ptr->size));

    ESP_ERROR_CHECK(esp_partition_write(partition_ptr, 0, store_data, sizeof(store_data)));
    ESP_LOGI(TAG, "Written data: %s", store_data);

    ESP_ERROR_CHECK(esp_partition_read(partition_ptr, 0, read_data, sizeof(read_data)));
    ESP_LOGI(TAG, "Read data: %s", read_data);

    ESP_ERROR_CHECK(esp_partition_erase_range(partition_ptr, 0, SPI_FLASH_SEC_SIZE));
    
    memset(store_data, 0xFF, sizeof(read_data));
    ESP_ERROR_CHECK(esp_partition_read(partition_ptr, 0, read_data, sizeof(read_data)));
    assert(memcmp(store_data, read_data, sizeof(read_data)) == 0);

    ESP_LOGI(TAG, "Erased data");

    ESP_LOGI(TAG, "Example end");
}

分区表文件如下：

# Name,   Type, SubType, Offset,  Size, Flags
nvs,        data, nvs,     ,      0x6000,
phy_init,   data, phy,     ,      0x1000,
factory,    app,  factory, ,      1M,
storage,    data, ,        ,      0x40000,

前面说了，只要在 menuconfig 里设置了自定义分区表，那么烧录的时候会自动将分区表烧录进去：

结果如下：

2、例二——遍历操作

本例中主要演示了迭代器 iterator 是怎么使用的，一定要记住，使用完迭代器后一定要释放：

// Get the string name of type enum values used in this example
static const char* get_type_str(esp_partition_type_t type)
{
    switch(type) {
        case ESP_PARTITION_TYPE_APP:
            return "ESP_PARTITION_TYPE_APP";
        case ESP_PARTITION_TYPE_DATA:
            return "ESP_PARTITION_TYPE_DATA";
        default:
            return "UNKNOWN_PARTITION_TYPE"; // type not used in this example
    }
}

// Get the string name of subtype enum values used in this example
static const char* get_subtype_str(esp_partition_subtype_t subtype)
{
    switch(subtype) {
        case ESP_PARTITION_SUBTYPE_DATA_NVS:
            return "ESP_PARTITION_SUBTYPE_DATA_NVS";
        case ESP_PARTITION_SUBTYPE_DATA_PHY:
            return "ESP_PARTITION_SUBTYPE_DATA_PHY";
        case ESP_PARTITION_SUBTYPE_APP_FACTORY:
            return "ESP_PARTITION_SUBTYPE_APP_FACTORY";
        case ESP_PARTITION_SUBTYPE_DATA_FAT:
            return "ESP_PARTITION_SUBTYPE_DATA_FAT";
        default:
            return "UNKNOWN_PARTITION_SUBTYPE"; // subtype not used in this example
    }
}

// Find the partition using given parameters
static void find_partition(esp_partition_type_t type, esp_partition_subtype_t subtype, const char* name)
{
    ESP_LOGI(TAG, "Find partition with type %s, subtype %s, label %s...", get_type_str(type), get_subtype_str(subtype),
                    name == NULL ? "NULL (unspecified)" : name);

    const esp_partition_t * part  = esp_partition_find_first(type, subtype, name);

    if (part != NULL) {
        ESP_LOGI(TAG, "\tfound partition '%s' at offset 0x%" PRIx32 " with size 0x%" PRIx32, part->label, part->address, part->size);
    } else {
        ESP_LOGE(TAG, "partition not found!");
    }
}

void app_main(void)
{
    /* First Part - Finding partitions using esp_partition_find_first. */

    ESP_LOGI(TAG, "----------------Find partitions---------------");

    find_partition(ESP_PARTITION_TYPE_DATA, ESP_PARTITION_SUBTYPE_DATA_NVS, NULL);
    find_partition(ESP_PARTITION_TYPE_DATA, ESP_PARTITION_SUBTYPE_DATA_PHY, NULL);
    find_partition(ESP_PARTITION_TYPE_APP, ESP_PARTITION_SUBTYPE_APP_FACTORY, NULL);

    /* Second Part - Iterating over partitions */

    ESP_LOGI(TAG, "----------------Iterate through partitions---------------");

    esp_partition_iterator_t it;

    ESP_LOGI(TAG, "Iterating through app partitions...");
    it = esp_partition_find(ESP_PARTITION_TYPE_APP, ESP_PARTITION_SUBTYPE_ANY, NULL);

    // 遍历 APP 分区
    for (; it != NULL; it = esp_partition_next(it)) {
        const esp_partition_t *part = esp_partition_get(it);
        ESP_LOGI(TAG, "\tfound partition '%s' at offset 0x%" PRIx32 " with size 0x%" PRIx32, part->label, part->address, part->size);
    }
    esp_partition_iterator_release(it);

    ESP_LOGI(TAG, "Iteratoring througn data partitions...");
    it = esp_partition_find(ESP_PARTITION_TYPE_DATA, ESP_PARTITION_SUBTYPE_ANY, NULL);

    // 遍历 Data 分区
    for (; it != NULL; it = esp_partition_next(it)) {
        const esp_partition_t *part = esp_partition_get(it);
        ESP_LOGI(TAG, "\tfound partition '%s' at offset 0x%" PRIx32 " with size 0x%" PRIx32, part->label, part->address, part->size);
    }   

    // 释放迭代器
    esp_partition_iterator_release(it);

    ESP_LOGI(TAG, "Example end");
}

分区表如下：

# Name,   Type, SubType, Offset,  Size, Flags
nvs,        data, nvs,     ,      0x6000,
phy_init,   data, phy,     ,      0x1000,
factory,    app,  factory, ,      1M,
storage1,    data, fat,    ,      0x40000,
storage2,    data, fat,    ,      0x40000,

结果如下：

ESP-IDF编译系统详解（1）
phmatthaus的专栏
04-27 1912
ESP-IDF编译系统详解（1）
关于ESP32-C3模组分区的诸细节问题详解
phmatthaus的专栏
06-06 1657
关于ESP32-C3模组分区的诸细节问题详解
ESP32之 ESP-IDF 教学（十三）—— 分区表
Augtons 的博客
01-03 1万+
本专栏讲解如何使用 ESP-IDF 构建 ESP32 程序，发布文章并会持续为已发布文章添加新内容！本文介绍了和为分区表以及如何使用分区表，为之后的学习提理论基础。
esp32-IDF 自定义分区表partitions.csv，Flash存储
小王的博客
03-12 1160
ESP32 的分区表长度为 0xC00 字节（最大支持95个分区表条目）。如果启用了安全启动，分区表的签名会附加在表格数据之后，因此整个分区表占据一个完整的闪存扇区，大小为 0x1000（4 KB）。因此，任何在分区表之后的分区必须至少位于 0x8000 + 0x1000 = 0x9000 的偏移量。ESP32 的分区表用于将Flash划分为多个功能区域，每个区域有特定的用途。user_config是我自己创建的分区，用于存放图片数据，所以内存分配的比较大。我的Flash是16MB，所以分配的空间较大。
ESP32中的分区表
smallerxuan的博客
11-28 4912
简单的对ESP32中的分区表的部分具体概念进行了描述，并简单阅读了一个分区表示例，同时也介绍了如何通过图形化界面配置分区表设置。
ESP32 分区表介绍
在嵌入式嵌入式领域奋斗的程序猿的博客
08-18 1677
ESP32 分区表介绍
ESP32 快速入门（九）：自定义 ESP32 分区表 partitions.csv
01-06
最近在 ESP32 编译中遇到了以下问题： esp_image: Image length 1057652 doesn't fit in partition length 1048576 boot: Factory app partition is not bootable boot: No bootable app partitions in the partition table 这里应该是分区表分配给 APP 的空间不够。借此契机来了解一下 ESP32 的分区表 partitions.csv 吧。 1. ESP32 预定义分区表 make menuconfig 配置中可选择以下预定义
ESP32 官方文档（三）分区表
qinrenzhi的博客
03-11 1952
分区表分区表概述内置分区表创建自定义分区表名字字段类型字段子类型App 子类型数据子类型偏移量 &amp; 大小标志生成二进制分区表MD5 校验和烧录分区表 分区表 概述 单个 ESP32 的 flash 可以包含多个应用程序,以及许多不同类型的数据(校准数据,文件系统,参数存储等). 因此,分区表被下载到 flash 中的 0x8000 地址(默认偏移量). 分区表长度为 0xC00 字节(最多...
【ESP32】打造全网最强esp-idf基础教程——12.ESP32中的分区表
Hello_kitty_ling的博客
06-24 2264
其实这里并非没有指定地址，在esp-idf中，还默认有个bootloader程序，这个程序在分区表中的地址是0x1000，另外还有分区表本身也需要存储，分区表在flash中存储的地址是0x8000，大小是0x1000，也就是除开bootloader和分区表本身，可用的地址是从0x9000开始的，也就是说，esp-idf中nvs分区其实地址是从0x9000开始存储，然后Size=0x6000。这个分区的大小需要设定为0x2000。擦除一段内容，第一个参数是分区指针，第二个参数是偏移地址，第三个参数是大小。
ESP32-IDF 在 Ubuntu 下的配置
热门推荐
Projectsauron 的博客
08-23 3万+
参考资料：官方文档：Linux 和 macOS 平台工具链的标准设置。参照官方文档，首先下载编译 所需要的软件包： 二、获取 ESP-IDF 首先创建一个目录用来作为 esp32 的工作目录： 为了解决国内开发者从 Github 克隆 esp 相关仓库慢的问题，官方已将 esp-idf 和部分重要仓库及其关联的子模块镜像到了 jihu，这些仓库将自动从原始仓库进行同步。所以先获取官方的工具：（相关信息见 乐鑫开源/esp-gitee-tools） 使用如下命令即可使用镜像的 URL： 然后就可以克隆远程仓
【ESP32】分区表
m0_48990531的博客
05-12 1855
记录 ESP32的 分区表 配置和介绍
ESP32分区表图解
SimonLiu的博客
07-15 1万+
在这篇博文ESP8266 RTOS 之 esp-aliyun 例程Flash分区中，我以2M的ESP8266为例说明了分区表的空间划分。 本文则以ESP32 4M Flash为例，讲一讲如何自定义分区。 首先下图是一个标准的分区表： 关于offset设置。make menuconfig - Partition Table设置里，有一个offset设置，默认为0x8000，即Patition Table的分区偏移地址。Patition Table的分区长度一般为0x1000。修改这个值，会影响到后面所有分区
ESP32-分区表
可可芯意的博客
01-28 930
一、分区表 分区表就不表述了，可以百度查到很多资料 二、我的配置 factory没啥用，直接上OTA0 OTA1 将nvs增大到0x73000,460K OTA0,OTA1分别是1b400，1744K OTA0地址是0x8000,OTA1地址是0x240000 注意 地址都要0x1000，也就是4K对齐… # Name, Type, SubType, Offset, Size, Flags # Note: if you change the phy_init or app partition
【ESP32】【分区表】
iStoneWalker的博客
01-21 2845
编译 ESP32 工程时，build 成功，但是下载时遇到如下问题： 经同事指点，是由于编译的 bootloader.bin 过大：新编译的 bootloader.bin 29K。而默认下载地址为： 0x1000： bootloader.bin 0x8000： partition-table.bin 0x10000: user.bin 计算 0x8000 - 0x1000 = 0x70...
在PlatformIO中配置 ESP32的分区表
qq_41932736的博客
12-23 3837
应该大家都在使用PlatformIO开发项目吧，可能也会遇到遇到一些问题吧。现在分享我遇到的问题。当我苦等工程建立成功时，TMD的太慢了！这以是一个问题。然后编译ESP32完成后看了程序存储空间被惊到了，才几行程序空间就快没了！（当时没有在意，还以为封装库太多了导致的！，然后去买了存储空间大的ESP32S3还是这个样子！此时就开始这个问题搜索......）然后看到分区表的内容。自所以空间会很小是官方默认分配空间小，而导致这个情况！怎么办呢，只有配置属于自己项目的分区表了。这里主要讲在VScode+
ESP32学习四-自定义分区表
qq_26226375的博客
04-14 4335
改分区就根据用户自定义来划分。
ESP32分区表介绍
sky的博客
06-06 1559
1、先按照如下图打开自定义分区表功能2、在Vscode中按下”快捷键打开命令面板，并在搜索栏内输入“打开分区表编辑器”，按下图配置各个分区大小首先按下"Add New Row”选项添加子分区条目然后设置条目的类型，偏移和大小。最后按下“Save”保存.Name字段Name 字段可以是任何有意义的名称，但不能超过 16 个字节，其中包括一个空字节（之后的内容将被截断）。该字段对 ESP32-S3 并不是特别重要。Type字段。
xecuting action: flash Serial port /dev/ttyACM0 Connecting.... Detecting chip type... ESP32-S3 Running ninja in directory /home/jichu/esp32/lvgl_display/build Executing "ninja flash"... [1/1] cd /home/jichu/esp32/lvgl_displa...isplay/build/bootloader/bootloader.bin Bootloader binary size 0x5240 bytes. 0x2dc0 bytes (36%) free. [2/5] Linking CXX executable lvgl_display.elf FAILED: lvgl_display.elf : && /home/jichu/.espressif/tools/xtensa-esp-elf/esp-13.2.0_20230928/xtensa-esp-elf/bin/xtensa-esp32s3-elf-g++ -mlongcalls -Wl,--cref -Wl,--defsym=IDF_TARGET_ESP32S3=0 -Wl,--Map=/home/jichu/esp32/lvgl_display/build/lvgl_display.map -Wl,--no-warn-rwx-segments -fno-rtti -fno-lto -Wl,--gc-sections -Wl,--warn-common -T esp32s3.peripherals.ld -T esp32s3.rom.ld -T esp32s3.rom.api.ld -T esp32s3.rom.libgcc.ld -T esp32s3.rom.newlib.ld -T esp32s3.rom.version.ld -T memory.ld -T sections.ld CMakeFiles/lvgl_display.elf.dir/project_elf_src_esp32s3.c.obj -o lvgl_display.elf -L/home/jichu/esp32/esp-idf/components/soc/esp32s3/ld -L/home/jichu/esp32/esp-idf/components/esp_rom/esp32s3/ld -L/home/jichu/esp32/lvgl_display/build/esp-idf/esp_system/ld -L/home/jichu/esp32/esp-idf/components/esp_phy/lib/esp32s3 -L/home/jichu/esp32/esp-idf/components/esp_coex/lib/esp32s3 -L/home/jichu/esp32/esp-idf/components/esp_wifi/lib/esp32s3 -L/home/jichu/esp32/esp-idf/components/bt/controller/lib_esp32c3_family/esp32s3 esp-idf/xtensa/libxtensa.a esp-idf/esp_ringbuf/libesp_ringbuf.a esp-idf/efuse/libefuse.a esp-idf/esp_mm/libesp_mm.a esp-idf/driver/libdriver.a esp-idf/esp_pm/libesp_pm.a esp-idf/mbedtls/libmbedtls.a esp-idf/esp_bootloader_format/libesp_bootloader_format.a esp-idf/esp_app_format/libesp_app_format.a esp-idf/bootloader_support/libbootloader_support.a esp-idf/esp_partition/libesp_partition.a esp-idf/app_update/libapp_update.a esp-idf/spi_flash/libspi_flash.a esp-idf/pthread/libpthread.a esp-idf/esp_system/libesp_system.a esp-idf/esp_rom/libesp_rom.a esp-idf/hal/libhal.a esp-idf/log/liblog.a esp-idf/heap/libheap.a esp-idf/soc/libsoc.a esp-idf/esp_hw_support/libesp_hw_support.a esp-idf/freertos/libfreertos.a esp-idf/newlib/libnewlib.a esp-idf/cxx/libcxx.a esp-idf/esp_common/libesp_common.a esp-idf/esp_timer/libesp_timer.a esp-idf/app_trace/libapp_trace.a esp-idf/esp_event/libesp_event.a esp-idf/nvs_flash/libnvs_flash.a esp-idf/esp_phy/libesp_phy.a esp-idf/vfs/libvfs.a esp-idf/lwip/liblwip.a esp-idf/esp_netif/libesp_netif.a esp-idf/wpa_supplicant/libwpa_supplicant.a esp-idf/esp_coex/libesp_coex.a esp-idf/esp_wifi/libesp_wifi.a esp-idf/bt/libbt.a esp-idf/unity/libunity.a esp-idf/cmock/libcmock.a esp-idf/console/libconsole.a esp-idf/http_parser/libhttp_parser.a esp-idf/esp-tls/libesp-tls.a esp-idf/esp_adc/libesp_adc.a esp-idf/esp_eth/libesp_eth.a esp-idf/esp_gdbstub/libesp_gdbstub.a esp-idf/esp_hid/libesp_hid.a esp-idf/tcp_transport/libtcp_transport.a esp-idf/esp_http_client/libesp_http_client.a esp-idf/esp_http_server/libesp_http_server.a esp-idf/esp_https_ota/libesp_https_ota.a esp-idf/esp_lcd/libesp_lcd.a esp-idf/protobuf-c/libprotobuf-c.a esp-idf/protocomm/libprotocomm.a esp-idf/esp_local_ctrl/libesp_local_ctrl.a esp-idf/espcoredump/libespcoredump.a esp-idf/wear_levelling/libwear_levelling.a esp-idf/sdmmc/libsdmmc.a esp-idf/fatfs/libfatfs.a esp-idf/json/libjson.a esp-idf/mqtt/libmqtt.a esp-idf/nvs_sec_provider/libnvs_sec_provider.a esp-idf/perfmon/libperfmon.a esp-idf/spiffs/libspiffs.a esp-idf/touch_element/libtouch_element.a esp-idf/usb/libusb.a esp-idf/wifi_p
最新发布
03-14
<think>好的，我现在要处理用户提供的关于ESP32-S3项目编译失败的日志。首先，我需要仔细阅读日志内容，找出关键错误信息。用户执行了`ninja flash`命令，但在链接阶段出现了问题，具体是`FAILED: lvgl_display.elf`，说明生成可执行文件时失败。 首先，我注意到链接器命令中使用了`xtensa-esp32s3-elf-g++`，这可能涉及到C++的链接问题。常见的失败原因可能包括内存不足、库缺失或版本不兼容、符号未定义等。用户的环境是ESP-IDF，可能使用了LVGL库，所以需要检查相关依赖是否正确配置。 日志中的错误没有直接显示具体的错误信息，这可能是因为输出被截断或者需要更详细的编译日志。因此，我应该建议用户增加编译的详细程度，例如运行`ninja -v flash`来获取更多信息。此外，检查是否有未定义的引用（undefined reference）或库路径问题。 另一个可能性是项目的sdkconfig配置不正确，特别是对于ESP32-S3的配置，例如PSRAM设置、分区表大小等。用户需要确认`sdkconfig`中是否选择了正确的芯片型号，以及LVGL相关配置是否适配ESP32-S3。 内存不足也是一个常见问题，尤其是在链接阶段。Bootloader的大小显示为0x5240字节，剩余36%的空间，这可能没问题，但主应用程序可能超出了可用内存。需要检查分区表是否合理，以及应用程序的代码量和内存需求。 还有可能是工具链的问题，比如xtensa-esp32s3-elf-g++的版本是否与ESP-IDF版本兼容。用户使用的ESP-IDF版本是否支持所选的LVGL版本？需要确认版本兼容性，并尝试重新安装或更新工具链。 此外，检查CMakeLists.txt和组件依赖是否正确，特别是LVGL组件是否被正确包含，路径是否正确。如果用户自定义了组件，可能存在路径错误或编译选项冲突。 最后，建议用户清理构建目录（删除build文件夹）并重新编译，有时候旧的构建文件会导致链接错误。如果问题依旧，查看更详细的日志或尝试简化项目以隔离问题。</think>您在尝试通过 `ninja flash` 命令烧录 ESP32-S3 固件时遇到了链接阶段的编译错误。以下是问题分析和解决步骤： --- ### **错误定位** 日志显示关键错误： ```bash FAILED: lvgl_display.elf : && /home/jichu/.espressif/tools/.../xtensa-esp32s3-elf-g++ ... (链接命令) ``` 此错误表明在生成最终可执行文件 `lvgl_display.elf` 时，链接器 (`xtensa-esp32s3-elf-g++`) 失败。 --- ### **可能原因** 1. **内存不足** - Bootloader 剩余空间：$$ 0x5240 \text{ bytes (总)} - 0x2dc0 \text{ bytes (剩余)} = 0x2480 \text{ bytes (已用)} $$ - 主程序 (`lvgl_display.elf`) 可能超出芯片 Flash 或 RAM 限制。 2. **依赖库缺失或冲突** - 检查是否缺少 LVGL 相关库（如 `lvgl/liblvgl.a`）。 - 确保所有组件（如 Wi-Fi、SPIFFS）在 `sdkconfig` 中正确配置。 3. **符号未定义 (Undefined Reference)** - 常见于未实现函数、头文件未包含或库未链接。 4. **工具链版本不兼容** - ESP-IDF 版本与 LVGL 组件或第三方库存在兼容性问题。 --- ### **解决步骤** #### 1. **启用详细日志** 重新编译并输出详细错误信息： ```bash ninja -v flash | tee build.log ``` 检查 `build.log` 中具体的未定义符号或路径错误。 --- #### 2. **检查内存配置** - **分区表**：确认 `partitions.csv` 中 `app` 分区大小是否足够。 - **sdkconfig**：通过 `idf.py menuconfig` 检查： - **Component config → LVGL → Memory settings**（调整 LVGL 缓冲区大小）。 - **Serial flasher config → Flash Size** 是否匹配硬件。 --- #### 3. **验证依赖关系** - **组件路径**：确保 LVGL 组件路径正确（`CMakeLists.txt` 中 `EXTRA_COMPONENT_DIRS`）。 - **库链接**：在 `CMakeLists.txt` 中添加缺失库： ```cmake target_link_libraries(${PROJECT_NAME} PRIVATE lvgl) ``` --- #### 4. **清理并重新编译** 清除旧构建文件： ```bash rm -rf build idf.py build ``` --- #### 5. **缩小问题范围** - **最小化代码**：注释掉 LVGL 初始化代码，逐步排查功能模块。 - **更新工具链**：重新安装 ESP-IDF 或更新至稳定版本（如 v5.1）。 --- ### **扩展建议** - **使用官方例程**：从 `esp-idf/examples/peripherals/lcd/lvgl` 测试基础功能。 - **内存分析工具**：通过 `idf.py size-components` 查看各组件内存占用。 如果仍有问题，请提供 `build.log` 中的具体错误信息，以便进一步诊断！
评论 4
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值