migrate forgotten text files from xo-strawberry

3 files changed, 127 insertions, 0 deletions

diff --git a/BUILDING b/BUILDING
new file mode 100644
index 0000000..a160283
--- /dev/null
+++ b/BUILDING
@@ -0,0 +1,60 @@
+Quickstart
+-------------
+git clone git://git.sugarlabs.org/soas/devxo.git xo-soas
+cd xo-soas
+git checkout -b xo-strawberry origin/xo-strawberry
+mkdir images cache
+echo "soasxo00" > images/lastbuild
+sudo ./build
+
+
+Introduction
+-------------
+
+This set of scripts is for people that want to build their own
+Sugar/Fedora image customised for the the OLPC XO-1.
+
+The created images are intended to be run from _writable_ media,
+including:
+
+- SD card
+- USB stick
+- XO-1 onboard NAND flash
+
+The created images are not intended to be used to create LiveCDs for
+running on the XO-1*.
+
+
+Objectives
+-------------
+
+This set of scripts:
+
+1a) creates a jffs2 .img, .crc, and .plc file set suitable for OFW's
+    copy-nand and NANDBlaster image-copying methods
+
+1b) creates a file that can be copied bit-for-bit (e.g., dd) onto a 4GB
+    removable drive from which Sugar/F11 can be booted
+
+2)  creates a livecd .ISO suitable for use booting an XO-1 with
+    Sugar/F11 via Fedora's livecd-creator tool
+
+
+Invocaton
+-------------
+
+Scripts are written assuming that "build" is being run by a cron job
+that does the following (note the cd into 'images' and its effect on
+relative paths):
+
+#!/bin/bash
+cd <git_checkout>
+./build
+
+
+
+
+Colophon
+-------------
+
+* a CD player is not a standard XO-1 accessory
diff --git a/README.txt b/README.txt
new file mode 100644
index 0000000..aaff692
--- /dev/null
+++ b/README.txt
@@ -0,0 +1,64 @@
+Instructions for experts:
+------------
+either:  copy-nand u:\soasxo??.img
+or:  cat soasxo??.removable.tar.lzma | lzma -dc - | tar xf - -O > /dev/sdX
+
+
+Quick Start for normal people:
+-------------
+
+Create a removable drive with Sugar for use on your XO.
+
+You need to have an unlocked XO first.  See instructions here for
+unlocking:
+
+http://wiki.laptop.org/go/Activation_and_Developer_Keys#Disable_the_security_system
+
+1) Download the right sized-image:
+
+2) "burn" it onto your removable media (USB stick / SD card).
+
+**** THIS WILL ERASE EVERYTHING ON YOUR REMOVABLE DRIVE ****
+
+ cat soasxoXX.removable.tar.lzma | lzma -dc - | tar xf - -O > /dev/sdX
+
+Replace the "XX" with the right filename, and replace the "/dev/sdX"
+with the name of your removable device (the _whole device_, NOT a
+partition like /dev/sda1)
+
+3) When this is done, eject the device and be sure all data were
+   written:
+
+ eject /dev/sdX ; sync ; sync
+
+4) Plug the stick/card into your XO-1 and power it on.
+
+
+
+Replace your XO operating system
+-------------
+
+There is another way - you can replace your XO's operating system:
+
+**** THIS WILL ERASE EVERYTHING ON YOUR XO laptop ****
+
+1) Download the latest files:
+
+soasxo.img
+soasxo.crc
+
+2) Copy it to a removable drive
+
+3) Plug in your removable drive and press "Esc" after powering up your
+XO.
+
+4a) If your removable drive is a USB drive, type:
+
+copy-nand u:\soasxo.img
+
+4b) If your removable drive is a SD card, type:
+
+copy-nand sd:\soasxo.img
+
+5) When the process completes, remove your drive and reboot the XO.
+
diff --git a/TODO b/TODO
new file mode 100644
index 0000000..38d3d04
--- /dev/null
+++ b/TODO
@@ -0,0 +1,3 @@
+add cjb's screencast
+background SSH host key generation (user will be busy picking colours)
+