Kernel driver i2c-parport

통합 병렬 포트 I2C 드라이버

작성자는 Jean Delvare <[email protected]>입니다. `i2c-parport`는 Philips, Velleman, ELV 등이 만든 여러 I2C-over-parallel-port 어댑터를 위한 통합 드라이버입니다.

이 드라이버는 기존의 개별 드라이버 `i2c-philips-par`, `i2c-elv`, `i2c-velleman`, `video/i2c-parport`를 대체합니다. 마지막 드라이버는 이 드라이버와 같지 않으며 자가 제작 teletext 어댑터 전용이었습니다.

현재 `type=0`부터 `type=8`까지 아홉 가지 배선을 지원합니다.

장치마다 핀 배치가 다르므로 `type` 모듈 매개변수로 보유한 장치를 알려야 합니다. 자동 감지 방법은 없습니다. 필요하면 다른 핀 배치도 쉽게 추가할 수 있습니다.

이전 커널은 Philips용 `type=0`을 기본값으로 사용했지만, 이제 `type` 매개변수가 없으면 드라이버 초기화가 실패합니다.

SMBus alert 선을 병렬 포트의 인터럽트 핀에 올바르게 연결한 어댑터에서는 SMBus alert를 지원합니다.

=========================
Kernel driver i2c-parport
=========================

Author: Jean Delvare <[email protected]>

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
 * (type=8) VCT-jig

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.

Analog Devices형 기본 회로

자가 제작 I2C-over-parallel-port 어댑터를 위한 예제 회로이며, 회로 설계의 공은 Sylvain Munaut에게 있습니다.

장치 측 SCL은 10kΩ 풀업과 오픈 컬렉터 74HC05 인버터를 거쳐 PC 병렬 포트 핀 2의 출력으로 구동합니다. SDA는 10kΩ 풀업을 두고, 입력 감지 경로는 핀 13, 출력 구동 경로는 74HC05를 거쳐 핀 3에 연결합니다.

PC 측 출력 경로에도 10kΩ 저항과 접지 연결을 사용하며, 회로의 공통 기준은 병렬 포트 GND입니다.

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

회로 주의사항과 ELV 호환 배선

이 회로는 Analog Devices 평가 보드에서 실제 사용하는 핀 배치와 전자 회로입니다. 모든 인버터는 오픈 컬렉터 출력인 74HC05여야 하며, 모든 저항은 10kΩ입니다. 병렬 포트 핀 18~25는 GND에 연결합니다.

드라이버가 핀을 high로 구동하므로 핀 4~9(D2~D7)를 Vdd로 사용할 수 있습니다. ADM1032 평가 보드는 D4~D7을 사용합니다. 다만 병렬 포트에서 끌어올 수 있는 전류는 제한적입니다.

연결된 모든 전원선은 반드시 같은 상태로 구동해야 합니다. 그렇지 않으면 출력 버퍼를 단락시킵니다. 초기화 전 데이터선 상태를 알 수 없으므로 `i2c-parport` 모듈을 로드한 뒤 I2C 어댑터를 꽂는 것이 안전할 수 있습니다.

이 회로는 5V입니다. 기본 회로에서는 SCL을 읽을 수 없어 엄밀히 표준을 준수하지 않습니다. SDA 입력 부분을 복사해 다른 입력 핀에 연결하면 SCL 읽기를 쉽게 추가할 수 있으며, 그러면 ELV 호환 핀 배치가 됩니다.

ELV 호환 배선은 SCL 입력을 pin 15, SCL 출력을 pin 2, SDA 입력을 pin 10, SDA 출력을 pin 3에 둡니다. 각 버스선은 10kΩ로 Vdd에 풀업하고 출력은 74HC05 오픈 컬렉터 인버터로 구동합니다.

가능하면 기존 어댑터와 같은 핀 배치를 사용해야 코드 변경 없이 동작시킬 수 있습니다.

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 resistors 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.

비슷하지만 다른 드라이버

이 드라이버는 i2c 패키지의 `i2c-pport` 드라이버와 같지 않습니다. `i2c-pport`는 현대 병렬 포트 기능을 사용하므로 추가 전자 회로가 필요 없지만 다른 제약이 있으며 당시 Linux 2.6으로 포팅되지 않았습니다.

또한 lm_sensors 패키지의 `i2c-pcf-epp`와도 다릅니다. `i2c-pcf-epp`는 병렬 포트를 I2C 버스로 직접 사용하지 않고 외부 I2C 버스 마스터를 제어하는 데 사용합니다. 이 드라이버 역시 당시 Linux 2.6으로 포팅되지 않았습니다.

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.

Velleman 어댑터의 레거시 자료

Velleman 웹사이트는 `http://www.velleman.be/`이고 K8000 Howto는 `http://howto.htlw16.ac.at/k8000-howto.html`에 있습니다.

이 프로젝트는 Velleman K8000과 K8005용 새 라이브러리 `LIBK8000 v1.99.1` 및 `LIBK8005 v0.21`로 이어졌습니다.

이 라이브러리를 사용하면 `/dev/velleman`을 통해 원래 Velleman 소프트웨어의 `SetIOchannel`, `ReadADchannel`, `SendStepCCWFull` 같은 간단한 명령으로 K8000 인터페이스 카드와 K8005 스테퍼 모터 카드를 제어할 수 있습니다.

관련 자료 주소는 `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/`입니다.

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 어댑터

JP1 프로젝트는 배터리실의 6핀 점퍼를 통해 내부 구성 EEPROM이 연결된 I2C 버스를 외부에 노출하는 여러 리모컨을 다룹니다.

자세한 프로젝트 정보는 `http://www.hifi-remote.com/jp1/`에서, 단순한 병렬 포트 하드웨어의 세부 사항은 `http://www.hifi-remote.com/jp1/hardware.shtml`에서 확인할 수 있습니다.

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