annotate doc/Host-tools-overview @ 964:a96cb97b66a2

ringtools/imy: fix duplicate definition of tdma_durations[] The bug was reported by Vadim Yanitskiy <fixeria@osmocom.org>, although the present fix is slightly different from the contributed patch: because main.c doesn't need this tdma_durations[] array at all, let's simply remove the reference to this array from main.c rather than turn it into an extern. I no longer remember my original thought flow that resulted (by mistake) in tdma_durations[] being multiply defined in main.c and durations.c. My intent might have been to define all globals in main.c and have the reference in durations.c be an extern - and I missed that extern - but without clear memory, I have no certainty. In any case, having this data array defined in the same module that fills it (durations.c) is sensible, so let's make it the new way.
author Mychaela Falconia <falcon@freecalypso.org>
date Thu, 31 Aug 2023 19:38:18 +0000
parents 1b8929cb7371
children
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
911
7077d02ed3b1 doc/Host-tools-overview: document fc-efr2tch
Mychaela Falconia <falcon@freecalypso.org>
parents: 891
diff changeset
139 fc-efr2tch This utility converts a GSM EFR speech sample from Themyscira
7077d02ed3b1 doc/Host-tools-overview: document fc-efr2tch
Mychaela Falconia <falcon@freecalypso.org>
parents: 891
diff changeset
140 gsmx format (defined in the GSM codec libraries & utilities
7077d02ed3b1 doc/Host-tools-overview: document fc-efr2tch
Mychaela Falconia <falcon@freecalypso.org>
parents: 891
diff changeset
141 package) into an uplink play file that can be played with the
7077d02ed3b1 doc/Host-tools-overview: document fc-efr2tch
Mychaela Falconia <falcon@freecalypso.org>
parents: 891
diff changeset
142 tch play command in fc-shell; see our TCH-bit-access article
7077d02ed3b1 doc/Host-tools-overview: document fc-efr2tch
Mychaela Falconia <falcon@freecalypso.org>
parents: 891
diff changeset
143 for more information.
7077d02ed3b1 doc/Host-tools-overview: document fc-efr2tch
Mychaela Falconia <falcon@freecalypso.org>
parents: 891
diff changeset
144
7077d02ed3b1 doc/Host-tools-overview: document fc-efr2tch
Mychaela Falconia <falcon@freecalypso.org>
parents: 891
diff changeset
145 fc-fr2tch This utility converts a GSM 06.10 speech sample from the
216
7e3e3a958e3f doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents: 154
diff changeset
146 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
147 standard tools like SoX) into an uplink play file that can be
911
7077d02ed3b1 doc/Host-tools-overview: document fc-efr2tch
Mychaela Falconia <falcon@freecalypso.org>
parents: 891
diff changeset
148 played with the tch play command in fc-shell; see our
216
7e3e3a958e3f doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents: 154
diff changeset
149 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
150
216
7e3e3a958e3f doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents: 154
diff changeset
151 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
152 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
153 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
154 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
155 invokes the latter.
0
e7502631a0f9 initial import from freecalypso-sw rev 1033:5ab737ac3ad7
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
156
890
76cc910c508e document fc-imy2pwt
Mychaela Falconia <falcon@freecalypso.org>
parents: 879
diff changeset
157 fc-imy2pwt This program converts monophonic ringtone melodies from iMelody
76cc910c508e document fc-imy2pwt
Mychaela Falconia <falcon@freecalypso.org>
parents: 879
diff changeset
158 interchange format into our own native PWT format. See the
76cc910c508e document fc-imy2pwt
Mychaela Falconia <falcon@freecalypso.org>
parents: 879
diff changeset
159 Buzzer-melodies article for more details.
76cc910c508e document fc-imy2pwt
Mychaela Falconia <falcon@freecalypso.org>
parents: 879
diff changeset
160
891
8e5f68b6420a doc/Host-tools-overview: document fc-imyplay
Mychaela Falconia <falcon@freecalypso.org>
parents: 890
diff changeset
161 fc-imyplay Shell script for quickly playing IMY melodies: the script runs
8e5f68b6420a doc/Host-tools-overview: document fc-imyplay
Mychaela Falconia <falcon@freecalypso.org>
parents: 890
diff changeset
162 fc-imy2pwt | fc-pwt-comp pipeline, compiling the melody into
8e5f68b6420a doc/Host-tools-overview: document fc-imyplay
Mychaela Falconia <falcon@freecalypso.org>
parents: 890
diff changeset
163 PWT binary format (under /tmp), then uploads the binary melody
8e5f68b6420a doc/Host-tools-overview: document fc-imyplay
Mychaela Falconia <falcon@freecalypso.org>
parents: 890
diff changeset
164 (via fc-fsio) to /buz/test.bz on the running FC phone or
8e5f68b6420a doc/Host-tools-overview: document fc-imyplay
Mychaela Falconia <falcon@freecalypso.org>
parents: 890
diff changeset
165 devboard, and then plays it via AT@BUZ command via fc-shell.
8e5f68b6420a doc/Host-tools-overview: document fc-imyplay
Mychaela Falconia <falcon@freecalypso.org>
parents: 890
diff changeset
166
395
8027cc12f96a doc/Host-tools-overview: update for the move-out of fc-lcdemu
Mychaela Falconia <falcon@freecalypso.org>
parents: 391
diff changeset
167 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
168 info.
8027cc12f96a doc/Host-tools-overview: update for the move-out of fc-lcdemu
Mychaela Falconia <falcon@freecalypso.org>
parents: 391
diff changeset
169
8027cc12f96a doc/Host-tools-overview: update for the move-out of fc-lcdemu
Mychaela Falconia <falcon@freecalypso.org>
parents: 391
diff changeset
170 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
171 for more info.
0
e7502631a0f9 initial import from freecalypso-sw rev 1033:5ab737ac3ad7
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
172
879
702470859ebd document fc-meltest-{e1,pwt}
Mychaela Falconia <falcon@freecalypso.org>
parents: 875
diff changeset
173 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
174 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
175 format (under /tmp), then uploads the binary melody (via
702470859ebd document fc-meltest-{e1,pwt}
Mychaela Falconia <falcon@freecalypso.org>
parents: 875
diff changeset
176 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
177 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
178
702470859ebd document fc-meltest-{e1,pwt}
Mychaela Falconia <falcon@freecalypso.org>
parents: 875
diff changeset
179 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
180 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
181 format (under /tmp), then uploads the binary melody (via
702470859ebd document fc-meltest-{e1,pwt}
Mychaela Falconia <falcon@freecalypso.org>
parents: 875
diff changeset
182 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
183 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
184
216
7e3e3a958e3f doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents: 154
diff changeset
185 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
186 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
187 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
188 FreeCalypso Citrine, with TCS211-based firmwares including
7e3e3a958e3f doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents: 154
diff changeset
189 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
190 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
191 through rvinterf.
7e3e3a958e3f doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents: 154
diff changeset
192
737
6d97866bad79 first round of documentation for DUART28C boot control addition
Mychaela Falconia <falcon@freecalypso.org>
parents: 730
diff changeset
193 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
194 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
195 for the explanation.
6d97866bad79 first round of documentation for DUART28C boot control addition
Mychaela Falconia <falcon@freecalypso.org>
parents: 730
diff changeset
196
6d97866bad79 first round of documentation for DUART28C boot control addition
Mychaela Falconia <falcon@freecalypso.org>
parents: 730
diff changeset
197 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
198 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
199 for the explanation.
6d97866bad79 first round of documentation for DUART28C boot control addition
Mychaela Falconia <falcon@freecalypso.org>
parents: 730
diff changeset
200
871
5a7ab739e4f3 doc/Host-tools-overview: document fc-pwt-comp
Mychaela Falconia <falcon@freecalypso.org>
parents: 864
diff changeset
201 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
202 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
203 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
204 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
205
310
c31a9cbf6ee2 doc/Host-tools-overview: fc-readcal documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 308
diff changeset
206 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
207 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
208 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
209 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
210 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
211 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
212 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
213
440
44f73d56b6f5 CHANGES and doc/Host-tools-overview: fc-rftab2c addition
Mychaela Falconia <falcon@freecalypso.org>
parents: 413
diff changeset
214 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
215 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
216 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
217 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
218 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
219
216
7e3e3a958e3f doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents: 154
diff changeset
220 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
221 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
222 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
223
875
8ff9bce1b56e document fc-ringlist-comp
Mychaela Falconia <falcon@freecalypso.org>
parents: 871
diff changeset
224 fc-ringlist-comp
8ff9bce1b56e document fc-ringlist-comp
Mychaela Falconia <falcon@freecalypso.org>
parents: 871
diff changeset
225 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
226 tone melodies from ASCII source into the binary format (.mls)
8ff9bce1b56e document fc-ringlist-comp
Mychaela Falconia <falcon@freecalypso.org>
parents: 871
diff changeset
227 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
228 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
229 article for more details.
8ff9bce1b56e document fc-ringlist-comp
Mychaela Falconia <falcon@freecalypso.org>
parents: 871
diff changeset
230
216
7e3e3a958e3f doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents: 154
diff changeset
231 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
232 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
233 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
234 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
235 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
236
796
2c0eebf1d00a doc/Host-tools-overview: add fc-simint and fc-simtool
Mychaela Falconia <falcon@freecalypso.org>
parents: 760
diff changeset
237 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
238 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
239 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
240 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
241 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
242
2c0eebf1d00a doc/Host-tools-overview: add fc-simint and fc-simtool
Mychaela Falconia <falcon@freecalypso.org>
parents: 760
diff changeset
243 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
244 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
245 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
246 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
247 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
248 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
249 inside Calypso devices.
2c0eebf1d00a doc/Host-tools-overview: add fc-simint and fc-simtool
Mychaela Falconia <falcon@freecalypso.org>
parents: 760
diff changeset
250
23
10b71f01f4ff doc/Host-tools-overview updated for the current state of the tools
Mychaela Falconia <falcon@freecalypso.org>
parents: 0
diff changeset
251 fc-tch2fr This hack-utility takes a TCH downlink recording produced with
912
3ed4f53c6092 doc/Host-tools-overview: update fc-tch2fr bogon description
Mychaela Falconia <falcon@freecalypso.org>
parents: 911
diff changeset
252 the tch record command in fc-shell (specifically, the old format
3ed4f53c6092 doc/Host-tools-overview: update fc-tch2fr bogon description
Mychaela Falconia <falcon@freecalypso.org>
parents: 911
diff changeset
253 that will only be produced if the source of TCH DL bits is a
3ed4f53c6092 doc/Host-tools-overview: update fc-tch2fr bogon description
Mychaela Falconia <falcon@freecalypso.org>
parents: 911
diff changeset
254 very old FC firmware version) and tries to convert it to a
3ed4f53c6092 doc/Host-tools-overview: update fc-tch2fr bogon description
Mychaela Falconia <falcon@freecalypso.org>
parents: 911
diff changeset
255 playable libgsm file (containing garbage frames in reality,
3ed4f53c6092 doc/Host-tools-overview: update fc-tch2fr bogon description
Mychaela Falconia <falcon@freecalypso.org>
parents: 911
diff changeset
256 resulting in very unpleasant noises on subsequent decoding) by
3ed4f53c6092 doc/Host-tools-overview: update fc-tch2fr bogon description
Mychaela Falconia <falcon@freecalypso.org>
parents: 911
diff changeset
257 completely disregarding the DSP status words which were not
3ed4f53c6092 doc/Host-tools-overview: update fc-tch2fr bogon description
Mychaela Falconia <falcon@freecalypso.org>
parents: 911
diff changeset
258 understood back when this hack was written in 2016. See our
23
10b71f01f4ff doc/Host-tools-overview updated for the current state of the tools
Mychaela Falconia <falcon@freecalypso.org>
parents: 0
diff changeset
259 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
260
7e3e3a958e3f doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents: 154
diff changeset
261 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
262 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
263 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
264 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
265 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
266 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
267 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
268 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
269 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
270 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
271 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
272 fully decoupled.
b84bc65e7f86 doc/Host-tools-overview: fc-tmsync documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 310
diff changeset
273
b84bc65e7f86 doc/Host-tools-overview: fc-tmsync documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 310
diff changeset
274 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
275 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
276 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
277 firmwares.
216
7e3e3a958e3f doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents: 154
diff changeset
278
913
1b8929cb7371 doc/Host-tools-overview: document fc-vm2gsmx
Mychaela Falconia <falcon@freecalypso.org>
parents: 912
diff changeset
279 fc-vm2gsmx This utility takes a TCS211 classic (non-AMR) voice memo
1b8929cb7371 doc/Host-tools-overview: document fc-vm2gsmx
Mychaela Falconia <falcon@freecalypso.org>
parents: 912
diff changeset
280 recording (a binary file as you would read out with fc-fsio) and
1b8929cb7371 doc/Host-tools-overview: document fc-vm2gsmx
Mychaela Falconia <falcon@freecalypso.org>
parents: 912
diff changeset
281 converts it into extended-libgsm (gsmx) format defined in our
1b8929cb7371 doc/Host-tools-overview: document fc-vm2gsmx
Mychaela Falconia <falcon@freecalypso.org>
parents: 912
diff changeset
282 gsm-codec-lib package. Please refer to Voice-memo-utils article
1b8929cb7371 doc/Host-tools-overview: document fc-vm2gsmx
Mychaela Falconia <falcon@freecalypso.org>
parents: 912
diff changeset
283 for more information.
1b8929cb7371 doc/Host-tools-overview: document fc-vm2gsmx
Mychaela Falconia <falcon@freecalypso.org>
parents: 912
diff changeset
284
1b8929cb7371 doc/Host-tools-overview: document fc-vm2gsmx
Mychaela Falconia <falcon@freecalypso.org>
parents: 912
diff changeset
285 fc-vm2hex This utility takes a TCS211 VM binary file just like fc-vm2gsmx
1b8929cb7371 doc/Host-tools-overview: document fc-vm2gsmx
Mychaela Falconia <falcon@freecalypso.org>
parents: 912
diff changeset
286 and converts it into ASCII hex format that can be analyzed by a
1b8929cb7371 doc/Host-tools-overview: document fc-vm2gsmx
Mychaela Falconia <falcon@freecalypso.org>
parents: 912
diff changeset
287 human, either directly or with the aid of gsmfr-dlcap-parse
1b8929cb7371 doc/Host-tools-overview: document fc-vm2gsmx
Mychaela Falconia <falcon@freecalypso.org>
parents: 912
diff changeset
288 utility from our gsm-codec-lib package. Please refer to
1b8929cb7371 doc/Host-tools-overview: document fc-vm2gsmx
Mychaela Falconia <falcon@freecalypso.org>
parents: 912
diff changeset
289 Voice-memo-utils article for more information.
216
7e3e3a958e3f doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents: 154
diff changeset
290
391
53b474e7e590 doc/Host-tools-overview: documented new additions
Mychaela Falconia <falcon@freecalypso.org>
parents: 311
diff changeset
291 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
292
216
7e3e3a958e3f doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents: 154
diff changeset
293 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
294 digit of an IMEI number.
7e3e3a958e3f doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents: 154
diff changeset
295
864
82d4a7438639 doc/Host-tools-overview: document l1trace-filter
Mychaela Falconia <falcon@freecalypso.org>
parents: 863
diff changeset
296 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
297 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
298 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
299
745
9e3b1ef1f440 make-imeisv utility documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 737
diff changeset
300 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
301 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
302 Luhn check digit) and a 2-digit SV field.
9e3b1ef1f440 make-imeisv utility documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 737
diff changeset
303
413
a28c46e5a6ce doc/Host-tools-overview: mokosrec2bin addition documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 395
diff changeset
304 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
305 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
306 options) to straight binary.
a28c46e5a6ce doc/Host-tools-overview: mokosrec2bin addition documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 395
diff changeset
307
601
4c58e09578d0 doc/Host-tools-overview: pcm-sms-decode documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 551
diff changeset
308 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
309 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
310 /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
311 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
312 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
313 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
314 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
315 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
316
216
7e3e3a958e3f doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents: 154
diff changeset
317 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
318 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
319 LCD.
7e3e3a958e3f doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents: 154
diff changeset
320
7e3e3a958e3f doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents: 154
diff changeset
321 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
322 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
323 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
324
391
53b474e7e590 doc/Host-tools-overview: documented new additions
Mychaela Falconia <falcon@freecalypso.org>
parents: 311
diff changeset
325 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
326 User-phone-tools article.
53b474e7e590 doc/Host-tools-overview: documented new additions
Mychaela Falconia <falcon@freecalypso.org>
parents: 311
diff changeset
327
623
46d17c346511 doc/Host-tools-overview: srec-regions added
Mychaela Falconia <falcon@freecalypso.org>
parents: 601
diff changeset
328 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
329 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
330 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
331
216
7e3e3a958e3f doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents: 154
diff changeset
332 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
333 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
334 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
335 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
336 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
337 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
338 firmware versions.
7e3e3a958e3f doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents: 154
diff changeset
339
244
97d6d593ffc6 doc/Host-tools-overview: tiaud-compile and tiaud-mkvol documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 216
diff changeset
340 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
341 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
342 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
343 fc-fsio.
97d6d593ffc6 doc/Host-tools-overview: tiaud-compile and tiaud-mkvol documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 216
diff changeset
344
216
7e3e3a958e3f doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents: 154
diff changeset
345 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
346 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
347 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
348
97d6d593ffc6 doc/Host-tools-overview: tiaud-compile and tiaud-mkvol documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 216
diff changeset
349 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
350 *.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
351
7e3e3a958e3f doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents: 154
diff changeset
352 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
353 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
354 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
355 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
356 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
357 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
358 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
359 configurations from Openmoko, Pirelli and Tango.
709
9b0ad72184e3 doc/Host-tools-overview: tiffs-mkfs documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 623
diff changeset
360
9b0ad72184e3 doc/Host-tools-overview: tiffs-mkfs documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 623
diff changeset
361 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
362 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
363 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
364 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
365 Calypso GSM device running FreeCalypso firmware.
747
efd85963ec85 tiffs-mkfile documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 745
diff changeset
366
efd85963ec85 tiffs-mkfile documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 745
diff changeset
367 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
368 certain types of binary files that go into TIFFS, for subsequent
efd85963ec85 tiffs-mkfile documented
Mychaela Falconia <falcon@freecalypso.org>
parents: 745
diff changeset
369 feeding to tiffs-mkfs.