+
−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.  The tools collected in the
+
−present package are as follows:
+
−
+
−ffstools	Here you will find tools for "in vitro" examination of FFS
+
−		(flash file system) images read out of TI-based GSM devices.
+
−		See doc/TIFFS-Overview for more information.
+
−
+
−loadtools	These tools allow you to load your own code into Calypso GSM
+
−		devices.  Using these tools, you can load code into target
+
−		device IRAM or XRAM and run it there, as well as dump and load
+
−		flash.  The operation of these tools is based on gaining
+
−		control of the target device either through the Calypso on-chip
+
−		boot ROM (on freedom-enabled devices), or through the
+
−		flash-resident boot code on the crippled Compal phones.
+
−
+
−miscutil	Two miscellaneous utilities are currently built here:
+
−		fc-serterm, which is a simple binary-safe serial terminal for
+
−		talking to debug serial ports that mix ASCII with binary, and
+
−		imei-luhn, whose function should be self-explanatory.
+
−
+
−rvinterf	In common with TI's original fw, FreeCalypso GSM fw implements
+
−		the so-called RiViera serial MUX, which is a binary packet
+
−		protocol for multiplexing many kinds of debug and development
+
−		traffic over just one available physical serial port.  This
+
−		rvinterf directory contains our suite of tools for connecting
+
−		to this RV serial interface, supporting both our own gsm-fw as
+
−		well as some existing proprietary firmwares to the extent to
+
−		which they are compatible.
+
−
+
−		The tfc139 utility, which logically belongs with loadtools, is
+
−		built in the rvinterf subtree because it is based on the
+
−		rvinterf framework.