[bsp][esp32-s3] add ESP32-S3-DevKitM-1 support by cms19859230182-lang · Pull Request #11844 · RT-Thread/rt-thread

cms19859230182-lang · 2026-09-28T11:04:06Z

拉取/合并请求描述：(PR description)

为什么提交这份PR (why to submit this PR)

主仓还没有 ESP32-S3 的 BSP。这块板是 ESP32-S3-DevKitM-1，模组 ESP32-S3-MINI-1，Xtensa LX7。它不是 RISC-V，不能用 ESP32-C3 的工具链，也不能搬 C3 的中断接法。

你的解决方案是什么 (what is your solution)

新增 bsp/ESP/ESP32_S3 和 libcpu/xtensa/esp32s3。本镜像单核。UART0 在开发板标着 UART 的 USB 口上，TX GPIO43，RX GPIO44，CP210x，115200。默认打开 GPIO 和 UART0。

builtin_imgs 里是 ESP32-S3 的 bootloader 和分区表，不能换成 ESP32-C3 的。Flash 是 DIO、8MB、80MHz。应用在 0x10000。

pkgs --update 拉官方 RT-Thread-packages/esp-idf。这份包的 SConscript 只编 ESP32-C3，S3 的源文件由 idf_components/SConscript 从包里挑。

共享改动：

libraries/drivers/Kconfig：SoC 收进 choice，默认仍是 ESP32-C3，新增 ESP32-S3。
board.c：S3 的节拍中断只加 tick，向量里已经做过 enter/leave。
sdkconfig.h：S3 转去包含 sdkconfig_s3.h。

中断看门狗默认关掉。IDF 用自己的向量喂 TG1WDT，这份 BSP 换了向量。不关的话，启动大约 300 ms 后以 rst:0x8 (TG1WDT_SYS_RST) 复位。

GPIO、I2C、SPI、ADC、PWM、Wi-Fi、BLE、板载灯和片内 8MB PSRAM 都还没在板上测，README 里写的是待支持。

CI 新增 xtensa-esp32s3-elf GCC 12.2.0 工具链，本 BSP 已加入 ALL_BSP_COMPILE.json 和 bsp_buildings。

在 ESP32-S3-DevKitM-1 上用 xtensa-esp32s3-elf GCC 12.2.0 烧过默认镜像：

能进 msh。help、version、ps、free 有回应。version 是 5.3.1。
隔开再执行 ps，left tick 从 0x08 变到 0x0a。
free：total 76704，used 12192，available 64512。
ps 里 timer 和 main 的 error 列是 EINTRPT。shell 仍有回应，节拍仍在走。

请提供验证的bsp和config (provide the config and bsp)

BSP: bsp/ESP/ESP32_S3
.config: 默认打开 GPIO 和 UART0。I2C、SPI、ADC、PWM、Wi-Fi、BLE 关闭。
action: CI 跑完后补上链接。

当前拉取/合并请求的状态 Intent for your PR

必须选择一项 Choose one (Mandatory):

本拉取/合并请求是一个草稿版本 This PR is for a code-review and is intended to get feedback
本拉取/合并请求是一个成熟版本 This PR is mature, and ready to be integrated into the repo

代码质量 Code Quality：

我在这个拉取/合并请求中已经考虑了 As part of this pull request, I've considered the following:

已经仔细查看过代码改动的对比 Already check the difference between PR and old code
代码风格正确，包括缩进空格，命名及其他风格 Style guide is adhered to, including spacing, naming and other styles
没有垃圾代码，代码尽量精简，不包含#if 0代码，不包含已经被注释了的代码 All redundant code is removed and cleaned up
所有变更均有原因及合理的，并且不会影响到其他软件组件代码或BSP All modifications are justified and not affect other components or BSP
对难懂代码均提供对应的注释 I've commented appropriately where code is tricky
代码是高质量的 Code in this PR is of high quality
已经使用clang-format 源码格式化工具确保格式符合RT-Thread代码规范 This PR has been formatted with clang-format and complies with RT-Thread code specification
如果是新增bsp, 已经添加ci检查到.github/ALL_BSP_COMPILE.json 详细请参考链接BSP自查

github-actions · 2026-09-28T11:04:24Z

👋 感谢您对 RT-Thread 的贡献！Thank you for your contribution to RT-Thread!

