Arduino-ESP32 项目中的分区表详解与应用指南

邵娇湘

于 2025-06-02 09:17:14 发布

阅读量428

点赞数 4

CC 4.0 BY-SA版权

本文链接：https://blog.youkuaiyun.com/gitblog_00260/article/details/148377802

Arduino-ESP32 项目中的分区表详解与应用指南

arduino-esp32 Arduino core for the ESP32 项目地址: https://gitcode.com/gh_mirrors/ar/arduino-esp32

分区表概述

在嵌入式开发中，合理管理闪存空间是项目成功的关键因素之一。Arduino-ESP32 平台通过分区表机制，为开发者提供了灵活的闪存管理方案。分区表本质上是一个描述闪存布局的配置文件，它定义了不同类型数据在闪存中的存储位置和大小。

分区表的核心要素

1. 分区表的基本结构

分区表采用 CSV 格式文件定义，每行代表一个分区，包含以下关键字段：

Name, Type, SubType, Offset, Size, Flags

2. 各字段详解

名称 (Name)

分区的唯一标识符
长度限制：不超过16个字符
不能包含特殊字符
系统不依赖名称识别分区，但建议使用有意义的命名

类型 (Type)

app：应用程序分区，存储固件代码
data：数据分区，存储各种非代码数据

子类型 (SubType)

数据分区子类型：

nvs：非易失性存储，适合Wi-Fi配置、设备参数等小型数据
ota：OTA更新信息存储区（固定8KB）
fat：FAT文件系统，支持磨损均衡和加密
spiffs：SPIFFS文件系统，适合较大文件存储

应用程序分区子类型：

factory：出厂固件分区
ota_0~ota_15：OTA更新分区
test：测试用分区

偏移量 (Offset)

分区起始地址
必须满足对齐要求：
- 通用分区：4KB对齐
- 应用程序分区：64KB对齐
第一分区固定偏移：0x9000
第一个应用分区固定偏移：0x10000

大小 (Size)

支持多种表示方式：
- 十进制：4096
- 十六进制：0x1000
- 带单位：4K 或 1M

标志 (Flags)

目前主要用于标识是否启用闪存加密

典型分区方案示例

基础方案（无OTA）

# Name,   Type, SubType, Offset,  Size
nvs,      data, nvs,     36K,     20K,
factory,  app,  factory, 64K,     1900K,

OTA更新方案

# Name,   Type, SubType, Offset,  Size
nvs,      data, nvs,     36K,     20K,
otadata,  data, ota,     56K,     8K,
app0,     app,  ota_0,   64K,     1900K,
app1,     app,  ota_1,   ,        1900K,

带文件系统的方案

# Name,   Type, SubType, Offset,  Size
nvs,      data, nvs,     36K,     20K,
otadata,  data, ota,     56K,     8K,
app0,     app,  ota_0,   64K,     2M,
app1,     app,  ota_1,   ,        2M,
spiffs,   data, spiffs,  ,        3M,