The Pandora OS
##############


Thanks for your interest in the Pandora OS.
Inside these directories, you can find ready-to-use images as well as the sourcecodes and the latest u-boot.bin and kernel.

The links in the main directory always point to the latest versions, whereas you can find additional files and images within the images-directory.

The sourcecodes to the programs included in the images can be found in the sources-directory, including the licenses for each single one of them.
The kernel and u-boot sourcecodes as well as some other Pandora specific sourcecodes can be found on http://git.openpandora.org/

The OS is based on The Ångström Distribution (http://www.angstrom-distribution.org/).



The rootfs on an SD Card
########################

You can extract the tar.bz2-version of the pandora-image onto an SD Card (EXT2) and directly boot off it.
Be sure to include a kernel in /boot (unless you want to use the one on the NAND) and use a boot.txt / autoboot.txt to pass parameters to u-boot.
This way, you can boot off your SD Card and meddle around with the OS without risking breaking NAND state.

An example for the boot.txt / autoboot.txt to boot from the first partition EXT2 of your SD Card would be:

setenv bootargs root=/dev/mmcblk0p1 rw rootwait vram=6272K omapfb.vram=0:3000K mmc_core.removable=0
ext2load mmc 0 0x80300000 /boot/uImage
bootm 0x80300000

See also http://pandorawiki.org/Running_Linux_from_an_SD_card .



The UBIFS-Version
#################

The UBIFS-Version can be used to flash the firmware to the Pandora.
NOTE: EVERYTHING ON THE NAND WILL BE DELETED!
ADDITIONALLY, DOING THIS OFTEN WILL WEAR OUT YOUR NAND.

To flash, grab the pandora-flash-kit, an UBIFS-image, a kernel and u-boot.bin.
Be sure to follow the instructions in the readme inside the Pandora-Flash-Kit.

To get a package with everything included (where you only need to extract everything onto the SD Card), check the Support-Area on the homepage (http://www.openpandora.org/)

More information about the boot-process and layout of the NAND can be found on DJWillis' blog:
http://blogs.distant-earth.com/wp/?p=79