This is the README-file for ufpb_tool-0.1.0         5-Jun-2002

ufpb_tool makes it possible to bootstrap and upload code to a 
hms_evb_h8s2633f-board via the ufpb (Universal Flash Programming Board).

First of all:

Make sure you know what you do. 
This software works for me, but it might fry your hardware.
The current FZTAT-devices support a maximum of 100 flash erase
cycles, so erasing the flash more than 100 times might break your
hardware. ufpb_tool does not mess with use the flash, but the 
way code is downloaded to the target is not that documented and
_might_ lead to erasure of the flash. Beware. Wear a helmet.

What it does:

ufpb_tool speaks to the ufpb which speaks to the target hardware 
(only a hms_evb_h8s2633f supported now), and uploads a small "ukernel" 
which sets up 128k external RAM at 0x200000. Then the "ukernel" will
take commands from ufpb_tool and read/write the memory of the target
hardware. Finally, the "ukernel" might get a run-command, and your
application will get started. Source-code for the ukernel could be
found under src/target. You will need a cross-toolchain (binutils+gcc)
if you want to compile the ukernel. A binary image of the ukernel is 
also provided.

To build the code:

$ cd src/host
$ make

Hardware setup:

Connect the serial port of you computer to SCI2 of the hms_evb_h8s2633f.

Usage:

Use ./ufpb_tool without any parameters to get usage info.

Or try the interactive monitor:

$ ./ufpb_tool -b hms_evb_h8s2633f -m

To upload a srec-file and start at 0x200

$ ./ufpb_tool -v -b hms_evb_h8s2633f -l file.srec -r 0x200


Redistribution / License:

The code is released under the terms of GPL.

Questions, patches and comments goes to <damm@opensource.se>

Have fun!

/ magnus
