RetroLink is a small USB input adapter for retro computers.
It allows modern USB mice and USB joysticks to be used on classic systems such as:
- Atari ST
- Commodore Amiga
- Commodore 64
- Features
- Button Control & LED Feedback
- Why This Project Exists
- How RetroLink Works
- Hardware
- Connecting RetroLink
- Configuration Console
- Menu Options
- Firmware
- Disclaimer
- USB mouse support
- USB joystick support, must be a HID joystick.
- Works with Atari 8 bit, Atari ST, Amiga, and C64
- Configurable mouse speed
- Switch between ST mouse and Amiga mouse
- Swap left & right mouse buttons
- Configurable autofire frequency
- Joystick learning wizard
- Configuration stored in flash memory
- Terminal-based configuration (optional)
- Configurable with onboard button & LED
The RetroLink uses one button:
- Short press Show menu on UART
- Long press Select function via LED flashes
< 1 second
- Prints the Main Menu
- Useful when opening a serial terminal
| Flashes | Function |
|---|---|
| 1 | Controller Learning |
| 2 | Swap Mouse Mode |
| 3 | Swap Mouse Buttons |
| 4 | Increase Mouse Speed |
| 5 | Increase Autofire Speed |
Release at desired flash count
Press a key on your controller in the order below to configure it:
- UP
- DOWN
- LEFT
- RIGHT
- FIRE
- AUTOFIRE
- Each step 2 short flashes
- Final step LED ON for 2 seconds
- Config is saved automatically
- Press PCB button
- Press ESC in terminal
- 1 flash Atari ST
- 2 flashes Amiga
- 1 flash Normal
- 2 flashes Swapped
Cycles from 1 to 5
| Flashes | Speed |
|---|---|
| 1 | Very Slow |
| 2 | Slow |
| 3 | Normal |
| 4 | Fast |
| 5 | Turbo |
| Flashes | Frequency |
|---|---|
| 1 | 8 Hz |
| 2 | 9 Hz |
| 3 | 10 Hz |
| 4 | 11 Hz |
| 5 | 12 Hz |
- Settings are stored in flash
- Persist after reboot
- LED is primary UI without UART
Classic hardware is aging:
- cables break
- hardware wears out
- ergonomics are outdated
RetroLink solves this by allowing modern USB devices to be used.
RetroLink translates USB input into DB9 signals.
Internally:
- USB HID reports are read
- Converted to:
- quadrature signals (mouse)
- digital lines (joystick)
- autofire pulses
I chose the CH559 because it operates directly on the 5 volts from the retro computer and therefore does not require a power regulator. Furthermore, the CH559 microcontroller has a built-in USB transceiver and USB controller. The DB9 interfaces are electrically very simple, but they rely on a specific signaling method: open-collector (or open-drain) logic.
Key features for the CH559:
- 8051-based MCU
- USB Host + Device
- 5V operation and low current 3.3v output
- Built-in flash storage
The disadvantage of the CH559 is the small RAM size. That's why strings are stored in flash using __code, for example:
static const char __code text[] = "Example";
Supports HID devices:
- mouse
- joystick
- gamepads
Uses quadrature encoding:
Learning wizard detects:
- changed bytes
- thresholds
- control mapping
Uses open-drain signals:
- only pulls LOW
- host provides pull-up
The RX and TX UART0 lines are connected to the CH340N UART-to-USB controller. This ensures that a micro USB cable can be used for the configuration.
See the hardware section.
- Plug into DB9 mouse or joystick port on your Atari 8 bit / ST / Amiga /C64
- Connect HID mouse/controller to the USB-A port
- Optional: connect micro USB cable to your PC to use the console
- For joystick emulation run the learning wizzard once.
Connect a USB cable from your pc to the micro USB port on the pcb. Any serial console could be used like:
- Arduino's serial monitor
- Visual Studio Code's serial monitor
- PuTTY
- TeraTerm
- minicom
Settings:
2000000 baud
8 data bits
no parity
1 stop bit
See the firmware section.
https://github.com/Fbeen/RetroLink
Provided as-is. Use at your own risk.


