summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--plum-tastatur/INSTALL.txt26
-rw-r--r--plum-tastatur/README.txt75
-rwxr-xr-xplum-tastatur/enable-plum236
3 files changed, 337 insertions, 0 deletions
diff --git a/plum-tastatur/INSTALL.txt b/plum-tastatur/INSTALL.txt
new file mode 100644
index 0000000..5efe8fd
--- /dev/null
+++ b/plum-tastatur/INSTALL.txt
@@ -0,0 +1,26 @@
+
+ Treiber zur Benutzung einer PLUM-Tastatur als Matrixtastatur
+ Hans-Christoph Wirth <hcw*at*gmx*dot*de>
+
+* Installation unter Linux
+
+ Der Treiber besteht aus einem Perlskript, welches die gerade aktive
+ Belegung mittels xmodmap ausliest und verdreht wieder setzt. Es
+ gibt keine (zuverlässige) Methode zu verhindern, dass dieser Vorgang
+ zweimal ausgeführt wird; das Ergebnis wäre eine unbenutzbare
+ Tastatureingabe. Daher sind Vorkehrungen zu treffen, im Fehlerfall
+ eine nutzbare Tastaturbelegung etwa mit der Maus wiederherstellbar
+ zu machen; ein Icon auf dem Desktop, welches einen Befehl der Art
+ "xmodmap $HOME/.xmodmap" zur Ausführung bringt, ist dafür
+ ausreichend.
+
+ 1. Einstellen des gewünschten Layouts für die QWERT-Tastatur (mit
+ xmodmap o.ä.)
+
+ 2. Gemäß obiger Anleitung eine Strategie zum Zurückschalten
+ zurechtlegen.
+
+ 3. Das Skript "enable-plum" ohne Parameter aufrufen.
+
+ Zu Testzwecken kann "enable-plum -n" aufgerufen werden, was die
+ Befehle nur anzeigt, aber nicht ausführt.
diff --git a/plum-tastatur/README.txt b/plum-tastatur/README.txt
new file mode 100644
index 0000000..37c005b
--- /dev/null
+++ b/plum-tastatur/README.txt
@@ -0,0 +1,75 @@
+
+ Treiber zur Benutzung einer PLUM-Tastatur als Matrixtastatur
+ Hans-Christoph Wirth <hcw*at*gmx*dot*de>
+
+* Was ist eine PLUM-Tastatur?
+
+ Der interessante Aspekt ist die physikalische Anordnung der Tasten.
+ Während bei einer herkömmlichen Tastatur die Reihen horizontal
+ gegeneinander versetzt liegen, bildet die PLUM-Tastatur eine Matrix,
+ d.h. die Tastenspalten liegen streng gerade untereinander.
+
+ Für uns an der PLUM-Tastatur weniger interessant ist die Belegung
+ der Tasten, die in der oberen Reihe das Wort PLUM und auf der
+ Grundlinie die Wörter READONTHIS bildet.
+
+ Die Tastatur ist günstig und preiswert bei www.plum.bz zu beziehen
+ und wird per USB-Kabel angeschlossen.
+
+* Wofür brauche ich einen Treiber?
+
+ Das PLUM-Layout ist fest verdrahtet, d.h. die Tastatur sendet
+ verdrehte Scancodes. Um ein Layout, welches auf einer herkömmlichen
+ 105-Tasten-PC-Tastatur läuft, mit der Plum-Tastatur zu nutzen,
+ müssen die verdrehten Scancodes angepasst werden.
+
+* Kann ich PLUM nur mit NEO nutzen?
+
+ Die Nutzung ist völlig unabhängig von dem gewählten Layout. Der
+ Treiber sorgt nur dafür, dass sich die PLUM-Tastatur möglichst so
+ verhält wie eine klassische QWERT-Tastatur.
+
+* Welche Einschränkungen bestehen?
+
+ Die PLUM-Tastatur hat weniger Tasten, und manche müssen umgeordnet
+ werden, damit das Blindschreiben im Zentralen weiterhin ermöglicht
+ wird. Im Einzelnen:
+
+ - die Taste '^' links von der '1' wandert neben die rechte
+ Shifttaste
+ - die Taste '<' zwischen Shift und 'y' wandert nach unten
+ - es gibt keine linke Windowstaste und keine Menü-Taste mehr
+ - die Taste 'return' nimmt die linke Hälfte der Leertaste ein
+
+ Herkömmliche Tastatur
+
+ +---+ +---+---+---+---+ +---+---+---+---+ +---+---+---+---+
+ |esc| |f1 |f2 |f3 |f4 | |f5 |f6 |f7 |f8 | |f9 |f10|f11|f12|
+ +---+---+---+---+---+---+-+-+-+-+-+-+-+-+-+-+---+---+---+---+
+ | ^ | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 0 | ß | ' | bsp |
+ +---+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+---+
+ | tab | q | w | e | r | t | z | u | i | o | p | ü | + | ret |
+ +-----++--++--++--++--++--++--++--++--++--++--++--++--++ |
+ | lock | a | s | d | f | g | h | j | k | l | ö | ä | # | |
+ +----+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+----+
+ |shf | < | y | x | c | v | b | n | m | , | . | - | shf |
+ +----+---++--+-+-+---+---+---+---+---+--++---+---++----+----+
+ |ctrl| win| alt| spc |agr | win|menu|ctrl|
+ +----+----+----+------------------------+----+----+----+----+
+
+
+ PLUM-Belegung nach Installation des Treibers
+
+ +---+---+---+---+---+---+---+---+---+---+---+---+---+
+ |esc|f1 |f2 |f3 |f4 |f5 |f6 |f7 |f8 |f9 |f10|f11|f12|
+ +---+---+---+---+---+---+---+---+---+---+---+---+---+
+ | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 0 | ß | ' |bsp|
+ +---+---+---+---+---+---+---+---+---+---+---+---+---+
+ |tab| q | w | e | r | t | z | u | i | o | p | ü | + |
+ +---+---+---+---+---+---+---+---+---+---+---+---+---+
+ |lck| a | s | d | f | g | h | j | k | l | ö | ä | # |
+ +---+---+---+---+---+---+---+---+---+---+---+---+---+
+ |shf| y | x | c | v | b | n | m | , | . | - |shf| ^ |
+ +---+---+---+---+---+---+---+---+---+---+---+---+---+
+ |ctr| < |alt| ret | spc |agr|win|ctl|
+ +---+---+---+-----------+-----------+---+---+---+
diff --git a/plum-tastatur/enable-plum b/plum-tastatur/enable-plum
new file mode 100755
index 0000000..35de3af
--- /dev/null
+++ b/plum-tastatur/enable-plum
@@ -0,0 +1,236 @@
+#!/usr/bin/perl -w
+
+# Enable PLUM to work as a standard pc keyboard
+# Written 2008 by Hans-Christoph Wirth <hcw@at@gmx@dot@de>
+# $Revision: $
+# $Date: $
+#
+# This command modifies any current X keymap (which is assumed to be
+# designed for use with an ordinary 105 key PC keyboard) so that it
+# can be used (almost) identically on a connected PLUM keyboard (see
+# www.plum.bz for information on that matrix-like keyboard).
+#
+# Usage:
+#
+# 1. Setup your keyboard layout for your standard keyboard using xmodmap.
+# 2. Read the warning below and prepare a recovery mechanism.
+# 3. Run this script without any parameters.
+#
+# Run with option "-n" to print the commands without executing them.
+#
+# Warning:
+#
+# There is no reliable way (that I am aware of) to determine the type
+# of the currently active keyboard. Hence we cannot prevent that you
+# call this script twice, which will instantaneously switch keyboard
+# input into a completely useless state. To recover from that, you
+# should prepare your desktop to run a recovery command (like 'xmodmap
+# $HOME/your-standard.modmap') on a mouse click.
+#
+######################################################################
+
+$XMODMAP = "/usr/bin/xmodmap";
+
+#
+# Options
+#
+$opt = shift || "";
+$noexec = $opt eq "-n" ? 1 : 0;
+$P = $noexec ? "! " : "";
+
+#
+# Read transformation matrix
+#
+while (<DATA>) {
+ ($plum, $pc) = split;
+ $plum[$pc] = 0+ $plum;
+}
+
+#
+# Read and parse existing map
+#
+print "${P}reading existing keymap\n";
+
+open (IN, "$XMODMAP -pke |") or die "read keyboard mapping failed\n";
+while (<IN>) {
+ /^keycode\s+(\d+)\s+=\s+(.*)$/o or die "error: malformed line: $_\n";
+
+ if ($plum[$1]) {
+ push @clearkeys, "keycode $plum[$1] =\n";
+ push @setkeys, "keycode $plum[$1] = $2\n";
+
+ push @report_keys, (split( ' ', $2, 2 ))[0];
+ }
+}
+close (IN);
+
+#
+# Read and parse existing modifiers
+#
+print "${P}reading existing modifiers\n";
+
+open (IN, "$XMODMAP -pm |") or die "read modifier list failed\n";
+while (<IN>) {
+ unless (/^(shift|lock|control|mod\d)\s*(.*)$/) {
+ next;
+ }
+
+ ($mod, $info) = ($1, $2);
+
+ @infos = ();
+ for (split( /,/, $info )) {
+ s/\(\S*\)//;
+ next if /^\s*$/;
+ push @infos, $_;
+ }
+
+ push @clearmodifiers, "clear $mod\n";
+ push @report_clearmodifiers, "$mod ";
+
+ if (@infos) {
+ push @setmodifiers, "add $mod = @infos\n";
+ push @report_setmodifiers, "$mod ";
+ }
+}
+close (IN);
+
+#
+# Now perform the changes using two external calls.
+#
+
+print "${P}clearing " . @report_keys . " keys... @report_keys\n";
+print "${P}clearing " . @report_clearmodifiers .
+ " modifiers... @report_clearmodifiers\n";
+
+if ($noexec) {
+ open (OUT, "| cat") or die "clear map failed\n";
+} else {
+ open (OUT, "| $XMODMAP -") or die "clear map failed\n";
+}
+
+print OUT @clearkeys;
+print OUT @clearmodifiers;
+
+close (OUT) or die "clear map failed\n";
+
+print "${P}setting all keys and modifiers @report_setmodifiers\n";
+
+if ($noexec) {
+ open (OUT, "| cat") or die "set new map failed\n";
+} else {
+ open (OUT, "| $XMODMAP -") or die "set new map failed\n";
+}
+
+print OUT @setkeys;
+print OUT @setmodifiers;
+
+close (OUT) or die "set new map failed\n";
+
+# The data section lists the plum keyboard scancodes ordered from left
+# to right and top to bottom. Each line describes one key position in
+# the form 'plum code' 'pc code'. Since the keyboard is short of a
+# few keys we have to move some keys in the periphery: this affects in
+# particular
+#
+# - the key to the left of '1' moves down next to right shift
+# - the key to the right of left shift moves down; there is no longer
+# a left windows key
+# - return key moves down to space key, obviously
+#
+# As an example, the standard German 105 key layout is mapped as
+# follows:
+#
+#
+# regular pc layout
+#
+# esc f1 f2 f3 f4 f5 f6 f7 f8 f9 f10 f11 f12
+# ^ 1 2 3 4 5 6 7 8 9 0 ß ' -bsp-
+# tab q w e r t z u i o p ü + ret
+# lock a s d f g h j k l ö ä #
+# shf < y x c v b n m , . - ---shf---
+# ctr win alt ---------spc--------- agr win men ctr
+#
+#
+# plum mapping
+#
+# esc f1 f2 f3 f4 f5 f6 f7 f8 f9 f10 f11 f12
+# 1 2 3 4 5 6 7 8 9 0 ß ' bsp
+# tab q w e r t z u i o p ü +
+# lck a s d f g h j k l ö ä #
+# shf y x c v b n m , . - shf ^
+# ctr < alt ---ret--- ---spc--- agr win ctr
+
+__DATA__
+9 9
+67 67
+68 68
+69 69
+70 70
+71 71
+72 72
+73 73
+74 74
+75 75
+76 76
+95 95
+96 96
+49 10
+10 11
+11 12
+12 13
+13 14
+14 15
+15 16
+16 17
+17 18
+18 19
+19 20
+20 21
+21 22
+47 23
+33 24
+46 25
+30 26
+58 27
+23 28
+22 29
+54 30
+41 31
+42 32
+24 33
+48 34
+51 35
+36 36
+50 66
+27 38
+26 39
+38 40
+40 41
+32 42
+57 43
+28 44
+43 45
+31 46
+39 47
+62 48
+61 51
+66 50
+45 52
+44 53
+55 54
+56 55
+59 56
+60 57
+25 58
+53 59
+29 60
+52 61
+34 62
+35 49
+37 37
+115 94
+64 64
+65 65
+113 113
+116 116
+109 109