From e1fe4cf2ea0f8717da3b2e879a7ba7ac23c325de Mon Sep 17 00:00:00 2001 From: Huaqi Fang <578567190@qq.com> Date: Thu, 25 Jul 2024 16:34:56 +0800 Subject: [PATCH] doc: doc about QEMU_MC_EXTOPT and QEMU_CPU_EXTOPT Signed-off-by: Huaqi Fang <578567190@qq.com> --- doc/source/changelog.rst | 2 ++ doc/source/design/soc/evalsoc.rst | 5 +++++ 2 files changed, 7 insertions(+) diff --git a/doc/source/changelog.rst b/doc/source/changelog.rst index 547a1697..dac4a3d0 100644 --- 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 index db8d2ffe..b9b4a618 100644 --- 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