FreeCalypso > hg > freecalypso-tools
annotate doc/Host-tools-overview @ 576:34d544c0f639
loadtools/loadtool.help: removed no-longer-applicable GTA02 stanza
| author | Mychaela Falconia <falcon@freecalypso.org> | 
|---|---|
| date | Sun, 02 Feb 2020 20:57:28 +0000 | 
| parents | 245ffa153cea | 
| children | 4c58e09578d0 | 
| rev | line source | 
|---|---|
| 216 
7e3e3a958e3f
doc/Host-tools-overview: updated and simplified
 Mychaela Falconia <falcon@freecalypso.org> parents: 
154diff
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: 
154diff
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: 
154diff
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: 
154diff
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: 
154diff
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: 
154diff
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: 
154diff
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: 
154diff
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: 
154diff
changeset | 17 different kinds of RAM through different download protocols. | 
| 
7e3e3a958e3f
doc/Host-tools-overview: updated and simplified
 Mychaela Falconia <falcon@freecalypso.org> parents: 
154diff
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: 
154diff
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: 
154diff
changeset | 20 | 
| 
7e3e3a958e3f
doc/Host-tools-overview: updated and simplified
 Mychaela Falconia <falcon@freecalypso.org> parents: 
154diff
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: 
154diff
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: 
154diff
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: 
154diff
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: 
154diff
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: 
154diff
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: 
154diff
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: 
154diff
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: 
154diff
changeset | 29 | 
| 
7e3e3a958e3f
doc/Host-tools-overview: updated and simplified
 Mychaela Falconia <falcon@freecalypso.org> parents: 
154diff
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: 
154diff
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: 
154diff
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: 
154diff
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: 
154diff
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: 
154diff
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: 
154diff
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: 
154diff
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: 
154diff
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: 
154diff
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 | 
| 216 
7e3e3a958e3f
doc/Host-tools-overview: updated and simplified
 Mychaela Falconia <falcon@freecalypso.org> parents: 
154diff
changeset | 49 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: 
154diff
changeset | 50 phones that exercises their peripheral hardware: LCD, keypad | 
| 
7e3e3a958e3f
doc/Host-tools-overview: updated and simplified
 Mychaela Falconia <falcon@freecalypso.org> parents: 
154diff
changeset | 51 backlight, buzzer and vibrator. | 
| 0 
e7502631a0f9
initial import from freecalypso-sw rev 1033:5ab737ac3ad7
 Mychaela Falconia <falcon@freecalypso.org> parents: diff
changeset | 52 | 
| 300 
0cfb2e3aeda4
started documenting c1xx-calextr
 Mychaela Falconia <falcon@freecalypso.org> parents: 
244diff
changeset | 53 c1xx-calextr This utility extracts the factory RF calibration values for | 
| 
0cfb2e3aeda4
started documenting c1xx-calextr
 Mychaela Falconia <falcon@freecalypso.org> parents: 
244diff
changeset | 54 Mot C1xx phones from the records contained in a special sector | 
| 
0cfb2e3aeda4
started documenting c1xx-calextr
 Mychaela Falconia <falcon@freecalypso.org> parents: 
244diff
changeset | 55 of their flash and converts them to FreeCalypso format, to be | 
| 
0cfb2e3aeda4
started documenting c1xx-calextr
 Mychaela Falconia <falcon@freecalypso.org> parents: 
244diff
changeset | 56 used when running our own firmware on these phones. See the | 
| 
0cfb2e3aeda4
started documenting c1xx-calextr
 Mychaela Falconia <falcon@freecalypso.org> parents: 
244diff
changeset | 57 Compal-calibration article for more details. | 
| 
0cfb2e3aeda4
started documenting c1xx-calextr
 Mychaela Falconia <falcon@freecalypso.org> parents: 
244diff
changeset | 58 | 
| 391 
53b474e7e590
doc/Host-tools-overview: documented new additions
 Mychaela Falconia <falcon@freecalypso.org> parents: 
