X-Git-Url: https://spindle.queued.net/cgi-bin/gitweb.cgi?a=blobdiff_plain;f=README;h=15025d5af29d3ee5d1211a76b6d18aa778a07c68;hb=60f69f877850cb64fd3cafd349bdb7b51c06462a;hp=fb0bc89da5ce7ad3af52d5570c7a34d40882d209;hpb=afd274b3ec930f9cf9af5a7695172c94e703fe10;p=xodist

diff --git a/README b/README
index fb0bc89..15025d5 100644
--- a/README
+++ b/README
@@ -1,10 +1,15 @@
 xodist - Debian image builder for OLPC XO
 
+Why is this needed?  Because the OLPC XO has exceptional and flexible
+firmware support unlike an ordinary PC.  The usual Debian boot CDs do
+not work, yet.  xodist builds a Debian system image in the format
+required by the firmware.
+
 See *.packages for other image flavours, and change "kde" below to the
 flavour.  See README.approx before starting if you would like to cache
 the packages downloaded.
 
-How to use xodist to generate a Debian KDE image:
+How to use xodist to generate a Debian KDE image for an OLPC XO:
 
 1.  build the root filesystem,
 
@@ -14,12 +19,28 @@ How to use xodist to generate a Debian KDE image:
 
 	sudo ./mkjffs2.sh kde.root kde.img
 
-3.  copy the kde.img and kde.crc files to a thumb drive,
+3.  copy the files to a thumb drive,
+
+	sudo ./mkbootable.sh --output /mnt kde
+
+4.  ensure the XO is unlocked, by obtaining a Developer Key, and using
+the OpenFirmware command,
+
+	disable-security
+
+5.  shut down the XO,
+
+6.  insert the thumb drive,
 
-	cp kde.img kde.crc /mnt/
+7.  power up, when prompted press Enter, and the image will be copied
+to the NAND flash, and then booted,
 
-4.  boot an XO into OFW, then type:
+Warning: this erases everything on the XO, including any Developer
+Key, but if you have followed step 4 above that should not matter so
+much.
 
-        copy-nand u:\kde.img
+8.  remove the thumb drive before the next reboot or power up.
 
-Warning: this erases everything on the XO.
+Note: Firmware Q2E20 or newer is required. The jffs2 images are for
+installation on NAND (the onboard flash), the ext3 images are only for
+usbsticks and sd-cards.