HTC Rhodium keyboard mapping files for Android
----------------------------------------------

Adam Williamson - adamwill@shaw.ca

Introduction
------------

This archive contains various files relating to keyboard mapping for the
HTC Rhodium family of devices in the Android operating system (specifically
the XDAndroid build - see http://forum.xda-developers.com/showthread.php?t=601751 ).

Changelog
---------

v1.0 (2010-02-02)
- initial combined release

Contents
--------

tilt2_microp-keypad.kl		key layout map for main keyboard device for Tilt 2
tilt2_microp-keypad.kcm		key character map for main keyboard device for Tilt 2
tilt2_microp-keypad.kcm.bin	key character map for main keyboard device for Tilt 2 (compiled: use 'kcm' tool from Android source)
tilt2_navi_pad.kl		key layout map for gpio-handled buttons for Tilt 2
rhod210_microp-keypad.kl	key layout map for main keyboard device for RHOD210 variant
rhod210_microp-keypad.kcm	key character map for main keyboard device for RHOD210 variant
rhod210_microp-keypad.kcm.bin	key character map for main keyboard device for RHOD210 variant (compiled)
init				modified init script with handling added for 'physkeyboard=tilt2' and 'physkeyboard=rhod210' parameters
rootfs.img			rebuilt XDAndroid rootfs image containing all of the above ready for use - based on 2010-01-14 XDAndroid rootfs.img

Usage
-----

For basic usage, replace your XDAndroid rootfs.img with the modified one from
this archive, edit your STARTUP.TXT file and add the appropriate parameter to
the 'set cmdline' line, for example:

set cmdline "lcd.density=240 msmts_calib=0x9f.0x39a.0x35c.0x78 
clock-7x00.a11=500 msmvkeyb_toggle=off physkeyboard=rhod210 pmem.extra=1 
gsensor_axis=-1,-2,3 force_cdma=1"

all on a single line. Now boot as usual.

In more detail, to recreate the changed rootfs.img, loop mount the 
rootfs.img you wish to modify, and place the .kl and .kcm.bin files from 
this archive into the directory init.etc/keymaps. Place the init file 
into the top level of the rootfs.img image. Then unmount the rootfs.img 
image. You can re-mount it to confirm the files were added, if you like. 
Use this method if you wish to adjust the mappings. The .kcm files are 
source files and will not be read if placed in the rootfs; you must 
compile them into .kcm.bin files before placing them into the rootfs. 
The tool used to do this is referred to as 'createkcharmap' in the 
Android documentation but is in fact called 'kcm' in the Android source 
tree, where it can be found.

For reference on the layout and function of the files, see:
http://pdk.android.com/online-pdk/guide/keymaps_keyboard_input.html

Licensing and acknowledgements
------------------------------

These files were developed with reference to the existing maps for other 
devices, particularly the AT&T Fuze maps by Bryan D. Stine. They are 
licensed under the MIT license, with the exception of init, which - 
being I believe based on an original Android file - is under the Apache 
Software License 2.0 . Please see the files COPYING and COPYING.ASL for 
more information.