backport 75ab59d4e141d106970f397c31d52ba486117fc9

author: Francis Rowe <info@gluglug.org.uk> 2016-01-30 05:07:47 (EST)
committer: Francis Rowe <info@gluglug.org.uk> 2016-01-30 05:07:47 (EST)
commit: 9e2cfd3d676433a8bf8624f5e56d1df1c8e1f29d (patch)
tree: e06d0fc211ec7deed5539f3714450e40ec594a36
parent: 1f48be7d3dda953164d6e6d20eab75ff5b88de2e (diff)
download: libreboot-9e2cfd3d676433a8bf8624f5e56d1df1c8e1f29d.zip
libreboot-9e2cfd3d676433a8bf8624f5e56d1df1c8e1f29d.tar.gz
libreboot-9e2cfd3d676433a8bf8624f5e56d1df1c8e1f29d.tar.bz2
5 files changed, 320 insertions, 0 deletions
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 &copy;  2016 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>
+
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 &copy;  2016 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>
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>
author	Francis Rowe <info@gluglug.org.uk>	2016-01-30 05:07:47 (EST)
committer	Francis Rowe <info@gluglug.org.uk>	2016-01-30 05:07:47 (EST)
commit	9e2cfd3d676433a8bf8624f5e56d1df1c8e1f29d (patch)
tree	e06d0fc211ec7deed5539f3714450e40ec594a36
parent	1f48be7d3dda953164d6e6d20eab75ff5b88de2e (diff)
download	libreboot-9e2cfd3d676433a8bf8624f5e56d1df1c8e1f29d.zip libreboot-9e2cfd3d676433a8bf8624f5e56d1df1c8e1f29d.tar.gz libreboot-9e2cfd3d676433a8bf8624f5e56d1df1c8e1f29d.tar.bz2