summaryrefslogtreecommitdiff
path: root/Vlv2TbltDevicePkg/ReadMe.MD
blob: 69811db87cbfbdf1c4766075b0dd1c2e88a7e8b8 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
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.