Go to file
2011-02-22 03:08:49 +09:00
adb added note about external pull resistor on DATA line. 2011-02-13 23:02:08 +09:00
hhkb change keycodes and define keymap macro for AEK. 2011-01-13 16:39:49 +09:00
macway changed special mode key for macway: Left Shift + Right Shift 2011-01-17 00:35:24 +09:00
ps2_usb Exceptional handling for PS/2 scan code set 2 2011-01-25 00:53:49 +09:00
ps2_vusb added PS/2 to USB converter use V-USB as protocol stack 2011-02-22 03:08:49 +09:00
usbdrv added PS/2 to USB converter use V-USB as protocol stack 2011-02-22 03:08:49 +09:00
.gitignore add mouse function. 2010-09-30 14:50:23 +09:00
adb.c ADB keyboard LEDs support 2011-01-13 22:46:57 +09:00
adb.h ADB keyboard LEDs support 2011-01-13 22:46:57 +09:00
ADB.txt added description of ADB socket pintouts. 2011-01-17 00:38:16 +09:00
controller_teensy.h ADD: keymap macro for human to read easier 2010-10-26 21:32:45 +09:00
debug.h improve layer switching 2010-10-30 01:16:47 +09:00
jump_bootloader.c Add PS/2 mouse support to connect TrackPoint Unit. 2011-01-02 23:52:13 +09:00
jump_bootloader.h add jump_bootloader. 2010-09-24 15:16:23 +09:00
key_process.c PS/2 to USB keyboard converter 2011-01-23 04:10:35 +09:00
key_process.h hhkb: refactored 2010-10-24 01:17:26 +09:00
keymap_skel.h changed signature of keymap_fn_layer() in keymap_skel.h. 2011-01-06 15:37:14 +09:00
layer.c rewrite code of layer switching 2011-01-23 04:19:17 +09:00
layer.h rewrite code of layer switching 2011-01-23 04:19:17 +09:00
Makefile.common PS/2 to USB keyboard converter 2011-01-23 04:10:35 +09:00
Makefile.vusb added PS/2 to USB converter use V-USB as protocol stack 2011-02-22 03:08:49 +09:00
matrix_skel.h added config option: MATRIX_HAS_GHOST and fixed some on matrix.c 2011-01-06 15:33:08 +09:00
mousekey.c fixed mousekey delay to do double/triple click easily. 2011-01-25 01:01:13 +09:00
mousekey.h Add PS/2 mouse support to connect TrackPoint Unit. 2011-01-02 23:52:13 +09:00
print.c added PS/2 to USB converter use V-USB as protocol stack 2011-02-22 03:08:49 +09:00
print.h added PS/2 to USB converter use V-USB as protocol stack 2011-02-22 03:08:49 +09:00
ps2_mouse.c add error handling to ps2_mouse 2011-01-04 20:30:23 +09:00
ps2_mouse.h add error handling to ps2_mouse 2011-01-04 20:30:23 +09:00
ps2.c PS/2 to USB keyboard converter 2011-01-23 04:10:35 +09:00
ps2.h PS/2 to USB keyboard converter 2011-01-23 04:10:35 +09:00
README PS/2 to USB keyboard converter 2011-01-23 04:10:35 +09:00
sendchar.h added PS/2 to USB converter use V-USB as protocol stack 2011-02-22 03:08:49 +09:00
timer.c added PS/2 to USB converter use V-USB as protocol stack 2011-02-22 03:08:49 +09:00
timer.h added PS/2 to USB converter use V-USB as protocol stack 2011-02-22 03:08:49 +09:00
tmk.c Add PS/2 mouse support to connect TrackPoint Unit. 2011-01-02 23:52:13 +09:00
TODO added a file TODO. 2011-01-06 19:07:35 +09:00
usb_debug.c divide usb_keyboard_debug.[c|h] into usb_device, usb_keyboard, usb_debug. 2010-09-23 20:23:50 +09:00
usb_debug.h add mouse function. 2010-09-30 14:50:23 +09:00
usb_extra.c add system controls(power down/wake up) from generic desktop page(HID) 2010-11-18 22:35:49 +09:00
usb_extra.h add a build option: USB_EXTRA_ENABLE 2011-01-05 00:19:43 +09:00
usb_keyboard.c Add PS/2 mouse support to connect TrackPoint Unit. 2011-01-02 23:52:13 +09:00
usb_keyboard.h Add PS/2 mouse support to connect TrackPoint Unit. 2011-01-02 23:52:13 +09:00
usb_keycodes.h added some short keycode names for ISO and JIS keyboard. 2011-02-17 13:29:50 +09:00
usb_mouse.c Add PS/2 mouse support to connect TrackPoint Unit. 2011-01-02 23:52:13 +09:00
usb_mouse.h Add PS/2 mouse support to connect TrackPoint Unit. 2011-01-02 23:52:13 +09:00
USB_NKRO.txt Add PS/2 mouse support to connect TrackPoint Unit. 2011-01-02 23:52:13 +09:00
usb.c add a build option: USB_EXTRA_ENABLE 2011-01-05 00:19:43 +09:00
usb.h PS/2 to USB keyboard converter 2011-01-23 04:10:35 +09:00
util.c add build option: NKRO_ENABLE(remove: USB_12KRO) 2010-12-08 01:57:55 +09:00
util.h new build method for macway 2010-10-27 22:56:01 +09:00

