mirror of
https://github.com/qmk/qmk_firmware
synced 2024-12-22 16:36:58 +00:00
152 lines
4.4 KiB
Plaintext
152 lines
4.4 KiB
Plaintext
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
|