如何烧录原生固件

note

本文档由 AI 翻译。如您发现内容有误或有改进建议，欢迎通过页面下方的评论区，或在以下 Issue 页面中告诉我们：https://github.com/Seeed-Studio/wiki-documents/issues

SenseCAP 指示器拥有两个MCU，分别是 ESP32-S3 和 RP2040。本教程提供了全面的指导，帮助开发者快速上手，包括烧录开箱即用的原生工厂固件以及将早期出厂设备更新到最新固件。

固件更新特别适用于以下两种场景：

如果您在 2023 年 6 月之前购买了没有 OpenAI 固件的产品，固件版本为 1.0.0，您可以下载并更新到包含 OpenAI 功能的最新固件。最新固件可从这里下载。
如果您开发了一个应用程序并希望烧录自定义固件，可以按照下面提供的教程进行操作。

简而言之，您需要本教程，因为：

您有一个固件需要烧录到 ESP32-S3 或 RP2040。
您修改了代码，需要编译并烧录到设备。

让我们开始本教程。

准备工作

开始之前，您只需要准备您的 SenseCAP 指示器和一台 Windows/Mac/Linux 电脑。

获取原生固件

SenseCAP 指示器的默认出厂固件是完全开源的，适用于 ESP32-S3 和 RP2040。

您有两种方式获取开箱即用的固件：

源码： 在烧录之前，您可以根据需求修改代码。您需要一个工具链（ESP-IDF、Arduino）来编译代码。
固件： 直接烧录预编译的二进制文件，无需任何代码修改或编译。可以使用 Esptool 和 Flash Download Tools 等工具。

源码

固件

针对 ESP32-S3

ESP-IDF

ESP-IDF（Espressif IoT Development Framework）是由 Espressif Systems 提供的软件开发框架，用于专门设计适用于其 ESP32 和 ESP8266 系列微控制器的固件和应用程序。有关更多信息，您可以参考 ESP-IDF 编程指南。

如果您选择将源码编译成固件，则需要使用 ESP-IDF 来完成编译过程。

注意：

ESP-IDF 版本必须大于 v5.0。如果您使用的是旧版本，则需要更新到最新版本。

对于新用户，以下视频可能会帮助您更好地理解以下步骤：

工具链安装

Windows
Linux 和 MacOS

官方 Espressif 文档：Windows 工具链标准设置

选项 1：使用离线安装程序

对于 Windows 用户，您可以直接下载 ESP-IDF 离线安装程序。以下是直接下载链接：🖱️下载离线安装程序 v5.1.1

选项 2：使用推荐的脚本

请参考使用命令提示符

官方 Espressif 文档：Linux 和 macOS 工具链标准设置

如果您使用 Linux 或 MacOS，可以按照以下指南更改 git 仓库版本。

git clone --recursive https://github.com/espressif/esp-idf.git

导航到 esp-idf 目录：

运行 ./install.sh esp32s3，以添加 ESP32-S3 支持（SenseCAP 指示器需要）。
输入 ./export.sh，以在当前终端会话中设置 PATH 和 IDF_PATH 变量。

如果您希望在任何 shell 会话中调用，可以将以下行添加到您的 shell 配置文件（例如 ~/.bash_profile）：

alias get_idf='. $HOME/esp/esp-idf/export.sh'

然后您可以使用 get_idf 激活环境。^refer

构建项目并烧录

如果您选择将源码编译成固件，则需要使用 ESP-IDF 来完成编译过程。

要构建、烧录并监控您的项目，请执行以下命令：

cd  <your_sdk_path>/examples/indicator_basis/
idf.py -p PORT build flash monitor

tip

如果没有指定 PORT，IDF 将自动选择可用的端口。

到目前为止，通过输入命令 idf.py -p PORT flash，固件已经成功烧录到 ESP32-S3 上。

Esptool

ESPtool - GitHub 是一个基于 Python 的开源工具，提供了一种跨平台的方式与 Espressif 芯片中的 ROM 引导程序通信。

Esptool 可以作为 Python 脚本的一部分使用。在本指南中，我们将使用 Esptool 发布页面上提供的 打包软件。请选择与您计算机操作系统对应的软件。

使用 Esptool 烧录固件

以下提供了两个脚本，展示了如何有效利用 Esptool 将固件烧录到 ESP32-S3 微控制器上。

注意:

请注意，提供的脚本是为 Windows 操作系统量身定制的。如果您使用的是其他操作系统，则需要根据您的环境调整脚本。

