前言

前段时间乐鑫CEO在小红书免费发放ESP32-S31开发板，有幸得到了一块，今天上手搭了一下环境，特别记录一下。

安装IDF

我以前使用ESP32芯片，基本都是用Arduino IDE，这次是初次尝试ESP-IDF。官方的文档在快速入门 - ESP32-S31 - — ESP-IDF 编程指南 latest 文档，需要注意的是目前只有master版本才支持ESP32-S31，其他稳定版本都不支持。

我使用的是Windows 命令行版本进行安装的。先安装EIM：

winget install Espressif.EIM-CLI

然后使用下面的命令进行安装：

eim wizard

安装时只选择ESP32 S31芯片即可，这样就只下载master版本，不会下载其他用不到的版本。安装的过程比较长，因为要现在大量工具和组件，最后看到下面的显示就表示成功了。

Successfully installed IDF

运行Hello World示例

配置芯片类型

ESP-IDF 安装完成后，EIM 会在桌面上创建 快捷方式，用于启动已激活 ESP-IDF 环境的终端。
点击 IDF_master_Powershell 快捷方式，打开已设置好环境的 PowerShell 终端。至此，已成功在终端中激活 ESP-IDF 环境。后续所有 ESP-IDF 相关命令都需在已激活的终端中运行。

我们首先编译和现在官方的例子helloworld。

cd D:\esp\master\esp-idf\examples\get-started\hello_world
idf.py --preview set-target esp32s31

目前S31芯片还属于预览阶段，官方文档没有提到，必须在idf.py后面加上--preview参数，否则IDF会按照ESP32芯片来生成工程代码，会导致错误。

编译

然后使用下面的命令进行编译：

idf.py build

如果一切正常，编译完成后将生成 .bin 文件。

烧录

运行以下命令，将刚刚生成的二进制文件烧录至 ESP32-S31 开发板：

idf.py -p COM4 flash

如果一切顺利，烧录完成后，开发板将会复位，应用程序 "hello_world" 开始运行。

监视输出

可以使用 idf.py -p COM4 monitor 命令，监视 “hello_world” 项目的运行情况。运行该命令后，IDF 监视器 应用程序将启动。

总结

至此程序运行成功，总体还是比较顺利。

BTW，如果想刷回出厂的固件，可以参考esp-dev-kits/examples/esp32-s31-korvo at master · espressif/esp-dev-kits。