140 lines
3.2 KiB
JavaScript
140 lines
3.2 KiB
JavaScript
/*
|
|
* device
|
|
* cylonjs.com
|
|
*
|
|
* Copyright (c) 2013-2014 The Hybrid Group
|
|
* Licensed under the Apache 2.0 license.
|
|
*/
|
|
|
|
'use strict';
|
|
|
|
var EventEmitter = require('events').EventEmitter;
|
|
|
|
var Registry = require('./registry'),
|
|
Config = require('./config'),
|
|
Logger = require('./logger'),
|
|
Utils = require('./utils');
|
|
|
|
var testMode = function() {
|
|
return process.env.NODE_ENV === 'test' && Config.testMode;
|
|
};
|
|
|
|
// Public: Creates a new Device
|
|
//
|
|
// opts - object containing Device params
|
|
// name - string name of the device
|
|
// pin - string pin of the device
|
|
// robot - parent Robot to the device
|
|
// connection - connection to the device
|
|
// driver - string name of the module the device driver logic lives in
|
|
//
|
|
// Returns a new Device
|
|
var Device = module.exports = function Device(opts) {
|
|
if (opts == null) {
|
|
opts = {};
|
|
}
|
|
|
|
this.halt = this.halt.bind(this);
|
|
this.start = this.start.bind(this);
|
|
|
|
this.robot = opts.robot;
|
|
this.name = opts.name;
|
|
this.pin = opts.pin;
|
|
this.connection = opts.connection;
|
|
this.driver = this.initDriver(opts);
|
|
|
|
this.details = {};
|
|
|
|
for (var opt in opts) {
|
|
if (['robot', 'name', 'connection', 'driver', 'device', 'adaptor'].indexOf(opt) < 0) {
|
|
this.details[opt] = opts[opt];
|
|
}
|
|
}
|
|
};
|
|
|
|
Utils.subclass(Device, EventEmitter);
|
|
|
|
// Public: Starts the device driver
|
|
//
|
|
// callback - callback function to be executed by the driver start
|
|
//
|
|
// Returns nothing
|
|
Device.prototype.start = function(callback) {
|
|
var msg = "Starting device '" + this.name + "'";
|
|
|
|
if (this.pin != null) {
|
|
msg += " on pin " + this.pin;
|
|
}
|
|
|
|
msg += ".";
|
|
|
|
Logger.info(msg);
|
|
this.driver.start(function() {
|
|
Utils.proxyFunctions(this.driver, this)
|
|
callback.apply(this, arguments);
|
|
}.bind(this));
|
|
};
|
|
|
|
// Public: Halt the device driver
|
|
//
|
|
// callback - function to trigger when the device has been halted
|
|
//
|
|
// Returns nothing
|
|
Device.prototype.halt = function(callback) {
|
|
Logger.info("Halting device '" + this.name + "'.");
|
|
this.removeAllListeners();
|
|
this.driver.halt(callback);
|
|
};
|
|
|
|
// Public: Expresses the Device in JSON format
|
|
//
|
|
// Returns an Object containing Connection data
|
|
Device.prototype.toJSON = function() {
|
|
return {
|
|
name: this.name,
|
|
driver: this.driver.constructor.name || this.driver.name,
|
|
connection: this.connection.name,
|
|
commands: Object.keys(this.driver.commands),
|
|
details: this.details
|
|
};
|
|
};
|
|
|
|
// Public: sets up driver with @robot
|
|
//
|
|
// opts - object containing options when initializing driver
|
|
// driver - name of the driver to intt()
|
|
//
|
|
// Returns the set-up driver
|
|
Device.prototype.initDriver = function(opts) {
|
|
var module;
|
|
|
|
if (opts.module) {
|
|
module = Registry.register(opts.module);
|
|
} else {
|
|
module = Registry.findByDriver(opts.driver);
|
|
}
|
|
|
|
opts.device = this;
|
|
|
|
if (!module) {
|
|
Registry.register('cylon-' + opts.driver);
|
|
module = Registry.findByDriver(opts.driver);
|
|
}
|
|
|
|
var driver = module.driver(opts);
|
|
|
|
if (testMode()) {
|
|
var testDriver = Registry.findByDriver('test').driver(opts);
|
|
|
|
for (var prop in driver) {
|
|
if (typeof driver[prop] === 'function' && !testDriver[prop]) {
|
|
testDriver[prop] = function() { return true; };
|
|
}
|
|
}
|
|
|
|
return testDriver;
|
|
}
|
|
|
|
return driver;
|
|
};
|