为确保代码符合 RT-Thread 的编码规范，请在你的仓库中执行以下步骤运行代码格式化工作流（如果格式化CI运行失败）。
To ensure your code complies with RT-Thread's coding style, please run the code formatting workflow by following the steps below (If the formatting of CI fails to run).

🛠 操作步骤 | Steps

前往 Actions 页面 | Go to the Actions page
点击进入工作流 → | Click to open workflow →
点击 Run workflow | Click Run workflow

Use workflow from 保持默认分支（通常为 master）
Keep the default branch (usually master) in Use workflow from
在 branch 输入框填写 PR 分支 bsp/esp32s3-devkitm-1
Enter PR branch bsp/esp32s3-devkitm-1 in the branch field
设置需排除的文件/目录（目录请以"/"结尾）
Set files/directories to exclude (directories should end with "/")

等待工作流完成 | Wait for the workflow to complete
格式化后的代码将作为独立提交推送至你的分支。
The formatting changes will be pushed to your branch as a separate commit.

完成后，提交将自动更新至 bsp/esp32s3-devkitm-1 分支，关联的 Pull Request 也会同步更新。
Once completed, commits will be pushed to the bsp/esp32s3-devkitm-1 branch automatically, and the related Pull Request will be updated.

如有问题欢迎联系我们，再次感谢您的贡献！💐
If you have any questions, feel free to reach out. Thanks again for your contribution!

github-actions · 2026-09-28T11:13:38Z

MemBrowse Memory Report · Explore what changed →

No memory changes detected for:

_{Catch memory regressions in CI with MemBrowse. Free for open source.}

github-actions · 2026-09-28T13:17:57Z

📌 Code Review Assignment

🏷️ Tag: workflow

Reviewers: @Rbb666 @kurisaW @supperthomas

Changed Files (Click to expand)

.github/ALL_BSP_COMPILE.json
.github/membrowse-targets.json
.github/workflows/action_tools.yml
.github/workflows/bsp_buildings.yml
.github/workflows/manual_bsp_build.yml
.github/workflows/manual_dist.yml
.github/workflows/manual_trigger_scons_except_STM32_all.yml
.github/workflows/manual_trigger_update_all.yml
.github/workflows/membrowse-onboard.yml
.github/workflows/membrowse-report.yml
.github/workflows/pr_clang_format.yml
.github/workflows/utest_auto_run.yml

📊 Current Review Status (Last Updated: 2026-10-28 07:38 CST)

⌛ @Rbb666 Pending Review
⌛ @kurisaW Pending Review
⌛ @supperthomas Pending Review

📝 Review Instructions

维护者可以通过单击此处来刷新审查状态: 🔄 刷新状态
Maintainers can refresh the review status by clicking here: 🔄 Refresh Status
确认审核通过后评论 LGTM/lgtm
Comment LGTM/lgtm after confirming approval
PR合并前需至少一位维护者确认
PR must be confirmed by at least one maintainer before merging

ℹ️ 刷新CI状态操作需要具备仓库写入权限。
ℹ️ Refresh CI status operation requires repository Write permission.

Rbb666 · 2026-09-28T14:18:08Z

@cms19859230182-lang 编译还有点问题，相关的软件包依赖没有添加

cms19859230182-lang · 2026-09-29T00:28:09Z

@cms19859230182-lang 编译还有点问题，相关的软件包依赖没有添加

好的，稍等一下，我回去就开始改。

cms19859230182-lang · 2026-09-29T02:18:00Z

@cms19859230182-lang 编译还有点问题，相关的软件包依赖没有添加

等一下，这个bug我改好了，你引用的是我在21：36的commit。不过我在commit完以后就意识到了问题，所以我在21：52的时候就又commit了一份上去，你康康

cms19859230182-lang · 2026-09-29T02:18:28Z

@Rbb666

Copilot

🔵 Needs a closer look

The low-level Xtensa port has unresolved interrupt and FreeRTOS compatibility defects and requires hardware-focused human review.

4 open findings

What changed in this PR

Adds initial single-core ESP32-S3-DevKitM-1 BSP support, including the Xtensa CPU port, ESP-IDF integration, board configuration, and CI tooling.
新增单核 ESP32-S3-DevKitM-1 BSP，包括 Xtensa CPU 移植、ESP-IDF 集成、板级配置及 CI 工具链支持。

Changes:

