From c679b19f0b0d95f587b3836c7bf867a932d3df28 Mon Sep 17 00:00:00 2001 From: Leah Rowe Date: Mon, 22 Aug 2016 10:22:04 +0100 Subject: actually add the documentation directory. (I forgot git add in last commit) --- docs/hcl/index.html | 682 ++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 682 insertions(+) create mode 100644 docs/hcl/index.html (limited to 'docs/hcl/index.html') diff --git a/docs/hcl/index.html b/docs/hcl/index.html new file mode 100644 index 00000000..6747cc6d --- /dev/null +++ b/docs/hcl/index.html @@ -0,0 +1,682 @@ + + + + + + + + + Hardware compatibility list + + + + +
+

Hardware compatibility list

+

+ This sections relates to known hardware compatibility in libreboot. +

+ +

+ Back to previous index. +

+
+ +
+ +

List of supported hardware

+ +

+ Libreboot supports the following systems in this release: +

+

Desktops (AMD, Intel, x86)

+ +

Servers/workstations (AMD, x86)

+ +

Laptops (ARM)

+ +

Laptops (Intel, x86)

+ + +

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

+ +

+ It is also possible to build ROM images (from source) for other systems (and virtual systems, e.g. QEMU). +

+ +

Back to top of page

+ +
+ +
+ + +

+ The following are known to work well: +

+ +

+ The following was mentioned (on IRC), but it's unknown to the libreboot project if these work with linux-libre kernel (TODO: test): +

+ + +

Back to top of page

+ +
+ +
+ +

List of supported ThinkPad X60s

+ +

+ Native gpu initialization ('native graphics') which replaces the proprietary VGA Option ROM + ('Video BIOS' or 'VBIOS'), + all known LCD panels are currently compatible: +

+ +

+ To find what LCD panel you have, see: ../misc/index.html#get_edid_panelname. +

+ + + +

+ 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. +

+ +

+ 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 system will refuse to boot if you replace the card. Fortunately it is very easily replaced; + just remove the card and install another one after libreboot is installed. See #recommended_wifi for replacements. +

+ +

Back to top of page.

+ +
+ +
+ +

List of supported ThinkPad X60 Tablets

+ +

+ Native gpu initialization ('native graphics') which replaces the proprietary VGA Option ROM + ('Video BIOS' or 'VBIOS'). +

+ +

+ To find what LCD panel you have, see: ../misc/index.html#get_edid_panelname. +

+ +

+ There are 5 known LCD panels for the X60 Tablet: +

+ + +

+ Most X60Ts only have digitizer (pen), but some have finger (touch) aswell as pen; finger/multitouch doesn't work, only digitizer (pen) does. +

+ +

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

+ +

+ 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 system will refuse to boot if you replace the card. Fortunately it is very easily replaced; + just remove the card and install another one after libreboot is installed. See #recommended_wifi for replacements. +

+ +

+ 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: +

+ +
+# 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 "Monitor"
+	 Identifier             "<default monitor>"
+	 DisplaySize     245 184
+EndSection
+
+Section "Screen"
+	 Identifier "Default Screen Section"
+	 Monitor    "<default monitor<"
+EndSection
+
+Section "InputDevice"
+	 Identifier  "WTouch"
+	 Driver      "wacom"
+	 Option      "Device" "/dev/ttyS0"
+#    Option      "DebugLevel" "12"
+	 Option      "BaudRate" "38400"
+	 Option      "Type" "touch"
+	 Option      "Touch" "on"
+	 Option      "Gesture" "on"
+	 Option      "ForceDevice" "ISDV4"
+#    Option      "KeepShape" "on"
+	 Option      "Mode" "Absolute"
+	 Option      "RawSample" "2"
+#    Option      "TPCButton" "off"
+	 Option      "TopX" "17"
+	 Option      "TopY" "53"
+	 Option      "BottomX" "961"
+	 Option      "BottomY" "985"
+EndSection
+
+Section "ServerLayout"
+  Identifier    "Default Layout"
+  Screen        "Default Screen Section"
+  InputDevice   "WTouch" "SendCoreEvents"
+EndSection
+
+
+ +

Back to top of page.

+ +
+ +
+ +

Supported T60 list

+ +

+ Native gpu initialization ('native graphics') which replaces the proprietary VGA Option ROM + ('Video BIOS' or 'VBIOS'). +

+ +

+ To find what LCD panel you have, see: ../misc/index.html#get_edid_panelname. +

