Imaging for XO-1.5

XO-1.5 only.

How to build your own operating system image file, by extracting an image from a laptop and using our tools to convert to the format required by the firmware.

You might do this in order to rapidly deploy a customised image, using fs-update or Nandblaster_for_XO-1.5.

Method 1 - Internal microSD

• prepare the image on the laptop's internal microSD, e.g. by installing a build and making changes, remove the files that Nandblaster_for_XO-1 identified as creating side effects, and then shutdown,
• boot from external SD or use a USB booted Linux such as Tiny Core Linux, see http://lists.laptop.org/pipermail/devel/2010-August/029467.html
• capture the image

cat /dev/mmcblk0 > fs.img

Method 2 - External SD

• prepare the image on a removable SD, e.g. by installing a build to the removable SD and making changes, remove the files that Nandblaster_for_XO-1 identified as creating side effects, and then shutdown,
• remove the SD card and insert into a running system, identify the block device from /proc/partitions,
• capture the image

cat /dev/mmcblk1 > fs.img

Convert to ZD

• build a .zd file of the image:

# yum install git make gcc zlib-devel libtomcrypt-devel
$ git clone git://dev.laptop.org/bios-crypto
$ cd bios-crypto/build
$ make zhashfs
$ ./zhashfs 0x20000 sha256 fs.img fs.zsp fs.zd

(this takes a fair while if run on XO-1.5 hardware, but block number progress feedback is provided)

• test install the image using fs-update.