This commit was manufactured by cvs2svn to create tag
[linux-2.6.git] / Documentation / tipar.txt
index 67133ba..773b9a2 100644 (file)
@@ -4,7 +4,7 @@
 
 
 Author: Romain Lievin
-Homepage: http://lpg.ticalc.org/prj_tidev/index.html
+Homepage: http://lpg.ticalc.org/prj_dev
 
 
 INTRODUCTION:
@@ -12,30 +12,31 @@ INTRODUCTION:
 This is a driver for the very common home-made parallel link cable, a cable 
 designed for connecting TI8x/9x graphing calculators (handhelds) to a computer
 or workstation (Alpha, Sparc). Given that driver is built on parport, the 
-parallel port abstraction layer, this driver is architecture-independent.
+parallel port abstraction layer, this driver is independent of the platform.
 
 It can also be used with another device plugged on the same port (such as a
-ZIP drive). I have a 100MB ZIP and both of them work fine!
+ZIP drive). I have a 100MB ZIP and both of them work fine !
 
 If you need more information, please visit the 'TI drivers' homepage at the URL
 above.
 
 WHAT YOU NEED:
 
-A TI calculator and a program capable of communicating with your calculator.
-
-TiLP will work for sure (since I am its developer!). yal92 may be able to use
+A TI calculator of course and a program capable to communicate with your 
+calculator.
+TiLP will work for sure (since I am his developer !). yal92 may be able to use
 it by changing tidev for tipar (may require some hacking...).
 
 HOW TO USE IT:
 
 You must have first compiled parport support (CONFIG_PARPORT_DEV): either 
 compiled in your kernel, either as a module. 
+This driver supports the new device hierarchy (devfs).
 
-Next, (as root):
+Next, (as root) from your appropriate modules directory (lib/modules/2.5.XX):
 
        modprobe parport
-       modprobe tipar
+       insmod tipar.o
 
 If it is not already there (it usually is), create the device:
 
@@ -46,14 +47,14 @@ If it is not already there (it usually is), create the device:
 You will have to set permissions on this device to allow you to read/write
 from it:
 
-       chmod 666 /dev/tipar[0..2]
+       chmod 666 /dev/tipar?
        
 Now you are ready to run a linking program such as TiLP. Be sure to configure 
 it properly (RTFM).
        
 MODULE PARAMETERS:
 
-  You can set these with:  modprobe tipar NAME=VALUE
+  You can set these with:  insmod tipar NAME=VALUE
   There is currently no way to set these on a per-cable basis.
 
   NAME: timeout
@@ -65,12 +66,11 @@ MODULE PARAMETERS:
   NAME: delay
   TYPE: integer
   DEFAULT: 10
-  DESC: Inter-bit delay in micro-seconds. A lower value gives an higher data
+  DESC: Inter-bit delay in micro-seconds. An lower value gives an higher data 
        rate but makes transmission less reliable.
 
 These parameters can be changed at run time by any program via ioctl(2) calls 
-as listed in ./include/linux/ticable.h.
-
+as listed in ./include/linux/ticable.h
 Rather than write 50 pages describing the ioctl() and so on, it is
 perhaps more useful you look at ticables library (dev_link.c) that demonstrates
 how to use them, and demonstrates the features of the driver. This is