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
便可以看到实验现象了。