INDEX:

1.  FEATURES
2.  BUILDING BLOB FOR INTEL PXA27x PROCESSOR DEVELOPER'S KIT
3.  SWITCH SETTINGS
4.  USB SERIAL
5.  KNOWN PROBLEMS
6.  CHANGELOG

+++ This software is licensed under the GNU GENERAL PUBLIC LICENSE, Version 2, June 1991 +++

---------------------------------------------------------------------------- 
1. FEATURES

Original Blob is a boot loader for SA11x0(StrongARM) platforms. Blob is
able to boot a kernel stored in flash or RAM and provide that with a ramdisk
(again from flash or RAM).  Blob is copyrighted by Jan-Derk Bakker and 
Erik Mouw, and released with a slightly modified GNU GPL license. The official 
Blob web site is
* http://www.lart.tudelft.nl/lartware/blob/
* http://sourceforge.net/projects/blob/

Blob for Intel PXA Architecture is ported from blob-2.0.5-prev3. It adds the
support for Platform PXA27x DVK.

---------------------------------------------------------------------------

2. BUILDING BLOB FOR INTEL PXA27x PROCESSOR DEVELOPER'S KIT

NOTE: Redhat9.x or higher is recommended. Otherwise, you need to upgrade
the automake/autoconf package.

* blob-xlli-snapshot-[mmddyy].tgz

2.1) Unzip the BLOB source code tarball,

   % tar xzf blob-xlli-snapshot-[mmddyy].tgz
   
2.2) Generate the "configure" script, and configure to meet the needs

  % make -f Makefile.cvs
  % ./configure --host=arm-linux --with-board=mainstone \
	--with-linux-prefix=/path/to/kernel --enable-xlli \
	--enable-network
  
  Or, if you want to use "usbdnet" instead of LAN91c111,

  % ./configure --host=arm-linux --with-board=mainstone \
	--with-linux-prefix=/path/to/kernel --enable-xlli \
	--enable-network --enable-usbdnet

NOTE: Please ignore the warnings/errors during "make -f Makefile.cvs".

NOTE: For Linux 2.6.9, we need to create "include/asm" symlink before building
the Blob.

  % cd /path/to/linux-2.6.9/
  % make mainstone_defconfig ARCH=arm CROSS_COMPILE=arm-linux-
  % make include/asm

2.3) Building now,

  % make

You will find the binary "blob" in "src/blob/"

2.4) Usage

2.4.1) Flash mapping

BLOB has the following flash mapping (fixed):

 0x0000,0000 - 0x00003,FFFF	: BLOB
 0x0004,0000 - 0x00023,FFFF	: KERNEL

NOTE: The "KERNEL" partition is changed from 1M to 2M, as the kernel size is
becoming larger.

2.4.2) Switches setting

As it integrated XLLI code, so the switching settings comply with stardard
XLLI/PXA27x DVK spec. For details, refer to section 3, "SWITCH SETTINGS".

Here are the POR'ed frequency points(SW13/SW12): 05, 86, AC, AE, D7, D8, D9, DA, FA

NOTE: SW16 = !dot, SW15 = dot, SW14 = !dot, SW13/SW12 = D9 (DEFAULT)

2.4.3) Commands

- autoip/setip/tftp

  * autoip 

    Grab the IP address using bootp.

  * setip {client|server} ip

    Set IP address for TFTP
   
  * tftp filename {--kernel|--ramfs}

    Specify "--kernel" or "--ramfs" if want to load the binary to the specific
    RAM location. Otherwise, the binary will be load to fixed address.

- fwrite/ferase

  No changes from last release

---------------------------------------------------------------------------

3. SWITCH SETTINGS

Please refer to the tables in "mainstone2-xlli-switch-setting.htm".

NOTE: *NOT ALL* the frequency points are working on PXA27x DVK. 

---------------------------------------------------------------------------
4. USB SERIAL

Please refer "bin/usbserial.tar.bz2" for details.

---------------------------------------------------------------------------

5. KNOWN PROBLEMS

* xdownload may not be functional.
* the commands beyond "tftp/ifconfig/fwrite/fearse/go/boot/autoip/setip" is not 
  well supported.
* When downloading image via ethernet(LAN91c111), ignore the "smc_send: memory 
  alloc time out" warning.

---------------------------------------------------------------------------

6. FAQ

Q  : When I use "fwrite/ferase", it failed and reported a error message.
A  : Please send email with the error message to the contractor for help. 
     Thanks.

Q  : After I use "tftp" to download image, and burn the image into flash, 
     then type "boot" to boot Linux, but it fails to boot.
A  : The kernel(zImage) is loaded to RAM when starting up. After you download 
     images, it may over-write the kernel in RAM. You may use "reload kernel" to 
     reload kernel from flash. At the same time, make sure the image size is <=2M.

Q  : There are some commands, such as "flash" etc don't work!
A  : Please use "tftp/ifconfig/fwrite/ferase/go/setip/autoip/boot/
     clockinfo{mainstone only}" when possible.  The other commands are not well 
     supported.

Q  : How to configurate Blob IP and server IP?
A  : Currently, the Server IP is set to 192.168.1.100; the Blob IP is set 
     to 192.168.1.101. 
     - Use "blob> setip" to show the IP setting.
     - Use "blob> autoip" to grap the IP via BOOTP.
     - Use "blob> setip c xx.xx.xx.xx" to set Blob IP;
     - Use "blob> setip s xx.xx.xx.xx" to set Server IP;

---------------------------------------------------------------------------

5. CHANGELOG
   [N/A]

---------------------------------------------------------------------------

*Other brands and names are the property of their respective owners.