使用esptool手动刷写Willow固件及NVS分区配置指南

背景介绍

Willow是一个开源的智能语音助手项目，基于ESP32-S3芯片开发。在标准部署流程中，官方推荐使用Web Flash工具进行固件刷写和配置。然而，当Web Flash工具出现兼容性问题时，开发者需要掌握手动刷写方法。

常见问题分析

许多开发者在Linux平台上使用Chrome浏览器时遇到了Web Flash工具无法正常工作的问题，主要表现为无法读取BOOTLOADER_FLASH_OFFSET属性。这种情况下，手动使用esptool工具刷写成为必要的替代方案。

解决方案详解

基础固件刷写步骤

1. 首先安装esptool工具：

pip install esptool

2. 使用以下命令刷写基础固件：

python3 -m esptool --port /dev/ttyACM0 write_flash 0x0 willow-dist-ESP32-S3-BOX.bin

NVS分区配置关键

仅刷写基础固件会导致设备无法正常启动，因为缺少关键的WiFi和WAS(Web Audio Service)配置信息。这些配置存储在NVS(Non-Volatile Storage)分区中，需要单独处理。

NVS分区生成方法

1. 准备CSV配置文件(nvs.csv)，内容如下：

key,type,encoding,value
WAS,namespace,,
URL,data,string,你的WAS服务地址
WIFI,namespace,,
PSK,data,string,你的WiFi密码
SSID,data,string,你的WiFi名称

2. 使用ESP-IDF提供的工具生成NVS分区镜像：

docker run -v$PWD/nvs.csv:/nvs.csv -v$PWD/nvs.bin:/nvs.bin espressif/idf \
/opt/esp/idf/components/nvs_flash/nvs_partition_generator/nvs_partition_gen.py \
generate --version 2 nvs.csv nvs.bin 0x24000

3. 刷写NVS分区到设备：

python3 -m esptool --port /dev/ttyACM0 write_flash 0x9000 nvs.bin

注意事项

1. NVS分区大小(0x24000)需要与设备分区表匹配
2. WAS URL必须包含协议头(如https://)
3. 刷写顺序建议为先基础固件后NVS分区
4. 确保使用正确的串口设备路径

排错技巧

若设备启动后出现网络连接问题，可通过串口日志检查：

• "disconnected from AP"表示WiFi配置问题
• "failed to open NVS namespace"表示NVS分区格式错误
• "Fatal error! Failed to read NVS partition"表示分区未正确刷写

通过以上步骤，开发者可以完全脱离Web Flash工具，实现Willow固件的手动部署和配置。这种方法不仅解决了Web工具的兼容性问题，也为自动化部署提供了可能。