阿里云ECS搭建ESP32开发环境

陈拓 2021/01/29-2021/02/03

1. 概述

在《用乐鑫国内Gitee镜像搭建ESP32开发环境》

https://zhuanlan.zhihu.com/p/348106034

https://blog.csdn.net/chentuo2000/article/details/113424934

一文中我们用乐鑫在国内的Gitee镜像搭建了ESP32开发环境，下面我们将ESP32的开发环境搭建到阿里云ECS服务器上。

2. 安装准备

https://docs.espressif.com/projects/esp-idf/zh_CN/stable/esp32/get-started/linux-setup.html

这一步，在《阿里云ECS搭建ESP8266_RTOS_SDK开发环境》

https://zhuanlan.zhihu.com/p/346975777

https://blog.csdn.net/chentuo2000/article/details/113173934

中已经做过了，可以看看其中的安装说明。

3. 获取 ESP-IDF

3.1 登录阿里云ECS

你可以使用Win10自带的ssh，也可以使用PuTTY，我用PuTTY。

查看阿里云上我的Linux系统版本：lsb_release -a

3.2 从github下载ESP-IDF

[https://docs.espressif.com/projects/esp-idf/zh_CN/stable/esp32/get-started/index.html#get-started-get-esp-idf]

3.2.1 下载ESP-IDF

git clone -b v4.2 --recursive https://github.com/espressif/esp-idf.git

ESP-IDF 将下载至 ~/esp/esp-idf。

3.2.2 设置工具

除了 ESP-IDF 本身，您还需要安装 ESP-IDF 使用的各种工具，比如编译器、调试器、Python 包等。

cd ~/esp/esp-idf

./install.sh

提示pip可以升级，我们先不管它。

查看安装的工具：

ls -l ~/.espressif/tools

3.2.3 设置环境变量

• 测试. $HOME/esp/esp-idf/export.sh

openocd-esp32没有安装。

• 安装openocd

openOCD是一个用于JTAG调试的开源软件。为了更好地适配 ESP32，乐鑫对 OpenOCD 做了改动，命名为openocd-esp32。网址是github.com/espressif/openocd-esp32。

要使用openocd-esp32必须通过源码编译安装，而我们现在在云端安装的开发工具并不能连接硬件进行JTAG调试，所以在这里我们安装一个标准的openocd，这样开发环境的安装工作就可以继续向下进行了。

cd ~/esp

sudo yum install openocd

查看openocd是否已经安装：

yum list installed openocd

• 再测试. $HOME/esp/esp-idf/export.sh

• 将环境变量写入脚本文件

测试成功后，我们将这行代码增加至~/.bashrc或者.bash_profile脚本中，这样就不用每次登录执行它了。

可以在~/.bashrc或者~/.bash_profile中设置环境变量。.bashrc在每次执行shell脚本的时候都会重新读取，可以立即生效，而~/.bash_profile只在登录的时候才读取一次。

我们在这里使用~/.bash_profile。

nano ~/.bash_profile

保存，退出。重新登录阿里云。

3.3 从乐鑫国内镜像gitee上下载ESP-IDF

从github上下载ESP-IDF很慢，不容易成功。现在从乐鑫国内镜像gitee上下载ESP-IDF，很快，但是有的麻烦。

3.3.1 网址

乐鑫已经在gitee上有了国内镜像，网址是：

https://gitee.com/EspressifSystems

3.3.2 安装方法

注意：Gitee 中ESP-IDF仓库的使用，请先参看https://gitee.com/EspressifSystems/esp-gitee-tools中的说明文档。

3.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.3.4 安装扩展工具esp-gitee-tools

在《阿里云ECS搭建ESP8266_RTOS_SDK开发环境》

https://zhuanlan.zhihu.com/p/346975777

https://blog.csdn.net/chentuo2000/article/details/113173934

一文中我们已经安装了扩展工具esp-gitee-tools。

我们下面用esp-gitee-tools来安装esp-idf开发工具和子模块。

https://gitee.com/EspressifSystems/esp-gitee-tools/blob/master/docs/README-install.md

3.3.5 将pip源换到国内

查看我的pip版本：

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.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

很快就安装安装完了。

3.3.7 安装更新子模块 submodules

$EGT_PATH/submodule-update.sh

安装顺利。

3.3.8 设置环境变量

见“3.2.3设置环境变量”。

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 .

• pip升级

/usr/bin/python -m pip install --upgrade pip

• 安装 Python 依赖库

python -m pip install -r requirements.txt

5. 配置项目

https://docs.espressif.com/projects/esp-idf/zh_CN/stable/esp32/get-started/

cd ~/esp/hello_world

idf.py menuconfig

需要CMake 3.5或更高版本，当前版本为2.8.12.2

• 升级CMake

1) 卸载原有的通过yum安装的cmake

