doc: doc about QEMU_MC_EXTOPT and QEMU_CPU_EXTOPT

Signed-off-by: Huaqi Fang <[email protected]>
Nuclei-Software · Jul 25, 2024 · e1fe4cf · e1fe4cf
1 parent 9ca5d74
commit e1fe4cf
Show file tree

Hide file tree

Showing 2 changed files with 7 additions and 0 deletions.
diff --git a/doc/source/changelog.rst b/doc/source/changelog.rst
@@ -38,6 +38,8 @@ This is **development** release version ``0.7.0`` of Nuclei SDK.
   - Add core ``n200e/n202/n202e`` and remove ``n205/n205e/n305/n307/n307fd`` which can be replaced by ``n203/n203e/n300/n300f/n300fd``
   - Prebuilt IAR projects and workbench are updated due to evalsoc support changes for plic and clint interrupt modes.
   - Add ``SYSCLK`` make variable for manually set default SYSTEM_CLOCK macro in evalsoc, it is useful for ``CODESIZE=1`` case
+  - Add ``QEMU_MC_EXTOPT`` make variable to pass extra Nuclei Qemu ``-M`` machine options for evalsoc.
+  - Add ``QEMU_CPU_EXTOPT`` make variable to pass extra Nuclei Qemu ``-cpu`` cpu options for evalsoc.
 
 V0.6.0
 ------

diff --git a/doc/source/design/soc/evalsoc.rst b/doc/source/design/soc/evalsoc.rst
@@ -86,6 +86,11 @@ Extra make variables supported only in this SoC and used internally only by Nucl
   * **XLCFG_xxx** make variables such as **XLCFG_CIDU**, **XLCFG_CCM**, **XLCFG_TEE** and **XLCFG_SMPU** which are used to overwrite default macros defined in ``cpufeature.h`` which will affect **XXX_PRESENT** macros in ``evalsoc.h``, introduced in 0.7.0 release.
   * **CODESIZE**: it is used to control whether remove all template routine code for interrupt and exception and banner print code to measure basic code size requirement for evalsoc when ``CODESIZE=1``
   * **SYSCLK``: it is used together with ``CODESIZE=1`` to overwrite default ``SYSTEM_CLOCK`` macro value for different bitstream, eg. ``SYSCLK=50000000 CODESIZE=1``, it will set default SYSTEM_CLOCK to 50000000.
+  * **QEMU_MC_EXTOPT** is used to pass extra options to Nuclei Qemu ``-M`` machine options for evalsoc,
+    please dont pass any extra ``,`` to this make variable, you can pass such as ``QEMU_MC_EXTOPT=debug=1`` but not pass ``QEMU_MC_EXTOPT=,debug=1``
+  * **QEMU_CPU_EXTOPT** is used to pass extra options to Nuclei Qemu ``-cpu`` cpu options for evalsoc,
+    please dont pass any extra ``,`` to this make variable, you can pass such as ``QEMU_CPU_EXTOPT=vlen=512`` but
+    not pass ``QEMU_CPU_EXTOPT=,vlen=512``
 
 .. code-block:: shell