955b8d9ae3 | ||
---|---|---|
.. | ||
.vscode | ||
drivers | ||
images | ||
main | ||
.config | ||
CMakeLists.txt | ||
Kconfig | ||
Makefile | ||
README.md | ||
rtconfig.h | ||
rtt.patch | ||
sdkconfig |
README.md
ESP32-C3 BSP 说明
简介
本文档为基于RT-THREAD的乐鑫ESP32-C3的ESP32C3 BSP (板级支持包) 说明。
主要内容如下:
- 开发板资源介绍
- BSP 快速上手
通过阅读快速上手章节开发者可以快速地上手该 BSP,将 RT-Thread 运行在开发板上。
开发板介绍
目前测试了两款开发板,运行都正常,由于两款开发板LED小灯引脚不同,请在menuconfig中选择自己手上的开发板。已测开发板外观如下图所示:
该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,欢迎小伙伴一起来讨论和贡献。
联系人信息
维护人:
特别感谢
- 感谢chenyingchun0312 提供了RISCV的强力支持