From 4e8ccd166f591f7b894aa917eb4ed52b02154ac5 Mon Sep 17 00:00:00 2001 From: Geoffroy Van Cutsem Date: Wed, 24 Mar 2021 14:26:01 +0100 Subject: [PATCH] doc: create a copy of the scenario file before making modifications Instruct the user to create a copy of the scenario XML file if modifications are needed. That modified copy should subsequently be used for building ACRN. Signed-off-by: Geoffroy Van Cutsem --- doc/tutorials/using_partition_mode_on_nuc.rst | 15 ++++++--------- 1 file changed, 6 insertions(+), 9 deletions(-) diff --git a/doc/tutorials/using_partition_mode_on_nuc.rst b/doc/tutorials/using_partition_mode_on_nuc.rst index ac82b565b..2de64a402 100644 --- a/doc/tutorials/using_partition_mode_on_nuc.rst +++ b/doc/tutorials/using_partition_mode_on_nuc.rst @@ -139,11 +139,6 @@ Update ACRN Hypervisor Image 04:00.0 Ethernet controller: Intel Corporation I210 Gigabit Network Connection (rev 03) Subsystem: Intel Corporation I210 Gigabit Network Connection - .. note:: - Verify the ``pci_devs`` defined for VM0 and VM1 in the - ``misc/config_tools/data/whl-ipc-i7/logical_partition.xml`` - with the information reported by the ``lspci -vv`` command. - #. Clone the ACRN source code and configure the build options. Refer to :ref:`getting-started-building` to set up the ACRN build @@ -157,7 +152,12 @@ Update ACRN Hypervisor Image $ cd acrn-hypervisor $ git checkout v2.4 - Build the ACRN hypervisor and ACPI binaries for pre-launched VMs with default xmls: +#. Check the ``pci_devs`` sections in ``misc/config_tools/data/whl-ipc-i7/logical_partition.xml`` + for each pre-launched VM to ensure you are using the right PCI device BDF information (as + reported by ``lspci -vv``). If you need to make changes to this file, create a copy of it and + use it subsequently when building ACRN (``SCENARIO=/path/to/newfile.xml``). + +#. Build the ACRN hypervisor and ACPI binaries for pre-launched VMs with default xmls: .. code-block:: none @@ -179,9 +179,6 @@ Update ACRN Hypervisor Image The above command output should contain the ``GRUB`` keyword. -#. Check or update the BDF information of the PCI devices for each - pre-launched VM; check it in the ``misc/config_tools/data/whl-ipc-i7/logical_partition.xml``. - #. Copy the artifact ``acrn.bin``, ``ACPI_VM0.bin``, and ``ACPI_VM1.bin`` to the ``/boot`` directory on NVME: #. Copy ``acrn.bin``, ``ACPI_VM1.bin`` and ``ACPI_VM0.bin`` to a removable disk.