rt-thread/bsp/ESP32_C3

ESP32-C3 BSP 说明

简介

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

主要内容如下：

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

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

开发板介绍

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

• LUATOS_ESP32C3

• HX-DK-商

该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链接的开发板可以调试

使用说明

快速上手

先要搭建IDE开发环境，乐鑫官方推荐使用IDF开发，这边建议使用vscode插件。

IDF的搭建方法有很多种，尝试了很多种方法之后，总结了一个比较好用的方法，并且可以使用vscode跨平台安装，非常简单方便，具体方法见链接ESP-IDF 一键式搭建环境基于VSCODE。 安装的时候IDF版本请选择IDF 4.4版本。如果你对官方IDF命令行的方式熟悉的话，你也可以使用命令行的方式，直接在bsp/esp32_c3中执行idf.py build即可，这边已经测试过，是可以使用的。

ESP-IDF 添加RT-THREAD patch

由于IDF使用的是FREERTOS，如果需要使用rt-thread就需要修改一些文件。将rtt.patch 这个文件拷贝到IDF的代码目录下面，然后在git bash命令行内执行命令下面几条命令就可以打上patch

cd esp/esp-idf
git checkout v4.4
git am rtt.patch

如果不想用patch文件，已经将代码上传到github上面，可以进入tangzz98/esp-idf 下载最新的freertos_wrapper分支代码即可。修改之后的IDF，原来的IDF的example还是正常使用，互不干扰，可以放心使用。

编译下载

在bsp/ESP32_C3中右击，然后使用vscode打开工程

编译选择最下面的按钮即可：

这边通常采用串口下载，需要根据你自己开发板选择对应的串口（如果有JTAG的，也可以用JTAG下载和调试）

运行结果

下载程序成功之后，系统会运行，红色的 LED灯以 1S 周期闪烁。 感兴趣的可以通过公众号Thomas的小火车来联系

注意事项

• 目前RTTHREAD支持起来了，后续会需要继续完善一些其他功能，刚开始使用ESP32，欢迎小伙伴一起来讨论和贡献。

联系人信息

维护人:

• supperthomas 邮箱：78900636@qq.com

特别感谢

• 感谢chenyingchun0312 提供了RISCV的强力支持