docs: Add --qemu-extra-args option to QEMU guide

This commit is contained in:
luweike
2025-09-19 16:31:23 +08:00
parent 649741fa9d
commit bfe6b51ac9
2 changed files with 28 additions and 0 deletions

View File

@@ -166,6 +166,20 @@ The provided flash image must meet the following requirements for proper emulati
- The flash file includes all required binaries, such as the bootloader, partition table, and application firmware, placed at their respective memory offsets.
Passing Extra Arguments to QEMU
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Use the ``--qemu-extra-args`` option to pass additional arguments directly to QEMU. This is useful when you need to enable advanced QEMU features or debugging options. For example:
.. code-block:: console
idf.py qemu --qemu-extra-args="-d in_asm,cpu" monitor
This command starts QEMU with the specified extra arguments. You can use this option to pass any valid QEMU command-line arguments, such as enabling debug output, configuring devices, or other advanced features.
For more available QEMU options, please refer to the `official QEMU documentation <https://www.qemu.org/docs/master/>`_ or run ``idf.py qemu --help``.
Emulating Secure Boot
~~~~~~~~~~~~~~~~~~~~~