view README @ 210:071544322478

CHANGES: documented newly added utilities
author Mychaela Falconia <falcon@freecalypso.org>
date Thu, 18 May 2017 23:32:31 +0000
parents 10e0f8fdc37c
children 3b009a0a1873
line wrap: on
line source

You are looking at the top level of the FreeCalypso host tools package.  All
tools in this package have been written to run on a Unix-based or Unix-like
host system, such as a GNU/Linux PC or laptop, with the expectation that the
user will compile them from the source using her regular system C compiler.

Most of these tools interface to and operate on Calypso-based GSM devices,
while a few perform some ancillary functions.  Please see
doc/Host-tools-overview for the listing of what tools are available and what
they do.  These tools are built in the following source directories:

ffstools	tiffs, mokoffs and pirffs are built here.

loadtools	fc-loadtool, fc-iram, fc-xram and fc-compalram form the part of
		FC host tools called loadtools, which used to be its own
		package.  In common with the rest of FC host tools, loadtools
		run on a PC or whatever host system, but they also require two
		target-side components called loadagent (for all targets) and
		compalstage (for Compal phones only).  If you are working with
		a packaged release of FC host tools, as opposed to a random
		snapshot of the source tree, precompiled binaries for loadagent
		and compalstage will be included under
		loadtools/target-binaries.

miscutil	A few miscellaneous utilities are built here.

rvinterf	Everything dealing with the RVTMUX interface to running GSM
		firmwares and everything based on the rvinterf framework is
		built under rvinterf.

		The tfc139 utility, which logically belongs with loadtools, is
		built in the rvinterf subtree because it is built from mostly
		the same source components as rvtdump and rvinterf.

The 4 directories listed above contain all of FC host tools; they are all you
need in order to get a fully working installation of these tools if you are
using the provided precompiled binaries for loadagent and compalstage.  However,
if you would like to recompile these components from source, you will need the
following additional stuff:

target-utils	The source for loadagent and compalstage lives here, along with
		a few extra target utilities that are of interest only to
		developers.

toolchain	Scripts and patches for building the gcc+binutils toolchain
		targeting ARM7, the CPU core of the Calypso GSM/GPRS baseband
		processor.  You'll need to build and install this toolchain
		first before you can build target-utils.