User Tools

Site Tools



Firmware YANG
Keymap Editor YANG
Solder YANG
Seller YANG / KBDFans

For sale:

If you knew about Hasu's HHKB Mod, it is easy to understand this one. Simple to say, it is an power-saving optimized version. The power saving of hardware comes from two ways. One is that the Bluetooth uses a ble module, and the other is that the working voltage needs only 3.3v no 5v. The power saving of software comes from the power saving strategy formulated according to the characteristics of the hardware. Taken together, the battery life may be 6 to 10 times improve from Hasu version. But the biggest hero is still him (the entire HHKB keyboard part of the scanning works), I just stand on the achievements of predecessors and improve the product.

Most information, please refer to the BLE Series Part. Here we mainly talk about some special features of HHKB BLE Mod.

Note: This section is for the latest firmware of

The firmware changelog can be found at: HHKB BLE firmware changelog

Bluetooth Pairing

In short, there is no need to enable pairing mode. When Bluetooth is unconnected and discoverable, you can pair it. Mainly refer to this section: BLE Series

If you have any problem, use this instruction to do troubleshooting: BLE troubleshooting

Hardware Switch of HHKB BLE

There is a physical switch behind the dip switch cover. This is the only switch on the controller. Its function is to turn on/off the battery power supply, not Bluetooth. Thus when this switch is turned off, if you plug in the USB cable, Bluetooth can still work as in this case USB is the power source.

If you want to turn off Bluetooth, refer to Bluetooth switch & connection status.
Note that this software switch is designed to turn off Bluetooth FUNCTION completely for people who only or temporarily only use USB. It is recommended to turn off the physical power switch While this switch is off. It is not designed for turning off Bluetooth daily to save energy as HHKB BLE consumes much more power when standby by using this function than Lock Mode.

Battery Charging

The charging port and data port are both the small USB port on HHKB, not two large USB female ports.

It is recommended to use the computer's USB port or a regular 5v charger to charge the keyboard. Improper charging(like more than 6v) may broke the charging IC. Using a high-power charger will not increase the charging speed as the default charging current is limited to about 450mA. That is to say, it takes about 6 hours to fully charge a 2500mAh battery.

The charging indicator is a red led below the left USB HUB port. You can see it from the back. It has three states:

  1. Low brightness or flicker means abnormal(no battery or battery problem).
  2. High brightness means charging
  3. off or extremely low brightness means that the battery is fully charged.

Generally it is no need to pay too much attention to this indicator light. You can know how long it takes to charge after one charge.

In win10 1809 or later, the battery percentage display is supported. It is not accurate and is for reference only (especially the error displayed during charging will be greater). Every 10% is a level and the highest is 90%. In addition, the percentage is displayed as x1% during charging which is 1% more than when not charging as the following pic shows.

When fully charged, the charging indicator will go off or the brightness will be extremely low.

Mac has blocked the battery service of third-party Bluetooth devices. Thus we can use Output Battery Percetage as Text function (default hotkey for HHKB BLE is Fn+E) if we want to know the battery level: Charge & Battery Information

Edit Keymap

The firmware is based on tmk and can be set on Various keyboard functions can be set through the web page.

Reflash Firmware

Please refer to this:Mass Storage Device Bootloader(like disk drive)

After entering the bootloader(flash mode), three indicators on the top right of the HHKB BLE controller will flash. LED3(green) will flash quickly when writing firmware to the controller.

If these three leds are not soldered or your hhkb case is black, you can't know their status, but you can still see LED3 under the right USB port.

Indicators and Power Saving

Common functions for indicators can be defined by LEDMAP( LEDMAP). The indicator lights only when the keyboard is working, not power saving. It is recommended not to set any indicators to a function that may keep it constantly on as that may increase the power consumption and significantly reduce the battery life.

Default LEDMAP Setting is LED1 for CapsLock,LED2 for Layer1(fn),LED3 for Layer2.

Besides LEDMAP setting, they have some other special functions.

  1. When entering Lock Mode, the three lights are all on first, then off one by one from right to left.
  2. When waking up from deep power saving, the three indicators will be on at the same time and then off.
  3. When the battery is low, the three indicators will flash at the same time when using the keyboard. You can still use it for two or three days after low battery alert.
  4. When the battery is extremely low, the three indicators will flash very fast(about 3 times per second) at the same time when using the keyboard. It is recommended to charge it as soon as possible.

Then about the power saving mode:

  1. After the keyboard is idle for 3 seconds without pressing any key, it enters the general power saving mode. At this mode, the matrix is scanned every 30ms. If there is any key pressed, it exits the general power saving mode.
  2. If the keyboard's bluetooth is not connected for 90 seconds, or it is idle for more than 2.5 hours, it will turn off bluetooth and enter the deep power saving mode. Press and hold any key for 3 to 5 seconds to wake it up.
  3. Using Lock Mode will directly make the keyboard enter deep power saving mode. The difference from 2 is that by this way, you can press and hold only F and J together for 3 to 5 seconds to wake it up.

To see bluetooth connection status, press LShift+RShift+S:

  1. The LED3 flashes. During the flashing process, its on and off time are the same. This means bluetooth is not connected.
  2. The LED2 and LED3 flash slowly. During the flashing process, their light-on time is significantly longer than the light-off time. This means bluetooth is connected.

The black hhkb can't use leds in the front. But with another LED3 below the right USB port, it can show most status.

The power consumption of the deep power saving mode is very low. For daily use you don't need to turn the power switch off, just leave the keybaord to let itselt enter power saving mode. If you want take it away in a bag, it is recommended to make it enter Lock Mode to prevent unexpectedly wake up.


The built-in interface is a miniUSB, so the USB HUB here supports USB 2.0 high speed at the highest.

In addition to the two USB ports on the HHKB case, there is an extra USB Port on the controller inside the keyboard. It is forbidden to connect high-current devices to these USB ports. The power supply of the internal USB port is controllable. The control function can be selected in LEDs & Functions. . You can put an USB Disk in it or just leave it with nothing.

Exception Handling

If there is a key press error trigger or random trigger. Please confirm whether the battery is insulated from the hhkb upper keyboard circuit board according to the installation instructions provided by taobao link.

If something goes wrong during work, the quickest way is to re-plug the USB cable or switch the keyboard power switch off and on again to check if it works well again.

If you have problems using it after pairing, see the BLE Series section. Generally, detele the bonding information and re-pairi can solve most problems. If that not works, please refer to Reset Bluetooth.   If any other bugs, email me.

Hardware Differences

Make a note of the differences between the hardware versions I've sold so that others can check.


The difference from v2.3 is that 5V is no longer supported, only 3.3V is kept. This version only supports HHKB Pro2 (including Type-S, US layout). The internal USB socket has been moved to the controller PCB.


First official release. 5v and 3.3v are supported, but the 5v circuit is unsoldered. Support HHKB Pro2 (including Type-S, US layout) and HHKB JP.
en/kb-mods/hhkb-ble.txt · Last modified: 2020/04/07 04:16 by yangdigi