Skip to content

Commit

Permalink
Update README.md
Browse files Browse the repository at this point in the history
  • Loading branch information
MrChromebox committed Jun 25, 2015
1 parent bce9a82 commit f31a6ad
Showing 1 changed file with 36 additions and 11 deletions.
47 changes: 36 additions & 11 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,37 +1,62 @@
# scripts
Collection of scripts for setup/install/firmware update for supported ChromeOS devices
Collection of scripts to install Kodi and/or update the fimware/legacy boot payload on supported ChromeOS devices

**setup-kodi.sh** facilitates the installation of Kodi on supported ChromeOS devices.
**setup-kodi.sh** facilitates the installation of Kodi on supported ChromeOS devices via the installation of either an updated legacy boot payload or a full custom firmware.

It allows the user to install a dual-boot setup with either OpenELEC or Ubuntu
Supported Devices:

function| Haswell Chromebox | Haswell/Broadwell Chromebook | notes
----| :----------: | :----: | -----
Dual Boot (OpenELEC/Ubuntu)|:white_check_mark:|:white_check_mark:|automatically updates legacy boot payload (SeaBIOS) as needed
Update Legacy Boot Payload|:white_check_mark:|:white_check_mark:| does not require firmware write-protect to be disabled
Set Firmware Boot Options|:white_check_mark:|:white_check_mark:|requires firmware write-protect to be disabled
Install/Update Custom coreboot Firmware|:white_check_mark:|:x:|Samsung Series 3 ChromeBox also supported
Create OpenELEC/Kodibuntu boot media|:white_check_mark:|:white_check_mark:| added solely for convenience

This script allows the user to install a dual-boot setup with either OpenELEC or Ubuntu
(with or without Kodi), to set the default OS, and to set the boot timeout on the
developer mode splash screen. It also provides for the installation of an updated
Legacy BIOS for devices that need it.

The script also allows the user to flash custom firmware, turning a ChromeBox into a regular PC,
It also allows the user to flash custom firmware, turning a ChromeBox into a regular PC,
and provides for the creation of installation media for OpenELEC and a custom build of
KodiBuntu (optimized for Haswell-based ChromeOS devices), though any off-the-shelf OS can be
KodiBuntu (optimized for Haswell-based ChromeOS devices); though with the custom firmware, any off-the-shelf OS can be
installed (including Windows 8/8.1/10).

setup-kodi.sh will run on any system with a full bash shell, though the dual-boot related functions
are restricted to ChromeOS.
setup-kodi.sh will run on any Linux system with a full bash shell; the dual-boot functionality is restricted to ChromeOS.

To download and run this script, from a terminal shell: `curl -L -O https://goo.gl/FdvHF6; sudo bash FdvHF6`

More details and support for this script can be found at http://forum.kodi.tv/showthread.php?tid=194362


**setup-firmware.sh** is a slimmed-down version of the above, without the kodi-related parts, and has
**setup-firmware.sh** is a slimmed-down version of the above script (without the kodi-related parts), and has
the same requirements/restrictions as well.

Supported Devices:

function| Haswell Chromebox | Haswell/Broadwell Chromebook | notes
:----:| ---------- | ---- | -----
Update Legacy Boot Payload|:white_check_mark:|:white_check_mark:| does not require firmware write-protect to be disabled
Set Firmware Boot Options|:white_check_mark:|:white_check_mark:|requires firmware write-protect to be disabled
Update/Install Custom coreboot Firmware|:white_check_mark:|:x:|Samsung Series 3 ChromeBox also supported
Restore Stock Firmware|:white_check_mark:|:x:|

It also includes functionality to restore the stock firmware on a Haswell ChromeBox, either
from a backup file or from a generic recovery image firmware file. If the latter is used, the
device-specific VPD (vital product data) is extracted from the running firmware and merged with
the generic firmware file, to ensure the device's unique MAC address, serial #, etc are maintained.
from a backup file (on USB) or from a generic recovery image firmware file (which it will download). If the latter is used, the device-specific VPD (vital product data) is extracted from the running firmware and merged with the generic firmware file, to ensure the device's unique MAC address, serial #, etc are maintained.

To download and run this script, from a terminal shell: `curl -L -O https://goo.gl/1hFfO3; sudo bash 1hFfO3`


**cbox-firmware-update.sh** exists solely to update the custom firmware on Haswell ChromeBoxes running
OpenELEC, which cannot run the above scripts due to lack of a full Bash shell.

Supported Devices:

function| Haswell Chromebox | Haswell/Broadwell Chromebook | notes
:----:| ---------- | ---- | -----
Update Custom coreboot Firmware|:white_check_mark:|:x:|must already be running custom coreboot firmware, not stock

This script will automatically check to see if an updated firmware is available, and if so, prompt the user to update. Install-time options include ability to boot without a connected display ("headless" option) and ability to set the default device to USB (vs internal ssd).

To download and run this script, from a ssh shell: `curl -L -O https://goo.gl/SoCQtG; bash SoCQtG`

0 comments on commit f31a6ad

Please sign in to comment.