BananaPi BPI-Leaf-S3的正确吃法之ESP-IDF的安装

本系列旨在交流 ESP32-S3 硬件开发环境的搭建,通过一些基本的示例来展示怎么用 ESP-IDF (Espressif IoT Development Framework) 来安装、配置环境,并编译、下载固件至 ESP32-S3 开发板等步骤。如果有什么没提到或者有问题的,欢迎各位留言交流。

原文链接: BananaPi BPI-Leaf-S3的正确吃法之ESP-IDF的安装-Qubot科技

作者:Qubot

前言

ESP-IDF是一个面向ESP32系列的官方开发框架,用于开发嵌入式应用程序。目前ESP-IDF已经支持了很多芯片,下面是具体的型号。

最新的支持列表在这里 获取

安装前的准备

必备硬件

  • BPI-Leaf-S3开发板:购买链接(其他ESP32板子也可以)

Leaf-S3

  • USB 数据线 (USB-A 转 Type-C)

  • 电脑(Windows、Linux 或 macOS都可以)

必备软件

在安装ESP-IDF之前,需要安装一些必要的软件:

  • Git:用于从GitHub上克隆ESP-IDF存储库。

  • Python:ESP-IDF需要Python 3.5或更高版本。

  • CMake:用于生成构建文件。

Windows系统

在Windows系统中,可以从以下链接下载和安装这些软件:

Git: Git - Downloading Package

Python: https://www.python.org/downloads/windows/

CMake: Download | CMake

Linux系统

在Linux系统中,可以使用以下命令来安装这些软件(Linux下我没有装过,这里是根据官方文档加上的):

  • Ubuntu 和 Debian:

sudo apt-get install git wget flex bison gperf python3 python3-venv python3-setuptools cmake ninja-build ccache libffi-dev libssl-dev dfu-util libusb-1.0-0

  • CentOS 7 & 8(官方这里说为了好的体验建议用CentOS 8):

sudo yum -y update && sudo yum install git wget flex bison gperf python3 python3-setuptools cmake ninja-build ccache dfu-util libusbx

  • Arch:

sudo pacman -S --needed gcc git make flex bison gperf python cmake ninja ccache dfu-util libusb

MacOS系统

在MacOS中,需要先安装一个HomeBrew(MacPorts也行,不过没试过)


brew install cmake ninja dfu-util

或者(MacPorts下)


sudo port install cmake ninja dfu-util

如果你想加快编译速度,需要装一个ccache


brew install ccache

或者(MacPorts下)


sudo port install ccache

安装

我这里是基于VS Code的安装,所以首先需要再安装一个VS Code,下载地址:Visual Studio Code

安装完成之后,单击 Visual Studio Code 一侧活动栏中的扩展图标,打开扩展视图或者快捷键Ctrl+Shift+X,Mac下是⇧+⌘+X),并在搜索框内输入idf搜索,下面第一个就是,点击Install安装,并等待右下角加载完

Search_idf

点击右上角的View > Command Palette(或者Ctrl+Shift+P,Mac下是⇧+⌘+P),输入ESP-IDF: Configure(不分大小写)并选择第一个

接下来就是开始下载选择ESP-IDF安装在哪里,点击EXPRESS选择快速安装(或者如果你已经安装了 ESP-IDF,则使用现有设置,选择第三个)

这一步是选择下载源(Github还是Espressif),IDF的版本(这里我选择的是5.0.1),IDF容器的路径(这里是Docker安装?)以及IDF工具的路径,选好之后点Install

接下来等待安装完成就行了,如果你在国内,可能会遇到网络故障问题,需要你自备工具解决,如果没有的话就反复安装就行。(或者选择spressif源试试?这个我没试过)

安装结束之后,会如图显示All settings have been configured. You can close this window.

总结

ESP-IDF的安装不难,主要是网络问题,国内用户可能会反复安装好几次,其他的不会有什么大的问题。