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.
tmk 0575b3db2e adb_usb: Use MODS_TAP_KEY action for Power key 7 years ago
..
binary adb_usb: Use MODS_TAP_KEY action for Power key 7 years ago
MEMO.txt adb_usb: Add support for Apple Adjustable keybaord media keys 7 years ago
Makefile adb_usb: Change Makfiles 7 years ago
Makefile.rev1 adb_usb: Change Makfiles 7 years ago
Makefile.teensy adb_usb: Change Makfiles 7 years ago
Makefile.unimap.rev1 adb_usb: Change unimap 7 years ago
Makefile.unimap.rev2 adb_usb: Change unimap 7 years ago
README.md adb_usb: Fix keypad and media keys of unimap 7 years ago
config.h Remove keymap read code from project directories 7 years ago
keymap_ansi.c Fix: Use action_t in keymap files 7 years ago
keymap_common.h adb_usb: Fix keymap macro 7 years ago
keymap_hasu.c Fix: Use action_t in keymap files 7 years ago
keymap_iso.c Fix: Use action_t in keymap files 7 years ago
keymap_plain.c Remove keymap read code from project directories 7 years ago
led.c adb_usb: Add support for Apple Adjustable keybaord media keys 7 years ago
matrix.c adb_usb/matrix.c : changed size of handler_id from uint16_t to uint8_t 7 years ago
unimap_common.h adb_usb: Fix keypad and media keys of unimap 7 years ago
unimap_plain.c adb_usb: Use MODS_TAP_KEY action for Power key 7 years ago

README.md

ADB to USB keyboard converter

This firmware converts Apple ADB keyboard protocol to USB, you can use it to plug old ADB keyboard into modern computer. It works on TMK ADB-USB Converter, PJRC Teensy2.0 and other USB AVR MCU(ATMega32U4, AT90USB64/128 or etc) and needs more than 10KB flash at least.

Discuss here: http://geekhack.org/showwiki.php?title=Island:14290

You can buy a TMK converter here: https://geekhack.org/index.php?topic=72052.0

README FIRST

https://github.com/tmk/tmk_keyboard https://github.com/tmk/tmk_keyboard/tree/master/converter/adb_usb

Also check these when you are in trouble.

https://github.com/tmk/tmk_keyboard/wiki https://github.com/tmk/tmk_keyboard/labels/NOTE

Wiring

Connect ADB pins to controller just by 3 lines(Vcc, GND, Data). By default Data line uses port PD0.

ADB female socket from the front:

  ,--_--.
 / o4 3o \      1: DATA
| o2   1o |     2: Power SW
 -  ===  -      3: VCC
  `-___-'       4: GND

This converter uses AVR’s internal pull-up, but it seems to be too weak, in particular when you want to use a long or coiled cable. The external pull-up resistor(1K-10K Ohm) on Data is strongly recommended.(It is almost must!) https://github.com/tmk/tmk_keyboard/wiki/FAQ#pull-up-resistor

Pull-up resister:

Keyboard       Conveter
               ,------.
5V------+------|VCC   |
        |      |      |
       [R]     |      |
        |      |      |
Signal--+------|PD0   |
               |      |
GND------------|GND   |
               `------'
R: 1K Ohm resistor

Define following macros for ADB connection in config.h if you use other than port PD0.

ADB_PORT, ADB_PIN, ADB_DDR, ADB_DATA_BIT

Build firmware and Program microcontroller

See doc/build.md.

To build firmware and program TMK Converter run these commands:

$ make -f Makefile clean
$ make -f Makefile [KEYMAP=(plain|ansi|iso|hasu)]
$ make -f Makefile [KEYMAP=(plain|ansi|iso|hasu)] dfu

You can select keymap with optional KEYMAP= (plain is default). Push button on the converter before running dfu target.

Use Makefile.rev1 for old TMK Converter rev.1 and Makefile.teensy for Teensy2.0 instead of Makefile. For TMK Converter rev.2 just use Makefile.

To program Teensy you can use teensy target:

$ make -f Makefile.teensy [KEYMAP=(plain|ansi|iso|hasu)] teensy

Keymap

You can change a keymap by editing code of keymap_[plain|ansi|iso|hasu|yours].c. How to define the keymap is probably obvious. You can find key symbols in common/keycode.h. And see doc/keymap.md for more detail.

Magic command

To get help press h holding Magic key. Magic key is Power key.

Locking CapsLock

Many of old ADB keyboards have mechanical push-lock switch for Capslock key and this converter supports the locking Capslock key by default. See README in top directory for more detail about this feature. https://github.com/tmk/tmk_keyboard/blob/master/README.md#mechanical-locking-support

Also you may want to remove locking pin from the push-lock switch to use capslock as a normal momentary switch.

Mouse support

ADB mouse support was added by @mek-apelsin on Apr,2015. It supports only one button as of now. https://github.com/tmk/tmk_keyboard/pull/207

Notes

Not-extended ADB keyboards have no discrimination between right modifier and left one, you will always see left control even if you press right control key. Apple Extended Keyboard and Apple Extended Keyboard II can discriminate both side modifiers except for GUI key(Windows/Command).

And most ADB keyboard has no diodes in its matrix so they are not NKRO, though ADB protocol itself supports it. See protocol/adb.c for more info.

If keyboard has ISO layout you may have swapped keys problem, see this for the detail.

https://github.com/tmk/tmk_keyboard/issues/35

EOF