Adds Xtensa vectors, context switching, startup, linker scripts, and ESP-IDF compatibility glue. / 新增 Xtensa 向量、上下文切换、启动代码、链接脚本及 ESP-IDF 兼容层。
Configures UART0, GPIO, system tick, flashing images, and BSP documentation. / 配置 UART0、GPIO、系统节拍、烧录镜像及 BSP 文档。
Registers the ESP32-S3 toolchain and BSP across CI workflows. / 在 CI 工作流中注册 ESP32-S3 工具链和 BSP。

File	Description
`tools/ci/toolchain.sh`	Adds Xtensa toolchain download. / 新增工具链下载。
`tools/ci/toolchain_bsp.yml`	Maps toolchain to BSP. / 映射工具链与 BSP。
`tools/ci/bsp_detail.yml`	Registers BSP checks. / 注册 BSP 检查。
`tools/ci/bsp_detail.py`	Adds toolchain URL. / 新增工具链地址。
`libcpu/xtensa/SConscript`	Dispatches Xtensa CPU ports. / 分派 Xtensa CPU 端口。
`libcpu/xtensa/esp32s3/SConscript`	Builds ESP32-S3 CPU sources. / 构建 CPU 源码。
`libcpu/xtensa/esp32s3/cpuport.h`	Defines context-frame policy. / 定义上下文帧策略。
`libcpu/xtensa/esp32s3/cpuport.c`	Implements stack, IRQ, and CPU glue. / 实现栈、中断及 CPU 适配。
`libcpu/xtensa/esp32s3/context_gcc.S`	Implements vectors and context switching. / 实现向量与上下文切换。
`bsp/ESP/libraries/drivers/sdkconfig.h`	Selects S3 SDK configuration. / 选择 S3 SDK 配置。
`bsp/ESP/libraries/drivers/sdkconfig_s3.h`	Supplies ESP-IDF configuration. / 提供 ESP-IDF 配置。
`bsp/ESP/libraries/drivers/Kconfig`	Adds S3 board options and pins. / 新增板型选项及引脚。
`bsp/ESP/libraries/drivers/board.c`	Adapts tick and interrupt setup. / 适配节拍及中断设置。
`bsp/ESP/ESP32_S3/.config`	Defines default BSP configuration. / 定义默认 BSP 配置。
`bsp/ESP/ESP32_S3/SConstruct`	Defines the BSP build and image conversion. / 定义构建及镜像转换。
`bsp/ESP/ESP32_S3/SConscript`	Collects BSP and wrapper groups. / 汇总 BSP 与包装层。
`bsp/ESP/ESP32_S3/rtconfig.py`	Configures compiler and linker. / 配置编译器与链接器。
`bsp/ESP/ESP32_S3/rtconfig.h`	Provides generated RT-Thread configuration. / 提供生成的系统配置。
`bsp/ESP/ESP32_S3/README.md`	Documents board build and flashing. / 说明编译与烧录流程。
`bsp/ESP/ESP32_S3/main/SConscript`	Builds the BSP application. / 构建 BSP 应用。
`bsp/ESP/ESP32_S3/main/main.c`	Adds the default shell application. / 新增默认 Shell 应用。
`bsp/ESP/ESP32_S3/Kconfig`	Defines BSP configuration roots. / 定义 BSP 配置入口。
`bsp/ESP/ESP32_S3/idf_port/src/rt-thread_balance_stub.c`	Adds ESP-IDF link shims. / 新增 ESP-IDF 链接桩。
`bsp/ESP/ESP32_S3/idf_port/src/port.c`	Adds startup-port functions. / 新增启动端口函数。
`bsp/ESP/ESP32_S3/idf_port/src/port_common.c`	Adds common startup integration. / 新增通用启动集成。
`bsp/ESP/ESP32_S3/idf_port/SConscript`	Builds the IDF port layer. / 构建 IDF 适配层。
`bsp/ESP/ESP32_S3/idf_port/ld/sections.ld`	Defines section placement. / 定义段布局。
`bsp/ESP/ESP32_S3/idf_port/ld/memory.ld`	Defines ESP32-S3 memory regions. / 定义内存区域。
`bsp/ESP/ESP32_S3/idf_port/include/freertos/task_snapshot.h`	Supplies task snapshot declarations. / 提供任务快照声明。
`bsp/ESP/ESP32_S3/idf_port/include/freertos/portmacro.h`	Maps FreeRTOS port APIs. / 映射 FreeRTOS 端口 API。
`bsp/ESP/ESP32_S3/idf_port/include/freertos/FreeRTOSConfig.h`	Configures wrapper compatibility. / 配置包装层兼容性。
`bsp/ESP/ESP32_S3/idf_port/include/freertos/FreeRTOSConfig_arch.h`	Adds Xtensa-specific settings. / 新增 Xtensa 配置。
`bsp/ESP/ESP32_S3/idf_port/include/freertos/freertos_tasks_c_additions.h`	Supplies IDF task additions. / 提供 IDF 任务扩展。
`bsp/ESP/ESP32_S3/idf_components/SConscript`	Selects ESP-IDF components. / 选择 ESP-IDF 组件。
`bsp/ESP/ESP32_S3/idf_components/include_compat/bootloader_flash.h`	Adds flash API compatibility. / 新增 Flash API 兼容层。
`bsp/ESP/ESP32_S3/idf_components/include_compat/bootloader_flash_priv.h`	Adds private flash declarations. / 新增私有 Flash 声明。
`bsp/ESP/ESP32_S3/idf_components/include_compat/atomic_var_init.h`	Restores atomic initializer compatibility. / 恢复原子初始化兼容性。
`bsp/ESP/ESP32_S3/builtin_imgs/.gitignore`	Whitelists flashing binaries. / 放行烧录二进制。
`bsp/ESP/ESP32_S3/builtin_imgs/bootloader.bin`	Supplies the prebuilt bootloader. / 提供预编译 bootloader。
`bsp/ESP/ESP32_S3/builtin_imgs/partition-table.bin`	Supplies the partition table. / 提供分区表。
`.github/workflows/manual_trigger_update_all.yml`	Adds manual toolchain installation. / 新增手动工具链安装。
`.github/workflows/manual_trigger_scons_except_STM32_all.yml`	Adds BSP matrix build. / 新增 BSP 矩阵构建。
`.github/workflows/manual_dist.yml`	Adds distribution support. / 新增发布包支持。
`.github/workflows/manual_bsp_build.yml`	Adds manual BSP builds. / 新增手动 BSP 构建。
`.github/workflows/bsp_buildings.yml`	Adds automated toolchain setup. / 新增自动工具链配置。
`.github/ALL_BSP_COMPILE.json`	Registers the BSP in CI. / 在 CI 中注册 BSP。

