221 lines
10 KiB
HTML
221 lines
10 KiB
HTML
<!DOCTYPE html>
|
|
<html lang="en">
|
|
<head>
|
|
<meta charset="utf-8">
|
|
<title>JSDoc: Source: duplotrainbase.js</title>
|
|
|
|
<script src="scripts/prettify/prettify.js"> </script>
|
|
<script src="scripts/prettify/lang-css.js"> </script>
|
|
<!--[if lt IE 9]>
|
|
<script src="//html5shiv.googlecode.com/svn/trunk/html5.js"></script>
|
|
<![endif]-->
|
|
<link type="text/css" rel="stylesheet" href="styles/prettify-tomorrow.css">
|
|
<link type="text/css" rel="stylesheet" href="styles/jsdoc-default.css">
|
|
</head>
|
|
|
|
<body>
|
|
|
|
<div id="main">
|
|
|
|
<h1 class="page-title">Source: duplotrainbase.js</h1>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<section>
|
|
<article>
|
|
<pre class="prettyprint source linenums"><code>"use strict";
|
|
var __importStar = (this && this.__importStar) || function (mod) {
|
|
if (mod && mod.__esModule) return mod;
|
|
var result = {};
|
|
if (mod != null) for (var k in mod) if (Object.hasOwnProperty.call(mod, k)) result[k] = mod[k];
|
|
result["default"] = mod;
|
|
return result;
|
|
};
|
|
Object.defineProperty(exports, "__esModule", { value: true });
|
|
const lpf2hub_1 = require("./lpf2hub");
|
|
const port_1 = require("./port");
|
|
const Consts = __importStar(require("./consts"));
|
|
const Debug = require("debug");
|
|
const debug = Debug("duploTrainBase");
|
|
/**
|
|
* The DuploTrainBase is emitted if the discovered device is a Duplo Train Base.
|
|
* @class DuploTrainBase
|
|
* @extends LPF2Hub
|
|
* @extends Hub
|
|
*/
|
|
class DuploTrainBase extends lpf2hub_1.LPF2Hub {
|
|
// We set JSDoc to ignore these events as a Duplo Train Base will never emit them.
|
|
/**
|
|
* @event DuploTrainBase#distance
|
|
* @ignore
|
|
*/
|
|
/**
|
|
* @event DuploTrainBase#colorAndDistance
|
|
* @ignore
|
|
*/
|
|
/**
|
|
* @event DuploTrainBase#tilt
|
|
* @ignore
|
|
*/
|
|
/**
|
|
* @event DuploTrainBase#rotate
|
|
* @ignore
|
|
*/
|
|
/**
|
|
* @event DuploTrainBase#button
|
|
* @ignore
|
|
*/
|
|
/**
|
|
* @event DuploTrainBase#attach
|
|
* @ignore
|
|
*/
|
|
/**
|
|
* @event DuploTrainBase#detach
|
|
* @ignore
|
|
*/
|
|
static IsDuploTrainBase(peripheral) {
|
|
return (peripheral.advertisement.serviceUuids.indexOf(Consts.BLEService.LPF2_HUB.replace(/-/g, "")) >= 0 && peripheral.advertisement.manufacturerData[3] === Consts.BLEManufacturerData.DUPLO_TRAIN_HUB_ID);
|
|
}
|
|
constructor(peripheral, autoSubscribe = true) {
|
|
super(peripheral, autoSubscribe);
|
|
this.type = Consts.HubType.DUPLO_TRAIN_HUB;
|
|
this._ports = {
|
|
"MOTOR": new port_1.Port("MOTOR", 0),
|
|
"COLOR": new port_1.Port("COLOR", 18),
|
|
"SPEEDOMETER": new port_1.Port("SPEEDOMETER", 19)
|
|
};
|
|
debug("Discovered Duplo Train Base");
|
|
}
|
|
connect() {
|
|
return new Promise(async (resolve, reject) => {
|
|
debug("Connecting to Duplo Train Base");
|
|
await super.connect();
|
|
debug("Connect completed");
|
|
return resolve();
|
|
});
|
|
}
|
|
/**
|
|
* Set the color of the LED on the train via a color value.
|
|
* @method DuploTrainBase#setLEDColor
|
|
* @param {Color} color
|
|
* @returns {Promise} Resolved upon successful issuance of command.
|
|
*/
|
|
setLEDColor(color) {
|
|
return new Promise((resolve, reject) => {
|
|
if (color === false) {
|
|
color = 0;
|
|
}
|
|
const data = Buffer.from([0x81, 0x11, 0x11, 0x51, 0x00, color]);
|
|
this._writeMessage(Consts.BLECharacteristic.LPF2_ALL, data);
|
|
return resolve();
|
|
});
|
|
}
|
|
/**
|
|
* Set the motor speed on a given port.
|
|
* @method DuploTrainBase#setMotorSpeed
|
|
* @param {string} port
|
|
* @param {number | Array.<number>} speed For forward, a value between 1 - 100 should be set. For reverse, a value between -1 to -100. Stop is 0. If you are specifying port AB to control both motors, you can optionally supply a tuple of speeds.
|
|
* @param {number} [time] How long to activate the motor for (in milliseconds). Leave empty to turn the motor on indefinitely.
|
|
* @returns {Promise} Resolved upon successful completion of command. If time is specified, this is once the motor is finished.
|
|
*/
|
|
setMotorSpeed(port, speed, time) {
|
|
const portObj = this._portLookup(port);
|
|
let cancelEventTimer = true;
|
|
if (typeof time === "boolean") {
|
|
if (time === true) {
|
|
cancelEventTimer = false;
|
|
}
|
|
time = undefined;
|
|
}
|
|
if (cancelEventTimer) {
|
|
portObj.cancelEventTimer();
|
|
}
|
|
return new Promise((resolve, reject) => {
|
|
if (time && typeof time === "number") {
|
|
const data = Buffer.from([0x81, portObj.value, 0x11, 0x51, 0x00, this._mapSpeed(speed)]);
|
|
this._writeMessage(Consts.BLECharacteristic.LPF2_ALL, data);
|
|
const timeout = global.setTimeout(() => {
|
|
const data = Buffer.from([0x81, portObj.value, 0x11, 0x51, 0x00, 0x00]);
|
|
this._writeMessage(Consts.BLECharacteristic.LPF2_ALL, data);
|
|
return resolve();
|
|
}, time);
|
|
portObj.setEventTimer(timeout);
|
|
}
|
|
else {
|
|
const data = Buffer.from([0x81, portObj.value, 0x11, 0x51, 0x00, this._mapSpeed(speed)]);
|
|
this._writeMessage(Consts.BLECharacteristic.LPF2_ALL, data);
|
|
return resolve();
|
|
}
|
|
});
|
|
}
|
|
/**
|
|
* Ramp the motor speed on a given port.
|
|
* @method DuploTrainBase#rampMotorSpeed
|
|
* @param {string} port
|
|
* @param {number} fromSpeed For forward, a value between 1 - 100 should be set. For reverse, a value between -1 to -100. Stop is 0.
|
|
* @param {number} toSpeed For forward, a value between 1 - 100 should be set. For reverse, a value between -1 to -100. Stop is 0.
|
|
* @param {number} time How long the ramp should last (in milliseconds).
|
|
* @returns {Promise} Resolved upon successful completion of command.
|
|
*/
|
|
rampMotorSpeed(port, fromSpeed, toSpeed, time) {
|
|
const portObj = this._portLookup(port);
|
|
portObj.cancelEventTimer();
|
|
return new Promise((resolve, reject) => {
|
|
this._calculateRamp(fromSpeed, toSpeed, time, portObj)
|
|
.on("changeSpeed", (speed) => {
|
|
this.setMotorSpeed(port, speed, true);
|
|
})
|
|
.on("finished", resolve);
|
|
});
|
|
}
|
|
/**
|
|
* Fully (hard) stop the motor on a given port.
|
|
* @method DuploTrainBase#hardStopMotor
|
|
* @param {string} port
|
|
* @returns {Promise} Resolved upon successful completion of command.
|
|
*/
|
|
hardStopMotor(port) {
|
|
return this.setMotorSpeed(port, 127);
|
|
}
|
|
/**
|
|
* Play a built-in train sound.
|
|
* @method DuploTrainBase#playSound
|
|
* @param {DuploTrainBaseSound} sound
|
|
* @returns {Promise} Resolved upon successful issuance of command.
|
|
*/
|
|
playSound(sound) {
|
|
return new Promise((resolve, reject) => {
|
|
const data = Buffer.from([0x81, 0x01, 0x11, 0x51, 0x01, sound]);
|
|
this._writeMessage(Consts.BLECharacteristic.LPF2_ALL, data);
|
|
return resolve();
|
|
});
|
|
}
|
|
}
|
|
exports.DuploTrainBase = DuploTrainBase;
|
|
</code></pre>
|
|
</article>
|
|
</section>
|
|
|
|
|
|
|
|
|
|
</div>
|
|
|
|
<nav>
|
|
<h2><a href="index.html">Home</a></h2><h3>Classes</h3><ul><li><a href="BoostMoveHub.html">BoostMoveHub</a></li><li><a href="DuploTrainBase.html">DuploTrainBase</a></li><li><a href="Hub.html">Hub</a></li><li><a href="LPF2Hub.html">LPF2Hub</a></li><li><a href="PoweredUP.html">PoweredUP</a></li><li><a href="PUPHub.html">PUPHub</a></li><li><a href="PUPRemote.html">PUPRemote</a></li><li><a href="WeDo2SmartHub.html">WeDo2SmartHub</a></li></ul><h3>Events</h3><ul><li><a href="BoostMoveHub.html#event:attach">attach</a></li><li><a href="BoostMoveHub.html#event:button">button</a></li><li><a href="BoostMoveHub.html#event:color">color</a></li><li><a href="BoostMoveHub.html#event:colorAndDistance">colorAndDistance</a></li><li><a href="BoostMoveHub.html#event:detach">detach</a></li><li><a href="BoostMoveHub.html#event:distance">distance</a></li><li><a href="BoostMoveHub.html#event:rotate">rotate</a></li><li><a href="BoostMoveHub.html#event:tilt">tilt</a></li><li><a href="DuploTrainBase.html#event:color">color</a></li><li><a href="DuploTrainBase.html#event:speed">speed</a></li><li><a href="Hub.html#event:attach">attach</a></li><li><a href="Hub.html#event:detach">detach</a></li><li><a href="LPF2Hub.html#event:attach">attach</a></li><li><a href="LPF2Hub.html#event:button">button</a></li><li><a href="LPF2Hub.html#event:color">color</a></li><li><a href="LPF2Hub.html#event:colorAndDistance">colorAndDistance</a></li><li><a href="LPF2Hub.html#event:detach">detach</a></li><li><a href="LPF2Hub.html#event:distance">distance</a></li><li><a href="LPF2Hub.html#event:rotate">rotate</a></li><li><a href="LPF2Hub.html#event:speed">speed</a></li><li><a href="LPF2Hub.html#event:tilt">tilt</a></li><li><a href="PoweredUP.html#event:discover">discover</a></li><li><a href="PUPHub.html#event:attach">attach</a></li><li><a href="PUPHub.html#event:button">button</a></li><li><a href="PUPHub.html#event:color">color</a></li><li><a href="PUPHub.html#event:colorAndDistance">colorAndDistance</a></li><li><a href="PUPHub.html#event:detach">detach</a></li><li><a href="PUPHub.html#event:distance">distance</a></li><li><a href="PUPHub.html#event:tilt">tilt</a></li><li><a href="PUPRemote.html#event:button">button</a></li><li><a href="PUPRemote.html#event:colorAndDistance">colorAndDistance</a></li><li><a href="WeDo2SmartHub.html#event:attach">attach</a></li><li><a href="WeDo2SmartHub.html#event:button">button</a></li><li><a href="WeDo2SmartHub.html#event:color">color</a></li><li><a href="WeDo2SmartHub.html#event:detach">detach</a></li><li><a href="WeDo2SmartHub.html#event:distance">distance</a></li><li><a href="WeDo2SmartHub.html#event:rotate">rotate</a></li><li><a href="WeDo2SmartHub.html#event:tilt">tilt</a></li></ul><h3><a href="global.html">Global</a></h3>
|
|
</nav>
|
|
|
|
<br class="clear">
|
|
|
|
<footer>
|
|
Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 3.5.5</a> on Fri Jan 18 2019 16:10:38 GMT-0800 (Pacific Standard Time)
|
|
</footer>
|
|
|
|
<script> prettyPrint(); </script>
|
|
<script src="scripts/linenumber.js"> </script>
|
|
</body>
|
|
</html>
|