summaryrefslogtreecommitdiffstats
path: root/docs/hcl/r500.html
blob: 434aac78ead4c66ee446bcc1c1f4b81917aca9c5 (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
<!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>ThinkPad R500</title>
</head>

<body>

	<div class="section">
		<h1 id="pagetop">ThinkPad R500</h1>
			
			<p>
				It is believed that all or most R500 laptops are compatible. 
				See notes about <a href="../install/r500_external.html#cpu_compatibility">CPU compatibility</a> for
				potential incompatibilities.
			</p>
			
			<p>
				There are two possible flash chip sizes for the R500: 4MiB (32Mbit) or 8MiB (64Mbit). 
				This can be identified by the type of flash chip below the palmrest: 4MiB is SOIC-8, 8MiB
				is SOIC-16.
				<b>
					NOTE: this paragraph is being treated with contempt. When an R500 was disassembled, it didn't look
					like there was an extra place for SOIC-16. It's highly likely that these laptops only have SOIC-8 (4MiB)
					flash chips. For now, libreboot will distribute 8MiB images just in case. If it is found later on
					that no 8MiB (SOIC-16) chips exist on the R500, then libreboot will cease to distribute 8MiB ROM images
					for this laptop. It is only said that the R500 has 4MiB or 8MiB, for now, since this is the case
					on other GM45 thinkpads that are supported in libreboot.
				</b>
			</p>
			
			<p>
				<b>The R400 laptops come with the ME (and sometimes AMT in addition) before flashing libreboot. Libreboot disables and removes it
				by using a modified descriptor: see <a href="gm45_remove_me.html">gm45_remove_me.html</a></b> (contains notes, plus
				instructions)
			</p>

			<p>
				Flashing instructions can be found at <a href="../install/index.html#flashrom">../install/index.html#flashrom</a>
			</p>

			<p>
				<b>
					NOTE: This board is unsupported in libreboot 20150518. To use it in libreboot, for now,
					you must build for it from source using the libreboot git repository.
				</b>
			</p>
			
			<p>
				<a href="index.html">Back to previous index</a>.
			</p>
	</div>

	<div class="section">

		<h2 id="compatibility_noblobs">Compatibility (without blobs)</h2>

			<div class="subsection">
				<h3 id="hwvirt">Hardware virtualization (vt-x)</h3>
					<p>
						The R400, when run without CPU microcode updates in coreboot, currently kernel panics
						if running QEMU with vt-x enabled on 2 cores for the guest. With a single core enabled
						for the guest, the guest panics (but the host is fine). Working around this in QEMU
						might be possible; if not, software virtualization should work fine (it's just slower).
					</p>
					<p>
						On GM45 hardware (with libreboot), make sure that the <i>kvm</i> and <i>kvm_intel</i> kernel modules
						are not loaded, when using QEMU.
					</p>
					<p>
						The following errata datasheet from Intel might help with investigation:
						<a href="http://download.intel.com/design/mobile/specupdt/320121.pdf">http://download.intel.com/design/mobile/specupdt/320121.pdf</a>
					</p>
			</div>

	</div>

	<div class="section">

		<h1 id="lcd_compatibility">LCD compatibly</h1>
			<p>
				Not all LCD panels are known to be compatible yet. See <a href="gm45_lcd.html">gm45_lcd.html</a>.
			</p>

	</div>

	<div class="section">

		<p>
			The R500 is almost identical to the X200, code-wise, but there are some hardware differences. See <a href="x200.html">x200.html</a>.
		</p>

	</div>

	<div class="section">

		<h2 id="regdumps">Hardware register dumps</h2>

		<p>
			The coreboot wiki <a href="http://www.coreboot.org/Motherboard_Porting_Guide">shows</a>
			how to collect various logs useful in porting to new
			boards.  Following are outputs from the R500:
		</p>

		<ul>
			<li>
				Lenovo BIOS 3.13 (EC firmware 1.06):
				<ul>
					<li><a href="hwdumps/r500/">hwdumps/r500/</a></li>
				</ul>
		</ul>

	</div>

	<div class="section">

		<h1 id="issues">Issues</h1>
			<h2>
				False report of overheating, automatic shut down
			</h2>
				<p>
					When attempting to boot Trisquel 7 live USB (GNOME), the following error appears and then
					the system abruptly shuts down:
					<b>thermal thermal_zone1: critical temperature reached(120 C),shutting down</b>.
				</p>
				<p>
					This is false. When booting with <b>acpi=off</b>, xsensors shows no overheating during a stress test.
					The system does not feel hot, nor does anything smell like it's burning.
				</p>
				<p>
					This is most likely caused by an ACPI bug in coreboot, which will have to be investigated. Grep for those things,
					comparing factory/libreboot (iasl -d or acpidump):
				</p>
<pre>
 Return (C2K(\_SB.PCI0.LPCB.EC.TMP0))
TMP0, 8,        /* Thermal Zone 0 temperature */
</pre>
			<h2>Cardbus slot didn't work when tested</h2>
				<p>
					Investigate.
				</p>

	</div>

	<div class="section">

		<h1>Descriptor differences</h1>

			<p>
				The <i>ich9gen</i> and <i>ich9deblob</i> utilities were modified,
				to reflect these differences.
			</p>

			<h2>Component 1 Density</h2>

<pre>
-    descriptorStruct.componentSection.flcomp.component1Density = 0x4;
+    descriptorStruct.componentSection.flcomp.component1Density = 0x3;
</pre>

				<p>
					Read page 848 in the ICH9 datasheet, linked to from <a href="gm45_remove_me.html#flash_descriptor_region">gm45_remove_me.html#flash_descriptor_region</a>.
					This doesn't break anything, but in the process of debugging descriptor differences on the R500, it was found that this
					config option isn't being modified in libreboot, for different size ROM images. 4MiB ROM images still contain 0x4 for component1Density.
					Per datasheets, 0x4 (100) is 8MiB, and 0x3 (011) is 4MiB. <b>This should be fixed!</b>
				</p>
				<p>
					It was 0x3 for this test, because the R500 that was used to create this report
					had a 4MiB SOIC-8 flash chip.
				</p>

			<h2>flReg1.LIMIT</h2>

<pre>
-    /* descriptorStruct.regionSection.flReg1.LIMIT = 0x07ff; */
+    /* descriptorStruct.regionSection.flReg1.LIMIT = 0x03ff; */
</pre>

				<p>
					Ignore this. This is not used at all, and is instead automatically set, depending on
					the targetted ROM image size, both in ich9gen and ich9deblob. 0x7ff means 8MiB, and 0x3ff means 
					4MiB. flReg1 is for the BIOS region. Simply speaking, this is defining the final 4KiB section
					of the ROM image, where the BIOS region ends.
				</p>
				<p>
					It was 0x3ff for this test, because the R500 that was used to create this report
					had a 4MiB SOIC-8 flash chip.
				</p>

			<h2>Onboard gigabit ethernet NIC is disabled</h2>

<pre>
-    descriptorStruct.ichStraps.ichStrap0.integratedGbe = 0x1;
-    descriptorStruct.ichStraps.ichStrap0.lanPhy = 0x1;
+    descriptorStruct.ichStraps.ichStrap0.integratedGbe = 0x0;
+    descriptorStruct.ichStraps.ichStrap0.lanPhy = 0x0;
</pre>

				<p>
					Most GM45 laptops (e.g. X200, T400, T500, R400) have the <b>Intel 82567LM</b>
					integrated gigabit NIC.
				</p>
				<p>
					On the R500, a <b>Broadcom BCM5787M</b> NIC is present. To make this work,
					the change above must be made for the R500 descriptor.
				</p>

		<h1 id="nogbe">No Gbe region!</h1>

			<p>
				Not shown in the diffs above:
			</p>

<pre>
Original: Descriptor start block: 00000000 ; Descriptor end block: 00000000
Original: BIOS start block: 00200000 ; BIOS end block: 003ff000
Original: ME start block: 00001000 ; ME end block: 001f7000
Original: GBe start block: 00fff000 ; GBe end block: 00000000
Original: Platform start block: 001f8000 ; Platform end block: 001ff000
</pre>

			<p>
				As explained above, this laptop uses a Broadcom NIC, which means that
				the Gbe region does not and <i>should not</i> exist, since this is for the
				Intel NIC only.
			</p>
			<p>
				In the output above, Gbe starts at fff and ends at 000. Base 1FFF or FFF, and limit 0,
				means that the region is disabled.
			</p>
			<p>
				In the output above, the ME region is 4KiB larger than on other GM45 systems that have
				a Gbe region. This accounts for the lack of a Gbe region.
			</p>

			<p>
				As part of this effort, ich9gen/ich9deblob/demefactory will all be
				modified to account for the differences above.
			</p>

	</div>

	<div class="section">

		<p>
			Copyright &copy;  2015 Francis Rowe &lt;info@gluglug.org.uk&gt;<br/>
			Permission is granted to copy, distribute and/or modify this document
			under the terms of the GNU Free Documentation License, Version 1.3
			or any later version published by the Free Software Foundation;
			with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.
			A copy of the license can be found at <a href="../gfdl-1.3.txt">../gfdl-1.3.txt</a>
		</p>

		<p>
			Updated versions of the license (when available) can be found at
			<a href="https://www.gnu.org/licenses/licenses.html">https://www.gnu.org/licenses/licenses.html</a>
		</p>

		<p>
			UNLESS OTHERWISE SEPARATELY UNDERTAKEN BY THE LICENSOR, TO THE
			EXTENT POSSIBLE, THE LICENSOR OFFERS THE LICENSED MATERIAL AS-IS
			AND AS-AVAILABLE, AND MAKES NO REPRESENTATIONS OR WARRANTIES OF
			ANY KIND CONCERNING THE LICENSED MATERIAL, WHETHER EXPRESS,
			IMPLIED, STATUTORY, OR OTHER. THIS INCLUDES, WITHOUT LIMITATION,
			WARRANTIES OF TITLE, MERCHANTABILITY, FITNESS FOR A PARTICULAR
			PURPOSE, NON-INFRINGEMENT, ABSENCE OF LATENT OR OTHER DEFECTS,
			ACCURACY, OR THE PRESENCE OR ABSENCE OF ERRORS, WHETHER OR NOT
			KNOWN OR DISCOVERABLE. WHERE DISCLAIMERS OF WARRANTIES ARE NOT
			ALLOWED IN FULL OR IN PART, THIS DISCLAIMER MAY NOT APPLY TO YOU.
		</p>
		<p>
			TO THE EXTENT POSSIBLE, IN NO EVENT WILL THE LICENSOR BE LIABLE
			TO YOU ON ANY LEGAL THEORY (INCLUDING, WITHOUT LIMITATION,
			NEGLIGENCE) OR OTHERWISE FOR ANY DIRECT, SPECIAL, INDIRECT,
			INCIDENTAL, CONSEQUENTIAL, PUNITIVE, EXEMPLARY, OR OTHER LOSSES,
			COSTS, EXPENSES, OR DAMAGES ARISING OUT OF THIS PUBLIC LICENSE OR
			USE OF THE LICENSED MATERIAL, EVEN IF THE LICENSOR HAS BEEN
			ADVISED OF THE POSSIBILITY OF SUCH LOSSES, COSTS, EXPENSES, OR
			DAMAGES. WHERE A LIMITATION OF LIABILITY IS NOT ALLOWED IN FULL OR
			IN PART, THIS LIMITATION MAY NOT APPLY TO YOU.
		</p>
		<p>
			The disclaimer of warranties and limitation of liability provided
			above shall be interpreted in a manner that, to the extent
			possible, most closely approximates an absolute disclaimer and
			waiver of all liability.
		</p>
		
	</div>

</body>
</html>