From bd6ff49ac5e71133402b55af70dac864e81e0112 Mon Sep 17 00:00:00 2001 From: Leah Rowe Date: Sun, 19 Feb 2023 11:49:28 +0000 Subject: [PATCH] re-add C201 pages --- site/docs/hardware/c201.md | 9 +++ site/docs/hardware/index.md | 2 +- site/docs/install/c201.md | 97 ++++++++++++++++++++++++++++++++ site/docs/install/chromebooks.md | 21 +++++++ 4 files changed, 128 insertions(+), 1 deletion(-) create mode 100644 site/docs/hardware/c201.md create mode 100644 site/docs/install/c201.md diff --git a/site/docs/hardware/c201.md b/site/docs/hardware/c201.md new file mode 100644 index 0000000..1e8188b --- /dev/null +++ b/site/docs/hardware/c201.md @@ -0,0 +1,9 @@ +--- +title: ASUS Chromebook C201 +x-toc-enable: true +... + +This page is absolete. Refer to these pages instead: + +* [C201 flashing instructions](../install/c201.md) +* [Chromebook flashing instructions](../install/chromebooks.md) diff --git a/site/docs/hardware/index.md b/site/docs/hardware/index.md index f18129b..73cb308 100644 --- a/site/docs/hardware/index.md +++ b/site/docs/hardware/index.md @@ -64,7 +64,7 @@ libreboot currently supports the following systems in this release: - [Acer Chromebook 13 (CB5-311, C810) (nyan-big)](../install/chromebooks.md) - [ASUS Chromebit CS10 (veyron-mickey)](../install/chromebooks.md) - [ASUS Chromebook Flip C100PA (veyron-minnie)](../install/chromebooks.md) -- [ASUS Chromebook C201PA (veyron-speedy)](../install/chromebooks.md) +- [ASUS Chromebook C201PA (veyron-speedy)](../install/c201.md) - [Hisense Chromebook C11 and more (veyron-jerry)](../install/chromebooks.md) - [ASUS Chromebook Flip C101 (gru-bob)](../install/chromebooks.md) - [Samsung Chromebook Plus (v1) (gru-kevin)](../install/chromebooks.md) diff --git a/site/docs/install/c201.md b/site/docs/install/c201.md new file mode 100644 index 0000000..38f96b8 --- /dev/null +++ b/site/docs/install/c201.md @@ -0,0 +1,97 @@ +--- +title: ASUS Chromebook C201 installation guide +x-toc-enable: true +... + +Introduction +=========== + +This page contains information about assembly and disassembly, for flashing +the ASUS Chromebook C201 externally. It will also link to internal flashing +instructions, and information about U-Boot. + +Flashrom +-------- + +A special fork of flashrom, maintained by Google, is required for flashing. +More information about this is present in the generic [chromebook flashing +instructions](chromebooks.md). + +Depthcharge payload (obsolete) +------------------------------ + +This board was also supported in Libreboot 20160907, with the Depthcharge +payload. Support was dropped in later releases, and then re-added in the +December 2022 release but with *u-boot* payload (not *depthcharge*). + +Refer to older versions of this page, in `lbwww.git`, if you wish to see +instructions pertaining to Depthcharge: + +* +* + +U-boot payload +============== + +U-Boot was ported to coreboot CrOS devices, courtesy of Alper Nebi +Yasak (`alpernebbi` on Libreboot IRC). + +Read the section pertaining to U-boot payload: + +[u-boot payload documentation for Libreboot](../uboot/) + +Internal flashing +================= + +External flashing is possible, but only necessary in the event of a *brick*. +If you're flashing good firmware, and the machine boots properly, you can +do it in software, from the host CPU. + +In the past, C201 was the only CrOS device so this page contained information +about internal flashing. Libreboot now supports many more CrOS devices, so +the information has moved. + +See: [chromebook flashing instructions](chromebooks.md) + +Write-protect screw +------------------- + +The chromebook flashing instructions, linked above, refer to a *screw* that +can be turned, to disable flash protection. This is necessary, for internally +flashing the C201. This section will tell you how to access that screw. + +To access the screw, the device has to be opened. There are 8 screws to remove +from the bottom of the device, as shown on the picture below. Two are hidden +under the top pads. After removing the screws, the keyboard plastic part can be +carefully detached from the rest. Beware: there are cables attached to it! It +is advised to flip the keyboard plastic part over, as shown on the picture +below. The write protect screw is located next to the SPI flash chip, circled +in red in the picture below. It has to be removed. Refer to the following +photos: + +[![Screws](https://av.libreboot.org/c201/screws.jpg)](https://av.libreboot.org/c201/screws.jpg) + +[![WP screw](https://av.libreboot.org/c201/wp-screw.jpg)](https://av.libreboot.org/c201/wp-screw.jpg) + +The write protect screw can be put back in place later, when the device +is known to be in a working state. + +External flashing +================= + +If the machine is no longer booting, due to bad firmware, you can unbrick +it externally. Refer to [external flash instructions](spi.md). + +[![SPI flash +layout](https://av.libreboot.org/c201/spi-flash-layout.jpg)](https://av.libreboot.org/c201/spi-flash-layout.jpg) + +[![Battery +connector](https://av.libreboot.org/c201/battery-connector.jpg)](https://av.libreboot.org/c201/battery-connector.jpg) + +You do not need to correct the `WP#` pin because it is held high via pull-up +resistor to 3.3v, when the write-protect screw is loosened (when tightened, +the screw grounds this pin; the pull-up resistor is to prevent a dead short). + +You must remove the battery, prior to flashing. The connector is shown in +the 2nd photo, above (the big black connector, with the black, green, yellow, +white and red wires going into it). Simply unplug that. diff --git a/site/docs/install/chromebooks.md b/site/docs/install/chromebooks.md index acd8897..4cf09f3 100644 --- a/site/docs/install/chromebooks.md +++ b/site/docs/install/chromebooks.md @@ -7,6 +7,16 @@ This page attempts to give a brief, general overview of how to flash custom firmware on ChromeOS devices. This guide usually refers to all of them as "Chromebook"s since it's the most common form factor. +Flashrom +======== + +A special fork of flashrom, maintained by Google, is required for flashing +these Chromebook devices. See: + + + +You must then compile this from source, and run it. + Enable ChromeOS "Developer Mode" ================================ @@ -147,6 +157,17 @@ To flash the entire ROM image internally, run within ChromeOS: If you can already boot a conventional Linux distro on your Chromebook, you may be able to use `flashrom -p linux_mtd` on that system instead. +Install an operating system +=========================== + +Libreboot currently lacks any good documentation about this, but there +is this page which refers to Debian: + +[Debian installation](https://wiki.debian.org/InstallingDebianOn/Asus/C201) + +In general, ARM-compatible distros targeting U-boot can be used. You can +follow their instructions, once you have Libreboot up and running. + See also ========