🧠 Review effort: Balanced

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

cms19859230182-lang · 2026-10-13T04:02:21Z

@Rbb666 Copilot 提的几条都已经改好并标记已解决了（加锁宏、UART0 中断级别、README 补充浮点/AI 指令限制）。目前剩下的 Tools 检查失败是上游的老问题，和本 PR 无关。麻烦有空再帮忙看一下，谢谢！

Rbb666 · 2026-10-13T04:42:48Z

@Rbb666 Copilot 提的几条都已经改好并标记已解决了（加锁宏、UART0 中断级别、README 补充浮点/AI 指令限制）。目前剩下的 Tools 检查失败是上游的老问题，和本 PR 无关。麻烦有空再帮忙看一下，谢谢！

好的，我今天晚点看看

cms19859230182-lang · 2026-10-14T02:37:59Z

@Rbb666 之前提的审查意见我都改完了，麻烦有空再看一眼，谢谢！

cms19859230182-lang · 2026-10-15T06:06:06Z

@Rbb666 两处都改好了：ioctl.h 已改用 RTT_ROOT 绝对路径，并验证关掉 Finsh 能编过；SConscript 已改为遍历 packages/（只跳过 esp-idf），额外开的软件包也能编进去。麻烦再看一下，谢谢！

cms19859230182-lang · 2026-10-19T05:40:36Z

@Rbb666 dist 后 RTT_ROOT 的问题已在 9abdfc3c11 修好，本地和 CI 的 ESP32S3 都过了，有空再看一眼谢谢！

…Thread#11844 Prepend idf_port freertos on Env before Drivers SConscript (C3/C6/S3) so portMUX_TYPE wins over FreeRTOS_Wrapper. S3 idf_port also prepends soc include+register paths for interrupt_core0_reg.h.

…for RT-Thread#11844

fix xtensa_context.h include path via find_package_path CPPPATH

github-actions Bot added BSP BSP: ESP32 BSP related with ESP libcpu labels Sep 28, 2026

github-actions Bot added the BSP: WCH BSP related with WCH label Sep 28, 2026

cms19859230182-lang requested review from kurisaW and supperthomas as code owners September 28, 2026 13:24

