From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from NAM10-BN7-obe.outbound.protection.outlook.com (NAM10-BN7-obe.outbound.protection.outlook.com [40.107.92.138]) by mx.groups.io with SMTP id smtpd.web11.13606.1607087202522317746 for ; Fri, 04 Dec 2020 05:06:42 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@os.amperecomputing.com header.s=selector2 header.b=rsz6nRz+; spf=pass (domain: os.amperecomputing.com, ip: 40.107.92.138, mailfrom: nhi@os.amperecomputing.com) ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=EO7aiIUz7i5aSapfBOrWaLuDanBSTqfeiAMS4MTW8ZcqbAntQ9TL/mLqzhdbE0t3gq/NrNsm4RQl1Fkti6h2E6rCS8+aqM5Xo5M3jivWNs90eXGlOrlgosdmM5WcvcKDvGEwrIya1WtsRQGzA0tCOybmwjHNaqCk7O7jqPqF8z4a+fhf8RmCZKL5Y33W8IQOFTWZobTcvOMd2nAiXu6x6gSpfxY0qXlmkaRGWcELNc47uDWqBaRagiAstRKWIzkkH7Ky+tiwml5oSjmHCjIyvu9CaJWNPA4x7Y4aMl/KSTC1AzAqLArovV+INSKqgMn2yRRO3Ts7e4MMil+EDDO8/Q== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector9901; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=GVy9SKGGMXQX6Co1wifyImdIlOz6kYZCKp0prdY19AE=; b=MSmbHKWKJOE/3Bwqu1KnN6ObkyXZzJEmk1ifKMm5TCjZw3tSgUOa2zTSL98JQi4aYQ+6yC2tTwMU+X+3jThF4pBenjyph2S5nfiRQ8YDU4Al7oJ9GOc/FSKQ19FkagbFzAx1CCyKucsnGfy8uepEIQi4nyqiU8iOviqeT3+uU+ypZrgkq0kV/7p3G0UB1h5soxpKuLn72zqARJjr49DXv2hQ9vLQetCLv19CtVlJjRRV7pAgvrilNbUsnBUyO4mPi4CVRUD70CRU5KB9cyonKDn56NMP/V2is/WEuVR7pMVUrjSdcJWVGk/pNekroAKvmYsvjB8OLoWFXRyRgZKPkQ== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=os.amperecomputing.com; dmarc=pass action=none header.from=os.amperecomputing.com; dkim=pass header.d=os.amperecomputing.com; arc=none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=os.amperecomputing.com; s=selector2; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=GVy9SKGGMXQX6Co1wifyImdIlOz6kYZCKp0prdY19AE=; b=rsz6nRz+XoaPOQQEKOFyUkYMwqi6tZVtKwsexe/cxiETVmMpAjEooylwAx4UI89kNXbyDstQ4gO0tMIFRuGktiKUsi9LKvX2j/WM1NSIu7cj7yn4Zb/r4OoAwr6fcNY5GcZhUw5w25v1vkZ66j8KFQUu4hW9vNQ6cpH+fzS8ams= Authentication-Results: edk2.groups.io; dkim=none (message not signed) header.d=none;edk2.groups.io; dmarc=none action=none header.from=os.amperecomputing.com; Received: from DM6PR01MB5849.prod.exchangelabs.com (2603:10b6:5:205::20) by DM6PR01MB4652.prod.exchangelabs.com (2603:10b6:5:63::29) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.3632.18; Fri, 4 Dec 2020 13:06:41 +0000 Received: from DM6PR01MB5849.prod.exchangelabs.com ([fe80::c814:9a08:5c2e:4076]) by DM6PR01MB5849.prod.exchangelabs.com ([fe80::c814:9a08:5c2e:4076%5]) with mapi id 15.20.3611.035; Fri, 4 Dec 2020 13:06:41 +0000 From: "Nhi Pham" To: devel@edk2.groups.io Cc: Phong Vo , Leif Lindholm , Michael D Kinney , Ard Biesheuvel , Nate DeSimone Subject: [edk2-platforms][PATCH v2 1/3] Platform/Ampere: Add Readme.md Date: Fri, 4 Dec 2020 20:07:50 +0700 Message-Id: <20201204130752.9633-2-nhi@os.amperecomputing.com> X-Mailer: git-send-email 2.17.1 In-Reply-To: <20201204130752.9633-1-nhi@os.amperecomputing.com> References: <20201204130752.9633-1-nhi@os.amperecomputing.com> X-Originating-IP: [118.69.219.201] X-ClientProxiedBy: HK2PR04CA0051.apcprd04.prod.outlook.com (2603:1096:202:14::19) To DM6PR01MB5849.prod.exchangelabs.com (2603:10b6:5:205::20) Return-Path: nhi@os.amperecomputing.com MIME-Version: 1.0 X-MS-Exchange-MessageSentRepresentingType: 1 Received: from sw004.amperecomputing.com (118.69.219.201) by HK2PR04CA0051.apcprd04.prod.outlook.com (2603:1096:202:14::19) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.3632.17 via Frontend Transport; Fri, 4 Dec 2020 13:06:39 +0000 X-MS-PublicTrafficType: Email X-MS-Office365-Filtering-Correlation-Id: 2c91b13e-8d21-48d2-6482-08d89855710e X-MS-TrafficTypeDiagnostic: DM6PR01MB4652: X-MS-Exchange-Transport-Forked: True X-Microsoft-Antispam-PRVS: X-MS-Oob-TLC-OOBClassifiers: OLM:9508; X-MS-Exchange-SenderADCheck: 1 X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: mVlHyZg6Sa+3vWLdRlt1E3nnFX7oFiBZRzKFFxhbWwKv3YD41qr1VAjxyVLZiL8HJnHtbJ9Q9yTkTU4Q3w3HbhTuRzGSY6F1fCyEVe1F9ib+Qo1PUfjLLgKmUDVoLUHh7X+zDEZuuylVb0P2OHsUDOgBb1/SPA/A1fGBLkQFkxZzK/chxArA+P6YvfKNJ5FZdP72ED99hDz0PrZONV53wBzdGJbEpDlqGLMo0knOpp+l0Ke5hmfWNDjRX86h+ifEPJVLDGO3uyb70cM6jeaDyN/wD89yA8784MMZvsJ+pr27ZxceQT1kl5h2knvU8tk1YB6h/TEIQM7lkB5kJMrTHI3qc+IzUXRTzaEwttYPoOSAPVQRDoUDZF52rJV0Ho9g4rjdVooC5JvWI4FlElfN7g== X-Forefront-Antispam-Report: CIP:255.255.255.255;CTRY:;LANG:en;SCL:1;SRV:;IPV:NLI;SFV:NSPM;H:DM6PR01MB5849.prod.exchangelabs.com;PTR:;CAT:NONE;SFS:(4636009)(136003)(39850400004)(396003)(376002)(366004)(346002)(6506007)(5660300002)(6666004)(316002)(2906002)(956004)(86362001)(26005)(66556008)(478600001)(8676002)(54906003)(1076003)(83380400001)(66476007)(66946007)(8936002)(2616005)(966005)(6512007)(52116002)(6916009)(6486002)(4326008)(16526019)(186003);DIR:OUT;SFP:1102; X-MS-Exchange-AntiSpam-MessageData: =?us-ascii?Q?ajWcIc8tichNIbgdRixNxCNB9XkpOacsa/Rgk2ioh05W7dqwnw+hqlErc6x8?= =?us-ascii?Q?NfaPuve37PPuAaS8oc0TgH87/XhUfIibIbyzfSM7I8rsqYtM4S6z55rq5co7?= =?us-ascii?Q?6DnlFti328FxCpcu+LU0WuMW/OQ/hPT8qz/HdJiZuErXBtvUp+M3z9uCUeL8?= =?us-ascii?Q?rZhdOTBSWk9wJ23xyKjHWZl6Zi95JYBhJHMwWID3001eSx4+2nAKbbcYNMml?= =?us-ascii?Q?MKpjdyuzGdhsHKSZgyxx83JT5k6tAC+nCbJXjhjfXHn9o2O3QazRiiX0M/wC?= =?us-ascii?Q?xNbu/Ui97NXWlBjifYpctz+nXuOCIqq9LY2D1Z7+BPxNQxOHoG1GuiRMp5fb?= =?us-ascii?Q?N5fJ117uQ1FV3yKynyNdVwRxsixDmjGlSA5dHfGA1OOwz5lMjeqyE7/Q+HrP?= =?us-ascii?Q?Z36S3KFXrBfh3cErq/lPZIKmIdtBgkrlMoJydcdeBjL5pnjTgHF2EpwokcTQ?= =?us-ascii?Q?2FG5ywaFIFSYG/SD/ao9Yr+1zzRrvVJHKlWYJ+XDiEbdW2GxUKEeazSuKuFD?= =?us-ascii?Q?Ez56YO1d6KP4ebrsQ2WPj9QfVh5bkE4dSUobEwgkl1RrhVW3TstEu5r+zuum?= =?us-ascii?Q?LrrxZQyYWmydI7dkuCgYEdOwd1Cuk07iNRApPgXYOlI8y8aYWg519dX2x4ih?= =?us-ascii?Q?VU2Hc1Npt0WmWkay7/pH7LFHjD6l/viemwg+JwO+4/SFF1jbcaEpwSiE5ay5?= =?us-ascii?Q?GLiMDyQR2gipT0YRUcevjrzth2Vkm33mInjun3YsIsqZ4q1Brw2tt3PTcJqK?= =?us-ascii?Q?/DV7D3jb8AvPSZAKwEWO0du2mqNEWO0vPwoKeA05XG0WswmIJ8+6beYlkoQF?= =?us-ascii?Q?tAwBn6Kn5XwfnIurgClmzUK9LM2Xv7wwAHTspz1yXG2oWOV3hvFp31jRefkI?= =?us-ascii?Q?Xl0kvhnwBUNhYKw41QOIvefi/YvFXU1cGwFo67k2T2zw8dFp7Z4+f5OSqmW7?= =?us-ascii?Q?I+RyTTljOqjnTBV2TyCpuyuOJAvBFN97lfDY95Te5/VPQKFCDm700YYHNCx1?= =?us-ascii?Q?66/g?= X-OriginatorOrg: os.amperecomputing.com X-MS-Exchange-CrossTenant-Network-Message-Id: 2c91b13e-8d21-48d2-6482-08d89855710e X-MS-Exchange-CrossTenant-AuthSource: DM6PR01MB5849.prod.exchangelabs.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-OriginalArrivalTime: 04 Dec 2020 13:06:41.0715 (UTC) X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted X-MS-Exchange-CrossTenant-Id: 3bc2b170-fd94-476d-b0ce-4229bdc904a7 X-MS-Exchange-CrossTenant-MailboxType: HOSTED X-MS-Exchange-CrossTenant-UserPrincipalName: azyxo8xZdHuqNtDqMDaF8iJIosix4/EuKb1h0hSBhw7MRvaHoNVjW+oU6gQixMdZbEyZirJwAA1zjDRbRlS0Zu2Vao3rTWBs4nWLhP8mB+k= X-MS-Exchange-Transport-CrossTenantHeadersStamped: DM6PR01MB4652 Content-Type: text/plain From: Phong Vo Add initial version of Readme.md for Ampere platform Cc: Leif Lindholm Cc: Michael D Kinney Cc: Ard Biesheuvel Cc: Nate DeSimone Signed-off-by: Phong Vo --- Platform/Ampere/Readme.md | 39 ++++++++++++++++++++ 1 file changed, 39 insertions(+) diff --git a/Platform/Ampere/Readme.md b/Platform/Ampere/Readme.md new file mode 100644 index 000000000000..894bad3437b8 --- /dev/null +++ b/Platform/Ampere/Readme.md @@ -0,0 +1,39 @@ +# Introduction + +This document provides the guideline to build UEFI firmware for Ampere Computing's Arm64 reference platforms. + +Platform code is located under Platform/Ampere/{Platform Name}Pkg. + +Silicon code is located under Silicon/Ampere/Ampere{SoC Name}Pkg. + +# Build machines + +- x86 Linux host machines running latest Ubuntu or CentOS releases. +- Arm64 Linux host machines if native compiling. This has been tested on Ampere's eMAG and Altra hardware platforms with latest AArch64 CentOS or Ubuntu releases. + +# How to build (Linux Environment) + +Please follow top-level Readme.md for build instructions. + +## Additional build tools + +Ampere provides additional tools and documentation for automating the manual process described as described in the top-level README.md, +and for building a final Tianocore UEFI image that can be flashed onto the target system. + +To use these tools, clone the following to the **WORKSPACE** location: + +```bash +$ git clone https://github.com/AmpereComputing/edk2-ampere-tools.git +``` + +## Notes + +If you run into any build issue with the Intel ASL+ Optimizing Compiler/Disassembler (IASL) that comes with your Linux distro, +download and install the IASL compiler from https://acpica.org/. At the time of this write-up, we have tested with version 20200110. + +```bash +$ wget https://acpica.org/sites/acpica/files/acpica-unix2-20200110.tar.gz +$ tar xzf acpica-unix2-20200110.tar.gz +$ cd acpica-unix2-20200110 +$ make HOST=_CYGWIN && sudo make install +``` -- 2.17.1