From 9e2cfd3d676433a8bf8624f5e56d1df1c8e1f29d Mon Sep 17 00:00:00 2001
From: Francis Rowe <info@gluglug.org.uk>
Date: Sat, 30 Jan 2016 05:07:47 -0500
Subject: backport 75ab59d4e141d106970f397c31d52ba486117fc9
---
(limited to 'docs')
diff --git a/docs/hcl/index.html b/docs/hcl/index.html
index 8ad08b4..f28b037 100644
--- a/docs/hcl/index.html
+++ b/docs/hcl/index.html
@@ -45,6 +45,7 @@
<h3 id="supported_desktops_x86amdintel">Desktops (AMD, Intel, x86)</h3>
<ul>
<li><a href="ga-g41m-es2l.html">Gigabyte GA-G41M-ES2L motherboard</a></li>
+ <li><a href="kcma-d8.html">ASUS KCMA-D8 motherboard</a></li>
</ul>
<h3 id="supported_workstations_x86amd">Servers/workstations (AMD, x86)</h3>
<ul>
diff --git a/docs/hcl/kcma-d8.html b/docs/hcl/kcma-d8.html
new file mode 100644
index 0000000..4a4fbf8
--- /dev/null
+++ b/docs/hcl/kcma-d8.html
@@ -0,0 +1,183 @@
+<!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>ASUS KCMA-D8 server/workstation board</title>
+</head>
+
+<body>
+
+ <div class="section">
+ <h1 id="pagetop">ASUS KCMA-D8 server/workstation board</h1>
+
+ <p>
+ This is a server board using AMD hardware (Fam10h <b>and Fam15h</b> CPUs available). It can also be used
+ for building a high-powered workstation. Powered by libreboot. The coreboot port was done by
+ Timothy Pearson of <a href="https://raptorengineeringinc.com/">Raptor Engineering Inc.</a> and,
+ working with Timothy (and sponsoring the work) merged into libreboot.
+ </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>
+ Flashing instructions can be found at <a href="../install/index.html#flashrom">../install/index.html#flashrom</a>
+ - note that external flashing is required (e.g. BBB), if the proprietary (ASUS) firmware is currently installed.
+ If you already have libreboot, by default it is possible to re-flash using software running in GNU/Linux
+ on the kcma-d8, without using external hardware.
+ </p>
+
+ <p>
+ <a href="index.html">Back to previous index</a>.
+ </p>
+ </div>
+
+ <div class="section">
+ <h1 id="boardstatus">Board status (compatibility)</h1>
+ <p>
+ See <a href="https://raptorengineeringinc.com/coreboot/kcma-d8-status.php">https://raptorengineeringinc.com/coreboot/kcma-d8-status.php</a>.
+ </p>
+ </div>
+
+ <div class="section">
+ <h1 id="formfactor">Form factor</h1>
+ <p>
+ These boards use the SSI EEB 3.61 form factor; make sure
+ that your case supports this. This form factor is similar
+ to E-ATX in that the size is identical, but the position of
+ the screws are different.
+ </p>
+ </div>
+
+ <div class="section">
+ <h1 id="ipmi">IPMI iKVM module add-on</h1>
+ <p>
+ Don't use it. It uses proprietary firmware and adds a backdoor (remote out-of-band management chip,
+ similar to the <a href="http://libreboot.org/faq/#intelme">Intel Management Engine</a>. Fortunately,
+ the firmware is unsigned (possibly to replace) and physically separate from the mainboard since it's
+ on the add-on module, which you don't have to install.
+ </p>
+ </div>
+
+ <div class="section">
+ <h1 id="flashchips">Flash chips</h1>
+ <p>
+ 2MiB flash chips are included by default, on these boards. It's on a P-DIP 8 slot (SPI chip).
+ The flash chip can be upgraded to higher sizes: 4MiB, 8MiB or 16MiB. With at least 8MiB,
+ you could feasibly fit a compressed linux+initramfs image (BusyBox+Linux system) into CBFS
+ and boot that, loading it into memory.
+ </p>
+ <p>
+ Libreboot has configs for 2, 4, 8 and 16 MiB flash chip sizes (default flash chip is 2MiB).
+ </p>
+ <p>
+ <b>
+ DO NOT hot-swap the chip with your bare hands. Use a P-DIP 8
+ chip extractor. These can be found online.
+ See <a href="http://www.coreboot.org/Developer_Manual/Tools#Chip_removal_tools">http://www.coreboot.org/Developer_Manual/Tools#Chip_removal_tools</a>
+ </b>
+ </p>
+ </div>
+
+ <div class="section">
+ <h1 id="graphics">Native graphics initialization</h1>
+ <p>
+ Only text-mode is known to work, but linux(kernel) can initialize
+ the framebuffer display (if it has KMS - kernel mode setting).
+ </p>
+ </div>
+
+ <div class="section">
+ <h1 id="issues">Current issues</h1>
+ <ul>
+ <li>RDIMM memory modules untested, according to tpearson (they'll probably work)</li>
+ <li>LRDIMM memory modules are currently incompatible</li>
+ <li>
+ SAS (via PIKE 2008 module) requires non-free option ROM (and SeaBIOS) to boot from it
+ (theoretically possible to replace, but you can put a kernel in CBFS or on SATA
+ and use that to boot GNU, which can be on a SAS drive. The linux kernel can use
+ those SAS drives (via PIKE module) without an option ROM).
+ </li>
+ <li>
+ IPMI iKVM module (optional add-on card) uses proprietary firmware. Since it's for
+ remote out-of-band management, it's theoretically a backdoor similar to the Intel
+ Management Engine. Fortunately, unlike the ME, this firmware is unsigned which
+ means that a free replacement is theoretically possible. For now, the libreboot project
+ recommends not installing the module. <a href="https://github.com/facebook/openbmc">This project</a>
+ might be interesting to derive from, for those who want to work on a free replacement.
+ In practise, out-of-band management isn't very useful anyway (or at the very least,
+ it's not a major inconvenience to not have it).
+ </li>
+ <li>Graphics: only text-mode works. See <a href="#graphics">#graphics</a></li>
+ </ul>
+ </div>
+
+ <div class="section">
+ <h2 id="specifications">Hardware specifications</h2>
+ <p>
+ Check the ASUS website.
+ </p>
+ </div>
+
+ <div class="section">
+
+ <p>
+ Copyright © 2016 Francis Rowe <info@gluglug.org.uk><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>
+
diff --git a/docs/install/index.html b/docs/install/index.html
index 894abd4..8b4703f 100644
--- a/docs/install/index.html
+++ b/docs/install/index.html
@@ -43,6 +43,7 @@
<li><a href="bbb_setup.html">Flashing the Gigabyte GA-G41M-ES2L (has 2 SOIC-8 chips, one is backup)</a></li>
<li><a href="bbb_ehci.html">How to configure EHCI debugging on the BeagleBone Black</a></li>
<li><a href="kgpe-d16.html">KGPE-D16 (needed if running the proprietary firmware, or to unbrick)</a></li>
+ <li><a href="kcma-d8.html">KCMA-D8 (needed if running the proprietary firmware, or to unbrick)</a></li>
<li><a href="x60_unbrick.html">ThinkPad X60: Recovery guide</a></li>
<li><a href="x60tablet_unbrick.html">ThinkPad X60 Tablet: Recovery guide</a></li>
<li><a href="t60_unbrick.html">ThinkPad T60: Recovery guide</a></li>
@@ -213,6 +214,29 @@
Do check the HCL entry: <a href="../hcl/kgpe-d16.html">../hcl/kgpe-d16.html</a>
</p>
+ <h2>ASUS KCMA-D8?</h2>
+
+ <p>
+ If you have the proprietary BIOS, you need to flash libreboot externally.
+ See <a href="kgpe-d16.html">kcma-d8.html</a>.
+ </p>
+ <p>
+ If you already have coreboot or libreboot installed, without write protection on the flash
+ chip, then you can do it in software (otherwise, see link above).
+ </p>
+
+ <p>
+ <b>
+ DO NOT hot-swap the chip with your bare hands. Use a PDIP-8
+ chip extractor. These can be found online.
+ See <a href="http://www.coreboot.org/Developer_Manual/Tools#Chip_removal_tools">http://www.coreboot.org/Developer_Manual/Tools#Chip_removal_tools</a>
+ </b>
+ </p>
+
+ <p>
+ Do check the HCL entry: <a href="../hcl/kcma-d8.html">../hcl/kcma-d8.html</a>
+ </p>
+
<h2>Are you currently running libreboot (or coreboot)?</h2>
<p>
diff --git a/docs/install/kcma-d8.html b/docs/install/kcma-d8.html
new file mode 100644
index 0000000..3d4fac4
--- /dev/null
+++ b/docs/install/kcma-d8.html
@@ -0,0 +1,105 @@
+<!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>KCMA-D8 external flashing instructions</title>
+</head>
+
+<body>
+
+ <div class="section">
+ <h1 id="pagetop">KCMA-D8 external flashing instructions</h1>
+ <p>Initial flashing instructions for kcma-d8.</p>
+ <p>
+ This guide is for those who want libreboot on their ASUS kcma-d8
+ motherboard, while they still have the proprietary ASUS BIOS present.
+ This guide can also be followed (adapted) if you brick you board, to know
+ how to recover.
+ </p>
+
+ <p>
+ For more general information about this board, refer to
+ <a href="../hcl/kcma-d8.html">../hcl/kcma-d8.html</a>.
+ </p>
+
+ <p>
+ TODO: show photos here, and other info.
+ </p>
+
+ <ul>
+ <li><a href="#preinstall">kcma-d8 boards (and full systems) with libreboot preinstalled</a></li>
+ <li><a href="#programmer">External programmer</a></li>
+ </ul>
+
+ <p><a href="index.html">Back to main index</a></p>
+ </div>
+
+ <div class="section">
+ <h1 id="programmer">External programmer</h1>
+ <p>
+ Refer to <a href="bbb_setup.html">bbb_setup.html</a> for a guide on
+ how to set up an external SPI programmer.
+ </p>
+ <p>
+ The flash chip is in a PDIP 8 socket (SPI flash chip) on the motherboard,
+ which you take out and then re-flash with libreboot, using the programmer.
+ <b>DO NOT</b> remove the chip with your hands. Use a chip extractor tool.
+ </p>
+ </div>
+
+ <div class="section">
+
+ <p>
+ Copyright © 2016 Francis Rowe <info@gluglug.org.uk><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>
diff --git a/docs/release.html b/docs/release.html
index 9af40ee..a9d708a 100644
--- a/docs/release.html
+++ b/docs/release.html
@@ -72,6 +72,13 @@
</ul>
</li>
<li>
+ <b>ASUS KCMA-D8 desktop/workstation board</b>
+ <ul>
+ <li>Check notes in <b><i>docs/hcl/kcma-d8.html</i></b></li>
+ <li><b>NOTE: not in libreboot 20150518. Only in git, for now.</b></li>
+ </ul>
+ </li>
+ <li>
<b>ThinkPad X60/X60s</b>
<ul>
<li>
--
cgit v0.9.1