311diff
changeset | 59 compile-fc-batt This utility compiles a table of battery thresholds for the new | 
| 
53b474e7e590
doc/Host-tools-overview: documented new additions
 Mychaela Falconia <falcon@freecalypso.org> parents: 
311diff
changeset | 60 FreeCalypso battery management code from ASCII source into the | 
| 
53b474e7e590
doc/Host-tools-overview: documented new additions
 Mychaela Falconia <falcon@freecalypso.org> parents: 
311diff
changeset | 61 binary form suitable for uploading into /etc/batterytab on a | 
| 
53b474e7e590
doc/Host-tools-overview: documented new additions
 Mychaela Falconia <falcon@freecalypso.org> parents: 
311diff
changeset | 62 FreeCalypso device. It is rarely used directly, instead | 
| 
53b474e7e590
doc/Host-tools-overview: documented new additions
 Mychaela Falconia <falcon@freecalypso.org> parents: 
311diff
changeset | 63 fc-fsio write-battery-table command invokes compile-fc-batt | 
| 
53b474e7e590
doc/Host-tools-overview: documented new additions
 Mychaela Falconia <falcon@freecalypso.org> parents: 
311diff
changeset | 64 behind the scenes. | 
| 
53b474e7e590
doc/Host-tools-overview: documented new additions
 Mychaela Falconia <falcon@freecalypso.org> parents: 
311diff
changeset | 65 | 
| 
53b474e7e590
doc/Host-tools-overview: documented new additions
 Mychaela Falconia <falcon@freecalypso.org> parents: 
311diff
changeset | 66 compile-fc-chg This utility compiles a FreeCalypso battery charging | 
| 
53b474e7e590
doc/Host-tools-overview: documented new additions
 Mychaela Falconia <falcon@freecalypso.org> parents: 
311diff
changeset | 67 configuration file from ASCII source into the binary form | 
| 
53b474e7e590
doc/Host-tools-overview: documented new additions
 Mychaela Falconia <falcon@freecalypso.org> parents: 
311diff
changeset | 68 suitable for uploading into /etc/charging on a FreeCalypso | 
| 
53b474e7e590
doc/Host-tools-overview: documented new additions
 Mychaela Falconia <falcon@freecalypso.org> parents: 
311diff
changeset | 69 device. It is rarely used directly, instead fc-fsio | 
| 
53b474e7e590
doc/Host-tools-overview: documented new additions
 Mychaela Falconia <falcon@freecalypso.org> parents: 
311diff
changeset | 70 write-charging-config command invokes compile-fc-chg behind the | 
| 
53b474e7e590
doc/Host-tools-overview: documented new additions
 Mychaela Falconia <falcon@freecalypso.org> parents: 
311diff
changeset | 71 scenes. | 
| 
53b474e7e590
doc/Host-tools-overview: documented new additions
 Mychaela Falconia <falcon@freecalypso.org> parents: 
311diff
changeset | 72 | 
| 0 
e7502631a0f9
initial import from freecalypso-sw rev 1033:5ab737ac3ad7
 Mychaela Falconia <falcon@freecalypso.org> parents: diff
changeset | 73 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 | 74 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 | 75 "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 | 76 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 | 77 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 | 78 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 | 79 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 | 80 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 | 81 question; this ctracedec utility performs that decoding. | 
| 
e7502631a0f9
initial import from freecalypso-sw rev 1033:5ab737ac3ad7
 Mychaela Falconia <falcon@freecalypso.org> parents: diff
changeset | 82 | 
| 485 
944e26b2f314
doc/Host-tools-overview: fc-bin2rftab addition documented
 Mychaela Falconia <falcon@freecalypso.org> parents: 
440diff
changeset | 83 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: 
440diff
changeset | 84 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: 
440diff
changeset | 85 offset, allowing extraction of tables from alien firmwares and | 
| 
944e26b2f314
doc/Host-tools-overview: fc-bin2rftab addition documented
 Mychaela Falconia <falcon@freecalypso.org> parents: 
