alex/esp-idf
1
0
Fork 0
mirror of https://github.com/espressif/esp-idf.git synced 2025-08-10 04:43:33 +00:00
Code Issues Packages Projects Releases Wiki Activity

feat(qemu): add a CLI option for graphics output

Browse Source
This commit is contained in:
Ivan Grokhotkov
2023-12-13 11:58:49 +08:00
parent 459422f75f
commit d9983c0039
2 changed files with 37 additions and 4 deletions
Download Patch File Download Diff File Expand all files Collapse all files

21
docs/en/api-guides/tools/qemu.rst
View File

@@ -21,6 +21,9 @@ If you are using a different platform, you need to build QEMU from source. Refer
Usage
-----
Running an Application
~~~~~~~~~~~~~~~~~~~~~~
To run an IDF application in QEMU, use the following command:
.. code-block:: console
@@ -29,6 +32,9 @@ To run an IDF application in QEMU, use the following command:
This command builds the application, starts QEMU and opens :doc:`IDF monitor <idf-monitor>`, connecting it to the emulated UART port. You can see the console output of the application and interact with it. IDF Monitor also provides automatic decoding of panic backtraces and UART core dumps.
Debugging
~~~~~~~~~
To debug an application in QEMU, use the following command:
.. code-block:: console
@@ -62,3 +68,18 @@ It is also possible to run QEMU without the IDF Monitor:
idf.py qemu
In this case, the IDF Monitor is not used, and you can interact with QEMU process directly. To switch between the emulated UART console and QEMU console ("QEMU monitor"), use Ctrl-A shortcut. For example, to exit QEMU, press Ctrl-A, then type ``q`` and press Enter. You can use the QEMU console to enter commands, such as for inspecting registers and memory.
Graphics Support
~~~~~~~~~~~~~~~~
QEMU supports a virtual framebuffer device. This device doesn't exist in the real {IDF_TARGET_NAME} hardware, but it can be used to test graphics applications in QEMU.
To launch QEMU with a virtual framebuffer device enabled, use the following command:
.. code-block:: console
idf.py qemu --graphics monitor
When the ``--graphics`` option is used, QEMU opens an additional window where the framebuffer contents are displayed.
To use the virtual framebuffer device in your application, you can add the `espressif/esp_lcd_qemu_rgb <https://components.espressif.com/components/espressif/esp_lcd_qemu_rgb>`_ component to your project. This component provides an esp_lcd compatible driver for the virtual framebuffer device.