make install && README
[pyfrprog.git] / README
1 What is frprog?
2 frprog is a programmer written in python for programming an microcontroller of
3 the FR Family by Fujitsu. It also includes a simple "kernel" (lets name it
4 "pkernel") for communication to the PC, since the BootROM isn't able to modify
5 the flash.
6
7
8 Why?
9 There are only programmers available on Windows.
10 And Windows sucks, in particular we hate the clickage every time we want to
11 flash a programm on the board. Sadly we don't have a monkey to do this job for
12 us.
13
14
15 Usage:
16 > frprog [target mhx-file]
17 where the target file must be a vaild MHX output of the Softune linker. frprog
18 will instruct you through the process then.
19 (We also build up a simple Makefile which calls their compiler, assembler, ...
20 through wine, so we actually don't rely on Windows for our work :) Contact
21 us if you are interested!)
22
23
24 Supported Microcontroller:
25 o MB91F465X (you find this controller in the "bits pot blue" board by Fujitsu)
26
27
28 Installation:
29 Do the common trick
30 > make && sudo make install
31 to install it. In case, adjust $PREFIX in the Makefile.
32
33 For zsh-users, add this to your .zshrc:
34 > _frprog() {
35 >       _files -J files -g '*.(#i)mhx(.)'
36 > }
37 > compdef _frprog frprog
38
39
40 ToDo:
41 o use checksum for transmission
42 o verify flash
43 o <insert your idea here>
44
45 feel free to contribute!
46
47
48 License and Disclaimer:
49 GPL2 of course and YOU USE THIS PROGRAM ON YOUR OWN
50 RISK ...
51
52
53 Credits:
54 Sebastian "theStack" Falbesoner // sebastian.falbesoner _AT_ gmail _DOT_ com
55 Bernhard "lewurm" Urban // lewurm _AT_ gmail _DOT_ com
56
57 Thanks to Holger for his value hints (check out also his featurerich programmer
58 "FLASHly" http://home.arcor.de/ho/holger.wech/elektronik/ for Windows)