Customization stick

From OLPC
Revision as of 22:39, 1 March 2008 by 18.85.46.179 (talk)
Jump to navigation Jump to search

The customization key allows you to install your own set of activities and library content on top of a signed OLPC build.

Preparing the key:

  • Unpack customize.zip into the root directory of a USB key.
    • This will create an empty subdirectory 'bundles' and a subdirectory 'boot' containing two files 'runos.zip' and 'actos.zip'.
  • Add 'fs.zip' and 'osXYZ.img' from the base build you want to install.
  • Drag the .xo files (activity bundles) and .xol files (library bundles) you want to install into the 'bundles' directory.
  • If you create a zip file containing 'frame00.565' through 'frame26.565' and place it in 'bundles' with a name ending in '.pb', you can customize the boot sequence.

Using the key:

Once you've created your usb stick(s) in this way:

  • Insert the stick into a powered-off XO
  • Turn the machine on while holding down all four game pad keys.

The machine will erase all contents of the flash on the XO, install the base build, and then install your custom activity and content set. It will then power-off, and you can remove the stick and move on to the next XO.

Advanced usage:

You can use this technique to upgrade activities without installing a new base build. Just insert the key and boot without holding down the gamepad keys.