This fork contains modified MakeFiles and Sources of the main copy of harlequin-tech/arduino-usb so it's ready to go for the Arduino UNO Rev3.

Arduino UNO Rev3 USB drivers

This is a collection of USB firmware for the Atmega16u2 processor on the UNO Rev3.

By loading the appropriate firmware onto the 16u2 the Arduino can be turned into a native USB device.

The following drivers are currently available here.

USB Mouse
USB Keyboard
USB Joystick
USB MIDI device

All drivers are based on examples from Dean Camera's LUFA project. LUFA version 100807 is used to build the drivers.

Example Arduino sketches are provided in the example directory. The sketches send and receive simplified binary USB reports using the hardware serial interface, which are in turn converted into real USB reports by the 16u2.

See Arduino Hacking for details.

Compiled Hex Files (for atmega16u2) can be found under the 'frimwares' directory.

Sketch report formats

Small joystick interface

2 axis, signed 8 bit values -100 to 100
2 buttons

    struct {  
        int8_t x;  
        int8_t y;  
        uint8_t buttons;  
        uint8_t rfu; 	/* reserved for future use */  
    } joyReport;

Big joystick interface

8 axis, signed 16 bit values -32768 to 32767
40 buttons

    typedef struct joyReport_t {
        int16_t axis[8];
        uint8_t button[5]; // 8 buttons per byte
    } joyReport_t;

USB HID Keyboard

See http://www.usb.org/developers/devclass_docs/Hut1_11.pdf for key codes.

    typedef {  
        uint8_t modifiers_keys;	// CTRL, Shift, ALT, and GUI modifier keys  
        uint8_t rfu;		// reserved  
        uint8_t key[6];		// HID active key usage codes. This represents up to 6 keys currently being pressed.  
    } keyboardReport_t;

USB MIDI device

    typedef union {  
        uint8_t command;  
        uint8_t channel;  
        uint8_t data2;  
        uint8_t data3;  
    } t_midiMsg;

Mouse

    struct {  
        uint8_t buttons;  
        int8_t x;  
        int8_t y;  
        int8_t wheel;	/* Not yet implemented */  
    } mouseReport;

Building the firmware

You will need the avr-gcc toolchain and avr-libc.

To install them on a debian linux system:

sudo apt-get install avr-gcc avr-libc

To install them on OSX:

Install macports from http://www.macports.org

sudo port install avr-gcc

sudo port install avr-libc

Build the firmware using the makefile in its local directory. E.g.

cd firmwares/arduino-keyboard  
make

You can also flash it to the UNO's 8U2 using the makefile after putting the UNO into DFU mode.

make dfu

Loading the firmware

For the Atmega8u2 (UNO R1, R2, MEGA2560 R1, R2): Put the UNO into DFU mode.

dfu-programmer atmega16u2 erase  
dfu-programmer atmega16u2 flash --debug 1 Arduino-big-joystick.hex  
dfu-programmer atmega16u2 reset

Unplug the UNO's USB cable for a few seconds and plug it back in.

Note you will need dfu-programmer version 0.5.5 to flash the atmega16u2.

tomasgvivo/arduino-usb