Home Explore Help
Sign In
lqb
/
rt-thread
mirror of https://gitee.com/rtthread/rt-thread.git
1
0
Fork 0
Files Issues 0 Wiki
Tree: 93f3cb30e4
Branches Tags
rt-thread
/
bsp
/
ESP32_C3
/
README_ZH.md

README_ZH.md 4.7 KB
History Raw

ESP32-C3 BSP 说明

中文 | English

简介

本文档为基于RT-THREAD的乐鑫ESP32-C3的ESP32C3 BSP (板级支持包) 说明。

主要内容如下：

  • 开发板资源介绍
  • BSP 快速上手

通过阅读快速上手章节开发者可以快速地上手该 BSP，将 RT-Thread 运行在开发板上。

开发板介绍

目前测试了两款开发板，运行都正常，由于两款开发板LED小灯引脚不同，请在menuconfig中选择自己手上的开发板。已测开发板外观如下图所示：

LUATOS_ESP32C3

hongxu

该LUATOS_ESP32C3开发板常用 板载资源 如下：

  • MCU：esp32-c3，主频 160MHz， 407.22 CoreMark; 2.55 CoreMark/MHz
  • 芯片内置：384KB ROM, 400KB SRAM,
  • 常用外设
    • 红色LED：2个，LED: D4 (IO12), D5（IO13）
    • 按键：2个，K1（BOOT） K2(RST)
    • SPI FLASH: 4M
  • 常用接口：USB UART等

开发板更多详细信息请参考 ESP32-C3开发板介绍。

外设支持

本 BSP 目前对外设的支持情况如下：

片上外设 支持情况 备注
GPIO 支持
UART 支持 使用LUATOS_ESP32C3开发板需要在UART0_TX和UART0_RX连接串口转USB芯片（如CP2102）
JTAG调试 支持 ESP32C3采用USB方式和PC链接的开发板可以调试

安装ESP-IDF

可以使用两种方法安装ESP-IDF

  1. 使用Env工具安装

  2. 下载软件包

    pkgs --update

  3. 安装IDF工具链。如果使用Linux或MacOS系统，在命令行内进入到ESP-IDF软件包路径，安装IDf工具链。

    cd packages/ESP-IDF-latest
./install.sh

    如果使用Windows系统，打开Command Prompt，注意不能使用其他任何命令行，如Env命令行和PowerShell。进入BSP目录并执行

    install.bat

    无论使用任何系统，这一步只需要在下载完软件包后执行一次。

  4. 在软件包路径下设置IDF路径。每当在新的命令行编译BSP时需要执行此命令。 如果使用Linux或MacOS系统，执行

    . export.sh

    如果使用Windows系统，执行

    export.bat

    这一步仍然只能使用Command Prompt。

  5. 在本地ESP-IDF加载patch

  6. 通过SCons --menuconfig选择

    Hardware Drivers Config
[*] Use local ESP-IDF installation

    并取消勾选ESP-IDF软件包

    RT-Thread online packages
peripheral libraries and drivers
    [ ] ESP-IDF: Espressif IoT Development Framework

  7. 使用Env工具下载FreeRTOS兼容层

    pkgs --update

  8. 可以选择其他方式在本地安装ESP-IDF，如VSCode插件。确保安装的ESP-IDF是master版本。

  9. 进入本地ESP-IDF目录执行以下命令

    git checkout 5c1044d84d625219eafa18c24758d9f0e4006b2c
# 把rtt.patch换成BSP目录下rtt.patch的正确路径
git am rtt.patch

  10. 加载patch后不会影响使用ESP-IDF编译基于FreeRTOS的工程

编译和烧录

  1. 在BSP路径下配置RT-Thread

    scons --menuconfig

  2. 每当使用scons --menuconfig更改RT-Thread配置后需要重新生成CMakeLists.txt。

    scons --target=esp-idf

  3. 如果使用Env安装了ESP-IDF，使用idf.py命令编译，烧录。具体参考乐鑫官网。注意如果使用Windows系统，idf.py只能在Command Prompt里执行。如果使用了在本地ESP-IDF加载patch的方式，可使用其他相应的编译和烧录方法，如VSCode插件。

  4. 下载程序成功之后，系统会运行，红色的 LED灯以 1S 周期闪烁。

注意事项

  • 目前RTTHREAD支持起来了，后续会需要继续完善一些其他功能，刚开始使用ESP32，欢迎小伙伴一起来讨论和贡献。感兴趣的可以通过公众号Thomas的小火车来联系

联系人信息

维护人:

特别感谢