qmk-dactyl-manuform-a/keyboard/hhkb/README.md

108 lines
3.7 KiB
Markdown
Raw Normal View History

2012-11-01 06:24:21 +01:00
Alternative Controller for HHKB Pro
===================================
2013-11-30 04:32:47 +01:00
I wanted to add some features like vi cursor and mouse keys to my [HHKB][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 and **Type-S**.
2013-07-11 09:23:53 +02:00
See [this thread][AltController] in geekhack.org.
2012-11-01 06:24:21 +01:00
[HHKB]: http://www.pfu.fujitsu.com/hhkeyboard/
2013-07-11 09:23:53 +02:00
[AltController]: http://geekhack.org/index.php?topic=12047.0
2012-11-01 06:24:21 +01:00
##Features
* Customizable keymap
* More keymap layers(more Fn keys)
* Mouse keys
* USB NKRO
2013-07-11 09:23:53 +02:00
See README of [tmk_keyboard] for more.
[tmk_keyboard]: http://github.com/tmk/tmk_keyboard
2012-11-01 06:24:21 +01:00
###Pros
* No risks: Everything is all reversible
* No need for PCB trace patching, case cutting or any other destructive mod
2012-11-01 06:24:21 +01:00
* Can keep original controller intact
2014-01-05 04:52:19 +01:00
* Can change all HHKB behavior as you like
2012-11-01 06:24:21 +01:00
###Cons
* Void your warranty
2013-07-11 09:23:53 +02:00
* Lose USB hub function of Pro2
2012-11-01 06:24:21 +01:00
##DISCLAIMER
2013-07-11 09:23:53 +02:00
I'm not a professional of electronics nor MCU programming. This may damage your HHKB.
2012-11-01 06:24:21 +01:00
And my English writing is poor, I'm not sure I can convey my notions accurately.
2013-07-11 09:23:53 +02:00
##Documents
See [doc/HHKB.txt](doc/HHKB.txt) and files under [doc/](doc/) for internal of HHKB and this controller.
2012-11-01 06:24:21 +01:00
2013-07-11 09:23:53 +02:00
##Build Firmware & Program
See [this document](../../doc/build.md) first.
2012-11-01 06:24:21 +01:00
### Configuration
Set `MCU`, `BOOTLOADER_SIZE` and other build options in `Makefile` and `config.h`.
2012-11-01 06:24:21 +01:00
### Build
2013-11-30 04:32:47 +01:00
Several version of keymap are available in advance but you are recommended to define your favorite layout yourself. Just `make` with `KEYMAP` option like:
2012-11-01 06:24:21 +01:00
2013-11-30 04:32:47 +01:00
$ make KEYMAP=[hasu|hhkb|spacefn|<name>]
2012-11-01 06:24:21 +01:00
### Program
First, push reset button on board to start bootloader.
2012-11-01 06:24:21 +01:00
2014-01-05 04:52:19 +01:00
This command programs the controller with [dfu-programmer] if the tool is installed and configured properly.
2012-11-01 06:24:21 +01:00
$ make dfu
2012-11-01 06:40:24 +01:00
2014-01-05 04:52:19 +01:00
Or you can also use [FLIP] command to program. Also the tool should be installed and configured properly. FLIP GUI application is also available.
2012-11-01 06:24:21 +01:00
$ make flip
2012-11-01 06:40:24 +01:00
Use [Teensy Loader] if your controller is Teensy/Teensy++.
2012-11-01 06:40:24 +01:00
2012-11-01 06:24:21 +01:00
2013-11-30 04:32:47 +01:00
##Keymap
To define your own keymap create file named `keymap_<name>.c` and see keymap document(you can find in top README.md) and existent keymap files.
2012-11-01 06:24:21 +01:00
2013-07-11 09:23:53 +02:00
##Hardware
2014-01-05 04:52:19 +01:00
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.
2013-07-11 09:23:53 +02:00
###1. TMK Alt Controller Board
TMK designed [Keyboard Controller Board for HHKB Pro2(KiCad project)](https://github.com/tmk/HHKB_controller).
See [this post](http://geekhack.org/index.php?topic=12047.msg948923#msg948923).
2013-11-30 04:32:47 +01:00
###2. PJRC Teensy++ 2.0 version
2013-07-11 09:23:53 +02:00
+---------------+
| Teensy++ |
| |
| | HHKB pro HHKB pro2
| | ~~~~~~~~ ~~~~~~~~~
| PB0-2|------->ROW (6-8) (5-7)
| PB3-5|------->COL (9-11) (8-10)
| PB6|------->ENABLE (12) (11)
| PE6|<-------KEY (4) (3)
| PE7|------->PREV (5) (4)
| |
| | 5V--- (1-3) (1-2)
| | GND--- (13-14) (12-13)
+---------------+
- NOTE: PJRC [Teensy](http://www.pjrc.com/teensy/)
2012-11-01 06:24:21 +01:00
2013-11-30 04:32:47 +01:00
###3. V-USB version
See [V-USB controller for HHKB](doc/V-USB.md)
2013-07-11 09:23:53 +02:00
[LUFA]: http://www.fourwalledcubicle.com/LUFA.php
[PJRC]: http://www.pjrc.com/teensy/usb_keyboard.html
[dfu-programmer]: http://dfu-programmer.sourceforge.net/
[FLIP]: http://www.atmel.com/tools/FLIP.aspx
[Teensy Loader]: http://www.pjrc.com/teensy/loader.html
2013-07-11 09:23:53 +02:00
[V-USB]: http://www.obdev.at/products/vusb/index.html