Skip to content

drivers/spi: QEMU virtual SPI loopback bus for utest (#11972) - #11979

Open
cms19859230182-lang wants to merge 2 commits into
RT-Thread:masterfrom
cms19859230182-lang:fix/11972-spi-qemu-virt
Open

drivers/spi: QEMU virtual SPI loopback bus for utest (#11972)#11979
cms19859230182-lang wants to merge 2 commits into
RT-Thread:masterfrom
cms19859230182-lang:fix/11972-spi-qemu-virt

Conversation

@cms19859230182-lang

@cms19859230182-lang cms19859230182-lang commented Nov 3, 2026

Copy link
Copy Markdown
Contributor

摘要

为 #11972 清单里 SPI／QEMU 格增加固件内虚拟 SPI bus（软件 MOSI↔MISO 回环），使现有 components.drivers.spi.loopback utest 在 qemu-vexpress-a9 上全绿，无需真实 PL022 模型。

本 PR 仅覆盖 SPI／QEMU 子项；清单其它设备格不在范围内，勿视为整份 #11972 已完成。

改动文件

  • components/drivers/spi/utest/spi_virt_bus.c（新建）：纯软件 SPI bus，默认名 spi2；configure + xfer(memcpy 回环) + rt_spi_bus_register + INIT_BOARD_EXPORT
  • components/drivers/spi/utest/SConscript：纳入 spi_virt_bus.c；CPPPATH 补 utilities/utest 与 drivers/include
  • components/drivers/spi/utest/Kconfig：RT_UTEST_SPI_LOOPBACK_BUS_NAME 默认 spi2，补充 qemu 说明
  • bsp/qemu-vexpress-a9/rtconfig.h：打开 RT_USING_UTEST／RT_UTEST_SPI_LOOPBACK，bus 名 spi2
  • bsp/qemu-vexpress-a9/.config：与上面对齐的 Kconfig 符号

验证

cd bsp/qemu-vexpress-a9
scons -j$(nproc)
# QEMU
{ echo "utest_run components.drivers.spi.loopback"; sleep 25; echo "quit"; sleep 3; } | \
  timeout 60 qemu-system-arm -M vexpress-a9 -smp cpus=2 -kernel rtthread.bin -nographic -sd sd.bin

摘录：

[I/utest] SPI loopback test: connect MOSI and MISO on bus spi2.
...
[I/utest] [  PASSED  ] [ result   ] testcase (components.drivers.spi.loopback)
[I/utest] [  PASSED  ] [ result   ] 1 tests.

时钟矩阵 100k–10M Hz；数据长度 1–512 bytes（全双工 sendrecv／transfer／transfer_message）均通过。

English

Add an in-firmware virtual SPI loopback bus (software MOSI↔MISO) so components.drivers.spi.loopback passes on qemu-vexpress-a9 without a PL022 model. Default bus name spi2. Fixes the SPI/QEMU checklist item of #11972 only.

Fixes #11972

@cms19859230182-lang
drivers/spi: add QEMU virtual SPI loopback bus for utest (RT-Thread#1…
f60b434 
…1972)

Register a pure-software SPI bus (default name spi2) with memcpy
loopback xfer so components.drivers.spi.loopback passes on
qemu-vexpress-a9 without a PL022 model. Fix utest include/CPPPATH
and align Kconfig/rtconfig bus name.

Verified: scons + qemu utest_run components.drivers.spi.loopback PASSED.

Fixes RT-Thread#11972 (SPI/QEMU checklist item).
@github-actions

github-actions Bot commented Nov 3, 2026

Copy link
Copy Markdown

👋 感谢您对 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

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

  2. 点击 Run workflow | Click Run workflow

  • Use workflow from 保持默认分支（通常为 master）
    Keep the default branch (usually master) in Use workflow from
  • 在 branch 输入框填写 PR 分支 fix/11972-spi-qemu-virt
    Enter PR branch fix/11972-spi-qemu-virt in the branch field
  • 设置需排除的文件/目录（目录请以"/"结尾）
    Set files/directories to exclude (directories should end with "/")
  1. 等待工作流完成 | Wait for the workflow to complete
    格式化后的代码将作为独立提交推送至你的分支。
    The formatting changes will be pushed to your branch as a separate commit.

完成后，提交将自动更新至 fix/11972-spi-qemu-virt 分支，关联的 Pull Request 也会同步更新。
Once completed, commits will be pushed to the fix/11972-spi-qemu-virt 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

github-actions Bot commented Nov 3, 2026

Copy link
Copy Markdown

📌 Code Review Assignment

🏷️ Tag: components

Reviewers: @Maihuanyi

Changed Files (Click to expand)
  • components/drivers/spi/utest/Kconfig
  • components/drivers/spi/utest/SConscript
  • components/drivers/spi/utest/spi_virt_bus.c

🏷️ Tag: components_driver_spi

Reviewers: @Liang1795 @wdfk-prog

Changed Files (Click to expand)
  • components/drivers/spi/utest/Kconfig
  • components/drivers/spi/utest/SConscript
  • components/drivers/spi/utest/spi_virt_bus.c

📊 Current Review Status (Last Updated: 2026-11-03 10:14 CST)

📝 Review Instructions

  1. 维护者可以通过单击此处来刷新审查状态: 🔄 刷新状态
    Maintainers can refresh the review status by clicking here: 🔄 Refresh Status

  2. 确认审核通过后评论 LGTM/lgtm
    Comment LGTM/lgtm after confirming approval

  3. PR合并前需至少一位维护者确认
    PR must be confirmed by at least one maintainer before merging

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

@cms19859230182-lang
drivers/spi: fix clang-format violations in spi_virt_bus.c
674309b 
Fix the 'Check File Format and License' CI job failure:

- put the spi_virt_ops initializer brace on the assignment line
- add the missing newline at end of file

No functional change.
@github-actions

github-actions Bot commented Nov 3, 2026

Copy link
Copy Markdown

MemBrowse Memory Report · Explore what changed →

No memory changes detected for:

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

@cms19859230182-lang cms19859230182-lang mentioned this pull request Nov 3, 2026
Open
13 of 40 tasks

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

No reviews

Assignees

No one assigned

Labels

BSP component: drivers/spi component: drivers Component

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

[Feature] QEMU虚拟设备测试和模拟：为Z版本的发布做CI的自动化测试

1 participant

@cms19859230182-lang