comparison doc/Host-tools-overview @ 23:10b71f01f4ff

doc/Host-tools-overview updated for the current state of the tools
author Mychaela Falconia <falcon@freecalypso.org>
date Sat, 22 Oct 2016 17:16:21 +0000
parents e7502631a0f9
children 3c446058b5a6
comparison
equal deleted inserted replaced
22:aa20bdae9e53 23:10b71f01f4ff
54 the lines of reading deleted files and seeing the history of 54 the lines of reading deleted files and seeing the history of
55 FFS modifications. tiffs is the main program, whereas mokoffs 55 FFS modifications. tiffs is the main program, whereas mokoffs
56 and pirffs are convenience wrappers for the common FFS 56 and pirffs are convenience wrappers for the common FFS
57 configurations from Openmoko and Pirelli. 57 configurations from Openmoko and Pirelli.
58 58
59 fc-getpirimei This utility retrieves the factory-programmed IMEI of a Pirelli
60 DP-L10 phone by quering its running firmware over the RVTMUX
61 interface.
62
63 fc-serterm This tool is a trivial serial terminal program. Its special 59 fc-serterm This tool is a trivial serial terminal program. Its special
64 feature is that any output coming the serial port that isn't 60 feature is that any output coming from the serial port that
65 printable ASCII is displayed as by cat -v. It is useful for 61 isn't printable ASCII is displayed as by cat -v. It is useful
66 talking to serially-interfaced devices that mix ASCII with 62 for talking to serially-interfaced devices that mix ASCII with
67 binary in their serial talk. 63 binary in their serial talk.
68 64
69 The following tools are really just for developers: 65 The following tools are really just for developers:
70 66
71 ctracedec GSM firmwares built in TI's Windows environment (official ones 67 ctracedec GSM firmwares built in TI's Windows environment (official ones
96 contrast, fc-fsio described above also talks to ETM, but it 92 contrast, fc-fsio described above also talks to ETM, but it
97 does so synchronously.) 93 does so synchronously.)
98 94
99 fc-olddump This tool captures a memory dump from a GSM device whose 95 fc-olddump This tool captures a memory dump from a GSM device whose
100 firmware implements the old non-enhanced Test Mode memory read 96 firmware implements the old non-enhanced Test Mode memory read
101 command. It works with Mot C1xx original firmwares. 97 command. It works with TCS211-based firmwares including
98 FreeCalypso Magnetite, as well as Mot C1xx original firmwares.
102 99
103 fc-rgbconv A simple aid for phone UI development that converts RGB color 100 fc-rgbconv A simple aid for phone UI development that converts RGB color
104 values between human-intuitive 8:8:8 format and the 5:6:5 format 101 values between human-intuitive 8:8:8 format and the 5:6:5 format
105 used by the color LCDs in the phones targeted by FreeCalypso. 102 used by the color LCDs in the phones targeted by FreeCalypso.
106 103
117 a hacked-up version of the fw that emits all raster blits 114 a hacked-up version of the fw that emits all raster blits
118 intended for the big LCD on the RVTMUX serial interface, and 115 intended for the big LCD on the RVTMUX serial interface, and
119 this fc-lcdemu utility is a plug-in for rvinterf that actually 116 this fc-lcdemu utility is a plug-in for rvinterf that actually
120 displays these LCD blits in an X11 window. 117 displays these LCD blits in an X11 window.
121 118
122 fc-pirhackinit This fc-pirhackinit utility is highly specific to the 119 fc-fr2tch This hack-utility converts a GSM 06.10 speech sample from the
123 TCS211-on-Pirelli exercise. DO NOT run it against Pirelli's 120 de facto standard libgsm format (which can be recorded with
124 stock firmware, nor is it needed when using our full-source 121 standard tools like SoX) into an uplink play file that can be
125 FreeCalypso firmware. 122 played with the tch play command in fc-shell; see the
123 TCH-bit-access article for more information.
124
125 fc-tch2fr This hack-utility takes a TCH downlink recording produced with
126 the tch record command in fc-shell and converts it to a playable
127 libgsm file which will most likely contain some garbage by
128 disregarding the non-understood DSP status words; see the
129 TCH-bit-access article for more information.