github/acrn-hypervisor
1
0
Fork 0
mirror of https://github.com/projectacrn/acrn-hypervisor.git synced 2025-07-05 03:26:29 +00:00
Code Issues Projects Releases Wiki Activity

Merge pull request #3567 from ClaudZhang1995/zy4

Browse Source 
doc: update Build ACRN from Source
This commit is contained in:
deb-intel 2019-09-09 19:13:25 -04:00 committed by GitHub
commit 67f3da2e97
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 7 additions and 27 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

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

@ -276,7 +276,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.
@ -294,7 +296,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,35 +306,14 @@ 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