Skip to content

Raspberry Pi Pico-based USB keyboard and Mouse to ADB adapter. Allows USB keyboards and mice to be used with vintage Macintosh computers.

License

Unknown, GPL-2.0 licenses found

Licenses found

Unknown
LICENSE
GPL-2.0
COPYING
Notifications You must be signed in to change notification settings

TechByAndroda/HIDHopper_ADB

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

HIDHopper ADB

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.

The Name

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

Picture

HIDHopper_ADB Hardware Image

Usage

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

Quick Usage

  • 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

Background

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..

How to build and flash HIDHopper ADB

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

References

ADB Pinout

Protocol/Software Documentation

Other libraries

Development resources

Hardware Links

About

Raspberry Pi Pico-based USB keyboard and Mouse to ADB adapter. Allows USB keyboards and mice to be used with vintage Macintosh computers.

Resources

License

Unknown, GPL-2.0 licenses found

Licenses found

Unknown
LICENSE
GPL-2.0
COPYING

Stars

Watchers

Forks

Packages

No packages published

Languages

  • C++ 74.0%
  • C 22.4%
  • CMake 2.1%
  • Shell 1.5%