--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/Makefile.hosttools	Tue Jun 10 09:23:07 2014 +0000
@@ -0,0 +1,15 @@
+SUBDIR=	ffstools loadtools miscutil rvinterf
+
+all:	${SUBDIR}
+
+${SUBDIR}: FRC
+	cd $@; ${MAKE} ${MFLAGS}
+
+clean: FRC
+	rm -f a.out core errs
+	for i in ${SUBDIR}; do (cd $$i; ${MAKE} ${MFLAGS} clean); done
+
+install: FRC
+	for i in ${SUBDIR}; do (cd $$i; ${MAKE} ${MFLAGS} install); done
+
+FRC:

--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/README.hosttools	Tue Jun 10 09:23:07 2014 +0000
@@ -0,0 +1,36 @@
+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	Currently the only utility built under miscutil is 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.