2
Copyright 1999-2002 by R. Lievin (roms)
9
Remark: This documentation is written for Linux and for Windows 9x/Me & Windows NT4/2000/XP. Specific topics due to the platform type are showed with [].
10
The Mac OS-X version of TiLP has its own documentation.
17
For the command line parameters, see the manpage (man TiLP) [Linux] or the Manpage.txt file [Win32]. You can also go in the Help menu (ManPage item).
18
The command line parameters are the same for Linux & Windows.
20
Once the program launched, you have:
23
- the information window in the bottom
24
- the local files window (PC files) on the right
25
- the calculator files window on the left.
27
On the right window, you can make a little menu appear by right-clicking on a file.
34
It contains all the functions of the program. A part of these functions are available in the toolbar. The others are more specific. Description of the different menus:
39
* Group File Manager: launch a mini-application you can use for viewing/grouping/ungrouping TI files.
41
* Convert AMS to ROM image: use this function to convert a TI89/92+ FLASH upgrade into a ROM image direcly useable by an emulator.
42
Remark: the converted ROM will not have the boot block.
44
* Unzip: for unzipping archives. By default, archive is extracted in a directory such as '/archive_name/'.
46
* Untar: for untarring archives (only .tgz or .tar.gz).
48
* Save config: save the current configuration in a plain text file (~/.tilp [Linux] or tilp.ini [Win32]). The general options are saved (see below) as well as the hardware and calculator options. THe format of this file is described in the manpage [Linux] or in the 'Manpage.txt' file [Win32]. This file can be manually edited.
50
* Reload config: reloads the previously saved configuration.
52
* Default: configuration like the first run.
54
* Quit: you exit from TiLP.
60
* General: this command give you a box in which you can configure several parameters such as:
61
- the use of the extended group file format: it allows you keep the attribute of the archive (archived or locked variables) whenever you send a variable or a backup previously received with TiLP. Works only with TI89/92+.
62
- if you want diplay the hidden files (files beginning by a dot '.'),
63
- the path mode (full/local): the path mode shows whether a variable must be sended in the current folder (local path) of the calculator or in its folder of origin (full path). Used by TI89/92/92+ calculators.
64
- the file type checking. Used only when sending a TI File Format file. There are 3 possible values which are 'restrictive', 'middle' or 'none'. The 'none' value disables any file checking (dangerous, must be used carefully !). The 'restrictive' value allows you to transfer only a TIxx file type to a TIxx calculator. The 'middle' value allows you to transfer a TIxx file to some other calculators (a 82 file on a TI85 for instance but you can not send a 82 file on a TI92 !).
65
- the sort order for the two window
66
- the confirmation whenever a file is going to be overwritten or deleted. This apply also to variables: TiLP will do a directory listing before sending any variables. If the variable already exists, TiLP will wait an action.
68
* External programs: the dialog box contains the place where TiLP can find a program for unzipping/untarring an archive. By default, the options fields are empty and TiLP uses its own command line parameters. If you fill these fields, TiLP will use your own options. Use them carefully !
69
Linux users: the default cmd line is 'unzip -o -d archive archive.zip' and 'tar xvzf archive.tar.gz'.
70
Windows users: the default program used for both operations is the WinZip CommandLine Add-On utility (~230 Kb) that you can find at http://www.winzip.com. It should be installed in C:\Program Files\WinZip\. Default command line is 'C:\Program Files\WinZip\wzunzip.exe -o -d archive.zip'.
72
* Screen capture: you can choose the image format: PCX (RLE compressed), XPM (UNIX) or JPG (non interlaced). You have also the ability to choose whether you want a full screen or a clipped screen. Useful for a TI89 and ASM programming.
73
PCX is the default image formet.
75
* Font: allows you to choose the font type used in the right window.
77
* Cable: you can choose:
78
- the cable type to use: GreyLink, home-made parallel, home-made serial or BlackLink, fastAVRlink, TIEmulator virtual link, VTi virtual link, TI/PC USB link (TPUlink) or SilverLink (TIGraphLink-USB).
80
- the I/O port according to your previous choice of cable. If you have a serial port card with some strange addresses, you can also give directly the port address.
82
* Calc: all calculators are supported (from TI73 to TI92+). The 'Auto-detect' checkbutton allows TiLP to automatically determine yuor calculator type. THis option works with TI73/83+/89 and 92+ calculators only.
85
-you can adjust the delay value. Not used by the GreyLink and the AVRlink. This value is the time which separates the transmission of two bits. It is not advisable to modify this value but it may be necessary in some cases. Decrease this value increases the speed transmission but decreases the reliablity. Used only for the parallel ans serial/BlackLink cables.
87
- you can also modify the time after an error occured (timeout).
89
* Link speed: for adjusting the baud rate of your AVRlink (the AVRlink must be accorded to this baud rate via the Avrlink Setup Utility).
95
* Ready: test if the calculator is ready.
97
* Terminal: places the calculator in remote control or terminal mode (for TI89/92/92+ only).
99
* Screendump: make a screen capture of the calculator screen in the choosed image format.
101
* Directory list: make a directory listing.
103
* Backup|Send backup: restore the calculator content.
105
* Backup|Receive backup: get a backup of your calculator content. TI89/92+ users: variable attributes are stored that is to say an archived variable will still be archived when backup is restored.
107
* Variable|Send variable: send a variable to the calculator. One or more variables can be sended.
109
* Variable|Receive variable: receive a variable to the calculator. One or more variables can be received. If one variable is selected, it is saved in a single file. If several variables are selected, they are saved in a single group file. To receive several variables in several files, they must be transmitted one by one. Or else, you should use the Ungroup command.
111
* FLASH|Send application: for sending a free FLASH application to a TI73/83+/89/92+ calculator.
113
* FLASH|Send OS: for sending an Operating System to the calculator (also called 'base code') to a TI73/83+/89/92+ calculator.
115
* FLASH|Receive application: if you want to download an application which has been installed on your calculator.
117
* FLASH|Get IDlist: this function replys the ID-list of your calc. It works only with FLASHed TI83+/89/92+ calcs.
119
* ROM|ROM dump: get a ROM image of the calculator. For this, an assembly program is sent and executed on the calculator. It's strongly recommended to do a backup. Some calculators may require a shell for the execution.
121
* ROM|ROM version: displays the ROM version of the calc (TI92 only).
127
This menu is available in the Linux version only.
128
The menu is activated if you have enabled the TiFFEP server support at compilation time (./configure --allow-tiffep-server).
130
* Options: tell to TiLP whether you want plug-ins (TiFFEP) to be loaded at startup or not.
132
* Load: load all plug-ins.
134
* List: display a box with a list of all available plug-ins (TiFFEP query).
135
Plug-ins allows you to edit any variable from any calculator. Actually, only the 89/92/92+ have a plug-in support. If you are interested by programming a plug-in then mail me.
136
These plug-ins are managed via the TiFFEP (Ti File Format Engine & Proxy), a powerful but independant library.
142
* Help: displays this help.
144
* Manpage: display the Linux manpage.
146
* ChangeLog: display the Release file that is to say the file which contains the latest modifications done on TiLP.
148
* Wizard: relaunch the Configuration Wizard.
150
* Thanks: displays the list of people who have contributed to the TiLP project.
152
* About: the copyright and the license agreement.
154
Remark: with the Grey TI Graph Link or the (fast)AVRlink, the transfer status box may show 100% whereas the transfer is in progress. It is due to buffering.
161
The toolbar take back a part of the menubar functions, but there is most specific functions:
163
* Mkdir: make a new directory in the current directory. You must provide a name.
164
* Trash: useful to delete some unused files. Beware, once deleted, you can not retrieve it any longer.
165
* Update: refresh the local files directory list.
169
+========================+
170
| The information window |
171
+========================+
173
This window give you some informations about the variables and files in the 2 upper windows. TiLP display the current working directory (right window) and the memory available or used (depending on the calculator type).
176
+=======================================+
177
| The local files window (right window) |
178
+=======================================+
180
This window displays all the variables of the calculator as well as some useful informations.
181
A popup menu is available whenever you use the right button of the mouse.
184
+=========================================+
185
The calculator files window (left window) |
186
+=========================================+
188
This window displays the current directory and all files which contains. You can change the current directory, the sort order and so on.
191
+=======================+
192
| The right-button menu |
193
+=======================+
195
It appears whenever you click on a file of the right window with the right button of your mouse.
196
It contains most of the command placed in menus and some additionnals items.
201
* Cut: cut a selected file
202
* Copy: copy a selected file
203
* Paste: paste the cutted/copied file
204
* Move to parent dir: move the selected file to the parent directory
205
* Select All: select all files in the window
206
* Unselect all: unselect all files in the window
211
* Unzip: unzip the selected file(s)
212
* Untar: untar the selected file(s), only .tgz/.tar.gz files.
213
* GFM|Group: group selected files into an unique file
214
* GFM|Ungroup: ungroup the selected file
215
* GFM|Open: display the TI file structure
216
* View: try to launch an application capable to view or edit the selected file. TiLP use the TiFFEP (under development) for this so it must be running.
217
* Rename: rename the selected file(s)
218
* Properties: display a lot of informations about the selected TI file (requires the TiFFEP server for this).
219
* Update: refresh the right window
220
* Make new dir: create a new directory
221
* Delete file: delete the selected file(s)
226
* Console: launch a shell (bash [Linux] or DOS [Win32]). Type 'quit' for exiting
228
* Change drive: change the current drive letter [Win32].
231
+===================================================+
232
| Particular use of TiLP depending on the link type |
233
+===================================================+
235
* For the TIEmulator virtual link, the emulator must be started BEFORE TiLP.
237
* For the VTi virtual link, VTi must be launched BEFORE any operation. Next, launch TiLP. If you quit TiLP, VTi must be closed before launching TiLP again.
239
* For the fastAVRlink, think to adjust the baudrate value according to the internal settings of the fastAVRlink (which can be modified with the Avrlink Setup Utility).
241
* For the TI-GRAPH LINK USB: you need drivers you can download at http://lpg.ticalc.org/prj_usb.
244
+=========================================================+
245
| Particular use of TiLP depending on the calculator type |
246
+=========================================================+
248
* For the TI89, TI92 and TI92+, TiLP works as described above. No remarks.
250
* For the TI83, TI86, there is no ready, no remote control functions.
252
* For the TI82/TI85, some functions do not exist: ready, directory list. Others work differently: send/receive backup and send/receive variables.
253
The computer does not initiate the transfer and so, it works in listen mode.
254
For 'receive backup': click the button, the PC waits. Then, on the calc, send the backup.
255
For 'send backup': put the calc in receive mode then click the button.
256
For 'receive vars': click the button, the PC waits. Then, on the calc, send the backup.
257
For 'send vars': put the calc in receive mode then click the button.
261
NB: I hope this documentation helpful and exhaustive. Feel free to mail me for any critics, suggestions ...
262
Remark: TiLP support internationalization. So, if you want translate this
263
documentation in another language then mail me.
267
(c) Copyright 1999-2001, Romain Lievin
268
web: http://lpg.ticalc.org/prj_tilp
269
mail: roms@lpg.ticalc.org