This controller board replaces stock controller and makes your HHKB full programmable. This board is fully assembled and you can install it into your HHKB only with screw driver.
HHKB Pro1(PD-KB300), HHKB Pro2(PD-KB400) and HHKB ProJP(PD-KB420) including Type-S are supported. Note that HHKB ProBT(PD-KB600/620) is not supported.
Bluetooth and USB controller look like these.


Note: In current revision pcb color is
green.
Battery is not included.Feel free to post your question or suggestion here! I basically prefer to discuss here to share info with community rather than email.
For more technical information see also this thread.
https://geekhack.org/index.php?topic=12047.0UPDATE:2014/05/01 GB was closed and moved to artisan service.
2015/08/22 components for next batch were ordered, it will take a few weeks to be delivered.
2015/09/10 waiting for PCB 7-10days
2015/10/07 All components are stocked for all variants now.
2015/11/09 Keymap editor was updated
2016/01/11 Updated keymap editor
2016/04/16 Revised price of USB controller
2016/08/31 New keymap editor: also finally available for JP
2016/10/01 out of stock
2016/10/07 back in stock
2017/04/28 All variants are virtually always in stock.
2017/06/06 Added note for shipping to Canada.
CONTROLLER VARIANTS:USB Controller for Pro2(PD-KB400)(Type-S is also supported.)
USB Controller for JP(PD-KB420)(Type-S is also supported.)
USB Controller for Pro1(PD-KB300)Bluetooth Controller for Pro2(PD-KB400)(Type-S is also supported.)
Bluetooth Controller for JP(PD-KB420)(Type-S is also supported.) - read
More
1. Case problem with Bluetooth Controller for JPSee this photo, black one is JP model and white is Pro2. As you can see JP bottom case has no hole for switch and LEDs.

To install Bluetooth controller into HHKB JP:1) you need to drill bottom case to make holes or
2) you can use Pro2 bottom half with JP top half as the photo indicates.
2. Japanese specific keys cannot be sent via Bluetooth. You can remap them to other normal keys. This won't be critical to other language users. See also LIMITATION section below.
NOTE: Bluetooth controller has all functions of USB controller, no compromise as USB controller.NOTE: This controller doesn't support "HHKB Professional BT"(PD-KB600/620).
STATUS & STOCK:All variants are virtually always in stock.
USB: Pro2 / JP / Pro1
BT: Pro2 / JP
Lead time: Can be shipped usually in a few bussiness days, a week in the worst case (2017/08/16)
ORDER(RULE & CONDITION)0. Read this post carefully and feel free to ask me if you have any question before placing an order.
1. Email me to let me know
which variant of controller you want.
My email is: hasu@tmk-kbd.com
2. I'll send invoice mail via PayPal in a few days.
3. Make a payment within
seven days. Please supply correct shipping address on PayPal when the payment.
4. You will receive an email with tracking number from Japan Post after shipping. Let me know if you don't get tracking number in three bussiness days after payment.
You can trace it here or your country's postal service like USPS.
https://trackings.post.japanpost.jp/services/srv/search/input?locale=en (Japan Post)
https://tools.usps.com/go/TrackConfirmAction_input (USPS)
Price: 42USD [for
USB Controller]
79USD [for
Bluetooth Controller]
For example, it costs 48USD(42+6) in total for an USB Controller and 164USD(79*2+6) for two Bluetooth Controller.
Payment: Paypal Invoice will be sent to your email. You'll be able to make a payment with credit card on Palpal even if you don't have Paypal account.
Shipping: World wide shipping at same rate
6USD. Registered Small Packet with tracking and insurance.
Shipping to CANADA: Sorry to say this but we've had very long delay on delivery in Canada these days and it takes even two months occasionally when you suffer from bad luck.
In the case of trouble you have to wait two months(plus a week) before having me issue fully refund. If you are in Canada consider using EMS for shipping method, which is traceable and very fast(3 days or so) but it costs
20USD instead of 6

