Blue2joy

🕹️ Blue2Joy

Blue2Joy is an adapter that lets you use modern Bluetooth controllers with Atari 8-bit computers. It emulates digital joysticks, analog paddles, and supports bidirectional communication and much more. Try the live demo: https://cepetr.github.io/blue2joy/main.

While primarily intended for gamepads, the device is not limited to them - in principle, any BLE HID device, such as a keyboard or mouse, can be connected.

Only devices that fully support the BLE HID over GATT Profile (HOGP) are supported. For this reason many older devices (especially gamepads) are unfortunately not usable with Blue2Joy. See compatible devices.

Have a look at some demos:

Use Cases

While there are other adapters that let Bluetooth controllers act as digital joysticks, Blue2Joy goes further. Besides standard and expected use cases, there are a few new possible ones that utilize analog input emulation or bidirectional communication:

• Use a gamepad as a digital joystick with up to 3 buttons (Joy2B+ standard)
• Use gamepad's analog sticks as paddles (direct or integration mode)
• Emulate paddles with a mouse
• Use a gamepad as an analog joystick (two axes on analog inputs) with up to 5 buttons
• Connect a mouse digitally- using quadrature encoding as on the Atari ST
• Connect a mouse in an analog way - using analog inputs for deltas, with up to 5 buttons
• Configure Blue2Joy via SPI-like communication over the joystick port
• Emulate the Y-axis of a light pen (conceptual idea, not sure if possible)
• Emulate an XEP80 terminal (work in progress)
• Send keycodes from the browser to Atari via paddle lines (used by the XEP80 terminal; requires btjkbd.sys).

Although designed for Atari 8-bit systems, Blue2Joy can be used with any device that follows the same joystick port pinout - with paddle functionality available only on Atari computers (see details).

🚧 Project Status

Blue2Joy is currently under active (but really slow) development. The hardware is stable and most of the core features have been successfully tested, but the software still needs some work to reach the level of polish I would consider complete.

Repository Structure

This repository contains complete project documentation and source code for all Blue2Joy components shown in the following image.

Blue2Joy Hardware

• Nordic nRF52840 (Cortex-M4F @ 64 MHz) with integrated Bluetooth 5 LE radio
• USB 2.0 Full-Speed (device mode only) for firmware updates, debugging, or use as a faster alternative to Bluetooth
• Female 9-pin D-sub connector
• RGB LED used as a status indicator (see details)
• Two user push-buttons (see details)

For more details, see the hardware folder.

Blue2Joy Firmware

• Supports pairing and connection to BLE HID devices (tested with Xbox Wireless Controller)
• Emulates a joystick port digital inputs as well as analog paddle potentiometers
• Supports bidirectional (SPI) communication with the Atari
• Indicates device status with an RGB LED
• Allows custom mapping of HID-device controls to joystick and paddle inputs
• Emulates an XEP80 terminal

For more details, see the firmware folder.

Web Configuration

• A web application that allows you to configure the Blue2Joy device directly from any browser supporting the Web Bluetooth or Web USB standards
• Provides an easy way to configure the mapping of HID controls to joystick port digital and analog pins
• Allows you to configure the device even while it is connected to HID devices (e.g., gamepads, mice)
• Emulates an XEP80 terminal

The application is available at https://cepetr.github.io/blue2joy/main.

For more details, see the webconfig folder.

Atari Blue2Joy Keyboard driver

A driver for SpartaDOS that lets you use Blue2Joy as a keyboard. It can be used together with XEP80 or on its own.

For more details, see the atari folder.

Atari Blue2Joy Configuration Application

• Not implemented yet. This component currently exists only as a design intention.
• Intended to be an application that allows configuring the Blue2Joy device directly from Atari
• Planned to use the bidirectional (SPI-like) communication over the joystick port

For more details, see the atari folder.

Feedback & Contributions

I'd be very happy to receive any feedback, pull requests, or even just a note that you've built and tried out Blue2Joy.

License

This repository contains software, firmware, and hardware design files.

Software and Firmware

All software and firmware files (in atari/, firmware/ and webconfig/) are licensed under the GNU General Public License, version 3.

See LICENSE-GPL for details.

Hardware

Schematics, PCB layout, mechanical design files (in hardware/) are licensed under the CERN Open Hardware Licence Version 2 - Strongly Reciprocal. You are free to use, modify, and share them, but if you distribute hardware or modified design files, you must also share your changes under the same license.

See LICENSE-CERN for details.