github-actions Bot added action github action yml imporve tools labels Sep 28, 2026

cms19859230182-lang force-pushed the bsp/esp32s3-devkitm-1 branch 2 times, most recently from 3520458 to 16ecc10 Compare October 10, 2026 04:07

Rbb666 requested a balanced review from Copilot October 10, 2026 10:40

Copilot started reviewing on behalf of Rbb666 October 10, 2026 10:41

View session

Copilot AI reviewed Oct 10, 2026

View reviewed changes

Comment thread bsp/ESP/ESP32_S3/idf_port/include/freertos/portmacro.h Outdated

Comment thread bsp/ESP/libraries/drivers/board.c Outdated

Comment thread bsp/ESP/ESP32_S3/README.md Outdated

Comment thread bsp/ESP/ESP32_S3/builtin_imgs/.gitignore Outdated

cms19859230182-lang force-pushed the bsp/esp32s3-devkitm-1 branch 2 times, most recently from 833dfcc to d976d97 Compare October 10, 2026 13:32

Rbb666 reviewed Oct 15, 2026

View reviewed changes

Comment thread bsp/ESP/ESP32_S3/rtconfig.py Outdated

Comment thread bsp/ESP/ESP32_S3/SConscript Outdated

Rbb666 reviewed Oct 16, 2026

View reviewed changes

Comment thread bsp/ESP/ESP32_S3/rtconfig.py Outdated

cms19859230182-lang force-pushed the bsp/esp32s3-devkitm-1 branch from 9abdfc3 to 8d3dd6e Compare October 25, 2026 07:57

cms19859230182-lang force-pushed the bsp/esp32s3-devkitm-1 branch from 05f9ab7 to 2d2793f Compare October 26, 2026 08:44

cms19859230182-lang added a commit to cms19859230182-lang/rt-thread that referenced this pull request Oct 26, 2026

[bsp][esp] fix configMAX_PRIORITIES redefine + S3 esp_newlib include …

9c0645a

…for RT-Thread#11844

cms19859230182-lang marked this pull request as draft October 27, 2026 15:27

cms19859230182-lang force-pushed the bsp/esp32s3-devkitm-1 branch from 9c0645a to a64d76e Compare October 27, 2026 23:38

[bsp][esp32-s3] add ESP32-S3-DevKitM-1 support

5bb6fce

fix xtensa_context.h include path via find_package_path CPPPATH

cms19859230182-lang force-pushed the bsp/esp32s3-devkitm-1 branch from a64d76e to 5bb6fce Compare October 28, 2026 07:36

Conversation

cms19859230182-lang commented Sep 28, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

拉取/合并请求描述：(PR description)

为什么提交这份PR (why to submit this PR)

你的解决方案是什么 (what is your solution)

请提供验证的bsp和config (provide the config and bsp)

当前拉取/合并请求的状态 Intent for your PR

代码质量 Code Quality：

Uh oh!

github-actions Bot commented Sep 28, 2026

🛠 操作步骤 | Steps

Uh oh!

github-actions Bot commented Sep 28, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

MemBrowse Memory Report · Explore what changed →

Uh oh!

github-actions Bot commented Sep 28, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

📌 Code Review Assignment

🏷️ Tag: workflow

📊 Current Review Status (Last Updated: 2026-10-28 07:38 CST)

📝 Review Instructions

Uh oh!

Rbb666 commented Sep 28, 2026

Uh oh!

cms19859230182-lang commented Sep 29, 2026

Uh oh!

cms19859230182-lang commented Sep 29, 2026

Uh oh!

cms19859230182-lang commented Sep 29, 2026

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

🔵 Needs a closer look

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

cms19859230182-lang commented Oct 13, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Rbb666 commented Oct 13, 2026

Uh oh!

cms19859230182-lang commented Oct 14, 2026

Uh oh!

Uh oh!

Uh oh!

cms19859230182-lang commented Oct 15, 2026

Uh oh!

Uh oh!

cms19859230182-lang commented Oct 19, 2026

Uh oh!

This branch has not been deployed

Reviewers

Uh oh!

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

cms19859230182-lang commented Sep 28, 2026 •

edited

Loading

github-actions Bot commented Sep 28, 2026 •

edited

Loading

github-actions Bot commented Sep 28, 2026 •

edited

Loading

cms19859230182-lang commented Oct 13, 2026 •

edited

Loading