陈拓 2021/01/27-2021/12/30
1. 概述
在《用乐鑫国内镜像构建ESP8266_RTOS_SDK开发环境》
https://zhuanlan.zhihu.com/p/347711847
一文中我们用乐鑫在国内的Gitee镜像搭建了ESP8266开发环境，下面我们在此基础上搭建ESP32的开发环境。
2. 安装准备
见《Win10-Ubuntu子系统构建ESP8266_RTOS_SDK开发环境》
https://zhuanlan.zhihu.com/p/346072018
一文。
3. 获取 ESP-IDF
3.1 esp-idf的下载网址
乐鑫已经在gitee上有了国内镜像，网址是：
https://gitee.com/EspressifSystems
3.2 安装方法
注意：Gitee 中ESP-IDF仓库的使用，请先参看https://gitee.com/EspressifSystems/esp-gitee-tools中的说明文档。
3.3 克隆 esp-idf
cd ~/esp
git clone https://gitee.com/EspressifSystems/esp-idf.git
ESP-IDF 将下载至 ~/esp/esp-idf。
注意：仅克隆 esp-idf，不包含子模块。即git 命令不带 --recursive 参数。
3.4 安装扩展工具esp-gitee-tools
在《阿里云ECS搭建ESP8266_RTOS_SDK开发环境》
https://zhuanlan.zhihu.com/p/346975777
一文中我们已经安装了扩展工具esp-gitee-tools。
我们下面用esp-gitee-tools来安装esp-idf开发工具和子模块。
https://gitee.com/EspressifSystems/esp-gitee-tools/blob/master/docs/README-install.md
3.5 将pip源换到国内
查看我的pip版本：
用别名将pip3设置为默认的pip：
echo alias pip=pip3 >> ~/.bashrc
source ~/.bashrc
pip 20.0.2 > 10.0.0，满足条件。
pip config set global.index-url http://mirrors.aliyun.com/pypi/simple
pip config set global.trusted-host mirrors.aliyun.com
3.6 安装工具子模块
除了ESP-IDF本身，还需要安装ESP-IDF使用的各种工具，比如编译器、调试器、Python包等。
注意：不要使用ESP-IDF自带的install.sh，使用esp-gitee-tools内的 install.sh。
进入 esp-gitee-tools 目录，export install.sh 所在路径，方便后期使用：
cd ~/esp/esp-gitee-tools
export EGT_PATH=$(pwd)
测试环境变量：echo $EGT_PATH
进入 esp-idf 目录：
cd ~/esp/esp-idf
$EGT_PATH/install.sh
很快就安装安装完了。
提示pip可以升级：
/home/ccdc/.espressif/python_env/idf4.3_py3.8_env/bin/python -m pip install --upgrade pip
3.7 安装更新子模块 submodules
$EGT_PATH/submodule-update.sh
安装顺利。
3.8 设置环境变量
编辑文件.bashrc
nano ~/.bashrc
- 将alias get_idf='. $HOME/esp/esp-idf/export.sh'添加到最后一行。
注意，命令开始的 “.” 与路径之间应有一个空格！
注意：要将我们之前安装ESP8266开发环境时设置的环境变量：
export IDF_PATH=~/esp/ESP8266_RTOS_SDK
前面加#号注释掉。
- 将ESP-IDF 中的tools/目录加入PATH环境变量中
export PATH=/home/ccdc/esp/esp-idf/tools:$PATH
保存，退出。重启终端窗口。
- 查看别名alias
- 查看环境变量echo $PATH
3.9 刷新esp-idf环境
get_idf
为Python设置一个别名：
echo alias Python=python >> ~/.bashrc
source ~/.bashrc
测试：
再刷新esp-idf环境：
get_idf
4. 开始创建项目工程
https://docs.espressif.com/projects/esp-idf/zh_CN/stable/esp32/get-started/
cd ~/esp
cp -r esp-idf/examples/get-started/hello_world/ .
或者cp -r $IDF_PATH/examples/get-started/hello_world .
5. 连接设备
我用的是网上买的下面这种开发板，加上ESP32模块。
插上USB线后我PC识别了CP2102：
惊叹号表示驱动未安装。
安装CP2102驱动：
上SILICON LABS官网下载驱动。
https://www.silabs.com/developers/usb-to-uart-bridge-vcp-drivers
CP210x_Universal_Windows_Driver.zip
解压缩，安装。
运行
完成。
我PC将USB-SERIAL识别为COM5。
6. 配置项目
快速入门 - ESP32 - — ESP-IDF 编程指南 v4.3.2 文档
cd ~/esp/hello_world
idf.py menuconfig
进入配置工具界面：
保持默认，退出。
- 编译项目
https://gitee.com/EspressifSystems/esp-idf
编译应用程序，引导程序，并根据配置生成分区表。
idf.py build
- 烧写项目
连接设备时我PC将USB-SERIAL识别为COM5。
idf.py -p /dev/ttyS5 -b 115200 flash
9. 擦除Falsh
正常情况下跳过这一步。
如果烧写出现错误，可以先擦除Flash试试。
idf.py -p /dev/ttyS5 -b 115200 erase_flash
10. 用串口调试助手查看程序运行结果
串口调试助手的使用请看《Win10使用CH340 USB-SERIAL串口》
https://zhuanlan.zhihu.com/p/343013801
