1 |
1275 |
phoenix |
-------------------------------------------------------------------------
|
2 |
|
|
Readme for Linux device driver for the Texas Instruments SilverLink cable
|
3 |
|
|
-------------------------------------------------------------------------
|
4 |
|
|
|
5 |
|
|
Author: Romain Liévin & Julien Blache
|
6 |
|
|
Homepage: http://lpg.ticalc.org/prj_usb
|
7 |
|
|
|
8 |
|
|
INTRODUCTION:
|
9 |
|
|
|
10 |
|
|
This is a driver for the TI-GRAPH LINK USB (aka SilverLink) cable, a cable
|
11 |
|
|
designed by TI for connecting their TI8x/9x calculators to a computer
|
12 |
|
|
(PC or Mac usually).
|
13 |
|
|
|
14 |
|
|
If you need more information, please visit the 'SilverLink drivers' homepage
|
15 |
|
|
at the above URL.
|
16 |
|
|
|
17 |
|
|
WHAT YOU NEED:
|
18 |
|
|
|
19 |
|
|
A TI calculator of course and a program capable to communicate with your
|
20 |
|
|
calculator.
|
21 |
|
|
TiLP will work for sure (since I am his developer !). yal92 may be able to use
|
22 |
|
|
it by changing tidev for tiglusb (may require some hacking...).
|
23 |
|
|
|
24 |
|
|
HOW TO USE IT:
|
25 |
|
|
|
26 |
|
|
You must have first compiled USB support, support for your specific USB host
|
27 |
|
|
controller (UHCI or OHCI).
|
28 |
|
|
|
29 |
|
|
Next, (as root) from your appropriate modules directory (lib/modules/2.5.XX):
|
30 |
|
|
|
31 |
|
|
insmod usb/usbcore.o
|
32 |
|
|
insmod usb/usb-uhci.o insmod usb/ohci-hcd.o
|
33 |
|
|
insmod tiglusb.o
|
34 |
|
|
|
35 |
|
|
If it is not already there (it usually is), create the device:
|
36 |
|
|
|
37 |
|
|
mknod /dev/tiglusb0 c 115 16
|
38 |
|
|
|
39 |
|
|
You will have to set permissions on this device to allow you to read/write
|
40 |
|
|
from it:
|
41 |
|
|
|
42 |
|
|
chmod 666 /dev/tiglusb0
|
43 |
|
|
|
44 |
|
|
Now you are ready to run a linking program such as TiLP. Be sure to configure
|
45 |
|
|
it properly (RTFM).
|
46 |
|
|
|
47 |
|
|
MODULE PARAMETERS:
|
48 |
|
|
|
49 |
|
|
You can set these with: insmod tiglusb NAME=VALUE
|
50 |
|
|
There is currently no way to set these on a per-cable basis.
|
51 |
|
|
|
52 |
|
|
NAME: timeout
|
53 |
|
|
TYPE: integer
|
54 |
|
|
DEFAULT: 15
|
55 |
|
|
DESC: Timeout value in tenth of seconds. If no data is available once this
|
56 |
|
|
time has expired then the driver will return with a timeout error.
|
57 |
|
|
|
58 |
|
|
QUIRKS:
|
59 |
|
|
|
60 |
|
|
The following problem seems to be specific to the link cable since it appears
|
61 |
|
|
on all platforms (Linux, Windows, Mac OS-X).
|
62 |
|
|
|
63 |
|
|
In some very particular cases, the driver returns with success but
|
64 |
|
|
without any data. The application should retry a read operation at least once.
|
65 |
|
|
|
66 |
|
|
HOW TO CONTACT US:
|
67 |
|
|
|
68 |
|
|
You can email me at roms@lpg.ticalc.org. Please prefix the subject line
|
69 |
|
|
with "TIGLUSB: " so that I am certain to notice your message.
|
70 |
|
|
You can also mail JB at jb@jblache.org: he has written the first release of
|
71 |
|
|
this driver but he better knows the Mac OS-X driver.
|
72 |
|
|
|
73 |
|
|
CREDITS:
|
74 |
|
|
|
75 |
|
|
The code is based on dabusb.c, printer.c and scanner.c !
|
76 |
|
|
The driver has been developed independantly of Texas Instruments.
|