Let me know if you want to use EMS.
AFTER RECEIVING YOUR CONTROLLERPLEASE TEST IT BEFORE FLASHING YOUR OWN FIRMWARE.Just install it and check if you can type on your keyboad normally.
(For BT controller user, you can check both USB and BT function safely even without battery.)
WARN: PLEASE MAKE SURE BATTERY POLARITY BEFORE CONNECTING. Some batteries in the market has reverse polarity at connector and it will fry and break battery charger chip. With the broken charger chip you cannot charge battery fully anymore or controller may stop working completely.
I can offer free repair service for faulty charger chip but you have to pay postage for both ways. No RMA service is provided for this, sorry.
Positive(+) side or red wire should be on left as the pic shows.
See "Bluetooth Battery" section below for more info. Get battery from reliable srouces like sparkfun or adafruit if you are not sure.
KEYMAP EDITOR:You can remap keys and download firmwre using TMK keymap editor on web browser. Please use Chrome if you have any problem on other browser. See 'MANUAL' section below for how to flash firmware onto controller.
Pro/Pro2 USB |
Pro2 Bluetooth |
JP USB |
JP BluetoothCAPABILITY- Fully Prorammable keyboard functions(USB and Bluetooth)
TMK firmware offers various features including key mapping, mouse keys and USB NKRO.
See
https://github.com/tmk/tmk_keyboard- Switching between USB and Bluetooth(Bluetooth)
You can switch the two connections with slide switch or key combination.
- RN42 config mode(Bluetooth)
You can change power/connection configuration of the module if needed.
- Low battery alert(Bluetooth)
Red LED turns on when low voltage.
- RN42 status indicator(Bluetooth)
LED indicates status of Bluetooth connection.
- Pairing(Bluetooth)
The module stores up to 8 connections.
- Auto connect(Bluetooth)
The module connects the last connected device automatically.
- iOS support(USB and Bluetooth)
works as keyboard with iPhone5. No tested completely. Note that iOS doesn't accept mouse device.
- Android support(USB and Bluetooth)
works as keyboard and mouse with Nexus5. No tested completely.
- Battery charging(Bluetooth)
You can charge from USB port or power adapter which has USB outlet.
LIMITATION & CAVEAT-
Class 2 Bluetooth 2.1 + EDR(BT) Bluetooth module which BT controller uses is RN42 of Mcirochip:
http://www.microchip.com/wwwproducts/Devices.aspx?product=RN42-
Bluetooth module RN42 limitations(BT) See this for detail.
https://github.com/tmk/tmk_keyboard/issues/322#issuecomment-204133554 =
Japanese and Korean specific keys are not supported Bluetooth module RN42 cannot send HID keyboard usage more than 0x65. This won't affect most of latin language users. USB controller can send all usage.
=
Mouse button 4,5(BTN4, BTN5) and horizontal wheel not supported Mouse button1,2,3(left, right, middle) and vertical wheel are supported.
https://github.com/tmk/tmk_keyboard/issues/322 =
NKRO does not work on Bluetooth Bluetooth is 6KRO like normal keyboards.
https://github.com/tmk/tmk_keyboard/issues/169 =
System control is not supported It can't send Power, Wake and Sleep keys.
-
No USB Hub(BT and USB) Controller has no USB Hub fucntion, you lose two USB downstream ports and they turn into just two empty holes on HHKB Pro2.
-
Short battery life(BT) Around 12 hours with 850mAh. Around 30 hours with 2600mAh. BT Controller needs to use battery power to scan HHKB key matrix and get minimum latency on Bluetooth. If you don't mind slow scan rate and latency you can make battery life a little longer but not so much, HHKB and the module is power hog in the end.
-
Lipo Battery is not included(BT) Lipo battery is not included. And it cannot be shipped from Japan due to regulations.
You have to purchase battery for BT controller, see
Bluetooth Battery section below for the detail.
-
LIPO BATTERY IS VERY DANGEROUS(BT) TAKE EXTRA CARE OF YOUR SAFETY AND PROPERTY. You can learn
here.
-
Karabiner doen't recognize Bluetooth inputs on Mac(BT) Key strokes from Bluetooth are ignored by default. To make Karabiner recognize them enable option 'Allow devices which Vendor ID and Product ID are zero.'.
See this issue.
https://github.com/tmk/tmk_keyboard/issues/213#issuecomment-102579416DISCLAIMER:USE AT YOUR OWN RISK. I can not be liable for any damage.
NO FRIENDLY CUSTOMER SUPPORT. You are required to teach yourself first.
NOT PROFESSIONAL JOB. I'm not a professional.
NOT LEAD FREE. I use leaded solder to assemble.
NOTE:-
No plan for USB-C C is a bit too large to plug in USB-mini hole.
More
-
how to change Bluetooth name More
https://geekhack.org/index.php?topic=71517.msg2478134#msg2478134The name 'TmkBT-XXXX' is stored actually in Bluetooth module RN42 and you can change 'TmkBT' part while '-XXXX' part is not configurable and it is last 4digits of bluetooth address.
You can change this line, build and upload firmware.
You can change the name by editing this line then build and upload firmware.
https://github.com/tmk/tmk_keyboard/blob/master/keyboard/hhkb/rn42/rn42_task.c#L160And you have to initialize RN42 module with LShift+RShift+ScrollLock(Fn+O). The intialization is nedeed just once after firmware is updated. Refer to 'MANUAL of Bluetooth Controller' below.
REVISIONS:More
ALL REVISIONS HAS NO ERRATA FOR USB CONTROLLERRev.A: 2013/06
Rev.B: 2014/03
Rev.C: 2014/08
Rev.D: 2014/10 Fix for Bluetooth
https://geekhack.org/index.php?topic=56494.msg1541485#msg1541485Rev.E: 2014/11 Fix for Bluetooth
https://geekhack.org/index.php?topic=56494.msg1556749#msg1556749NO ERRATA found for following revisionsRev.F: 2014/12
Rev.F(batch2): 2015/01
Rev.G: 2015/03
https://geekhack.org/index.php?topic=56494.msg1675635#msg1675635Rev.H: 2015/07 Fix thermal releif spokes for reset/program button
Rev.I: 2015/12 Changed USB mini-B connector SMT to TH
Rev.J 2016/01 Removed C13 and added logo on silk layer
RESOURCES:TMK firmware supports the controller and provides various features for the keyboard. You can use the features fully by building your own firmware from source codes. See following links for the detail.
More
Design files, source codes and the detail of the controller are available.
More
OTHER INFO:Old GB thread: https://geekhack.org/index.php?topic=56494.0USB Type-C: https://geekhack.org/index.php?topic=12047.msg1876688#msg1876688Cover for USB Hub hole by alienman82: https://geekhack.org/index.php?topic=12047.msg1754098#msg1754098Cover for USB Hub hole and Qi charger by manisteinn: https://geekhack.org/index.php?topic=12047.msg1558708#msg1558708Cover by RavenIl: reddit postMANUAL:Firmware/KeymapMore
Keymap EditorYou can try HHKB keymap editor first. You can download pre-build firmware after editing your keymap. Some features are not available but it is easy to use.
http://www.tmk-kbd.com/tmk_keyboard/editor/index.html
Build firmwareIf Keymap Editor is not enough it is time to edit source codes and build firmware yourself.
https://github.com/tmk/tmk_keyboard/wiki#build-firmwarehttps://github.com/tmk/tmk_keyboard/tree/master/keyboard/hhkbIn short,
$ cd keyboard/hhkb
and
make -f Makefile
for USB
$ make -f Makefile.rn42
for BT
Flash FirmwareMore
You can use
dfu-programmer or
Atmel FLIP to program microcontroller on the board. To get controller into bootloader(program) mode you can push red button on back or press key combo "LShift+RShift+Fn+P(Pause)" with default keymap. Microcontroller of board is Atmel
ATMega32u4.
https://github.com/tmk/tmk_keyboard/wiki#flash-firmware InstallationMore
There is good instruciton video. Thank you Tech Intake!
1. Unscrew three bolts on bottom and open case carefully not to damage cables.

