ESP32-C3 BSP 实操指南从零配置到首次烧录 LED 闪烁【免费下载链接】rt-threadRT-Thread is an open source IoT Real-Time Operating System (RTOS). https://rt-thread.github.io/rt-thread/项目地址: https://gitcode.com/gh_mirrors/rt/rt-thread看完这篇你能在乐鑫 ESP32-C3 上跑通仓库的 ESP32-C3 BSPscons 编译出固件、esptool 烧录进 Flash、板子默认 1 秒周期闪烁 LED。它覆盖 LUATOS_ESP32C3 与 HX-DK 两款开发板提供 Docker 一键编译和原生工具链两套环境方案内核之上靠idf_port适配层复用 ESP-IDF 的驱动和 ROM 代码。 硬件与芯片速查芯片主频 / 架构内置存储开发板一句话区别ESP32-C3160MHz / RISC-VRV32IMC384KB ROM、400KB SRAMLUATOS_ESP32C3LED 在 IO124M FlashESP32-C3同上同上HX-DK-商LED 在 IO8其余一致引脚差异不折腾代码LUATOS 板 LED 默认 IO12HX 板 IO8UART0 的 TX/RX 默认 IO21/IO20在 驱动 Kconfig 里选板号即自动切换。 开发环境准备先做硬件检查再装软件顺序别反ls /dev/ttyUSB* # 或 /dev/ttyACM*Linux 下能列出串口设备说明板子接对了Windows 看设备管理器里有没有新串口。LUATOS_ESP32C3 的 USB 口只走 JTAG 调试日志要接板子上的 CP2102 串口芯片。主线方案选 Docker 一键编译三条命令搞定git clone https://gitcode.com/gh_mirrors/rt/rt-thread cd rt-thread/bsp/ESP/ESP32_C3/docker sudo docker build -t rtthread_esp32c3 .构建参数可加--build-arg HTTP_PROXY/HTTPS_PROXY否则容器内拉软件包可能卡住。进容器时把串口映射进去sudo docker run -it --device/dev/ttyUSB* rtthread_esp32c3备选是原生环境适合正式开发下载riscv32-esp-elf工具链后pip install esptool。工具链路径只需一行改 rtconfig.py 里的EXEC_PATH或导出环境变量RTT_EXEC_PATHexport RTT_EXEC_PATH/opt/riscv32-esp-elf/bin环境变量优先于EXEC_PATH默认值~会自动展开工具前缀riscv32-esp-elf-。✅ 首次编译与烧录Step 1进 BSP 目录打开 menuconfig首次会自动下载 env 脚本到~/.envscons --menuconfig预期终端弹出文本菜单在 Hardware Drivers Config → Select BSP board 选板号默认 LUATOS_ESP32C3保存退出。Step 2拉取软件包并编译source ~/.env/env.sh pkgs --update sconspkgs --update会拉取 ESP-IDF 与 FreeRTOS-Wrapper 两个包预期编译结尾同时生成rtthread.elf和rtthread.bin看到这两个文件说明通过。Step 3烧录三个文件偏移地址固定二进制文件偏移地址来源bootloader.bin0x0builtin_imgs/partition-table.bin0x8000builtin_imgs/rtthread.bin0x10000本次编译产出esptool.py -b 115200 --before default_reset --after hard_reset write_flash --flash_mode dio --flash_size detect --flash_freq 80m 0x0 bootloader.bin 0x8000 partition-table.bin 0x10000 rtthread.bin参数对应 SConstruct 打包时的 DIO 模式、4MB Flash、80MHz 频率烧录前别改。预期Linux 出现Hash of data verifiedWindows 用 Flash Download Tools 3.9.4芯片型号选 ESP32-C3按上表配三个文件START 后出现A successful flash has been completed。差异点WindowsLinux烧录工具Flash Download Toolsesptool.py多设备下拉选 COM 口-p /dev/ttyXXX失败常见原因驱动/COM 口没选对串口权限不足 按需开启外设一张开关总表加三个坑默认只开 GPIO 和 UART其余按需在 menuconfig 勾选配置开关外设默认备注BSP_USING_GPIOGPIOy点亮 LED 就靠它BSP_USING_UARTUART0y默认 IO21/IO20BSP_USING_I2CI2Cn硬件/软件两个子选项BSP_USING_SOFT_I2C0软件 I2CnSCLIO19、SDAIO18 可改BSP_USING_SPI / SPI2SPInCS 默认 IO10 可改BSP_USING_WIFIWi-Fin见下坑 2BSP_USING_BLEBLENimBLEn见下坑 3BSP_USING_ADC / ADC1ADCn—BSP_USING_PWM / PWM0PWMLEDCn6 通道 GPIO 可分别配BSP_USING_CLOCK_TIMER时钟定时器n依赖 RT_USING_CLOCK_TIMEBSP_ENABLE_GDBSTUBGDB 调试n出错进 GDB 模式坑 1软件 I2C。现象开了软件 I2C 后定时器异常。原因软件 I2C 会占用一个硬件通用定时器。怎么绕时钟用别的通道或只开硬件 I2C——但硬件 I2C 目前会丢字节两者各有所失以仓库文档描述为准。坑 2Wi-Fi 中断里调消息队列。现象在 ISR 里用rt_mq_recv后系统挂死。原因Wi-Fi 驱动当前实现有此限制。怎么绕中断里只置标志位实际处理放线程。坑 3BLE 与 Wi-Fi 互斥。现象同时开启后互相干扰。原因射频资源冲突。怎么绕开 BLE 前在 menuconfig 关掉RT_USING_WIFI和LWIP并先调esp_timer_init()再进 NimBLE 接口main.c 里已有这段顺序可参考。 调试与排错出事了先查这 5 条串口权限ls /dev 能列出设备esptool 却打不开板号选对没menuconfig 里 board 选项和实物一致工具链路径EXEC_PATH 或 RTT_EXEC_PATH 指向真实 bin偏移地址三个文件烧到 0x0 / 0x8000 / 0x10000软件包pkgs --update 拉的是不是最新主线深入排查开BSP_ENABLE_GDBSTUB芯片出错后自动进 GDB 模式sudo riscv32-esp-elf-gdb (gdb) source esp32c3.gpb (gdb) continue脚本里写好了内存映射、115200 波特率和/dev/ttyACM0按自己端口改最后一行即可。⚠️ 已知限制与规避策略硬件 I2C 丢字节 → 硬件控制器在 ESP32-C3 上表现不稳 → 用软件 I2C接受它吃掉一个硬件定时器。Wi-Fi 的 ISR 限制 → 驱动实现未完成 → 消息队列、互斥量一律放线程里处理。BLENimBLE长时间运行后出错 → 当前实现问题 → 短任务验证功能不跑长稳且 Wi-Fi 必须关闭。以上均为当前主线分支状态细节以仓库实际代码为准。接下来可以试把主循环的 LED 闪烁换成 UART 打印心跳开软件 I2C 接一个温湿度传感器开 SPI2 驱动一块 OLED。维护人supperthomas、tangzz98、wumingzi有编译或烧录问题可以联系或在仓库提 Issue。【免费下载链接】rt-threadRT-Thread is an open source IoT Real-Time Operating System (RTOS). https://rt-thread.github.io/rt-thread/项目地址: https://gitcode.com/gh_mirrors/rt/rt-thread创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 
长河君 · 2026/11/4 6:10:31 · 阅读 1.2k ESP32-C3 BSP 实操指南：从零配置到首次烧录 LED 闪烁
ESP32-C3 BSP 实操指南从零配置到首次烧录 LED 闪烁【免费下载链接】rt-threadRT-Thread is an open source IoT Real-Time Operating System (RTOS). https://rt-thread.github.io/rt-thread/项目地址: https://gitcode.com/gh_mirrors/rt/rt-thread看完这篇你能在乐鑫 ESP32-C3 上跑通仓库的 ESP32-C3 BSPscons 编译出固件、esptool 烧录进 Flash、板子默认 1 秒周期闪烁 LED。它覆盖 LUATOS_ESP32C3 与 HX-DK 两款开发板提供 Docker 一键编译和原生工具链两套环境方案内核之上靠idf_port适配层复用 ESP-IDF 的驱动和 ROM 代码。 硬件与芯片速查芯片主频 / 架构内置存储开发板一句话区别ESP32-C3160MHz / RISC-VRV32IMC384KB ROM、400KB SRAMLUATOS_ESP32C3LED 在 IO124M FlashESP32-C3同上同上HX-DK-商LED 在 IO8其余一致引脚差异不折腾代码LUATOS 板 LED 默认 IO12HX 板 IO8UART0 的 TX/RX 默认 IO21/IO20在 驱动 Kconfig 里选板号即自动切换。 开发环境准备先做硬件检查再装软件顺序别反ls /dev/ttyUSB* # 或 /dev/ttyACM*Linux 下能列出串口设备说明板子接对了Windows 看设备管理器里有没有新串口。LUATOS_ESP32C3 的 USB 口只走 JTAG 调试日志要接板子上的 CP2102 串口芯片。主线方案选 Docker 一键编译三条命令搞定git clone https://gitcode.com/gh_mirrors/rt/rt-thread cd rt-thread/bsp/ESP/ESP32_C3/docker sudo docker build -t rtthread_esp32c3 .构建参数可加--build-arg HTTP_PROXY/HTTPS_PROXY否则容器内拉软件包可能卡住。进容器时把串口映射进去sudo docker run -it --device/dev/ttyUSB* rtthread_esp32c3备选是原生环境适合正式开发下载riscv32-esp-elf工具链后pip install esptool。工具链路径只需一行改 rtconfig.py 里的EXEC_PATH或导出环境变量RTT_EXEC_PATHexport RTT_EXEC_PATH/opt/riscv32-esp-elf/bin环境变量优先于EXEC_PATH默认值~会自动展开工具前缀riscv32-esp-elf-。✅ 首次编译与烧录Step 1进 BSP 目录打开 menuconfig首次会自动下载 env 脚本到~/.envscons --menuconfig预期终端弹出文本菜单在 Hardware Drivers Config → Select BSP board 选板号默认 LUATOS_ESP32C3保存退出。Step 2拉取软件包并编译source ~/.env/env.sh pkgs --update sconspkgs --update会拉取 ESP-IDF 与 FreeRTOS-Wrapper 两个包预期编译结尾同时生成rtthread.elf和rtthread.bin看到这两个文件说明通过。Step 3烧录三个文件偏移地址固定二进制文件偏移地址来源bootloader.bin0x0builtin_imgs/partition-table.bin0x8000builtin_imgs/rtthread.bin0x10000本次编译产出esptool.py -b 115200 --before default_reset --after hard_reset write_flash --flash_mode dio --flash_size detect --flash_freq 80m 0x0 bootloader.bin 0x8000 partition-table.bin 0x10000 rtthread.bin参数对应 SConstruct 打包时的 DIO 模式、4MB Flash、80MHz 频率烧录前别改。预期Linux 出现Hash of data verifiedWindows 用 Flash Download Tools 3.9.4芯片型号选 ESP32-C3按上表配三个文件START 后出现A successful flash has been completed。差异点WindowsLinux烧录工具Flash Download Toolsesptool.py多设备下拉选 COM 口-p /dev/ttyXXX失败常见原因驱动/COM 口没选对串口权限不足 按需开启外设一张开关总表加三个坑默认只开 GPIO 和 UART其余按需在 menuconfig 勾选配置开关外设默认备注BSP_USING_GPIOGPIOy点亮 LED 就靠它BSP_USING_UARTUART0y默认 IO21/IO20BSP_USING_I2CI2Cn硬件/软件两个子选项BSP_USING_SOFT_I2C0软件 I2CnSCLIO19、SDAIO18 可改BSP_USING_SPI / SPI2SPInCS 默认 IO10 可改BSP_USING_WIFIWi-Fin见下坑 2BSP_USING_BLEBLENimBLEn见下坑 3BSP_USING_ADC / ADC1ADCn—BSP_USING_PWM / PWM0PWMLEDCn6 通道 GPIO 可分别配BSP_USING_CLOCK_TIMER时钟定时器n依赖 RT_USING_CLOCK_TIMEBSP_ENABLE_GDBSTUBGDB 调试n出错进 GDB 模式坑 1软件 I2C。现象开了软件 I2C 后定时器异常。原因软件 I2C 会占用一个硬件通用定时器。怎么绕时钟用别的通道或只开硬件 I2C——但硬件 I2C 目前会丢字节两者各有所失以仓库文档描述为准。坑 2Wi-Fi 中断里调消息队列。现象在 ISR 里用rt_mq_recv后系统挂死。原因Wi-Fi 驱动当前实现有此限制。怎么绕中断里只置标志位实际处理放线程。坑 3BLE 与 Wi-Fi 互斥。现象同时开启后互相干扰。原因射频资源冲突。怎么绕开 BLE 前在 menuconfig 关掉RT_USING_WIFI和LWIP并先调esp_timer_init()再进 NimBLE 接口main.c 里已有这段顺序可参考。 调试与排错出事了先查这 5 条串口权限ls /dev 能列出设备esptool 却打不开板号选对没menuconfig 里 board 选项和实物一致工具链路径EXEC_PATH 或 RTT_EXEC_PATH 指向真实 bin偏移地址三个文件烧到 0x0 / 0x8000 / 0x10000软件包pkgs --update 拉的是不是最新主线深入排查开BSP_ENABLE_GDBSTUB芯片出错后自动进 GDB 模式sudo riscv32-esp-elf-gdb (gdb) source esp32c3.gpb (gdb) continue脚本里写好了内存映射、115200 波特率和/dev/ttyACM0按自己端口改最后一行即可。⚠️ 已知限制与规避策略硬件 I2C 丢字节 → 硬件控制器在 ESP32-C3 上表现不稳 → 用软件 I2C接受它吃掉一个硬件定时器。Wi-Fi 的 ISR 限制 → 驱动实现未完成 → 消息队列、互斥量一律放线程里处理。BLENimBLE长时间运行后出错 → 当前实现问题 → 短任务验证功能不跑长稳且 Wi-Fi 必须关闭。以上均为当前主线分支状态细节以仓库实际代码为准。接下来可以试把主循环的 LED 闪烁换成 UART 打印心跳开软件 I2C 接一个温湿度传感器开 SPI2 驱动一块 OLED。维护人supperthomas、tangzz98、wumingzi有编译或烧录问题可以联系或在仓库提 Issue。【免费下载链接】rt-threadRT-Thread is an open source IoT Real-Time Operating System (RTOS). https://rt-thread.github.io/rt-thread/项目地址: https://gitcode.com/gh_mirrors/rt/rt-thread创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考