Keyboard Driver Patch


OVERVIEW

Patches to the keyboard drivers to enable all standard keys,
especially for USB international keyboards.

Following keys are enabled with this patch.

	keyboard type		keys
	=============		====
	USB American:		right Windows
	USB Japanese/European:	right Windows, international keys
	USB PC-98:		right Windows, international keys, 
				keypad =, keypad comma
	USB Macintosh:		right Command, Power, keypad =, keypad comma
	ADB Macintosh Japanese:	international keys
	AT,PS/2 Japanese:	underscore (R4.5.x only)



REQUIREMENTS

- BeOS R4.5.x/R5 x86/PowerPC
- USB American/Japanese/European keyboard (incl. PC-98 and Macintosh)
- AT or PS/2 Japanese keyboard (R4.5.x only)

You may have to modify keymap as well.
Use my International Keymap Pack distributed separately.
Be careful that the right GUI (Windows or Command) key is assigned
nowhere in BeOS standard keymaps.



CAUTION

This patch is intentionally made so that it will rewrite the original
drivers directly. If the patch should fail, a significant problem
may arise in booting and operating the BeOS due to the nature of the
keyboard device. In particular, pay great attention for use with a
notebook PC that can't emergency-boot from the installation CD.

In case of trouble you can recover the original drivers as follows:

$ cd /system/add-ons/input_server/devices
$ gunzip keyboard.gz
$ cd /system/add-ons/kernel/drivers/bin
$ gunzip hid.gz



INSTALLATION

If you have installed an earlier version of this patch, recover the
original drivers as shown above.

Double-click install.sh, or

$ sh install.sh

(bsubst is an auxiliary program and not to be executed itself.)



MEMORANDUM

This section contains technical information on USB keyboards.
You don't have to read.

----------------------------------------------------------------------
		USB	BeOS
Key name	keycode	keycode		Remark
(Usage Name)	(UID)

Affected keys: (whose BeOS keycodes are officially defined)

non-US # and ~	32	33		Japanese ] and };
					conflict with \ and | (USB keycode:31)
non-US \ and |	64	69		102/105 keyboard
KB intl 1	87	6b		Japanese \ and _; Brazilian ABNT2 / and ?
KB intl 2	88	6e		Japanese hiragana/katakana
KB intl 3	89	6a		Japanese yen and |
KB intl 4	8A	6d		Japanese henkan
KB intl 5	8B	6c		Japanese muhenkan

Affected keys: (whose BeOS keycodes not officially defined)

Power		66	71 (not 6b)	Macintosh Power
Keypad =	67	6f (not 6a)	Macintosh/PC-98 keypad =
Keypad Comma	85	70		Macintosh keypad comma; Brazilian ABNT2 keypad period
KB intl 6	8C	70		PC-98 keypad comma
KB LANG 1	90	72		Korean Hangul/English; Macintosh Japanese kana
KB LANG 2	91	73		Korean Hanja; Macintosh Japanese Alphanumeric

Unaffected keys:

KB intl 7	8D	??		DBCS/SBCS?
KB LANG 3	92	??		Japanese word-processor katakana?
KB LANG 4	93	??		Japanese word-processor hiragana?
KB LANG 5	94	??		Japanese word-processor zenkaku/hankaku?
----------------------------------------------------------------------

cf. Universal Serial Bus HID Usage Tables 1.1 pp.35-41
http://www.usb.org/developers/data/hut1_1.pdf

To use Macintosh USB keyboard with PC:

- disable CapsLock and NumLock (otherwise these keys cause keyboard hang-up)
- swap option and command keys
- always NumLock



LICENSING INFORMATION

This program is free software.

You can obtain the latest version at:
http://euc.jp/beos/index.en.html
http://www.bebits.com/



HISTORY

Japanese Keyboard Patch (patchjkb.sh)
1.00	first release
1.10	saves original add-on
1.20	R4.5.2 supported

USB International Keyboard Patch (patchukb.sh)
1.00	first release
1.10	NEC PC-98 USB keyboard supported
1.11	checksum after applying patch
1.20	R4.5.2 CD driver supported

Keyboard Driver Patch (patchkb.sh)
1.00	first release
	integrating Japanese Keyboard Patch and International Keyboard Patch
	independent of driver version
	Macintosh USB keyboard supported
1.10	GUI
1.20	Macintosh ADB JIS keyboard supported
	USB hiragana and henkan keys fixed
1.21	R5 supported
	Brazilian ABNT2 keypad period supported
1.22	R5.0.1 supported
	Fixed broken archive
1.30	Right GUI key supported in USB keyboards

[EOF]