中文 | English
本文档为基于RT-THREAD的乐鑫ESP32-C3的ESP32C3 BSP (板级支持包) 说明。
主要内容如下:
通过阅读快速上手章节开发者可以快速地上手该 BSP,将 RT-Thread 运行在开发板上。
目前测试了两款开发板,运行都正常,由于两款开发板LED小灯引脚不同,请在menuconfig中选择自己手上的开发板。已测开发板外观如下图所示:
该LUATOS_ESP32C3开发板常用 板载资源 如下:
开发板更多详细信息请参考 ESP32-C3开发板介绍。
本 BSP 目前对外设的支持情况如下:
| 片上外设 | 支持情况 | 备注 |
|---|---|---|
| GPIO | 支持 | |
| UART | 支持 | 使用LUATOS_ESP32C3开发板需要在UART0_TX和UART0_RX连接串口转USB芯片(如CP2102) |
| JTAG调试 | 支持 | ESP32C3采用USB方式和PC链接的开发板可以调试 |
下载 RISC-V 工具链:
wget https://github.com/espressif/crosstool-NG/releases/download/esp-2022r1-RC1/riscv32-esp-elf-gcc11_2_0-esp-2022r1-RC1-linux-amd64.tar.xz
tar xf riscv32-esp-elf-gcc11_2_0-esp-2022r1-RC1-linux-amd64.tar.xz
在bsp/ESP32_C3/rtconfig.py文件中将RISC-V工具链的本地路径添加到EXEC_PATH变量中,或者通过设置 RTT_EXEC_PATH环境变量指定路径,例如:
export RTT_EXEC_PATH=/opt/riscv32-esp-elf/bin
安装 esptool 用于转换 ELF 文件为二进制烧录文件:
pip install esptool
在 Linux 平台下进入bsp/ESP32_C3/执行以下命令进行配置:
scons --menuconfig
它会自动下载env相关脚本到~/.env目录,然后执行:
source ~/.env/env.sh
cd bsp/ESP32_C3/
pkgs --update
它会自动下载RT-Thread-packages/esp-idf和RT-Thread-packages/FreeRTOS-Wrapper,更新完软件包后,执行 scons 来编译这个板级支持包。
如果编译成功,将生成rtthread.elf、rtthread.bin文件。
烧录工具下载
当前bsp测试使用flash_download_tool_3.9.4工具进行烧录无误。
烧录工具下载地址:https://www.espressif.com.cn/sites/default/files/tools/flash_download_tool_3.9.4_0.zip
烧录工具配置
芯片型号选择ESP32-C3
将二进制文件与偏移地址配置如下:
| 二进制文件 | 偏移地址 |
|---|---|
| bootloader.bin | 0x0 |
| partition-table.bin | 0x8000 |
| rtthread.bin | 0x10000 |
其中bootloader.bin和partition-table.bin可在bsp/ESP32_C3/builtin_imgs文件夹下找到,配置完成后截图如下,之后点击START即可下载。
Thomas的小火车来联系维护人: