别再问卖家了！手把手教你用ESP-IDF和esptool查询ESP32的Flash和PSRAM大小（附代码）

ESP32硬件侦探指南：全方位解析Flash与PSRAM的查询技巧

拿到一块来路不明的ESP32开发板，就像收到一个没有说明书的礼物——既兴奋又忐忑。作为开发者，我们最关心的莫过于板上Flash和PSRAM的实际容量是否与卖家描述一致。本文将带你深入ESP32硬件信息的查询世界，从基础工具使用到高级编程验证，打造一套完整的"自助验机"方案。

1. 准备工作：搭建硬件侦探的"工具箱"

在开始硬件侦探之旅前，我们需要准备几样关键工具。首先是esptool，这是乐鑫官方提供的多功能瑞士军刀，能够与ESP32的bootloader进行通信。安装非常简单：

pip install esptool

对于Windows用户，安装后可以直接在命令提示符中使用esptool.py命令。Mac和Linux用户可能需要使用esptool或esptool.py，具体取决于pip的安装方式。

连接开发板时的常见问题排查：

• 确保安装了正确的USB驱动程序（CP210x或CH340等）
• 检查设备管理器中是否识别到串口
• 尝试不同的USB线缆，劣质线缆可能导致通信不稳定
• 如果使用USB集线器，尝试直接连接到电脑的USB端口

提示：某些ESP32开发板需要按住BOOT按钮再按RESET进入下载模式，才能被esptool识别

2. 快速查询Flash信息：esptool的妙用

Flash存储器是ESP32的核心组件，存储着固件和文件系统。使用esptool可以快速获取Flash的详细信息：

esptool.py flash_id

这个命令会输出类似如下的信息：

Detecting chip type... ESP32 Chip is ESP32-D0WDQ6 (revision 1) Features: WiFi, BT, Dual Core, 240MHz, VRef calibration in efuse, Coding Scheme None Crystal is 40MHz MAC: xx:xx:xx:xx:xx:xx Uploading stub... Running stub... Stub running... Manufacturer: c8 Device: 4016 Detected flash size: 4MB Hard resetting via RTS pin...

关键信息解读：

• Manufacturer: Flash芯片制造商ID（c8对应GigaDevice）
• Device: 设备型号代码
• Detected flash size: 实际检测到的Flash容量

常见Flash容量对应表：

值得注意的是，某些山寨板可能会使用劣质Flash芯片，虽然容量显示正确，但实际性能和可靠性可能大打折扣。这也是为什么我们需要进一步验证的原因。

3. 深入挖掘PSRAM信息：ESP-IDF工程验证法

PSRAM（伪静态随机存取存储器）是某些ESP32型号（如WROVER）的额外内存资源，对于内存密集型应用至关重要。与Flash不同，PSRAM的信息需要通过运行代码来获取。

3.1 创建验证工程

首先创建一个新的ESP-IDF工程，或者使用现有的helloworld示例。关键是要正确配置SPIRAM支持：

1. 打开菜单配置：

   idf.py menuconfig

2. 导航至Component config → ESP32-specific
3. 启用Support for external, SPI-connected RAM
4. 在子菜单中启用Initialize SPI RAM during startup
5. 保存并退出配置

3.2 添加PSRAM检测代码

在main.c中添加以下代码：

#include "esp_spiram.h" #include "esp_log.h" void app_main() { // 获取PSRAM大小 size_t psram_size = esp_spiram_get_size(); ESP_LOGI("PSRAM", "Detected size: %d bytes (%d MB)", psram_size, psram_size / (1024 * 1024)); // 验证PSRAM是否可用 if (esp_spiram_test()) { ESP_LOGI("PSRAM", "PSRAM test passed"); } else { ESP_LOGI("PSRAM", "PSRAM test failed!"); } }

编译并烧录程序后，串口监视器会显示类似输出：

I (342) PSRAM: Detected size: 8388608 bytes (8 MB) I (342) PSRAM: PSRAM test passed

3.3 解读启动日志中的隐藏信息

即使不添加额外代码，ESP-IDF的启动日志也包含了PSRAM信息。仔细观察串口输出的初始信息，你可能会发现：

spiram: Found 64MBit SPI RAM device

这里显示的是64MBit，需要转换为更常见的MB单位：

64MBit ÷ 8 = 8MB

ESP32系列PSRAM容量对照表：

4. 高级技巧：全面硬件信息探测

除了基本的Flash和PSRAM信息，我们还可以获取更多硬件细节来全面了解手中的ESP32开发板。

4.1 获取芯片完整信息

使用esptool可以获取芯片的详细规格：

esptool.py chip_id

输出示例：

Chip is ESP32-D0WDQ6 (revision 1) Features: WiFi, BT, Dual Core, 240MHz, VRef calibration in efuse, Coding Scheme None MAC: xx:xx:xx:xx:xx:xx

芯片型号解读：

• ESP32-D0WDQ6: 双核，WiFi+BT，QFN封装
• ESP32-S0WD: 单核版本
• ESP32-U4WDH: 4MB内置Flash版本

4.2 编程方式获取硬件信息

在代码中，我们可以使用以下API获取更多硬件信息：

