annotate README.hosttools @ 923:10b4bed10192

gsm-fw/L1: fix for the DSP patch corruption bug The L1 code we got from the LoCosto fw contains a feature for DSP CPU load measurement. This feature is a LoCosto-ism, i.e., not applicable to earlier DBB chips (Calypso) with their respective earlier DSP ROMs. Most of the code dealing with that feature is conditionalized as #if (DSP >= 38), but one spot was missed, and the MCU code was writing into an API word dealing with this feature. In TCS211 this DSP API word happens to be used by the DSP code patch, hence that write was corrupting the patched DSP code.
author Mychaela Falconia <falcon@ivan.Harhan.ORG>
date Mon, 19 Oct 2015 17:13:56 +0000
parents c6e1c813e7f0
children 63ebab69680a
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
385
1cb7b2b6ce18 Makefile.hosttools and README.hosttools added at the top level
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
1 You are looking at the top level of the FreeCalypso host tools package. All
1cb7b2b6ce18 Makefile.hosttools and README.hosttools added at the top level
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
2 tools in this package have been written to run on a Unix-based or Unix-like
1cb7b2b6ce18 Makefile.hosttools and README.hosttools added at the top level
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
3 host system, such as a GNU/Linux PC or laptop, with the expectation that the
1cb7b2b6ce18 Makefile.hosttools and README.hosttools added at the top level
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
4 user will compile them from the source using her regular system C compiler.
1cb7b2b6ce18 Makefile.hosttools and README.hosttools added at the top level
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
5
1cb7b2b6ce18 Makefile.hosttools and README.hosttools added at the top level
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
6 Most of these tools interface to and operate on Calypso-based GSM devices,
1cb7b2b6ce18 Makefile.hosttools and README.hosttools added at the top level
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
7 while a few perform some ancillary functions. The tools collected in the
1cb7b2b6ce18 Makefile.hosttools and README.hosttools added at the top level
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
8 present package are as follows:
1cb7b2b6ce18 Makefile.hosttools and README.hosttools added at the top level
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
9
1cb7b2b6ce18 Makefile.hosttools and README.hosttools added at the top level
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
10 ffstools Here you will find tools for "in vitro" examination of FFS
1cb7b2b6ce18 Makefile.hosttools and README.hosttools added at the top level
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
11 (flash file system) images read out of TI-based GSM devices.
1cb7b2b6ce18 Makefile.hosttools and README.hosttools added at the top level
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
12 See doc/TIFFS-Overview for more information.
1cb7b2b6ce18 Makefile.hosttools and README.hosttools added at the top level
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
13
1cb7b2b6ce18 Makefile.hosttools and README.hosttools added at the top level
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
14 loadtools These tools allow you to load your own code into Calypso GSM
1cb7b2b6ce18 Makefile.hosttools and README.hosttools added at the top level
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
15 devices. Using these tools, you can load code into target
1cb7b2b6ce18 Makefile.hosttools and README.hosttools added at the top level
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
16 device IRAM or XRAM and run it there, as well as dump and load
1cb7b2b6ce18 Makefile.hosttools and README.hosttools added at the top level
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
17 flash. The operation of these tools is based on gaining
1cb7b2b6ce18 Makefile.hosttools and README.hosttools added at the top level
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
18 control of the target device either through the Calypso on-chip
1cb7b2b6ce18 Makefile.hosttools and README.hosttools added at the top level
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
19 boot ROM (on freedom-enabled devices), or through the
1cb7b2b6ce18 Makefile.hosttools and README.hosttools added at the top level
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
20 flash-resident boot code on the crippled Compal phones.
1cb7b2b6ce18 Makefile.hosttools and README.hosttools added at the top level
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
21
435
c6e1c813e7f0 README.hosttools: updated for serterm
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents: 385
diff changeset
22 miscutil Two miscellaneous utilities are currently built here:
c6e1c813e7f0 README.hosttools: updated for serterm
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents: 385
diff changeset
23 fc-serterm, which is a simple binary-safe serial terminal for
c6e1c813e7f0 README.hosttools: updated for serterm
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents: 385
diff changeset
24 talking to debug serial ports that mix ASCII with binary, and
c6e1c813e7f0 README.hosttools: updated for serterm
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents: 385
diff changeset
25 imei-luhn, whose function should be self-explanatory.
385
1cb7b2b6ce18 Makefile.hosttools and README.hosttools added at the top level
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
26
1cb7b2b6ce18 Makefile.hosttools and README.hosttools added at the top level
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
27 rvinterf In common with TI's original fw, FreeCalypso GSM fw implements
1cb7b2b6ce18 Makefile.hosttools and README.hosttools added at the top level
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
28 the so-called RiViera serial MUX, which is a binary packet
1cb7b2b6ce18 Makefile.hosttools and README.hosttools added at the top level
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
29 protocol for multiplexing many kinds of debug and development
1cb7b2b6ce18 Makefile.hosttools and README.hosttools added at the top level
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
30 traffic over just one available physical serial port. This
1cb7b2b6ce18 Makefile.hosttools and README.hosttools added at the top level
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
31 rvinterf directory contains our suite of tools for connecting
1cb7b2b6ce18 Makefile.hosttools and README.hosttools added at the top level
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
32 to this RV serial interface, supporting both our own gsm-fw as
1cb7b2b6ce18 Makefile.hosttools and README.hosttools added at the top level
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
33 well as some existing proprietary firmwares to the extent to
1cb7b2b6ce18 Makefile.hosttools and README.hosttools added at the top level
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
34 which they are compatible.
1cb7b2b6ce18 Makefile.hosttools and README.hosttools added at the top level
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
35
1cb7b2b6ce18 Makefile.hosttools and README.hosttools added at the top level
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
36 The tfc139 utility, which logically belongs with loadtools, is
1cb7b2b6ce18 Makefile.hosttools and README.hosttools added at the top level
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
37 built in the rvinterf subtree because it is based on the
1cb7b2b6ce18 Makefile.hosttools and README.hosttools added at the top level
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
38 rvinterf framework.