# [Node Xbox Controller](http://libraries.io/npm/xbox-controller)

Interface for Xbox 360 game controller into Node.js

Lots of low level details about the controller here:
* http://free60.org/GamePad
* http://tattiebogle.net/index.php/ProjectRoot/Xbox360Controller/UsbInfo
* http://euc.jp/periphs/xbox-controller.ja.html

Mac OSX driver: for [Lion/Snow Leopard](http://tattiebogle.net/index.php/ProjectRoot/Xbox360Controller/OsxDriver)
or for [Yosemite](https://github.com/d235j/360Controller/releases)

## Usage

```javascript
var XboxController = require('xbox-controller');
var xbox = new XboxController;

xbox.on('a:press', function (key) {
  console.log(key + ' press');
});

xbox.on('b:release', function (key) {
  console.log(key+' release');
});

xbox.on('lefttrigger', function(position){
  console.log('lefttrigger', position);
});

xbox.on('righttrigger', function(position){
  console.log('righttrigger', position);
});

xbox.on('left:move', function(position){
  console.log('left:move', position);
});

xbox.on('right:move', function(position){
  console.log('right:move', position);
});

xbox.on('connected', function(){
  console.log('Xbox controller connected');
});

xbox.on('not-found', function(){
  console.log('Xbox controller could not be found');
});
```

Also see the [`example.js`](https://github.com/andrew/node-xbox-controller/blob/master/example.js) for usage.

## LEDs

Set LED pattern on controller:

```javascript
xbox.setLed(0x0A);
```

Available LED patterns:

    0x00   All off
    0x01   All blinking
    0x02   1 flashes, then on
    0x03   2 flashes, then on
    0x04   3 flashes, then on
    0x05   4 flashes, then on
    0x06   1 on
    0x07   2 on
    0x08   3 on
    0x09   4 on
    0x0A   Rotating (e.g. 1-2-4-3)
    0x0B   Blinking*
    0x0C   Slow blinking*
    0x0D   Alternating (e.g. 1+4-2+3), then back to previous*

## Rumble

Control left and right rumble motors:

```javascript
var leftStrength = 255;
var rightStrength = 255;

xbox.rumble(leftStrength, rightStrength);
```

Where the strengths are between 0 and 255.

## Within function

Listen for when a trigger or stick's position is within a particular range:

```javascript
xbox.within('righttrigger', [50,100], function(err, data){
	console.log('rightttrigger within 50 and 100', err, data);
});
```

## Multiple Devices

On startup, if a device is in use, it will be skipped and the next available device will be used.  The serial number and
path will be printed to the console for debugging.

Use the printed serial number to specifically address devices if required, see Serial Numbers below.

## Serial Numbers

Each device has own serial number.  On startup, the serial number of the device detected will be printed to the console.

To use a specific serial number, specify it when creating the controller:

```javascript
var xbox = new XboxController('9BB004D0');
```

If you have a third party controller without 'controller' in the name, specify the device serial number to use that
 device.

## Configuring a Third Party Controller

To configure a third party controller:

```javascript
XboxController.configure();
```

## Copyright

Copyright (c) 2015 Andrew Nesbitt. See [LICENSE](https://github.com/andrew/node-xbox-controller/blob/master/LICENSE) for details.