1
0
Fork 0
qmk_firmware/keyboard/hhkb
tmk ea60dae6e6 Fix for new API(key_t to keypos_t) 2014-07-30 14:38:25 +09:00
..
doc Fix document on HHKB internal 2014-07-09 16:33:40 +09:00
Makefile Fix 'debug-off' target of hhkb to remove 'print' 2014-07-20 00:37:49 +09:00
Makefile.iwrap Add support of iWRAP5 2013-04-18 15:52:23 +09:00
Makefile.nodebug Make keymap_hhkb as default and change keymap_hasu 2014-06-12 17:19:58 +09:00
Makefile.pjrc Add new keymap framework 2013-11-29 09:12:28 +09:00
Makefile.vusb Changed Makefile and config.h for new options 2013-03-21 15:34:36 +09:00
README.md Fix READEM of hhkb and doc/build.md 2014-07-10 15:28:36 +09:00
config.h Add HHKB JP support 2014-07-09 15:31:52 +09:00
config_iwrap.h Delete MOUSEKEY_DELAY_TIME in config.h 2013-10-28 11:32:19 +09:00
config_vusb.h Delete MOUSEKEY_DELAY_TIME in config.h 2013-10-28 11:32:19 +09:00
hhkb_avr.h Fix READEM of hhkb and doc/build.md 2014-07-10 15:28:36 +09:00
iwrap.txt Improve documentation 2012-11-01 14:24:21 +09:00
keymap_common.c Fix for new API(key_t to keypos_t) 2014-07-30 14:38:25 +09:00
keymap_common.h Add HHKB JP support 2014-07-09 15:31:52 +09:00
keymap_hasu.c Make keymap_hhkb as default and change keymap_hasu 2014-06-12 17:19:58 +09:00
keymap_hhkb.c Add new keymap framework 2013-11-29 09:12:28 +09:00
keymap_jp.c Add HHKB JP support 2014-07-09 15:31:52 +09:00
keymap_spacefn.c Add Ctrl + Up(SpaceFN) -> PgUp 2014-06-12 17:23:02 +09:00
led.c Add Caps Lock LED on PD6 2013-07-11 09:07:02 +09:00
matrix.c Add HHKB JP support 2014-07-09 15:31:52 +09:00
usbconfig.h Made directories for keyboard and converter projects. 2012-06-08 13:32:38 +09:00

README.md

Alternative Controller for HHKB Pro

I wanted to add some features like vi cursor and mouse keys to my HHKB but its controller is not programmable and firmware source code is not open, of course. This means customizing this keyboard needs to replace original controller with programmable one.

This controller can work with HHKB Professional, Professional 2, JP and Type-S.

See this thread in geekhack.org.

##Features

  • Customizable keymap
  • More keymap layers(more Fn keys)
  • Mouse keys
  • USB NKRO

See README of tmk_keyboard for more.

###Pros

  • No risks: Everything is all reversible
  • No need for PCB trace patching, case cutting or any other destructive mod
  • Can keep original controller intact
  • Can change all HHKB behavior as you like

###Cons

  • Void your warranty
  • Lose USB hub function of Pro2

##DISCLAIMER I'm not a professional of electronics nor MCU programming. This may damage your HHKB. And my English writing is poor, I'm not sure I can convey my notions accurately.

##Documents See doc/HHKB.txt and files under doc/ for internal of HHKB and this controller.

##Build Firmware & Program See this document first.

Configuration

Set MCU, BOOTLOADER_SIZE and other build options in Makefile and config.h. If your target is HHKB JP you need to set HHKB_JP build option in Makefile.

Build

Several version of keymap are available in advance but you are recommended to define your favorite layout yourself. Just make with KEYMAP option like:

$ make KEYMAP=[hasu|hhkb|spacefn|<name>]

Program

First, push reset button on board to start bootloader.

This command programs the controller with dfu-programmer if the tool is installed and configured properly.

$ make dfu

Or you can also use FLIP command to program. Also the tool should be installed and configured properly. FLIP GUI application is also available.

$ make flip

Use Teensy Loader if your controller is Teensy/Teensy++.

##Keymap To define your own keymap create file named keymap_<name>.c and see keymap document and existent keymap files.

##Hardware You have some options for hardware. Development boards with USB AVR family(ATMega32U4, AT90USB1286) like Teensy will work while MegaAVR with V-USB library is also cheaper option for DIY.

###1. TMK Alt Controller Board Design files are available at Keyboard Controller Board for HHKB(KiCad project) and see Controller Distribution thread if you get an assembled one.

###2. PJRC Teensy See this thread.

###3. V-USB version See V-USB controller for HHKB.