From mboxrd@z Thu Jan 1 00:00:00 1970 X-GM-THRID: 6658915524700798976 X-Received: by 2002:a7b:cb02:: with SMTP id u2mr1125620wmj.6.1550399587826; Sun, 17 Feb 2019 02:33:07 -0800 (PST) X-BeenThere: isar-users@googlegroups.com Received: by 2002:a1c:ce0a:: with SMTP id e10ls1326363wmg.1.canary-gmail; Sun, 17 Feb 2019 02:33:07 -0800 (PST) X-Google-Smtp-Source: AHgI3IbDAgKEpIfyNIGuDZ84ch57RQ9yLgsXOoNsWhQzijGYZIL2rt3f8sZFhSgWnlS0wnuBoE2G X-Received: by 2002:a1c:761a:: with SMTP id r26mr963634wmc.1.1550399587370; Sun, 17 Feb 2019 02:33:07 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1550399587; cv=none; d=google.com; s=arc-20160816; b=rs8kuuG5hAw3yrm46Ipuzef0XDvZ0OAos/GjhrWnNR78YObh0Y2KhW4VifeiSTnNBA +MZTCWDPbFW+kWz4PH8lroHgbwhmwX7mC9hCKbfxV9u3RyQdBojFUmzMY8YQddTSYgV4 WKP5SN8F3uev06BMmQ6/TABcw1Kka2DBGAohiwBn+i3D3cNG48yo7TW8Vy1nd5jgM7la Pt+/PfoKmXxThQrZACuAF6XKXYT6qVIbtVeNgZEi9Q3knDVr2p479gx1p7TvSewFldGn Qw4e+3LfQGq8PgTPsuY/kzRy1cF/oQNdowZBQRVsMqu0/jLj5pJuK7bM9L8a5BnG1bHv 7eBQ== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=message-id:date:subject:to:from; bh=aFApMA37xcbblThb+H+mdTSoEsh0nlEek/Mb3gEJ5/U=; b=t0fXYugh+c/ezCrmX2Q17oVDZ3Z5w+buNuR+zi+AQH4WyuCeWN3D9x6EqMd76pdamw pZnMRNMuMlTcXYuqo+v7+kqZpXmy79/8k4RA5Hnp/dFTUXQYHrsO7oGDPk6XkotxTfJI Zbq+XhB345vguCD+WMO6GHBdEZgRW6j7nBvcCroyC9hZy6g+ey8R1q9PSQDbdSAOMFmV 6QIohu3iI/9hUYb4Ls6G3A1v39bLVUfX27qW0syBGAckS8jdo6aQJYmcaUl4iQkQMkiK 8P4OKLlQnWvPGWeyH63C5iXB93njx1uq3UMNgMCiGYk+d+iCIcx1csB5FyR4+79WwtEx /7fQ== ARC-Authentication-Results: i=1; gmr-mx.google.com; spf=neutral (google.com: 85.214.156.166 is neither permitted nor denied by best guess record for domain of ibr@radix50.net) smtp.mailfrom=ibr@radix50.net Return-Path: Received: from shymkent.ilbers.de (shymkent.ilbers.de. [85.214.156.166]) by gmr-mx.google.com with ESMTPS id y200si457134wmd.0.2019.02.17.02.33.07 for (version=TLS1_2 cipher=ECDHE-RSA-CHACHA20-POLY1305 bits=256/256); Sun, 17 Feb 2019 02:33:07 -0800 (PST) Received-SPF: neutral (google.com: 85.214.156.166 is neither permitted nor denied by best guess record for domain of ibr@radix50.net) client-ip=85.214.156.166; Authentication-Results: gmr-mx.google.com; spf=neutral (google.com: 85.214.156.166 is neither permitted nor denied by best guess record for domain of ibr@radix50.net) smtp.mailfrom=ibr@radix50.net Received: from yssyq.m.ilbers.de (dslb-084-058-239-227.084.058.pools.vodafone-ip.de [84.58.239.227]) (authenticated bits=0) by shymkent.ilbers.de (8.15.2/8.15.2/Debian-8) with ESMTPSA id x1HAX689008633 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=NOT) for ; Sun, 17 Feb 2019 11:33:06 +0100 Received: from yssyq.m.ilbers.de (localhost [127.0.0.1]) by yssyq.m.ilbers.de (8.15.2/8.15.2/Debian-8) with ESMTPS id x1HAX1tL003390 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=NOT) for ; Sun, 17 Feb 2019 11:33:01 +0100 Received: (from ibr@localhost) by yssyq.m.ilbers.de (8.15.2/8.15.2/Submit) id x1HAX1mT003389 for isar-users@googlegroups.com; Sun, 17 Feb 2019 11:33:01 +0100 From: Baurzhan Ismagulov To: isar-users@googlegroups.com Subject: [PATCH] doc: Improve docs Date: Sun, 17 Feb 2019 11:33:01 +0100 Message-Id: <20190217103301.3348-1-ibr@radix50.net> X-Mailer: git-send-email 2.11.0 X-Spam-Status: No, score=-1.0 required=5.0 tests=ALL_TRUSTED,URIBL_BLOCKED autolearn=unavailable autolearn_force=no version=3.4.2 X-Spam-Checker-Version: SpamAssassin 3.4.2 (2018-09-13) on shymkent.ilbers.de X-TUID: lILwFv2Alr0j From: Baurzhan Ismagulov Signed-off-by: Baurzhan Ismagulov --- doc/edk2_build.md | 59 +++++++++++++++++++++++++++++++++++++++--------------- doc/user_manual.md | 17 ++++++++++++---- 2 files changed, 56 insertions(+), 20 deletions(-) diff --git a/doc/edk2_build.md b/doc/edk2_build.md index 64c90ff..f33d381 100644 --- a/doc/edk2_build.md +++ b/doc/edk2_build.md @@ -1,12 +1,20 @@ # Building Tianocore UEFI Firmware -## Install Build Dependencies +A binary `ovmf` package is available in Debian Jessie, Stretch, and sid, but it +doesn't seem to be recent enough for testing images generated by Isar. + +## Get the Sources + +``` +git clone https://github.com/tianocore/edk2 +cd edk2 +git checkout 3858b4a1ff09d3243fea8d07bd135478237cb8f7 +``` -Install the following packages with `sudo apt-get install`: +## Install Build Dependencies ``` -uuid-dev # /usr/include/uuid/uuid.h -acpica-tools # /usr/bin/iasl +sudo apt-get install acpica-tools g++ make nasm python uuid-dev ``` ## Build BaseTools @@ -14,31 +22,50 @@ acpica-tools # /usr/bin/iasl * `BaseTools/Source/C/Makefiles/header.makefile`: Remove `-Werror` * `make -C BaseTools` - ## Initialize Build Environment -`. edksetup.sh` +`. ./edksetup.sh` -## Build IA32 Firmware +## Build X64 Firmware + +Usable with qemu-system-x86_64. -* `Conf/target.txt`: Edit as follows: +Edit `Conf/target.txt` as follows: ``` -ACTIVE_PLATFORM = OvmfPkg/OvmfPkgIa32.dsc +ACTIVE_PLATFORM = OvmfPkg/OvmfPkgX64.dsc TARGET = RELEASE -TARGET_ARCH = IA32 +TARGET_ARCH = X64 TOOL_CHAIN_TAG = GCC49 MAX_CONCURRENT_THREAD_NUMBER = 8 ``` -* `build` -## Build X64 Firmware +``` +build +``` + +Tested on Stretch. + +## Build IA32 Firmware -* `Conf/target.txt`: Edit as follows: +Usable with qemu-system-i386 or qemu-system-x86_64. If the X64 version works +for you, skip this section. + +Edit `Conf/target.txt` as follows: ``` -ACTIVE_PLATFORM = OvmfPkg/OvmfPkgX64.dsc +ACTIVE_PLATFORM = OvmfPkg/OvmfPkgIa32.dsc TARGET = RELEASE -TARGET_ARCH = X64 +TARGET_ARCH = IA32 TOOL_CHAIN_TAG = GCC49 MAX_CONCURRENT_THREAD_NUMBER = 8 ``` -* `build` + +``` +build +``` + +Tested on Jessie. + +## TODO + +* Test sid `ovmf` later than 2018-08-07. If it doesn't work, provide an updated + package. diff --git a/doc/user_manual.md b/doc/user_manual.md index ff4939c..24e3cc7 100644 --- a/doc/user_manual.md +++ b/doc/user_manual.md @@ -57,23 +57,32 @@ The supported host system is >= stretch. Install the following packages: ``` +binfmt-support +debootstrap dosfstools -git dpkg-dev +git +mtools parted python3 python3-distutils # host >= buster -qemu +qemu # start_vm qemu-user-static -binfmt-support -sudo reprepro +sudo ``` Notes: * BitBake requires Python 3.4+. * The python3 package is required for the correct `alternatives` setting. +* If you'd like to run bitbake in a container (chroot, docker, etc.), install + the above in the container, and also perform `sudo apt-get install + binfmt-support qemu-user-static` on the host that should run the container. +* If you install `binfmt-support` after `qemu-user-static`, perform `sudo + apt-get install --reinstall qemu-user-static` to register binary formats + handled by QEMU (check e.g. `qemu-arm` in `/usr/sbin/update-binfmts + --display`). ### Setup Sudo -- 2.11.0