Keyboard firmwares for Atmel AVR and Cortex-M
Du kannst nicht mehr als 25 Themen auswählen Themen müssen mit entweder einem Buchstaben oder einer Ziffer beginnen. Sie können Bindestriche („-“) enthalten und bis zu 35 Zeichen lang sein.
tmk 6284b147c2 add debouncing into macway/matrix.c. vor 12 Jahren
adb_usb Added Bulegiga iWRAP support into HHKB.(Bluetooth) vor 12 Jahren
hhkb Added Bulegiga iWRAP support into HHKB.(Bluetooth) vor 12 Jahren
iwrap Added Bulegiga iWRAP support into HHKB.(Bluetooth) vor 12 Jahren
macway add debouncing into macway/matrix.c. vor 12 Jahren
pjrc Refactored bootloader jumping. Added USBaspLoader support. vor 12 Jahren
ps2_usb Added Bulegiga iWRAP support into HHKB.(Bluetooth) vor 12 Jahren
vusb Refactored bootloader jumping. Added USBaspLoader support. vor 12 Jahren
.gitignore add mouse function. vor 13 Jahren
COPYING.GPLv2 added copyright and license notice. vor 13 Jahren
COPYING.GPLv3 added copyright and license notice. vor 13 Jahren
LICENSE.txt added copyright and license notice. vor 13 Jahren
POWER.txt Added Bulegiga iWRAP support into HHKB.(Bluetooth) vor 12 Jahren
README Added Bulegiga iWRAP support into HHKB.(Bluetooth) vor 12 Jahren
USB_NKRO.txt Add PS/2 mouse support to connect TrackPoint Unit. vor 13 Jahren
adb.c added copyright and license notice. vor 13 Jahren
adb.h added copyright and license notice. vor 13 Jahren
bootloader.c Refactored bootloader jumping. Added USBaspLoader support. vor 12 Jahren
bootloader.h Refactored bootloader jumping. Added USBaspLoader support. vor 12 Jahren
command.c Refactored bootloader jumping. Added USBaspLoader support. vor 12 Jahren
command.h Added Bulegiga iWRAP support into HHKB.(Bluetooth) vor 12 Jahren
common.mk Refactored bootloader jumping. Added USBaspLoader support. vor 12 Jahren
controller_teensy.h added copyright and license notice. vor 13 Jahren
debug.h added copyright and license notice. vor 13 Jahren
host.c Added Bulegiga iWRAP support into HHKB.(Bluetooth) vor 12 Jahren
host.h Added Bulegiga iWRAP support into HHKB.(Bluetooth) vor 12 Jahren
host_driver.h Added Bulegiga iWRAP support into HHKB.(Bluetooth) vor 12 Jahren
iwrap.mk Added Bulegiga iWRAP support into HHKB.(Bluetooth) vor 12 Jahren
keyboard.c Added Bulegiga iWRAP support into HHKB.(Bluetooth) vor 12 Jahren
keyboard.h added copyright and license notice. vor 13 Jahren
keymap.h added copyright and license notice. vor 13 Jahren
layer.c Added Bulegiga iWRAP support into HHKB.(Bluetooth) vor 12 Jahren
layer.h added copyright and license notice. vor 13 Jahren
led.h added copyright and license notice. vor 13 Jahren
matrix.h added copyright and license notice. vor 13 Jahren
mousekey.c Added Bulegiga iWRAP support into HHKB.(Bluetooth) vor 12 Jahren
mousekey.h added copyright and license notice. vor 13 Jahren
pjrc.mk Refactored bootloader jumping. Added USBaspLoader support. vor 12 Jahren
print.c Added Bulegiga iWRAP support into HHKB.(Bluetooth) vor 12 Jahren
print.h Added Bulegiga iWRAP support into HHKB.(Bluetooth) vor 12 Jahren
ps2.c added copyright and license notice. vor 13 Jahren
ps2.h added copyright and license notice. vor 13 Jahren
ps2_mouse.c added copyright and license notice. vor 13 Jahren
ps2_mouse.h added copyright and license notice. vor 13 Jahren
ps2_usart.c added copyright and license notice. vor 13 Jahren
report.h Added Bulegiga iWRAP support into HHKB.(Bluetooth) vor 12 Jahren
rules.mk Added Bulegiga iWRAP support into HHKB.(Bluetooth) vor 12 Jahren
sendchar.h Added Bulegiga iWRAP support into HHKB.(Bluetooth) vor 12 Jahren
sendchar_null.c Added Bulegiga iWRAP support into HHKB.(Bluetooth) vor 12 Jahren
sendchar_uart.c Added Bulegiga iWRAP support into HHKB.(Bluetooth) vor 12 Jahren
timer.c Added Bulegiga iWRAP support into HHKB.(Bluetooth) vor 12 Jahren
timer.h Added Bulegiga iWRAP support into HHKB.(Bluetooth) vor 12 Jahren
uart.c Added Bulegiga iWRAP support into HHKB.(Bluetooth) vor 12 Jahren
uart.h Added Bulegiga iWRAP support into HHKB.(Bluetooth) vor 12 Jahren
usb_keycodes.h Added Bulegiga iWRAP support into HHKB.(Bluetooth) vor 12 Jahren
util.c added copyright and license notice. vor 13 Jahren
util.h added copyright and license notice. vor 13 Jahren
vusb.mk Refactored bootloader jumping. Added USBaspLoader support. vor 12 Jahren

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
EXTRAKEY_ENABLE = yes # Enhanced feature for Windows(Audio control and System control)
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