Gitiles
Code Review Sign In
review.coreboot.org / coreboot / 2d96be6484217bf070a1f0e8270661dc355033d6 / . / Documentation / Intel / SoC / quark.html
blob: 61abebd2398f2fd0b8971b69ec80c44b674b4921 [file] [log] [blame]
Lee Leahyc1e4f892016-01-07 11:24:24 -0800[diff] [blame]1<!DOCTYPE html>
2<html>
3 <head>
4 <title>Quark&trade; SoC</title>
5 </head>
6 <body>
7
8<h1>Intel&reg; Quark&trade; SoC</h1>
9<table>
10 <tr>
11 <td><a target="_blank" href="http://www.intel.com/content/dam/www/public/us/en/images/embedded/16x9/edc-quark-block-diagram-16x9.png"><img alt="Quark Block Diagram" src="http://www.intel.com/content/dam/www/public/us/en/images/embedded/16x9/edc-quark-block-diagram-16x9.png" width=500></a></td>
12 <td>
Lee Leahy05c02152016-02-02 07:55:38 -0800[diff] [blame]13 The Quark&trade; SoC code was developed using the
14 <a target="_blank" href="../Board/galileo.html">Galileo Gen 2</a>
15 board:
16 <ul>
Lee Leahye8424cf2016-02-03 07:28:22 -0800[diff] [blame]17 <li><a target="_blank" href="../development.html">Overall</a> development</li>
Lee Leahy05c02152016-02-02 07:55:38 -0800[diff] [blame]18 <li><a target="_blank" href="soc.html">SoC</a> support</li>
19 <li><a target="_blank" href="../fsp1_1.html">FSP 1.1</a> integration</li>
20 <li><a target="_blank" href="../Board/board.html">Board</a> support</li>
Lee Leahy2d96be62016-05-17 17:03:00 -0700[diff] [blame^]21 <li><a target="_blank" href="#QuarkFsp">Quark&trade; FSP</a></li>
22 <li><a target="_blank" href="#CorebootPayloadPkg">CorebootPayloadPkg</a></li>
Lee Leahy05c02152016-02-02 07:55:38 -0800[diff] [blame]23 </ul>
Lee Leahyc1e4f892016-01-07 11:24:24 -0800[diff] [blame]24 </td>
25 </tr>
26</table>
27
28
29
30<hr>
31<h1>Quark&trade; Documentation</h1>
32<ul>
33 <li><a target="_blank" href="http://www.intel.com/content/dam/www/public/us/en/images/embedded/16x9/edc-quark-block-diagram-16x9.png">Block Diagram</a></li>
Lee Leahyc1e4f892016-01-07 11:24:24 -0800[diff] [blame]34 <li><a target="_blank" href="http://www.intel.com/content/www/us/en/embedded/products/quark/specifications.html">Specifications</a>:
35 <ul>
36 <li><a target="_blank" href="http://ark.intel.com/products/79084/Intel-Quark-SoC-X1000-16K-Cache-400-MHz">X1000</a>
37 - <a target="_blank" href="http://www.intel.com/content/www/us/en/search.html?keyword=X1000">Documentation</a>:
38 <ul>
39 <li><a target="_blank" href="http://www.intel.com/content/dam/www/public/us/en/documents/datasheets/quark-x1000-datasheet.pdf">Datasheet</a></li>
40 <li><a target="_blank" href="http://www.intel.com/content/dam/support/us/en/documents/processors/quark/sb/intelquarkcore_devman_001.pdf">Developer's Manual</a></li>
41 <li><a target="_blank" href="http://www.intel.com/content/dam/www/public/us/en/documents/product-briefs/intel-quark-product-brief-v3.pdf">Product Brief</a></li>
42 </ul>
43 </li>
44 </ul>
45 </li>
Lee Leahy2d96be62016-05-17 17:03:00 -0700[diff] [blame^]46 <li><a target="_blank" href="../index.html#Documentation">More documentation</a></li>
Lee Leahyc1e4f892016-01-07 11:24:24 -0800[diff] [blame]47</ul>
48
49
50
51<hr>
Lee Leahy4ee073d2016-02-28 06:22:47 -0800[diff] [blame]52<h1><a name="CorebootPayloadPkg">Quark&trade; EDK2 CorebootPayloadPkg</a></h1>
Lee Leahydb7410e2016-02-10 11:12:50 -0800[diff] [blame]53<p>
54Build Instructions:
55</p>
56<ol>
57 <li>Set up <a href="#BuildEnvironment">build environment</a></li>
Lee Leahy2d96be62016-05-17 17:03:00 -0700[diff] [blame^]58 <li>Linux (assumes GCC48):
59<pre><code>build -p CorebootPayloadPkg/CorebootPayloadPkgIa32.dsc -a IA32 \
60 -t GCC48 -b DEBUG -DDEBUG_PROPERTY_MASK=0x27 \
61 -DDEBUG_PRINT_ERROR_LEVEL=0x80000042 -DSHELL_TYPE=BUILD_SHELL \
62 -DMAX_LOGICAL_PROCESSORS=1
Lee Leahyc7a94332016-02-20 17:44:35 -0800[diff] [blame]63ls Build/CorebootPayloadPkgIA32/DEBUG_GCC48/FV/UEFIPAYLOAD.fd
Lee Leahydb7410e2016-02-10 11:12:50 -0800[diff] [blame]64</code></pre>
Lee Leahy2d96be62016-05-17 17:03:00 -0700[diff] [blame^]65 </li>
66 <li>Windows (assumes Visual Studio 2015):
67<pre><code>build -p CorebootPayloadPkg\CorebootPayloadPkgIa32.dsc -a IA32 -t VS2015x86 -b DEBUG -DDEBUG_PROPERTY_MASK=0x27 -DDEBUG_PRINT_ERROR_LEVEL=0x80000042 -DSHELL_TYPE=BUILD_SHELL -DMAX_LOGICAL_PROCESSORS=1
68dir Build\CorebootPayloadPkgIA32\DEBUG_VS2015x86\FV\UEFIPAYLOAD.fd
Lee Leahydb7410e2016-02-10 11:12:50 -0800[diff] [blame]69</code></pre>
Lee Leahydb7410e2016-02-10 11:12:50 -0800[diff] [blame]70 </li>
Lee Leahyc7a94332016-02-20 17:44:35 -0800[diff] [blame]71 <li>In the .config for coreboot, set the following Kconfig values:
Lee Leahydb7410e2016-02-10 11:12:50 -0800[diff] [blame]72 <ul>
73 <li>CONFIG_PAYLOAD_ELF=y</li>
74 <li>CONFIG_PAYLOAD_FILE="path to UEFIPAYLOAD.fd"</li>
75 </ul>
76 </li>
77 <li>Build coreboot</li>
78 <li>Copy the image build/coreboot.rom into flash</li>
79</ol>
80
81
82
83<hr>
84<h1><a name="BuildEnvironment">Quark&trade; EDK2 Build Environment</a></h1>
85<p>
86 Use the following steps to setup a build environment:
87</p>
88<ol>
89 <li>Get the EDK2 sources:
90 <ol type="A">
Lee Leahyc1e4f892016-01-07 11:24:24 -0800[diff] [blame]91 <li>EDK2: git clone <a target="_blank" href="https://github.com/tianocore/edk2.git">https://github.com/tianocore/edk2.git</a></li>
Lee Leahyc1e4f892016-01-07 11:24:24 -0800[diff] [blame]92 <li>EDK2-non-osi: git clone <a target="_blank" href="https://github.com/tianocore/edk2-non-osi.git">https://github.com/tianocore/edk2-non-osi.git</a></li>
93 <li>Win32 BaseTools: git clone <a target="_blank" href="https://github.com/tianocore/edk2-BaseTools-win32.git">https://github.com/tianocore/edk2-BaseTools-win32.git</a></li>
Lee Leahydb7410e2016-02-10 11:12:50 -0800[diff] [blame]94 </ol>
Lee Leahyc1e4f892016-01-07 11:24:24 -0800[diff] [blame]95 </li>
Lee Leahydb7410e2016-02-10 11:12:50 -0800[diff] [blame]96 <li>Set up a build window:
97 <ul>
98 <li>Linux:
Lee Leahy1c85fea2016-02-08 13:57:47 -0800[diff] [blame]99<pre><code>export WORKSPACE=$PWD
Lee Leahy2d96be62016-05-17 17:03:00 -0700[diff] [blame^]100export PACKAGES_PATH="$PWD/edk2:$PWD/edk2-non-osi"
Lee Leahy1c85fea2016-02-08 13:57:47 -0800[diff] [blame]101cd edk2
102export WORKSPACE=$PWD
103. edksetup.sh
Lee Leahy1c85fea2016-02-08 13:57:47 -0800[diff] [blame]104</code></pre>
Lee Leahydb7410e2016-02-10 11:12:50 -0800[diff] [blame]105 </li>
106 <li>Windows:
Lee Leahyc1e4f892016-01-07 11:24:24 -0800[diff] [blame]107<pre><code>set WORKSPACE=%CD%
Lee Leahy2d96be62016-05-17 17:03:00 -0700[diff] [blame^]108set PACKAGES_PATH=%WORKSPACE%\edk2;%WORKSPACE%\edk2-non-osi
Lee Leahyc1e4f892016-01-07 11:24:24 -0800[diff] [blame]109set EDK_TOOLS_BIN=%WORKSPACE%\edk2-BaseTools-win32
110cd edk2
111edksetup.bat
Lee Leahyc1e4f892016-01-07 11:24:24 -0800[diff] [blame]112</code></pre>
Lee Leahydb7410e2016-02-10 11:12:50 -0800[diff] [blame]113 </li>
114 </ul>
Lee Leahyc1e4f892016-01-07 11:24:24 -0800[diff] [blame]115 </li>
Lee Leahydb7410e2016-02-10 11:12:50 -0800[diff] [blame]116</ol>
117
Lee Leahyc1e4f892016-01-07 11:24:24 -0800[diff] [blame]118
119
120<hr>
Lee Leahy2d96be62016-05-17 17:03:00 -0700[diff] [blame^]121<h1><a name="QuarkFsp">Quark&trade; FSP</a></h1>
Lee Leahydb7410e2016-02-10 11:12:50 -0800[diff] [blame]122<p>
Lee Leahy2d96be62016-05-17 17:03:00 -0700[diff] [blame^]123Getting the Quark FSP source:
124</p>
125<ol>
126 <li>Set up an EDK-II <a href="#BuildEnvironment">Build Environment</a></li>
127 <li>cd edk2</li>
128 <li>mkdir QuarkFspPkg</li>
129 <li>cd QuarkFspPkg</li>
130 <li>Use git to clone <a target="_blank" href="https://review.gerrithub.io/#/admin/projects/LeeLeahy/quarkfsp">QuarkFspPkg</a> into the QuarkFpsPkg directory (.)</li>
131</ol>
132
133<p>
134Building QuarkFspPkg:
Lee Leahydb7410e2016-02-10 11:12:50 -0800[diff] [blame]135</p>
136<ul>
Lee Leahy2d96be62016-05-17 17:03:00 -0700[diff] [blame^]137 <li>Linux: QuarkFspPkg/BuildFsp.sh -d32</li>
138 <li>Windows: QuarkFspPkg/BuildFsp.bat -d32</li>
Lee Leahydb7410e2016-02-10 11:12:50 -0800[diff] [blame]139</ul>
140
141
142
143<hr>
144<h1>Quark&trade; EDK2 BIOS</h1>
145<p>
146Build Instructions:
147</p>
148<ol>
149 <li>Set up <a href="#BuildEnvironment">build environment</a></li>
150 <li>Build the image:
151 <ul>
152 <li>Linux:
153<pre><code>build -p QuarkPlatformPkg/Quark.dsc -a IA32 -t GCC48 -b DEBUG -DDEBUG_PROPERTY_MASK=0x27 -DDEBUG_PRINT_ERROR_LEVEL=0x80000042
154ls Build/Quark/DEBUG_GCC48/FV/Quark.fd
155</code></pre>
156 </li>
157 <li>Windows:
158<pre><code>build -p QuarkPlatformPkg/Quark.dsc -a IA32 -t VS2012x86 -b DEBUG -DDEBUG_PROPERTY_MASK=0x27 -DDEBUG_PRINT_ERROR_LEVEL=0x80000042
159dir Build\Quark\DEBUG_VS2012x86\FV\Quark.fd
160</code></pre>
161 </li>
162 </ul>
163 </li>
164</ol>
165
166<p>
167Documentation:
168</p>
169<ul>
Lee Leahyfcfa94d2016-03-03 16:08:29 -0800[diff] [blame]170 <li><a target="_blank" href="https://github.com/tianocore/edk2/tree/master/QuarkPlatformPkg">EDK II firmware for Intel&reg; Quark&trade; SoC X1000 based platforms</a></li>
Lee Leahydb7410e2016-02-10 11:12:50 -0800[diff] [blame]171 <li>Intel&reg; Quark&trade; SoC X1000 <a target="_blank" href="http://www.intel.com/content/dam/www/public/us/en/documents/guides/quark-x1000-uefi-firmware-writers-guide.pdf">UEFI Firmware Writer's Guide</a></li>
172</ul>
173
174
175
176<hr>
Lee Leahy2d96be62016-05-17 17:03:00 -0700[diff] [blame^]177<p>Modified: 17 May 2016</p>
Lee Leahyc1e4f892016-01-07 11:24:24 -0800[diff] [blame]178 </body>
Lee Leahy2d96be62016-05-17 17:03:00 -0700[diff] [blame^]179</html>