diff --git a/docs/en/api-guides/tools/qemu.rst b/docs/en/api-guides/tools/qemu.rst index 43c1be5fb1..f88766a4a3 100644 --- a/docs/en/api-guides/tools/qemu.rst +++ b/docs/en/api-guides/tools/qemu.rst @@ -165,8 +165,8 @@ The provided flash image must meet the following requirements for proper emulati - The flash file size matches the value specified by :ref:`CONFIG_ESPTOOLPY_FLASHSIZE` in the project configuration. - The flash file includes all required binaries, such as the bootloader, partition table, and application firmware, placed at their respective memory offsets. + Emulating Secure Boot ~~~~~~~~~~~~~~~~~~~~~ QEMU supports emulation of secure boot v2 scheme. Please keep :ref:`CONFIG_SECURE_BOOT_FLASH_BOOTLOADER_DEFAULT` enabled to include signed bootloader image into the QEMU image artifact. - diff --git a/docs/zh_CN/api-guides/tools/qemu.rst b/docs/zh_CN/api-guides/tools/qemu.rst index 87ba8729a2..3d4465f700 100644 --- a/docs/zh_CN/api-guides/tools/qemu.rst +++ b/docs/zh_CN/api-guides/tools/qemu.rst @@ -150,8 +150,23 @@ QEMU 支持 eFuse 的仿真,可用来测试安全启动和 flash 加密等与 idf.py qemu --efuse-file my_efuse.bin efuse-burn {IDF_TARGET_CRYPT_CNT} 1 idf.py qemu --efuse-file my_efuse.bin monitor +指定 flash 映像 +~~~~~~~~~~~~~~~ + +默认情况下,QEMU 使用构建目录中的 ``qemu_flash.bin`` 文件作为 flash 映像。该文件是根据构建目录中 ``flash_args`` 文件提供的项目信息生成的。如果想使用其他 flash 映像,可通过 ``--flash-file`` 选项进行指定。例如: + +.. code-block:: console + + idf.py qemu --flash-file my_flash.bin monitor + + +所提供的 flash 映像必须满足以下要求,以确保正确模拟: + +- flash 文件大小与项目配置中 :ref:`CONFIG_ESPTOOLPY_FLASHSIZE` 的指定值相同。 +- flash 文件包括所有必需的二进制文件,如引导加载程序、分区表和应用程序固件,这些文件位于各自的内存偏移量处。 + + 模拟安全启动 ~~~~~~~~~~~~~ QEMU 支持模拟安全启动 v2 机制。请保持 :ref:`CONFIG_SECURE_BOOT_FLASH_BOOTLOADER_DEFAULT` 处于启用状态,将签名的引导加载程序镜像嵌入到 QEMU 的镜像文件中。 -