4nes4snes/Readme.txt

76 lines
2.3 KiB
Plaintext

This is 4nes3snes Readme.txt file.
Table of contents:
1) What is 4nes3snes?
2) USB Implementation
3) Compilation and installation
4) License
5) About the vendor id/product id pair:
6) Where do I get more information and updates?
1) What is 4nes3snes?
--------------------
4nes3snes if a firmware for Atmel ATmega8 which
allows one to connect NES and SNES controllers to
a PC using a single circuit. Here are the possible
combinations:
- 4 NES controllers
- 3 SNES controllers
- 2 SNES controllers + 2 NES controllers
- 1 SNES controller + 3 NES controllers
The device connects to an USB port and appears to the
PC as standard HID joystick with 4 axes and 32 buttons.
The two first controllers get their D-PADs mapped to a
pair of axes. The remaining controllers D-PADs
are mapped to ordinary buttons.
2) USB Implementation
------------------
4nes3snes uses the software-only usb driver from Objective Development.
See http://www.obdev.at/products/avrusb/index.html
A good portion of 4nes3snes is based on Objective Development's
HIDKeys example.
3) Compilation and installation
----------------------------
First, you must compile it. To compile, you need a working avr-gcc and
avr-libc. Under linux or cygwin, simply type make in the project directory.
(assuming avr-gcc is in your path).
Next, you must upload the generated file (main.hex) to the Atmega8 using
whatever tools you like. Personally, I use uisp. The 'flash' and 'fuse'
targets in the makefile is a good example about how to use it.
The Atmega fuse bits must also be set properly. The idea behind this is to
enable the external 12mhz crystal instead of the internal clock. Check the
makefile for good fuse bytes values.
4) License
-------
4nes3snes is released under Objective Development's extended GPL
license. See License.txt
5) About the vendor id/product id pair:
------------------------------------
Please dont re-use them for other projects. Instead,
obtain your own. I got mine from mecanique:
http://www.mecanique.co.uk/products/usb/pid.html
6) Where do I get more information and updates?
--------------------------------------------
Visit 4nes3snes page:
http://www.raphnet.net/electronique/4nes_3snes/index_en.php
you may also contact me by email:
Raphael Assenat <raph@raphnet.net>