Copy of https://github.com/qmk/qmk_firmware Modified for our keyboard.

Go to file

tmk c5060ea819 test build of 'Host shield' in minimal env.		12 years ago
common	test build of 'Host shield' in minimal env.	12 years ago
converter	Fix Makefiles.	13 years ago
doc	Moved files to common, protocol and doc directory	13 years ago
keyboard	Add CONSOLE_ENABLE build option to LUFA.	13 years ago
protocol	test build of 'Host shield' in minimal env.	12 years ago
.gitignore	add mouse function.	14 years ago
.gitmodules	Add USB_Host_Shield_2.0 and arduino-1.0.1 in usb_hid.	12 years ago
README.md	Fix README.md: remove bad links	13 years ago
common.mk	test build of 'Host shield' in minimal env.	12 years ago
protocol.mk	Made directories for keyboard and converter projects.	13 years ago
rules.mk	test build of 'Host shield' in minimal env.	12 years ago

README.md

t.m.k. Keyboard Firmware Collection

This is a keyboard firmware with some features for Atmel AVR controller.

Source code is available here: http://github.com/tmk/tmk_keyboard

Features

Mouse key - Mouse control by keyboard.
System Control Key - Power Down, Sleep, Wake Up and USB Remote Wake up.
Media Control Key - Volume Down/Up, Mute, Next/Prev track, Play, Stop and etc.
USB NKRO - Can send 120 keys(+ 8 modifiers) simultaneously.
PS/2 mouse support - integrate PS/2 mouse(TrackPoint) into keyboard as composite device.
keyboard protocols - PS/2, ADB and old keyboard protocols.

Projects

converter

ps2_usb - PS/2 keyboard to USB
adb_usb - ADB keyboard to USB
m0110_usb - Machintosh 128K/512K/Plus keyboard to USB
terminal_usb - IBM Model M terminal keyboard(PS/2 scancode set3) to USB
news_usb - Sony NEWS keyboard to USB
x68k_usb - Sharp X68000 keyboard to USB

keyboard

hhkb - Happy Hacking Keyboard professional
macway - Compact keyboard mod
hbkb - Happy Buckling sprint keyboard(IBM Model M mod)

Files & Directories

Top

common/ - common codes
protocol/ - keyboard protocol support
keyboard/ - keyboard projects
converter/ - protocol converter projects
doc/ - documents
common.mk - Makefile for common
protoco.mk - Makefile for protocol
rules.mk - Makefile for build rules

Keyboard Protocols

pjrc/ - PJRC USB stack
vusb/ - Objective Development V-USB
iwrap/ - Bluetooth HID for Bluegiga iWRAP
ps2.c - PS/2 protocol
adb.c - Apple Desktop Bus protocol
m0110.c - Macintosh 128K/512K/Plus keyboard protocol
news.c - Sony NEWS keyboard protocol
x68k.c - Sharp X68000 keyboard protocol

Build & Program

Build firmware

To compile you need AVR GCC, AVR Libc and GNU make. You can use WinAVR on Windows and CrossPack on Mac.

$ cd <project>
$ make

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

Program Controller

If you have a proper program command in Makefile just type this.

$ make program

As for Teensy you can use PJRC's loader to program hex file. http://www.pjrc.com/teensy/loader.html

Makefile Options

1. MCU and Frequency.

MCU = atmega32u4       # Teensy 2.0
#MCU = at90usb1286      # Teensy++ 2.0
F_CPU = 16000000

2. Features

Note that comment out to disable them.

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

3. Programmer

Set proper command for your controller, bootloader and programmer.

# for PJRC Teensy
PROGRAM_CMD = teensy_loader_cli -mmcu=$(MCU) -w -v $(TARGET).hex

# for Atmel AT90USBKEY
PROGRAM_CMD = dfu-programmer $(MCU) flash $(TARGET).hex

# avrdude
PROGRAM_CMD = avrdude -p $(MCU) -c avrispmkII -P USB -U flash:w:$(TARGET).hex
PROGRAM_CMD = avrdude -p $(MCU) -c usbasp -U flash:w:$(TARGET).hex
PROGRAM_CMD = avrdude -p $(MCU) -c arduino -P COM1 -b 57600 -U flash:w:$(TARGET).hex

config.h Options

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

4. PS/2 mouse

5. COMMAND key combination

#define IS_COMMAND() (keyboard_report->mods == (MOD_BIT(KB_LSHIFT) | MOD_BIT(KB_RSHIFT)))

Keymap

Build your own firmware

Debuging

Use PJRC's hid_listen to see debug messages and press <COMMAND> + H to debug menu. See config.h for definition of <COMMAND> key combination.