2. Unscrew bolt at top right on board first and then unmate connector to remove original board.
Note that you don't need any tool to unmate. See this.
3. Mate with connector of Alt board firmly and screw.
For Bluetooth: Also connect Lipo battery to board. Battery should be fixed with double sided adhesive tape or something but
too strong stickyness may deform and damage battery when you remove it.

4. Close case and scew bolts.
Make sure ferrite core on cables are placed right position like pic above beore screwing, otherwise It won't close decently.
Bluetooth ControllerMore
BT SwitchThis turn on Bluetooth function of controller and switch keyboard into BT mode. When this switch is off keyboard works in USB mode.
BT LED It lights
red when Bluetooth is connected to host,
blinks red(once per second) when waiting for connection and
blinks red(10 times per second) when Bluetooth module is config mode.
BAT LEDWhen keyboard are powered with USB it lights
green if battery is fully charged or ligths
red if charging. And it also lights
red to alarm when not powered and battery is low.
Charging with USBLipo battery can be charged when keyboard is powered with USB cable. You can power it with USB port on PC and 5V USB power adapter. Charging battery with low voltage takes long time or can't charge full. Note that cheap or unpowered USB hub may not be able to supply enough power.
ParingYou can connect keyboard with OS specific method during red BT LED is blinking. You can make up to eight pairing with different hosts, according to manual of RN42.
http://en.wikipedia.org/wiki/Bluetooth#Pairing_and_bondingYou cannot pair with new host during keyboard is connected to a host. To pair with new host you have to disconnect by turning off the host's BT radio, removing pairing info from the host, keeping away enough to make its radio unreachable or use magic command 'p' to remove pairing info from keyboard.
Auto ConnectKeyboard is automatically connected to host once pairing process is done.
Keyboard is always connected host to which keyboard connected last time.This means you can't connect keyboad to other hosts when the last host are in reachable range. In this case you will have to make keyboard into paring mode forcibly using magic command 'p' and redo pairing process.
Magic commandsPrefix of magic command are
LShift + RShift.
-
i displays Bluetooth information on
hid_listen console.
-
b displays battery voltage on console.
-
Delete enter/exits Bluetoot module RN42
config mode on console. See RN42 manual.
-
Scroll Lock initializes module with TMK default configuration.
-
p put keyboard into paring mode focibly. Note that this removes all pairing infos.
-
u switches between USB and Bluetooth mode.
RN42 initializeYou can initialize module when you are in trouble. But you should tarke care to prevent module from being cofigured incompletely or wrongly. Take the following steps.
0. Turn BT swich off and unplug USB cable.
1. open
hid_listen. You can do without it but I recommend.
2. Plug USB cable and wait for keyboard to startup.
3. Press key combo LShift+RShift+ScrollLock(Fn+O).
4. Turn BT switch on. You will see output below on hid_listen.
5. Do not touch keyobard until the command completes or for twenty seconds.
Now module is configured with default setting and in pairing mode. You may need extra power cycle for pairing, try BT switch off and on.
Output on hid_listen from initialize command.
Entering config mode ...
CMD
Ver 6.15 04/26/2013
(c) Roving Networks
ECHO ON
SF,1
AOK
S-,TmkBT
AOK
SS,Keyboard/Mouse
AOK
SM,4
AOK
SW,8000
AOK
S~,6
AOK
SH,003C
AOK
SY,FFF4
AOK
R,1
Reboot!
Exiting config mode ...
RN42 config modeYou need
hid_listen to access this mode. You can change configuration of Bluetooth module with this.
Don't change baud rate! Never! Firmware will lose access to the modlue and you need to communicate to the module with 3.3V UART adapter hardware to fix this problem.
This may brick your BT module. Read all documents of RN42 before do this. DO NOT USE IF YOU ARE NOT SURE.See this for configuration commands.
http://ww1.microchip.com/downloads/en/DeviceDoc/bluetooth_cr_UG-v1.0r.pdfAnd for other documents.
http://www.microchip.com/wwwproducts/Devices.aspx?product=RN42RN42 Factory ResetWhen you make a mess of the module configuration you can do Factory Reset. This resets the module factory default settings.
Quote from manual.
To reset the module to the factory defaults, GPIO4 should be high on
power-up and then toggle low, high, low, high with a 1 second wait between the transitions.
You can toggle GPIO4 with two pads labeled as "F.RST" in pic below. You can turn it high(ON) by closing the pads with tweezer, paper clip, or screwdriver and low(OFF) by keeping open.
http://i.imgur.com/4FxeD1H.jpghttps://geekhack.org/index.php?topic=71517.msg2131887#msg2131887After reset you have to initialize the module to use it as Bluetooth keyboard.
Bluetooth BatteryMore