convert documentation to texinfo

author: Francis Rowe <info@gluglug.org.uk> 2015-11-06 17:43:29 (EST)
committer: Francis Rowe <info@gluglug.org.uk> 2015-11-06 23:45:09 (EST)
commit: 95259e28ef047923258434898113d70c8e544eab (patch)
tree: 1c0501bf4c7df1c31948184dabfc1e7c4c215a6e /docs/hcl/r500.html
parent: 707f9383a8189b0054730134340f20709f56f976 (diff)
download: libreboot-95259e28ef047923258434898113d70c8e544eab.zip
libreboot-95259e28ef047923258434898113d70c8e544eab.tar.gz
libreboot-95259e28ef047923258434898113d70c8e544eab.tar.bz2
1 files changed, 0 insertions, 299 deletions
diff --git a/docs/hcl/r500.html b/docs/hcl/r500.html
deleted file mode 100644
index 434aac7..0000000
--- a/docs/hcl/r500.html
+++ /dev/null
@@ -1,299 +0,0 @@
-<!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>
author	Francis Rowe <info@gluglug.org.uk>	2015-11-06 17:43:29 (EST)
committer	Francis Rowe <info@gluglug.org.uk>	2015-11-06 23:45:09 (EST)
commit	95259e28ef047923258434898113d70c8e544eab (patch)
tree	1c0501bf4c7df1c31948184dabfc1e7c4c215a6e /docs/hcl/r500.html
parent	707f9383a8189b0054730134340f20709f56f976 (diff)
download	libreboot-95259e28ef047923258434898113d70c8e544eab.zip libreboot-95259e28ef047923258434898113d70c8e544eab.tar.gz libreboot-95259e28ef047923258434898113d70c8e544eab.tar.bz2