Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/jonthysell/segacontroller

Arduino library to read Sega Genesis (Mega Drive) and Master System (Mark III) controllers.
https://github.com/jonthysell/segacontroller

arduino arduino-library controller gamepad joystick sega sega-genesis sega-mark-iii sega-master-system sega-mega-drive

Last synced: about 1 month ago
JSON representation

Arduino library to read Sega Genesis (Mega Drive) and Master System (Mark III) controllers.

Awesome Lists containing this project

README

        

# SegaController #

Read Sega Genesis (Mega Drive) and Master System (Mark III) controllers in your Arduino sketches.

## Installation ##

1. Download SegaController.zip from https://github.com/jonthysell/SegaController/releases/latest
2. Open the Arduino IDE
3. Open "Sketch > Include Library > Add .ZIP Library..."
4. Select the zip file you downloaded in step 1

## Usage ##

The controller pins are as follows, looking face on to the (female) DB9 plug:

5 4 3 2 1
9 8 7 6

1. Connect controller pin 5 to +5VCC
2. Connect controller pin 8 to GND
3. Connect each remaining pin to a digital I/O pin on your Arduino
4. In your sketch, include the SegaController library
5. In your sketch, initialize a SegaController object with the digital pins you chose in step 3

## Examples ##

There are two example sketches included which make use of the SegaController library. See "File > Examples > SegaController" in the Arduino IDE after installation. Make sure the digital pins you've wired matches those chosen in the code.

### SegaControllerSerialReader ###

This sketch reads the state of a single controller and reports it via the Serial interface. Note that it only reports when the state has changed (a button has been pressed or released). It's good for validating you've got your pins wired up properly.

### SegaControllerKeyboardReader ###

This sketch reads the state of a single controller and simulates key presses via the Keyboard interface. You can specify which buttons correspond to which keys in the sketch. This sketch requires a 32u4 based board (such as the Leonardo, Micro, or Due).

## More Info ##

For details on how SegaController reads the controller's state, see [How To Read Sega Controllers](https://github.com/jonthysell/SegaController/wiki/How-To-Read-Sega-Controllers).

Copyright (c) 2017 Jon Thysell