ESP32-S3 环境搭建

ESP32-S3 环境搭建

之前因为小智AI购买的ESP32-S3板子,买来一直吃灰,最近有时间研究下,发现Arduino好弄,但是IDF setup 还是需要点时间的

I. 产品来源

淘宝购买 ESP32-S3 N16R8

II. 环境搭建

由于ESP32 windows下编译效率比较低,所以我选择的ubuntu主机和windows remote方式来实现的编译调试。
以下分为ubuntu安装步骤和windows 的ssh步骤分别介绍

1. ubuntu 系统安装要求及步骤

  • 使用的ubuntu系统: Ubuntu 24.04.4 LTS
  • 安装eim
# step 1 添加乐鑫软件镜像源到ubuntu apt list
echo "deb [trusted=yes] https://dl.espressif.com/dl/eim/apt/ stable main" | sudo tee /etc/apt/sources.list.d/espressif.list
sudo apt update 

# step 2 安装eim
sudo apt install eim

# setp 3 启动eim
eim
  • 启动eim后,点击新安装,再选择简易安装即可,静待安装完成
  • 由于usb系统需要添加allow list 所以需要将如下list添加入ubuntu的路径/etc/udev/rules.d/60-openocd.rules 路径官方参考文件路径[1]
  • 添加完成后执行以下命令[1:1]
sudo udevadm control --reload-rules
sudo udevadm trigger
sudo udevadm trigger

2. windows 系统安装要求

  • 安装vscode

  • 在vscode 安装remote ssh

  • 通过remote ssh 连接ubuntu主机.

  • 连接成功后,在vscode 连接成功界面添加插件ESP-IDF 插件

  • 插件安装完成,点击侧边栏,选择Advanced折叠标签,选择新项目向导

  • 新建hello world 工程

  • 进入工程后,在Vscode下方工具条,分别点选红框选项

      1. USB-JTAG
      1. USB 选择带Espressif的tty,如果没有参照ai-node进行配置安装
      1. device选择esp32s3
  • windows 按F1,创建ESP-IDF VSCODE configure文件

  • 打开OpenOCD,这里我有踩到一个坑,如果openocd打开失败,可以在ubuntu系统执行指令 lsusb, 如果显示的303a:4001则说明芯片现在boot的模式由固件接管,那么openocd无法执行调试,此问题解决方式也简单,按照如下步骤

      1. 拔下usb
      1. 按住板子上的boot按键,插上usb,此时boot按键不要松开
      1. 按以下rst按键,此时boot键也不要松开
      1. 松开boot按键
      1. 再在ubuntu系统执行lsusb,就可以看到设备标识编程303a:1001了,这个状态下再去startopenocd,就可以实现调试了。

III. 以上步骤都执行完,就可以实现观察代码的编译和调试了

  • 点击VSCODE下方的编译按钮编译新建的工程
  • 点击调试按钮即可看到debug界面了,不过这里的debug是无法实现vscode和debug断点的连接的

IV. 以上步骤完成,可能你点击单步执行,程序还是无法实现单步执行, 可能需要把编译等级改成-O0. 步骤如下

  • 打开vscode底部的open esp-idf terminal (打开esp-idf 终端)
  • 执行命令idf.py menuconfig
  • 选择Compiler Options → Optimization Level
  • 选择-O0
  • 键盘输入s. 保存配置并退出。

至此整个esp-idf 开发调试环境就setup完成,可以根据自己需求进行接下来的调试开发了。
我也试了是单独就在windows下开发编译,太慢了,实在是忍受不了。


  1. 最后这两步骤,此处仅需在ubuntu系统无法识别到usb设备时执行 ↩︎ ↩︎

posted on 2026-09-08 11:21  WinterLii  阅读(21)  评论(0)    收藏  举报

导航