[docs] point QEMU Linux quick start at qemu-nographic.sh - #11793
Conversation
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.
|
Cheng Li seems not to be a GitHub user. You need a GitHub account to be able to sign the CLA. If you have already a GitHub account, please add the email address used for this commit to your account. You have signed the CLA already but the status is still pending? Let us recheck it. |
|
👋 感谢您对 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-09 23:53 CST)
📝 Review Instructions
|
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