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
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
|
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<style type="text/css">
@import url('../css/main.css');
</style>
<title>Installing libreboot</title>
</head>
<body>
<div class="section">
<h1 id="pagetop">Installing libreboot</h1>
<p>
This section relates to installing libreboot on supported targets.
</p>
<p>
<a href="../index.html">Back to previous index</a>
</p>
</div>
<div class="section">
<ul>
</ul>
<h2>Software methods</h2>
<ul>
<li><a href="#rom">List of ROM images in libreboot</a></li>
<li><a href="#flashrom">How to install or update libreboot (if running libreboot or coreboot)</a></li>
<li><a href="#flashrom_lenovobios">ThinkPad X60/T60: Initial installation guide (if running Lenovo BIOS firmware)</a></li>
<li><a href="#flashrom_macbook21">MacBook2,1: Initial installation guide (if running Apple EFI firmware)</a></li>
</ul>
<h2>Hardware methods</h2>
<ul>
<li><a href="bbb_setup.html">How to programme an SPI flash chip with the BeagleBone Black</a></li>
<li><a href="x60_unbrick.html">ThinkPad X60: Recovery guide</a></li>
<li><a href="x60tablet_unbrick.html">ThinkPad X60 Tablet: Recovery guide</a></li>
<li><a href="t60_unbrick.html">ThinkPad T60: Recovery guide</a></li>
<li><a href="x200_external.html">ThinkPad X200: Initial installation guide</a> (also the recovery guide)</li>
<li><a href="r400_external.html">ThinkPad R400: Initial installation guide</a> (also the recovery guide)</li>
<li><a href="t400_external.html">ThinkPad T400: Initial installation guide</a> (also the recovery guide)</li>
<li><a href="t500_external.html">ThinkPad T500: Initial installation guide</a> (also the recovery guide)</li>
</ul>
</div>
<div class="section">
<h1 id="rom">List of ROM images in libreboot</h1>
<p>
Libreboot supports the following (refer to the <a href="../release.html">release</a> page):
</p>
<ul>
<li>Apple MacBook1,1 and MacBook2,1: download <b>libreboot_macbook21.tar.xz</b></li>
<li>ThinkPad X60, X60s and X60 Tablet: download <b>libreboot_x60.tar.xz</b></li>
<li>ThinkPad T60: download <b>libreboot_t60.tar.xz</b> (see <a href="../hcl/index.html#supported_t60_list">../hcl/index.html#supported_t60_list</a>)</li>
<li>ThinkPad X200: download <b>libreboot_x200_8mb.tar.xz</b> (8MiB flash chip) or <b>libreboot_x200_4mb.tar.xz</b> (4MiB flash chip) (see <a href="../hcl/x200.html">../hcl/x200.html</a>)</li>
<li>ThinkPad R400: download <b>libreboot_r400_8mb.tar.xz</b> (8MiB flash chip) or <b>libreboot_r400_4mb.tar.xz</b> (4MiB flash chip) (see <a href="../hcl/r400.html">../hcl/r400.html</a>)</li>
<li>ThinkPad T400: download <b>libreboot_t400_8mb.tar.xz</b> (8MiB flash chip) or <b>libreboot_t400_4mb.tar.xz</b> (4MiB flash chip) (see <a href="../hcl/t400.html">../hcl/t400.html</a>)</li>
<li>ThinkPad T500: download <b>libreboot_t500_8mb.tar.xz</b> (8MiB flash chip) or <b>libreboot_t500_4mb.tar.xz</b> (4MiB flash chip) (see <a href="../hcl/t500.html">../hcl/t500.html</a>)</li>
</ul>
<p>
The ROM images in each archive use the following naming convention: <b>boardname_keymap_mode.rom</b>
</p>
<p>
Available <i>modes</i>: <b>vesafb</b> or <b>txtmode</b>. The <i>vesafb</i> ROM images are recommended, in most cases;
<i>txtmode</i> ROM images come with MemTest86+, which requires text-mode instead of the usual framebuffer used
by coreboot native graphics initialization.
</p>
<p>
Keymaps are named appropriate according to each keyboard layout
support in GRUB. To learn how these keymaps are created, see
<a href="../grub/index.html#grub_keyboard">../grub/index.html#grub_keyboard</a>
</p>
<h2 id="qemu">QEMU</h2>
<p>
Libreboot comes with ROM images built for QEMU, by default:
</p>
<ul>
<li><b>libreboot_qemu_q35_ich9.tar.xz</b></li>
<li><b>libreboot_qemu_i440fx_piix4.tar.xz</b></li>
</ul>
<p>
Examples of how to use libreboot in QEMU:
</p>
<ul>
<li>$ <b>qemu-system-i386 -M q35 -m 512 -bios qemu_q35_ich9_keymap_mode.rom</b></li>
<li>$ <b>qemu-system-i386 -M pc -m 512 -bios qemu_i440fx_piix4_keymap_mode.rom</b></li>
</ul>
<p>
You can optionally specify the <b>-serial stdio</b> argument, so that QEMU will emulate
a serial terminal on the standard input/output (most likely your terminal emulator or TTY).
</p>
<p>
Other arguments are available for QEMU. The manual will contain more information.
</p>
<p>
<a href="#pagetop">Back to top of page.</a>
</p>
</div>
<div class="section">
<h1 id="flashrom">How to install or update libreboot (if running libreboot or coreboot)</h1>
<div class="important">
<p>
<b>If you are using libreboot_src or git, then make sure that you built the sources first (see <a href="../git/index.html#build">../git/index.html#build</a>).</b>
</p>
</div>
<p>
These instructions work for most targets, provided that they are already running libreboot or coreboot.
</p>
<p>
Look at the <a href="#rom">list of ROM images</a> to see which image is compatible with your device.
</p>
<p>
X60/T60 users with Lenovo BIOS should refer to <a href="#flashrom_lenovobios">#flashrom_lenovobios</a> instead.
Similary, MacBook2,1 users running Apple EFI should refer to <a href="#flashrom_macbook21">#flashrom_macbook21</a>.
</p>
<p>
<b>
ThinkPad T60 and X60 Tablet users: be sure to read <a href="../hcl/index.html#supported_t60_list">../hcl/index.html#supported_t60_list</a>
or <a href="../hcl/index.html#supported_t60_list">../hcl/index.html#supported_t60_list</a>.
</b>
</p>
<p>
X200/R400/T400/T500 users running Lenovo BIOS should refer to <a href="x200_external.html">x200_external.html</a>,
<a href="r400_external.html">r400_external.html</a>,
<a href="t400_external.html">t400_external.html</a> or
<a href="t500_external.html">t500_external.html</a>. <b>These machines contain the hard coded
MAC address for the onboard ethernet chipset, directly inside the SPI flash;
<a href="../hcl/gm45_remove_me.html#ich9gen">ich9gen</a> shows how to change it (the default
libreboot ROM images for these machines contain a generic MAC address).</b>
</p>
<p>
X200/R400/T400/T500 users should also note, that it is possible for the user to write-protect whole regions
of the SPI flash by using a modified descriptor. Locked regions must be flashed externally;
see <a href="x200_external.html">x200_external.html</a>, <a href="r400_external.html">r400_external.html</a>,
<a href="t400_external.html">t400_external.html</a> or <a href="t500_external.html">t500_external.html</a>.
<b>Libreboot unlocks all regions, by default.</b>
</p>
<div class="important">
<p>
How to update the flash chip contents:<br/>
$ <b>sudo ./flash update <a href="#rom">yourrom.rom</a></b>
</p>
</div>
<div class="important">
<p>
Ocassionally, coreboot changes the name of a given board. If flashrom complains about a board mismatch, but
you are sure that you chose the correct ROM image, then run this alternative command:<br/>
$ <b>sudo ./flash forceupdate <a href="#rom">yourrom.rom</a></b>
</p>
</div>
<div class="important">
<p>
You should see <b>"Verifying flash... VERIFIED."</b> written at the end of the flashrom output. <b>Shut down</b>
after you see this, and then boot up again after a few seconds.
</p>
</div>
<p><a href="#pagetop">Back to top of page</a></p>
</div>
<div class="section">
<h1 id="flashrom_lenovobios">ThinkPad X60/T60: Initial installation guide (if running Lenovo BIOS firmware)</h1>
<p><b>This is for the ThinkPad X60 and T60 while running Lenovo BIOS. If you already have coreboot or libreboot running,
then go to <a href="#flashrom">#flashrom</a> instead!</b></p>
<p><b>If you are flashing a Lenovo ThinkPad T60, be sure to read <a href="../hcl/index.html#supported_t60_list">../hcl/index.html#supported_t60_list</a></b></p>
<div class="important">
<p>
<b>If you are using libreboot_src or git, then make sure that you built the sources first (see <a href="../git/index.html#build">../git/index.html#build</a>).</b>
</p>
</div>
<p>
<b>
Warning: this guide will not instruct the user how to backup the original Lenovo BIOS firmware. These backups
are tied to each machine, and will not work on any other.
For that, please refer to <a href="http://www.coreboot.org/Board:lenovo/x60/Installation">http://www.coreboot.org/Board:lenovo/x60/Installation</a>.
</b>
</p>
<div class="important">
<p>
The first half of the procedure is as follows:<br/>
$ <b>sudo ./flash i945lenovo_firstflash <a href="#rom">yourrom.rom</a>.</b>
</p>
</div>
<div class="important">
<p>
You should see within the output the following:<br/>
<b>"Updated BUC.TS=1 - 64kb address ranges at 0xFFFE0000 and 0xFFFF0000 are swapped"</b>.
</p>
<p>
You should also see within the output the following:<br/>
<b>"Flash chip is in an unknown state"</b>, <b>"FAILED"</b> and <b>"DO NOT SHUTDOWN OR REBOOT"</b><br/>
Seeing this means that the operation was a <b>resounding</b> success! <b>DON'T PANIC</b>.
</p>
<p>
See this link for more details:
<a href="http://thread.gmane.org/gmane.linux.bios.flashrom/575">http://thread.gmane.org/gmane.linux.bios.flashrom/575</a>.
</p>
<p>
If the above is what you see, then <b>SHUT DOWN</b>. Wait a few seconds, and then boot; libreboot is running, but there is a 2nd procedure <b>*needed*</b> (see below).
</p>
</div>
<div class="important">
<p>
When you have booted up again, you must also do this:<br/>
$ <b>sudo ./flash i945lenovo_secondflash <a href="#rom">yourrom.rom</a></b>
</p>
</div>
<div class="important">
<p>
You should see within the output the following:<br/>
<b>"Updated BUC.TS=0 - 128kb address range 0xFFFE0000-0xFFFFFFFF is untranslated"</b>
</p>
<p>
You should also see within the output the following:<br/>
<b>"Verifying flash... VERIFIED."</b>
</p>
</div>
<p><a href="#pagetop">Back to top of page.</a></p>
</div>
<div class="section">
<h1 id="flashrom_macbook21">MacBook2,1: Initial installation guide (if running Apple EFI firmware)</h1>
<div class="important">
<p>
<b>If you have a MacBook1,1, refer to <a href="../hcl/index.html#macbook11">../hcl/index.html#macbook11</a> for flashing instructions.</b>
</p>
</div>
<p>
<b>
This is for the MacBook2,1 while running Apple EFI firmware. If you already have
coreboot or libreboot running, then go to <a href="#flashrom">#flashrom</a> instead!
</b>
</p>
<p>
Be sure to read the information in <a href="../hcl/index.html#macbook21">../hcl/index.html#macbook21</a>.
</p>
<p>
<b>
Warning: this guide will not instruct the user how to backup the original Apple EFI firmware.
For that, please refer to <a href="http://www.coreboot.org/Board:apple/macbook21">http://www.coreboot.org/Board:apple/macbook21</a>.
</b>
</p>
<div class="important">
<p>
<b>If you are using libreboot_src or git, then make sure that you built the sources first (see <a href="../git/index.html#build">../git/index.html#build</a>).</b>
</p>
</div>
<p>
Look at the <a href="#rom">list of ROM images</a> to see which image is compatible with your device.
</p>
<div class="important">
<p>
Use this flashing script, to install libreboot:<br/>
$ <b>sudo ./flash i945apple_firstflash <a href="#rom">yourrom.rom</a></b>
</p>
</div>
<div class="important">
<p>
You should also see within the output the following:<br/>
<b>"Verifying flash... VERIFIED."</b>
</p>
<p>
Shut down.
</p>
</div>
<p><a href="#pagetop">Back to top of page.</a></p>
</div>
<div class="section">
<p>
Copyright © 2014, 2015 Francis Rowe <info@gluglug.org.uk><br/>
This document is released under the Creative Commons Attribution-ShareAlike 4.0 International Public License and all future versions.
A copy of the license can be found at <a href="../license.txt">../license.txt</a>.
</p>
<p>
This document is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See <a href="../license.txt">../license.txt</a> for more information.
</p>
</div>
</body>
</html>
|
