]> spindle.queued.net Git - xodist/blob - README
debxo-sugar: update packages for squeeze
[xodist] / README
1 xodist - Debian image builder for OLPC XO
2
3 Why is this needed?  Because the OLPC XO has exceptional and flexible
4 firmware support unlike an ordinary PC.  The usual Debian boot CDs do
5 not work, yet.  xodist builds a Debian system image in the format
6 required by the firmware.
7
8 See configs/* for other image flavours, and change "kde" below to the
9 flavour.  See README.approx before starting if you would like to cache
10 the packages downloaded.
11
12 How to use xodist to generate a Debian KDE image for an OLPC XO:
13
14 1.  build the root filesystem,
15
16         sudo ./mkchroot.sh --config-type debxo-kde debxo-kde.root
17
18 2.  make the JFFS2 filesystem,
19
20         sudo ./mkjffs2.sh --config-type debxo-kde debxo-kde.root debxo-kde.img
21
22 3.  copy the files to a thumb drive,
23
24         sudo ./mkbootable.sh --output /mnt debxo-kde
25
26 4.  ensure the XO is unlocked, by obtaining a Developer Key, and using
27 the OpenFirmware command,
28
29         disable-security
30
31 5.  shut down the XO,
32
33 6.  insert the thumb drive,
34
35 7.  power up, answer the prompt, and the image will be copied to the
36 NAND flash, and then booted,
37
38 Warning: this erases everything on the XO, including any Developer
39 Key, but if you have followed step 4 above that should not matter so
40 much.
41
42 8.  remove the thumb drive before the next reboot or power up.
43
44 Note: Firmware Q2E20 or newer is required. The jffs2 images are for
45 installation on NAND (the onboard flash), the ext3 images are only for
46 usbsticks and sd-cards.