Skip to content

Latest commit

 

History

History
69 lines (48 loc) · 4.96 KB

README.md

File metadata and controls

69 lines (48 loc) · 4.96 KB

Background

"Adbuino" has a long history of different people tinkering with it. Just to provide some clarity...

  • ORIGINAL PS/2 version - In the beginning - bbraun created the adbuino project and generously open sourced it. The links aren't working anymore, but the original SVN repo was bbraun's
  • Difegue PS/2 version - 2020 - Difegue's version of the adbuino, modified bbraun's version, with some extra code added to alleviate issues with his own PS/2 keyboard.
  • akuker USB version - 2022 - akuker converted Difegue's version to use a USB controller and created a PCB design using KiCad.
  • QuokkADB - 2023 - Rabbit Hole computing created a new PCB based on the RP2040 (instead of Atmel chip). Morio, ported the code to the dual core RP2040, removed the dependency on the expensive MAX3421E USB controller and updated it to a PlatformIO project. Morio graciously merged their code changes back into akuker/adbuino
  • HIDHopper_ADB - 2023 - TechByAndroda forked the repo and made a new PCB that uses a Raspberry Pi Pico (instead of a chip-down RP2040)

Its GPL code. It belongs to the community. Do fun GPL stuff with it.

akuker USB Adbuino

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

QuokkADB

QuokkADB picture QuokkADB is a modified version of adbuino. It is targeted to the Rabbit Hole Computing's QuokkADB device. QuokkADB is a Raspberry Pi RP2040 based device that takes in USB inputs from a keyboard and/or mouse and outputs Apple's ADB (Apple Desktop Bus). Further information can be found in the QuokkADB.md file.

HIDHopper_ADB

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

Hack-y Alternative

The USB ADBuino is essentially a "value-engineered" version of a bunch of off-the-shelf components.

How to build and flash an adbuino

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

Any dependencies that are configured in the PlatformIO project (such as TinyUSB) will automatically be downloaded. Make sure you are connected to the Internet the first time you build this software.

  • Install Visual Studio Code
  • Install Platform IO
  • Open Visual studio Code and open the directory ./src/adbuino
  • Select the PlatformIO icon on the left
  • Execute the Build project task
  • Execute the Upload project task to flash your device

What's this repo for?

The intent of this repository is to add "USB Host" support to the original ADB design. This will allow a USB keyboard and/or mouse to be used to drive an ADB host, as well as PS/2.

The BMOW "Wombat" is a closed-source alternative to adbuino. The BMOW "Wombat" is an AWESOME project, but doesn't allow external contributors.

References

ADB Pinout

Protocol/Software Documentation

Other libraries

Development resources

Hardware Links