#include "esp_chip_info.h" void print_chip_info() { esp_chip_info_t chip_info; esp_chip_info(&chip_info); printf("Chip Model: %s\n", CONFIG_IDF_TARGET); printf("Chip Revision: %d\n", chip_info.revision); printf("Chip Cores: %d\n", chip_info.cores); printf("Features:%s%s%s%s\n", (chip_info.features & CHIP_FEATURE_WIFI_BGN) ? " WiFi" : "", (chip_info.features & CHIP_FEATURE_BLE) ? " BT" : "", (chip_info.features & CHIP_FEATURE_BT) ? " BLE" : "", (chip_info.features & CHIP_FEATURE_EMB_FLASH) ? " EmbeddedFlash" : ""); printf("Flash Size: %dMB\n", spi_flash_get_chip_size() / (1024 * 1024)); }

4.3 识别开发板型号

虽然ESP32芯片本身有型号标识，但开发板的具体型号（如WROOM、WROVER）通常需要通过Flash和PSRAM的组合来判断：

常见组合判断逻辑：

void identify_board() { size_t flash_size = spi_flash_get_chip_size(); size_t psram_size = esp_spiram_get_size(); if (psram_size == 0) { if (flash_size == 1*1024*1024) printf("Likely ESP32-WROOM-32 (1MB)\n"); else if (flash_size == 2*1024*1024) printf("Likely ESP32-WROOM-32 (2MB)\n"); else if (flash_size == 4*1024*1024) printf("Likely ESP32-WROOM-32 (4MB)\n"); } else { if (flash_size == 4*1024*1024 && psram_size == 4*1024*1024) printf("Likely ESP32-WROVER (4MB+4MB)\n"); else if (flash_size == 8*1024*1024 && psram_size == 8*1024*1024) printf("Likely ESP32-WROVER-B (8MB+8MB)\n"); } }

5. 实战案例：二手ESP32开发板验机流程

假设你从某鱼购买了一块标称"ESP32-WROVER 8MB Flash + 8MB PSRAM"的开发板，以下是完整的验证流程：

1. 物理检查：

   • 查看板载芯片标记
   • 检查天线连接方式（PCB天线或IPEX接口）
   • 确认USB转串口芯片型号

2. 基础信息获取：

   esptool.py chip_id esptool.py flash_id

3. PSRAM验证：

   • 创建测试工程并启用SPIRAM支持
   • 添加PSRAM检测代码
   • 编译烧录并观察输出

4. 性能测试：

   // 简单的PSRAM读写测试 void test_psram() { uint32_t *mem = (uint32_t*)heap_caps_malloc(1024, MALLOC_CAP_SPIRAM); if(mem == NULL) { printf("PSRAM allocation failed!\n"); return; } // 写入测试 for(int i=0; i<256; i++) { mem[i] = i; } // 读取验证 int errors = 0; for(int i=0; i<256; i++) { if(mem[i] != i) errors++; } printf("PSRAM test completed with %d errors\n", errors); heap_caps_free(mem); }

5. 综合判断：

   • 对比检测结果与卖家描述
   • 评估芯片是否为正品（通过MAC地址前三位）
   • 检查Flash和PSRAM性能是否达标

6. 常见问题与解决方案

Q1: esptool无法识别我的设备

A1: 尝试以下步骤：

1. 检查USB驱动安装
2. 尝试不同的USB端口
3. 按住BOOT按钮再插入USB
4. 手动指定端口：esptool.py --port COM3 flash_id

Q2: PSRAM检测结果为0，但卖家声称有PSRAM

A2: 可能原因：

• 菜单配置未正确启用PSRAM支持
• 开发板实际没有PSRAM
• PSRAM芯片损坏
• 使用了不支持PSRAM的ESP32型号（如C3）

Q3: Flash检测大小与实际不符

A3: 可能情况：

• 使用了非常规Flash芯片
• Flash芯片部分损坏
• 开发板使用了分区的Flash（如OTA保留区）

Q4: 如何区分正品和山寨ESP32开发板

A4: 几个鉴别点：

• 正品通常使用乐鑫官方模组（WROOM/WROVER）
• 检查芯片丝印是否清晰
• MAC地址前三位：24:0A:C4（乐鑫）
• 使用espefuse.py工具读取efuse信息

7. 扩展应用：自动化硬件检测脚本

对于需要批量检测的开发场景，我们可以创建一个自动化脚本：

import serial import re import subprocess def detect_esp32(port): try: # 获取芯片信息 result = subprocess.run(['esptool.py', '--port', port, 'chip_id'], capture_output=True, text=True) chip_info = result.stdout # 获取Flash信息 result = subprocess.run(['esptool.py', '--port', port, 'flash_id'], capture_output=True, text=True) flash_info = result.stdout # 解析关键信息 chip_type = re.search(r'Chip is (ESP32-\w+)', chip_info) flash_size = re.search(r'Detected flash size: (\w+)', flash_info) return { 'chip_type': chip_type.group(1) if chip_type else 'Unknown', 'flash_size': flash_size.group(1) if flash_size else 'Unknown', 'port': port } except Exception as e: return {'error': str(e), 'port': port} # 示例使用 if __name__ == '__main__': ports = ['COM3', 'COM4'] # 假设的端口列表 for port in ports: print(f"检测 {port}: {detect_esp32(port)}")

这个脚本可以扩展为完整的硬件检测工具，集成到CI/CD流程中，确保开发团队使用的硬件规格一致。