FreeCalypso > hg > freecalypso-tools
comparison README @ 0:e7502631a0f9
initial import from freecalypso-sw rev 1033:5ab737ac3ad7
| author | Mychaela Falconia <falcon@freecalypso.org> |
|---|---|
| date | Sat, 11 Jun 2016 00:13:35 +0000 |
| parents | |
| children | 10e0f8fdc37c |
comparison
equal
deleted
inserted
replaced
| -1:000000000000 | 0:e7502631a0f9 |
|---|---|
| 1 You are looking at the top level of the FreeCalypso host tools package. All | |
| 2 tools in this package have been written to run on a Unix-based or Unix-like | |
| 3 host system, such as a GNU/Linux PC or laptop, with the expectation that the | |
| 4 user will compile them from the source using her regular system C compiler. | |
| 5 | |
| 6 Most of these tools interface to and operate on Calypso-based GSM devices, | |
| 7 while a few perform some ancillary functions. Please see | |
| 8 doc/Host-tools-overview for the listing of what tools are available and what | |
| 9 they do. These tools are built in the following source directories: | |
| 10 | |
| 11 ffstools tiffs, mokoffs and pirffs are built here. | |
| 12 | |
| 13 loadtools fc-loadtool, fc-iram, fc-xram and fc-compalram form the part of | |
| 14 FC host tools called loadtools, which used to be its own | |
| 15 package. In common with the rest of FC host tools, loadtools | |
| 16 run on a PC or whatever host system, but they also require two | |
| 17 target-side components called loadagent (for all targets) and | |
| 18 compalstage (for Compal phones only). If you are working with | |
| 19 a packaged release of FC host tools, as opposed to a random | |
| 20 snapshot of the source tree, precompiled binaries for loadagent | |
| 21 and compalstage will be included under | |
| 22 loadtools/target-binaries. | |
| 23 | |
| 24 lcdemu fc-lcdemu is built here. | |
| 25 | |
| 26 miscutil fc-rgbconv, fc-serterm and imei-luhn are built here. | |
| 27 | |
| 28 rvinterf Everything dealing with the RVTMUX interface to running GSM | |
| 29 firmwares and everything based on the rvinterf framework is | |
| 30 built under rvinterf. | |
| 31 | |
| 32 The tfc139 utility, which logically belongs with loadtools, is | |
| 33 built in the rvinterf subtree because it is built from mostly | |
| 34 the same source components as rvtdump and rvinterf. | |
| 35 | |
| 36 The 5 directories listed above contain all of FC host tools; they are all you | |
| 37 need in order to get a fully working installation of these tools if you are | |
| 38 using the provided precompiled binaries for loadagent and compalstage. However, | |
| 39 if you would like to recompile these components from source, you will need the | |
| 40 following additional stuff: | |
| 41 | |
| 42 target-utils The source for loadagent and compalstage lives here, along with | |
| 43 a few extra target utilities that are of interest only to | |
| 44 developers. | |
| 45 | |
| 46 toolchain Scripts and patches for building the gcc+binutils toolchain | |
| 47 targeting ARM7, the CPU core of the Calypso GSM/GPRS baseband | |
| 48 processor. You'll need to build and install this toolchain | |
| 49 first before you can build target-utils. |