OpenCores
URL https://opencores.org/ocsvn/or1k/or1k/trunk

Subversion Repositories or1k

[/] [or1k/] [trunk/] [linux/] [linux-2.4/] [Documentation/] [tipar.txt] - Blame information for rev 1765

Details | Compare with Previous | View Log

Line No. Rev Author Line
1 1275 phoenix
 
2
                Parallel link cable for Texas Instruments handhelds
3
                ===================================================
4
 
5
 
6
Author: Romain Lievin
7
Homepage: http://lpg.ticalc.org/prj_tidev
8
 
9
 
10
INTRODUCTION:
11
 
12
This is a driver for the very common home-made parallel link cable, a cable
13
designed for connecting TI8x/9x graphing calculators (handhelds) to a computer
14
or workstation (Alpha, Sparc). Given that driver is built on parport, the
15
parallel port abstraction layer, this driver is independant of the platform.
16
 
17
It can also be used with another device plugged on the same port (such as a
18
ZIP drive). I have a 100MB ZIP and both of them work fine !
19
 
20
If you need more information, please visit the 'TI drivers' homepage at the URL
21
above.
22
 
23
WHAT YOU NEED:
24
 
25
A TI calculator of course and a program capable to communicate with your
26
calculator.
27
TiLP will work for sure (since I am his developer !). yal92 may be able to use
28
it by changing tidev for tipar (may require some hacking...).
29
 
30
HOW TO USE IT:
31
 
32
You must have first compiled parport support (CONFIG_PARPORT_DEV): either
33
compiled in your kernel, either as a module.
34
This driver supports the new device hierarchy (devfs).
35
 
36
Next, (as root) from your appropriate modules directory (lib/modules/2.5.XX):
37
 
38
       modprobe parport
39
       insmod tipar.o
40
 
41
If it is not already there (it usually is), create the device:
42
 
43
       mknod /dev/tipar0 c 115 0
44
       mknod /dev/tipar1 c 115 1
45
       mknod /dev/tipar2 c 115 2
46
 
47
You will have to set permissions on this device to allow you to read/write
48
from it:
49
 
50
       chmod 666 /dev/tipar?
51
 
52
Now you are ready to run a linking program such as TiLP. Be sure to configure
53
it properly (RTFM).
54
 
55
MODULE PARAMETERS:
56
 
57
  You can set these with:  insmod tipar NAME=VALUE
58
  There is currently no way to set these on a per-cable basis.
59
 
60
  NAME: timeout
61
  TYPE: integer
62
  DEFAULT: 15
63
  DESC: Timeout value in tenth of seconds. If no data is available once this
64
        time has expired then the driver will return with a timeout error.
65
 
66
  NAME: delay
67
  TYPE: integer
68
  DEFAULT: 10
69
  DESC: Inter-bit delay in micro-seconds. An lower value gives an higher data
70
        rate but makes transmission less reliable.
71
 
72
These parameters can be changed at run time by any program via ioctl(2) calls
73
as listed in ./include/linux/ticable.h
74
Rather than write 50 pages describing the ioctl() and so on, it is
75
perhaps more useful you look at ticables library (dev_link.c) that demonstrates
76
how to use them, and demonstrates the features of the driver. This is
77
probably a lot more useful to people interested in writing applications
78
that will be using this driver.
79
 
80
QUIRKS/BUGS:
81
 
82
None.
83
 
84
HOW TO CONTACT US:
85
 
86
You can email me at roms@lpg.ticalc.org. Please prefix the subject line
87
with "TIPAR: " so that I am certain to notice your message.
88
You can also mail JB at jb@jblache.org. He packaged these drivers for Debian.
89
 
90
CREDITS:
91
 
92
The code is based on tidev.c & parport.c.
93
The driver has been developed independantly of Texas Instruments.

powered by: WebSVN 2.1.0

© copyright 1999-2024 OpenCores.org, equivalent to Oliscience, all rights reserved. OpenCores®, registered trademark.