模板: ESP32-development environment-setup

来自Waveshare Wiki
跳转至： 导航、 搜索

环境搭建

ESP-IDF下使用

以下开发系统默认为Windows，推荐使用VSCode插件进行开发

ESP-IDF

  • 推荐使用VSC插件进行开发

使用VSCode插件开发

安装VSCode
  1. 打开VSCode官网的下载页面，选择对应系统和系统位数进行下载
    Esp32-vscod-01.jpg
  2. 运行安装包后，其余均可以默认安装，但这里为了后续的体验建议，建议在此处勾选框中的1、2、3项
    Esp32-vscod-02.jpg
    • 第一二项开启后，可以直接通过鼠标右键文件或者目录打开VSCode，可以提高后续的使用体验.
    • 第三项开启后，选择打开方式时，可以直接选择VSCode

安装Espressif IDF插件

  • 注：当前插件最新版本为V1.6.0，为体验一致，用户可以选择与我们一样的版本
  1. 打开VSCode,使用快捷键Shift+Ctrl+X，进入插件管理器
    Esp32-vscod-03.jpg
  2. 在搜索栏中，输入Espressif IDF，选择对应的插件点击 install即可
    Esp32-vscod-04.jpg
  3. 使用快捷键F1，输入
    esp-idf: configure esp-idf extension

    Esp32-vscod-05.jpg
  4. 选择express（此教程针对第一次安装的用户，故只讲述初次的通用安装教程）Esp32-vscod-06.jpg
  5. 打开后显示该界面
    Esp32-vscod-07.jpg
  6. 选择下载服务器，我们推荐国内用户使用Espressif作为你的下载服务器
    Esp32-vscod-08.jpg
  7. 选择想要现在的ESP-IDF版本，我们选择最新的V5.0.1(注意ESP-IDF从V4.4版本后才开始支持ESP32-S3)
    Esp32-vscod-09.jpg
  8. 下面两个分别为ESP-IDF容器安装地址和ESP-IDF所需的工具安装地址，
    Esp32-vscod-10.jpg
    • 注意：如果之前有安装过ESP-IDF，或者失败过的，请务必彻底删除文件或者创建全新的无中文路径
  9. 配置完成后，点击 install 进行下载
    Esp32-vscod-11.jpg
  10. 进入下载页面，其会自动安装对应工具与环境，稍等片刻即可
    Esp32-vscod-11.jpg
  11. 安装完成后，会进入以下界面，说明安装完成
    Esp32-vscod-13.jpg

使用官方例程

  • ESP官方为我们提供大量的例程,并且写详细的使用方法与效果，点击此处查看
创建例程
  1. 使用快捷键F1，输入
    esp-idf:show examples projects

    Esp32-vscod-14.jpg
  2. 选择你当前的IDF版本
    Esp32-vscod-15.jpg
  3. 以Hello world例程为例
    Esp32-vscod-16.jpg
  4. ①选择对应例程
  5. ②其readme会说明该例程适用于什么芯片（下文有介绍例程怎么使用与文件结构，这里略）
  6. ③点击创建例程
  7. 选择放置例程的路径，要求无例程同名文件夹
    Esp32-vscod-17.jpg
修改COM口
  1. 此处显示使用对应的COM口，点击可以修改对应COM口
    Esp32-vscod-18.jpg
  2. 我们的CH343的COM为COM5，所以我们选择COM5，请根据自己CH343对应COM口进行选择
    Esp32-vscod-19.jpg
  3. 选择使用的工程或者例程
    Esp32-vscod-20.jpg
  4. 然后我们的COM口就修改好了
修改驱动对象
  1. 此处显示的是使用的驱动对象，点击可以修改对应驱动对象
    Esp32-vscod-21.jpg
  2. 选择使用的工程或者例程
    Esp32-vscod-20.jpg
  3. 点击后需要稍等片刻
    Esp32-vscod-22.jpg
  4. 选择我们需要驱动的对象，也就是我们的主芯片为ESP32S3
    Esp32-vscod-23.jpg
  5. 选择openocd的路径，这里对我们没有影响，所以我们随便选择一个即可
    Esp32-vscod-24.jpg
其余状态栏简介

Esp32-vscod-25.jpg

  • ①SDK 配置编辑器，ESP-IDF很多功能与配置可以在其内修改
  • ②全部清理，清空所有编译文件，
  • ③编译
  • ④当前下载方式，默认为UART
  • ⑤烧录当前固件，请在编译后进行
  • ⑥打开串口监视器，用于查看串口信息
  • ⑦编译，烧录，打开串口监视器 一体按键（调试时最常用）
编译、烧录、串口监视
  1. 点击我们之前介绍的 编译，烧录，打开串口监视器按键
    Esp32-vscod-29.jpg
  2. 编译可能需要较长时间才能完成，尤其是在第一次编译时。
    Esp32-vscod-26.jpg
    • 在此过程中，ESP-IDF可能会占用大量CPU资源，因此可能会导致系统卡顿。
  3. 因为我们使用的是CH343为USB转串口芯片，并且板载自动下载电路，无需手动操作即可自动下载
    Esp32-vscod-27.jpg
  4. 下载成功后，自动进入串口监视器，可以看到芯片输出对应的信息并提示10S后重启
    Esp32-vscod-28.jpg

Arduino下使用

  • 如果没用使用过arduino-esp32的基础建议仔细阅读官方文档，点击此处查看

安装Arduino IDE

  1. 打开官网软件下载页面,选择对应的系统和系统位数下载
    ESP32-S3-Pico-Ar-01.jpg
  2. 可以选择直接下载，也可以选择捐赠并下载
    ESP32-S3-Pico-Ar-02.jpg
  3. 运行安装程序，全部默认安装即可

在线安装arduino-esp32

  1. 打开首选项
    ESP32-S3-Pico-Ar-03.jpg
  2. 添加对应的板管理链接，点击该按键
    ESP32-S3-Pico-Ar-04.jpg
  3. 在第一个空白处，添加下文
    https://raw.githubusercontent.com/espressif/arduino-esp32/gh-pages/package_esp32_index.json

    ESP32-S3-Pico-Ar-05.jpg
  4. 保存设置
  5. 打开板管理器并搜索输入ESP32,选择版本2.0.11
    ESP32-S3-Pico-Ar-06-240708.png
  6. 等待下载
    ESP32-S3-Pico-Ar-07.jpg
  7. arduino-esp32下载完成
    ESP32-S3-Pico-Ar-08.jpg

使用Arduino例程

  1. 选择例程，这里我们选择获取芯片ID的例程
    ESP32-S3-Pico-Ar-09.jpg
  2. 选择我们的板子为 ESP32S3 Dev Moudule
    ESP32-S3-Pico-Ar-12.jpg
  3. 选择我们的端口号，这里我们选择CH343的COM5
    ESP32-S3-Pico-Ar-13.jpg
  4. 点击下载按键,此时会自动编译并下载
    ESP32-S3-Pico-Ar-14.jpg
  5. 下载完成
    ESP32-S3-Pico-Ar-15.jpg
  6. 打开串口监视器
    ESP32-S3-Pico-Ar-16.jpg
  7. 看到循环输出的芯片ID
    ESP32-S3-Pico-Ar-17.jpg

特别说明:本产品使用USB连接Type-C，如若出现不能输出芯片信息的情况，请将代码中Serial.print字样的函数修改为printf函数直接输出到USB上

取自“https://www.waveshare.net/w/index.php?title=模板:ESP32-development_environment-setup&oldid=114360”