HIDHopper ADB is a modified (forked) version of adbuino and QuokkADB. It is a Raspberry Pi Pico based hardware device which converts USB keyboard and mouse inputs to the Apple Desktop Bus (ADB) standard.

HIDHopper comes from the USB "HID" standard, for Human Interface Device. Hopper just sounded right after HID.

See the file doc/HIDHopper.md for more full documentation

• For Base HIDHopper without USB Hub, before turning on your computer:
  • Plug in your desired USB peripheral (keyboard or mouse)
  • Plug HIDHopper into the ADB bus
  • Start computer
  • Hot-plug is not supported, don't unplug from the ADB Bus or unplug the USB device that is connected while the computer is on
• For HIDHopper with the USB Hub Hat, before turning on your computer:
  • Ensure the Hub is solidly secured in place with the two mounting screws and top cover plate
  • Plug HIDHopper into the ADB bus
  • Plug in your external 5v USB-C power supply to the connector on the Hub
    • You must use USB-C External Power to avoid blowing the ADB Power fuse on your motherboard!
  • Plug in your desired USB keyboard and mouse
  • Hot-plug is not supported, don't unplug from the ADB Bus or unplug USB devices that are connected while the computer is on
    • Hot-plug of USB devices is finicky, sometimes it works and other times it does not
    • Best to connect before startup, that always works

This is a fork of Difegue's version of the adbuino, which was a modified version of bbraun's PS/2 to ADB arduino sketch, with some extra code added to alleviate issues with his own PS/2 keyboard. For Difegue's original write-up, please read more info here..

Note: This software is intended to be compiled in an Ubuntu Linux environment.

• Install the Raspberry Pi Pico SDK (https://github.com/raspberrypi/pico-sdk)
• Set the $PICO_SDK_PATH environment variable to your pico-sdk directory
• Open a Terminal and "cd" into this project
• From the top level of this project, "cd" to the src/firmware folder
• In Terminal, execute the following commands from the above src/firmware folder:
  • mkdir build
  • cd build
  • cmake ..
  • make
• The build outputs (.uf2, .bin, .elf, etc) will be placed in this folder (path is from the top level of the project):
  • src/firmware/build/src
• Next, plug the micro-USB side of a USB cable into HIDHopper
• Press the button which is near the micro-USB port
• While holding down the button, plug the USB cable into your computer (then release the button after plugging in)
• You should see an "RPI-RP2" mass storage device appear on your computer
• Drag the ".uf2" file onto that mass storage device
• Once the mass storage device disappears, wait 10 seconds and then you are free to unplug

• Apple ADB Manager Documenation
• ADB Overview
• Microchip Application Note AN591
• TMK Documentation

• TinyUSB Library
• MiSTER adb hardware emulation

• Running OpenOCD without root

• ADB Connector - mouser