440diff
changeset | 86 whatnot) and emits it in FreeCalypso ASCII format. | 
| 
944e26b2f314
doc/Host-tools-overview: fc-bin2rftab addition documented
 Mychaela Falconia <falcon@freecalypso.org> parents: 
440diff
changeset | 87 | 
| 216 
7e3e3a958e3f
doc/Host-tools-overview: updated and simplified
 Mychaela Falconia <falcon@freecalypso.org> parents: 
154diff
changeset | 88 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: 
154diff
changeset | 89 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: 
154diff
changeset | 90 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: 
154diff
changeset | 91 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: 
154diff
changeset | 92 | 
| 308 
6a254cc6a7f3
doc/Host-tools-overview: fc-cal2bin documented
 Mychaela Falconia <falcon@freecalypso.org> parents: 
300diff
changeset | 93 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: 
300diff
changeset | 94 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: 
300diff
changeset | 95 RF_tables article for more details. | 
| 
6a254cc6a7f3
doc/Host-tools-overview: fc-cal2bin documented
 Mychaela Falconia <falcon@freecalypso.org> parents: 
300diff
changeset | 96 | 
| 216 
7e3e3a958e3f
doc/Host-tools-overview: updated and simplified
 Mychaela Falconia <falcon@freecalypso.org> parents: 
