evolution-drone

evolution-drone is a node JS library for interfacing with Evolution Controller's Drone gamepad.

This library provides a basic DeviceManager that continuously scans for Drone devices. Once a device is detected, an event will be dispatched that contains the new Device instance. You can then use this instance to connect to the Drone controller.

After you connect to a Device, that instance will then emit DeviceDataEvents that contain details of how the controller is being used.

This library is a work in progress and a side hobby of mine. If you have interest in contributing or specific requests, please feel free to open up an issue on github and I will get back to you.

Latest Version 0.0.3

NOTE: This documentation is still being written. If you click on a link and it doesn't go anywhere, it's likely because that portion of the docs hasn't been written yet. If there are parts of the docs you'd like us to focus on, feel free to ask!

Quick Examples

Using DeviceManager

var evolution  = require('evolution-drone');

var DeviceManager   = evolution.DeviceManager;

var myDeviceManager = new DeviceManager();
myDeviceManager.addEventListener(DeviceManager.EventTypes.DEVICE_DETECTED, function(event) {
    var device = event.getData().device;

    // Use device!
});

myDeviceManager.addEventListener(DeviceManager.EventTypes.DEVICE_LOST, function(event) {
    var device = event.getData().device;

    // Device was lost, do what you must....
});

myDeviceManager.startScanningForDevices();

Connecting to a Device and listening for DeviceDataEvents

var evolution       = require('evolution-drone');
var DeviceDataEvent = evolution.DeviceDataEvent;
var DeviceManager   = evolution.DeviceManager;


var myDeviceManager = new DeviceManager();
myDeviceManager.addEventListener(DeviceManager.EventTypes.DEVICE_DETECTED, function(event) {
    var device = event.getData().device;
    device.addEventListener(DeviceDataEvent.EventTypes.DATA, function(event) {
        console.log(event.getData());
    });
    device.connectToDevice();
});
myDeviceManager.startScanningForDevices();

Dependencies

evolution-drone is dependent upon the following libraries

• bugcore
• bugpack
• node-hid

Download Source

The source is available for download from GitHub

Install

For node js, you can install using Node Package Manager npm

npm install evolution-drone

Usage

In node js:

npm will install the bugcore, bugpack, and node-hide dependencies

var drone = require('evolution-drone');

Documentation

Classes

• Device
• DeviceConnection
• DeviceDataEvent
• DeviceManager
• DeviceService

Device

Class used to represent a detected Drone device.

Class

/**
 * @class
 * @extends {EventDispatcher}
 */
var Device = Class.extend(EventDispatcher, {

    _name: "evolution.Device",

View code

Extends

• EventDispatcher

Constructor Summary

Getters and Setters Summary

Method Summary

/**
 * @constructs
 * @param {{
 *      interface: number,
 *      manufacturer: string,
 *      path: string,
 *      product: string,
 *      productId: string,
 *      release: number,
 *      serialNumber: string,
 *      vendorId: string
 * }} hidDevice
 */
_constructor: function(hidDevice) {

var hid         = require('node-hid');
var devices     = hid.devices();
var myDevice    = new Device(devices[0]);

/**
 * @return {boolean}
 */
getConnected: function() {

var myDevice    = new Device(devices[0]);
myDevice.getConnected();    // false, Devices do not automatically have a connection open when they're detected.

/**
 * @return {DeviceConnection}
 */
getConnection: function() {

var device = new Device();
device.getConnection();         // null

myDeviceManager.addEventListener(DeviceManager.EventTypes.DEVICE_DETECTED, function(event) {
    var device = event.getData().device;
    device.getConnection()      // null
});

myDeviceManager.addEventListener(DeviceManager.EventTypes.DEVICE_DETECTED, function(event) {
    var device = event.getData().device;
    device.connectToDevice();
    device.getConnection()      // {DeviceConnection}
});

DeviceConnection

Class used to represent a connection to a Drone device.

Class

/**
 * @class
 * @extends {EventDispatcher}
 */
var DeviceConnection = Class.extend(EventDispatcher, {

    _name: "evolution.DeviceConnection",

View code

Extends

• EventDispatcher

Constructor Summary

Getters and Setters Summary

Method Summary

DeviceDataEvent

Class used to represent a data event from the Drone device.

Class

/**
 * @class
 * @extends {Event}
 */
var DeviceDataEvent = Class.extend(Event, /** @lends {DeviceDataEvent.prototype} */{

    _name: "evolution.DeviceDataEvent",

View code

Extends

• Event

Constructor Summary

Getters and Setters Summary

Method Summary

DeviceManager

TODO

DeviceService

TODO