'''Name:''' [http://benbergman.ca Benjamin Bergman]

'''IRC:''' [irc://irc.freenode.net benbergman]

'''Twitter:''' [http://www.twitter.com/uberben @uberben]

'''Email:''' ben AT benbergman DOT ca

== Interests ==
* [http://www.archlinux.org/ Arch Linux]
* Electronics
* [http://www.arduino.cc/ Arduino]
* [http://www.ti.com/launchpad MSP430 Launchpad]

== Project Ideas ==
* Electronic piano to keytar conversion (in progress)
* NES-chucks - Wii nun-chuck used to play NES games (Hack-a-thon 6 project)
* Adult sized light up shoes
* OBD module for car
** Display fuel efficiency
** Wireless transceiver for remote unlocking (connecting to TI ez430 Chronos watch)
* PCB mill from old printer(s)
* Bamboo bike
** Xtracycle compatible?
** Electric assist? (ala stoke monkey)
* Compass belt/anklet
* Arm wrest mounted split keyboard
* Homebrew lazer tag
* Portal themed pinball machine
* Skully (logo) disc wheels for cycling events
** Integrated LED POV displays
* Put something in <del>space</del> orbit
* [[Custom bluetooth keyboard]]
* Geodesic domes of LEDs and/or buttons

== Relevant Links ==
[http://www.instructables.com/id/Open-Source-CNC-Toolpathing-Workflow/ Open source CNC Toolpathing Workflow]

File:SkullSpace PAD.pdf

2015-07-07T13:13:31Z

Benbergman: Benbergman uploaded a new version of "File:SkullSpace PAD.pdf"

2014-12-07T03:39:09Z

Benbergman: /* Key Matrix */

Bluetooth conversion of a [http://en.wikipedia.org/wiki/Kinesis_(keyboard) Kinesis contour keyboard] to a bluetooth keyboard.

= Brainstorming =
== Available approaches ==
{| class="wikitable"
|-
! Options
! Pros
! Cons
|-
| USB HID to bluetooth adapter
|
* No modification of the keyboard necessary (for USB versions of the keyboard)
* Usable on any USB keyboard
|
* USB HID host chips are uncommon and expensive
* Programming USB HID host may be complicated
* PS/2 version of keyboard may or may not have USB output (though there are USB related markings on the PCB)
** If capable, would likely require modifications to the original controller board
|-
| PS/2 to bluetooth adapter
|
* Simpler to decode than USB HID
* Any microcontroller can be used
* No modification of the keyboard necessary (for PS/2 versions of the keyboard)
* Usable on any PS/2 keyboard
|
* USB version of keyboard may or may not have PS/2 output
** If capable, would likely require modifications to the original controller board
|-
| Custom replacement keyboard controller with integrated bluetooth
|
* Getting data directly from button matrix is likely simpler than decoding some other protocol
* Opportunity to add extra features
* Likely better battery life
* Any microcontroller (with enough IO) can be used
* Supposedly replacement key wells can be had for < $90 directly from Kinesis. Add on some extra keycaps and the thumb boards and the custom controller and you could have a brand new, bluetooth Kinesis for much less than a brand new one.
** A case would need to be made, but many people have modded their existing cases so the two halves are physically separated anyway, plus I personally think that the the thumb buttons could be at a slightly better angle, so that could be considered another pro (good use for AsentWorks 3D printer)
|
* Kinesis keyboards have some advanced programmability - reimplementing that on a custom controller could take some time
* Requires interfacing with the key matrix directly which either requires special connectors or soldering to the key matrix
|}

== Features ==
* Bluetooth module might have audio capabilities in addition to the required HID function
** Use keyboard as audio extender - include a headphone port in keyboard
** Kinesis has a key recognition click speaker built in which can be hard to hear when listening to music, but might still annoy others
** WT12 will do low-fi audio such as a typical BT headset, but does not support analog A2DP (use WT32 instead)
*** Overlay key click sound over bluetooth audio signal
* USB interface for charging
** disable bluetooth while charging and instead use the USB connection
* Saving, editing, and uploading custom keyboard layouts to the keyboard from the computer
** Cross platform application
** Keyboard layers could be saved, exported, and uploaded individually
*** Example:
**** Standard keyboards have "qwerty" on the base layer and the shift key brings them to the next layer containing "QWERTY" (assuming qwerty keyboard)
**** The Kinesis firmware has a keypad layer, so when you press the keypad button, the keys under the right hand become a numpad and the shift key moves between the layers of the numpad (numbers or arrows)
*** Separate keys and their shifted values for more finely tuned layouts (can be done in xmodmap in Linux, but this isn't portable/cross platform)
**** May not act as expected in some programs as normally it is the computer that determines the shift's effect on the key, not the keyboard
**** Probably need to take special consideration into key sequences (eg pressing shift then x as opposed to x then shift)
* Integrated pointing device
* Bluetooth pedal
** Needs to connect to the controller directly for most functions, so really only feasible with the custom controller
** Need to verify keyboard's bluetooth controller can connect to two devices at once (PC and pedal(s))
* Battery status report via bluetooth
** Might be able to do this with just the ADC on the micro, but might need something like [http://www.sparkfun.com/products/10617 this] for detection
** WT12 does not directly read battery level (use WT32 instead), though reading with MCU and reporting over SPP link would work

= Prototype =
The Kinesis Advantages was found to natively support PS/2 output. This was tested using the PS/2 cable from a Kinesis Essential 132 (the 132 was also found to be capable of outputting USB using the Kinesis Advantages USB cable/board). The USB Kinesis Advantage is the first board that is going under the knife. Because of the relative simplicity of reading PS/2 data, this is the method that will be used.

PS/2 communication (according to the [http://www.pjrc.com/teensy/td_libs_PS2Keyboard.html Arduino PS/2 library]) only requires an interrupt pin and a generic IO pin. The WT12 requires a serial channel. These requirements are pretty basic, so any microcontroller should work fine. Additional IO might be desirable for a BT pairing button, but this feature could also be embedded into a special key combination on the keyboard itself.

== To-Do list ==
* Order prototype parts
* Assemble prototype
* Test PS/2 data aquisition
* Test bluetooth HID output
* Determine power consumption (will probably be somewhat high as the keyboard is likely going to not have any kind of power saving mode)
* Find an appropriate battery
* Design custom PCB for a final version
* Order final version parts
* Assemble final version

== Parts ==
* Bluegiga WT12 Bluetooth module ([http://www.inmojo.com/store/jeff-rowberg/item/wt12-uart-bluetooth-breakout-board/ serial only breakout board] - $40, [http://www.inmojo.com/store/jeff-rowberg/item/wt12-bluetooth-breakout-board/ full breakout board] - $50, [http://ca.mouser.com/ProductDetail/Bluegiga-Technologies/WT12-A-AI4/?qs=sGAEpiMZZMu3sxpa5v1qrtmBpKx54T3%2FJoc62K8RZWc%3D just the module] - $28)
* Microcontroller development board
** Arduino (easy to use, PS/2 libraries) - $10-$50
** ATmega32u4 based dev board (native USB HID output which can be used while plugged in and charging for improved reliability and charging speed) - $15-$40
** MSP430 (specialize in low power, great for battery operation) - $5+
* [http://www.solarbotics.com/products/50550/ Logic level converter] (PS/2 device requires 5v and WT12 requires 3.3v; microcontroller could use either) - $2
* Power supply (for testing could use bench supply but USB charged Lithium Ion would be good to prototype too)
** [http://www.sparkfun.com/products/10300 USB LiPo charger with built-in boost converter] - $20
* 3v3 voltage regulator - $2
* [http://ca.mouser.com/ProductDetail/E-Switch/EG1206A/?qs=sGAEpiMZZMtHXLepoqNyVeddQslW3BFOwgoxRUo4V%252bU%3d Right angle SPDT slide switch] with 3mm spacing between pins - for enabling memory lockout feature of the Kinesis pro on other versions of the keyboard - $0.50

== Schematic ==
Block diagram:
<tt>
VCC1 = 5V VCC2 = 3V3
------------------------
VCC1 VCC1 VCC1 VCC2 VCC2 VCC1 VCC2
_____________ ^ _____________ ^ ^ _____________ ^ ^ ____________ ^ ^
| |-' | |-' '-| |-' '-| | | |
| | | | RTS | | RTS | | | ___________ |
| | | |---------| |---------| | | | | |
| | CLOCK | | CTS | LOGIC | CTS | | |----| Voltage |----|
| KINESIS |-------| ARDUINO |---------| LEVEL |---------| BLUEGIGA | | | Regulator | |
| | DATA | | TXD | CONVERTER | RXD | WT12 | === |___________| ===
| |-------| |---------| |---------| | | | |
| | | | RXD | | TXD | | '----------+----------'
| | | |---------| |---------| | |
|_____________|-, |_____________|-, ,-|_____________|-, ,-|____________| |
v v v v v v
GND GND GND GND GND GND
</tt>

== Key Matrix ==
The creator of the HumbleHacker keyboard replaced the controller in his keyboard and kindly [http://humblehacker.com/blog/20100720/hacking-the-kinesis-contoured-keyboard/ posted] his reverse-engineered key matrix. I have copied them below, with some basic modifications.

(Keywell pin numbers start at 1 closest to the thumb switches and end at 13 towards the function keys)

{| class="wikitable"
|+ Left Keywell
|-
! Pin
! width="60" | 6
! width="60" | 7
! width="60" | 8
! width="60" | 10
! width="60" | 11
! width="60" | 12
|-
! scope="row" | 1
| || \ || IN || LT || || RT
|-
! scope="row" | 2
| LS || Z || X || C || V || B
|-
! scope="row" | 3
| CP || A || S || D || F || G
|-
! scope="row" | 5
| TB || Q || W || E || R || T
|-
! scope="row" | 13
| = || 1 || 2 || 3 || 4 || 5
|}

{| class="wikitable"
|+ Right Keywell
|-
! Pin
! width="60" | 1
! width="60" | 2
! width="60" | 3
! width="60" | 6
! width="60" | 12
! width="60" | 13
|-
!scope="row" | 4
| UP || DN || || || [ || ]
|-
!scope="row" | 7
| N || , || M || RS || . || /
|-
!scope="row" | 8
| H || K || J || ' || L || ;
|-
!scope="row" | 9
| Y || I || U || \ || O || P
|-
!scope="row" | 10
|| 6 || 8 || 7 || - || 9 || 0
|}

(Thumbswitch pin numbers start at 1 closest to the center of the keyboard and end at 10 towards the keywells)

{| class="wikitable"
|+ Left Thumbswitches
|-
! Pin
! width="60" | 1
! width="60" | 2
! width="60" | 3
! width="60" | 8
|-
!scope="row" | 4
| SL3 || || SL6 || SL4
|-
!scope="row" | 5
| || SL1 || SL5 || SL2
|}

{| class="wikitable"
|+ Right Thumbswitches
|-
! Pin
! width="60" | 3
! width="60" | 4
! width="60" | 5
! width="60" | 6
|-
!scope="row" | 7
| SR1 || || SR2 || SR5
|-
!scope="row" | 8
| SR4 || SR3 || SR6 ||
|}

(Function key pins start with 1 near the USB/PS2 cable and 13 near the keywells)

{| class="wikitable"
|+ Left Function Keys
|-
! Pin
! width="60" | 2
! width="60" | 3,6,10
! width="60" | 4,7,11
|-
!scope="row" | 1
| ESC || F1 || F2
|-
!scope="row" | 8
| F3 || F4 || F5
|-
!scope="row" | 5
| F6 || F7 || F8
|}

{| class="wikitable"
|+ Right Function Keys
|-
! Pin
! width="60" | 5
! width="60" | 8,11
! width="60" | 7,10
|-
!scope="row" | 8
| PB || PG || KY
|-
!scope="row" | 1
| F9 || F10 || F11
|-
!scope="row" | 5
| F12 || PS || SL
|}

{| class="wikitable"
|+ Full Matrix
|-
! Pin
! width="60" | A
! width="60" | B
! width="60" | C
! width="60" | D
! width="60" | E
! width="60" | F
! width="60" | G
! width="60" | H
! width="60" | I
! width="60" | J
! width="60" | K
! width="60" | L
! width="60" | M
! width="60" | N
! width="60" | O
|-
!scope="row" | 1
|= || 1 || 2 || 3 || 4 || 5 || || || || || || || F6 || F7 || F8
|-
!scope="row" | 2
|TB || Q || W || E || R || T || || || || || || || F3 || F4 || F5
|-
!scope="row" | 3
|CP || A || S || D || F || G || || || || || || || ESC || F1 || F2
|-
!scope="row" | 4
|LS || Z || X || C || V || B || UP || || DN || [ || ] || X1 || F9 || F10 || F11
|-
!scope="row" | 5
|X2 || ` || IN || LT || || RT || 6 || 7 || 8 || 9 || 0 || - || F12 || PS || SL
|-
!scope="row" | 6
| || SL1 || || SL2 || || SL5 || Y || U || I || O || P || || PB || PG || KY
|-
!scope="row" | 7
|SR4 || SR3 || SR6 || SL4 || SL3 || SL6 || H || J || K || L || ; || ‘ || || ||
|-
!scope="row" | 8
|SR1 || || SR2 || || SR5 || || N || M || , || . || / || RS || || ||
|}

The Humble Hacker keyboard uses a condensed version of the above matrix, but I wanted to condense it further, retain 8 rows for ease of scanning, and I wanted to be able to split the matrix into left and right handed sections in case I ever decide to split my keyboard physically into two sections. By combining the single-element columns in each thumb cluster, I was able achieve this, with room for an extra 2x3 (less 1) matrix in each half, perfect for mouse buttons and modifiers.

{| class="wikitable"
|+ Condensed Kinesis matrix (original qwerty labelling)
|-
! Pin
! width="60" | 0
! width="60" | 1
! width="60" | 2
! width="60" | 3
! width="60" | 4
! width="60" | 5
! width="60" | 6
! width="60" | 7
! width="60" | 8
! width="60" | 9
! width="60" | 10
! width="60" | 11
|-
!scope="row" | 0
| = || 1 || 2 || 3 || 4 || 5 || 6 || 7 || 8 || 9 || 0 || -
|-
!scope="row" | 1
| TB || Q || W || E || R || T || Y || U || I || O || P || \
|-
!scope="row" | 2
| CP || A || S || D || F || G || H || J || K || L || ; || ‘
|-
!scope="row" | 3
| LS || Z || X || C || V || B || N || M || , || . || / || RS
|-
!scope="row" | 4
| || ` || IN || LT || || RT || UP || || DN || [ || ] ||
|-
!scope="row" | 5
| || F6 || F7 || F8 || || || || || F9 || F10 || F11 ||
|-
!scope="row" | 6
| HOME || F3 || F4 || F5 || END || LALT || SPACE || ENTER || F12 || PS || SL || RCTRL
|-
!scope="row" | 7
| BKSP || ESC || F1 || F2 || DEL || LCTRL || PGDN || RALT || PB || PG || KY || PGUP
|}

= Reference =
* [http://www.keyglove.net/2011/03/24/bluegiga-wt12-bluetooth-module-connection/ Development example using Bluegiga WT12]
* [http://www.keyglove.net/2011/06/25/wt12-custom-breakout-board-take-2/ WT12 breakout boards] - OSHW breakouts
** Eagle schematic and PCB files available on InMojo WT12 [http://www.inmojo.com/store/jeff-rowberg/item/wt12-bluetooth-breakout-board/ full]/[http://www.inmojo.com/store/jeff-rowberg/item/wt12-uart-bluetooth-breakout-board/ UART] product pages
* [http://ca.mouser.com/ProductDetail/Bluegiga-Technologies/WT12-A-AI4/?qs=sGAEpiMZZMu3sxpa5v1qrtmBpKx54T3%2FJoc62K8RZWc%3D WT12 module]
* [http://geekhack.org/showwiki.php?title=Island:10371 Custom bluetooth IBM Model M] using a salvaged bluetooth module from a mini keyboard - salvaged PCB
* [http://geekhack.org/showwiki.php?title=Island:19104 Custom bluetooth IBM Model M] using a salvaged bluetooth module from a mini keyboard - custom PCB
* [http://geekhack.org/showwiki.php?title=Island:20851 Custom bluetooth HHKB] using the WT12
* [http://humblehacker.com/blog/20100720/hacking-the-kinesis-contoured-keyboard/ HumbleHacker Kinesis]
* [http://geekhack.org/showwiki.php?title=Island:8110 Major Kinesis mod project] - includes a collection of other Kinesis mods
* [http://geekhack.org/showwiki.php?title=Island:16112 Split Kinesis mod] - includes PCB scans from one version of the Kinesis
* [http://www.pjrc.com/teensy/td_libs_PS2Keyboard.html Arduino PS/2 keyboard library]
* [http://www.arduino.cc/playground/Main/PS2KeyboardExt2 Modified version of the Arduino PS/2 keyboard library] - supposedly more complete

[[Category:Projects]]

Custom bluetooth keyboard

2014-12-01T03:04:26Z

Benbergman: /* Key Matrix */

Bluetooth conversion of a [http://en.wikipedia.org/wiki/Kinesis_(keyboard) Kinesis contour keyboard] to a bluetooth keyboard.

= Brainstorming =
== Available approaches ==
{| class="wikitable"
|-
! Options
! Pros
! Cons
|-
| USB HID to bluetooth adapter
|
* No modification of the keyboard necessary (for USB versions of the keyboard)
* Usable on any USB keyboard
|
* USB HID host chips are uncommon and expensive
* Programming USB HID host may be complicated
* PS/2 version of keyboard may or may not have USB output (though there are USB related markings on the PCB)
** If capable, would likely require modifications to the original controller board
|-
| PS/2 to bluetooth adapter
|
* Simpler to decode than USB HID
* Any microcontroller can be used
* No modification of the keyboard necessary (for PS/2 versions of the keyboard)
* Usable on any PS/2 keyboard
|
* USB version of keyboard may or may not have PS/2 output
** If capable, would likely require modifications to the original controller board
|-
| Custom replacement keyboard controller with integrated bluetooth
|
* Getting data directly from button matrix is likely simpler than decoding some other protocol
* Opportunity to add extra features
* Likely better battery life
* Any microcontroller (with enough IO) can be used
* Supposedly replacement key wells can be had for < $90 directly from Kinesis. Add on some extra keycaps and the thumb boards and the custom controller and you could have a brand new, bluetooth Kinesis for much less than a brand new one.
** A case would need to be made, but many people have modded their existing cases so the two halves are physically separated anyway, plus I personally think that the the thumb buttons could be at a slightly better angle, so that could be considered another pro (good use for AsentWorks 3D printer)
|
* Kinesis keyboards have some advanced programmability - reimplementing that on a custom controller could take some time
* Requires interfacing with the key matrix directly which either requires special connectors or soldering to the key matrix
|}

== Features ==
* Bluetooth module might have audio capabilities in addition to the required HID function
** Use keyboard as audio extender - include a headphone port in keyboard
** Kinesis has a key recognition click speaker built in which can be hard to hear when listening to music, but might still annoy others
** WT12 will do low-fi audio such as a typical BT headset, but does not support analog A2DP (use WT32 instead)
*** Overlay key click sound over bluetooth audio signal
* USB interface for charging
** disable bluetooth while charging and instead use the USB connection
* Saving, editing, and uploading custom keyboard layouts to the keyboard from the computer
** Cross platform application
** Keyboard layers could be saved, exported, and uploaded individually
*** Example:
**** Standard keyboards have "qwerty" on the base layer and the shift key brings them to the next layer containing "QWERTY" (assuming qwerty keyboard)
**** The Kinesis firmware has a keypad layer, so when you press the keypad button, the keys under the right hand become a numpad and the shift key moves between the layers of the numpad (numbers or arrows)
*** Separate keys and their shifted values for more finely tuned layouts (can be done in xmodmap in Linux, but this isn't portable/cross platform)
**** May not act as expected in some programs as normally it is the computer that determines the shift's effect on the key, not the keyboard
**** Probably need to take special consideration into key sequences (eg pressing shift then x as opposed to x then shift)
* Integrated pointing device
* Bluetooth pedal
** Needs to connect to the controller directly for most functions, so really only feasible with the custom controller
** Need to verify keyboard's bluetooth controller can connect to two devices at once (PC and pedal(s))
* Battery status report via bluetooth
** Might be able to do this with just the ADC on the micro, but might need something like [http://www.sparkfun.com/products/10617 this] for detection
** WT12 does not directly read battery level (use WT32 instead), though reading with MCU and reporting over SPP link would work

= Prototype =
The Kinesis Advantages was found to natively support PS/2 output. This was tested using the PS/2 cable from a Kinesis Essential 132 (the 132 was also found to be capable of outputting USB using the Kinesis Advantages USB cable/board). The USB Kinesis Advantage is the first board that is going under the knife. Because of the relative simplicity of reading PS/2 data, this is the method that will be used.

PS/2 communication (according to the [http://www.pjrc.com/teensy/td_libs_PS2Keyboard.html Arduino PS/2 library]) only requires an interrupt pin and a generic IO pin. The WT12 requires a serial channel. These requirements are pretty basic, so any microcontroller should work fine. Additional IO might be desirable for a BT pairing button, but this feature could also be embedded into a special key combination on the keyboard itself.

== To-Do list ==
* Order prototype parts
* Assemble prototype
* Test PS/2 data aquisition
* Test bluetooth HID output
* Determine power consumption (will probably be somewhat high as the keyboard is likely going to not have any kind of power saving mode)
* Find an appropriate battery
* Design custom PCB for a final version
* Order final version parts
* Assemble final version

== Parts ==
* Bluegiga WT12 Bluetooth module ([http://www.inmojo.com/store/jeff-rowberg/item/wt12-uart-bluetooth-breakout-board/ serial only breakout board] - $40, [http://www.inmojo.com/store/jeff-rowberg/item/wt12-bluetooth-breakout-board/ full breakout board] - $50, [http://ca.mouser.com/ProductDetail/Bluegiga-Technologies/WT12-A-AI4/?qs=sGAEpiMZZMu3sxpa5v1qrtmBpKx54T3%2FJoc62K8RZWc%3D just the module] - $28)
* Microcontroller development board
** Arduino (easy to use, PS/2 libraries) - $10-$50
** ATmega32u4 based dev board (native USB HID output which can be used while plugged in and charging for improved reliability and charging speed) - $15-$40
** MSP430 (specialize in low power, great for battery operation) - $5+
* [http://www.solarbotics.com/products/50550/ Logic level converter] (PS/2 device requires 5v and WT12 requires 3.3v; microcontroller could use either) - $2
* Power supply (for testing could use bench supply but USB charged Lithium Ion would be good to prototype too)
** [http://www.sparkfun.com/products/10300 USB LiPo charger with built-in boost converter] - $20
* 3v3 voltage regulator - $2
* [http://ca.mouser.com/ProductDetail/E-Switch/EG1206A/?qs=sGAEpiMZZMtHXLepoqNyVeddQslW3BFOwgoxRUo4V%252bU%3d Right angle SPDT slide switch] with 3mm spacing between pins - for enabling memory lockout feature of the Kinesis pro on other versions of the keyboard - $0.50

== Schematic ==
Block diagram:
<tt>
VCC1 = 5V VCC2 = 3V3
------------------------
VCC1 VCC1 VCC1 VCC2 VCC2 VCC1 VCC2
_____________ ^ _____________ ^ ^ _____________ ^ ^ ____________ ^ ^
| |-' | |-' '-| |-' '-| | | |
| | | | RTS | | RTS | | | ___________ |
| | | |---------| |---------| | | | | |
| | CLOCK | | CTS | LOGIC | CTS | | |----| Voltage |----|
| KINESIS |-------| ARDUINO |---------| LEVEL |---------| BLUEGIGA | | | Regulator | |
| | DATA | | TXD | CONVERTER | RXD | WT12 | === |___________| ===
| |-------| |---------| |---------| | | | |
| | | | RXD | | TXD | | '----------+----------'
| | | |---------| |---------| | |
|_____________|-, |_____________|-, ,-|_____________|-, ,-|____________| |
v v v v v v
GND GND GND GND GND GND
</tt>

== Key Matrix ==
The creator of the HumbleHacker keyboard replaced the controller in his keyboard and kindly [http://humblehacker.com/blog/20100720/hacking-the-kinesis-contoured-keyboard/ posted] his reverse-engineered key matrix. I have copied them below, with some basic modifications.

(Keywell pin numbers start at 1 closest to the thumb switches and end at 13 towards the function keys)

{| class="wikitable"
|+ Left Keywell
|-
! Pin
! width="60" | 6
! width="60" | 7
! width="60" | 8
! width="60" | 10
! width="60" | 11
! width="60" | 12
|-
! scope="row" | 1
| || \ || IN || LT || || RT
|-
! scope="row" | 2
| LS || Z || X || C || V || B
|-
! scope="row" | 3
| CP || A || S || D || F || G
|-
! scope="row" | 5
| TB || Q || W || E || R || T
|-
! scope="row" | 13
| = || 1 || 2 || 3 || 4 || 5
|}

{| class="wikitable"
|+ Right Keywell
|-
! Pin
! width="60" | 1
! width="60" | 2
! width="60" | 3
! width="60" | 6
! width="60" | 12
! width="60" | 13
|-
!scope="row" | 4
| UP || DN || || || [ || ]
|-
!scope="row" | 7
| N || , || M || RS || . || /
|-
!scope="row" | 8
| H || K || J || ' || L || ;
|-
!scope="row" | 9
| Y || I || U || \ || O || P
|-
!scope="row" | 10
|| 6 || 8 || 7 || - || 9 || 0
|}

(Thumbswitch pin numbers start at 1 closest to the center of the keyboard and end at 10 towards the keywells)

{| class="wikitable"
|+ Left Thumbswitches
|-
! Pin
! width="60" | 1
! width="60" | 2
! width="60" | 3
! width="60" | 8
|-
!scope="row" | 4
| SL3 || || SL6 || SL4
|-
!scope="row" | 5
| || SL1 || SL5 || SL2
|}

{| class="wikitable"
|+ Right Thumbswitches
|-
! Pin
! width="60" | 3
! width="60" | 4
! width="60" | 5
! width="60" | 6
|-
!scope="row" | 7
| SR1 || || SR2 || SR5
|-
!scope="row" | 8
| SR4 || SR3 || SR6 ||
|}

(Function key pins start with 1 near the cable and 13 near the keywells)

{| class="wikitable"
|+ Left Function Keys
|-
! Pin
! width="60" | 2
! width="60" | 3,6,10
! width="60" | 4,7,11
|-
!scope="row" | 1
| ESC || F1 || F2
|-
!scope="row" | 8
| F3 || F4 || F5
|-
!scope="row" | 5
| F6 || F7 || F8
|}

{| class="wikitable"
|+ Right Function Keys
|-
! Pin
! width="60" | 5
! width="60" | 8,11
! width="60" | 7,10
|-
!scope="row" | 8
| PB || PG || KY
|-
!scope="row" | 1
| F9 || F10 || F11
|-
!scope="row" | 5
| F12 || PS || SL
|}

{| class="wikitable"
|+ Full Matrix
|-
! Pin
! width="60" | A
! width="60" | B
! width="60" | C
! width="60" | D
! width="60" | E
! width="60" | F
! width="60" | G
! width="60" | H
! width="60" | I
! width="60" | J
! width="60" | K
! width="60" | L
! width="60" | M
! width="60" | N
! width="60" | O
|-
!scope="row" | 1
|= || 1 || 2 || 3 || 4 || 5 || || || || || || || F6 || F7 || F8
|-
!scope="row" | 2
|TB || Q || W || E || R || T || || || || || || || F3 || F4 || F5
|-
!scope="row" | 3
|CP || A || S || D || F || G || || || || || || || ESC || F1 || F2
|-
!scope="row" | 4
|LS || Z || X || C || V || B || UP || || DN || [ || ] || X1 || F9 || F10 || F11
|-
!scope="row" | 5
|X2 || ` || IN || LT || || RT || 6 || 7 || 8 || 9 || 0 || - || F12 || PS || SL
|-
!scope="row" | 6
| || SL1 || || SL2 || || SL5 || Y || U || I || O || P || || PB || PG || KY
|-
!scope="row" | 7
|SR4 || SR3 || SR6 || SL4 || SL3 || SL6 || H || J || K || L || ; || ‘ || || ||
|-
!scope="row" | 8
|SR1 || || SR2 || || SR5 || || N || M || , || . || / || RS || || ||
|}

The Humble Hacker keyboard uses a condensed version of the above matrix, but I wanted to condense it further, retain 8 rows for ease of scanning, and I wanted to be able to split the matrix into left and right handed sections in case I ever decide to split my keyboard physically into two sections. By combining the single-element columns in each thumb cluster, I was able achieve this, with room for an extra 2x3 (less 1) matrix in each half, perfect for mouse buttons and modifiers.

{| class="wikitable"
|+ Condensed Kinesis matrix (original qwerty labelling)
|-
! Pin
! width="60" | 0
! width="60" | 1
! width="60" | 2
! width="60" | 3
! width="60" | 4
! width="60" | 5
! width="60" | 6
! width="60" | 7
! width="60" | 8
! width="60" | 9
! width="60" | 10
! width="60" | 11
|-
!scope="row" | 0
| = || 1 || 2 || 3 || 4 || 5 || 6 || 7 || 8 || 9 || 0 || -
|-
!scope="row" | 1
| TB || Q || W || E || R || T || Y || U || I || O || P || \
|-
!scope="row" | 2
| CP || A || S || D || F || G || H || J || K || L || ; || ‘
|-
!scope="row" | 3
| LS || Z || X || C || V || B || N || M || , || . || / || RS
|-
!scope="row" | 4
| || ` || IN || LT || || RT || UP || || DN || [ || ] ||
|-
!scope="row" | 5
| || F6 || F7 || F8 || || || || || F9 || F10 || F11 ||
|-
!scope="row" | 6
| HOME || F3 || F4 || F5 || END || LALT || SPACE || ENTER || F12 || PS || SL || RCTRL
|-
!scope="row" | 7
| BKSP || ESC || F1 || F2 || DEL || LCTRL || PGDN || RALT || PB || PG || KY || PGUP
|}

= Reference =
* [http://www.keyglove.net/2011/03/24/bluegiga-wt12-bluetooth-module-connection/ Development example using Bluegiga WT12]
* [http://www.keyglove.net/2011/06/25/wt12-custom-breakout-board-take-2/ WT12 breakout boards] - OSHW breakouts
** Eagle schematic and PCB files available on InMojo WT12 [http://www.inmojo.com/store/jeff-rowberg/item/wt12-bluetooth-breakout-board/ full]/[http://www.inmojo.com/store/jeff-rowberg/item/wt12-uart-bluetooth-breakout-board/ UART] product pages
* [http://ca.mouser.com/ProductDetail/Bluegiga-Technologies/WT12-A-AI4/?qs=sGAEpiMZZMu3sxpa5v1qrtmBpKx54T3%2FJoc62K8RZWc%3D WT12 module]
* [http://geekhack.org/showwiki.php?title=Island:10371 Custom bluetooth IBM Model M] using a salvaged bluetooth module from a mini keyboard - salvaged PCB
* [http://geekhack.org/showwiki.php?title=Island:19104 Custom bluetooth IBM Model M] using a salvaged bluetooth module from a mini keyboard - custom PCB
* [http://geekhack.org/showwiki.php?title=Island:20851 Custom bluetooth HHKB] using the WT12
* [http://humblehacker.com/blog/20100720/hacking-the-kinesis-contoured-keyboard/ HumbleHacker Kinesis]
* [http://geekhack.org/showwiki.php?title=Island:8110 Major Kinesis mod project] - includes a collection of other Kinesis mods
* [http://geekhack.org/showwiki.php?title=Island:16112 Split Kinesis mod] - includes PCB scans from one version of the Kinesis
* [http://www.pjrc.com/teensy/td_libs_PS2Keyboard.html Arduino PS/2 keyboard library]
* [http://www.arduino.cc/playground/Main/PS2KeyboardExt2 Modified version of the Arduino PS/2 keyboard library] - supposedly more complete

[[Category:Projects]]