view README.hosttools @ 385:1cb7b2b6ce18

Makefile.hosttools and README.hosttools added at the top level
author Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
date Tue, 10 Jun 2014 09:23:07 +0000
parents
children c6e1c813e7f0
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.  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.