From f094ae8e312f797db656f8ea5078eff194fc87b8 Mon Sep 17 00:00:00 2001 From: Shixiong Zhang Date: Sun, 27 Sep 2020 02:20:43 -0400 Subject: [PATCH] doc: add the iasl dependence From V2.2, we use the iasl tool to compile offline ACPI binary for pre-launched VMs while building ACRN, so we need to install the iasl tool in the ACRN building environment. This doc is to describe how to install the iasl tool and specify the version of iasl at the chapter Install build tools and dependencies. Tracked-On: #5350 Signed-off-by: Shixiong Zhang --- doc/getting-started/building-from-source.rst | 3 ++- doc/getting-started/rt_industry_ubuntu.rst | 13 ++++--------- 2 files changed, 6 insertions(+), 10 deletions(-) diff --git a/doc/getting-started/building-from-source.rst b/doc/getting-started/building-from-source.rst index 76ea7a344..1a80bcee0 100644 --- a/doc/getting-started/building-from-source.rst +++ b/doc/getting-started/building-from-source.rst @@ -88,7 +88,8 @@ Install the necessary tools for the following systems: $ wget https://acpica.org/sites/acpica/files/acpica-unix-20191018.tar.gz $ tar zxvf acpica-unix-20191018.tar.gz $ cd acpica-unix-20191018 - $ make clean && make iasl && make install + $ make clean && make iasl + $ sudo cp ./generate/unix/bin/iasl /usr/sbin/ .. note:: ACRN requires ``gcc`` version 7.3.* (or higher) and ``binutils`` version diff --git a/doc/getting-started/rt_industry_ubuntu.rst b/doc/getting-started/rt_industry_ubuntu.rst index 3d181960e..6fd877510 100644 --- a/doc/getting-started/rt_industry_ubuntu.rst +++ b/doc/getting-started/rt_industry_ubuntu.rst @@ -154,10 +154,8 @@ Build the ACRN Hypervisor on Ubuntu bison $ sudo pip3 install kconfiglib - $ wget https://acpica.org/sites/acpica/files/acpica-unix-20191018.tar.gz - $ tar zxvf acpica-unix-20191018.tar.gz - $ cd acpica-unix-20191018 - $ make clean && make iasl && make install + + Follow the `Install IASL in Ubuntu for User VM launch`_ section to install ``iasl``. #. Get the ACRN source code: @@ -317,14 +315,11 @@ The User VM will be launched by OVMF, so copy it to the specific folder: Install IASL in Ubuntu for User VM launch ----------------------------------------- -ACRN uses ``iasl`` to parse **User VM ACPI** information. The original ``iasl`` -in Ubuntu 18.04 is too old to match with ``acrn-dm``; update it using the -following steps: +ACRN uses ``iasl`` to parse **User VM ACPI** information. or to generate +ACPI binary for pre-launched VMs. .. code-block:: none - $ sudo -E apt-get install iasl - $ cd /home/acrn/work $ wget https://acpica.org/sites/acpica/files/acpica-unix-20191018.tar.gz $ tar zxvf acpica-unix-20191018.tar.gz $ cd acpica-unix-20191018