OrgACRN
/
acrn-hypervisor
mirror of https://github.com/projectacrn/acrn-hypervisor.git
1
0
Fork 0
Code Issues Releases Wiki Activity

doc: update Build ACRN from Source 

Signed-off-by: yunzha4x <yunx.zhang@intel.com>
This commit is contained in:
yunzha4x 2019-09-06 12:02:50 +08:00
parent cd40980d5f
commit 4041275f78
1 changed files with 7 additions and 27 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

32
doc/getting-started/building-from-source.rst
View File

@ -275,7 +275,9 @@ the hypervisor using the updated ``.config``.
.. code-block:: none .. code-block:: none
$ make menuconfig # Modify the configurations per your needs # Modify the configurations per your needs
$ cd ../ # Enter top-level folder of acrn-hypervisor source
$ make menuconfig -C hypervisor BOARD=kbl-nuc-i7 <select industry scenario>
.. note:: .. note::
Menuconfig is python3 only. Menuconfig is python3 only.
@ -293,7 +295,6 @@ Now you can build all these components in one go as follows:
.. code-block:: none .. code-block:: none
$ cd ../ # Enter top-level folder of acrn-hypervisor source
$ make FIRMWARE=uefi # Build the UEFI hypervisor with the new .config $ make FIRMWARE=uefi # Build the UEFI hypervisor with the new .config
The build results are found in the ``build`` directory. You can specify The build results are found in the ``build`` directory. You can specify
@ -305,34 +306,13 @@ If you only need the hypervisor, then use this command:
.. code-block:: none .. code-block:: none
$ make clean # Remove files previously built $ make clean # Remove files previously built
$ make FIRMWARE=uefi hypervisor # This will only build the hypervisor $ make -C hypervisor
$ make -C misc/efi-stub HV_OBJDIR=$PWD/hypervisor/build EFI_OBJDIR=$PWD/hypervisor/build
You could also use ``FIRMWARE=sbl`` instead, to build the Intel SBL The acrn.efi will be generated in directory: . /hypervisor/build/acrn.efi
(`Slim bootloader (`Slim bootloader
<https://www.intel.com/content/www/us/en/design/products-and-solutions/technologies/slim-bootloader/overview.html>`_) <https://www.intel.com/content/www/us/en/design/products-and-solutions/technologies/slim-bootloader/overview.html>`_)
hypervisor. hypervisor.
Follow the same instructions to boot and test the images you created from your build. Follow the same instructions to boot and test the images you created from your build.
Save as default configuration
*****************************
Currently the ACRN hypervisor looks for default configurations under
``hypervisor/arch/x86/configs/<BOARD>.config``, where ``<BOARD>`` is the
specified platform. The following steps allow you to create a defconfig for
another platform based on a current one.
.. code-block:: none
$ cd hypervisor
$ make defconfig BOARD=nuc6cayh
$ make menuconfig # Modify the configurations
$ make savedefconfig # The minimized config reside at build/defconfig
$ cp build/defconfig arch/x86/configs/xxx.config
Then you can re-use that configuration by passing the name (``xxx`` in the
example above) to 'BOARD=':
.. code-block:: none
$ make defconfig BOARD=xxx