t.m.k. Keyboard Firmware
========================
http://github.com/tmk/tmk_keyboard

This is keyboard firmware for AVR USB MCUs or Teensy/Teensy++.
http://www.pjrc.com/teensy

The project is heavily based on PJRC USB Keyboard/Mouse Example and
owes a debt to preceding keyboard firmware projects.

This firmware is used in following projects:
HHKB mod:   http://geekhack.org/showwiki.php?title=Island:12047
Macway mod: http://geekhack.org/showwiki.php?title=Island:11930


Features
--------
Mouse key
    control mouse cursor from keyboard.
System Control Key
    Power Down, Sleep, Wake Up & USB Remote Wake up
Media Control Key
    Volume Down/Up, Mute
USB NKRO
    send 120 keys(+ 8 modifiers) at most simultaneously.
PS/2 mouse support
    integrate PS/2 mouse(TrackPoint) into keyboard as composite device.


Limitations
-----------


Build
-----
To compile needs AVR GCC, AVR Libc and GNU make.
You can use WinAVR on Windows.  http://winavr.sourceforge.net/

$ cd <target> (hhkb or macway currently)
$ make

The firmware will be compiled as a file tmk_<target>.hex.


Build your own firmware
-----------------------
Copying exsistent target(macway) is easy way.
1. Copy contens of macway/ to your own target directory.
2. Edit Makefile. See next section.
3. Edit config.h. See next section.
4. Edit matrix.c. You will need to fix followings at least.
     matrix_init()
     matrix_scan()
     read_col()
     unselect_rows()
     select_row()
5. Edit keymap.c. NOTE: It is not final design and a bit messy.
   You will need to fix followings at least.
     KEYMAP
     fn_layer[]
     fn_keycode[]
     keymaps[]
6. Build.

If you have a build error like following, comment out "--relax" option in Makefile.common.
    (.vectors+0x30): relocation truncated to fit: R_AVR_13_PCREL against symbol `__vector_12'


Build Options
-------------
<target>/Makefile:
1. Set target name for your firmware.
     TARGET = tmk_<target>
2. Choose a MCU and its frequency.
     MCU = atmega32u4       # Teensy 2.0
     #MCU = at90usb1286      # Teensy++ 2.0
     F_CPU = 16000000
3. Choose optional modules as needed. Comment out to disable optional modules.
     MOUSEKEY_ENABLE = yes	# Mouse keys
     PS2_MOUSE_ENABLE = yes	# PS/2 mouse(TrackPoint) support
     USB_EXTRA_ENABLE = yes	# Enhanced feature for Windows(Audio control and System control)
     USB_NKRO_ENABLE = yes	# USB Nkey Rollover

<target>/config.h:
1. USB vendor/product ID and device description
     #define VENDOR_ID       0xFEED
     #define PRODUCT_ID      0xBEEF
     /* device description */
     #define MANUFACTURER    t.m.k.
     #define PRODUCT         Macway mod
     #define DESCRIPTION     t.m.k. keyboard firmware for Macway mod
2. Keyboard matrix configuration
     #define MATRIX_ROWS 8
     #define MATRIX_COLS 8
     #define MATRIX_HAS_GHOST
3. Mouse keys configuration if needed.
4. PS/2 mouse configuration if needed.


Debuging & Rescue
-----------------
Use PJRC's hid_listen.exe to see debug messages.
Press right Control + Shift + Alt + GUI + H to debug menu. 

Pressing any 3 keys when connected enables debug output.
Pressing any 4 keys when connected makes bootloader comes up.


Projects related
----------------
PJRC USB Keyboard/Mouse Example
    http://www.pjrc.com/teensy/usb_keyboard.html
    http://www.pjrc.com/teensy/usb_mouse.html
kbupgrade
    http://github.com/rhomann/kbupgrade
    http://geekhack.org/showwiki.php?title=Island:8406
c64key
    http://symlink.dk/projects/c64key/
rump
    http://mg8.org/rump/
    http://github.com/clee/rump
dulcimer
    http://www.schatenseite.de/dulcimer.html
humblehacker-keyboard
    http://github.com/humblehacker
    http://www.humblehacker.com/keyboard/
    http://geekhack.org/showwiki.php?title=Island:6292
ps2avr
    http://sourceforge.net/projects/ps2avr/


EOF