ESP32入门 - 介绍与环境搭建

一、什么是 ESP32

ESP32 是一款由乐鑫（Espressif Systems）推出的高性能、低功耗的 Wi-Fi 和蓝牙双模芯片。它广泛应用于物联网（IoT）领域，支持多种通信协议，具备强大的处理能力和丰富的外设接口，是开发智能硬件的理想选择。

二、为什么选择 ESP-IDF 开发环境

1. C/C++ 开发
   使用 C/C++ 编程语言进行开发，性能高效且灵活。

2. 官方主推，更新维护频繁
   ESP-IDF（Espressif IoT Development Framework）是乐鑫官方主推的 SDK，支持最新的特性和功能，同时定期修复 BUG，保持良好的稳定性。

3. 实际项目需求，固件运行速度更快
   相较于其他开发框架，ESP-IDF 提供了更接近底层的控制能力，能够最大化利用 ESP32 的硬件性能，满足对运行速度有较高要求的项目。

三、常见的 ESP32 型号

四、ESP32 开发环境搭建

1. 安装 VMware 和 Ubuntu 系统

• 下载 Ubuntu Server 镜像文件：
  ubuntu-20.04.6-server-amd64.iso
• 在 VMware 中安装 Ubuntu 虚拟机系统，并确保安装 OpenSSH 服务器，以便后续远程连接。
  

2. 安装网络工具

在 Ubuntu 系统中安装网络工具以查看虚拟机的 IP 地址：

sudo apt-get install net-tools

安装完成后，输入以下命令查看虚拟机的 IP 地址：

ifconfig

3. 使用 MobaXterm 登录 Ubuntu 系统

1. 下载并安装 MobaXterm_Personal_24.0。

2. 打开 MobaXterm，点击 Session，选择 SSH 协议。
   
   

3. 输入虚拟机的 IP 地址和用户名，点击连接。
   

4. 输入虚拟机的密码，即可在 Windows 中打开 Ubuntu 终端界面。

4. 拉取 ESP-IDF

(1) 安装必要的工具

运行以下命令安装必备的依赖工具：

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

(2) 新建 ESP32 目录

mkdir esp32
cd esp32

(3) 拉取 Gitee 工具

git clone https://gitee.com/EspressifSystems/esp-gitee-tools.git

(4) 执行镜像切换脚本

cd esp-gitee-tools
./jihu-mirror.sh set

(5) 拉取 ESP-IDF 源码

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

(6) 切换到指定版本分支（如 v5.2）

cd esp-idf
git checkout v5.2
git submodule update --init --recursive

如果提示失败或错误，可以尝试运行以下命令：

../esp-gitee-tools/submodule-update.sh

(7) 更换 pip 源

为了加快 Python 包的下载速度，建议更换为阿里云的 pip 源：

pip config set global.index-url http://mirrors.aliyun.com/pypi/simple
pip config set global.trusted-host mirrors.aliyun.com

(8) 安装编译工具

../esp-gitee-tools/install.sh

(9) 设置环境变量

将环境变量添加到 .bashrc 文件中：

source export.sh
echo "source ~/esp32/esp-idf/export.sh" >> ~/.bashrc

(10) 下载课程配套源码

cd ~/esp32
git clone --recursive https://gitee.com/vi-iot/esp32-board.git

(11) 编译示例工程

进入示例工程目录并编译：

cd esp32-board/helloworld
idf.py build

---

5. 设置 USB 串口权限

为了让 Ubuntu 系统识别 USB 串口设备，需设置权限：

sudo usermod -aG dialout <username>

注意：将 <username> 替换为你的实际用户名。

设置完成后，重启系统：

sudo reboot

五、使用 VS Code 编辑器

1. 下载并安装 VS Code

从 VS Code 官网 下载并安装编辑器。

2. 安装插件

安装以下插件以支持 ESP-IDF 开发：

• C/C++
• ESP-IDF

提示：安装完成后建议重启 VS Code，确保插件生效。

3. 连接远程主机

通过 VS Code 连接到 Ubuntu 系统，并打开 helloworld 工程目录。




如果不装这两个插件，我们看代码没法跳转 ，装好后最好重启一下VSCode，重复上述步骤登录ubuntu和打开helloworld文件夹

4. 添加 ESP-IDF 配置

按下 Ctrl+Shift+P，弹出搜索框，输入以下命令：

ESP-IDF: Add vscode Configuration Folder

点击后，该操作会将 ESP-IDF 的源码路径添加到工程中，使你能够通过按住 Ctrl 键点击函数或变量进行代码跳转。

六、总结

通过以上步骤，你已经成功搭建了基于 ESP-IDF 的 ESP32 开发环境，并完成了基础的编译和配置工作。接下来，你可以开始探索更多 ESP32 的功能与应用，打造属于自己的物联网项目！

如有任何问题，欢迎参考官方文档或社区资源：

• ESP-IDF 官方文档
• 乐鑫开发者论坛