基于WSL搭建ESP8266开发环境

目的

本文档用于记录 ESP8266 基于 WSL 的开发环境搭建。本人在最早接触 ESP8266 时使用的环境搭建方法是在 windows 下使用 MINGW32，这个环境下的编译非常慢，体验非常不好。后来接触到 ubuntu 下的环境搭建，但由于是使用的 vmware，来回切换也是非常的复杂。近期看到 windwos 下的 wsl 环境搭建，尝试一番后发现用起来得心应手，于是记录下来，供日后使用。

准备工作

• 安装 WSL
• 安装 ubuntu
• 下载 Move WSL

环境搭建过程

1. 安装 WSL 以及 ubuntu

如何安装 wsl 以及 ubuntu 就不在赘述了，网上一搜一大把。下面从安装完 WSL 以及 ubuntu 开始。

2. 迁移 wsl

系统默认将 ubuntu 安装在了 C 盘，我们以后日常使用，ubuntu 里面的安装的内容越来越多，会导致 C 盘空间不够用，因此在安装完 wsl 之后，我们即可将其迁移到合适的盘。

wls 本身提供了 export 和 inport 功能，而 move wsl 是一个 powershell 脚本，可以帮助我们傻瓜式进行 wsl 的迁移。下面开始利用 move wsl 进行迁移

• 确保关闭要迁移的 ubuntu

• 管理员权限打开 powershell，进入 move wsl 文件夹，执行脚本.\move-wsl.ps1
  

• 按 2 选择 Ubuntu-20.04
  

• 选择需要迁移的文件夹路径
  

• 当出现如下界面，说明迁移已经完成
  

3. ubuntu 基本配置

3.1 更新国内源

使用 sed 命令更新 ubuntu 源为国内源以提高访问速度

sed -i s/archive.ubuntu.com/mirrors.aliyun.com/g /etc/apt/sources.list
sed -i s/security.ubuntu.com/mirrors.aliyun.com/g /etc/apt/sources.list

执行如下命令，更新 ubuntu 中软件

apt-get update 
apt-get upgrade

3.2 linux 准备

根据乐鑫 官方文档 ，安装 ubuntu 下必要组件

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

4.tools

由于国内访问 git 较慢，乐鑫在 gitee 上为大家准备了一个 tools，可以加速访问；

• 首先先建立工作目录并进入该路径
  
• 使用 git clone esp-gitee-tools

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

• 在 esp-gitee-tools 中乐鑫为我们提供了三个工具(具体用法可查看其 readme)，其中：
  
• List item jihu-mirror.sh 适用于解决国内开发者从 github 克隆 esp 相关仓库慢的问题
• submodule-update.sh 是用于更新 submodule，有了 jihu 之后已经不再需要；
• install.sh 适用于加速下载各种编译工具链
• 执行 jihu-mirror.sh 设置镜像

./jihu-mirror.sh set

5 退出 esp-git-tools 文件夹，git clone ESP8266 SDK

git clone --recursive https://github.com/espressif/ESP8266_RTOS_SDK.git

由于使用了 jihu 镜像，git 上的 ESP8266 SDK 很快就 clone 下来了。

6.使用 tools 中的 install.sh 工具

• 回到 esp-gitee-tools 文件件
• 执行如下指令

export EGT_PATH=$(pwd)

7.设置 pip 加速

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

8.执行 install.sh 脚本

回到 ESP8266SDK 目录下，执行如下命令

$EGT_PATH/install.sh

报错如下：

执行如下三个命令后，在此执行 shell 脚本成功

python3 --version
whereis python3
sudo ln -s /usr/bin/python3 /usr/bin/python

直到出现如下界面，表明环境配置成功

9.编译运行 helloworld

• 首先执行. ./export.sh，每次打开新的终端，都需要执行该脚本。其重要用于导入 SDK 的各种环境变量
• 退出 ESP8266_RTOS_SDK，并建立 project 目录
  
• copy helloworld 到 project

cp -r ESP8266_RTOS_SDK/examples/get-started/hello_world/ project/

• 进入 project 下面的 helloworld 执行 make
  报错入下：
  
  这是因为 ubuntu 下的 curses 库未安装，执行如下指令安装

sudo apt-get install libncurses5-dev

接下来可以成功编译。

10.Monitor

10.1 usbipd

在 wsl 下，我们使用 usbipd 来讲 windows 下的 usb 串口绑定到 ubuntu 下。 usbipd下载
同时，在 wsl 环境下，我们也需要下载安装 usbipd

sudo apt install linux-tools-5.4.0-77-generic hwdata
sudo update-alternatives --install /usr/local/bin/usbip usbip /usr/lib/linux-tools/5.4.0-77-generic/usbip 20

接下来通过以下两个命令，在 powshell 中将 usb 接口绑定到 wsl

usbipd wsl list
usbipd wsl attach --busid <busid>

usbipd具体应用参考

10.2 运行 idf.py monitor 即可在 wsl 下查看 ESP8266 运行的串口 log

11.卸载与清除 ubuntu

• 在 windows“添加删除程序”中删除需要卸载的 ubuntu；
• 以管理员权限打开 powershell，运行 wsl -l -v 测试可以看到刚才删除的 ubuntu 还在；
  
• 运行如下命令：wsl --unregister Ubuntu-20.04
  
• 此时再使用 wsl -l -v 发现 Ubuntu-20.04 已经完全删除