2  *  Parallel port to Keyboard port adapter driver for Linux
 
   4  *  Copyright (c) 1999-2004 Vojtech Pavlik
 
   8  * This program is free software; you can redistribute it and/or modify it
 
   9  * under the terms of the GNU General Public License version 2 as published by
 
  10  * the Free Software Foundation.
 
  14  * To connect an AT or XT keyboard to the parallel port, a fairly simple adapter
 
  17  *  Parallel port            Keyboard port
 
  19  *     +5V --------------------- +5V (4)
 
  22  *     +5V -------|______|--.
 
  24  *     ACK (10) ------------|
 
  26  *     STROBE (1) ---|<|----'
 
  29  *     +5V -------|______|--.
 
  31  *     BUSY (11) -----------|
 
  33  *     AUTOFD (14) --|<|----'
 
  35  *     GND (18-25) ------------- GND (3)
 
  37  * The diodes can be fairly any type, and the resistors should be somewhere
 
  38  * around 5 kOhm, but the adapter will likely work without the resistors,
 
  41  * The +5V source can be taken either from USB, from mouse or keyboard ports,
 
  42  * or from a joystick port. Unfortunately, the parallel port of a PC doesn't
 
  43  * have a +5V pin, and feeding the keyboard from signal pins is out of question
 
  44  * with 300 mA power reqirement of a typical AT keyboard.
 
  47 #include <linux/module.h>
 
  48 #include <linux/parport.h>
 
  49 #include <linux/init.h>
 
  50 #include <linux/serio.h>
 
  52 MODULE_AUTHOR("Vojtech Pavlik <vojtech@ucw.cz>");
 
  53 MODULE_DESCRIPTION("Parallel port to Keyboard port adapter driver");
 
  54 MODULE_LICENSE("GPL");
 
  56 static unsigned int parkbd_pp_no;
 
  57 module_param_named(port, parkbd_pp_no, int, 0);
 
  58 MODULE_PARM_DESC(port, "Parallel port the adapter is connected to (default is 0)");
 
  60 static unsigned int parkbd_mode = SERIO_8042;
 
  61 module_param_named(mode, parkbd_mode, uint, 0);
 
  62 MODULE_PARM_DESC(mode, "Mode of operation: XT = 0/AT = 1 (default)");
 
  64 #define PARKBD_CLOCK    0x01    /* Strobe & Ack */
 
  65 #define PARKBD_DATA     0x02    /* AutoFd & Busy */
 
  67 static int parkbd_buffer;
 
  68 static int parkbd_counter;
 
  69 static unsigned long parkbd_last;
 
  70 static int parkbd_writing;
 
  71 static unsigned long parkbd_start;
 
  73 static struct pardevice *parkbd_dev;
 
  74 static struct serio *parkbd_port;
 
  76 static int parkbd_readlines(void)
 
  78         return (parport_read_status(parkbd_dev->port) >> 6) ^ 2;
 
  81 static void parkbd_writelines(int data)
 
  83         parport_write_control(parkbd_dev->port, (~data & 3) | 0x10);
 
  86 static int parkbd_write(struct serio *port, unsigned char c)
 
  90         if (!parkbd_mode) return -1;
 
  98         parkbd_buffer = c | (((int) (~p & 1)) << 8) | 0x600;
 
 100         parkbd_writelines(2);
 
 105 static void parkbd_interrupt(int irq, void *dev_id, struct pt_regs *regs)
 
 108         if (parkbd_writing) {
 
 110                 if (parkbd_counter && ((parkbd_counter == 11) || time_after(jiffies, parkbd_last + HZ/100))) {
 
 114                         parkbd_writelines(3);
 
 118                 parkbd_writelines(((parkbd_buffer >> parkbd_counter++) & 1) | 2);
 
 120                 if (parkbd_counter == 11) {
 
 124                         parkbd_writelines(3);
 
 129                 if ((parkbd_counter == parkbd_mode + 10) || time_after(jiffies, parkbd_last + HZ/100)) {
 
 134                 parkbd_buffer |= (parkbd_readlines() >> 1) << parkbd_counter++;
 
 136                 if (parkbd_counter == parkbd_mode + 10)
 
 137                         serio_interrupt(parkbd_port, (parkbd_buffer >> (2 - parkbd_mode)) & 0xff, 0, regs);
 
 140         parkbd_last = jiffies;
 
 143 static int parkbd_getport(void)
 
 147         pp = parport_find_number(parkbd_pp_no);
 
 150                 printk(KERN_ERR "parkbd: no such parport\n");
 
 154         parkbd_dev = parport_register_device(pp, "parkbd", NULL, NULL, parkbd_interrupt, PARPORT_DEV_EXCL, NULL);
 
 155         parport_put_port(pp);
 
 160         if (parport_claim(parkbd_dev)) {
 
 161                 parport_unregister_device(parkbd_dev);
 
 165         parkbd_start = jiffies;
 
 170 static struct serio * __init parkbd_allocate_serio(void)
 
 174         serio = kzalloc(sizeof(struct serio), GFP_KERNEL);
 
 176                 serio->id.type = parkbd_mode;
 
 177                 serio->write = parkbd_write,
 
 178                 strlcpy(serio->name, "PARKBD AT/XT keyboard adapter", sizeof(serio->name));
 
 179                 snprintf(serio->phys, sizeof(serio->phys), "%s/serio0", parkbd_dev->port->name);
 
 185 static int __init parkbd_init(void)
 
 189         err = parkbd_getport();
 
 193         parkbd_port = parkbd_allocate_serio();
 
 195                 parport_release(parkbd_dev);
 
 199         parkbd_writelines(3);
 
 201         serio_register_port(parkbd_port);
 
 203         printk(KERN_INFO "serio: PARKBD %s adapter on %s\n",
 
 204                         parkbd_mode ? "AT" : "XT", parkbd_dev->port->name);
 
 209 static void __exit parkbd_exit(void)
 
 211         parport_release(parkbd_dev);
 
 212         serio_unregister_port(parkbd_port);
 
 213         parport_unregister_device(parkbd_dev);
 
 216 module_init(parkbd_init);
 
 217 module_exit(parkbd_exit);