merge.bat 脚本特别有用，它可以智能地将引导程序、分区表和基础指示器二进制文件合并为一个固件文件。合并后，可以使用 flash.bat 脚本将该固件无缝烧录到 ESP32-S3 上。当提示时，输入与您的设备对应的 COM 端口，烧录过程将开始。完整操作总结如下：

merge.bat
esptool.exe --chip esp32s3 ^
merge_bin -o sensecap_indicator_basis_v1.0.0.bin ^ # 目标文件名
--flash_mode dio ^
--flash_size 8MB ^
0x0 ../../build/bootloader/bootloader.bin ^
0x8000 ../../build/partition_table/partition-table.bin ^
0x10000 ../../build/indicator_basis.bin

或者，如果您更喜欢分别烧录二进制文件而不是合并后再烧录，可以直接使用 just_flash.bat 脚本：

just_flash.bat
esptool.exe --chip esp32s3 --port COMx --baud 921600 write_flash -z ^
0x0 ../../build/bootloader/bootloader.bin ^
0x8000 ../../build/partition_table/partition-table.bin ^
0x10000 ../../build/indicator_basis.bin

对于使用合并固件进行简单烧录的过程：

flash.bat

esptool.exe --chip esp32s3 --port COMx --baud 921600 write_flash -z 0x0 indicator_basis_v1.0.0.bin

特别注意起始地址（0x0），尤其是在不合并二进制文件的情况下。对于单独的二进制文件，请参考单独二进制文件的烧录工具说明。遵循这些指南可以确保烧录无误。

要使用这些脚本，请将代码保存为项目文件夹中的 merge.bat 和 flash.bat 两个单独的文本文件。这种组织方式简化了访问和使用。

通过使用这些脚本，您可以简化固件准备和烧录阶段，从而实现更顺畅、更可靠的流程。

├── indicator_basis
│   ├── CMakeLists.txt
│   ├── build
│   ├── docs
│   ├── main
│   ├── partitions.csv
│   ├── sdkconfig
│   └── .defaults
│   └── flash.bat
│   └── merge.bat

使用 merge.bat 合并二进制文件。
使用 flash.bat 烧录合并后的固件。

烧录固件

要烧录固件，可以使用提供的 flash.bat 脚本。此脚本旨在简化将固件烧录到 ESP32-S3 微控制器的过程。

显示 flash.bat 代码

```bat @echo off setlocal cd /d "%~dp0" :: 设置芯片 set chip=esp32s3 :: 设置波特率 set baud=921600 :: 列出 COM 端口 echo 可用端口和设备： echo. for /F "tokens=* delims=" %%A in ('wmic path Win32_PnPEntity get Name ^| findstr /C:"COM" ^| findstr /C:"CH340"') do ( echo %%A ) :: 提示输入端口 :chooseport echo. echo 请输入要使用的 COM 端口（例如：COM5）： set /p port= :: 检查选择的端口是否有效并包含 "CH340" for /F "tokens=* delims=" %%A in ('wmic path Win32_PnPEntity get Name ^| findstr /C:"%port%" ^| findstr /C:"CH340"') do ( set device=%%A goto :flash ) echo 端口 %port% 未找到 goto :chooseport :flash:: 打印选择的参数 echo. echo 您选择了： echo 芯片: %chip% echo 端口: %port% - %device% echo 波特率: %baud% @REM echo 按任意键继续... @REM pause >nul :: 使用单个文件运行 esptool esptool.exe --chip %chip% --port %port% --baud %baud% write_flash -z 0x0 indicator_basis_v1.0.0.bin if ERRORLEVEL 1 ( echo 使用单个文件烧录失败，错误代码 %ERRORLEVEL%。 goto :end ) :: 脚本结束 :end endlocal ```

合并二进制文件

提供的 merge.bat 脚本可用于将必要的二进制文件合并为一个固件文件。此脚本简化了流程并确保正确合并，从而成功烧录，允许您烧录单个 bin 文件，而无需分别烧录文件。

显示 merge.bat 代码

```bat @echo off SETLOCAL SET CurrentDir=%cd% SET ScriptDir=%~dp0 SET CurrentDir=%CurrentDir:~0,-1% SET ScriptDir=%ScriptDir:~0,-1% IF NOT "%CurrentDir%"=="%ScriptDir%" ( cd /d "%ScriptDir%" ) esptool.exe --chip esp32s3 ^ merge_bin -o indicator_basis_v1.0.0.bin ^ --flash_mode dio ^ --flash_size 8MB ^ 0x0 ../../build/bootloader/bootloader.bin ^ 0x8000 ../../build/partition_table/partition-table.bin ^ 0x10000 ../../build/indicator_basis.bin ENDLOCAL ```