+ +

+ + Some T60s have ATI GPUs, and all T60P laptops have ATI GPUs These are incompatible! See #t60_ati_intel for how to remedy this. + +

+ +

+ How to dump the EDID:
+ +

+ +

+ Tested LCD panels: working(compatible) +

+ + +
+ +

+ Tested LCD panels: not working yet (incompatible; see ../future/index.html#lcd_i945_incompatibility) +

+
    +
  • Samsung LTN141XA-L01 (14.1" 1024x768)
    • +
  • LG-Philips LP150X09 (15.1" 1024x768)
    • +
  • Samsung LTN150XG (15.1" 1024x768)
    • +
  • LG-Philips LP150E06-A5K4 (15.1" 1400x1050) (also, not an official T60 screen)
    • +
  • Samsung LTN154X3-L0A (15.4" 1280x800)
    • +
  • IDtech IAQX10N (15.1" 2048x1536) (no display in GRUB, display in GNU/Linux is temperamental) (P/N 42T0078 FRU 42T0079 or P/N 41W1338 recommended for the inverter board)
    • +
  • IDtech N150U3-L01 (15.1" 1600x1200) (no display in GRUB, display in GNU/Linux works) (P/N 42T0078 FRU 42T0079 or P/N 41W1338 recommended for the inverter board)
    • +
+ +
+ +
+ +

+ The following LCD panels are UNTESTED. If you have one of these panels + then please submit a report!: +

+
    +
  • CMO(IDtech?) N141XC (14.1" 1024x768)
    • +
  • BOE-Hydis HT14X14 (14.1" 1024x768)
    • +
  • TMD-Toshiba LTD141ECMB (14.1" 1024x768)
    • +
  • Boe-Hydis HT14P12 (14.1" 1400x1050) (FRU P/N 41W1478 recommended for the inverter board)
    • +
  • CMO (IDtech?) 13N7068 (15.1" 1024x768)
    • +
  • CMO (IDtech?) 13N7069 (15.1" 1024x768)
    • +
  • BOE-Hydis HV150P01-100 (15.1" 1400x1050) (P/N 42T0078 FRU 42T0079 or P/N 41W1338 recommended for the inverter board)
    • +
  • BOE-Hydis HV150UX1-102 (15.1" 1600x1200) (P/N 42T0078 FRU 42T0079 or P/N 41W1338 recommended for the inverter board)
    • +
  • IDtech IAQX10S (15.1" 2048x1536) (P/N 42T0078 FRU 42T0079 or P/N 41W1338 recommended for the inverter board)
    • +
  • Samsung LTN154P2-L05 (42X4641 42T0329) (15.4" 1680x1050)
    • +
  • LG-Philips LP154W02-TL10 (13N7020 42T0423) (15.4" 1680x1050)
    • +
  • LG-Philips LP154WU1-TLB1 (42T0361) (15.4" 1920x1200) (for T61p but it might work in T60. Unknown!)
    • +
  • Samsung LTN154U2-L05 (42T0408 42T0574) (15.4" 1920x1200) (for T61p but it might work in T60. Unknown!)
    • +
+ +

+ It is unknown whether the 1680x1050 (15.4") and 1920x1200 (15.4") panels use a different inverter board than the 1280x800 panels. +

+ +

+ 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 system will refuse to boot if you replace the card. Fortunately it is very easily replaced; + just remove the card and install another one after libreboot is installed. See #recommended_wifi for replacements. +

+ +
+ +

Back to top of page.

+ +
+ +
+ +

ThinkPad T60 (ATI GPU) and ThinkPad T60 (Intel GPU) differences.

+ +

+ If your T60 is a 14.1" or 15.1" 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. +

+ +

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

+ +

+ There is also a 15.4" T60 with Intel GPU. +

+ +

+ Note: the T60p laptops all have ATI graphics. + The T60p laptops cannot be used with libreboot under any circumstances. +

+ +

+ 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):

+ +

+ +

+ 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. +

+ +

+ The 'Video BIOS' is what initializes graphics. +

+ +

+ See: https://en.wikipedia.org/wiki/Video_BIOS.
+ 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. +

+ +

+ Theoretically, the ThinkPad T60 with ATI GPU can work with libreboot and have ROM images 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). +

+ +

Back to top of page.

+ +
+ +
+ +

Information about the macbook1,1

+ +

+ 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 MacBook2,1 to coreboot, the ROM images also work on the macbook1,1. +

+ +

+ You can refer to #macbook21 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. +

+ +

+ It is believed that all models are compatible, listed here: +

+ + +
+

+ Compatible models +

+

+ Specifically (Order No. / Model No. / CPU): +

+
    +
  • MA255LL/A / A1181 (EMC 2092) / Core Duo T2500 (tested - working)
    • +
  • MA254LL/A / A1181 (EMC 2092) / Core Duo T2400 (tested - working)
    • +
  • MA472LL/A / A1181 (EMC 2092) / Core Duo T2500 (untested)
    • +
+
+ +

+ Also of interest: ../git/index.html#config_macbook21. +

+ +

+ Unbricking: this page shows disassembly guides and mono's page (see #macbook21) + shows the location of the SPI flash chip on the motherboard. How to remove the motherboard. +

+ +

+ No method is yet known for flashing in GNU/Linux while the Apple firmware is running. You will need to disassemble the system and flash externally. + Reading from flash seems to work. For external flashing, refer to ../install/bbb_setup.html. +

+ +

Back to top of page.

+ +
+ +
+ +

Information about the macbook2,1

+ +

+ 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 their macbook2,1, and now libreboot can run on it. +

+

+ 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 that this person 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. +

+

+ Backups created using wget:
+ $ wget -m -p -E -k -K -np http://macbook.donderklumpen.de/
+ $ wget -m -p -E -k -K -np http://macbook.donderklumpen.de/coreboot/
+ Use -e robots=off if using this trick for other sites and the site restricts using robots.txt +

+ +

+ 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 + this person to tell me what license these works fall under first. Otherwise, the above URLs should be fine. NOTE TO SELF: REMOVE THIS WHEN DONE +

+ +
+

+ Installing GNU/Linux distributions (on Apple EFI firmware) +

+ +

+ 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 ../install/index.html#flashrom_macbook21. +

+
+ +
+

+ Information about coreboot +

+ +
+ +
+

+ coreboot wiki page +

+ +
+ +
+

+ Compatible models +

+

+ It is believed that all models are compatible, listed here: +

+ +

+ Specifically (Order No. / Model No. / CPU): +

+
    +
  • MA699LL/A / A1181 (EMC 2121) / Intel Core 2 Duo T5600 (tested - working)
    • +
  • MA701LL/A / A1181 (EMC 2121) / Intel Core 2 Duo T7200 (tested - working)
    • +
  • MB061LL/A / A1181 (EMC 2139) / Intel Core 2 Duo T7200 (untested)
    • +
  • MA700LL/A / A1181 (EMC 2121) / Intel Core 2 Duo T7200 (tested - working)
    • +
  • MB063LL/A / A1181 (EMC 2139) / Intel Core 2 Duo T7400 (works)
    • +
  • MB062LL/A / A1181 (EMC 2139) / Intel Core 2 Duo T7400 (tested - working)
    • +
+
+ +

+ Also of interest: ../git/index.html#config_macbook21. +

+ +

+ Unbricking: this page shows disassembly guides and mono's page (see above) + shows the location of the SPI flash chip on the motherboard. How to remove the motherboard. +

+ +

+ For external flashing, refer to ../install/bbb_setup.html. +

+ +

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

+ +

+ There are some issues with this system (compared to other computers that libreboot supports): +

+ +

+ This is an apple laptop, so it comes with OS X: it has an Apple keyboard, which means that certain keys 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. +

+ +

+ The system does get a bit hotter compared to when running the original firmware. It is certainly hotter + than an X60/T60. The heat issues have been partially fixed by the following patch (now merged in libreboot): + http://review.coreboot.org/#/c/7923/. +

+ +

+ + 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. + +

+ +

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

+ +
+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
+
+

+ A user reported that the above is only for linux kernel 3.15 or lower. For newer kernels, + the touchpad works fine out of the box, except middle tapping. +

+ +

+ A user submitted a utility to enable 3-finger tap on this laptop. It's + available at resources/utilities/macbook21-three-finger-tap in + the libreboot git repository. The script is for GNOME, confirmed to + work in Trisquel 7. +

+ +

Back to top of page.

+ +
+ +
+ +

+ Copyright © 2014, 2015, 2016 Leah Rowe <info@minifree.org>
+ 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 ../gfdl-1.3.txt +

+ +

+ Updated versions of the license (when available) can be found at + https://www.gnu.org/licenses/licenses.html +

+ +

+ 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. +

+ +
+ + + -- cgit v1.2.3-70-g09d2