154diff
changeset | 97 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: 
154diff
changeset | 98 directory subtree as input (either extracted in vitro with tiffs | 
| 
7e3e3a958e3f
doc/Host-tools-overview: updated and simplified
 Mychaela Falconia <falcon@freecalypso.org> parents: 
154diff
changeset | 99 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: 
154diff
changeset | 100 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: 
154diff
changeset | 101 article for more details. | 
| 
7e3e3a958e3f
doc/Host-tools-overview: updated and simplified
 Mychaela Falconia <falcon@freecalypso.org> parents: 
154diff
changeset | 102 | 
| 
7e3e3a958e3f
doc/Host-tools-overview: updated and simplified
 Mychaela Falconia <falcon@freecalypso.org> parents: 
154diff
changeset | 103 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: 
154diff
changeset | 104 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: 
154diff
changeset | 105 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 | 106 | 
| 551 
245ffa153cea
doc/Host-tools-overview: fc-dspromdump documented
 Mychaela Falconia <falcon@freecalypso.org> parents: 
485diff
changeset | 107 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: 
485diff
changeset | 108 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: 
485diff
changeset | 109 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: 
485diff
changeset | 110 the DSP-ROM-dump article for more details. | 
| 
245ffa153cea
doc/Host-tools-overview: fc-dspromdump documented
 Mychaela Falconia <falcon@freecalypso.org> parents: 
485diff
changeset | 111 | 
| 216 
7e3e3a958e3f
doc/Host-tools-overview: updated and simplified
 Mychaela Falconia <falcon@freecalypso.org> parents: 
154diff
changeset | 112 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: 
154diff
changeset | 113 the native binary format to our own ASCII-based representation; | 
| 
7e3e3a958e3f
doc/Host-tools-overview: updated and simplified
 Mychaela Falconia <falcon@freecalypso.org> parents: 
154diff
changeset | 114 see the Melody_E1 article for more information. | 
| 
7e3e3a958e3f
doc/Host-tools-overview: updated and simplified
 Mychaela Falconia <falcon@freecalypso.org> parents: 
154diff
changeset | 115 | 
| 
7e3e3a958e3f
doc/Host-tools-overview: updated and simplified
 Mychaela Falconia <falcon@freecalypso.org> parents: 
154diff
changeset | 116 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: 
154diff
changeset | 117 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: 
154diff
changeset | 118 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 | 119 | 
| 216 
7e3e3a958e3f
doc/Host-tools-overview: updated and simplified
 Mychaela Falconia <falcon@freecalypso.org> parents: 
154diff
changeset | 120 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: 
154diff
changeset | 121 de facto standard libgsm format (which can be recorded with | 
| 
7e3e3a958e3f
doc/Host-tools-overview: updated and simplified
 Mychaela Falconia <falcon@freecalypso.org> parents: 
154diff
changeset | 122 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: 
154diff
changeset | 123 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: 
154diff
changeset | 124 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 | 125 | 
| 216 
7e3e3a958e3f
doc/Host-tools-overview: updated and simplified
 Mychaela Falconia <falcon@freecalypso.org> parents: 
154diff
changeset | 126 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: 
154diff
changeset | 127 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: 
154diff
changeset | 128 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: 
154diff
changeset | 129 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: 
154diff
changeset | 130 invokes the latter. | 
| 0 
e7502631a0f9
initial import from freecalypso-sw rev 1033:5ab737ac3ad7
 Mychaela Falconia <falcon@freecalypso.org> parents: diff
changeset | 131 | 
| 395 
8027cc12f96a
doc/Host-tools-overview: update for the move-out of fc-lcdemu
 Mychaela Falconia <falcon@freecalypso.org> parents: 
391diff
changeset | 132 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: 
391diff
changeset | 133 info. | 
| 
8027cc12f96a
doc/Host-tools-overview: update for the move-out of fc-lcdemu
 Mychaela Falconia <falcon@freecalypso.org> parents: 
391diff
changeset | 134 | 
| 
8027cc12f96a
doc/Host-tools-overview: update for the move-out of fc-lcdemu
 Mychaela Falconia <falcon@freecalypso.org> parents: 
391diff
changeset | 135 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: 
391diff
changeset | 136 for more info. | 
| 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: 
154diff
changeset | 138 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: 
154diff
changeset | 139 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: 
154diff
changeset | 140 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: 
154diff
changeset | 141 FreeCalypso Citrine, with TCS211-based firmwares including | 
| 
7e3e3a958e3f
doc/Host-tools-overview: updated and simplified
 Mychaela Falconia <falcon@freecalypso.org> parents: 
154diff
changeset | 142 FreeCalypso Magnetite, with really old TI firmwares which | 
| 
7e3e3a958e3f
doc/Host-tools-overview: updated and simplified
 Mychaela Falconia <falcon@freecalypso.org> parents: 
154diff
changeset | 143 predate ETM, and with Mot C1xx original firmwares. It works | 
| 
7e3e3a958e3f
doc/Host-tools-overview: updated and simplified
 Mychaela Falconia <falcon@freecalypso.org> parents: 
154diff
changeset | 144 through rvinterf. | 
| 
7e3e3a958e3f
doc/Host-tools-overview: updated and simplified
 Mychaela Falconia <falcon@freecalypso.org> parents: 
154diff
changeset | 145 | 
| 310 
c31a9cbf6ee2
doc/Host-tools-overview: fc-readcal documented
 Mychaela Falconia <falcon@freecalypso.org> parents: 
308diff
changeset | 146 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: 
308diff
changeset | 147 out of a running firmware through Test Mode commands: first | 
| 
c31a9cbf6ee2
doc/Host-tools-overview: fc-readcal documented
 Mychaela Falconia <falcon@freecalypso.org> parents: 
308diff
changeset | 148 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: 
308diff
changeset | 149 read various tables. The primary intended purpose is extracting | 
| 
c31a9cbf6ee2
doc/Host-tools-overview: fc-readcal documented
 Mychaela Falconia <falcon@freecalypso.org> parents: 
308diff
changeset | 150 RF calibration or static configuration data from alien | 
| 
c31a9cbf6ee2
doc/Host-tools-overview: fc-readcal documented
 Mychaela Falconia <falcon@freecalypso.org> parents: 
308diff
changeset | 151 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: 
308diff
changeset | 152 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: 
308diff
changeset | 153 | 
| 440 
44f73d56b6f5
CHANGES and doc/Host-tools-overview: fc-rftab2c addition
 Mychaela Falconia <falcon@freecalypso.org> parents: 
413diff
changeset | 154 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: 
413diff
changeset | 155 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: 
413diff
changeset | 156 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: 
413diff
changeset | 157 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: 
413diff
changeset | 158 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: 
413diff
changeset | 159 | 
| 216 
7e3e3a958e3f
doc/Host-tools-overview: updated and simplified
 Mychaela Falconia <falcon@freecalypso.org> parents: 
154diff
changeset | 160 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: 
154diff
changeset | 161 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: 
154diff
changeset | 162 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: 
154diff
changeset | 163 | 
| 
7e3e3a958e3f
doc/Host-tools-overview: updated and simplified
 Mychaela Falconia <falcon@freecalypso.org> parents: 
154diff
changeset | 164 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: 
154diff
changeset | 165 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: 
154diff
changeset | 166 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: 
154diff
changeset | 167 for talking to serially-interfaced devices that mix ASCII with | 
| 
7e3e3a958e3f
doc/Host-tools-overview: updated and simplified
 Mychaela Falconia <falcon@freecalypso.org> parents: 
154diff
changeset | 168 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: 
0diff
changeset | 169 | 
| 
10b71f01f4ff
doc/Host-tools-overview updated for the current state of the tools
 Mychaela Falconia <falcon@freecalypso.org> parents: 
0diff
changeset | 170 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: 
0diff
changeset | 171 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: 
0diff
changeset | 172 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: 
0diff
changeset | 173 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: 
0diff
changeset | 174 TCH-bit-access article for more information. | 
| 216 
7e3e3a958e3f
doc/Host-tools-overview: updated and simplified
 Mychaela Falconia <falcon@freecalypso.org> parents: 
154diff
changeset | 175 | 
| 
7e3e3a958e3f
doc/Host-tools-overview: updated and simplified
 Mychaela Falconia <falcon@freecalypso.org> parents: 
154diff
changeset | 176 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: 
154diff
changeset | 177 that can be issued through the RVTMUX (debug trace) serial | 
| 
7e3e3a958e3f
doc/Host-tools-overview: updated and simplified
 Mychaela Falconia <falcon@freecalypso.org> parents: 
154diff
changeset | 178 channel, used for L1/RF test functions, production line RF | 
| 
7e3e3a958e3f
doc/Host-tools-overview: updated and simplified
 Mychaela Falconia <falcon@freecalypso.org> parents: 
154diff
changeset | 179 calibration, FFS (flash file system) access, audio configuration | 
| 
7e3e3a958e3f
doc/Host-tools-overview: updated and simplified
 Mychaela Falconia <falcon@freecalypso.org> parents: 
154diff
changeset | 180 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: 
154diff
changeset | 181 sending these Test Mode commands to targets and displaying | 
| 
7e3e3a958e3f
doc/Host-tools-overview: updated and simplified
 Mychaela Falconia <falcon@freecalypso.org> parents: 
154diff
changeset | 182 decoded target responses; it works through rvinterf. fc-tmsh | 
| 
7e3e3a958e3f
doc/Host-tools-overview: updated and simplified
 Mychaela Falconia <falcon@freecalypso.org> parents: 
154diff
changeset | 183 supports all Test Mode commands (both TM3 and ETM) implemented | 
| 
7e3e3a958e3f
doc/Host-tools-overview: updated and simplified
 Mychaela Falconia <falcon@freecalypso.org> parents: 
154diff
changeset | 184 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: 
310diff
changeset | 185 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: 
310diff
changeset | 186 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: 
310diff
changeset | 187 fully decoupled. | 
| 
b84bc65e7f86
doc/Host-tools-overview: fc-tmsync documented
 Mychaela Falconia <falcon@freecalypso.org> parents: 
310diff
changeset | 188 | 
| 
b84bc65e7f86
doc/Host-tools-overview: fc-tmsync documented
 Mychaela Falconia <falcon@freecalypso.org> parents: 
310diff
changeset | 189 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: 
310diff
changeset | 190 a synchronous manner; it was written together with fc-readcal | 
| 
b84bc65e7f86
doc/Host-tools-overview: fc-tmsync documented
 Mychaela Falconia <falcon@freecalypso.org> parents: 
310diff
changeset | 191 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: 
310diff
changeset | 192 firmwares. | 
| 216 
7e3e3a958e3f
doc/Host-tools-overview: updated and simplified
 Mychaela Falconia <falcon@freecalypso.org> parents: 
154diff
changeset | 193 | 
| 
7e3e3a958e3f
doc/Host-tools-overview: updated and simplified
 Mychaela Falconia <falcon@freecalypso.org> parents: 
154diff
changeset | 194 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: 
154diff
changeset | 195 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: 
154diff
changeset | 196 a human or further fed to fc-tch2fr. | 
| 
7e3e3a958e3f
doc/Host-tools-overview: updated and simplified
 Mychaela Falconia <falcon@freecalypso.org> parents: 
154diff
changeset | 197 | 
| 391 
53b474e7e590
doc/Host-tools-overview: documented new additions
 Mychaela Falconia <falcon@freecalypso.org> parents: 
311diff
changeset | 198 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: 
311diff
changeset | 199 | 
| 216 
7e3e3a958e3f
doc/Host-tools-overview: updated and simplified
 Mychaela Falconia <falcon@freecalypso.org> parents: 
154diff
changeset | 200 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: 
154diff
changeset | 201 digit of an IMEI number. | 
| 
7e3e3a958e3f
doc/Host-tools-overview: updated and simplified
 Mychaela Falconia <falcon@freecalypso.org> parents: 
154diff
changeset | 202 | 
| 413 
a28c46e5a6ce
doc/Host-tools-overview: mokosrec2bin addition documented
 Mychaela Falconia <falcon@freecalypso.org> parents: 
395diff
changeset | 203 mokosrec2bin This utility converts "moko-style" S-record files (those | 
| 
a28c46e5a6ce
doc/Host-tools-overview: mokosrec2bin addition documented
 Mychaela Falconia <falcon@freecalypso.org> parents: 
395diff
changeset | 204 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: 
395diff
changeset | 205 options) to straight binary. | 
| 
a28c46e5a6ce
doc/Host-tools-overview: mokosrec2bin addition documented
 Mychaela Falconia <falcon@freecalypso.org> parents: 
395diff
changeset | 206 | 
| 216 
7e3e3a958e3f
doc/Host-tools-overview: updated and simplified
 Mychaela Falconia <falcon@freecalypso.org> parents: 
154diff
changeset | 207 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: 
154diff
changeset | 208 phones that exercises their peripheral hardware, primarily their | 
| 
7e3e3a958e3f
doc/Host-tools-overview: updated and simplified
 Mychaela Falconia <falcon@freecalypso.org> parents: 
154diff
changeset | 209 LCD. | 
| 
7e3e3a958e3f
doc/Host-tools-overview: updated and simplified
 Mychaela Falconia <falcon@freecalypso.org> parents: 
154diff
changeset | 210 | 
| 
7e3e3a958e3f
doc/Host-tools-overview: updated and simplified
 Mychaela Falconia <falcon@freecalypso.org> parents: 
154diff
changeset | 211 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: 
154diff
changeset | 212 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: 
154diff
changeset | 213 can also log this dump to a file. | 
| 
7e3e3a958e3f
doc/Host-tools-overview: updated and simplified
 Mychaela Falconia <falcon@freecalypso.org> parents: 
154diff
changeset | 214 | 
| 391 
53b474e7e590
doc/Host-tools-overview: documented new additions
 Mychaela Falconia <falcon@freecalypso.org> parents: 
311diff
changeset | 215 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: 
311diff
changeset | 216 User-phone-tools article. | 
| 
53b474e7e590
doc/Host-tools-overview: documented new additions
 Mychaela Falconia <falcon@freecalypso.org> parents: 
311diff
changeset | 217 | 
| 216 
7e3e3a958e3f
doc/Host-tools-overview: updated and simplified
 Mychaela Falconia <falcon@freecalypso.org> parents: 
154diff
changeset | 218 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: 
154diff
changeset | 219 a method that works despite any bootloader locks, allowing you | 
| 
7e3e3a958e3f
doc/Host-tools-overview: updated and simplified
 Mychaela Falconia <falcon@freecalypso.org> parents: 
154diff
changeset | 220 to reflash locked phones with new firmware with fc-loadtool. | 
| 
7e3e3a958e3f
doc/Host-tools-overview: updated and simplified
 Mychaela Falconia <falcon@freecalypso.org> parents: 
154diff
changeset | 221 The name of the utility is historical: previously it was | 
| 
7e3e3a958e3f
doc/Host-tools-overview: updated and simplified
 Mychaela Falconia <falcon@freecalypso.org> parents: 
154diff
changeset | 222 specific to TFC139 phones (C139s sold with TracFone branding), | 
| 
7e3e3a958e3f
doc/Host-tools-overview: updated and simplified
 Mychaela Falconia <falcon@freecalypso.org> parents: 
154diff
changeset | 223 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: 
154diff
changeset | 224 firmware versions. | 
| 
7e3e3a958e3f
doc/Host-tools-overview: updated and simplified
 Mychaela Falconia <falcon@freecalypso.org> parents: 
154diff
changeset | 225 | 
| 244 
97d6d593ffc6
doc/Host-tools-overview: tiaud-compile and tiaud-mkvol documented
 Mychaela Falconia <falcon@freecalypso.org> parents: 
216diff
changeset | 226 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: 
216diff
changeset | 227 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: 
216diff
changeset | 228 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: 
216diff
changeset | 229 fc-fsio. | 
| 
97d6d593ffc6
doc/Host-tools-overview: tiaud-compile and tiaud-mkvol documented
 Mychaela Falconia <falcon@freecalypso.org> parents: 
216diff
changeset | 230 | 
| 216 
7e3e3a958e3f
doc/Host-tools-overview: updated and simplified
 Mychaela Falconia <falcon@freecalypso.org> parents: 
154diff
changeset | 231 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: 
216diff
changeset | 232 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: 
216diff
changeset | 233 operation performed by tiaud-compile. | 
| 
97d6d593ffc6
doc/Host-tools-overview: tiaud-compile and tiaud-mkvol documented
 Mychaela Falconia <falcon@freecalypso.org> parents: 
216diff
changeset | 234 | 
| 
97d6d593ffc6
doc/Host-tools-overview: tiaud-compile and tiaud-mkvol documented
 Mychaela Falconia <falcon@freecalypso.org> parents: 
216diff
changeset | 235 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: 
216diff
changeset | 236 *.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: 
154diff
changeset | 237 | 
| 
7e3e3a958e3f
doc/Host-tools-overview: updated and simplified
 Mychaela Falconia <falcon@freecalypso.org> parents: 
154diff
changeset | 238 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: 
154diff
changeset | 239 mokoffs, (FFS) images read out of GSM devices with TI-based firmwares. | 
| 
7e3e3a958e3f
doc/Host-tools-overview: updated and simplified
 Mychaela Falconia <falcon@freecalypso.org> parents: 
154diff
changeset | 240 pirffs You can list and extract the FFS content captured as a raw | 
| 
7e3e3a958e3f
doc/Host-tools-overview: updated and simplified
 Mychaela Falconia <falcon@freecalypso.org> parents: 
154diff
changeset | 241 flash image, and even perform a few "forensic" operations along | 
| 
7e3e3a958e3f
doc/Host-tools-overview: updated and simplified
 Mychaela Falconia <falcon@freecalypso.org> parents: 
154diff
changeset | 242 the lines of reading deleted files and seeing the history of | 
| 
7e3e3a958e3f
doc/Host-tools-overview: updated and simplified
 Mychaela Falconia <falcon@freecalypso.org> parents: 
154diff
changeset | 243 FFS modifications. tiffs is the main program, whereas mokoffs | 
| 
7e3e3a958e3f
doc/Host-tools-overview: updated and simplified
 Mychaela Falconia <falcon@freecalypso.org> parents: 
154diff
changeset | 244 and pirffs are convenience wrappers for the common FFS | 
| 
7e3e3a958e3f
doc/Host-tools-overview: updated and simplified
 Mychaela Falconia <falcon@freecalypso.org> parents: 
154diff
changeset | 245 configurations from Openmoko and Pirelli. | 
