]> git.friedersdorff.com Git - max/tmk_keyboard.git/blobdiff - README
v2.0: HHKB/Macway support merged
[max/tmk_keyboard.git] / README
diff --git a/README b/README
index 4b10d663ea95debb9c5e08bbaece58a2eef855d0..e5463401a4b9dc1f535aab5da9538fcfade3e8df 100644 (file)
--- a/README
+++ b/README
@@ -1,48 +1,70 @@
-Keyboard Firmware
-=================
-2010/08/23 noname
+t.m.k. Keyboard Firmware
+========================
+http://github.com/tmk/tmk_keyboard
 
+This is keyboard firmware for PFU HHKB style keyboard and Teensy/Teensy++ 2.0.
+OS see this as composite device which has keyboard and mouse.
 
-VERSION
+The project is heavily based on PJRC USB Keyboard/Mouse Example and
+owes a debt to preceding keyboard firmware projects.
+
+
+Version
 -------
 0.1     2010/08/23
-        implemented for macway modified.
-        It works as normal keyboard now.
+        It works as normal keyboard.
+        It is for modified Macway keyboard(TP-999KB-E).
 
+1.0     2010/10/02
+        keyboard has mouse key now.
+        keyboard with layers.(see keymap.c)
+            FN_1(right cmd):
+                vi style layer
+            FN_2(next to right shift):
+                HHKB style layer
+            FN_3(left bottom):
+                h j k l:   mouse move
+                a s d spc: mouse buttons
+                m ,:       mouse wheel
 
-TODO
-----
-modulization
-    clean source
-debouncing
-anti-ghost
-sleep&wakeup
-boot keyboard support
-mouse key
-keymap layer
-    key combination switch
-    toggle siwtch
-    HHKB like cursor etc.
-setting menu(wizard)
-    debug console
-    keymap setting
-    matrix display
-PS/2 keyboard mode
-HHKB support
-Trackpoint(PS/2) support
-    Thinkpad keyboard support
+1.1     2010/10/08
+        Matrix wiring changed for casing.
+        (and my Teensy PD3 seems to be latchuped and unusable. :<)
 
+1.2     2010/10/13
+        HHKB support
+        horizontal mouse wheel support
+        change keymaps
 
-target board
-------------
-Teensy 2.0
+2.0     2010/10/27
+        HHKB/Macway support merged
+
+
+Build
+-----
+Compiling sources need AVR GCC, AVR Libc and GNU make.(You can use WinAVR on Windows.)
+
+$ cd <target> (hhkb or macway)
+$ make
+
+
+Debuging
+--------
+Debug print is on if 4 keys are pressed during booting. 
+Use PJRC's hid_listen.exe to see debug messages.
+
+
+AVR Target board
+----------------
+Teensy/Teensy++
 http://www.pjrc.com/teensy
 
 
-projects based on/related to
-----------------------------
-PJRC USB Keyboard Example
+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
@@ -61,4 +83,59 @@ ps2avr
     http://sourceforge.net/projects/ps2avr/
 
 
+TODO & ideas
+------------
+licensing notes(GPL)
+    I think GPL is not infringement of PJRC license.
+souce code cleaning
+sleep&wakeup
+debouncing logic
+    will be coded when bouncing occurs.
+    bouncing doesnt occur on my ALPS switch so far.
+    scan rate is too slow?(to be measure)
+layer switching
+    time before switching
+    timeout when not used during specific time
+
+Trackpoint(PS/2)
+    receive PS/2 signal from TrackPoint
+    send USB HID report
+Thinkpad keyboard support
+    turn keyboard to USB keyboard/mouse composite device
+setting menu(configure without changing firmware)
+    console for display
+    keymap/layer setting
+    mouse speed/acceleration
+    matrix display
+PS/2 keyboard mode
+    with USB to PS/2 dumb adapter(possible?)
+AT90USBKEY support
+    and other AVR USB boards
+
+DONE:
+support for HHKB pro matrix signal
+    exchange controller board with teensy
+    2010/10/11
+keymap
+    Matias half keyboard style
+    2010/10/23
+souce code cleaning
+    2010/10/23
+debug on/off
+    debug off by default
+    pressing keys during booting
+    2010/10/23
+mouse horizontal wheel
+    http://www.microchip.com/forums/tm.aspx?high=&m=391435&mpage=1#391521
+    http://www.keil.com/forum/15671/
+    http://www.microsoft.com/whdc/device/input/wheel.mspx
+    2010/10/13
+debug on/off
+    Fn key conbination during normal operation
+    matrix print on/off
+    key print on/off
+    mouse print on/off
+    2010/10/26
+
+
 EOF