TILP(1)                                                                TILP(1)



[1mNAME[0m
       TiLP - a communication program for TI calculators ('Ti Linking Program'
       or 'Tilp is a Linking Program')

[1mSYNOPSYS[0m
       [1mtilp  [22m[--help]  [--version]  [-h]  [-v]  [-calc=]  [-link=]  [-port=  ]
       [-adr_port=]  [-dev_port=]  [-timeout=]  [-delay=]  [-cmdline]  [-gui=]
       [filename]

[1mDESCRIPTION[0m
       The [1mTiLP [22mprogram allows you to backup, restore and archive variables of
       your  Texas  Intruments  calculator on your computer. It has also addi-
       tional features such as screen dump, remote control, ROM  dump,  FLASH-
       ing.  TiLP is a very complete program. Moreover, you have the same pro-
       gram for all calculator types.

[1mOPTIONS[0m
       The command line of tilp can be  used  for  sending  or  opening  files
       (variables, backup, FLASH apps, OS, ...). For sending one or more file,
       simply pass the filename(s) on  the  command  line  with  the  [1m-cmdline[0m
       option.  If  you  don't  use the [1m-cmdline [22moption, the file will be open
       within the GUI by the Group File Manager.

       It is possible to send one or more files (single/group  file  only)  or
       one  file  which can be a single/group var as well as a backup, a FLASH
       app or an Operating System even. You can not do any  other  operations.
       If  you  want  more  operations,  you  can  use  the  interactive  mode
       ([1m-gui=console[22m).

       Note: options must be passed before the filename !

       [1mtilp [22maccepts the following options:

       [1m-h, --help[0m
              Display a list of all command line options.

       [1m-v, --version[0m
              Output the version info.

       [1m-cmdline[0m
              Send file(s)  without  launching  any  Graphic  User  Interface.
              Informations are displayed in the terminal.

       [1m-gui=  [22mUse  a  specific  graphic  interface.  You  can choose 'console'
              (prompt), or 'gtk' (GTK+).  In console mode, you can enter  some
              commands.  There  are several commands which allow you to do the
              same things that you could do in GUI mode. These  commands  are:
              ready, screen [filename], dirlist [filename], backup [filename],
              restore [filename], send [filename]  (variable,  FLASHapp,  OS),
              receive [filename] and dump [filename] (ROM).

       [1m-calc= [22mSelect  a  calculator type: v200, ti92+, ti92, ti89, ti86, ti85,
              ti83+, ti83, ti82 or ti73.

       [1m-link= [22mSelect a link cable  type:  Grey  TIGraphLink  (tgl),  home-made
              serial  or  Black  TIGraphLink  (ser),  home-made  parallel link
              (par), fastAVRlink (avr), generic virtual link (vtl), TIEmulator
              virtual link (tie), VTi virtual link (vti), TI/PC USB link (tpu)
              or USB TIGraphLink also known as SilverLink (slv).

       [1m-port= [22mSpecify on which port the link cable is plugged on. Can  be  any
              value between 1 and 2, 3 or 4 (depending on link cable).

       [1m-adr_port=[0m
              Optionnal.  Override  value  passed  with -port.  This value can
              represent either a direct address, either a link number, accord-
              ing  to  the  link type. It will override the address associated
              with the port specified in the config  file.   Give  the  direct
              address  of  the parallel port (0x3BC, 0x378 or 0x278) or serial
              port (0x3F8, 0x2F8, 0x3E8 or 0x2E8), depending of the link cable
              type.   Give  the link number of the virtual link (1 -> #0, 2 ->
              #1).  Give the link mode of the TI/PC USB link (1 -> 'raw' mode,
              2 -> 'cooked' mode).

       [1m-dev_port=[0m
              Optionnal.  Override  value passed with -port.  It will override
              the device associated with the  port  specified  in  the  config
              file.   Give  the  serial  port device (/dev/ttyS[0..3]) for the
              Grey TIGraphLink  or  the  fastAVRlink.   Give  the  USB  device
              (/dev/tiglusb[0..3]).

       [1m-timeout=[0m
              in  tenth of seconds (0.1 s). This is the time while the program
              wait a response of the calculator. Once this delay elapsed,  the
              program send a time out error. The default value is 1 seconds.

       [1m-delay=[0m
              in  microseconds.  This is the time which separate the transmis-
              sion of 2 bytes.  The default value is 5 microseconds.  Decrease
              this  value  increase the transfer speed but decrease the relia-
              bility of the transmission.

[1mEXAMPLE[0m
       Quicly send (no gui) an TI89 file with a BlackLink cable on the  second
       serial port (/dev/ttyS1 or COM2); timeout is set to 2s:

       tilp -cmdline -calc=ti89 -link=serial -port=2 -timeout=20   group.89g

[1mCONFIG FILE FORMAT[0m
       This  section describes the format of the .tilp config file which is in
       the home directory of the user (Linux) or the  tilp.ini  file  (Win32).
       The  file  is  separated  into  several  sections (hardware, gui, calc,
       external programs, fonts, screen, misc). But, there is  no  order,  you
       can  write  lines  as you want.  A line preceded by the '#' symbol is a
       comment. Each line has the  following  format:  option=something.   The
       config  file  must  have the 'RC_END' string at end.  Every line can be
       put in any order. Beware: any comment added to the file will  be  over-
       written !  Below is described each option and the possible values:

       [1mversion=  [22mWhich  version  of  TiLP has written the config file. Used to
       display the Release the file and to keep compatibility.

       [1mcalctype= [22mDefines the calculator type.  Choose  one  of  the  following
       value: ti82, ti83, ti83+, ti85, ti86, ti89, ti92, ti92+, v200.

       [1mlinktype=  [22mDefine  the  link  cable  type.  Choose one of the following
       value: TIGraphLink, parallel, serial,  AVRlink,  fastAVRlink,  virtual,
       TiEmulator, VTi, UsbGraphLink, TiPcUsbLink.

       [1mport=  [22mDefine  the port to use. You have to choose one of the following
       value depending on your link cable type and the port you want use: par-
       allel  port  #[1-3],  serial port #[1-4], virtual port #[1-2], USB port
       #[1-4].

       [1mmethod= [22mYou can specify here an I/O management method to use.  You  can
       choose:  automatic, asm, api and driver. Non-expert users should choose
       automatic. The libticables library  will  automatically  determine  the
       best method.

       [1madr_port=  [22mIf  you specify a value, this will override the default set-
       tings associated with the port value.  Define the I/O  address  of  the
       I/O  port to use. It can be 0x3F8 for a serial port or 0x378 for a par-
       allel port for instance.

       [1mserial_device= [22mIf you specify a value, this will override  the  default
       settings  associated  with  the  port value.  Define the device name to
       use.

       [1mbaudrate= [22mIf you have a fastAVRlink cable, you may  have  to  pass  the
       link cable speed. This value must be the same than the cable one.

       [1mtimeout=  [22mwith  the  timeout  value to use in tenth of seconds. Default
       value: 20.

       [1mdelay= [22mwith the delay value  to  use  in  micro-seconds  for  home-made
       cables. Default value: 10

       [1mrts_cts=  [22mEnable  (on)  or  disable  (off)  the  hardware  flow control
       (RTS/CTS method) for the fastAVRlink cable. Disable it can decrease the
       reliability of transfers unless you decrease the link speed. Above 9600
       bauds, flow control is recommended.


       [1mxsize= [22mand [1mysize= [22mGives the X and Y values of the size of the left win-
       dow. Default values: 300 and 400.

       [1mclist_sort=  [22mDefine the sorting method for the right window. Choose one
       of the following value: name, date, size, user, group, attrib

       [1mclist_order= [22mDefine the sorting order  for  the  right  window.  Choose
       either 'up' or 'down'.

       [1mctree_sort=  [22mDefine  the sorting method for the left window. Choose one
       of the following value: name, info, type, size

       [1mctree_order= [22mDefine the sorting  order  for  the  left  window.  Choose
       either 'up' or 'down'.

       [1mfile_display=  [22mDefine  whether  tilp  shows only TI files or all files.
       Possible values are 'ti' or 'all'.

       [1mconfirm= [22mDefine whether tilp ask you confirmation when you delete  some
       files. Use carefully !!! You can choose 'yes' or 'no'

       [1mconsole=  [22mDefine whether tilp will display some verbose informations or
       not. Under Win32, this will display a background console. Values: 'yes'
       or 'no'.

       [1mshow_gui= [22mDisplay the Graphic User Interface in command line mode. Val-
       ues: 'yes' or 'no'.

       [1msingle_or_group= [22mReceive set of files as a single file or as a  grouped
       file. Values: 'single' or 'group'.

       [1muse_checksum= [22mUnimplemented yet.

       [1mpath=  [22mDefine whether tilp sends the variable in its original folder or
       in the locurrent folder. Choose either 'full' or  'local'.  Works  only
       for TI89/92/92+.

       [1mprobe_ti=  [22mDefine  whether  tilp  will try and determine the calculator
       automagically. Works only for TI73, TI83+, TI89 and TI92+  calculators.
       Values: 'yes' or 'no'.

       [1munzip_location= [22mDefine the location of the program to use for unzipping
       archives. Most of the time, the 'unzip' string is enough.

       [1munzip_options= [22mDefine the options to pass on the command  line  of  the
       'unzip'  program. By default, all files of the ZIP archive are deflated
       in a directory such as 'archive_name/'. An option such  as  'unzip_fil-
       ter=*.89* -d tidir/' can be useful too.

       [1mtar_location=  [22mDefine  the  location  of  the program for untarring ar-
       chives. Most of the time, the 'tar' string is enough.

       [1mtar_options= [22mDefine the options to pass on  the  command  line  of  the
       'tar'  program. By default, this option is equal to 'tar_options=xvzf'.

       [1mweb_location= [22mDefine the location of the browser. Mozilla  is  used  by
       default: /usr/bin/mozilla.

       [1mweb_options=  [22mDefine  the  options  to  pass on the command line of the
       'browser' program. By default, there is no option.

       [1mleft_font_name= [22mDefine the font to use in the left window (calc files).
       The font is described by its XFLD (X-Font Logical Description) name.

       [1mright_font_name=  [22mDefine  the font to use in the right window (computer
       files). The font is described  by  its  XFLD  name,  such  as:  -adobe-
       courier-medium-r-*-*-*-125-*-*-*-*-*-*

       [1mscreen_mode=  [22mDefine whether tilp display the entire screen of the cal-
       culator or only the visible part. This option is only useful  for  TI89
       calculators  because  they have a screen which has the same size than a
       TI92 one but only a part is displayed. The other part is  only  useable
       via ASM programming.

       [1mscreen_format=  [22mDefine  the  image format to use for saving screen cap-
       tures. It can be 'jpg' or 'png'. Previous format such as  'xpm',  'pcx'
       or 'bmp' are not supported any longer.

       [1mscreen_blurry= [22mDefine whether the image is saved in B&W or saved like a
       VTi image (dark & light gray). Values: 'yes' or 'no'.

       [1mlocale= [22mOverride the default locale ("C" most of the time). Must  be  a
       string such as 'fr_FR' or 'en _US' for instance.

       [1mworking_dir= [22mContains the directory that TiLP will list at startup. Can
       be changed from the popup menu.

       Think to terminate your config script with the 'RC_END' word !!!


[1mCOPYRIGHT[0m
       Copyright (C) 1999-2004, Romain Lievin.  Permission to use, copy,  mod-
       ify, and distribute this software and its documentation for any purpose
       and without fee is hereby granted, provided that  the  above  copyright
       notice  appear  in  all  copies and that both that copyright notice and
       this permission notice appear in supporting documentation.

       This program and its source code is distributed under the terms of  the
       terms  of the GNU General Public License as published by the Free Soft-
       ware Foundation; either version 2 of the License, or (at  your  option)
       any later version.

       This  program  is  distributed  in the hope that it will be useful, but
       WITHOUT ANY  WARRANTY;  without  even  the  implied  warranty  of  MER-
       CHANTABILITY  or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General
       Public License for more details.

       You should have received a copy of the GNU General Public License along
       with this program; if not, write to the Free Software Foundation, Inc.,
       59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.


[1mSUGGESTIONS AND BUG REPORTS[0m
       The  canonical place to find tilp and some  miscellenaous  informations
       is         at         http://www.tilp.info        (redirected        on
       http://lpg.ticalc.org/prj_tilp/index.php)  You   can   also   look   at
       http://lpg.ticalc.org  and  http://www.ticalc.org for others TI related
       programs for Linux. French  people  can  also  look  at  http://www.ti-
       fr.org.

[1mAUTHOR[0m
       Original author (Linux & Win32): Romain Lievin.

       Mac OS-X port by Julien Blache.

       FreeBSD port by Tijl Coosemans.

[1mTHANKS[0m
       Thanks  to  these persons to have lent me their calculator: Jean-Pierre
       and Thomas (TI92+), Benoit, Philippe and Florence (TI89), Louis (TI86),
       Luc (TI85), Nicolas (TI83), Jean-Philippe and Francois (TI82).  Special
       thanks to Guillaume for her Grey/Gray TIGL link cable.  Thanks to  many
       others (patches, suggestions, ...)

[1mSEE ALSO[0m
       tilp-reg(1)



                                 March 3, 2003                         TILP(1)
