自定义 ESP32 分区表 partitions.csv

最近在 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 配置中可选择以下预定义分区表:

• Single factory app, no OTA
• Factory app, two OTA definitions

接下来可以分别查看其中的具体信息。

1.1 Single factory app, no OTA

# Name,   Type, SubType, Offset,  Size, Flags
nvs,      data, nvs,     0x9000,  0x6000,
phy_init, data, phy,     0xf000,  0x1000,
factory,  app,  factory, 0x10000, 1M,

我们可以看到：

• 定义了两个用于存储 NVS 库分区和 PHY 初始化数据的数据区域
• 在0x10000(64 KB) 偏移量处为 factory 应用程序，定义的长度是 1 M

故此时程序固件大于 1 M，即会出现文章开头的报错。

1.2 Factory app, two OTA definitions

# Name,   Type, SubType, Offset,  Size, Flags
nvs,      data, nvs,     0x9000,  0x4000,
otadata,  data, ota,     0xd000,  0x2000,
phy_init, data, phy,     0xf000,  0x1000,
factory,  0,    0,       0x10000, 1M,
ota_0,    0,    ota_0,  0x110000, 1M,
ota_1,    0,    ota_1,  0x210000, 1M,

我们可以看到：

• 有 factory、ota_0 和 ota_1三个应用程序分区定义，这三种 Type 都设置为 app。长度大小都是 1M；
• 有一个 ota data 区域，一般用于保存 OTA 更新的数据。 如果 ota data 为空，它将执行 factory 应用程序。

2. 解决方案：自定义 ESP32 分区表

拿 Single factory app, no OTA 来举例，如果 程序固件 大于 1 M，即会出现文章开头的错误。此时我们可以做如下修改（flash 为 4 M 时）：

# Name,   Type, SubType, Offset,  Size, Flags
nvs,      data, nvs,     0x9000,  0x6000,
phy_init, data, phy,     0xf000,  0x1000,
factory,  app,  factory, 0x10000, 2M,

修改后如果程序固件不大于 2 M，就不会报错了。