readme.txt 3.4 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798
  1. OLPC XO Laptops
  2. ===============
  3. This document explains how to build and run images that run on the OLPC
  4. XO laptops.
  5. Supported models
  6. ----------------
  7. * OLPC XO-1
  8. The original NS Geode based OLPC laptop, uses the x86 architecture.
  9. Can be booted either from an internal MTD device formatted with JFFS2
  10. or from a FAT or EXT4 partition on a SD card or a USB flash stick.
  11. * OLPC XO-7.5
  12. The ARM-based laptop. Needs a recent enough firmware to provide a good
  13. enough flattened device tree to the kernel. Can be from a FAT or EXT4
  14. partition on a internal eMMC, a SD card or a USB flash stick.
  15. Configure and build
  16. ===================
  17. $ make olpc_xo1_defconfig # Configure for XO-1
  18. or:
  19. $ make olpc_xo175_defconfig # Configure for XO-1.75
  20. Then:
  21. $ make menuconfig # Customize the build configuration
  22. $ make # Build
  23. Preparing the machine
  24. =====================
  25. Firmware security
  26. -----------------
  27. Most OLPC machines were shipped with the security system that disallows
  28. booting unsigned software. If this is the case with your machine, in order
  29. to run the image you've built on it you'll need to get a developer key and
  30. deactivate the security system.
  31. The procedure is descriped in the OLPC wiki:
  32. http://wiki.laptop.org/go/Activation_and_Developer_Keys
  33. Firmware upgrade
  34. ----------------
  35. It is always preferrable to use an up to date firmware. The firmware images
  36. are available at http://wiki.laptop.org/go/Firmware. For the XO-1.75 laptop
  37. to boot the mainline kernel a firmware Q4E00JA or newer is needed. You can
  38. get it at http://dev.laptop.org/~quozl/q4e00ja.rom.
  39. To update the firmware, place the .rom file on to your bootable media,
  40. connect a charged battery pack and a wall adapter, and enter the Open
  41. Firmware prompt by pressing ESC during the early boot (needs an unlocked
  42. laptop -- see "Firmware security" above). Then use the "flash" command
  43. to update the firmware:
  44. ok flash ext:\q4e00ja.rom \ Flash the "q4e00ja.rom" from the SD card
  45. ok flash u:\q4e00ja.rom \ Flash the "q4e00ja.rom" from USB stick
  46. Create the bootable SD card or USB flash stick
  47. ==============================================
  48. When the build is finished, an image file called "sdcard.img" will be created.
  49. It is suitable for writing directly to a SD card, USB flash stick or (on a
  50. XO-1.75) the internal eMMC flash.
  51. Before writing the image, please double check that you're using the right
  52. device (e.g. with "lsblk" command). Doing the following will DESTROY ALL DATA
  53. that's currently on the media.
  54. # cat output/images/sdcard.img >/dev/<device>
  55. Flashing the JFFS2 image (XO-1 only)
  56. ====================================
  57. Unlike XO-1.75, the internal NAND flash on XO-1 is accessed without a
  58. FTL and needs a flash-friendly filesystem. A build configured for XO-1
  59. creates a file named "root.jffs2" that can be written to it.
  60. One way to write it is from the Open Firmware prompt. First, partition
  61. and format a USB flash disk with a FAT file system and place the
  62. "root.jffs2" file onto it. Then power on the machine, enter the
  63. Open Firmware port by pressing the ESC key and run the following:
  64. ok patch noop ?open-crcs copy-nand \ Disable CRC check
  65. ok copy-nand u:\root.jffs2
  66. Booting the machine
  67. ===================
  68. Once your machine is unlocked, it will automatically boot from your media
  69. wherever it will detect it attached to the USB bus or the SD card slot,
  70. otherwise it will proceed booting from the internal flash.