|tmk b653b622a6 adb_usb: Add support for Apple Adjustable keybaord media keys||6 years ago|
|MEMO.txt||6 years ago|
|Makefile||6 years ago|
|Makefile.rev1||6 years ago|
|Makefile.teensy||6 years ago|
|README.md||6 years ago|
|config.h||8 years ago|
|keymap_ansi.c||6 years ago|
|keymap_common.c||7 years ago|
|keymap_common.h||6 years ago|
|keymap_hasu.c||7 years ago|
|keymap_iso.c||6 years ago|
|keymap_plain.c||6 years ago|
|led.c||6 years ago|
|matrix.c||6 years ago|
This firmware converts Apple ADB keyboard protocol to USB. You can use TMK Converter, PJRC Teensy2.0 and other USB AVR MCU(ATMega32U4, AT90USB64/128 or etc) for this. But binary size is probably more than 10KB and it won’t fit into 8K flash.
TMK Converter: https://geekhack.org/index.php?topic=72052.0
Also check these when you are in trouble.
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
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
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
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
$ make -f Makefile.teensy [KEYMAP=(plain|ansi|iso|hasu)] teensy
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.
To get help press
h holding Magic key. Magic key is
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.
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.