========================================================
 LinuxLoader on WindowsMobile

 Copyright 2007-2009 zaki <http://llwm.xii.jp/wiki/wiki.cgi>
 All rights reserved.
========================================================

ABOUT

    This is a program that calls Linux kernel image (zImage). 
    It operates on WindowsMobile OS, Xscale PXA27x CPU. 


USAGE

    Put the following files to any folder. 
    * LinuxLoader.exe       -- Main program
    * LinuxLoader.parm.txt  -- File that specifies parameters
    
    When LinuxLoader.exe runs, it reads LinuxLoader.parm.txt file in 
    the same folder. And Linux kernel image (zImage) is called according 
    to the parameter specified in LinuxLoader.parm.txt.
    
    If failing, the log is output to the LoadLinux.error.txt file in
    the same folder. If failing too, the log is output to in the My Documents 
    folder
    
    It leaves the under of the control of WindowsMobile when the Linux kernel 
    is called once. 
    Please reset hardware to return.
    
    It is necessary that called Linux kernel image (zImage) includes rootfs 
    with initramfs. 


PARAMETER

    The parameter that can be specified with LinuxLoader.parm.txt is as 
    follows. 

    ImageFile -- Linux kernel image (zImage) file
    MachineType -- Model number(Refer to linux/arch/arm/tools/mach-types)
    CommandLine -- Command line passed to Linux kernel
    RamAddress -- Physical address of RAM(Hexadecimal number)
    RamSize -- Size of RAM. The unit is MBytes(Decimal number)

    The line which starts # is skipped as a comment. 

    If kernel image is following to '\', it is absolute path. If following
    not to '\', it is relative path.

    The parameter of sha_pon003,004,007,011,020 is appended as a sample. 
    Please edit and use it after rename. 


CAUTION

    * Back up all data and remove the equipment not used, before  executes 
      LinuxLoader.exe.

    * This program doesn't check whether another application program runs. 
      Terminate all another application programs beforehand, and wait enough 
      for time might write flash ROM. 

    * The author is not responsible even if there is an immediate, indirect 
      damage by using the program. 
      Everything must consent as user's responsibility. 


HISTORY
20090704
    Program runs in any folder, not only in My Documents folder.
    Clear register LCCR4.

20080822
    Stop most internal-peripherals.

20080822
    Add code for UHC DMA setting.
    Add sample parameter files for sha_pon020.

20080210
    Fix code for DMA setting.
    Rename sample parameter files.

20070924
    Time can have been passed to Linux.
    Kernel necessary "Set system time from RTC on startup".
        
    Add fbcon=rotate:3 to Commandline in the sample of LinuxLoader.parm.txt.
    
    Add readme-en.txt
    

20070722
    The source is rewritten based on the experiment result.
    
    LIMITATION:
      The size of Linux kernel image (zImage) is maximum about 11Mbytes. 

20070625
    First release. (experiment)

