FreeCalypso > hg > freecalypso-tools

annotate doc/Host-tools-overview @ 890:76cc910c508e

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
document fc-imy2pwt
author Mychaela Falconia <falcon@freecalypso.org>
date Sun, 03 Apr 2022 05:29:17 +0000
parents 702470859ebd
children 8e5f68b6420a
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
216
7e3e3a958e3f doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents: 154
diff changeset
1 FreeCalypso host tools suite includes a large number of different tools, many
7e3e3a958e3f doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents: 154
diff changeset
2 of which are quite specialized and rarely needed. The following tools are the
7e3e3a958e3f doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents: 154
diff changeset
3 most essential ones:
0
e7502631a0f9 initial import from freecalypso-sw rev 1033:5ab737ac3ad7
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
4
e7502631a0f9 initial import from freecalypso-sw rev 1033:5ab737ac3ad7
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
5 fc-loadtool This is the tool used to read and write the non-volatile flash
e7502631a0f9 initial import from freecalypso-sw rev 1033:5ab737ac3ad7
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
6 memory of supported GSM devices. It can be used to reflash
e7502631a0f9 initial import from freecalypso-sw rev 1033:5ab737ac3ad7
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
7 these devices with new firmware (whether pre-existing or new
e7502631a0f9 initial import from freecalypso-sw rev 1033:5ab737ac3ad7
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
8 firmwares developed within our project), and to save and restore
e7502631a0f9 initial import from freecalypso-sw rev 1033:5ab737ac3ad7
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
9 flash backups. This tool operates on the target device (phone
e7502631a0f9 initial import from freecalypso-sw rev 1033:5ab737ac3ad7
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
10 or modem) while its regular firmware is shut down.
e7502631a0f9 initial import from freecalypso-sw rev 1033:5ab737ac3ad7
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
11
216
7e3e3a958e3f doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents: 154
diff changeset
12 fc-iram, Reprogramming the non-volatile flash memory is not the only way
7e3e3a958e3f doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents: 154
diff changeset
13 fc-xram, to run your own code on a Calypso GSM device. If your code is
7e3e3a958e3f doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents: 154
diff changeset
14 fc-compalram small enough to fit entirely into the available RAM on the
7e3e3a958e3f doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents: 154
diff changeset
15 device, and you would like to just run it without flashing it
7e3e3a958e3f doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents: 154
diff changeset
16 permanently, these tools do the job of loading code images into
7e3e3a958e3f doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents: 154
diff changeset
17 different kinds of RAM through different download protocols.
7e3e3a958e3f doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents: 154
diff changeset
18 Some phones have large enough RAM to allow a complete functional
7e3e3a958e3f doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents: 154
diff changeset
19 firmware image to be run via fc-xram without flashing.
7e3e3a958e3f doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents: 154
diff changeset
20
7e3e3a958e3f doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents: 154
diff changeset
21 rvinterf This program is our engine for communicating with up & running
7e3e3a958e3f doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents: 154
diff changeset
22 TI-based firmwares through the RVTMUX binary packet interface.
7e3e3a958e3f doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents: 154
diff changeset
23 It receives and decodes all debug trace and other packets
7e3e3a958e3f doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents: 154
diff changeset
24 emitted by the target fw, and allows the options of printing
7e3e3a958e3f doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents: 154
diff changeset
25 them on the terminal, saving them to a log file, and/or passing
7e3e3a958e3f doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents: 154
diff changeset
26 them to other programs that connect to rvinterf as local socket
7e3e3a958e3f doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents: 154
diff changeset
27 clients. In the other direction those latter client programs
7e3e3a958e3f doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents: 154
diff changeset
28 can send arbitrary command packets to the target fw.
7e3e3a958e3f doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents: 154
diff changeset
29
7e3e3a958e3f doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents: 154
diff changeset
30 fc-fsio Going through rvinterf, this tool connects to GSM devices
7e3e3a958e3f doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents: 154
diff changeset
31 running one of the supported firmware versions while the fw is
7e3e3a958e3f doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents: 154
diff changeset
32 running (unlike fc-loadtool which operates on a device while
7e3e3a958e3f doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents: 154
diff changeset
33 its regular fw is shut down) and allows you to manipulate
7e3e3a958e3f doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents: 154
diff changeset
34 (read and write) the device's flash file system. It is thus a
7e3e3a958e3f doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents: 154
diff changeset
35 higher-level tool than fc-loadtool. It is intended primarily
7e3e3a958e3f doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents: 154
diff changeset
36 for working with our own firmwares, but it also works with
7e3e3a958e3f doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents: 154
diff changeset
37 Pirelli's original fw.
0
e7502631a0f9 initial import from freecalypso-sw rev 1033:5ab737ac3ad7
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
38
e7502631a0f9 initial import from freecalypso-sw rev 1033:5ab737ac3ad7
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
39 fc-shell FreeCalypso firmwares have a feature of our own invention (not
e7502631a0f9 initial import from freecalypso-sw rev 1033:5ab737ac3ad7
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
40 present in any pre-existing ones) to accept AT commands over
e7502631a0f9 initial import from freecalypso-sw rev 1033:5ab737ac3ad7
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
41 the RVTMUX interface. It is useful when no second UART is
e7502631a0f9 initial import from freecalypso-sw rev 1033:5ab737ac3ad7
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
42 available for a dedicated standard AT command interface.
e7502631a0f9 initial import from freecalypso-sw rev 1033:5ab737ac3ad7
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
43 fc-shell is the tool that allows you to send AT commands to the
e7502631a0f9 initial import from freecalypso-sw rev 1033:5ab737ac3ad7
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
44 firmware in this manner; it also allows a few other kinds of
216
7e3e3a958e3f doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents: 154
diff changeset
45 asynchronous commands to be sent. It works through rvinterf.
0
e7502631a0f9 initial import from freecalypso-sw rev 1033:5ab737ac3ad7
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
46
216
7e3e3a958e3f doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents: 154
diff changeset
47 And here is a listing of all other tools in mostly-alphabetical order:
0
e7502631a0f9 initial import from freecalypso-sw rev 1033:5ab737ac3ad7
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
48
760
e1c8c5bcb233 ARFCN conversion tools documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 756
diff changeset
49 arfcn2ti These two utilities convert back and forth between standard
e1c8c5bcb233 ARFCN conversion tools documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 756
diff changeset
50 ti2arfcn ARFCNs and TCS211 L1 radio_freq numbers - see ARFCN-mapping
e1c8c5bcb233 ARFCN conversion tools documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 756
diff changeset
51 article for the explanation.
e1c8c5bcb233 ARFCN conversion tools documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 756
diff changeset
52
216
7e3e3a958e3f doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents: 154
diff changeset
53 c139explore This is a run-from-RAM (no flashing) program for Mot C139/140
7e3e3a958e3f doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents: 154
diff changeset
54 phones that exercises their peripheral hardware: LCD, keypad
7e3e3a958e3f doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents: 154
diff changeset
55 backlight, buzzer and vibrator.
0
e7502631a0f9 initial import from freecalypso-sw rev 1033:5ab737ac3ad7
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
56
300
0cfb2e3aeda4 started documenting c1xx-calextr
Mychaela Falconia <falcon@freecalypso.org>
parents: 244
diff changeset
57 c1xx-calextr This utility extracts the factory RF calibration values for
0cfb2e3aeda4 started documenting c1xx-calextr
Mychaela Falconia <falcon@freecalypso.org>
parents: 244
diff changeset
58 Mot C1xx phones from the records contained in a special sector
0cfb2e3aeda4 started documenting c1xx-calextr
Mychaela Falconia <falcon@freecalypso.org>
parents: 244
diff changeset
59 of their flash and converts them to FreeCalypso format, to be
0cfb2e3aeda4 started documenting c1xx-calextr
Mychaela Falconia <falcon@freecalypso.org>
parents: 244
diff changeset
60 used when running our own firmware on these phones. See the
0cfb2e3aeda4 started documenting c1xx-calextr
Mychaela Falconia <falcon@freecalypso.org>
parents: 244
diff changeset
61 Compal-calibration article for more details.
0cfb2e3aeda4 started documenting c1xx-calextr
Mychaela Falconia <falcon@freecalypso.org>
parents: 244
diff changeset
62
756
b0e749c88f53 doc/Host-tools-overview: compile-fc-batt[2] new description
Mychaela Falconia <falcon@freecalypso.org>
parents: 747
diff changeset
63 compile-fc-batt This utility compiles a table of battery thresholds for our
b0e749c88f53 doc/Host-tools-overview: compile-fc-batt[2] new description
Mychaela Falconia <falcon@freecalypso.org>
parents: 747
diff changeset
64 FreeCalypso battery management code (FCHG) from ASCII source
b0e749c88f53 doc/Host-tools-overview: compile-fc-batt[2] new description
Mychaela Falconia <falcon@freecalypso.org>
parents: 747
diff changeset
65 into the binary form suitable for uploading into /etc/batterytab
b0e749c88f53 doc/Host-tools-overview: compile-fc-batt[2] new description
Mychaela Falconia <falcon@freecalypso.org>
parents: 747
diff changeset
66 (v1 binary format) on a FreeCalypso device. It is rarely used
b0e749c88f53 doc/Host-tools-overview: compile-fc-batt[2] new description
Mychaela Falconia <falcon@freecalypso.org>
parents: 747
diff changeset
67 directly, instead fc-fsio write-battery-table-v1 command invokes
b0e749c88f53 doc/Host-tools-overview: compile-fc-batt[2] new description
Mychaela Falconia <falcon@freecalypso.org>
parents: 747
diff changeset
68 compile-fc-batt behind the scenes.
b0e749c88f53 doc/Host-tools-overview: compile-fc-batt[2] new description
Mychaela Falconia <falcon@freecalypso.org>
parents: 747
diff changeset
69
b0e749c88f53 doc/Host-tools-overview: compile-fc-batt[2] new description
Mychaela Falconia <falcon@freecalypso.org>
parents: 747
diff changeset
70 compile-fc-batt2
b0e749c88f53 doc/Host-tools-overview: compile-fc-batt[2] new description
Mychaela Falconia <falcon@freecalypso.org>
parents: 747
diff changeset
71 This utility is like the original compile-fc-batt, but generates
b0e749c88f53 doc/Host-tools-overview: compile-fc-batt[2] new description
Mychaela Falconia <falcon@freecalypso.org>
parents: 747
diff changeset
72 v2 binary format for uploading into /etc/batterytab2. This new
b0e749c88f53 doc/Host-tools-overview: compile-fc-batt[2] new description
Mychaela Falconia <falcon@freecalypso.org>
parents: 747
diff changeset
73 binary format is needed for the new FC Tourmaline version of
b0e749c88f53 doc/Host-tools-overview: compile-fc-batt[2] new description
Mychaela Falconia <falcon@freecalypso.org>
parents: 747
diff changeset
74 FCHG. It is rarely used directly, instead fc-fsio
b0e749c88f53 doc/Host-tools-overview: compile-fc-batt[2] new description
Mychaela Falconia <falcon@freecalypso.org>
parents: 747
diff changeset
75 write-battery-table-v2 command invokes compile-fc-batt2 behind
b0e749c88f53 doc/Host-tools-overview: compile-fc-batt[2] new description
Mychaela Falconia <falcon@freecalypso.org>
parents: 747
diff changeset
76 the scenes.
391
53b474e7e590 doc/Host-tools-overview: documented new additions
Mychaela Falconia <falcon@freecalypso.org>
parents: 311
diff changeset
77
53b474e7e590 doc/Host-tools-overview: documented new additions
Mychaela Falconia <falcon@freecalypso.org>
parents: 311
diff changeset
78 compile-fc-chg This utility compiles a FreeCalypso battery charging
53b474e7e590 doc/Host-tools-overview: documented new additions
Mychaela Falconia <falcon@freecalypso.org>
parents: 311
diff changeset
79 configuration file from ASCII source into the binary form
53b474e7e590 doc/Host-tools-overview: documented new additions
Mychaela Falconia <falcon@freecalypso.org>
parents: 311
diff changeset
80 suitable for uploading into /etc/charging on a FreeCalypso
53b474e7e590 doc/Host-tools-overview: documented new additions
Mychaela Falconia <falcon@freecalypso.org>
parents: 311
diff changeset
81 device. It is rarely used directly, instead fc-fsio
53b474e7e590 doc/Host-tools-overview: documented new additions
Mychaela Falconia <falcon@freecalypso.org>
parents: 311
diff changeset
82 write-charging-config command invokes compile-fc-chg behind the
53b474e7e590 doc/Host-tools-overview: documented new additions
Mychaela Falconia <falcon@freecalypso.org>
parents: 311
diff changeset
83 scenes.
53b474e7e590 doc/Host-tools-overview: documented new additions
Mychaela Falconia <falcon@freecalypso.org>
parents: 311
diff changeset
84
0
e7502631a0f9 initial import from freecalypso-sw rev 1033:5ab737ac3ad7
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
85 ctracedec GSM firmwares built in TI's Windows environment (official ones
e7502631a0f9 initial import from freecalypso-sw rev 1033:5ab737ac3ad7
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
86 as well as our own hacks based on the TCS211 semi-src) have a
e7502631a0f9 initial import from freecalypso-sw rev 1033:5ab737ac3ad7
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
87 "compressed trace" misfeature whereby many of the ASCII strings
e7502631a0f9 initial import from freecalypso-sw rev 1033:5ab737ac3ad7
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
88 in debug trace messages get replaced with numeric indices at
e7502631a0f9 initial import from freecalypso-sw rev 1033:5ab737ac3ad7
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
89 build time, and these numeric indices are all that gets emitted
e7502631a0f9 initial import from freecalypso-sw rev 1033:5ab737ac3ad7
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
90 on the RVTMUX serial channel. This numeric trace output can be
e7502631a0f9 initial import from freecalypso-sw rev 1033:5ab737ac3ad7
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
91 turned back into ASCII strings if you have the str2ind.tab file
e7502631a0f9 initial import from freecalypso-sw rev 1033:5ab737ac3ad7
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
92 corresponding to the fw version that emitted the output in
e7502631a0f9 initial import from freecalypso-sw rev 1033:5ab737ac3ad7
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
93 question; this ctracedec utility performs that decoding.
e7502631a0f9 initial import from freecalypso-sw rev 1033:5ab737ac3ad7
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
94
863
694a94d15eb1 doc/Host-tools-overview: document fc-add-ramps
Mychaela Falconia <falcon@freecalypso.org>
parents: 831
diff changeset
95 fc-add-ramps This program is a developer tool, specifically for engineers
694a94d15eb1 doc/Host-tools-overview: document fc-add-ramps
Mychaela Falconia <falcon@freecalypso.org>
parents: 831
diff changeset
96 working on RF Tx tract tuning. It reads a table of Tx ramp
694a94d15eb1 doc/Host-tools-overview: document fc-add-ramps
Mychaela Falconia <falcon@freecalypso.org>
parents: 831
diff changeset
97 templates in FreeCalypso RF table ASCII format, adds up each
694a94d15eb1 doc/Host-tools-overview: document fc-add-ramps
Mychaela Falconia <falcon@freecalypso.org>
parents: 831
diff changeset
98 ramp and reports the resulting sums.
694a94d15eb1 doc/Host-tools-overview: document fc-add-ramps
Mychaela Falconia <falcon@freecalypso.org>
parents: 831
diff changeset
99
485
944e26b2f314 doc/Host-tools-overview: fc-bin2rftab addition documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 440
diff changeset
100 fc-bin2rftab This program is a developer tool: it reads a binary RF table of
944e26b2f314 doc/Host-tools-overview: fc-bin2rftab addition documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 440
diff changeset
101 the user-specified type from a binary file (at a user-specified
944e26b2f314 doc/Host-tools-overview: fc-bin2rftab addition documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 440
diff changeset
102 offset, allowing extraction of tables from alien firmwares and
944e26b2f314 doc/Host-tools-overview: fc-bin2rftab addition documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 440
diff changeset
103 whatnot) and emits it in FreeCalypso ASCII format.
944e26b2f314 doc/Host-tools-overview: fc-bin2rftab addition documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 440
diff changeset
104
831
2f401860e9ad documentation update for buzzer melodies
Mychaela Falconia <falcon@freecalypso.org>
parents: 796
diff changeset
105 fc-buzplay This program plays Calypso buzzer melodies (BU or PWT) on an
2f401860e9ad documentation update for buzzer melodies
Mychaela Falconia <falcon@freecalypso.org>
parents: 796
diff changeset
106 actual Calypso device equipped with such a buzzer (Mot C1xx,
2f401860e9ad documentation update for buzzer melodies
Mychaela Falconia <falcon@freecalypso.org>
parents: 796
diff changeset
107 TI's D-Sample board, our next planned development board) by
2f401860e9ad documentation update for buzzer melodies
Mychaela Falconia <falcon@freecalypso.org>
parents: 796
diff changeset
108 loading a buzplayer agent onto the target and feeding melodies
2f401860e9ad documentation update for buzzer melodies
Mychaela Falconia <falcon@freecalypso.org>
parents: 796
diff changeset
109 to be played to it. See the Buzzer-melodies article for more
2f401860e9ad documentation update for buzzer melodies
Mychaela Falconia <falcon@freecalypso.org>
parents: 796
diff changeset
110 details.
216
7e3e3a958e3f doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents: 154
diff changeset
111
308
6a254cc6a7f3 doc/Host-tools-overview: fc-cal2bin documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 300
diff changeset
112 fc-cal2bin This utility takes an RF table in FreeCalypso ASCII format and
6a254cc6a7f3 doc/Host-tools-overview: fc-cal2bin documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 300
diff changeset
113 converts it to the firmware's native binary format. See the
6a254cc6a7f3 doc/Host-tools-overview: fc-cal2bin documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 300
diff changeset
114 RF_tables article for more details.
6a254cc6a7f3 doc/Host-tools-overview: fc-cal2bin documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 300
diff changeset
115
216
7e3e3a958e3f doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents: 154
diff changeset
116 fc-cal2text This utility takes a dump of TI's /gsm/rf flash file system
7e3e3a958e3f doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents: 154
diff changeset
117 directory subtree as input (either extracted in vitro with tiffs
7e3e3a958e3f doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents: 154
diff changeset
118 or read out in vivo with fc-fsio) and converts all RF tables
7e3e3a958e3f doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents: 154
diff changeset
119 found therein into a readable ASCII format. See the RF_tables
7e3e3a958e3f doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents: 154
diff changeset
120 article for more details.
7e3e3a958e3f doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents: 154
diff changeset
121
7e3e3a958e3f doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents: 154
diff changeset
122 fc-dspapidump This utility uses ETM in synchronous mode (going through
7e3e3a958e3f doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents: 154
diff changeset
123 rvinterf) to read and dump the contents of the DSP API RAM in a
7e3e3a958e3f doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents: 154
diff changeset
124 target Calypso GSM device while the firmware is running.
0
e7502631a0f9 initial import from freecalypso-sw rev 1033:5ab737ac3ad7
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
125
551
245ffa153cea doc/Host-tools-overview: fc-dspromdump documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 485
diff changeset
126 fc-dspromdump This utility feeds a dump agent program (dspdump) to the target
245ffa153cea doc/Host-tools-overview: fc-dspromdump documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 485
diff changeset
127 Calypso device's ARM boot ROM and then commands this dump agent
245ffa153cea doc/Host-tools-overview: fc-dspromdump documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 485
diff changeset
128 program to perform a complete dump of the chip's DSP ROM. See
245ffa153cea doc/Host-tools-overview: fc-dspromdump documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 485
diff changeset
129 the DSP-ROM-dump article for more details.
245ffa153cea doc/Host-tools-overview: fc-dspromdump documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 485
diff changeset
130
216
7e3e3a958e3f doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents: 154
diff changeset
131 fc-e1decode This utility decodes a melody in TI's Melody E1 format from the
7e3e3a958e3f doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents: 154
diff changeset
132 the native binary format to our own ASCII-based representation;
7e3e3a958e3f doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents: 154
diff changeset
133 see the Melody_E1 article for more information.
7e3e3a958e3f doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents: 154
diff changeset
134
7e3e3a958e3f doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents: 154
diff changeset
135 fc-e1gen This utility compiles an E1 melody from our own ASCII source
7e3e3a958e3f doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents: 154
diff changeset
136 format into binary bits to be loaded into a FreeCalypso phone;
7e3e3a958e3f doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents: 154
diff changeset
137 see the Melody_E1 article for more information.
0
e7502631a0f9 initial import from freecalypso-sw rev 1033:5ab737ac3ad7
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
138
216
7e3e3a958e3f doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents: 154
diff changeset
139 fc-fr2tch This hack-utility converts a GSM 06.10 speech sample from the
7e3e3a958e3f doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents: 154
diff changeset
140 de facto standard libgsm format (which can be recorded with
7e3e3a958e3f doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents: 154
diff changeset
141 standard tools like SoX) into an uplink play file that can be
7e3e3a958e3f doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents: 154
diff changeset
142 played with the tch play command in fc-shell; see the
7e3e3a958e3f doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents: 154
diff changeset
143 TCH-bit-access article for more information.
0
e7502631a0f9 initial import from freecalypso-sw rev 1033:5ab737ac3ad7
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
144
216
7e3e3a958e3f doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents: 154
diff changeset
145 fc-gsm2vm This utility converts a GSM 06.10 speech sample from the same
7e3e3a958e3f doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents: 154
diff changeset
146 libgsm source format into a voice memo file that can be
7e3e3a958e3f doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents: 154
diff changeset
147 uploaded into the FFS of a FreeCalypso device and played with
7e3e3a958e3f doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents: 154
diff changeset
148 the audio_vm_play_start() API or the AT@VMP command that
7e3e3a958e3f doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents: 154
diff changeset
149 invokes the latter.
0
e7502631a0f9 initial import from freecalypso-sw rev 1033:5ab737ac3ad7
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
150
890
76cc910c508e document fc-imy2pwt
Mychaela Falconia <falcon@freecalypso.org>
parents: 879
diff changeset
151 fc-imy2pwt This program converts monophonic ringtone melodies from iMelody
76cc910c508e document fc-imy2pwt
Mychaela Falconia <falcon@freecalypso.org>
parents: 879
diff changeset
152 interchange format into our own native PWT format. See the
76cc910c508e document fc-imy2pwt
Mychaela Falconia <falcon@freecalypso.org>
parents: 879
diff changeset
153 Buzzer-melodies article for more details.
76cc910c508e document fc-imy2pwt
Mychaela Falconia <falcon@freecalypso.org>
parents: 879
diff changeset
154
395
8027cc12f96a doc/Host-tools-overview: update for the move-out of fc-lcdemu
Mychaela Falconia <falcon@freecalypso.org>
parents: 391
diff changeset
155 fc-lcdemu Moved to freecalypso-ui-dev repository; look there for more
8027cc12f96a doc/Host-tools-overview: update for the move-out of fc-lcdemu
Mychaela Falconia <falcon@freecalypso.org>
parents: 391
diff changeset
156 info.
8027cc12f96a doc/Host-tools-overview: update for the move-out of fc-lcdemu
Mychaela Falconia <falcon@freecalypso.org>
parents: 391
diff changeset
157
8027cc12f96a doc/Host-tools-overview: update for the move-out of fc-lcdemu
Mychaela Falconia <falcon@freecalypso.org>
parents: 391
diff changeset
158 fc-lcdpoll New companion utility to fc-lcdemu; look in freecalypso-ui-dev
8027cc12f96a doc/Host-tools-overview: update for the move-out of fc-lcdemu
Mychaela Falconia <falcon@freecalypso.org>
parents: 391
diff changeset
159 for more info.
0
e7502631a0f9 initial import from freecalypso-sw rev 1033:5ab737ac3ad7
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
160
879
702470859ebd document fc-meltest-{e1,pwt}
Mychaela Falconia <falcon@freecalypso.org>
parents: 875
diff changeset
161 fc-meltest-e1 Shell script for quickly playing E1 melodies: the script runs
702470859ebd document fc-meltest-{e1,pwt}
Mychaela Falconia <falcon@freecalypso.org>
parents: 875
diff changeset
162 fc-e1gen, compiling the melody from ASCII source into binary
702470859ebd document fc-meltest-{e1,pwt}
Mychaela Falconia <falcon@freecalypso.org>
parents: 875
diff changeset
163 format (under /tmp), then uploads the binary melody (via
702470859ebd document fc-meltest-{e1,pwt}
Mychaela Falconia <falcon@freecalypso.org>
parents: 875
diff changeset
164 fc-fsio) to /mel/test.e1 on the running FC phone or devboard,
702470859ebd document fc-meltest-{e1,pwt}
Mychaela Falconia <falcon@freecalypso.org>
parents: 875
diff changeset
165 and then plays it via AT@E1 command via fc-shell.
702470859ebd document fc-meltest-{e1,pwt}
Mychaela Falconia <falcon@freecalypso.org>
parents: 875
diff changeset
166
702470859ebd document fc-meltest-{e1,pwt}
Mychaela Falconia <falcon@freecalypso.org>
parents: 875
diff changeset
167 fc-meltest-pwt Shell script for quickly playing PWT melodies: the script runs
702470859ebd document fc-meltest-{e1,pwt}
Mychaela Falconia <falcon@freecalypso.org>
parents: 875
diff changeset
168 fc-pwt-comp, compiling the melody from ASCII source into binary
702470859ebd document fc-meltest-{e1,pwt}
Mychaela Falconia <falcon@freecalypso.org>
parents: 875
diff changeset
169 format (under /tmp), then uploads the binary melody (via
702470859ebd document fc-meltest-{e1,pwt}
Mychaela Falconia <falcon@freecalypso.org>
parents: 875
diff changeset
170 fc-fsio) to /buz/test.bz on the running FC phone or devboard,
702470859ebd document fc-meltest-{e1,pwt}
Mychaela Falconia <falcon@freecalypso.org>
parents: 875
diff changeset
171 and then plays it via AT@BUZ command via fc-shell.
702470859ebd document fc-meltest-{e1,pwt}
Mychaela Falconia <falcon@freecalypso.org>
parents: 875
diff changeset
172
216
7e3e3a958e3f doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents: 154
diff changeset
173 fc-memdump This tool captures a memory dump from a GSM device whose
7e3e3a958e3f doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents: 154
diff changeset
174 firmware implements one of TI's Test Mode memory read commands,
7e3e3a958e3f doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents: 154
diff changeset
175 either the old TM3 version or the new ETM one. It works with
7e3e3a958e3f doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents: 154
diff changeset
176 FreeCalypso Citrine, with TCS211-based firmwares including
7e3e3a958e3f doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents: 154
diff changeset
177 FreeCalypso Magnetite, with really old TI firmwares which
7e3e3a958e3f doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents: 154
diff changeset
178 predate ETM, and with Mot C1xx original firmwares. It works
7e3e3a958e3f doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents: 154
diff changeset
179 through rvinterf.
7e3e3a958e3f doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents: 154
diff changeset
180
737
6d97866bad79 first round of documentation for DUART28C boot control addition
Mychaela Falconia <falcon@freecalypso.org>
parents: 730
diff changeset
181 fc-pulse-dtr This trivial utility opens a serial port, asserts DTR for 50 ms,
6d97866bad79 first round of documentation for DUART28C boot control addition
Mychaela Falconia <falcon@freecalypso.org>
parents: 730
diff changeset
182 then negates it and exits. See the DUART28-boot-control article
6d97866bad79 first round of documentation for DUART28C boot control addition
Mychaela Falconia <falcon@freecalypso.org>
parents: 730
diff changeset
183 for the explanation.
6d97866bad79 first round of documentation for DUART28C boot control addition
Mychaela Falconia <falcon@freecalypso.org>
parents: 730
diff changeset
184
6d97866bad79 first round of documentation for DUART28C boot control addition
Mychaela Falconia <falcon@freecalypso.org>
parents: 730
diff changeset
185 fc-pulse-rts This trivial utility opens a serial port, asserts RTS for 50 ms,
6d97866bad79 first round of documentation for DUART28C boot control addition
Mychaela Falconia <falcon@freecalypso.org>
parents: 730
diff changeset
186 then negates it and exits. See the DUART28-boot-control article
6d97866bad79 first round of documentation for DUART28C boot control addition
Mychaela Falconia <falcon@freecalypso.org>
parents: 730
diff changeset
187 for the explanation.
6d97866bad79 first round of documentation for DUART28C boot control addition
Mychaela Falconia <falcon@freecalypso.org>
parents: 730
diff changeset
188
871
5a7ab739e4f3 doc/Host-tools-overview: document fc-pwt-comp
Mychaela Falconia <falcon@freecalypso.org>
parents: 864
diff changeset
189 fc-pwt-comp This program compiles a FreeCalypso PWT melody from our ASCII
5a7ab739e4f3 doc/Host-tools-overview: document fc-pwt-comp
Mychaela Falconia <falcon@freecalypso.org>
parents: 864
diff changeset
190 source format into the compact binary format that will be
5a7ab739e4f3 doc/Host-tools-overview: document fc-pwt-comp
Mychaela Falconia <falcon@freecalypso.org>
parents: 864
diff changeset
191 uploaded into FC device FFS for use by our BUZM melody player
5a7ab739e4f3 doc/Host-tools-overview: document fc-pwt-comp
Mychaela Falconia <falcon@freecalypso.org>
parents: 864
diff changeset
192 engine. See the Buzzer-melodies article for more details.
5a7ab739e4f3 doc/Host-tools-overview: document fc-pwt-comp
Mychaela Falconia <falcon@freecalypso.org>
parents: 864
diff changeset
193
310
c31a9cbf6ee2 doc/Host-tools-overview: fc-readcal documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 308
diff changeset
194 fc-readcal This program attempts to read a bunch of RF calibration tables
c31a9cbf6ee2 doc/Host-tools-overview: fc-readcal documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 308
diff changeset
195 out of a running firmware through Test Mode commands: first
c31a9cbf6ee2 doc/Host-tools-overview: fc-readcal documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 308
diff changeset
196 tms 1, then rfpw 7 for each band, then rftr and ttr commands to
c31a9cbf6ee2 doc/Host-tools-overview: fc-readcal documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 308
diff changeset
197 read various tables. The primary intended purpose is extracting
c31a9cbf6ee2 doc/Host-tools-overview: fc-readcal documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 308
diff changeset
198 RF calibration or static configuration data from alien
c31a9cbf6ee2 doc/Host-tools-overview: fc-readcal documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 308
diff changeset
199 firmwares. Please beware that the tms 1 and rfpw 7 commands
c31a9cbf6ee2 doc/Host-tools-overview: fc-readcal documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 308
diff changeset
200 sent by this tool are highly disruptive to normal GSM operation.
c31a9cbf6ee2 doc/Host-tools-overview: fc-readcal documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 308
diff changeset
201
440
44f73d56b6f5 CHANGES and doc/Host-tools-overview: fc-rftab2c addition
Mychaela Falconia <falcon@freecalypso.org>
parents: 413
diff changeset
202 fc-rftab2c This program is a developer tool: it takes an RF parameter
44f73d56b6f5 CHANGES and doc/Host-tools-overview: fc-rftab2c addition
Mychaela Falconia <falcon@freecalypso.org>
parents: 413
diff changeset
203 table of one of the supported types in FreeCalypso ASCII format
44f73d56b6f5 CHANGES and doc/Host-tools-overview: fc-rftab2c addition
Mychaela Falconia <falcon@freecalypso.org>
parents: 413
diff changeset
204 and converts it into a C code snippet suitable for insertion
44f73d56b6f5 CHANGES and doc/Host-tools-overview: fc-rftab2c addition
Mychaela Falconia <falcon@freecalypso.org>
parents: 413
diff changeset
205 into the firmware source in the L1 RF "customization" code
44f73d56b6f5 CHANGES and doc/Host-tools-overview: fc-rftab2c addition
Mychaela Falconia <falcon@freecalypso.org>
parents: 413
diff changeset
206 where compiled-in default RF parameter tables are defined.
44f73d56b6f5 CHANGES and doc/Host-tools-overview: fc-rftab2c addition
Mychaela Falconia <falcon@freecalypso.org>
parents: 413
diff changeset
207
216
7e3e3a958e3f doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents: 154
diff changeset
208 fc-rgbconv A simple aid for phone UI development that converts RGB color
7e3e3a958e3f doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents: 154
diff changeset
209 values between human-intuitive 8:8:8 format and the 5:6:5 format
7e3e3a958e3f doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents: 154
diff changeset
210 used by the color LCDs in the phones targeted by FreeCalypso.
7e3e3a958e3f doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents: 154
diff changeset
211
875
8ff9bce1b56e document fc-ringlist-comp
Mychaela Falconia <falcon@freecalypso.org>
parents: 871
diff changeset
212 fc-ringlist-comp
8ff9bce1b56e document fc-ringlist-comp
Mychaela Falconia <falcon@freecalypso.org>
parents: 871
diff changeset
213 This program compiles a list of ringing tone or message alert
8ff9bce1b56e document fc-ringlist-comp
Mychaela Falconia <falcon@freecalypso.org>
parents: 871
diff changeset
214 tone melodies from ASCII source into the binary format (.mls)
8ff9bce1b56e document fc-ringlist-comp
Mychaela Falconia <falcon@freecalypso.org>
parents: 871
diff changeset
215 that will be uploaded into FreeCalypso device FFS and read by
8ff9bce1b56e document fc-ringlist-comp
Mychaela Falconia <falcon@freecalypso.org>
parents: 871
diff changeset
216 the UI layer of FC phone firmwares. See the Buzzer-melodies
8ff9bce1b56e document fc-ringlist-comp
Mychaela Falconia <falcon@freecalypso.org>
parents: 871
diff changeset
217 article for more details.
8ff9bce1b56e document fc-ringlist-comp
Mychaela Falconia <falcon@freecalypso.org>
parents: 871
diff changeset
218
216
7e3e3a958e3f doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents: 154
diff changeset
219 fc-serterm This tool is a trivial serial terminal program. Its special
7e3e3a958e3f doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents: 154
diff changeset
220 feature is that any output coming from the serial port that
7e3e3a958e3f doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents: 154
diff changeset
221 isn't printable ASCII is displayed as by cat -v. It is useful
7e3e3a958e3f doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents: 154
diff changeset
222 for talking to serially-interfaced devices that mix ASCII with
7e3e3a958e3f doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents: 154
diff changeset
223 binary in their serial talk.
23
10b71f01f4ff doc/Host-tools-overview updated for the current state of the tools
Mychaela Falconia <falcon@freecalypso.org>
parents: 0
diff changeset
224
796
2c0eebf1d00a doc/Host-tools-overview: add fc-simint and fc-simtool
Mychaela Falconia <falcon@freecalypso.org>
parents: 760
diff changeset
225 fc-simint This program is a specialized front end to fc-simtool, allowing
2c0eebf1d00a doc/Host-tools-overview: add fc-simint and fc-simtool
Mychaela Falconia <falcon@freecalypso.org>
parents: 760
diff changeset
226 the latter tool to operate on SIM cards inside Calypso phones
2c0eebf1d00a doc/Host-tools-overview: add fc-simint and fc-simtool
Mychaela Falconia <falcon@freecalypso.org>
parents: 760
diff changeset
227 and development boards. fc-simint loads and runs simagent on
2c0eebf1d00a doc/Host-tools-overview: add fc-simint and fc-simtool
Mychaela Falconia <falcon@freecalypso.org>
parents: 760
diff changeset
228 the Calypso device in the manner of loadtools, then passes the
2c0eebf1d00a doc/Host-tools-overview: add fc-simint and fc-simtool
Mychaela Falconia <falcon@freecalypso.org>
parents: 760
diff changeset
229 open file descriptor to fc-simtool.
2c0eebf1d00a doc/Host-tools-overview: add fc-simint and fc-simtool
Mychaela Falconia <falcon@freecalypso.org>
parents: 760
diff changeset
230
2c0eebf1d00a doc/Host-tools-overview: add fc-simint and fc-simtool
Mychaela Falconia <falcon@freecalypso.org>
parents: 760
diff changeset
231 fc-simtool Maintained in a separate fc-sim-tools repository, fc-simtool is
2c0eebf1d00a doc/Host-tools-overview: add fc-simint and fc-simtool
Mychaela Falconia <falcon@freecalypso.org>
parents: 760
diff changeset
232 our tool for operating on SIM cards. Its primary mode of usage
2c0eebf1d00a doc/Host-tools-overview: add fc-simint and fc-simtool
Mychaela Falconia <falcon@freecalypso.org>
parents: 760
diff changeset
233 is operating on SIM cards inserted into special smart card
2c0eebf1d00a doc/Host-tools-overview: add fc-simint and fc-simtool
Mychaela Falconia <falcon@freecalypso.org>
parents: 760
diff changeset
234 reader/programmer devices, without going through any kind of
2c0eebf1d00a doc/Host-tools-overview: add fc-simint and fc-simtool
Mychaela Falconia <falcon@freecalypso.org>
parents: 760
diff changeset
235 phone or other GSM device, but fc-simtool can also be invoked
2c0eebf1d00a doc/Host-tools-overview: add fc-simint and fc-simtool
Mychaela Falconia <falcon@freecalypso.org>
parents: 760
diff changeset
236 indirectly via fc-simint, in which case it operates on SIM cards
2c0eebf1d00a doc/Host-tools-overview: add fc-simint and fc-simtool
Mychaela Falconia <falcon@freecalypso.org>
parents: 760
diff changeset
237 inside Calypso devices.
2c0eebf1d00a doc/Host-tools-overview: add fc-simint and fc-simtool
Mychaela Falconia <falcon@freecalypso.org>
parents: 760
diff changeset
238
23
10b71f01f4ff doc/Host-tools-overview updated for the current state of the tools
Mychaela Falconia <falcon@freecalypso.org>
parents: 0
diff changeset
239 fc-tch2fr This hack-utility takes a TCH downlink recording produced with
10b71f01f4ff doc/Host-tools-overview updated for the current state of the tools
Mychaela Falconia <falcon@freecalypso.org>
parents: 0
diff changeset
240 the tch record command in fc-shell and converts it to a playable
10b71f01f4ff doc/Host-tools-overview updated for the current state of the tools
Mychaela Falconia <falcon@freecalypso.org>
parents: 0
diff changeset
241 libgsm file which will most likely contain some garbage by
10b71f01f4ff doc/Host-tools-overview updated for the current state of the tools
Mychaela Falconia <falcon@freecalypso.org>
parents: 0
diff changeset
242 disregarding the non-understood DSP status words; see the
10b71f01f4ff doc/Host-tools-overview updated for the current state of the tools
Mychaela Falconia <falcon@freecalypso.org>
parents: 0
diff changeset
243 TCH-bit-access article for more information.
216
7e3e3a958e3f doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents: 154
diff changeset
244
7e3e3a958e3f doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents: 154
diff changeset
245 fc-tmsh TI-based GSM firmwares provide a rich set of Test Mode commands
7e3e3a958e3f doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents: 154
diff changeset
246 that can be issued through the RVTMUX (debug trace) serial
7e3e3a958e3f doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents: 154
diff changeset
247 channel, used for L1/RF test functions, production line RF
7e3e3a958e3f doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents: 154
diff changeset
248 calibration, FFS (flash file system) access, audio configuration
7e3e3a958e3f doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents: 154
diff changeset
249 and other miscellany. fc-tmsh is our test mode shell for
7e3e3a958e3f doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents: 154
diff changeset
250 sending these Test Mode commands to targets and displaying
7e3e3a958e3f doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents: 154
diff changeset
251 decoded target responses; it works through rvinterf. fc-tmsh
7e3e3a958e3f doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents: 154
diff changeset
252 supports all Test Mode commands (both TM3 and ETM) implemented
7e3e3a958e3f doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents: 154
diff changeset
253 in our target firmwares except FFS access; use fc-fsio for the
311
b84bc65e7f86 doc/Host-tools-overview: fc-tmsync documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 310
diff changeset
254 latter. fc-tmsh is fully asynchronous in that the issuance of
b84bc65e7f86 doc/Host-tools-overview: fc-tmsync documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 310
diff changeset
255 commands to the target and the handling of target responses are
b84bc65e7f86 doc/Host-tools-overview: fc-tmsync documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 310
diff changeset
256 fully decoupled.
b84bc65e7f86 doc/Host-tools-overview: fc-tmsync documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 310
diff changeset
257
b84bc65e7f86 doc/Host-tools-overview: fc-tmsync documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 310
diff changeset
258 fc-tmsync This program reimplements a small subset of fc-tmsh commands in
b84bc65e7f86 doc/Host-tools-overview: fc-tmsync documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 310
diff changeset
259 a synchronous manner; it was written together with fc-readcal
b84bc65e7f86 doc/Host-tools-overview: fc-tmsync documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 310
diff changeset
260 for the same purpose of extracting "in vivo" data from alien
b84bc65e7f86 doc/Host-tools-overview: fc-tmsync documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 310
diff changeset
261 firmwares.
216
7e3e3a958e3f doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents: 154
diff changeset
262
7e3e3a958e3f doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents: 154
diff changeset
263 fc-vm2hex This utility converts the old-fashioned (non-AMR) voice memo
7e3e3a958e3f doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents: 154
diff changeset
264 files read out of FFS into hex strings that can be analyzed by
7e3e3a958e3f doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents: 154
diff changeset
265 a human or further fed to fc-tch2fr.
7e3e3a958e3f doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents: 154
diff changeset
266
391
53b474e7e590 doc/Host-tools-overview: documented new additions
Mychaela Falconia <falcon@freecalypso.org>
parents: 311
diff changeset
267 fcup-* FreeCalypso User Phone Tools; see the User-phone-tools article.
53b474e7e590 doc/Host-tools-overview: documented new additions
Mychaela Falconia <falcon@freecalypso.org>
parents: 311
diff changeset
268
216
7e3e3a958e3f doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents: 154
diff changeset
269 imei-luhn A simple utility for computing or verifying the Luhn check
7e3e3a958e3f doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents: 154
diff changeset
270 digit of an IMEI number.
7e3e3a958e3f doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents: 154
diff changeset
271
864
82d4a7438639 doc/Host-tools-overview: document l1trace-filter
Mychaela Falconia <falcon@freecalypso.org>
parents: 863
diff changeset
272 l1trace-filter This program connects to rvinterf as a client and displays only
82d4a7438639 doc/Host-tools-overview: document l1trace-filter
Mychaela Falconia <falcon@freecalypso.org>
parents: 863
diff changeset
273 certain filtered L1 traces; it was written for the purpose of
82d4a7438639 doc/Host-tools-overview: document l1trace-filter
Mychaela Falconia <falcon@freecalypso.org>
parents: 863
diff changeset
274 isolating specific traces of interest out of the noise.
82d4a7438639 doc/Host-tools-overview: document l1trace-filter
Mychaela Falconia <falcon@freecalypso.org>
parents: 863
diff changeset
275
745
9e3b1ef1f440 make-imeisv utility documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 737
diff changeset
276 make-imeisv This utility is intended for use in shell scripts: it constructs
9e3b1ef1f440 make-imeisv utility documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 737
diff changeset
277 a 16-digit IMEISV from a 15-digit IMEI (which must have a valid
9e3b1ef1f440 make-imeisv utility documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 737
diff changeset
278 Luhn check digit) and a 2-digit SV field.
9e3b1ef1f440 make-imeisv utility documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 737
diff changeset
279
413
a28c46e5a6ce doc/Host-tools-overview: mokosrec2bin addition documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 395
diff changeset
280 mokosrec2bin This utility converts "moko-style" S-record files (those
a28c46e5a6ce doc/Host-tools-overview: mokosrec2bin addition documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 395
diff changeset
281 produced by TI's hex470 tool with -memwidth 16 -romwidth 16
a28c46e5a6ce doc/Host-tools-overview: mokosrec2bin addition documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 395
diff changeset
282 options) to straight binary.
a28c46e5a6ce doc/Host-tools-overview: mokosrec2bin addition documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 395
diff changeset
283
601
4c58e09578d0 doc/Host-tools-overview: pcm-sms-decode documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 551
diff changeset
284 pcm-sms-decode Some TI-based vendor firmwares (not TI's original and not
4c58e09578d0 doc/Host-tools-overview: pcm-sms-decode documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 551
diff changeset
285 FreeCalypso) implement SMS storage in their FFS in a file named
4c58e09578d0 doc/Host-tools-overview: pcm-sms-decode documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 551
diff changeset
286 /pcm/SMS in the same format in which SMS records are stored in
4c58e09578d0 doc/Host-tools-overview: pcm-sms-decode documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 551
diff changeset
287 SIM cards (EF_SMS elementary file). Pirelli's firmware is one
4c58e09578d0 doc/Host-tools-overview: pcm-sms-decode documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 551
diff changeset
288 major user of this mechanism. This /pcm/SMS file can be read
4c58e09578d0 doc/Host-tools-overview: pcm-sms-decode documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 551
diff changeset
289 out in vivo via fc-fsio or extracted in vitro via tiffs; the
4c58e09578d0 doc/Host-tools-overview: pcm-sms-decode documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 551
diff changeset
290 new pcm-sms-decode utility decodes the stored SMS content from
4c58e09578d0 doc/Host-tools-overview: pcm-sms-decode documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 551
diff changeset
291 this binary file similarly to sms-pdu-decode.
4c58e09578d0 doc/Host-tools-overview: pcm-sms-decode documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 551
diff changeset
292
216
7e3e3a958e3f doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents: 154
diff changeset
293 pirexplore This is a run-from-RAM (no flashing) program for Pirelli DP-L10
7e3e3a958e3f doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents: 154
diff changeset
294 phones that exercises their peripheral hardware, primarily their
7e3e3a958e3f doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents: 154
diff changeset
295 LCD.
7e3e3a958e3f doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents: 154
diff changeset
296
7e3e3a958e3f doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents: 154
diff changeset
297 rvtdump This tool produces a human-readable dump of all output emitted
7e3e3a958e3f doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents: 154
diff changeset
298 by a TI-based GSM fw on the RVTMUX binary packet interface. It
7e3e3a958e3f doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents: 154
diff changeset
299 can also log this dump to a file.
7e3e3a958e3f doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents: 154
diff changeset
300
391
53b474e7e590 doc/Host-tools-overview: documented new additions
Mychaela Falconia <falcon@freecalypso.org>
parents: 311
diff changeset
301 sms-pdu-decode This utility is part of FC User Phone Tools; see the
53b474e7e590 doc/Host-tools-overview: documented new additions
Mychaela Falconia <falcon@freecalypso.org>
parents: 311
diff changeset
302 User-phone-tools article.
53b474e7e590 doc/Host-tools-overview: documented new additions
Mychaela Falconia <falcon@freecalypso.org>
parents: 311
diff changeset
303
623
46d17c346511 doc/Host-tools-overview: srec-regions added
Mychaela Falconia <falcon@freecalypso.org>
parents: 601
diff changeset
304 srec-regions This utility parses a firmware image file in S-record format,
46d17c346511 doc/Host-tools-overview: srec-regions added
Mychaela Falconia <falcon@freecalypso.org>
parents: 601
diff changeset
305 identifies the set of discontiguous regions into which this
46d17c346511 doc/Host-tools-overview: srec-regions added
Mychaela Falconia <falcon@freecalypso.org>
parents: 601
diff changeset
306 SREC image deposits bits, and lists these identified regions.
46d17c346511 doc/Host-tools-overview: srec-regions added
Mychaela Falconia <falcon@freecalypso.org>
parents: 601
diff changeset
307
216
7e3e3a958e3f doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents: 154
diff changeset
308 tfc139 This tool breaks into Mot C1xx phones via shellcode injection,
7e3e3a958e3f doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents: 154
diff changeset
309 a method that works despite any bootloader locks, allowing you
7e3e3a958e3f doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents: 154
diff changeset
310 to reflash locked phones with new firmware with fc-loadtool.
7e3e3a958e3f doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents: 154
diff changeset
311 The name of the utility is historical: previously it was
7e3e3a958e3f doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents: 154
diff changeset
312 specific to TFC139 phones (C139s sold with TracFone branding),
7e3e3a958e3f doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents: 154
diff changeset
313 but the current version is expected to work with all Mot C1xx
7e3e3a958e3f doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents: 154
diff changeset
314 firmware versions.
7e3e3a958e3f doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents: 154
diff changeset
315
244
97d6d593ffc6 doc/Host-tools-overview: tiaud-compile and tiaud-mkvol documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 216
diff changeset
316 tiaud-compile This utility compiles an audio mode configuration table for TI's
97d6d593ffc6 doc/Host-tools-overview: tiaud-compile and tiaud-mkvol documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 216
diff changeset
317 Audio Service from our own ASCII source format into the binary
97d6d593ffc6 doc/Host-tools-overview: tiaud-compile and tiaud-mkvol documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 216
diff changeset
318 format for uploading into FreeCalypso GSM device FFS with
97d6d593ffc6 doc/Host-tools-overview: tiaud-compile and tiaud-mkvol documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 216
diff changeset
319 fc-fsio.
97d6d593ffc6 doc/Host-tools-overview: tiaud-compile and tiaud-mkvol documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 216
diff changeset
320
216
7e3e3a958e3f doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents: 154
diff changeset
321 tiaud-decomp This utility decodes TI's audio mode configuration files read
244
97d6d593ffc6 doc/Host-tools-overview: tiaud-compile and tiaud-mkvol documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 216
diff changeset
322 out of FFS into our own ASCII format. It is the reverse of the
97d6d593ffc6 doc/Host-tools-overview: tiaud-compile and tiaud-mkvol documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 216
diff changeset
323 operation performed by tiaud-compile.
97d6d593ffc6 doc/Host-tools-overview: tiaud-compile and tiaud-mkvol documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 216
diff changeset
324
97d6d593ffc6 doc/Host-tools-overview: tiaud-compile and tiaud-mkvol documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 216
diff changeset
325 tiaud-mkvol This utility is a companion to tiaud-compile that generates the
97d6d593ffc6 doc/Host-tools-overview: tiaud-compile and tiaud-mkvol documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 216
diff changeset
326 *.vol binary files which need to accompany the main *.cfg ones.
216
7e3e3a958e3f doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents: 154
diff changeset
327
7e3e3a958e3f doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents: 154
diff changeset
328 tiffs, These tools perform "in vitro" analysis of flash file system
7e3e3a958e3f doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents: 154
diff changeset
329 mokoffs, (FFS) images read out of GSM devices with TI-based firmwares.
730
6ae3ad8865f4 doc/Host-tools-overview: update for tiffs-8m
Mychaela Falconia <falcon@freecalypso.org>
parents: 718
diff changeset
330 pirffs, You can list and extract the FFS content captured as a raw
6ae3ad8865f4 doc/Host-tools-overview: update for tiffs-8m
Mychaela Falconia <falcon@freecalypso.org>
parents: 718
diff changeset
331 tiffs-8m flash image, and even perform a few "forensic" operations along
216
7e3e3a958e3f doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents: 154
diff changeset
332 the lines of reading deleted files and seeing the history of
730
6ae3ad8865f4 doc/Host-tools-overview: update for tiffs-8m
Mychaela Falconia <falcon@freecalypso.org>
parents: 718
diff changeset
333 FFS modifications. tiffs is the main program, whereas mokoffs,
6ae3ad8865f4 doc/Host-tools-overview: update for tiffs-8m
Mychaela Falconia <falcon@freecalypso.org>
parents: 718
diff changeset
334 pirffs and tiffs-8m are convenience wrappers for the common FFS
6ae3ad8865f4 doc/Host-tools-overview: update for tiffs-8m
Mychaela Falconia <falcon@freecalypso.org>
parents: 718
diff changeset
335 configurations from Openmoko, Pirelli and Tango.
709
9b0ad72184e3 doc/Host-tools-overview: tiffs-mkfs documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 623
diff changeset
336
9b0ad72184e3 doc/Host-tools-overview: tiffs-mkfs documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 623
diff changeset
337 tiffs-mkfs This utility constructs a TI flash file system (TIFFS) image
9b0ad72184e3 doc/Host-tools-overview: tiffs-mkfs documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 623
diff changeset
338 completely from scratch "in vitro", containing initial directory
9b0ad72184e3 doc/Host-tools-overview: tiffs-mkfs documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 623
diff changeset
339 and file content given by a Unix directory and file tree on the
9b0ad72184e3 doc/Host-tools-overview: tiffs-mkfs documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 623
diff changeset
340 host system. The resulting image can then be flashed into a
718
098fea21ba13 doc/Host-tools-overview: tiffs-mkfs description updated
Mychaela Falconia <falcon@freecalypso.org>
parents: 709
diff changeset
341 Calypso GSM device running FreeCalypso firmware.
747
efd85963ec85 tiffs-mkfile documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 745
diff changeset
342
efd85963ec85 tiffs-mkfile documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 745
diff changeset
343 tiffs-mkfile This utility is intended for use in shell scripts: it generates
efd85963ec85 tiffs-mkfile documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 745
diff changeset
344 certain types of binary files that go into TIFFS, for subsequent
efd85963ec85 tiffs-mkfile documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 745
diff changeset
345 feeding to tiffs-mkfs.