mirror of https://github.com/Keychron/qmk_firmware.git synced 2024-11-22 16:37:58 +06:00

Open-source keyboard firmware for Atmel AVR and Arm USB families

Go to file

tmk 7350b7c6aa Fix the way of sending out IN packet. This fixes problem that it losts keycode when send keycodes in row in layer.c. Undef CONSOLE_ENABLE build option makes this problem clear.		2012-08-28 21:12:45 +09:00
common	Add support of USBasp bootloader.	2012-06-30 14:44:14 +09:00
converter	Fix Makefiles.	2012-06-30 14:44:59 +09:00
doc	Moved files to common, protocol and doc directory	2012-06-07 02:47:33 +09:00
keyboard	Add CONSOLE_ENABLE build option to LUFA.	2012-07-20 13:08:18 +09:00
protocol	Fix the way of sending out IN packet.	2012-08-28 21:12:45 +09:00
.gitignore	add mouse function.	2010-09-30 14:50:23 +09:00
common.mk	Add CONSOLE_ENABLE build option to LUFA.	2012-07-20 13:08:18 +09:00
protocol.mk	Made directories for keyboard and converter projects.	2012-06-08 13:32:38 +09:00
README.md	Fix README.md: remove bad links	2012-06-11 15:20:40 +09:00
rules.mk	Add Makefile.lufa to keyboard/hhkb and hbkb.	2012-06-30 13:26:09 +09:00

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.