summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorGuo Mang <mang.guo@intel.com>2017-09-05 19:48:56 +0800
committerGuo Mang <mang.guo@intel.com>2017-09-05 19:48:56 +0800
commitd282ad6ee8f83c9a4d769bd2eb5bac97fbc03791 (patch)
tree39ed77367997a6639b60239c5653ad9640e978f3
parent0add0a5b5f19360fe2f4e8d4c83d623d1e3d6200 (diff)
downloadedk2-platforms-d282ad6ee8f83c9a4d769bd2eb5bac97fbc03791.tar.xz
Vlv2TbltDevicePkg: Add platform ReadMe.MD
Contributed-under: TianoCore Contribution Agreement 1.1 Signed-off-by: Guo Mang <mang.guo@intel.com>
-rw-r--r--Vlv2TbltDevicePkg/ReadMe.MD108
1 files changed, 108 insertions, 0 deletions
diff --git a/Vlv2TbltDevicePkg/ReadMe.MD b/Vlv2TbltDevicePkg/ReadMe.MD
new file mode 100644
index 0000000000..69811db87c
--- /dev/null
+++ b/Vlv2TbltDevicePkg/ReadMe.MD
@@ -0,0 +1,108 @@
+# MINNOWBOARD MAX/TURBOT PLATFORM FIRMWARE
+
+This UEFI firmware is designed for the open hardware MinnowBoard Max/Turbot platforms using
+the Intel(R) Atom(tm) Processor E3800 Series, based on UDK2017 core packages.
+
+## **Download the sources**
+
+### Download official released sources:
+
+ Please refer to the release notes to download official released sources.
+
+ Get release notes from https://firmware.intel.com/projects/minnowboard-max
+
+### Download the latest sources:
+
+(Official releases sources is recommanded as it is passed stability testing)
+```
+1. Create a new directory for use as your WORKSPACE (e.g. "C:\MyWorkspace").
+
+2. Download below repository to this WORKSPACE:
+
+edk2 repository
+ git clone https://github.com/tianocore/edk2.git -b UDK2017
+ cd edk2
+ git checkout vUDK2017
+
+edk2-BaseTools-win32 repository
+ git clone https://github.com/tianocore/edk2-BaseTools-win32.git
+ cd edk2-BaseTools-win32
+ git checkout 0e088c19ab31fccd1d2f55d9e4fe0314b57c0097
+
+edk2-platforms repository
+ git clone https://github.com/tianocore/edk2-platforms.git -b devel-MinnowBoardMax-UDK2017
+
+3. Download MinnowBoard MAX Binary Object Modules from https://firmware.intel.com/projects/minnowboard-max
+
+ IA32FamilyCpuPkg
+ Vlv2BinaryPkg
+ Vlv2MiscBinariesPkg
+
+Create a new directory named "silicon" below WORKSPACE (e.g. "C:\MyWorkspace\silicon\").
+Copy the three folders to "silicon" directory .
+```
+
+## **Windows Build Instructions**
+
+### Pre-requisites
+
+* Microsoft Visual Studio.
+ - Visual Studio 2008/2010/2012/2013.
+* ASL compiler: Available from http://www.acpica.org
+ - Install into ```C:\ASL``` to match default tools_def.txt configuration.
+* NASM assembler: Available from: http://www.nasm.us/
+ - Install into ```C:\NASM``` to match default tools_def.txt configuration.
+* Python 2.7.10: Available from: https://www.python.org/downloads/release/python-2710/
+ - Install Python and make sure that a file with the extension of ".py" will be opened by Python.exe.
+
+### Build
+
+1. Open command window, goto the workspace dir, e.g. c:\MyWorkspace.
+2. Type "cd edk2-platforms\Vlv2TbltDevicePkg".
+3. Build
+ - Type "Build_IFWI.bat /IA32 MNW2 Release" to build a 32 bit release version.
+ - Type "Build_IFWI.bat /IA32 MNW2 Debug" to build a 32 bit debug version.
+ - Type "Build_IFWI.bat MNW2 Release" to build a 64 bit release version.
+ - Type "Build_IFWI.bat MNW2 Debug" to build a 64 bit debug version.
+
+## **Linux Build Instructions**
+
+### Pre-requisites
+
+* Linux System Configuration.
+ - Ubuntu 16.04 64 bit
+ - GCC version 5 or above
+* NASM assembler
+ - ``# apt-get install nasm``.
+* ASL compiler
+ - Download ASL build tool from https://acpica.org/downloads
+ make sure the iasl tool version that you installed is "20170728" or newer.
+ - The requirements for generating ACPICA tools from source code are:
+ ```
+ flex: version 2.5.4 or greater
+ bison: version 2.4.1 or greater
+
+ # apt-get install bison flex
+ ```
+ - Generate and install the iasl tool in usr/bin
+ ```
+ # make clean
+ # make iasl
+ # make install
+ ```
+
+### Build
+
+1. Open a command prompt, goto the platform package "edk2-platforms\Vlv2TbltDevicePkg".
+2. Build
+ - Type "./Build_IFWI.sh MNW2 Release" to build a release version.
+ - Type "./Build_IFWI.sh MNW2 Debug" to build a debug version.
+
+## **Related Materials**
+
+http://minnowboard.org/ -- Platform Information, including schematics and information on where to purchase boards.
+
+https://firmware.intel.com/projects/minnowboard-max -- Release notes, pre-built release/debug binaries, build instructions, and binary objects required to compile firmware.
+
+
+