FreeCalypso > hg > freecalypso-tools
annotate doc/Host-tools-overview @ 830:07105f244424
ringtools/examples: astureses.pwt and bugle.pwt reconstruction
attempts from TI's defunct mmiMelody_data.c
author | Mychaela Falconia <falcon@freecalypso.org> |
---|---|
date | Sun, 30 May 2021 23:47:16 +0000 |
parents | 2c0eebf1d00a |
children | 2f401860e9ad |
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 |
485
944e26b2f314
doc/Host-tools-overview: fc-bin2rftab addition documented
Mychaela Falconia <falcon@freecalypso.org>
parents:
440
diff
changeset
|
95 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
|
96 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
|
97 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
|
98 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
|
99 |
216
7e3e3a958e3f
doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents:
154
diff
changeset
|
100 fc-buzplay This program plays piezoelectic buzzer melodies on an actual |
7e3e3a958e3f
doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents:
154
diff
changeset
|
101 Calypso device equipped with such a buzzer (Mot C1xx, TI's |
7e3e3a958e3f
doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents:
154
diff
changeset
|
102 D-Sample board, our planned future HSMBP) by loading a buzplayer |
7e3e3a958e3f
doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents:
154
diff
changeset
|
103 agent onto the target and feeding melodies to be played to it. |
7e3e3a958e3f
doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents:
154
diff
changeset
|
104 |
308
6a254cc6a7f3
doc/Host-tools-overview: fc-cal2bin documented
Mychaela Falconia <falcon@freecalypso.org>
parents:
300
diff
changeset
|
105 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
|
106 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
|
107 RF_tables article for more details. |
6a254cc6a7f3
doc/Host-tools-overview: fc-cal2bin documented
Mychaela Falconia <falcon@freecalypso.org>
parents:
300
diff
changeset
|
108 |
216
7e3e3a958e3f
doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents:
154
diff
changeset
|
109 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
|
110 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
|
111 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
|
112 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
|
113 article for more details. |
7e3e3a958e3f
doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents:
154
diff
changeset
|
114 |
7e3e3a958e3f
doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents:
154
diff
changeset
|
115 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
|
116 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
|
117 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
|
118 |
551
245ffa153cea
doc/Host-tools-overview: fc-dspromdump documented
Mychaela Falconia <falcon@freecalypso.org>
parents:
485
diff
changeset
|
119 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
|
120 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
|
121 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
|
122 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
|
123 |
216
7e3e3a958e3f
doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents:
154
diff
changeset
|
124 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
|
125 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
|
126 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
|
127 |
7e3e3a958e3f
doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents:
154
diff
changeset
|
128 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
|
129 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
|
130 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
|
131 |
216
7e3e3a958e3f
doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents:
154
diff
changeset
|
132 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
|
133 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
|
134 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
|
135 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
|
136 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
|
137 |
216
7e3e3a958e3f
doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents:
154
diff
changeset
|
138 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
|
139 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
|
140 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
|
141 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
|
142 invokes the latter. |
0
e7502631a0f9
initial import from freecalypso-sw rev 1033:5ab737ac3ad7
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
143 |
395
8027cc12f96a
doc/Host-tools-overview: update for the move-out of fc-lcdemu
Mychaela Falconia <falcon@freecalypso.org>
parents:
391
diff
changeset
|
144 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
|
145 info. |
8027cc12f96a
doc/Host-tools-overview: update for the move-out of fc-lcdemu
Mychaela Falconia <falcon@freecalypso.org>
parents:
391
diff
changeset
|
146 |
8027cc12f96a
doc/Host-tools-overview: update for the move-out of fc-lcdemu
Mychaela Falconia <falcon@freecalypso.org>
parents:
391
diff
changeset
|
147 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
|
148 for more info. |
0
e7502631a0f9
initial import from freecalypso-sw rev 1033:5ab737ac3ad7
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff
changeset
|
149 |
216
7e3e3a958e3f
doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents:
154
diff
changeset
|
150 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
|
151 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
|
152 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
|
153 FreeCalypso Citrine, with TCS211-based firmwares including |
7e3e3a958e3f
doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents:
154
diff
changeset
|
154 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
|
155 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
|
156 through rvinterf. |
7e3e3a958e3f
doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents:
154
diff
changeset
|
157 |
737
6d97866bad79
first round of documentation for DUART28C boot control addition
Mychaela Falconia <falcon@freecalypso.org>
parents:
730
diff
changeset
|
158 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
|
159 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
|
160 for the explanation. |
6d97866bad79
first round of documentation for DUART28C boot control addition
Mychaela Falconia <falcon@freecalypso.org>
parents:
730
diff
changeset
|
161 |
6d97866bad79
first round of documentation for DUART28C boot control addition
Mychaela Falconia <falcon@freecalypso.org>
parents:
730
diff
changeset
|
162 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
|
163 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
|
164 for the explanation. |
6d97866bad79
first round of documentation for DUART28C boot control addition
Mychaela Falconia <falcon@freecalypso.org>
parents:
730
diff
changeset
|
165 |
310
c31a9cbf6ee2
doc/Host-tools-overview: fc-readcal documented
Mychaela Falconia <falcon@freecalypso.org>
parents:
308
diff
changeset
|
166 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
|
167 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
|
168 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
|
169 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
|
170 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
|
171 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
|
172 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
|
173 |
440
44f73d56b6f5
CHANGES and doc/Host-tools-overview: fc-rftab2c addition
Mychaela Falconia <falcon@freecalypso.org>
parents:
413
diff
changeset
|
174 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
|
175 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
|
176 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
|
177 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
|
178 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
|
179 |
216
7e3e3a958e3f
doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents:
154
diff
changeset
|
180 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
|
181 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
|
182 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
|
183 |
7e3e3a958e3f
doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents:
154
diff
changeset
|
184 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
|
185 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
|
186 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
|
187 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
|
188 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
|
189 |
796
2c0eebf1d00a
doc/Host-tools-overview: add fc-simint and fc-simtool
Mychaela Falconia <falcon@freecalypso.org>
parents:
760
diff
changeset
|
190 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
|
191 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
|
192 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
|
193 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
|
194 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
|
195 |
2c0eebf1d00a
doc/Host-tools-overview: add fc-simint and fc-simtool
Mychaela Falconia <falcon@freecalypso.org>
parents:
760
diff
changeset
|
196 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
|
197 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
|
198 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
|
199 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
|
200 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
|
201 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
|
202 inside Calypso devices. |
2c0eebf1d00a
doc/Host-tools-overview: add fc-simint and fc-simtool
Mychaela Falconia <falcon@freecalypso.org>
parents:
760
diff
changeset
|
203 |
23
10b71f01f4ff
doc/Host-tools-overview updated for the current state of the tools
Mychaela Falconia <falcon@freecalypso.org>
parents:
0
diff
changeset
|
204 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
|
205 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
|
206 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
|
207 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
|
208 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
|
209 |
7e3e3a958e3f
doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents:
154
diff
changeset
|
210 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
|
211 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
|
212 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
|
213 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
|
214 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
|
215 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
|
216 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
|
217 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
|
218 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
|
219 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
|
220 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
|
221 fully decoupled. |
b84bc65e7f86
doc/Host-tools-overview: fc-tmsync documented
Mychaela Falconia <falcon@freecalypso.org>
parents:
310
diff
changeset
|
222 |
b84bc65e7f86
doc/Host-tools-overview: fc-tmsync documented
Mychaela Falconia <falcon@freecalypso.org>
parents:
310
diff
changeset
|
223 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
|
224 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
|
225 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
|
226 firmwares. |
216
7e3e3a958e3f
doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents:
154
diff
changeset
|
227 |
7e3e3a958e3f
doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents:
154
diff
changeset
|
228 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
|
229 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
|
230 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
|
231 |
391
53b474e7e590
doc/Host-tools-overview: documented new additions
Mychaela Falconia <falcon@freecalypso.org>
parents:
311
diff
changeset
|
232 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
|
233 |
216
7e3e3a958e3f
doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents:
154
diff
changeset
|
234 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
|
235 digit of an IMEI number. |
7e3e3a958e3f
doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents:
154
diff
changeset
|
236 |
745
9e3b1ef1f440
make-imeisv utility documented
Mychaela Falconia <falcon@freecalypso.org>
parents:
737
diff
changeset
|
237 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
|
238 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
|
239 Luhn check digit) and a 2-digit SV field. |
9e3b1ef1f440
make-imeisv utility documented
Mychaela Falconia <falcon@freecalypso.org>
parents:
737
diff
changeset
|
240 |
413
a28c46e5a6ce
doc/Host-tools-overview: mokosrec2bin addition documented
Mychaela Falconia <falcon@freecalypso.org>
parents:
395
diff
changeset
|
241 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
|
242 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
|
243 options) to straight binary. |
a28c46e5a6ce
doc/Host-tools-overview: mokosrec2bin addition documented
Mychaela Falconia <falcon@freecalypso.org>
parents:
395
diff
changeset
|
244 |
601
4c58e09578d0
doc/Host-tools-overview: pcm-sms-decode documented
Mychaela Falconia <falcon@freecalypso.org>
parents:
551
diff
changeset
|
245 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
|
246 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
|
247 /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
|
248 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
|
249 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
|
250 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
|
251 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
|
252 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
|
253 |
216
7e3e3a958e3f
doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents:
154
diff
changeset
|
254 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
|
255 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
|
256 LCD. |
7e3e3a958e3f
doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents:
154
diff
changeset
|
257 |
7e3e3a958e3f
doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents:
154
diff
changeset
|
258 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
|
259 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
|
260 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
|
261 |
391
53b474e7e590
doc/Host-tools-overview: documented new additions
Mychaela Falconia <falcon@freecalypso.org>
parents:
311
diff
changeset
|
262 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
|
263 User-phone-tools article. |
53b474e7e590
doc/Host-tools-overview: documented new additions
Mychaela Falconia <falcon@freecalypso.org>
parents:
311
diff
changeset
|
264 |
623
46d17c346511
doc/Host-tools-overview: srec-regions added
Mychaela Falconia <falcon@freecalypso.org>
parents:
601
diff
changeset
|
265 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
|
266 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
|
267 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
|
268 |
216
7e3e3a958e3f
doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents:
154
diff
changeset
|
269 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
|
270 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
|
271 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
|
272 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
|
273 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
|
274 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
|
275 firmware versions. |
7e3e3a958e3f
doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents:
154
diff
changeset
|
276 |
244
97d6d593ffc6
doc/Host-tools-overview: tiaud-compile and tiaud-mkvol documented
Mychaela Falconia <falcon@freecalypso.org>
parents:
216
diff
changeset
|
277 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
|
278 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
|
279 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
|
280 fc-fsio. |
97d6d593ffc6
doc/Host-tools-overview: tiaud-compile and tiaud-mkvol documented
Mychaela Falconia <falcon@freecalypso.org>
parents:
216
diff
changeset
|
281 |
216
7e3e3a958e3f
doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents:
154
diff
changeset
|
282 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
|
283 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
|
284 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
|
285 |
97d6d593ffc6
doc/Host-tools-overview: tiaud-compile and tiaud-mkvol documented
Mychaela Falconia <falcon@freecalypso.org>
parents:
216
diff
changeset
|
286 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
|
287 *.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
|
288 |
7e3e3a958e3f
doc/Host-tools-overview: updated and simplified
Mychaela Falconia <falcon@freecalypso.org>
parents:
154
diff
changeset
|
289 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
|
290 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
|
291 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
|
292 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
|
293 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
|
294 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
|
295 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
|
296 configurations from Openmoko, Pirelli and Tango. |
709
9b0ad72184e3
doc/Host-tools-overview: tiffs-mkfs documented
Mychaela Falconia <falcon@freecalypso.org>
parents:
623
diff
changeset
|
297 |
9b0ad72184e3
doc/Host-tools-overview: tiffs-mkfs documented
Mychaela Falconia <falcon@freecalypso.org>
parents:
623
diff
changeset
|
298 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
|
299 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
|
300 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
|
301 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
|
302 Calypso GSM device running FreeCalypso firmware. |
747
efd85963ec85
tiffs-mkfile documented
Mychaela Falconia <falcon@freecalypso.org>
parents:
745
diff
changeset
|
303 |
efd85963ec85
tiffs-mkfile documented
Mychaela Falconia <falcon@freecalypso.org>
parents:
745
diff
changeset
|
304 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
|
305 certain types of binary files that go into TIFFS, for subsequent |
efd85963ec85
tiffs-mkfile documented
Mychaela Falconia <falcon@freecalypso.org>
parents:
745
diff
changeset
|
306 feeding to tiffs-mkfs. |