diff options
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/hcl/index.html | 1 | ||||
| -rw-r--r-- | docs/hcl/kcma-d8.html | 183 | ||||
| -rw-r--r-- | docs/install/index.html | 24 | ||||
| -rw-r--r-- | docs/install/kcma-d8.html | 105 | ||||
| -rw-r--r-- | docs/release.html | 7 |
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 © 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> |