Linux系统下ESP32开发板搭建RT-Thread开发环境

发布于 2018-02-06 14:45:01 浏览：5406 订阅该版

**1. 搭建步骤**
以下步骤是以Ubuntu 16.04 LTS 32bit 英文版中为例，其他Linux系统类似，但不排除有小细节不同（如包管理软件为yum等）。

ESP32的下载需要使用USB串口工具，请确保自己的开板（ESP-DevkitC、NodeMCU-32S）集成有USB串口功能，或者使用USB转串口工具，Linux中串口的描述符默认是/dev/ttyUSB0，如果你使用的串口不是/dev/ttyUSB0，烧写时修改的路径请自行修改。

以下示例中linux用户的名称为ss，请自行替换为自己linux的用户名。此外，工程及编译工具都放在用户根目录下，你可以根据自己实际情况设置到合适位置中。
在熊大如下的git项目版本中已经经过了测试，不排除最新版本有了完善：
[indent]commit a8504d523214ee872ae480106e31cd1db138b74f
Author: Bernard Xiong <[email]bernard.xiong@gmail.com[/email]>
Date:   Fri Aug 25 15:29:362017 +0800
[/indent]**
******1.1. 下载交叉编译工具****[indent]cd ~
wget[https://dl.espressif.com/dl/xtensa-esp32-elf-linux32-1.22.0-61-gab8375a-5.2.0.tar.gz](https://dl.espressif.com/dl/xtensa-esp32-elf-linux32-1.22.0-61-gab8375a-5.2.0.tar.gz)
[/indent]**
******1.2. 解压缩交叉编译工具****[indent]tar -xzf xtensa-esp32-elf-linux32-1.22.0-61-gab8375a-5.2.0.tar.gz
[/indent]**
******1.3. 安装必要的软件****[indent]sudo apt-get install git wget make libncurses-devflex bison gperf python python-serial scons
[/indent]**
******1.4. 获取代码****[indent]cd ~
[/indent][indent]git clone[https://github.com/BernardXiong/rtthread-esp-idf](https://github.com/BernardXiong/rtthread-esp-idf)

cd rtthread-esp-idf
git submodule init
git submodule update

cd esp-idf-port/esp-idf
git submodule init
git submodule update

git apply ../0001-cpu_start-patch.patch
git apply ../0002-add-esp_task.h.patch
git apply ../0003-add-memset-to-0.patch
[/indent]
****1.5. 修改工程中交叉编译工具的路径****修改~/rtthread-esp-idf/rtconfig.py中exec_path的路径为：
EXEC_PATH   =r'/home/ss/xtensa-esp32-elf/bin'
* 注路径中的ss为linux当前用户的用户名

**
******1.6. 编译****首先修改个Makefile中的一个小错误，python那行命令路径需要修改：
[indent]pythonesp-idf-port/esp-idf/components/esptool_py/esptool/esptool.py --chip esp32elf2image --flash_mode "dio" --flash_freq "40m"--flash_size "4MB"  -ortthread.bin rtthread-esp32.elf
[/indent]然后进入项目根目录进行编译
[indent]cd ~/rtthread-esp-idf
make all
[/indent]
****1.7. 下载****1) 由于Linux下普通用户无权限直接操作/dev/ttyUSB0，首先给当前用户加入相应的权限，以便后边烧写时不需要使用sudo权限：
[indent]sudo usermod -aG dialout ss
[/indent]* 注：ss为linux当前用户的用户名

设置完成后注销重新登录一下当前用户即可，之后不再需要执行该命令。

2) 修改~/rtthread-esp-idf/burn_flash.bat中串口的名字（/dev/ttyUSB0）为如下：
[indent]python esp-idf-port/esp-idf/components/esptool_py/esptool/esptool.py--chip esp32 --port /dev/ttyUSB0 --baud 115200 --before"default_reset" --after "hard_reset" write_flash -z--flash_mode "dio" --flash_freq "40m" --flash_size detect0x1000 bootloader.bin 0x10000 rtthread.bin 0x8000 partitions_singleapp.bin
[/indent]
3) 给burn_flash.bat设置好执行权限：
[indent]chmod a+xburn_flash.bat
[/indent]
4) 将开发板与电脑连接好（如果是虚拟机，需要将设置连入虚拟机），同时如果开发板不支持一键烧写功能，一般需要通过按键使其进入烧写模式（同时按下IO0和reset，然后先松开reset，再松开IO0）；

5) 执行一下命令等待烧写完成：
[indent]cd ~/rtthread-esp-idf
./burn_flash.bat
[/indent][align=center]![FastAdmin](https://www.rt-thread.org/file.php?pathname=201710/f_b633284bd27a4da6d2deb240642e3d29&extension=png)[align=center]*（波特率:115200）*****2. 其他说明********2.1. Linux64bit、Windows及macos的交叉编译工具****具体见[https://github.com/BernardXiong/rtthread-esp-idf](https://github.com/BernardXiong/rtthread-esp-idf)，里边有其他系统交叉编译工具的下载路径。
注：windows下需要先安装MSYS2等GNU-compatible环境软件。
**
******2.2. 目录及文件说明****下图为rttthread-esp-idf的目录结构：
[align=center]![FastAdmin](https://www.rt-thread.org/file.php?pathname=201710/f_0234e2156c64691c5051062b53a15328&extension=png)
其中：
* ** application目录**为rtt应用程序的代码，其中main.c中的app_main()为应用程序入口函数。你可以在这里修改、编码，来熟悉和调试rtt程序。

* **build目录**为编译中间文件使用的目录，编译中的.o .d等都在这个目录内。

* **componets目录**为rtt组件代码保存的目录，自己编写的组件可以放在这里。

* **doc**为该项目一些使用、功能的介绍文档。

* **drivers目录**为rtt用于移植驱动的相关代码保存的目录，已有的包括uart、gpio、i2c、psram等。

* **esp-idf-port目录**为esp-idf移植修改的代码目录，由于rtt on esp32是基于esp官方的esp-idf移植的，esp-idf的代码及移植补丁等在这个目录中。同时用于下载、打包镜像等python工具包也在该目录下。如果你需要更深入地使用ESP32（比如使用自定的分区结构、使用FlashEncryption等功能），可能需要在这个目录配置修改。

* **rt-thread**为rtt核心的内核及相关组件、驱动等代码保存的目录，如果你需要深入了解或调试rtt核心的功能，可以在本目录中寻找、修改、调试。

* **镜像文件或其辅助文件：**

-bootloader.bin：esp32的Second stagebootloader-partitions_singleapp.bin：esp32的分区表数据，目前rtt默认的是非ota的镜像。-rttthread-esp32.bin：rtt on esp32的目标代码。-esp32.common.ld、esp32_out.ld、rtthread-esp32.elf、rtthread-esp32.map：编译镜像的中间文件及脚本工具。* **rtconfig.h、rtconfig_project**：rtt的配置头文件。

* **sdkconfig.h**：esp-idf的配置文件

* **rtconfig.py、rtconfig.pyc**：rtt编译的python脚本。

* **burn_flash.bat**：镜像烧写脚本。

* **Kconfig、Makefile、mkbin.bat、SConscript、SConstruct**：项目编译的各种脚本。

* **README.md**：项目简介。

[align=center]**- End - **
[align=center]**支持RT-Thread，请关注RT-Thread公众号**[align=center]![FastAdmin](https://www.rt-thread.org/file.php?pathname=201710/f_39e72854e007ad99a5fbb1eb67775f97&extension=jpg)**添加微信13924608367 为好友，注明rt-thread，拉进RT-Thread Nano微信交流群，与RT-Thread官方团队直接交流。**