alterNERDtive/qmk_firmware
1
0
Fork 0
Code Pull requests Activity
qmk_firmware/keyboards/converter/adb_usb
History
James Young b7b4ffc449
Migrate LOCKING_*_ENABLE to Data-Driven: A-C, Part 3 (#23747) 
Affects:

  - `ck60i`
  - `coarse/cordillera`
  - `contender`
  - `converter/a1200/mistress1200`
  - `converter/adb_usb`
  - `converter/m0110_usb`
  - `converter/siemens_tastatur`
  - `cool836a`
  - `copenhagen_click/click_pad_v1`
  - `coseyfannitutti/discipad`
  - `coseyfannitutti/discipline`
  - `coseyfannitutti/mysterium`
  - `coseyfannitutti/romeo`
  - `cozykeys/bloomer`
  - `cozykeys/speedo/v2`
  - `cozykeys/speedo/v3`
  - `craftwalk`
  - `crawlpad`
  - `crazy_keyboard_68`
  - `crbn`
  - `creatkeebs/glacier`
  - `crimsonkeyboards/resume1800`
  - `crin`
  - `cutie_club/borsdorf`
  - `cutie_club/fidelity`
  - `cutie_club/giant_macro_pad`
  - `cutie_club/keebcats/denis`
  - `cutie_club/keebcats/dougal`
  - `cutie_club/novus`
  - `cutie_club/wraith`
2024-05-20 20:55:19 +01:00
..
keymaps/default Remove obvious user keymaps, keyboards/{b,c}* edition. (#22693) 2023-12-18 16:05:50 +11:00
rev1 Migrate build target markers to keyboard.json (#23293) 2024-03-30 11:31:50 +00:00
rev2 Migrate build target markers to keyboard.json (#23293) 2024-03-30 11:31:50 +00:00
adb.c Fix functions with empty params (#19647) 2023-01-20 16:21:17 +00:00
adb.h Move converter specific tmk_core protocols (#14743) 2021-10-07 23:14:26 +01:00
config.h Migrate LOCKING_*_ENABLE to Data-Driven: A-C, Part 3 (#23747) 2024-05-20 20:55:19 +01:00
info.json Migrate LOCKING_*_ENABLE to Data-Driven: A-C, Part 3 (#23747) 2024-05-20 20:55:19 +01:00
led.c [Keyboard] ADB converter lock LED fix (#5035) 2019-02-02 12:43:58 -08:00
matrix.c Remove matrix_init_quantum/matrix_scan_quantum (#19806) 2023-02-11 03:47:17 +00:00
readme.md ADB to USB converter: split into rev1 and rev2 (#18052) 2022-08-15 10:15:22 +01:00
rules.mk Data-driven Keyboard Conversions: C (#23453) 2024-04-11 16:29:10 +01:00

readme.md

ADB-to-USB Keyboard Converter

This firmware converts Apple Desktop Bus (ADB) keyboard protocol to USB so that you can use an ADB keyboard on a modern computer. It works on the PJRC Teensy 2.0 and other USB AVR MCUs (ATMega32U4, AT90USB64/128, etc) and needs at least 10KB of flash memory.

This is a port of the TMK ADB-to-USB converter to QMK. For information on QMK, please consult the following: https://github.com/qmk/qmk_firmware
https://docs.qmk.fm

Wiring

Connect the VCC, GND, and DATA lines of the ADB keyboard to the controller (Teensy 2.0 or similar). By default the DATA line uses port PD0. The Power SW line is unused by the converter.

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. Using an external pull-up resistor (1K-10K Ohm) between the DATA and VCC lines is strongly recommended.

Pull-up resistor:

Keyboard       Converter
               ,------.
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

Building the Firmware

See the build environment setup and the make instructions for more information. Brand new to QMK? Start with our Complete Newbs Guide.

Keymap

To build the default keymap run this command:

$ make converter/adb_usb/rev1:default # Pro Micro-based
$ make converter/adb_usb/rev2:default # Hasu 32U2 PCB

Locking Caps Lock

Many old ADB keyboards use a locking switch for the caps lock key. This converter supports the locking caps lock key by default.

Notes

Non-extended ADB keyboards make no distinction between the left and right modifiers, i.e. the keycode for the left modifier will be sent even if the right modifier

The Apple Extended Keyboard and Apple Extended Keyboard II can differentiate between the left and right modifiers except for the GUI key (Windows/Command).

Most ADB keyboards have no diodes in its matrix so they are not NKRO, though the ADB protocol itself supports it. See protocol/adb.c for more info.

QMK Port Changelog

  • 2018/09/16 - Initial release.
  • 2018/12/23 - Fixed lock LED support.