summaryrefslogtreecommitdiff
path: root/docs/hcl/index.html
blob: 3ffaea8d5ef4d80bcf06db93ad6f912ae8110d29 (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
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
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
<!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>Hardware compatibility list</title>
</head>

<body>

	<h1 id="pagetop">Hardware compatibility list</h1>
		<p>
			This sections relates to known hardware compatibility in libreboot.
		</p>
		<p>
			Or <a href="../index.html">back to main index</a>.
		</p>
		<ul>
			<li><a href="#supported_list">List of supported hardware</a></li>
			<li><a href="#recommended_wifi">Recommended wifi chipsets</a></li>
			<li><a href="#supported_x60_list">List of supported ThinkPad X60/X60s</a></li>
			<li><a href="#supported_x60t_list">List of supported ThinkPad X60 Tablets</a></li>
			<li><a href="#supported_t60_list">List of supported ThinkPad T60's</a></li>
			<li><a href="#t60_ati_intel">ThinkPad T60 (ATI GPU) and ThinkPad T60 (Intel GPU) differences.</a></li>
			<li><a href="#macbook11">Information about the Macbook1,1</a></li>
			<li><a href="#macbook21">Information about the Macbook2,1</a></li>
		</ul>

<hr/>

	<h1 id="supported_list">List of supported hardware</h1>

		<p>
			Libreboot supports the following machines in this release:
		</p>
			<ul>
				<li><a href="#supported_x60_list">Lenovo ThinkPad X60/X60s</a></li>
				<li><a href="#supported_x60t_list">Lenovo ThinkPad X60 Tablet</a></li>
				<li><a href="#supported_t60_list">Lenovo ThinkPad T60</a> (there are exceptions. see link)</li>
				<li><a href="#macbook11">Apple MacBook1,1</a></li>
				<li><a href="#macbook21">Apple MacBook2,1</a></li>
			</ul>

		<p>
			'Supported' means that the build scripts know how to build ROM's for these machines,
			and that the machines have been tested (confirmed working). There may be exceptions; 
			in other words, this is a list of 'officially' supported machines.
		</p>

		<p>
			It is also possible to build ROM images (from source) for other machines (and virtual machines, e.g. QEMU).
		</p>

		<p><a href="#pagetop">Back to top of page</a></p>

<hr/>

	<h1 id="recommended_wifi">Recommended wifi chipsets</h1>
		<p>
			The following are known to work well:
		</p>
			<ul>
				<li><a href="http://h-node.org/search/results/en/1/search/wifi/ar9285">Atheros AR5B95</a> (chipset: Atheros AR9285); mini PCI-E. Most of these are half-height, so you will need a half&gt;full height mini PCI express adapter/bracket.</li>
				<li><a href="http://h-node.org/wifi/view/en/116/Atheros-Communications-Inc--AR928X-Wireless-Network-Adapter--PCI-Express---rev-01-">Atheros AR928X</a> chipset; mini PCI-E. Most of these are half-height, so you will need a half&gt;full height mini PCI express adapter/bracket</li>
				<li>Unex DNUA-93F (chipset: <a href="http://h-node.org/search/results/en/1/search/wifi/ar9271">Atheros AR9271</a>); USB.</li>
				<li>Any of the chipsets listed at <a href="https://fsf.org/ryf">https://fsf.org/ryf</a></li>
				<li>Any of the chipsets listed at <a href="http://h-node.org/wifi/catalogue/en/1/1/undef/undef/yes?">http://h-node.org/wifi/catalogue/en/1/1/undef/undef/yes?</a>
			</ul>

		<p><a href="#pagetop">Back to top of page</a></p>

<hr/>

	<h1 id="supported_x60_list">List of supported ThinkPad X60's</h1>

		<p>
			Native gpu initialization ('native graphics') which replaces the proprietary VGA Option ROM 
			('<a href="https://en.wikipedia.org/wiki/Video_BIOS">Video BIOS</a>' or 'VBIOS'),
			all known LCD panels are currently compatible:
		</p>

		<p>
			To find what LCD panel you have, see: <a href="../misc/index.html#get_edid_panelname">../misc/index.html#get_edid_panelname</a>.
		</p>

		<ul>
			<li>TMD-Toshiba LTD121ECHB: #</li>
			<li>CMO N121X5-L06: #</li>
			<li>Samsung LTN121XJ-L07: #</li>
			<li>BOE-Hydis HT121X01-101: #</li>		
		</ul>

		<p>
			You can remove an X61/X61s motherboard from the chassis and install an X60/X60s motherboard in it's place (for flashing libreboot). The chassis is mostly identical
			and the motherboards are the same shape/size.
		</p>

		<p>
			The X60 typically comes with an Intel wifi chipset which does not work at all without proprietary firmware, and while Lenovo BIOS is running
			the machine will refuse to boot if you replace the card. Fortunately it is very easily replaced;
			just remove the card and install another one <b>after</b> libreboot is installed. See <a href="#recommended_wifi">#recommended_wifi</a> for replacements.
		</p>

		<p><a href="#pagetop">Back to top of page.</a></p>

<hr/>

	<h1 id="supported_x60t_list">List of supported ThinkPad X60 Tablets</h1>

		<p>
			Native gpu initialization ('native graphics') which replaces the proprietary VGA Option ROM 
			('<a href="https://en.wikipedia.org/wiki/Video_BIOS">Video BIOS</a>' or 'VBIOS').
		</p>

		<p>
			To find what LCD panel you have, see: <a href="../misc/index.html#get_edid_panelname">../misc/index.html#get_edid_panelname</a>.
		</p>

		<p>
			There are 5 known LCD panels for the X60 Tablet:
		</p>
			<ul>
				<li>
					<b>X60T XGA (1024x768):</b>
					<ul>
						<li>BOE-Hydis HV121X03-100 (works)</li>
						<li>Samsung LTN121XP01 (does not work. blank screen)</li>
						<li>BOE-Hydis HT12X21-351 (does not work. blank screen)</li>
					</ul>
				</li>
				<li>
					<b>X60T SXGA+ (1400x1050):</b>
					<ul>
						<li>BOE-Hydis HV121P01-100 (works)</li>
						<li>BOE-Hydis HV121P01-101 (works)</li>
					</ul>
				</li>
			</ul>

		<p>
			Most X60T's only have digitizer (pen), but some have finger (touch) aswell as pen; finger/multitouch doesn't work, only digitizer (pen) does.
		</p>

		<p>
			You can remove an X61/X61s motherboard from the chassis and install an X60/X60s motherboard in it's place (for flashing libreboot). The chassis is mostly identical
			and the motherboards are the same shape/size. <b>It is unknown if the same applies between the X60 Tablet and the X61 Tablet</b>.
		</p>

		<p>
			The X60 Tablet typically comes with an Intel wifi chipset which does not work at all without proprietary firmware, and while Lenovo BIOS is running
			the machine will refuse to boot if you replace the card. Fortunately it is very easily replaced;
			just remove the card and install another one <b>after</b> libreboot is installed. See <a href="#recommended_wifi">#recommended_wifi</a> for replacements.
		</p>

		<p>
			A user with a X60T that has digitizer+finger support, reported that they could get finger input working. They
			used linuxwacom at git tag 0.25.99.2 and had the following in their xorg.conf:
		</p>

<pre>
# Now, for some reason (probably a bug in linuxwacom),
# the 'Touch=on' directive gets reset to 'off'.
# So you'll need to do
# $ xsetwacom --set WTouch Touch on
#
# tested with linuxwacom git 42a42b2a8636abc9e105559e5dea467163499de7

Section &quot;Monitor&quot;
    Identifier             &quot;&lt;default monitor&gt;&quot;
    DisplaySize     245 184
EndSection

Section &quot;Screen&quot;
    Identifier &quot;Default Screen Section&quot;
    Monitor    &quot;&lt;default monitor&lt;&quot;
EndSection

Section &quot;InputDevice&quot;
    Identifier  &quot;WTouch&quot;
    Driver      &quot;wacom&quot;
    Option      &quot;Device&quot; &quot;/dev/ttyS0&quot;
#    Option      &quot;DebugLevel&quot; &quot;12&quot;
    Option      &quot;BaudRate&quot; &quot;38400&quot;
    Option      &quot;Type&quot; &quot;touch&quot;
    Option      &quot;Touch&quot; &quot;on&quot;
    Option      &quot;Gesture&quot; &quot;on&quot;
    Option      &quot;ForceDevice&quot; &quot;ISDV4&quot;
#    Option      &quot;KeepShape&quot; &quot;on&quot;
    Option      &quot;Mode&quot; &quot;Absolute&quot;
    Option      &quot;RawSample&quot; &quot;2&quot;
#    Option      &quot;TPCButton&quot; &quot;off&quot;
    Option      &quot;TopX&quot; &quot;17&quot;
    Option      &quot;TopY&quot; &quot;53&quot;
    Option      &quot;BottomX&quot; &quot;961&quot;
    Option      &quot;BottomY&quot; &quot;985&quot;
EndSection

Section &quot;ServerLayout&quot;
  Identifier    &quot;Default Layout&quot;
  Screen        &quot;Default Screen Section&quot;
  InputDevice   &quot;WTouch&quot; &quot;SendCoreEvents&quot;
EndSection

</pre>

		<p><a href="#pagetop">Back to top of page.</a></p>

<hr/>

	<h1 id="supported_t60_list">Supported T60 list</h1>

		<p>
			Native gpu initialization ('native graphics') which replaces the proprietary VGA Option ROM 
			('<a href="https://en.wikipedia.org/wiki/Video_BIOS">Video BIOS</a>' or 'VBIOS').
		</p>

		<p>
			To find what LCD panel you have, see: <a href="../misc/index.html#get_edid_panelname">../misc/index.html#get_edid_panelname</a>.
		</p>

		<p>
			<b>
				Some T60's have ATI GPU's, and all T60p's have ATI GPU's These are incompatible! See <a href="#t60_ati_intel">#t60_ati_intel</a> for how to remedy this.
			</b>
		</p>

		<p>
			How to dump the EDID:<br/>
			
		</p>

		<p>
			Tested LCD panels: <b>working(compatible)</b>
		</p>
			<ul>
				<li>TMD-Toshiba LTD141EN9B (14.1&quot; 1400x1050) (FRU P/N 41W1478 recommended for the inverter board)</li>
				<li>Samsung LTN141P4-L02 (14.1&quot; 1400x1050) (FRU P/N 41W1478 recommended for the inverter board)</li>
				<li>LG-Philips LP150E05-A2K1 (15.1&quot; 1400x1050) (P/N 42T0078 FRU 42T0079 or P/N 41W1338 recommended for the inverter board)</li>
				<li>Samsung LTN150P4-L01 (15.1&quot; 1400x1050) (P/N 42T0078 FRU 42T0079 or P/N 41W1338 recommended for the inverter board) (not a T60 screen afaik, but it works)</li>
				<li>BOE-Hydis HV150UX1-100 (15.1&quot; 1600x1200) (P/N 42T0078 FRU 42T0079 or P/N 41W1338 recommended for the inverter board)</li>
				<li>IDtech IAQX10N (15.1&quot; 2048x1536) (GRUB doesn't display at the moment, but GNU/Linux works) (P/N 42T0078 FRU 42T0079 or P/N 41W1338 recommended for the inverter board)</li>
			</ul>

		<div class="important">

			<p>
				Tested LCD panels: <b>not working yet (incompatible; see <a href="../future/index.html#lcd_i945_incompatibility">../future/index.html#lcd_i945_incompatibility</a>)</b>
			</p>
				<ul>
					<li>Samsung LTN141XA-L01 (14.1&quot; 1024x768)</li>
					<li>LG-Philips LP150X09 (15.1&quot; 1024x768)</li>
					<li>Samsung LTN150XG (15.1&quot; 1024x768) - <a href="../future/dumps/LTN150XG_edid">EDID dump</a> (taken using <b>sudo i2cdump -y 5 0x50</b>)</li>
					<li>LG-Philips LP150E06-A5K4 (15.1&quot; 1400x1050) (also, not an official T60 screen)</li>
					<li>Samsung LTN154X3-L0A (15.4&quot; 1280x800)</li>
				</ul>

			<p>
				<u><i>The following LCD panels are <b>UNTESTED</b>. If you have one of these panels
				then please submit a report!</i></u>:
			</p>
				<ul>
					<li>CMO(IDtech?) N141XC (14.1&quot; 1024x768)</li>
					<li>BOE-Hydis HT14X14 (14.1&quot; 1024x768)</li>
					<li>TMD-Toshiba LTD141ECMB (14.1&quot; 1024x768)</li>
					<li>Boe-Hydis HT14P12 (14.1&quot; 1400x1050) (FRU P/N 41W1478 recommended for the inverter board)</li>
					<li>CMO (IDtech?) 13N7068 (15.1&quot; 1024x768)</li>
					<li>CMO (IDtech?) 13N7069 (15.1&quot; 1024x768)</li>
					<li>BOE-Hydis HV150P01-100 (15.1&quot; 1400x1050) (P/N 42T0078 FRU 42T0079 or P/N 41W1338 recommended for the inverter board)</li>
					<li>IDtech N150U3-L01 (15.1&quot; 1600x1200) (P/N 42T0078 FRU 42T0079 or P/N 41W1338 recommended for the inverter board)</li>
					<li>BOE-Hydis HV150UX1-102 (15.1&quot; 1600x1200) (P/N 42T0078 FRU 42T0079 or P/N 41W1338 recommended for the inverter board)</li>
					<li>IDtech IAQX10S (15.1&quot; 2048x1536) (P/N 42T0078 FRU 42T0079 or P/N 41W1338 recommended for the inverter board)</li>
					<li>Samsung LTN154P2-L05 (42X4641 42T0329) (15.4&quot; 1680x1050)</li>
					<li>LG-Philips LP154W02-TL10 (13N7020 42T0423) (15.4&quot; 1680x1050)</li>
					<li>LG-Philips LP154WU1-TLB1 (42T0361) (15.4&quot; 1920x1200) <b>(for T61p but it might work in T60. Unknown!)</b></li>
					<li>Samsung LTN154U2-L05 (42T0408 42T0574) (15.4&quot; 1920x1200) <b>(for T61p but it might work in T60. Unknown!)</b></li>
				</ul>

			<p>
				It is unknown whether the 1680x1050 (15.4&quot;) and 1920x1200 (15.4&quot;) panels use a different inverter board than the 1280x800 panels.
			</p>

		<p>
			The T60 typically comes with an Intel wifi chipset which does not work at all without proprietary firmware, and while Lenovo BIOS is running
			the machine will refuse to boot if you replace the card. Fortunately it is very easily replaced;
			just remove the card and install another one <b>after</b> libreboot is installed. See <a href="#recommended_wifi">#recommended_wifi</a> for replacements.
		</p>

		</div>

		<p><a href="#pagetop">Back to top of page.</a></p>

<hr/>

	<h1 id="t60_ati_intel">ThinkPad T60 (ATI GPU) and ThinkPad T60 (Intel GPU) differences.</h1>

		<p>
			If your T60 is a 14.1&quot; or 15.1&quot; model with an ATI GPU, it won't work with libreboot by default but
			you can replace the motherboard with another T60 motherboard that has an Intel GPU, and then libreboot should work.
		</p>

		<p>
			As far as I know, 14.1&quot; (Intel GPU) and 15.1&quot; (Intel GPU) T60 motherboards are the same, where
			'spacers' are used on the 15.1&quot; T60. In any case, it makes sense to find one that is guaranteed to fit in your chassis.
		</p>

		<p>
			There is also a 15.4&quot; T60 with Intel GPU.
		</p>

		<p>
			Note: the T60<b>p</b> laptops all have ATI graphics. 
			The T60p laptops cannot be used with libreboot under any circumstances.
		</p>

		<p>
			The following T60 motherboard (see area highlighted in white) shows an empty space where the ATI GPU would be (this particular motherboard has an Intel GPU):<br/>
			<img src="../images/t60_dev/t60_unbrick.jpg" alt="" />
		</p>

		<p>
			The reason that the ATI GPU on T60 is unsupported is due to the VBIOS (Video BIOS) which is non-free. 
			The VBIOS for the Intel GPU on X60/T60 has been reverse engineered, and replaced with Free Software and
			so will work in libreboot.
		</p>

		<p>
			The 'Video BIOS' is what initializes graphics.
		</p>

		<p>
			See: <a href="https://en.wikipedia.org/wiki/Video_BIOS">https://en.wikipedia.org/wiki/Video_BIOS</a>.<br/>
			In fact, lack of free VBIOS in general is a big problem in coreboot, and is one reason (among others) why many ports for coreboot are 
			unsuitable for libreboot's purpose.
		</p>

		<p>
			Theoretically, the ThinkPad T60 with ATI GPU can work with libreboot and have ROM's compiled for it, however
			in practise it would not be usable as a laptop because there would be no visual display at all. That being said,
			such a configuration is acceptable for use in a 'headless' server setup (with serial and/or ssh console as the display).
		</p>

		<p><a href="#pagetop">Back to top of page.</a></p>

<hr/>

	<h1 id="macbook11">Information about the macbook1,1</h1>

		<p>
			There is an Apple laptop called the macbook1,1 from 2006 which uses the same i945 chipset as the ThinkPad X60/T60. 
			A developer ported the <a href="#macbook21">MacBook2,1</a> to coreboot, the ROM images also work on the macbook1,1.
		</p>

		<p>
			You can refer to <a href="#macbook21">#macbook21</a> for most of this. Macbook2,1 laptops come with Core 2 Duo processors
			which support 64-bit operating systems (and 32-bit). The MacBook1,1 uses Core Duo processors (supports 32-bit OS but not 64-bit),
			and it is believed that this is the only difference.
		</p>

		<p>
			It is believed that all models are compatible, listed here:
		</p>
			<ul>
				<li><a href="http://www.everymac.com/ultimate-mac-lookup/?search_keywords=MacBook1,1">http://www.everymac.com/ultimate-mac-lookup/?search_keywords=MacBook1,1</a></li>
			</ul>

		<h2>
			Compatible models
		</h2>
			<p>
				Specifically (Order No. / Model No. / CPU): 
			</p>
				<ul>
					<li>MA255LL/A / A1181 (EMC 2092) / Core Duo T2500 <b>(tested - working)</b></li>
					<li>MA254LL/A / A1181 (EMC 2092) / Core Duo T2400 (untested)</li>
					<li>MA472LL/A / A1181 (EMC 2092) / Core Duo T2500 (untested)</li>
				</ul>

		<p>
			Also of interest: <a href="../git/index.html#config_macbook21">../git/index.html#config_macbook21</a>.
		</p>

		<p>
			Unbricking: <a href="https://www.ifixit.com/Device/MacBook_Core_2_Duo">this page shows disassembly guides</a> and mono's page (see <a href="#macbook21">#macbook21</a>) 
			shows the location of the SPI flash chip on the motherboard. <a href="https://www.ifixit.com/Guide/MacBook+Core+2+Duo+PRAM+Battery+Replacement/529">How to remove the motherboard</a>.
		</p>

		<p>
			No method is yet known for flashing in GNU/Linux while the Apple firmware is running. You will need to disassemble the machine and flash externally.
			Reading from flash seems to work. Bus Pirate recommended for external flashing (there are others) and needed tools: clip (eg Pomona 5250), mini usb cable,
			bus pirate cable (for connecting Pomona to the bus pirate). 
		</p>

		<p><a href="#pagetop">Back to top of page.</a></p>

<hr/>

	<h1 id="macbook21">Information about the macbook2,1</h1>

		<p>
			There is an Apple laptop called the macbook2,1 from late 2006 or early 2007 that uses the same i945 chipset
			as the ThinkPad X60 and ThinkPad T60. A developer ported coreboot to his macbook2,1, and now libreboot can run on it.
		</p>
		<p>
			Mono Moosbart is the person who wrote the port for macbook2,1. Referenced below are copies (up to date at the time of writing, 20140630)
			of the pages he wrote when porting coreboot to the macbook2,1. They are included here in case the main site goes down for
			whatever reason, since they include a lot of useful information.
		</p>
		<p>
			Backups created using wget:<br/>
			<b>$ wget -m -p -E -k -K -np http://macbook.donderklumpen.de/</b><br/>
			<b>$ wget -m -p -E -k -K -np http://macbook.donderklumpen.de/coreboot/</b><br/>
			Use <b>-e robots=off</b> if using this trick for other sites and the site restricts using robots.txt
		</p>

		<p>
			<b>Links to wget backups (and the backups themselves) of Mono's pages (see above) removed temporarily. Mono has given me permission to distribute them, but I need to ask
			him to tell me what license these works fall under first. Otherwise, the above URL's should be fine. NOTE TO SELF: REMOVE THIS WHEN DONE</b>
		</p>

		<h2>
			Installing GNU/Linux distributions (on Apple EFI firmware)
		</h2>
			<ul>
				<li><a href="#">Parabola GNU/Linux installation on a macbook2,1 with Apple EFI firmware</a> (this is a copy of Mono's page, see above)</li>
			</ul>
			<p>
				How to boot an ISO: burn it to a CD (like you would normally) and hold down the Alt/Control key while booting. 
				The bootloader will detect the GNU/Linux CD as 'Windows' (because Apple doesn't think GNU/Linux exists). Install it like you normally would.
				When you boot up again, hold Alt/Control once more. The installation (on the HDD) will once again be seen as 'Windows'. (it's not actually Windows,
				but Apple likes to think that Apple and Microsoft are all that exist.)
				Now to install libreboot, follow <a href="../install/index.html#flashrom_macbook21">../install/index.html#flashrom_macbook21</a>.
			</p>

		<h2>
			Information about coreboot
		</h2>
			<ul>
				<li><a href="#">Coreboot on the macbook2,1</a> (this is a copy of Mono's page, see above)</li>
			</ul>

		<h2>
			coreboot wiki page
		</h2>
			<ul>
				<li><a href="http://www.coreboot.org/Board:apple/macbook21">http://www.coreboot.org/Board:apple/macbook21</a></li>
			</ul>

		<h2>
			Compatible models
		</h2>
			<p>
				It is believed that all models are compatible, listed here:
			</p>
			<ul>
				<li><a href="http://www.everymac.com/ultimate-mac-lookup/?search_keywords=MacBook2,1">http://www.everymac.com/ultimate-mac-lookup/?search_keywords=MacBook2,1</a></li>
			</ul>
			<p>
				Specifically (Order No. / Model No. / CPU):
			</p>
			<ul>
				<li>MA699LL/A / A1181 (EMC 2121) / Intel Core 2 Duo T5600 <b>(tested - working)</b></li>
				<li>MA701LL/A / A1181 (EMC 2121) / Intel Core 2 Duo T7200 <b>(tested - working)</b></li>
				<li>MB061LL/A / A1181 (EMC 2139) / Intel Core 2 Duo T7200 (untested)</li>
				<li>MA700LL/A / A1181 (EMC 2121) / Intel Core 2 Duo T7200 <b>(tested - working)</b></li>
				<li>MB063LL/A / A1181 (EMC 2139) / Intel Core 2 Duo T7400 (untested)</li>
				<li>MB062LL/A / A1181 (EMC 2139) / Intel Core 2 Duo T7400 <b>(tested - working)</b></li>
			</ul>

		<p>
			Also of interest: <a href="../git/index.html#config_macbook21">../git/index.html#config_macbook21</a>.
		</p>

		<p>
			Unbricking: <a href="https://www.ifixit.com/Device/MacBook_Core_2_Duo">this page shows disassembly guides</a> and mono's page (see above) 
			shows the location of the SPI flash chip on the motherboard. <a href="https://www.ifixit.com/Guide/MacBook+Core+2+Duo+PRAM+Battery+Replacement/529">How to remove the motherboard</a>.
		</p>

		<p>
			Bus Pirate recommended for external flashing (there are others) and needed tools: clip (eg Pomona 5250), mini usb cable,
			bus pirate cable (for connecting Pomona to the bus pirate). 
		</p>

		<p>
			You need to replace OS X with GNU/Linux before flashing libreboot. (OSX won't run at all in libreboot).
		</p>

		<p>
			There are some issues with this machine (compared to other computers that libreboot supports):
		</p>

		<p>
			This is an apple laptop, so it comes with OS X: it has an Apple keyboard, which means that certain keys you expect are missing:
			insert, del, home, end, pgup, pgdown. There is also one mouse button only. Battery life is poor compared to X60/T60 (for now). 
			It also has other issues: for example, the Apple logo on the back is a hole, exposing the backlight, which means that it glows. You should cover it up.
		</p>

		<p>
			The macbook21 gets extremely hot under GNU/Linux and libreboot; Macfanctld (mac fan control daemon) I'm told is a programme (GPLv3 license) that can help with this.
		</p>

		<p>
			Debugging the heating issues (initial work):<br/>
			Distro: Trisquel 7. kernel(linux-libre): 3.13.0-32<br/>
			<b>CPU temperatures:</b><br/>
			52C(idle)/81C(stress) on factory.bin<br/>
			70C(idle)/80C(stress) on coreboot(with microcode updates). libreboot results (without microcode updates) were the same.<br/>
			(libreboot and coreboot rom's were both built from the same code, just with or without microcode included in the rom)<br/>
			battery life was higher on original firmware, lower on coreboot/libreboot.<br/>
			microcode patches included [y/n] makes no difference.<br/>
			libreboot: 1hr18min left on idle (99% battery), 42mins left on stress (82% battery)<br/>
			factory.bin: 2 hours left on idle (99% battery), 48mins left on stress (82% battery)
		</p>
		<p>
			Todo: see what the non-free firmware has in it's ACPI tables using acpidump and iasl -d. Try to implement cstate support in coreboot
			(this will allow for lower temperatures).
		</p>

		<p>
			<b>
				The MacBook2,1 comes with a webcam, which does not work without proprietary software. Also, webcams are a security risk; cover it up! Or remove it.
			</b>
		</p>

		<p>
			A user reported that they could get better response from the touchpad with the following in their xorg.conf:
		</p>

<pre>
Section "InputClass"
 Identifier "Synaptics Touchpad"
 Driver "synaptics"
 MatchIsTouchpad "on"
 MatchDevicePath "/dev/input/event*"
 Driver "synaptics"
# The next two values determine how much pressure one needs
# for tapping, moving the cursor and other events.
 Option "FingerLow" "10"
 Option "FingerHigh" "15"
# Do not emulate mouse buttons in the touchpad corners.
 Option "RTCornerButton" "0"
 Option "RBCornerButton" "0"
 Option "LTCornerButton" "0"
 Option "LBCornerButton" "0"
# One finger tap = left-click
 Option "TapButton1" "1"
# Two fingers tap = right-click
 Option "TapButton2" "3"
# Three fingers tap = middle-mouse
 Option "TapButton3" "2"
# Try to not count the palm of the hand landing on the touchpad
# as a tap. Not sure if helps.
 Option "PalmDetect" "1"
# The following modifies how long and how fast scrolling continues
# after lifting the finger when scrolling
 Option "CoastingSpeed" "20"
 Option "CoastingFriction" "200"
# Smaller number means that the finger has to travel less distance
# for it to count as cursor movement. Larger number prevents cursor
# shaking.
 Option "HorizHysteresis" "10"
 Option "VertHysteresis" "10"
# Prevent two-finger scrolling. Very jerky movement
 Option "HorizTwoFingerScroll" "0"
 Option "VertTwoFingerScroll" "0"
# Use edge scrolling
 Option "HorizEdgeScroll" "1"
 Option "VertEdgeScroll" "1"
EndSection
</pre>

		<p><a href="#pagetop">Back to top of page.</a></p>

<hr/>

	<p>
		Copyright &copy; 2014 Francis Rowe &lt;info@gluglug.org.uk&gt;<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>

</body>
</html>