|  | Kernel driver i2c-parport | 
|  |  | 
|  | Author: Jean Delvare <khali@linux-fr.org> | 
|  |  | 
|  | This is a unified driver for several i2c-over-parallel-port adapters, | 
|  | such as the ones made by Philips, Velleman or ELV. This driver is | 
|  | meant as a replacement for the older, individual drivers: | 
|  | * i2c-philips-par | 
|  | * i2c-elv | 
|  | * i2c-velleman | 
|  | * video/i2c-parport (NOT the same as this one, dedicated to home brew | 
|  | teletext adapters) | 
|  |  | 
|  | It currently supports the following devices: | 
|  | * (type=0) Philips adapter | 
|  | * (type=1) home brew teletext adapter | 
|  | * (type=2) Velleman K8000 adapter | 
|  | * (type=3) ELV adapter | 
|  | * (type=4) Analog Devices ADM1032 evaluation board | 
|  | * (type=5) Analog Devices evaluation boards: ADM1025, ADM1030, ADM1031 | 
|  | * (type=6) Barco LPT->DVI (K5800236) adapter | 
|  | * (type=7) One For All JP1 parallel port adapter | 
|  |  | 
|  | These devices use different pinout configurations, so you have to tell | 
|  | the driver what you have, using the type module parameter. There is no | 
|  | way to autodetect the devices. Support for different pinout configurations | 
|  | can be easily added when needed. | 
|  |  | 
|  | Earlier kernels defaulted to type=0 (Philips).  But now, if the type | 
|  | parameter is missing, the driver will simply fail to initialize. | 
|  |  | 
|  | SMBus alert support is available on adapters which have this line properly | 
|  | connected to the parallel port's interrupt pin. | 
|  |  | 
|  |  | 
|  | Building your own adapter | 
|  | ------------------------- | 
|  |  | 
|  | If you want to build you own i2c-over-parallel-port adapter, here is | 
|  | a sample electronics schema (credits go to Sylvain Munaut): | 
|  |  | 
|  | Device                                                      PC | 
|  | Side          ___________________Vdd (+)                    Side | 
|  | |    |         | | 
|  | ---  ---       --- | 
|  | | |  | |       | | | 
|  | |R|  |R|       |R| | 
|  | | |  | |       | | | 
|  | ---  ---       --- | 
|  | |    |         | | 
|  | |    |    /|   | | 
|  | SCL  ----------x--------o |-----------x-------------------  pin 2 | 
|  | |    \|   |       | | 
|  | |         |       | | 
|  | |   |\    |       | | 
|  | SDA  ----------x----x---| o---x---------------------------  pin 13 | 
|  | |        |/            | | 
|  | |                      | | 
|  | |         /|           | | 
|  | ---------o |----------------x--------------  pin 3 | 
|  | \|           |    | | 
|  | |    | | 
|  | ---  --- | 
|  | | |  | | | 
|  | |R|  |R| | 
|  | | |  | | | 
|  | ---  --- | 
|  | |    | | 
|  | ###  ### | 
|  | GND  GND | 
|  |  | 
|  | Remarks: | 
|  | - This is the exact pinout and electronics used on the Analog Devices | 
|  | evaluation boards. | 
|  | /| | 
|  | - All inverters -o |- must be 74HC05, they must be open collector output. | 
|  | \| | 
|  | - All resitors are 10k. | 
|  | - Pins 18-25 of the parallel port connected to GND. | 
|  | - Pins 4-9 (D2-D7) could be used as VDD is the driver drives them high. | 
|  | The ADM1032 evaluation board uses D4-D7. Beware that the amount of | 
|  | current you can draw from the parallel port is limited. Also note that | 
|  | all connected lines MUST BE driven at the same state, else you'll short | 
|  | circuit the output buffers! So plugging the I2C adapter after loading | 
|  | the i2c-parport module might be a good safety since data line state | 
|  | prior to init may be unknown. | 
|  | - This is 5V! | 
|  | - Obviously you cannot read SCL (so it's not really standard-compliant). | 
|  | Pretty easy to add, just copy the SDA part and use another input pin. | 
|  | That would give (ELV compatible pinout): | 
|  |  | 
|  |  | 
|  | Device                                                      PC | 
|  | Side          ______________________________Vdd (+)         Side | 
|  | |    |            |    | | 
|  | ---  ---          ---  --- | 
|  | | |  | |          | |  | | | 
|  | |R|  |R|          |R|  |R| | 
|  | | |  | |          | |  | | | 
|  | ---  ---          ---  --- | 
|  | |    |            |    | | 
|  | |    |      |\    |    | | 
|  | SCL  ----------x--------x--| o---x------------------------  pin 15 | 
|  | |   |  |/         | | 
|  | |   |             | | 
|  | |   |   /|        | | 
|  | |   ---o |-------------x--------------  pin 2 | 
|  | |       \|        |    | | 
|  | |                 |    | | 
|  | |                 |    | | 
|  | |      |\         |    | | 
|  | SDA  ---------------x---x--| o--------x-------------------  pin 10 | 
|  | |  |/              | | 
|  | |                  | | 
|  | |   /|             | | 
|  | ---o |------------------x---------  pin 3 | 
|  | \|             |    | | 
|  | |    | | 
|  | ---  --- | 
|  | | |  | | | 
|  | |R|  |R| | 
|  | | |  | | | 
|  | ---  --- | 
|  | |    | | 
|  | ###  ### | 
|  | GND  GND | 
|  |  | 
|  |  | 
|  | If possible, you should use the same pinout configuration as existing | 
|  | adapters do, so you won't even have to change the code. | 
|  |  | 
|  |  | 
|  | Similar (but different) drivers | 
|  | ------------------------------- | 
|  |  | 
|  | This driver is NOT the same as the i2c-pport driver found in the i2c | 
|  | package. The i2c-pport driver makes use of modern parallel port features so | 
|  | that you don't need additional electronics. It has other restrictions | 
|  | however, and was not ported to Linux 2.6 (yet). | 
|  |  | 
|  | This driver is also NOT the same as the i2c-pcf-epp driver found in the | 
|  | lm_sensors package. The i2c-pcf-epp driver doesn't use the parallel port as | 
|  | an I2C bus directly. Instead, it uses it to control an external I2C bus | 
|  | master. That driver was not ported to Linux 2.6 (yet) either. | 
|  |  | 
|  |  | 
|  | Legacy documentation for Velleman adapter | 
|  | ----------------------------------------- | 
|  |  | 
|  | Useful links: | 
|  | Velleman                http://www.velleman.be/ | 
|  | Velleman K8000 Howto    http://howto.htlw16.ac.at/k8000-howto.html | 
|  |  | 
|  | The project has lead to new libs for the Velleman K8000 and K8005: | 
|  | LIBK8000 v1.99.1 and LIBK8005 v0.21 | 
|  | With these libs, you can control the K8000 interface card and the K8005 | 
|  | stepper motor card with the simple commands which are in the original | 
|  | Velleman software, like SetIOchannel, ReadADchannel, SendStepCCWFull and | 
|  | many more, using /dev/velleman. | 
|  | http://home.wanadoo.nl/hihihi/libk8000.htm | 
|  | http://home.wanadoo.nl/hihihi/libk8005.htm | 
|  | http://struyve.mine.nu:8080/index.php?block=k8000 | 
|  | http://sourceforge.net/projects/libk8005/ | 
|  |  | 
|  |  | 
|  | One For All JP1 parallel port adapter | 
|  | ------------------------------------- | 
|  |  | 
|  | The JP1 project revolves around a set of remote controls which expose | 
|  | the I2C bus their internal configuration EEPROM lives on via a 6 pin | 
|  | jumper in the battery compartment. More details can be found at: | 
|  |  | 
|  | http://www.hifi-remote.com/jp1/ | 
|  |  | 
|  | Details of the simple parallel port hardware can be found at: | 
|  |  | 
|  | http://www.hifi-remote.com/jp1/hardware.shtml |