comparison 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
comparison
equal deleted inserted replaced
384:7ef814efbebe 385:1cb7b2b6ce18
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. The tools collected in the
8 present package are as follows:
9
10 ffstools Here you will find tools for "in vitro" examination of FFS
11 (flash file system) images read out of TI-based GSM devices.
12 See doc/TIFFS-Overview for more information.
13
14 loadtools These tools allow you to load your own code into Calypso GSM
15 devices. Using these tools, you can load code into target
16 device IRAM or XRAM and run it there, as well as dump and load
17 flash. The operation of these tools is based on gaining
18 control of the target device either through the Calypso on-chip
19 boot ROM (on freedom-enabled devices), or through the
20 flash-resident boot code on the crippled Compal phones.
21
22 miscutil Currently the only utility built under miscutil is imei-luhn,
23 whose function should be self-explanatory.
24
25 rvinterf In common with TI's original fw, FreeCalypso GSM fw implements
26 the so-called RiViera serial MUX, which is a binary packet
27 protocol for multiplexing many kinds of debug and development
28 traffic over just one available physical serial port. This
29 rvinterf directory contains our suite of tools for connecting
30 to this RV serial interface, supporting both our own gsm-fw as
31 well as some existing proprietary firmwares to the extent to
32 which they are compatible.
33
34 The tfc139 utility, which logically belongs with loadtools, is
35 built in the rvinterf subtree because it is based on the
36 rvinterf framework.