yum remove cmake

2) 下载最新的cmake安装包

先看看最新版本：

https://github.com/Kitware/CMake/tags

下载1.19.4版本。

选择cmake-3.19.4-Linux-x86_64.tar.gz下载。

cd /opt

sudo wget https://github.com/Kitware/CMake/releases/download/v3.19.4/cmake-3.19.4-Linux-x86_64.tar.gz

3) 解压

sudo tar zxvf cmake-3.19.4-Linux-x86_64.tar.gz

4) 设置环境变量

sudo nano /etc/profile.d/cmake.sh

添加:

export CMAKE_HOME=/opt/cmake-3.19.4-Linux-x86_64

export PATH=$PATH:$CMAKE_HOME/bin

保存，退出。

5) 让 cmake 环境文件生效：source /etc/profile

6) 测试

cmake --version

• 进入配置工具界面

cd ~/esp/hello_world

idf.py menuconfig

保持默认，退出。

6. 编译项目

https://gitee.com/EspressifSystems/esp-idf

编译应用程序，引导程序，并根据配置生成分区表。

6.1 编译

idf.py build

6.2 烧写命令

/home/ccdc/.espressif/python_env/idf4.2_py3.6_env/bin/python ../esp-idf/components/esptool_py/esptool/esptool.py -p (PORT) -b 460800 --before default_reset --after hard_reset --chip esp32  write_flash --flash_mode dio --flash_size detect --flash_freq 40m 0x1000 build/bootloader/bootloader.bin 0x8000 build/partition_table/partition-table.bin 0x10000 build/hello-world.bin

从命令中可以获取以下信息：

• Flash芯片模式

flash_mode dio

• Flash芯片频率

40m

需要下载3个文件和烧写地址：

• bootloader.bin

0x1000 build/bootloader/bootloader.bin

• partitions_singleapp.bin

0x8000 build/partition_table/partition-table.bin

• hello-world.bin

0x10000 build/hello-world.bin

0x1000，0x8000和0x10000是烧写地址，后面要用到。

7. 将编译好的bin文件下载到本地

• 进入CMD窗口

Win+R

输入cmd，确定。

• 用sftp登录阿里云

@前面是用户名，后面是IP地址。

• 进入远程项目的build目录

cd /home/ccdc/esp/hello_world/build

• 切换本地目录

lcd E:\ct\ESP32

• 下载bootloader.bin

get bootloader/bootloader.bin

• 下载partitions_singleapp.bin

get build/partition_table/partition-table.bin

• 下载hello-world.bin

get hello-world.bin

• 查看本地目录

• 退出sftp

8. 烧写项目

• 下载Windows的Flash烧写工具

见《阿里云ECS搭建ESP8266_RTOS_SDK开发环境》

https://zhuanlan.zhihu.com/p/346975777

https://blog.csdn.net/chentuo2000/article/details/113173934

一文中的相关内容。

• 设置Flash烧写工具

运行flash_download_tool_v3.8.5.exe

选择ESP32下载工具。设置如下，地址在前面已经有了，对应如下：

0x1000 bootloader.bin

0x8000 partitions_singleapp.bin

0x10000 hello-world.bin

如下设置：

点击START开始烧写。

烧写完成：

9. 用串口调试助手查看程序运行结果

串口调试助手的使用请看《Win10使用CH340 USB-SERIAL串口》

https://zhuanlan.zhihu.com/p/343013801

https://blog.csdn.net/chentuo2000/article/details/112323488

按开发板的RST键。