From 687471b1bc3c7b1208e185b58135068397efb1ff Mon Sep 17 00:00:00 2001 From: Tang Zaozao Date: Tue, 4 Aug 2026 10:31:27 +0800 Subject: [PATCH] docs(dragon/q6a,q8b): add reboot-after-SPI-flash warning Add a warning right after the SPI boot firmware flash commands in the Dragon Q6A and Q8B low-level docs: - Re-plug device power - Run `edl-ng reset` in the terminal Without this hint, users can mistake a successful flash for a failed one because the device keeps booting with the old bootloader. The warning tells them to restart the device after flashing. Both Chinese (docs/) and English (i18n/en/) versions updated in lockstep. Signed-off-by: Tang Zaozao --- docs/dragon/q6a/low-level-dev/spi-fw.md | 7 +++++++ docs/dragon/q8b/low-level-dev/spi-fw.md | 7 +++++++ .../current/dragon/q6a/low-level-dev/spi-fw.md | 7 +++++++ .../current/dragon/q8b/low-level-dev/spi-fw.md | 7 +++++++ 4 files changed, 28 insertions(+) diff --git a/docs/dragon/q6a/low-level-dev/spi-fw.md b/docs/dragon/q6a/low-level-dev/spi-fw.md index 0b49090a0..d29b71a7d 100644 --- a/docs/dragon/q6a/low-level-dev/spi-fw.md +++ b/docs/dragon/q6a/low-level-dev/spi-fw.md @@ -103,6 +103,13 @@ sudo edl-ng --memory=spinor rawprogram rawprogram0.xml patch0.xml --loader=prog_ +:::warning 烧录完成后请重启设备 +SPI 启动固件烧录成功后，请按以下任一方式重启设备： + +- 重新插拔设备电源 +- 在终端执行 `edl-ng reset` 命令 +::: + ## 擦除 SPI 启动固件 擦除 SPI 启动固件将导致设备无法启动，需要重新烧录 SPI 启动固件才可正常启动，若非必要，请勿擦除 SPI 启动固件。 diff --git a/docs/dragon/q8b/low-level-dev/spi-fw.md b/docs/dragon/q8b/low-level-dev/spi-fw.md index 14e5d19a5..e97b9022d 100644 --- a/docs/dragon/q8b/low-level-dev/spi-fw.md +++ b/docs/dragon/q8b/low-level-dev/spi-fw.md @@ -103,6 +103,13 @@ sudo edl-ng --memory=spinor rawprogram rawprogram0.xml patch0.xml --loader=prog_ +:::warning 烧录完成后请重启设备 +SPI 启动固件烧录成功后，请按以下任一方式重启设备： + +- 重新插拔设备电源 +- 在终端执行 `edl-ng reset` 命令 +::: + ## 擦除 SPI 启动固件 擦除 SPI 启动固件将导致设备无法启动，需要重新烧录 SPI 启动固件才可正常启动，若非必要，请勿擦除 SPI 启动固件。 diff --git a/i18n/en/docusaurus-plugin-content-docs/current/dragon/q6a/low-level-dev/spi-fw.md b/i18n/en/docusaurus-plugin-content-docs/current/dragon/q6a/low-level-dev/spi-fw.md index cac11c005..bbd7e7884 100644 --- a/i18n/en/docusaurus-plugin-content-docs/current/dragon/q6a/low-level-dev/spi-fw.md +++ b/i18n/en/docusaurus-plugin-content-docs/current/dragon/q6a/low-level-dev/spi-fw.md @@ -103,6 +103,13 @@ sudo edl-ng --memory=spinor rawprogram rawprogram0.xml patch0.xml --loader=prog_ +:::warning Restart the device after flashing +After the SPI boot firmware is successfully flashed, please restart the device using either of the following methods: + +- Re-plug the device power +- Run the `edl-ng reset` command in the terminal +::: + ## Erase SPI Boot Firmware Erasing the SPI boot firmware will prevent the device from booting. You will need to re-flash the SPI boot firmware to restore normal operation. Do not erase the SPI boot firmware unless absolutely necessary. diff --git a/i18n/en/docusaurus-plugin-content-docs/current/dragon/q8b/low-level-dev/spi-fw.md b/i18n/en/docusaurus-plugin-content-docs/current/dragon/q8b/low-level-dev/spi-fw.md index a56fd26af..51794b6d9 100644 --- a/i18n/en/docusaurus-plugin-content-docs/current/dragon/q8b/low-level-dev/spi-fw.md +++ b/i18n/en/docusaurus-plugin-content-docs/current/dragon/q8b/low-level-dev/spi-fw.md @@ -103,6 +103,13 @@ sudo edl-ng --memory=spinor rawprogram rawprogram0.xml patch0.xml --loader=prog_ +:::warning Restart the device after flashing +After the SPI boot firmware is successfully flashed, please restart the device using either of the following methods: + +- Re-plug the device power +- Run the `edl-ng reset` command in the terminal +::: + ## Erase SPI Boot Firmware Erasing the SPI boot firmware will prevent the device from booting. You must reflash the SPI boot firmware before the device can boot normally. Do not erase the SPI boot firmware unless necessary.