Convert documentation to markdown

1 files changed, 160 insertions, 0 deletions

diff --git a/docs/hcl/t500.md b/docs/hcl/t500.md
new file mode 100644
index 00000000..eebeccb1
--- /dev/null
+++ b/docs/hcl/t500.md
@@ -0,0 +1,160 @@
+<div class="section">
+
+ThinkPad T500 {#pagetop}
+=============
+
+It is believed that all or most T500 laptops are compatible. See notes
+about [CPU
+compatibility](../install/t500_external.html#cpu_compatibility) for
+potential incompatibilities.
+
+There are two possible flash chip sizes for the T500: 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.
+
+**The T500 laptops come with the ME (and sometimes AMT in addition)
+before flashing libreboot. Libreboot disables and removes it by using a
+modified descriptor: see [gm45\_remove\_me.html](gm45_remove_me.html)**
+(contains notes, plus instructions)
+
+Flashing instructions can be found at
+[../install/\#flashrom](../install/#flashrom)
+
+[Back to previous index](./).
+
+</div>
+
+<div class="section">
+
+EC update {#ecupdate}
+=========
+
+It is recommended that you update to the latest EC firmware version. The
+[EC firmware](https://libreboot.org/faq/#firmware-ec) is separate from
+libreboot, so we don\'t actually provide that, but if you still have
+Lenovo BIOS then you can just run the Lenovo BIOS update utility, which
+will update both the BIOS and EC version. See:
+
+-   <https://libreboot.org/docs/install/index.html#flashrom>
+-   <http://www.thinkwiki.org/wiki/BIOS_update_without_optical_disk>
+
+NOTE: this can only be done when you are using Lenovo BIOS. How to
+update the EC firmware while running libreboot is unknown. Libreboot
+only replaces the BIOS firmware, not EC.
+
+Updated EC firmware has several advantages e.g. bettery battery
+handling.
+
+</div>
+
+<div class="section">
+
+Compatibility (without blobs) {#compatibility_noblobs}
+-----------------------------
+
+<div class="subsection">
+
+### Hardware virtualization (vt-x) {#hwvirt}
+
+The T500, 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).
+
+On GM45 hardware (with libreboot), make sure that the *kvm* and
+*kvm\_intel* kernel modules are not loaded, when using QEMU.
+
+The following errata datasheet from Intel might help with investigation:
+<http://download.intel.com/design/mobile/specupdt/320121.pdf>
+
+</div>
+
+</div>
+
+<div class="section">
+
+The T500 is almost identical to the X200, code-wise. See
+[x200.html](x200.html).
+
+</div>
+
+<div class="section">
+
+Descriptor and Gbe differences {#descriptor_difference}
+------------------------------
+
+See
+[../future/dumps/t500\_x200\_descriptor/descriptor\_diff\_t500\_x200.txt](../future/dumps/t500_x200_descriptor/descriptor_diff_t500_x200.txt)
+and
+[../future/dumps/t500\_x200\_descriptor/gbe\_diff\_t500\_x200.txt](../future/dumps/t500_x200_descriptor/gbe_diff_t500_x200.txt)
+
+The patches above are based on the output from ich9deblob on a
+factory.rom image dumped from the T500 with a SOIC-8 4MiB flash chip.
+The patch re-creates the X200 descriptor/gbe source, so the commands
+were something like:\
+\$ **diff -u t500gbe x200gbe**\
+\$ **diff -u t500descriptor x200descriptor**
+
+ME VSCC table is in a different place and a different size on the T500.
+Libreboot disables and removes the ME anyway, so it doesn\'t matter.
+
+The very same descriptor/gbe used on the X200 (generated by
+[ich9gen](gm45_remove_me.html#ich9gen)) was re-used on the T500, and it
+still worked.
+
+</div>
+
+<div class="section">
+
+Hardware register dumps {#regdumps}
+-----------------------
+
+The coreboot wiki
+[shows](http://www.coreboot.org/Motherboard_Porting_Guide) how to
+collect various logs useful in porting to new boards. Following are
+outputs from the T500:
+
+-   T500 with **Macronix MX25L3205D** flash chip (4MiB, SOIC-8) and
+    Lenovo BIOS 3.13 7VET83WW (EC firmware 1.06):
+    -   [../future/dumps/t500log/](../future/dumps/t500log/)
+
+</div>
+
+<div class="section">
+
+Copyright © 2015 Leah Rowe &lt;info@minifree.org&gt;\
+Permission is granted to copy, distribute and/or modify this document
+under the terms of the Creative Commons Attribution-ShareAlike 4.0
+International license or any later version published by Creative
+Commons; A copy of the license can be found at
+[../cc-by-sa-4.0.txt](../cc-by-sa-4.0.txt)
+
+Updated versions of the license (when available) can be found at
+<https://creativecommons.org/licenses/by-sa/4.0/legalcode>
+
+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.
+
+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.
+
+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.
+
+</div>