在Linux-Ubuntu16.04上部署ESP8266工作环境

ESP8266学习随记

在LINUX上部署ESP8266工作环境

LINUX环境：ubuntu-16.04.4-desktop-amd64
ESP8266_SDK：RTOS
esp-toolchain version：v8.4.0
安装日期：21/04/30

1. 更新ubuntu16.04的pip版本

ubuntu16.04默认预装了python2.7、python3.5，且没有预装pip。先进行pip的安装，后续在ESP8266环境部署中会使用到pip。

	sudo apt-get install python-pip python-dev build-essential

此命令安装的pip版本还是过低（pip 8.1.1），笔者在后续安装python依赖包时发现部分包无法下载，我们还需要额外步骤进行手动更新pip版本。这里使用get-pip.py进行pip版本的一键更新。

	mkdir ~/Download/get-pip/2.7 && cd ~/Download/get-pip/2.7
	wget https://bootstrap.pypa.io/pip/2.7/get-pip.py
	python get-pip.py
	mkdir ~/Download/get-pip/3.5 && cd ~/Download/get-pip/3.5
	wget https://bootstrap.pypa.io/pip/3.5/get-pip.py
	python3 get-pip.py

这里主要是使用python2-pip，python3的pip也顺便安装了。安装完成后使用pip -V命令检查一下pip的版本是否成功更新到pip 20.3.4。随后就可以开始ESP8266的环境部署了。

1.1 更换pip源为阿里源

pip默认是从国外下载，速度很慢，且出现丢包后还会导致错误。这里我们需要提前更换为阿里源，配置过程也很简单，这里直接放代码：

	mkdir ~/.pip
	gedit ~/.pip/pip.conf

在pip.conf添加如下内容，保存后即可。

[global]
index-url = http://mirrors.aliyun.com/pypi/simple/
[install]
trusted-host=mirrors.aliyun.com

2. 获取toolchain

笔者安装时toolchain版本更新到v8.4.0，这里附上乐鑫ESP8266的github官方地址，在下方的readme.md中带有安装的详细介绍。这里我下载的是Linux(64)版本，获取xtensa-lx106-elf-gcc8_4_0-esp-2020r3-linux-amd64.tar.gz，将其解压至Linux系统中的/opt/pkg/下。这里还需要有一步配置Path路径，我们放到后面再做。

3. 获取ESP8266_RTOS_SDK

首先创建SDK存放目录：

	mkdir ~/esp && cd ~/esp

按照官方说明的方法，直接git clone github即可（这里没安装git的同学apt-get安装一下）。但是国内直接git github速度实在太慢，在linux中也不太方便配置代理，所以我们可以把github的仓库转到国内gitee上，这样下载就很快了，但是这样做也会导致随后的问题，我们后续会讲到。这里不能直接在github网页端下载.zip文件并将其解压至linux系统中，由于此仓库内部还有其他仓库的链接，这样做会导致在最后的make all中其余仓库获取失败。
这里我已经将SDK转到gitee了，可以通过如下命令下载：

	git clone https://gitee.com/jadechen_y/ESP8266_RTOS_SDK

接下来我们设置toolchain和SDK的Path路径，我们可以将Path直接加入系统路径中，这样可以永久生效，我这里使用的手动设置的方法，减少系统累赘。在/opt/pkg/xtensa-lx106-elf/中新建一个settings.sh（如有必要，sudo chmod 777 settings.sh一下），并加入如下代码：

	export IDF_PATH=/home/mlia/esp/ESP8266_RTOS_SDK
	PATH=$PATH:/opt/pkg/xtensa-lx106-elf/bin
	export PATH

随后在终端中输入指令别名命令alias

	echo "alias esp8266set='source /opt/pkg/xtensa-lx106-elf/settings.sh'" >> ~/.bashrc

这样我们打开新终端后，输入esp8266set就可以设置toolchain和SDK的环境变量了。
接着进行python包的安装：

注意这里进入/tools目录后要esp8266set一下，这样后面进行工具安装时py脚本就可以识别到toolchain已经被安装，不会再进行重复安装的工作。

	cd ~/esp/ESP8266_RTOS_SDK/tools
	esp8266set
	python3 idf_tools.py install
	python3 idf_tools.py install-python-env

3. SDK仓库的额外补充

按照官方说明，此时我们就可以开始examples/get-started/hello_world的实验了，但是我们前面使用了gitee下载，需要进行额外补充。进入~/esp/ESP8266_RTOS_SDK目录，编辑隐藏文件.git/config：

	cd ~/esp/ESP8266_RTOS_SDK/.git
	gedit config

在文末加入如下代码，这是对仓库文件的进一步补充：

[submodule "components/json/cJSON"]
	url = https://gitee.com/jadechen_y/cJSON.git
[submodule "components/lwip/lwip"]
	url = https://gitee.com/jadechen_y/esp-lwip.git
[submodule "components/mqtt/esp-mqtt"]
	url = https://gitee.com/jadechen_y/esp-mqtt.git
[submodule "components/mbedtls/mbedtls"]
	url = https://gitee.com/jadechen_y/mbedtls.git

最后效果如图：

4. 最后进行hello world实验

前面的步骤都进行完了，那么最后编译一下hello world就水到渠成了。执行make menuconfig后简单配置一下，save后退出。这里make all中会进行gitee下载，就是前面所提到的，会下载cJSON、esp-lwip等库。

	cd ~/esp/ESP8266_RTOS_SDK/examples/get-started/hello_world
	esp8266set
	make menuconfig
	make all

4.1 make flash遇到的问题

连接板子，查询串口是否已经连接：

	ls /dev | grep ttyUSB*

正常情况下，此时如果直接make flash会出现问题，查看错误信息大致是串口拒绝访问。这时候需要赋予一下普通用户读写串口的权利，这里参考网上的解决方法，

	sudo gedit /etc/udev/rules.d/70-ttyusb.rules

文末加入KERNEL=="ttyUSB[0-9]*", MODE="0666"即可。重新执行make flash，烧录成功。查看串口信息：

	make monitor

便可以看到实验现象了。