[docs] point QEMU Linux quick start at qemu-nographic.sh - #11793
Conversation
|
👋 感谢您对 RT-Thread 的贡献!Thank you for your contribution to RT-Thread! 为确保代码符合 RT-Thread 的编码规范,请在你的仓库中执行以下步骤运行代码格式化工作流(如果格式化CI运行失败)。 🛠 操作步骤 | Steps
完成后,提交将自动更新至 如有问题欢迎联系我们,再次感谢您的贡献!💐 |
📌 Code Review Assignment🏷️ Tag: documentationReviewers: @CXSforHPU @GorrayLi @lianux-mm Changed Files (Click to expand)
📊 Current Review Status (Last Updated: 2026-09-10 13:53 CST)
📝 Review Instructions
|
The quick start only ever mentions ./qemu.sh, and its file table omits the qemu-nographic scripts entirely. qemu.sh passes -serial stdio without -nographic, so QEMU opens a GTK window for the emulated CLCD. On a headless machine or over SSH it stops at "gtk initialization failed", with nothing in the guide explaining what to do next, even though the BSP already ships qemu-nographic.sh for exactly this case. Add both nographic scripts to the file table and document them where the project is first run.
3a533ce to
e1d3b34
Compare
Problem
The QEMU Linux quick start only ever mentions
./qemu.sh, and its file table omits theqemu-nographicscripts entirely.qemu.shpasses-serial stdiowithout-nographic, so QEMU opens a GTK window for the emulated CLCD. On a headless machine or over SSH it stops atgtk initialization failed(reproduced by running it withDISPLAYunset), with nothing in the guide explaining what to do next — even though the BSP already shipsqemu-nographic.shfor exactly this case, and the BSP README itself recommends it for servers.Change
qemu-nographicscripts to the file table in chapter 4./qemu-nographic.shin section 5.2, right where the project is first run