di0ib
/
tmk_keyboard
Segui 1
Vota 0
Forka 0
Codice Rilasci 4 Attività
Keyboard firmwares for Atmel AVR and Cortex-M
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
103 Commit
3 Rami (Branch)
Albero (Tree): f382fc93d5
Rami (Branch) Tag
${ item.name }
Crea branch ${ searchTerm }
da 'f382fc93d5'
${ noResults }
tmk f382fc93d5 Change layer pram and keymap of HHKB. Fix vusb/host.c. 13 anni fa
adb_usb added HHKB/README and clean some codes. 13 anni fa
hhkb Change layer pram and keymap of HHKB. Fix vusb/host.c. 13 anni fa
macway added HHKB/README and clean some codes. 13 anni fa
pjrc Added PS/2 multimeda key support. 13 anni fa
ps2_usb Added PS/2 multimeda key support. 13 anni fa
vusb Change layer pram and keymap of HHKB. Fix vusb/host.c. 13 anni fa
.gitignore add mouse function. 13 anni fa
Makefile.common host interface for pjrc 13 anni fa
Makefile.pjrc host interface for pjrc 13 anni fa
Makefile.rules integrate V-USB support into ps2_usb 13 anni fa
Makefile.vusb move files: main_vusb.c ps2_usart.c sendchar_usart.c from ps2_usb to common dir 13 anni fa
README v3.0 cleanse files 13 anni fa
USB_NKRO.txt Add PS/2 mouse support to connect TrackPoint Unit. 13 anni fa
adb.c FIX: send last report when idle timeouts. (pjrc) 13 anni fa
adb.h ADB keyboard LEDs support 13 anni fa
command.c Add special keycodes for media control. Fix power down command. 13 anni fa
command.h host interface for pjrc 13 anni fa
controller_teensy.h ADD: keymap macro for human to read easier 13 anni fa
debug.h improve layer switching 13 anni fa
host.h Added PS/2 multimeda key support. 13 anni fa
keyboard.c Added PS/2 multimeda key support. 13 anni fa
keyboard.h host interface for pjrc 13 anni fa
keymap.h integrate V-USB support into ps2_usb 13 anni fa
layer.c Change layer pram and keymap of HHKB. Fix vusb/host.c. 13 anni fa
layer.h refactor keyboard.h, host.h 13 anni fa
led.h added protocol stack: pjrc, vusb 13 anni fa
main_pjrc.c integrate V-USB support into ps2_usb 13 anni fa
main_vusb.c move files: main_vusb.c ps2_usart.c sendchar_usart.c from ps2_usb to common dir 13 anni fa
matrix.h integrate V-USB support into ps2_usb 13 anni fa
mousekey.c host interface for pjrc 13 anni fa
mousekey.c.bak refactor keyboard.h, host.h 13 anni fa
mousekey.h refactor keyboard.h, host.h 13 anni fa
mousekey.h.bak refactor keyboard.h, host.h 13 anni fa
print.c added PS/2 to USB converter use V-USB as protocol stack 13 anni fa
print.h added PS/2 to USB converter use V-USB as protocol stack 13 anni fa
ps2.c added initial V-USB support for HHKB 13 anni fa
ps2.h Synchronous USART support for PS/2 on V-USB stack 13 anni fa
ps2_mouse.c refactor keyboard.h, host.h 13 anni fa
ps2_mouse.h add error handling to ps2_mouse 13 anni fa
ps2_usart.c move files: main_vusb.c ps2_usart.c sendchar_usart.c from ps2_usb to common dir 13 anni fa
sendchar.h added PS/2 to USB converter use V-USB as protocol stack 13 anni fa
timer.c added PS/2 to USB converter use V-USB as protocol stack 13 anni fa
timer.h added PS/2 to USB converter use V-USB as protocol stack 13 anni fa
usb_keycodes.h Add special keycodes for media control. Fix power down command. 13 anni fa
util.c add build option: NKRO_ENABLE(remove: USB_12KRO) 13 anni fa
util.h new build method for macway 13 anni fa

README 

t.m.k. Keyboard Firmware
========================
This is keyboard firmware for Teensy(AVR USB MCU) and V-USB board.

source code repository:
http://github.com/tmk/tmk_keyboard

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
PS2 to USB: http://geekhack.org/showwiki.php?title=Island:14618
ADB to USB: http://geekhack.org/showwiki.php?title=Island:14290

The project is heavily based on PJRC USB Keyboard/Mouse Example and
owes a debt to preceding keyboard firmware projects.
http://www.pjrc.com/teensy


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
-----------


Files & Directories
-------------------
Target:
hhkb/                           keyboard controller for PFU HHKB pro
macway/                         keyboard controller for Macway mod
ps2_usb/                        PS2 to USB keyboard converter
adb_usb/                        ADB to USB keyboard converter

USB Protocol Stack:
pjrc/                           PJRC  USB stack
vusb/                           V-USB USB stack
ps2.[ch]                        PS/2 protocol
adb.[ch]                        ADB protocol


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

$ cd <target>
$ 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 <COMMAND> + H to debug menu. 
(see config.h for <COMMAND> key combination.)

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