FreeCalypso > hg > freecalypso-tools
annotate README @ 1014:961efadd530a default tip
fc-shell TCH DL handler: add support for CSD modes
TCH DL capture mechanism in FC Tourmaline firmware has been extended
to support CSD modes in addition to speech - add the necessary support
on the host tools side.
It needs to be noted that this mechanism in its present state does NOT
provide the debug utility value that was sought: as we learned only
after the code was implemented, TI's DSP has a misfeature in that the
buffer we are reading (a_dd_0[]) is zeroed out when the IDS block
is enabled, i.e., we are reading all zeros and not the real DL bits
we were after. But since the code has already been written, we are
keeping it - perhaps we can do some tests with IDS disabled.
author | Mychaela Falconia <falcon@freecalypso.org> |
---|---|
date | Tue, 26 Nov 2024 06:27:43 +0000 |
parents | dddcd55883fe |
children |
rev | line source |
---|---|
0
e7502631a0f9
initial import from freecalypso-sw rev 1033:5ab737ac3ad7
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
1 You are looking at the top level of the FreeCalypso host tools package. All |
e7502631a0f9
initial import from freecalypso-sw rev 1033:5ab737ac3ad7
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
2 tools in this package have been written to run on a Unix-based or Unix-like |
e7502631a0f9
initial import from freecalypso-sw rev 1033:5ab737ac3ad7
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
3 host system, such as a GNU/Linux PC or laptop, with the expectation that the |
e7502631a0f9
initial import from freecalypso-sw rev 1033:5ab737ac3ad7
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
4 user will compile them from the source using her regular system C compiler. |
434
3ec8ef8b2d37
top README simplified, source dirs info moved to Source-dirs
Mychaela Falconia <falcon@freecalypso.org>
parents:
390
diff
changeset
|
5 See INSTALL for installation instructions. Most of these tools interface to |
3ec8ef8b2d37
top README simplified, source dirs info moved to Source-dirs
Mychaela Falconia <falcon@freecalypso.org>
parents:
390
diff
changeset
|
6 and operate on Calypso-based GSM devices, while a few perform some ancillary |
3ec8ef8b2d37
top README simplified, source dirs info moved to Source-dirs
Mychaela Falconia <falcon@freecalypso.org>
parents:
390
diff
changeset
|
7 functions. Please see doc/Host-tools-overview for the listing of what tools |
3ec8ef8b2d37
top README simplified, source dirs info moved to Source-dirs
Mychaela Falconia <falcon@freecalypso.org>
parents:
390
diff
changeset
|
8 are available and what they do. |
0
e7502631a0f9
initial import from freecalypso-sw rev 1033:5ab737ac3ad7
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
9 |
434
3ec8ef8b2d37
top README simplified, source dirs info moved to Source-dirs
Mychaela Falconia <falcon@freecalypso.org>
parents:
390
diff
changeset
|
10 The most commonly needed tool for flashing firmware images (fc-loadtool) and |
3ec8ef8b2d37
top README simplified, source dirs info moved to Source-dirs
Mychaela Falconia <falcon@freecalypso.org>
parents:
390
diff
changeset
|
11 some of the more rarely needed tools (fc-xram, fc-iram when used with Mot C1xx |
3ec8ef8b2d37
top README simplified, source dirs info moved to Source-dirs
Mychaela Falconia <falcon@freecalypso.org>
parents:
390
diff
changeset
|
12 phones, and fc-buzplay) have target-side components, i.e., a part of their |
3ec8ef8b2d37
top README simplified, source dirs info moved to Source-dirs
Mychaela Falconia <falcon@freecalypso.org>
parents:
390
diff
changeset
|
13 functionality is implemented in Calypso ARM7 code pieces which these tools feed |
3ec8ef8b2d37
top README simplified, source dirs info moved to Source-dirs
Mychaela Falconia <falcon@freecalypso.org>
parents:
390
diff
changeset
|
14 to the Calypso chip's boot ROM or to Mot/Compal's bootloader on Mot C1xx phones. |
3ec8ef8b2d37
top README simplified, source dirs info moved to Source-dirs
Mychaela Falconia <falcon@freecalypso.org>
parents:
390
diff
changeset
|
15 The most important of these ARM7 code pieces is loadagent (implements flash |
3ec8ef8b2d37
top README simplified, source dirs info moved to Source-dirs
Mychaela Falconia <falcon@freecalypso.org>
parents:
390
diff
changeset
|
16 reading and writing, hardware peeks and pokes, and the chain loading function |
3ec8ef8b2d37
top README simplified, source dirs info moved to Source-dirs
Mychaela Falconia <falcon@freecalypso.org>
parents:
390
diff
changeset
|
17 for fc-xram) which is needed for all of our supported Calypso targets (it is |
3ec8ef8b2d37
top README simplified, source dirs info moved to Source-dirs
Mychaela Falconia <falcon@freecalypso.org>
parents:
390
diff
changeset
|
18 also common to all of them, no variants), and the second most important piece |
3ec8ef8b2d37
top README simplified, source dirs info moved to Source-dirs
Mychaela Falconia <falcon@freecalypso.org>
parents:
390
diff
changeset
|
19 is compalstage, which is needed for Compal (Mot C1xx) phones only. |
390
c7599298998c
README: updated for the new set of top-level source directories
Mychaela Falconia <falcon@freecalypso.org>
parents:
211
diff
changeset
|
20 |
434
3ec8ef8b2d37
top README simplified, source dirs info moved to Source-dirs
Mychaela Falconia <falcon@freecalypso.org>
parents:
390
diff
changeset
|
21 If you are working with a packaged release of FC host tools, as opposed to a |
3ec8ef8b2d37
top README simplified, source dirs info moved to Source-dirs
Mychaela Falconia <falcon@freecalypso.org>
parents:
390
diff
changeset
|
22 random snapshot of the source tree, precompiled binaries for loadagent and |
3ec8ef8b2d37
top README simplified, source dirs info moved to Source-dirs
Mychaela Falconia <falcon@freecalypso.org>
parents:
390
diff
changeset
|
23 compalstage will be included in the target-bin directory, otherwise you will |
3ec8ef8b2d37
top README simplified, source dirs info moved to Source-dirs
Mychaela Falconia <falcon@freecalypso.org>
parents:
390
diff
changeset
|
24 need to build them from source: the source for loadagent and compalstage (plus |
3ec8ef8b2d37
top README simplified, source dirs info moved to Source-dirs
Mychaela Falconia <falcon@freecalypso.org>
parents:
390
diff
changeset
|
25 a few extra target utilities that are of interest only to developers) resides |
3ec8ef8b2d37
top README simplified, source dirs info moved to Source-dirs
Mychaela Falconia <falcon@freecalypso.org>
parents:
390
diff
changeset
|
26 in target-utils, and you will first need to build and install a special ARM7 |
3ec8ef8b2d37
top README simplified, source dirs info moved to Source-dirs
Mychaela Falconia <falcon@freecalypso.org>
parents:
390
diff
changeset
|
27 gcc toolchain as explained in the INSTALL document. |
0
e7502631a0f9
initial import from freecalypso-sw rev 1033:5ab737ac3ad7
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
28 |
434
3ec8ef8b2d37
top README simplified, source dirs info moved to Source-dirs
Mychaela Falconia <falcon@freecalypso.org>
parents:
390
diff
changeset
|
29 There is a good amount of documentation included in the doc directory, and |
3ec8ef8b2d37
top README simplified, source dirs info moved to Source-dirs
Mychaela Falconia <falcon@freecalypso.org>
parents:
390
diff
changeset
|
30 there is more documentation in our dedicated freecalypso-docs repository: |
0
e7502631a0f9
initial import from freecalypso-sw rev 1033:5ab737ac3ad7
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
31 |
569
dddcd55883fe
README: Bitbucket link changed to new location (freecalypso-docs)
Mychaela Falconia <falcon@freecalypso.org>
parents:
434
diff
changeset
|
32 https://www.freecalypso.org/hg/freecalypso-docs/ |