Introduction
~~~~~~~~~~~~
This is a simple Amiga keyboard driver  for  the  Catweasel  MK3  PCI/Zorro
flipper board. It allows the use of the preferred Amiga keyboards e.g. on a
Pegasos. It was losely based  on  a  framework  sent  to  me  by  Christian
Hattemer.  Binaries  for  both MorphOS (PPC) and 68k are included. This new
version also supports the Catweasel in an original Amiga Zorro slots (which
makes  sense,  if  you  have  an  A1200T  with an adapter to only connect a
standard PS/2 PC keyboard, which sucks).

Either my Catweasel is broken, or something else interfers,  but  I  tested
two  different  keyboards  and none of them worked flawelessly (random data
returned occassionally). Jens Schönfeld and I are still trying to find  the
cause  for  this.  Some  people  said that it worked okay though. So please
report any problems.


Requirements
~~~~~~~~~~~~
- Pegasos with MorphOS:
  - Catweasel MK3 in an PCI slot
  - OpenPCI library V1.1 or higher

- *mithlon:
  - Catweasel MK3 in an PCI slot
  - OpenPCI library V1.1 or higher
  Please note that the current version of the input.device under *mithlon
  will not support automatic keyrepeat.

- AmigaOS
  - Catweasel MK3 in an Zorro slot OR
  - Catweasel MK3 in an PCI slot AND a PCI board that's supported with
    OpenPCI (like Prometheus, GRex, unfortunately NOT Mediator).
  - MorphOS input.device replacement as included in Poseidon USB stack.
    Without this, you won't get automatic key repeat.


Usage
~~~~~
Just start it in a shell. Press Ctrl-C to terminate. If this works  nicely,
you might want to add it to your user-startup (don't forget "Run >NIL:").

The command line template is:
NOSOFTINT/S,PRI/N,RESETDELAY=DELAY/K/N,NORESETHANDLER/S

NOSOFTINT/S: By giving the NOSOFTINT switch, the command  will  not  use  a
SoftInt  as  it  was  the case with V1.0. You decide, but using the SoftInt
usually works better with multitasking.

PRI/N: The PRI option allows you to set the priority  of  the  task  that's
sending  the  input  events to the input.device. It is recommended that you
set this to 20.

RESETDELAY=DELAY/K/N:  Number   of   seconds   to   wait   after   pressing
Ctrl-LAmiga-RAmiga before rebooting the machine. Defaults to 10 seconds. If
no keyboard reset handler is installed or  NORESETHANDLER  was  given,  the
reboot will happen immediately.

NORESETHANDLER/S: If given, no reset handlers are called and the reset will
happen immediately.


History
~~~~~~~
V2.1 (24-Aug-03):
  - Added the four command line options.

V2.0 (19-Aug-03):
  - Added support for Zorro aswell (autodetects either Zorro or PCI)
  - Changed internal handling to SoftInts using timer.device. That way, the
    keyboard will still correctly react under high CPU load.
  - Added support for keyboard reset (including reset handlers catching).
  - Fixed spelling mistakes (Catweazle instead of Catweasel) as requested
    by Jens.

V1.0 (15-Aug-03):
  - Initial release.


Contact address
~~~~~~~~~~~~~~~
Any mail, comments or donations welcome:

Chris Hodges                    Account: 359 68 63
Kennedystr. 8                   BLZ    : 700 530 70
D-82178 Puchheim                Bank   : Sparkasse Fürstenfeldbruck
Germany
Tel.: +49-89/80001543           WWW: http://www.platon42.de/
Email: hodgesin.tum.de         IRC: platon42 on EfNet

PERMISSION  UID  GID    PACKED    SIZE  RATIO METHOD CRC     STAMP     NAME
---------- ----------- ------- ------- ------ ---------- ------------ ----------
[generic]                  555    1192  46.6% -lh5- 33c1 Sep 21  1996 CW-Keyboard.info
[generic]                 2870    4616  62.2% -lh5- 7e96 Aug 24  2003 CW-Keyboard/cw-keyboard.68k
[generic]                 5596   13224  42.3% -lh5- 148f Aug 24  2003 CW-Keyboard/cw-keyboard.elf
[generic]                 1793    3610  49.7% -lh5- e261 Aug 24  2003 CW-Keyboard/CW-Keyboard.readme
---------- ----------- ------- ------- ------ ---------- ------------ ----------
 Total         4 files   10814   22642  47.8%            Nov 16 19:48