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

2017-10-18 13:56:00
RT-Thread
原创
4694
摘要:ESP32是一款集成了wifi和蓝牙的集成模块,本文主要讲解Linux系统下ESP32开发板搭建RT-Thread开发环境。

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项目版本中已经经过了测试,不排除最新版本有了完善:

commit a8504d523214ee872ae480106e31cd1db138b74f

Author: Bernard Xiong <bernard.xiong@gmail.com>

Date:   Fri Aug 25 15:29:362017 +0800


1.1. 下载交叉编译工具

cd ~

wgethttps://dl.espressif.com/dl/xtensa-esp32-elf-linux32-1.22.0-61-gab8375a-5.2.0.tar.gz


1.2. 解压缩交叉编译工具

tar -xzf xtensa-esp32-elf-linux32-1.22.0-61-gab8375a-5.2.0.tar.gz


1.3. 安装必要的软件

sudo apt-get install git wget make libncurses-devflex bison gperf python python-serial scons


1.4. 获取代码

cd ~

git clonehttps://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


1.5. 修改工程中交叉编译工具的路径

修改~/rtthread-esp-idf/rtconfig.py中exec_path的路径为:

EXEC_PATH   =r'/home/ss/xtensa-esp32-elf/bin'

  • 注路径中的ss为linux当前用户的用户名


1.6. 编译

首先修改个Makefile中的一个小错误,python那行命令路径需要修改:

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

然后进入项目根目录进行编译

cd ~/rtthread-esp-idf

make all


1.7. 下载

1) 由于Linux下普通用户无权限直接操作/dev/ttyUSB0,首先给当前用户加入相应的权限,以便后边烧写时不需要使用sudo权限:

sudo usermod -aG dialout ss

  • 注:ss为linux当前用户的用户名

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


2) 修改~/rtthread-esp-idf/burn_flash.bat中串口的名字(/dev/ttyUSB0)为如下:

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


3) 给burn_flash.bat设置好执行权限:

chmod a+xburn_flash.bat


4) 将开发板与电脑连接好(如果是虚拟机,需要将设置连入虚拟机),同时如果开发板不支持一键烧写功能,一般需要通过按键使其进入烧写模式(同时按下IO0和reset,然后先松开reset,再松开IO0);


5) 执行一下命令等待烧写完成:

cd ~/rtthread-esp-idf

./burn_flash.bat

(波特率:115200)

2. 其他说明

2.1. Linux64bit、Windows及macos的交叉编译工具

具体见https://github.com/BernardXiong/rtthread-esp-idf,里边有其他系统交叉编译工具的下载路径。

注:windows下需要先安装MSYS2等GNU-compatible环境软件。


2.2. 目录及文件说明

下图为rttthread-esp-idf的目录结构:


其中:

  •  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:项目简介。



- End - 


支持RT-Thread,请关注RT-Thread公众号

添加微信13924608367 为好友,注明rt-thread,拉进RT-Thread Nano微信交流群,与RT-Thread官方团队直接交流。

发表评论
评论通过审核后显示。

关注RT-Thread

License许可证

RT-Thread实时操作系统遵循Apache许可证2.0版本,实时操作系统内核及所有开源组件可以免费在商业产品中使用,不需要公布应用程序源码,没有潜在商业风险。

联系RT-Thread

support@rt-thread.com

+86 021-31608913

群号87088566

上海浦东新区达尔文路88号半岛科技园11号楼5层