tmk 7860d09914 Change TMK_DIR setting %!s(int64=10) %!d(string=hai) anos
..
Makefile 7860d09914 Change TMK_DIR setting %!s(int64=10) %!d(string=hai) anos
Makefile.pjrc 7860d09914 Change TMK_DIR setting %!s(int64=10) %!d(string=hai) anos
Makefile.teensy 7860d09914 Change TMK_DIR setting %!s(int64=10) %!d(string=hai) anos
README.md 9b4914b005 m0110: Fix README.md and keymap_intl.c %!s(int64=10) %!d(string=hai) anos
config.h 7e122279c5 Change keymap and enable bootmagic of M0110 %!s(int64=11) %!d(string=hai) anos
keymap_common.c e2077cad45 Change key_t to keypos_t %!s(int64=10) %!d(string=hai) anos
keymap_common.h e3169ccc45 m0110: Add support for international keyboard %!s(int64=10) %!d(string=hai) anos
keymap_default.c e3169ccc45 m0110: Add support for international keyboard %!s(int64=10) %!d(string=hai) anos
keymap_for_editor.c 9c8d0f6c0d Change keymaps of M0110 %!s(int64=11) %!d(string=hai) anos
keymap_hasu.c 9c8d0f6c0d Change keymaps of M0110 %!s(int64=11) %!d(string=hai) anos
keymap_intl.c 9b4914b005 m0110: Fix README.md and keymap_intl.c %!s(int64=10) %!d(string=hai) anos
keymap_plain.c e3169ccc45 m0110: Add support for international keyboard %!s(int64=10) %!d(string=hai) anos
keymap_spacefn.c 9c8d0f6c0d Change keymaps of M0110 %!s(int64=11) %!d(string=hai) anos
led.c e3169ccc45 m0110: Add support for international keyboard %!s(int64=10) %!d(string=hai) anos
matrix.c 2b33ecad57 Add new build options on m0110_usb %!s(int64=12) %!d(string=hai) anos

README.md

M0110/M0110A to USB keyboard converter

This firmware converts the protocol of Apple Macintosh keyboard M0110, M0110A and M0120 into USB. Target of this project is USB AVR controller like ATmega32U2 and ATmega32U4. Using this converter you can revive these retro keyboards with modern computer.

Read README of top directory too.

Pictures of M0110 + M0120 and M0110A.

M0110A

  • M0110A support was contributed by skagon@github.
  • M0120 also is supported. keys(+ * / and ,) on M0120 are recognized as cursor keys.

Update

  • 2013/08: Change port for signals PF to PD
  • 2013/09: Change port again, it uses inversely PD0 for data and PD1 for clock line now.
  • 2014/06: Change keymaps
  • 2015/03: Add support for "International"(ISO) keyboard(keymap_intl.c)

Building Hardware

You need TMK converter or AVR dev board like PJRC Teensy. Port of the MCU PD1 is assigned to CLOCK line and PD0 to DATA by default, you can change pin configuration with editing config.h.

M0110 Converter

4P4C phone handset cable

Note that original cable used with Mac is straight while phone handset cable is crossover.

http://en.wikipedia.org/wiki/Modular_connector#4P4C

Close-up picture of handset cable. You can see one end of plug has reverse color codes against the other. Click to enlarge. 4P4C cable

Socket Pinout

Jack fig

Pull-up Resistor

You may need pull-up resistors on signal lines(CLOCK, DATA) in particular when you have long or coiled cable. 1k-10k Ohm will be OK for this purpose. In that case the converter may not read signal from keyboard correctly without pull-up resistors.

Building Firmware

To compile firmware you need AVR GCC. You can edit Makefile and config.h to change compile options and pin configuration. Also KEYMAP option can be used to select keymap.

$ git clone git://github.com/tmk/tmk_keyboard.git (or download source)
$ cd m0110_usb
$ make -f Makefile clean
$ make -f Makefile [KEYMAP={default|plain|intl|spacefn|hasu}]

Use Makefile.teensy instead for Teensy.

Keymap

To create your own keymap copy existent keymap file to keymap_name.c and edit it. You can build it like this.

$ make -f Makefile clean
$ make -f Makefile KEYMAP=name

Debug

You can use PJRC HID listen to see debug output. The converter has some functions for debug, press <Magic>+H simultaneously to get help.

  • Magic combo: Shift+Option+⌘ or Shift+Option+Ctrl(Shift+Alt+Gui or Shift+Alt+Control)