======================
		   OpenEZX's Phonetools
		  ======================

 This is a GUI, written in QT, for the "boot_usb" tool,  that
has been developed by the OpenEZX project' team.

 This is now an user friendly way to make these devices to
boot via USB, either on X11, or on Windows (R).

This tool can also be used for flashing, backup the
 firmware, the RAM content...

=============================================================

	       ===================
		Using Phonetools:
	       ===================

 ALWAYS select the right machine Id in machID field, unless 
the booted kernel will not work properly.


               ============
		Test tools:
	       ============

     Use as a read and backup functionality: 
    -----------------------------------------

 1. Select the phone's machine ID (machid).

 2. Click on the "Download" button and choose a file name for
your backup.

 3. Enter the start address (offset), and the size  (both in
hexadecimal, without the "0x" prefix) of your desired backup.

 Size needs to be a multiple of 0x20000 (131072bytes).

 4. Click on "Flash" and wait.


     Use the flashing functionality.
    ---------------------------------
 1. Select you phone's machine ID.

 2. Click on the "Upload" button and select the file you want
to flash on the phone.

 3. Enter the start address (offset, in hexadecimal, without
the "0x" prefix), the size field isn't used, phonetools will
use the flashfile's size.

 4.Click on "Flash" and wait.


     Use phonetools to execute a code uploaded in RAM.
    ---------------------------------------------------

 Any address between 0xA0000000 and 0xA1FFFFFB is in RAM. 
 But note that gen-blob copy itself on RAM while running,
genblob normally lives at 0xA0200000 (so it ends at
0xA0220000), but while loaded by boot-usb,gen-blob starts at
0xA0300000 and ends at 0xA0320000.

 Upload will fail with an address in flash. so it cannot be
destructive, it only can crash gen-blob if the addresses
overlap.

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

               ========================
		Booting a linux kernel:
	       ========================

 1. Select you machine ID.

 2. Fill the required fields with your respective kernel
image's path, optionnal command line, and if you optionnaly,
the initrd's path too.

3. Click on the "Boot linux".

You can refer to the OpenEZX's wiki for detailled help.
i.e.: http://wiki.openezx.org/Getting_Started

=============================================================

		Compiling: 
	       ===========

On linux, with QT  (version >=4.4 ).
 Qmake && make

TODO:
On windows with MingGW compiler and QT (>=4.4):???

=============================================================
 
Written by Guiming Zhuo, based on Harald Welte's boot_usb.