1526 lines
53 KiB
Markdown
1526 lines
53 KiB
Markdown
## Classes
|
|
|
|
<dl>
|
|
<dt><a href="#PoweredUP">PoweredUP</a> ⇐ <code>EventEmitter</code></dt>
|
|
<dd></dd>
|
|
<dt><a href="#WeDo2SmartHub">WeDo2SmartHub</a> ⇐ <code>Hub</code></dt>
|
|
<dd></dd>
|
|
<dt><a href="#BoostMoveHub">BoostMoveHub</a> ⇐ <code>LPF2Hub</code></dt>
|
|
<dd></dd>
|
|
<dt><a href="#PUPHub">PUPHub</a> ⇐ <code>LPF2Hub</code></dt>
|
|
<dd></dd>
|
|
<dt><a href="#PUPRemote">PUPRemote</a> ⇐ <code>LPF2Hub</code></dt>
|
|
<dd></dd>
|
|
<dt><a href="#DuploTrainBase">DuploTrainBase</a> ⇐ <code>LPF2Hub</code></dt>
|
|
<dd></dd>
|
|
</dl>
|
|
|
|
<a name="PoweredUP"></a>
|
|
|
|
## PoweredUP ⇐ <code>EventEmitter</code>
|
|
**Kind**: global class
|
|
**Extends**: <code>EventEmitter</code>
|
|
|
|
* [PoweredUP](#PoweredUP) ⇐ <code>EventEmitter</code>
|
|
* [.scan()](#PoweredUP+scan)
|
|
* [.stop()](#PoweredUP+stop)
|
|
* [.getConnectedHubByUUID(uuid)](#PoweredUP+getConnectedHubByUUID) ⇒ <code>Hub</code> \| <code>null</code>
|
|
* [.getConnectedHubs()](#PoweredUP+getConnectedHubs) ⇒ <code>Array.<Hub></code>
|
|
* ["discover" (hub)](#PoweredUP+event_discover)
|
|
|
|
<a name="PoweredUP+scan"></a>
|
|
|
|
### poweredUP.scan()
|
|
Begin scanning for Powered UP Hub devices.
|
|
|
|
**Kind**: instance method of [<code>PoweredUP</code>](#PoweredUP)
|
|
<a name="PoweredUP+stop"></a>
|
|
|
|
### poweredUP.stop()
|
|
Stop scanning for Powered UP Hub devices.
|
|
|
|
**Kind**: instance method of [<code>PoweredUP</code>](#PoweredUP)
|
|
<a name="PoweredUP+getConnectedHubByUUID"></a>
|
|
|
|
### poweredUP.getConnectedHubByUUID(uuid) ⇒ <code>Hub</code> \| <code>null</code>
|
|
Retrieve a Powered UP Hub by UUID.
|
|
|
|
**Kind**: instance method of [<code>PoweredUP</code>](#PoweredUP)
|
|
|
|
| Param | Type |
|
|
| --- | --- |
|
|
| uuid | <code>string</code> |
|
|
|
|
<a name="PoweredUP+getConnectedHubs"></a>
|
|
|
|
### poweredUP.getConnectedHubs() ⇒ <code>Array.<Hub></code>
|
|
Retrieve a list of Powered UP Hubs.
|
|
|
|
**Kind**: instance method of [<code>PoweredUP</code>](#PoweredUP)
|
|
<a name="PoweredUP+event_discover"></a>
|
|
|
|
### "discover" (hub)
|
|
Emits when a Powered UP Hub device is found.
|
|
|
|
**Kind**: event emitted by [<code>PoweredUP</code>](#PoweredUP)
|
|
|
|
| Param | Type |
|
|
| --- | --- |
|
|
| hub | [<code>WeDo2SmartHub</code>](#WeDo2SmartHub) \| [<code>BoostMoveHub</code>](#BoostMoveHub) \| [<code>PUPHub</code>](#PUPHub) \| [<code>PUPRemote</code>](#PUPRemote) \| [<code>DuploTrainBase</code>](#DuploTrainBase) |
|
|
|
|
<a name="WeDo2SmartHub"></a>
|
|
|
|
## WeDo2SmartHub ⇐ <code>Hub</code>
|
|
**Kind**: global class
|
|
**Extends**: <code>Hub</code>
|
|
|
|
* [WeDo2SmartHub](#WeDo2SmartHub) ⇐ <code>Hub</code>
|
|
* [new WeDo2SmartHub()](#new_WeDo2SmartHub_new)
|
|
* [.name](#Hub+name)
|
|
* [.uuid](#Hub+uuid)
|
|
* [.rssi](#Hub+rssi)
|
|
* [.batteryLevel](#Hub+batteryLevel)
|
|
* [.setName(name)](#WeDo2SmartHub+setName) ⇒ <code>Promise</code>
|
|
* [.setLEDColor(color)](#WeDo2SmartHub+setLEDColor) ⇒ <code>Promise</code>
|
|
* [.setLEDRGB(red, green, blue)](#WeDo2SmartHub+setLEDRGB) ⇒ <code>Promise</code>
|
|
* [.setMotorSpeed(port, speed, [time])](#WeDo2SmartHub+setMotorSpeed) ⇒ <code>Promise</code>
|
|
* [.rampMotorSpeed(port, fromSpeed, toSpeed, time)](#WeDo2SmartHub+rampMotorSpeed) ⇒ <code>Promise</code>
|
|
* [.playTone(frequency, time)](#WeDo2SmartHub+playTone) ⇒ <code>Promise</code>
|
|
* [.setLightBrightness(port, brightness, [time])](#WeDo2SmartHub+setLightBrightness) ⇒ <code>Promise</code>
|
|
* [.connect()](#Hub+connect) ⇒ <code>Promise</code>
|
|
* [.disconnect()](#Hub+disconnect) ⇒ <code>Promise</code>
|
|
* [.subscribe(port, [mode])](#Hub+subscribe) ⇒ <code>Promise</code>
|
|
* [.unsubscribe(port)](#Hub+unsubscribe) ⇒ <code>Promise</code>
|
|
* [.sleep(delay)](#Hub+sleep) ⇒ <code>Promise</code>
|
|
* [.wait(commands)](#Hub+wait) ⇒ <code>Promise</code>
|
|
* ["button" (button, state)](#WeDo2SmartHub+event_button)
|
|
* ["distance" (port, distance)](#WeDo2SmartHub+event_distance)
|
|
* ["color" (port, color)](#WeDo2SmartHub+event_color)
|
|
* ["tilt" (port, x, y)](#WeDo2SmartHub+event_tilt)
|
|
* ["rotate" (port, rotation)](#WeDo2SmartHub+event_rotate)
|
|
* ["attach" (port, type)](#Hub+event_attach)
|
|
* ["detach" (port)](#Hub+event_detach)
|
|
|
|
<a name="new_WeDo2SmartHub_new"></a>
|
|
|
|
### new WeDo2SmartHub()
|
|
The WeDo2SmartHub is emitted if the discovered device is a WeDo 2.0 Smart Hub.
|
|
|
|
<a name="Hub+name"></a>
|
|
|
|
### weDo2SmartHub.name
|
|
**Kind**: instance property of [<code>WeDo2SmartHub</code>](#WeDo2SmartHub)
|
|
**Read only**: true
|
|
**Properties**
|
|
|
|
| Name | Type | Description |
|
|
| --- | --- | --- |
|
|
| name | <code>string</code> | Name of the hub |
|
|
|
|
<a name="Hub+uuid"></a>
|
|
|
|
### weDo2SmartHub.uuid
|
|
**Kind**: instance property of [<code>WeDo2SmartHub</code>](#WeDo2SmartHub)
|
|
**Read only**: true
|
|
**Properties**
|
|
|
|
| Name | Type | Description |
|
|
| --- | --- | --- |
|
|
| uuid | <code>string</code> | UUID of the hub |
|
|
|
|
<a name="Hub+rssi"></a>
|
|
|
|
### weDo2SmartHub.rssi
|
|
**Kind**: instance property of [<code>WeDo2SmartHub</code>](#WeDo2SmartHub)
|
|
**Read only**: true
|
|
**Properties**
|
|
|
|
| Name | Type | Description |
|
|
| --- | --- | --- |
|
|
| rssi | <code>number</code> | Signal strength of the hub |
|
|
|
|
<a name="Hub+batteryLevel"></a>
|
|
|
|
### weDo2SmartHub.batteryLevel
|
|
**Kind**: instance property of [<code>WeDo2SmartHub</code>](#WeDo2SmartHub)
|
|
**Read only**: true
|
|
**Properties**
|
|
|
|
| Name | Type | Description |
|
|
| --- | --- | --- |
|
|
| batteryLevel | <code>number</code> | Battery level of the hub (Percentage between 0-100) |
|
|
|
|
<a name="WeDo2SmartHub+setName"></a>
|
|
|
|
### weDo2SmartHub.setName(name) ⇒ <code>Promise</code>
|
|
Set the name of the Hub.
|
|
|
|
**Kind**: instance method of [<code>WeDo2SmartHub</code>](#WeDo2SmartHub)
|
|
**Returns**: <code>Promise</code> - Resolved upon successful issuance of command.
|
|
|
|
| Param | Type | Description |
|
|
| --- | --- | --- |
|
|
| name | <code>string</code> | New name of the hub (14 characters or less, ASCII only). |
|
|
|
|
<a name="WeDo2SmartHub+setLEDColor"></a>
|
|
|
|
### weDo2SmartHub.setLEDColor(color) ⇒ <code>Promise</code>
|
|
Set the color of the LED on the Hub via a color value.
|
|
|
|
**Kind**: instance method of [<code>WeDo2SmartHub</code>](#WeDo2SmartHub)
|
|
**Returns**: <code>Promise</code> - Resolved upon successful issuance of command.
|
|
|
|
| Param | Type | Description |
|
|
| --- | --- | --- |
|
|
| color | <code>number</code> | A number representing one of the LED color consts. |
|
|
|
|
<a name="WeDo2SmartHub+setLEDRGB"></a>
|
|
|
|
### weDo2SmartHub.setLEDRGB(red, green, blue) ⇒ <code>Promise</code>
|
|
Set the color of the LED on the Hub via RGB values.
|
|
|
|
**Kind**: instance method of [<code>WeDo2SmartHub</code>](#WeDo2SmartHub)
|
|
**Returns**: <code>Promise</code> - Resolved upon successful issuance of command.
|
|
|
|
| Param | Type |
|
|
| --- | --- |
|
|
| red | <code>number</code> |
|
|
| green | <code>number</code> |
|
|
| blue | <code>number</code> |
|
|
|
|
<a name="WeDo2SmartHub+setMotorSpeed"></a>
|
|
|
|
### weDo2SmartHub.setMotorSpeed(port, speed, [time]) ⇒ <code>Promise</code>
|
|
Set the motor speed on a given port.
|
|
|
|
**Kind**: instance method of [<code>WeDo2SmartHub</code>](#WeDo2SmartHub)
|
|
**Returns**: <code>Promise</code> - Resolved upon successful completion of command. If time is specified, this is once the motor is finished.
|
|
|
|
| Param | Type | Description |
|
|
| --- | --- | --- |
|
|
| port | <code>string</code> | |
|
|
| speed | <code>number</code> | For forward, a value between 1 - 100 should be set. For reverse, a value between -1 to -100. Stop is 0. |
|
|
| [time] | <code>number</code> | How long to activate the motor for (in milliseconds). Leave empty to turn the motor on indefinitely. |
|
|
|
|
<a name="WeDo2SmartHub+rampMotorSpeed"></a>
|
|
|
|
### weDo2SmartHub.rampMotorSpeed(port, fromSpeed, toSpeed, time) ⇒ <code>Promise</code>
|
|
Ramp the motor speed on a given port.
|
|
|
|
**Kind**: instance method of [<code>WeDo2SmartHub</code>](#WeDo2SmartHub)
|
|
**Returns**: <code>Promise</code> - Resolved upon successful completion of command.
|
|
|
|
| Param | Type | Description |
|
|
| --- | --- | --- |
|
|
| port | <code>string</code> | |
|
|
| fromSpeed | <code>number</code> | For forward, a value between 1 - 100 should be set. For reverse, a value between -1 to -100. Stop is 0. |
|
|
| toSpeed | <code>number</code> | For forward, a value between 1 - 100 should be set. For reverse, a value between -1 to -100. Stop is 0. |
|
|
| time | <code>number</code> | How long the ramp should last (in milliseconds). |
|
|
|
|
<a name="WeDo2SmartHub+playTone"></a>
|
|
|
|
### weDo2SmartHub.playTone(frequency, time) ⇒ <code>Promise</code>
|
|
Play a tone on the Hub's in-built buzzer
|
|
|
|
**Kind**: instance method of [<code>WeDo2SmartHub</code>](#WeDo2SmartHub)
|
|
**Returns**: <code>Promise</code> - Resolved upon successful completion of command (ie. once the tone has finished playing).
|
|
|
|
| Param | Type | Description |
|
|
| --- | --- | --- |
|
|
| frequency | <code>number</code> | |
|
|
| time | <code>number</code> | How long the tone should play for (in milliseconds). |
|
|
|
|
<a name="WeDo2SmartHub+setLightBrightness"></a>
|
|
|
|
### weDo2SmartHub.setLightBrightness(port, brightness, [time]) ⇒ <code>Promise</code>
|
|
Set the light brightness on a given port.
|
|
|
|
**Kind**: instance method of [<code>WeDo2SmartHub</code>](#WeDo2SmartHub)
|
|
**Returns**: <code>Promise</code> - Resolved upon successful completion of command. If time is specified, this is once the light is turned off.
|
|
|
|
| Param | Type | Description |
|
|
| --- | --- | --- |
|
|
| port | <code>string</code> | |
|
|
| brightness | <code>number</code> | Brightness value between 0-100 (0 is off) |
|
|
| [time] | <code>number</code> | How long to turn the light on (in milliseconds). Leave empty to turn the light on indefinitely. |
|
|
|
|
<a name="Hub+connect"></a>
|
|
|
|
### weDo2SmartHub.connect() ⇒ <code>Promise</code>
|
|
Connect to the Hub.
|
|
|
|
**Kind**: instance method of [<code>WeDo2SmartHub</code>](#WeDo2SmartHub)
|
|
**Overrides**: [<code>connect</code>](#Hub+connect)
|
|
**Returns**: <code>Promise</code> - Resolved upon successful connect.
|
|
<a name="Hub+disconnect"></a>
|
|
|
|
### weDo2SmartHub.disconnect() ⇒ <code>Promise</code>
|
|
Disconnect the Hub.
|
|
|
|
**Kind**: instance method of [<code>WeDo2SmartHub</code>](#WeDo2SmartHub)
|
|
**Returns**: <code>Promise</code> - Resolved upon successful disconnect.
|
|
<a name="Hub+subscribe"></a>
|
|
|
|
### weDo2SmartHub.subscribe(port, [mode]) ⇒ <code>Promise</code>
|
|
Subscribe to sensor notifications on a given port.
|
|
|
|
**Kind**: instance method of [<code>WeDo2SmartHub</code>](#WeDo2SmartHub)
|
|
**Returns**: <code>Promise</code> - Resolved upon successful issuance of command.
|
|
|
|
| Param | Type | Description |
|
|
| --- | --- | --- |
|
|
| port | <code>string</code> | |
|
|
| [mode] | <code>number</code> | The sensor mode to activate. If no mode is provided, the default for that sensor will be chosen. |
|
|
|
|
<a name="Hub+unsubscribe"></a>
|
|
|
|
### weDo2SmartHub.unsubscribe(port) ⇒ <code>Promise</code>
|
|
Unsubscribe to sensor notifications on a given port.
|
|
|
|
**Kind**: instance method of [<code>WeDo2SmartHub</code>](#WeDo2SmartHub)
|
|
**Returns**: <code>Promise</code> - Resolved upon successful issuance of command.
|
|
|
|
| Param | Type |
|
|
| --- | --- |
|
|
| port | <code>string</code> |
|
|
|
|
<a name="Hub+sleep"></a>
|
|
|
|
### weDo2SmartHub.sleep(delay) ⇒ <code>Promise</code>
|
|
Sleep a given amount of time.
|
|
|
|
This is a helper method to make it easier to add delays into a chain of commands.
|
|
|
|
**Kind**: instance method of [<code>WeDo2SmartHub</code>](#WeDo2SmartHub)
|
|
**Returns**: <code>Promise</code> - Resolved after the delay is finished.
|
|
|
|
| Param | Type | Description |
|
|
| --- | --- | --- |
|
|
| delay | <code>number</code> | How long to sleep (in milliseconds). |
|
|
|
|
<a name="Hub+wait"></a>
|
|
|
|
### weDo2SmartHub.wait(commands) ⇒ <code>Promise</code>
|
|
Wait until a given list of concurrently running commands are complete.
|
|
|
|
This is a helper method to make it easier to wait for concurrent commands to complete.
|
|
|
|
**Kind**: instance method of [<code>WeDo2SmartHub</code>](#WeDo2SmartHub)
|
|
**Returns**: <code>Promise</code> - Resolved after the commands are finished.
|
|
|
|
| Param | Type | Description |
|
|
| --- | --- | --- |
|
|
| commands | <code>Array.<Promise.<any>></code> | Array of executing commands. |
|
|
|
|
<a name="WeDo2SmartHub+event_button"></a>
|
|
|
|
### "button" (button, state)
|
|
Emits when a button is pressed.
|
|
|
|
**Kind**: event emitted by [<code>WeDo2SmartHub</code>](#WeDo2SmartHub)
|
|
|
|
| Param | Type | Description |
|
|
| --- | --- | --- |
|
|
| button | <code>string</code> | |
|
|
| state | <code>number</code> | A number representing one of the button state consts. |
|
|
|
|
<a name="WeDo2SmartHub+event_distance"></a>
|
|
|
|
### "distance" (port, distance)
|
|
Emits when a distance sensor is activated.
|
|
|
|
**Kind**: event emitted by [<code>WeDo2SmartHub</code>](#WeDo2SmartHub)
|
|
|
|
| Param | Type | Description |
|
|
| --- | --- | --- |
|
|
| port | <code>string</code> | |
|
|
| distance | <code>number</code> | Distance, in millimeters. |
|
|
|
|
<a name="WeDo2SmartHub+event_color"></a>
|
|
|
|
### "color" (port, color)
|
|
Emits when a color sensor is activated.
|
|
|
|
**Kind**: event emitted by [<code>WeDo2SmartHub</code>](#WeDo2SmartHub)
|
|
|
|
| Param | Type | Description |
|
|
| --- | --- | --- |
|
|
| port | <code>string</code> | |
|
|
| color | <code>number</code> | A number representing one of the LED color consts. |
|
|
|
|
<a name="WeDo2SmartHub+event_tilt"></a>
|
|
|
|
### "tilt" (port, x, y)
|
|
Emits when a tilt sensor is activated.
|
|
|
|
**Kind**: event emitted by [<code>WeDo2SmartHub</code>](#WeDo2SmartHub)
|
|
|
|
| Param | Type |
|
|
| --- | --- |
|
|
| port | <code>string</code> |
|
|
| x | <code>number</code> |
|
|
| y | <code>number</code> |
|
|
|
|
<a name="WeDo2SmartHub+event_rotate"></a>
|
|
|
|
### "rotate" (port, rotation)
|
|
Emits when a rotation sensor is activated.
|
|
|
|
**Kind**: event emitted by [<code>WeDo2SmartHub</code>](#WeDo2SmartHub)
|
|
|
|
| Param | Type |
|
|
| --- | --- |
|
|
| port | <code>string</code> |
|
|
| rotation | <code>number</code> |
|
|
|
|
<a name="Hub+event_attach"></a>
|
|
|
|
### "attach" (port, type)
|
|
Emits when a motor or sensor is attached to the Hub.
|
|
|
|
**Kind**: event emitted by [<code>WeDo2SmartHub</code>](#WeDo2SmartHub)
|
|
|
|
| Param | Type | Description |
|
|
| --- | --- | --- |
|
|
| port | <code>string</code> | |
|
|
| type | <code>number</code> | A number representing one of the peripheral consts. |
|
|
|
|
<a name="Hub+event_detach"></a>
|
|
|
|
### "detach" (port)
|
|
Emits when an attached motor or sensor is detached from the Hub.
|
|
|
|
**Kind**: event emitted by [<code>WeDo2SmartHub</code>](#WeDo2SmartHub)
|
|
|
|
| Param | Type |
|
|
| --- | --- |
|
|
| port | <code>string</code> |
|
|
|
|
<a name="BoostMoveHub"></a>
|
|
|
|
## BoostMoveHub ⇐ <code>LPF2Hub</code>
|
|
**Kind**: global class
|
|
**Extends**: <code>LPF2Hub</code>, <code>Hub</code>
|
|
|
|
* [BoostMoveHub](#BoostMoveHub) ⇐ <code>LPF2Hub</code>
|
|
* [new BoostMoveHub()](#new_BoostMoveHub_new)
|
|
* [.current](#LPF2Hub+current)
|
|
* [.name](#Hub+name)
|
|
* [.uuid](#Hub+uuid)
|
|
* [.rssi](#Hub+rssi)
|
|
* [.batteryLevel](#Hub+batteryLevel)
|
|
* [.setMotorSpeed(port, speed, [time])](#BoostMoveHub+setMotorSpeed) ⇒ <code>Promise</code>
|
|
* [.rampMotorSpeed(port, fromSpeed, toSpeed, time)](#BoostMoveHub+rampMotorSpeed) ⇒ <code>Promise</code>
|
|
* [.setMotorAngle(port, angle, [speed])](#BoostMoveHub+setMotorAngle) ⇒ <code>Promise</code>
|
|
* [.setLightBrightness(port, brightness, [time])](#BoostMoveHub+setLightBrightness) ⇒ <code>Promise</code>
|
|
* [.setName(name)](#LPF2Hub+setName) ⇒ <code>Promise</code>
|
|
* [.setLEDColor(color)](#LPF2Hub+setLEDColor) ⇒ <code>Promise</code>
|
|
* [.setLEDRGB(red, green, blue)](#LPF2Hub+setLEDRGB) ⇒ <code>Promise</code>
|
|
* [.connect()](#Hub+connect) ⇒ <code>Promise</code>
|
|
* [.disconnect()](#Hub+disconnect) ⇒ <code>Promise</code>
|
|
* [.subscribe(port, [mode])](#Hub+subscribe) ⇒ <code>Promise</code>
|
|
* [.unsubscribe(port)](#Hub+unsubscribe) ⇒ <code>Promise</code>
|
|
* [.sleep(delay)](#Hub+sleep) ⇒ <code>Promise</code>
|
|
* [.wait(commands)](#Hub+wait) ⇒ <code>Promise</code>
|
|
* ["button" (button, state)](#LPF2Hub+event_button)
|
|
* ["distance" (port, distance)](#LPF2Hub+event_distance)
|
|
* ["color" (port, color)](#LPF2Hub+event_color)
|
|
* ["tilt" (port, x, y)](#LPF2Hub+event_tilt)
|
|
* ["rotate" (port, rotation)](#LPF2Hub+event_rotate)
|
|
* ["attach" (port, type)](#Hub+event_attach)
|
|
* ["detach" (port)](#Hub+event_detach)
|
|
|
|
<a name="new_BoostMoveHub_new"></a>
|
|
|
|
### new BoostMoveHub()
|
|
The BoostMoveHub is emitted if the discovered device is a Boost Move Hub.
|
|
|
|
<a name="LPF2Hub+current"></a>
|
|
|
|
### boostMoveHub.current
|
|
**Kind**: instance property of [<code>BoostMoveHub</code>](#BoostMoveHub)
|
|
**Read only**: true
|
|
**Properties**
|
|
|
|
| Name | Type | Description |
|
|
| --- | --- | --- |
|
|
| current | <code>number</code> | Current usage of the hub (Amps) |
|
|
|
|
<a name="Hub+name"></a>
|
|
|
|
### boostMoveHub.name
|
|
**Kind**: instance property of [<code>BoostMoveHub</code>](#BoostMoveHub)
|
|
**Read only**: true
|
|
**Properties**
|
|
|
|
| Name | Type | Description |
|
|
| --- | --- | --- |
|
|
| name | <code>string</code> | Name of the hub |
|
|
|
|
<a name="Hub+uuid"></a>
|
|
|
|
### boostMoveHub.uuid
|
|
**Kind**: instance property of [<code>BoostMoveHub</code>](#BoostMoveHub)
|
|
**Read only**: true
|
|
**Properties**
|
|
|
|
| Name | Type | Description |
|
|
| --- | --- | --- |
|
|
| uuid | <code>string</code> | UUID of the hub |
|
|
|
|
<a name="Hub+rssi"></a>
|
|
|
|
### boostMoveHub.rssi
|
|
**Kind**: instance property of [<code>BoostMoveHub</code>](#BoostMoveHub)
|
|
**Read only**: true
|
|
**Properties**
|
|
|
|
| Name | Type | Description |
|
|
| --- | --- | --- |
|
|
| rssi | <code>number</code> | Signal strength of the hub |
|
|
|
|
<a name="Hub+batteryLevel"></a>
|
|
|
|
### boostMoveHub.batteryLevel
|
|
**Kind**: instance property of [<code>BoostMoveHub</code>](#BoostMoveHub)
|
|
**Read only**: true
|
|
**Properties**
|
|
|
|
| Name | Type | Description |
|
|
| --- | --- | --- |
|
|
| batteryLevel | <code>number</code> | Battery level of the hub (Percentage between 0-100) |
|
|
|
|
<a name="BoostMoveHub+setMotorSpeed"></a>
|
|
|
|
### boostMoveHub.setMotorSpeed(port, speed, [time]) ⇒ <code>Promise</code>
|
|
Set the motor speed on a given port.
|
|
|
|
**Kind**: instance method of [<code>BoostMoveHub</code>](#BoostMoveHub)
|
|
**Returns**: <code>Promise</code> - Resolved upon successful completion of command. If time is specified, this is once the motor is finished.
|
|
|
|
| Param | Type | Description |
|
|
| --- | --- | --- |
|
|
| port | <code>string</code> | |
|
|
| speed | <code>number</code> \| <code>Array.<number></code> | 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. |
|
|
| [time] | <code>number</code> | How long to activate the motor for (in milliseconds). Leave empty to turn the motor on indefinitely. |
|
|
|
|
<a name="BoostMoveHub+rampMotorSpeed"></a>
|
|
|
|
### boostMoveHub.rampMotorSpeed(port, fromSpeed, toSpeed, time) ⇒ <code>Promise</code>
|
|
Ramp the motor speed on a given port.
|
|
|
|
**Kind**: instance method of [<code>BoostMoveHub</code>](#BoostMoveHub)
|
|
**Returns**: <code>Promise</code> - Resolved upon successful completion of command.
|
|
|
|
| Param | Type | Description |
|
|
| --- | --- | --- |
|
|
| port | <code>string</code> | |
|
|
| fromSpeed | <code>number</code> | For forward, a value between 1 - 100 should be set. For reverse, a value between -1 to -100. Stop is 0. |
|
|
| toSpeed | <code>number</code> | For forward, a value between 1 - 100 should be set. For reverse, a value between -1 to -100. Stop is 0. |
|
|
| time | <code>number</code> | How long the ramp should last (in milliseconds). |
|
|
|
|
<a name="BoostMoveHub+setMotorAngle"></a>
|
|
|
|
### boostMoveHub.setMotorAngle(port, angle, [speed]) ⇒ <code>Promise</code>
|
|
Rotate a motor by a given angle.
|
|
|
|
**Kind**: instance method of [<code>BoostMoveHub</code>](#BoostMoveHub)
|
|
**Returns**: <code>Promise</code> - Resolved upon successful completion of command (ie. once the motor is finished).
|
|
|
|
| Param | Type | Default | Description |
|
|
| --- | --- | --- | --- |
|
|
| port | <code>string</code> | | |
|
|
| angle | <code>number</code> | | How much the motor should be rotated (in degrees). |
|
|
| [speed] | <code>number</code> \| <code>Array.<number></code> | <code>100</code> | 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. |
|
|
|
|
<a name="BoostMoveHub+setLightBrightness"></a>
|
|
|
|
### boostMoveHub.setLightBrightness(port, brightness, [time]) ⇒ <code>Promise</code>
|
|
Set the light brightness on a given port.
|
|
|
|
**Kind**: instance method of [<code>BoostMoveHub</code>](#BoostMoveHub)
|
|
**Returns**: <code>Promise</code> - Resolved upon successful completion of command. If time is specified, this is once the light is turned off.
|
|
|
|
| Param | Type | Description |
|
|
| --- | --- | --- |
|
|
| port | <code>string</code> | |
|
|
| brightness | <code>number</code> | Brightness value between 0-100 (0 is off) |
|
|
| [time] | <code>number</code> | How long to turn the light on (in milliseconds). Leave empty to turn the light on indefinitely. |
|
|
|
|
<a name="LPF2Hub+setName"></a>
|
|
|
|
### boostMoveHub.setName(name) ⇒ <code>Promise</code>
|
|
Set the name of the Hub.
|
|
|
|
**Kind**: instance method of [<code>BoostMoveHub</code>](#BoostMoveHub)
|
|
**Returns**: <code>Promise</code> - Resolved upon successful issuance of command.
|
|
|
|
| Param | Type | Description |
|
|
| --- | --- | --- |
|
|
| name | <code>string</code> | New name of the hub (14 characters or less, ASCII only). |
|
|
|
|
<a name="LPF2Hub+setLEDColor"></a>
|
|
|
|
### boostMoveHub.setLEDColor(color) ⇒ <code>Promise</code>
|
|
Set the color of the LED on the Hub via a color value.
|
|
|
|
**Kind**: instance method of [<code>BoostMoveHub</code>](#BoostMoveHub)
|
|
**Returns**: <code>Promise</code> - Resolved upon successful issuance of command.
|
|
|
|
| Param | Type | Description |
|
|
| --- | --- | --- |
|
|
| color | <code>number</code> | A number representing one of the LED color consts. |
|
|
|
|
<a name="LPF2Hub+setLEDRGB"></a>
|
|
|
|
### boostMoveHub.setLEDRGB(red, green, blue) ⇒ <code>Promise</code>
|
|
Set the color of the LED on the Hub via RGB values.
|
|
|
|
**Kind**: instance method of [<code>BoostMoveHub</code>](#BoostMoveHub)
|
|
**Returns**: <code>Promise</code> - Resolved upon successful issuance of command.
|
|
|
|
| Param | Type |
|
|
| --- | --- |
|
|
| red | <code>number</code> |
|
|
| green | <code>number</code> |
|
|
| blue | <code>number</code> |
|
|
|
|
<a name="Hub+connect"></a>
|
|
|
|
### boostMoveHub.connect() ⇒ <code>Promise</code>
|
|
Connect to the Hub.
|
|
|
|
**Kind**: instance method of [<code>BoostMoveHub</code>](#BoostMoveHub)
|
|
**Overrides**: [<code>connect</code>](#Hub+connect)
|
|
**Returns**: <code>Promise</code> - Resolved upon successful connect.
|
|
<a name="Hub+disconnect"></a>
|
|
|
|
### boostMoveHub.disconnect() ⇒ <code>Promise</code>
|
|
Disconnect the Hub.
|
|
|
|
**Kind**: instance method of [<code>BoostMoveHub</code>](#BoostMoveHub)
|
|
**Returns**: <code>Promise</code> - Resolved upon successful disconnect.
|
|
<a name="Hub+subscribe"></a>
|
|
|
|
### boostMoveHub.subscribe(port, [mode]) ⇒ <code>Promise</code>
|
|
Subscribe to sensor notifications on a given port.
|
|
|
|
**Kind**: instance method of [<code>BoostMoveHub</code>](#BoostMoveHub)
|
|
**Returns**: <code>Promise</code> - Resolved upon successful issuance of command.
|
|
|
|
| Param | Type | Description |
|
|
| --- | --- | --- |
|
|
| port | <code>string</code> | |
|
|
| [mode] | <code>number</code> | The sensor mode to activate. If no mode is provided, the default for that sensor will be chosen. |
|
|
|
|
<a name="Hub+unsubscribe"></a>
|
|
|
|
### boostMoveHub.unsubscribe(port) ⇒ <code>Promise</code>
|
|
Unsubscribe to sensor notifications on a given port.
|
|
|
|
**Kind**: instance method of [<code>BoostMoveHub</code>](#BoostMoveHub)
|
|
**Returns**: <code>Promise</code> - Resolved upon successful issuance of command.
|
|
|
|
| Param | Type |
|
|
| --- | --- |
|
|
| port | <code>string</code> |
|
|
|
|
<a name="Hub+sleep"></a>
|
|
|
|
### boostMoveHub.sleep(delay) ⇒ <code>Promise</code>
|
|
Sleep a given amount of time.
|
|
|
|
This is a helper method to make it easier to add delays into a chain of commands.
|
|
|
|
**Kind**: instance method of [<code>BoostMoveHub</code>](#BoostMoveHub)
|
|
**Returns**: <code>Promise</code> - Resolved after the delay is finished.
|
|
|
|
| Param | Type | Description |
|
|
| --- | --- | --- |
|
|
| delay | <code>number</code> | How long to sleep (in milliseconds). |
|
|
|
|
<a name="Hub+wait"></a>
|
|
|
|
### boostMoveHub.wait(commands) ⇒ <code>Promise</code>
|
|
Wait until a given list of concurrently running commands are complete.
|
|
|
|
This is a helper method to make it easier to wait for concurrent commands to complete.
|
|
|
|
**Kind**: instance method of [<code>BoostMoveHub</code>](#BoostMoveHub)
|
|
**Returns**: <code>Promise</code> - Resolved after the commands are finished.
|
|
|
|
| Param | Type | Description |
|
|
| --- | --- | --- |
|
|
| commands | <code>Array.<Promise.<any>></code> | Array of executing commands. |
|
|
|
|
<a name="LPF2Hub+event_button"></a>
|
|
|
|
### "button" (button, state)
|
|
Emits when a button is pressed.
|
|
|
|
**Kind**: event emitted by [<code>BoostMoveHub</code>](#BoostMoveHub)
|
|
|
|
| Param | Type | Description |
|
|
| --- | --- | --- |
|
|
| button | <code>string</code> | |
|
|
| state | <code>number</code> | A number representing one of the button state consts. |
|
|
|
|
<a name="LPF2Hub+event_distance"></a>
|
|
|
|
### "distance" (port, distance)
|
|
Emits when a distance sensor is activated.
|
|
|
|
**Kind**: event emitted by [<code>BoostMoveHub</code>](#BoostMoveHub)
|
|
|
|
| Param | Type | Description |
|
|
| --- | --- | --- |
|
|
| port | <code>string</code> | |
|
|
| distance | <code>number</code> | Distance, in millimeters. |
|
|
|
|
<a name="LPF2Hub+event_color"></a>
|
|
|
|
### "color" (port, color)
|
|
Emits when a color sensor is activated.
|
|
|
|
**Kind**: event emitted by [<code>BoostMoveHub</code>](#BoostMoveHub)
|
|
|
|
| Param | Type | Description |
|
|
| --- | --- | --- |
|
|
| port | <code>string</code> | |
|
|
| color | <code>number</code> | A number representing one of the LED color consts. |
|
|
|
|
<a name="LPF2Hub+event_tilt"></a>
|
|
|
|
### "tilt" (port, x, y)
|
|
Emits when a tilt sensor is activated.
|
|
|
|
**Kind**: event emitted by [<code>BoostMoveHub</code>](#BoostMoveHub)
|
|
|
|
| Param | Type | Description |
|
|
| --- | --- | --- |
|
|
| port | <code>string</code> | If the event is fired from the Move Hub's in-built tilt sensor, the special port "TILT" is used. |
|
|
| x | <code>number</code> | |
|
|
| y | <code>number</code> | |
|
|
|
|
<a name="LPF2Hub+event_rotate"></a>
|
|
|
|
### "rotate" (port, rotation)
|
|
Emits when a rotation sensor is activated.
|
|
|
|
**Kind**: event emitted by [<code>BoostMoveHub</code>](#BoostMoveHub)
|
|
|
|
| Param | Type |
|
|
| --- | --- |
|
|
| port | <code>string</code> |
|
|
| rotation | <code>number</code> |
|
|
|
|
<a name="Hub+event_attach"></a>
|
|
|
|
### "attach" (port, type)
|
|
Emits when a motor or sensor is attached to the Hub.
|
|
|
|
**Kind**: event emitted by [<code>BoostMoveHub</code>](#BoostMoveHub)
|
|
|
|
| Param | Type | Description |
|
|
| --- | --- | --- |
|
|
| port | <code>string</code> | |
|
|
| type | <code>number</code> | A number representing one of the peripheral consts. |
|
|
|
|
<a name="Hub+event_detach"></a>
|
|
|
|
### "detach" (port)
|
|
Emits when an attached motor or sensor is detached from the Hub.
|
|
|
|
**Kind**: event emitted by [<code>BoostMoveHub</code>](#BoostMoveHub)
|
|
|
|
| Param | Type |
|
|
| --- | --- |
|
|
| port | <code>string</code> |
|
|
|
|
<a name="PUPHub"></a>
|
|
|
|
## PUPHub ⇐ <code>LPF2Hub</code>
|
|
**Kind**: global class
|
|
**Extends**: <code>LPF2Hub</code>, <code>Hub</code>
|
|
|
|
* [PUPHub](#PUPHub) ⇐ <code>LPF2Hub</code>
|
|
* [new PUPHub()](#new_PUPHub_new)
|
|
* [.current](#LPF2Hub+current)
|
|
* [.name](#Hub+name)
|
|
* [.uuid](#Hub+uuid)
|
|
* [.rssi](#Hub+rssi)
|
|
* [.batteryLevel](#Hub+batteryLevel)
|
|
* [.setMotorSpeed(port, speed, [time])](#PUPHub+setMotorSpeed) ⇒ <code>Promise</code>
|
|
* [.rampMotorSpeed(port, fromSpeed, toSpeed, time)](#PUPHub+rampMotorSpeed) ⇒ <code>Promise</code>
|
|
* [.setLightBrightness(port, brightness, [time])](#PUPHub+setLightBrightness) ⇒ <code>Promise</code>
|
|
* [.setName(name)](#LPF2Hub+setName) ⇒ <code>Promise</code>
|
|
* [.setLEDColor(color)](#LPF2Hub+setLEDColor) ⇒ <code>Promise</code>
|
|
* [.setLEDRGB(red, green, blue)](#LPF2Hub+setLEDRGB) ⇒ <code>Promise</code>
|
|
* [.connect()](#Hub+connect) ⇒ <code>Promise</code>
|
|
* [.disconnect()](#Hub+disconnect) ⇒ <code>Promise</code>
|
|
* [.subscribe(port, [mode])](#Hub+subscribe) ⇒ <code>Promise</code>
|
|
* [.unsubscribe(port)](#Hub+unsubscribe) ⇒ <code>Promise</code>
|
|
* [.sleep(delay)](#Hub+sleep) ⇒ <code>Promise</code>
|
|
* [.wait(commands)](#Hub+wait) ⇒ <code>Promise</code>
|
|
* ["button" (button, state)](#LPF2Hub+event_button)
|
|
* ["distance" (port, distance)](#LPF2Hub+event_distance)
|
|
* ["color" (port, color)](#LPF2Hub+event_color)
|
|
* ["tilt" (port, x, y)](#LPF2Hub+event_tilt)
|
|
* ["attach" (port, type)](#Hub+event_attach)
|
|
* ["detach" (port)](#Hub+event_detach)
|
|
|
|
<a name="new_PUPHub_new"></a>
|
|
|
|
### new PUPHub()
|
|
The PUPHub is emitted if the discovered device is a Powered UP Hub.
|
|
|
|
<a name="LPF2Hub+current"></a>
|
|
|
|
### pupHub.current
|
|
**Kind**: instance property of [<code>PUPHub</code>](#PUPHub)
|
|
**Read only**: true
|
|
**Properties**
|
|
|
|
| Name | Type | Description |
|
|
| --- | --- | --- |
|
|
| current | <code>number</code> | Current usage of the hub (Amps) |
|
|
|
|
<a name="Hub+name"></a>
|
|
|
|
### pupHub.name
|
|
**Kind**: instance property of [<code>PUPHub</code>](#PUPHub)
|
|
**Read only**: true
|
|
**Properties**
|
|
|
|
| Name | Type | Description |
|
|
| --- | --- | --- |
|
|
| name | <code>string</code> | Name of the hub |
|
|
|
|
<a name="Hub+uuid"></a>
|
|
|
|
### pupHub.uuid
|
|
**Kind**: instance property of [<code>PUPHub</code>](#PUPHub)
|
|
**Read only**: true
|
|
**Properties**
|
|
|
|
| Name | Type | Description |
|
|
| --- | --- | --- |
|
|
| uuid | <code>string</code> | UUID of the hub |
|
|
|
|
<a name="Hub+rssi"></a>
|
|
|
|
### pupHub.rssi
|
|
**Kind**: instance property of [<code>PUPHub</code>](#PUPHub)
|
|
**Read only**: true
|
|
**Properties**
|
|
|
|
| Name | Type | Description |
|
|
| --- | --- | --- |
|
|
| rssi | <code>number</code> | Signal strength of the hub |
|
|
|
|
<a name="Hub+batteryLevel"></a>
|
|
|
|
### pupHub.batteryLevel
|
|
**Kind**: instance property of [<code>PUPHub</code>](#PUPHub)
|
|
**Read only**: true
|
|
**Properties**
|
|
|
|
| Name | Type | Description |
|
|
| --- | --- | --- |
|
|
| batteryLevel | <code>number</code> | Battery level of the hub (Percentage between 0-100) |
|
|
|
|
<a name="PUPHub+setMotorSpeed"></a>
|
|
|
|
### pupHub.setMotorSpeed(port, speed, [time]) ⇒ <code>Promise</code>
|
|
Set the motor speed on a given port.
|
|
|
|
**Kind**: instance method of [<code>PUPHub</code>](#PUPHub)
|
|
**Returns**: <code>Promise</code> - Resolved upon successful completion of command. If time is specified, this is once the motor is finished.
|
|
|
|
| Param | Type | Description |
|
|
| --- | --- | --- |
|
|
| port | <code>string</code> | |
|
|
| speed | <code>number</code> \| <code>Array.<number></code> | 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. |
|
|
| [time] | <code>number</code> | How long to activate the motor for (in milliseconds). Leave empty to turn the motor on indefinitely. |
|
|
|
|
<a name="PUPHub+rampMotorSpeed"></a>
|
|
|
|
### pupHub.rampMotorSpeed(port, fromSpeed, toSpeed, time) ⇒ <code>Promise</code>
|
|
Ramp the motor speed on a given port.
|
|
|
|
**Kind**: instance method of [<code>PUPHub</code>](#PUPHub)
|
|
**Returns**: <code>Promise</code> - Resolved upon successful completion of command.
|
|
|
|
| Param | Type | Description |
|
|
| --- | --- | --- |
|
|
| port | <code>string</code> | |
|
|
| fromSpeed | <code>number</code> | For forward, a value between 1 - 100 should be set. For reverse, a value between -1 to -100. Stop is 0. |
|
|
| toSpeed | <code>number</code> | For forward, a value between 1 - 100 should be set. For reverse, a value between -1 to -100. Stop is 0. |
|
|
| time | <code>number</code> | How long the ramp should last (in milliseconds). |
|
|
|
|
<a name="PUPHub+setLightBrightness"></a>
|
|
|
|
### pupHub.setLightBrightness(port, brightness, [time]) ⇒ <code>Promise</code>
|
|
Set the light brightness on a given port.
|
|
|
|
**Kind**: instance method of [<code>PUPHub</code>](#PUPHub)
|
|
**Returns**: <code>Promise</code> - Resolved upon successful completion of command. If time is specified, this is once the light is turned off.
|
|
|
|
| Param | Type | Description |
|
|
| --- | --- | --- |
|
|
| port | <code>string</code> | |
|
|
| brightness | <code>number</code> | Brightness value between 0-100 (0 is off) |
|
|
| [time] | <code>number</code> | How long to turn the light on (in milliseconds). Leave empty to turn the light on indefinitely. |
|
|
|
|
<a name="LPF2Hub+setName"></a>
|
|
|
|
### pupHub.setName(name) ⇒ <code>Promise</code>
|
|
Set the name of the Hub.
|
|
|
|
**Kind**: instance method of [<code>PUPHub</code>](#PUPHub)
|
|
**Returns**: <code>Promise</code> - Resolved upon successful issuance of command.
|
|
|
|
| Param | Type | Description |
|
|
| --- | --- | --- |
|
|
| name | <code>string</code> | New name of the hub (14 characters or less, ASCII only). |
|
|
|
|
<a name="LPF2Hub+setLEDColor"></a>
|
|
|
|
### pupHub.setLEDColor(color) ⇒ <code>Promise</code>
|
|
Set the color of the LED on the Hub via a color value.
|
|
|
|
**Kind**: instance method of [<code>PUPHub</code>](#PUPHub)
|
|
**Returns**: <code>Promise</code> - Resolved upon successful issuance of command.
|
|
|
|
| Param | Type | Description |
|
|
| --- | --- | --- |
|
|
| color | <code>number</code> | A number representing one of the LED color consts. |
|
|
|
|
<a name="LPF2Hub+setLEDRGB"></a>
|
|
|
|
### pupHub.setLEDRGB(red, green, blue) ⇒ <code>Promise</code>
|
|
Set the color of the LED on the Hub via RGB values.
|
|
|
|
**Kind**: instance method of [<code>PUPHub</code>](#PUPHub)
|
|
**Returns**: <code>Promise</code> - Resolved upon successful issuance of command.
|
|
|
|
| Param | Type |
|
|
| --- | --- |
|
|
| red | <code>number</code> |
|
|
| green | <code>number</code> |
|
|
| blue | <code>number</code> |
|
|
|
|
<a name="Hub+connect"></a>
|
|
|
|
### pupHub.connect() ⇒ <code>Promise</code>
|
|
Connect to the Hub.
|
|
|
|
**Kind**: instance method of [<code>PUPHub</code>](#PUPHub)
|
|
**Overrides**: [<code>connect</code>](#Hub+connect)
|
|
**Returns**: <code>Promise</code> - Resolved upon successful connect.
|
|
<a name="Hub+disconnect"></a>
|
|
|
|
### pupHub.disconnect() ⇒ <code>Promise</code>
|
|
Disconnect the Hub.
|
|
|
|
**Kind**: instance method of [<code>PUPHub</code>](#PUPHub)
|
|
**Returns**: <code>Promise</code> - Resolved upon successful disconnect.
|
|
<a name="Hub+subscribe"></a>
|
|
|
|
### pupHub.subscribe(port, [mode]) ⇒ <code>Promise</code>
|
|
Subscribe to sensor notifications on a given port.
|
|
|
|
**Kind**: instance method of [<code>PUPHub</code>](#PUPHub)
|
|
**Returns**: <code>Promise</code> - Resolved upon successful issuance of command.
|
|
|
|
| Param | Type | Description |
|
|
| --- | --- | --- |
|
|
| port | <code>string</code> | |
|
|
| [mode] | <code>number</code> | The sensor mode to activate. If no mode is provided, the default for that sensor will be chosen. |
|
|
|
|
<a name="Hub+unsubscribe"></a>
|
|
|
|
### pupHub.unsubscribe(port) ⇒ <code>Promise</code>
|
|
Unsubscribe to sensor notifications on a given port.
|
|
|
|
**Kind**: instance method of [<code>PUPHub</code>](#PUPHub)
|
|
**Returns**: <code>Promise</code> - Resolved upon successful issuance of command.
|
|
|
|
| Param | Type |
|
|
| --- | --- |
|
|
| port | <code>string</code> |
|
|
|
|
<a name="Hub+sleep"></a>
|
|
|
|
### pupHub.sleep(delay) ⇒ <code>Promise</code>
|
|
Sleep a given amount of time.
|
|
|
|
This is a helper method to make it easier to add delays into a chain of commands.
|
|
|
|
**Kind**: instance method of [<code>PUPHub</code>](#PUPHub)
|
|
**Returns**: <code>Promise</code> - Resolved after the delay is finished.
|
|
|
|
| Param | Type | Description |
|
|
| --- | --- | --- |
|
|
| delay | <code>number</code> | How long to sleep (in milliseconds). |
|
|
|
|
<a name="Hub+wait"></a>
|
|
|
|
### pupHub.wait(commands) ⇒ <code>Promise</code>
|
|
Wait until a given list of concurrently running commands are complete.
|
|
|
|
This is a helper method to make it easier to wait for concurrent commands to complete.
|
|
|
|
**Kind**: instance method of [<code>PUPHub</code>](#PUPHub)
|
|
**Returns**: <code>Promise</code> - Resolved after the commands are finished.
|
|
|
|
| Param | Type | Description |
|
|
| --- | --- | --- |
|
|
| commands | <code>Array.<Promise.<any>></code> | Array of executing commands. |
|
|
|
|
<a name="LPF2Hub+event_button"></a>
|
|
|
|
### "button" (button, state)
|
|
Emits when a button is pressed.
|
|
|
|
**Kind**: event emitted by [<code>PUPHub</code>](#PUPHub)
|
|
|
|
| Param | Type | Description |
|
|
| --- | --- | --- |
|
|
| button | <code>string</code> | |
|
|
| state | <code>number</code> | A number representing one of the button state consts. |
|
|
|
|
<a name="LPF2Hub+event_distance"></a>
|
|
|
|
### "distance" (port, distance)
|
|
Emits when a distance sensor is activated.
|
|
|
|
**Kind**: event emitted by [<code>PUPHub</code>](#PUPHub)
|
|
|
|
| Param | Type | Description |
|
|
| --- | --- | --- |
|
|
| port | <code>string</code> | |
|
|
| distance | <code>number</code> | Distance, in millimeters. |
|
|
|
|
<a name="LPF2Hub+event_color"></a>
|
|
|
|
### "color" (port, color)
|
|
Emits when a color sensor is activated.
|
|
|
|
**Kind**: event emitted by [<code>PUPHub</code>](#PUPHub)
|
|
|
|
| Param | Type | Description |
|
|
| --- | --- | --- |
|
|
| port | <code>string</code> | |
|
|
| color | <code>number</code> | A number representing one of the LED color consts. |
|
|
|
|
<a name="LPF2Hub+event_tilt"></a>
|
|
|
|
### "tilt" (port, x, y)
|
|
Emits when a tilt sensor is activated.
|
|
|
|
**Kind**: event emitted by [<code>PUPHub</code>](#PUPHub)
|
|
|
|
| Param | Type | Description |
|
|
| --- | --- | --- |
|
|
| port | <code>string</code> | If the event is fired from the Move Hub's in-built tilt sensor, the special port "TILT" is used. |
|
|
| x | <code>number</code> | |
|
|
| y | <code>number</code> | |
|
|
|
|
<a name="Hub+event_attach"></a>
|
|
|
|
### "attach" (port, type)
|
|
Emits when a motor or sensor is attached to the Hub.
|
|
|
|
**Kind**: event emitted by [<code>PUPHub</code>](#PUPHub)
|
|
|
|
| Param | Type | Description |
|
|
| --- | --- | --- |
|
|
| port | <code>string</code> | |
|
|
| type | <code>number</code> | A number representing one of the peripheral consts. |
|
|
|
|
<a name="Hub+event_detach"></a>
|
|
|
|
### "detach" (port)
|
|
Emits when an attached motor or sensor is detached from the Hub.
|
|
|
|
**Kind**: event emitted by [<code>PUPHub</code>](#PUPHub)
|
|
|
|
| Param | Type |
|
|
| --- | --- |
|
|
| port | <code>string</code> |
|
|
|
|
<a name="PUPRemote"></a>
|
|
|
|
## PUPRemote ⇐ <code>LPF2Hub</code>
|
|
**Kind**: global class
|
|
**Extends**: <code>LPF2Hub</code>, <code>Hub</code>
|
|
|
|
* [PUPRemote](#PUPRemote) ⇐ <code>LPF2Hub</code>
|
|
* [new PUPRemote()](#new_PUPRemote_new)
|
|
* [.current](#LPF2Hub+current)
|
|
* [.name](#Hub+name)
|
|
* [.uuid](#Hub+uuid)
|
|
* [.rssi](#Hub+rssi)
|
|
* [.batteryLevel](#Hub+batteryLevel)
|
|
* [.setLEDColor(color)](#PUPRemote+setLEDColor) ⇒ <code>Promise</code>
|
|
* [.setLEDRGB(red, green, blue)](#PUPRemote+setLEDRGB) ⇒ <code>Promise</code>
|
|
* [.setName(name)](#LPF2Hub+setName) ⇒ <code>Promise</code>
|
|
* [.connect()](#Hub+connect) ⇒ <code>Promise</code>
|
|
* [.disconnect()](#Hub+disconnect) ⇒ <code>Promise</code>
|
|
* [.subscribe(port, [mode])](#Hub+subscribe) ⇒ <code>Promise</code>
|
|
* [.unsubscribe(port)](#Hub+unsubscribe) ⇒ <code>Promise</code>
|
|
* [.sleep(delay)](#Hub+sleep) ⇒ <code>Promise</code>
|
|
* [.wait(commands)](#Hub+wait) ⇒ <code>Promise</code>
|
|
* ["button" (button, state)](#LPF2Hub+event_button)
|
|
|
|
<a name="new_PUPRemote_new"></a>
|
|
|
|
### new PUPRemote()
|
|
The PUPRemote is emitted if the discovered device is a Powered UP Remote.
|
|
|
|
<a name="LPF2Hub+current"></a>
|
|
|
|
### pupRemote.current
|
|
**Kind**: instance property of [<code>PUPRemote</code>](#PUPRemote)
|
|
**Read only**: true
|
|
**Properties**
|
|
|
|
| Name | Type | Description |
|
|
| --- | --- | --- |
|
|
| current | <code>number</code> | Current usage of the hub (Amps) |
|
|
|
|
<a name="Hub+name"></a>
|
|
|
|
### pupRemote.name
|
|
**Kind**: instance property of [<code>PUPRemote</code>](#PUPRemote)
|
|
**Read only**: true
|
|
**Properties**
|
|
|
|
| Name | Type | Description |
|
|
| --- | --- | --- |
|
|
| name | <code>string</code> | Name of the hub |
|
|
|
|
<a name="Hub+uuid"></a>
|
|
|
|
### pupRemote.uuid
|
|
**Kind**: instance property of [<code>PUPRemote</code>](#PUPRemote)
|
|
**Read only**: true
|
|
**Properties**
|
|
|
|
| Name | Type | Description |
|
|
| --- | --- | --- |
|
|
| uuid | <code>string</code> | UUID of the hub |
|
|
|
|
<a name="Hub+rssi"></a>
|
|
|
|
### pupRemote.rssi
|
|
**Kind**: instance property of [<code>PUPRemote</code>](#PUPRemote)
|
|
**Read only**: true
|
|
**Properties**
|
|
|
|
| Name | Type | Description |
|
|
| --- | --- | --- |
|
|
| rssi | <code>number</code> | Signal strength of the hub |
|
|
|
|
<a name="Hub+batteryLevel"></a>
|
|
|
|
### pupRemote.batteryLevel
|
|
**Kind**: instance property of [<code>PUPRemote</code>](#PUPRemote)
|
|
**Read only**: true
|
|
**Properties**
|
|
|
|
| Name | Type | Description |
|
|
| --- | --- | --- |
|
|
| batteryLevel | <code>number</code> | Battery level of the hub (Percentage between 0-100) |
|
|
|
|
<a name="PUPRemote+setLEDColor"></a>
|
|
|
|
### pupRemote.setLEDColor(color) ⇒ <code>Promise</code>
|
|
Set the color of the LED on the Remote via a color value.
|
|
|
|
**Kind**: instance method of [<code>PUPRemote</code>](#PUPRemote)
|
|
**Overrides**: [<code>setLEDColor</code>](#LPF2Hub+setLEDColor)
|
|
**Returns**: <code>Promise</code> - Resolved upon successful issuance of command.
|
|
|
|
| Param | Type | Description |
|
|
| --- | --- | --- |
|
|
| color | <code>number</code> | A number representing one of the LED color consts. |
|
|
|
|
<a name="PUPRemote+setLEDRGB"></a>
|
|
|
|
### pupRemote.setLEDRGB(red, green, blue) ⇒ <code>Promise</code>
|
|
Set the color of the LED on the Hub via RGB values.
|
|
|
|
**Kind**: instance method of [<code>PUPRemote</code>](#PUPRemote)
|
|
**Overrides**: [<code>setLEDRGB</code>](#LPF2Hub+setLEDRGB)
|
|
**Returns**: <code>Promise</code> - Resolved upon successful issuance of command.
|
|
|
|
| Param | Type |
|
|
| --- | --- |
|
|
| red | <code>number</code> |
|
|
| green | <code>number</code> |
|
|
| blue | <code>number</code> |
|
|
|
|
<a name="LPF2Hub+setName"></a>
|
|
|
|
### pupRemote.setName(name) ⇒ <code>Promise</code>
|
|
Set the name of the Hub.
|
|
|
|
**Kind**: instance method of [<code>PUPRemote</code>](#PUPRemote)
|
|
**Returns**: <code>Promise</code> - Resolved upon successful issuance of command.
|
|
|
|
| Param | Type | Description |
|
|
| --- | --- | --- |
|
|
| name | <code>string</code> | New name of the hub (14 characters or less, ASCII only). |
|
|
|
|
<a name="Hub+connect"></a>
|
|
|
|
### pupRemote.connect() ⇒ <code>Promise</code>
|
|
Connect to the Hub.
|
|
|
|
**Kind**: instance method of [<code>PUPRemote</code>](#PUPRemote)
|
|
**Overrides**: [<code>connect</code>](#Hub+connect)
|
|
**Returns**: <code>Promise</code> - Resolved upon successful connect.
|
|
<a name="Hub+disconnect"></a>
|
|
|
|
### pupRemote.disconnect() ⇒ <code>Promise</code>
|
|
Disconnect the Hub.
|
|
|
|
**Kind**: instance method of [<code>PUPRemote</code>](#PUPRemote)
|
|
**Returns**: <code>Promise</code> - Resolved upon successful disconnect.
|
|
<a name="Hub+subscribe"></a>
|
|
|
|
### pupRemote.subscribe(port, [mode]) ⇒ <code>Promise</code>
|
|
Subscribe to sensor notifications on a given port.
|
|
|
|
**Kind**: instance method of [<code>PUPRemote</code>](#PUPRemote)
|
|
**Returns**: <code>Promise</code> - Resolved upon successful issuance of command.
|
|
|
|
| Param | Type | Description |
|
|
| --- | --- | --- |
|
|
| port | <code>string</code> | |
|
|
| [mode] | <code>number</code> | The sensor mode to activate. If no mode is provided, the default for that sensor will be chosen. |
|
|
|
|
<a name="Hub+unsubscribe"></a>
|
|
|
|
### pupRemote.unsubscribe(port) ⇒ <code>Promise</code>
|
|
Unsubscribe to sensor notifications on a given port.
|
|
|
|
**Kind**: instance method of [<code>PUPRemote</code>](#PUPRemote)
|
|
**Returns**: <code>Promise</code> - Resolved upon successful issuance of command.
|
|
|
|
| Param | Type |
|
|
| --- | --- |
|
|
| port | <code>string</code> |
|
|
|
|
<a name="Hub+sleep"></a>
|
|
|
|
### pupRemote.sleep(delay) ⇒ <code>Promise</code>
|
|
Sleep a given amount of time.
|
|
|
|
This is a helper method to make it easier to add delays into a chain of commands.
|
|
|
|
**Kind**: instance method of [<code>PUPRemote</code>](#PUPRemote)
|
|
**Returns**: <code>Promise</code> - Resolved after the delay is finished.
|
|
|
|
| Param | Type | Description |
|
|
| --- | --- | --- |
|
|
| delay | <code>number</code> | How long to sleep (in milliseconds). |
|
|
|
|
<a name="Hub+wait"></a>
|
|
|
|
### pupRemote.wait(commands) ⇒ <code>Promise</code>
|
|
Wait until a given list of concurrently running commands are complete.
|
|
|
|
This is a helper method to make it easier to wait for concurrent commands to complete.
|
|
|
|
**Kind**: instance method of [<code>PUPRemote</code>](#PUPRemote)
|
|
**Returns**: <code>Promise</code> - Resolved after the commands are finished.
|
|
|
|
| Param | Type | Description |
|
|
| --- | --- | --- |
|
|
| commands | <code>Array.<Promise.<any>></code> | Array of executing commands. |
|
|
|
|
<a name="LPF2Hub+event_button"></a>
|
|
|
|
### "button" (button, state)
|
|
Emits when a button is pressed.
|
|
|
|
**Kind**: event emitted by [<code>PUPRemote</code>](#PUPRemote)
|
|
|
|
| Param | Type | Description |
|
|
| --- | --- | --- |
|
|
| button | <code>string</code> | |
|
|
| state | <code>number</code> | A number representing one of the button state consts. |
|
|
|
|
<a name="DuploTrainBase"></a>
|
|
|
|
## DuploTrainBase ⇐ <code>LPF2Hub</code>
|
|
**Kind**: global class
|
|
**Extends**: <code>LPF2Hub</code>, <code>Hub</code>
|
|
|
|
* [DuploTrainBase](#DuploTrainBase) ⇐ <code>LPF2Hub</code>
|
|
* [new DuploTrainBase()](#new_DuploTrainBase_new)
|
|
* [.current](#LPF2Hub+current)
|
|
* [.name](#Hub+name)
|
|
* [.uuid](#Hub+uuid)
|
|
* [.rssi](#Hub+rssi)
|
|
* [.batteryLevel](#Hub+batteryLevel)
|
|
* [.setLEDColor(color)](#DuploTrainBase+setLEDColor) ⇒ <code>Promise</code>
|
|
* [.setMotorSpeed(port, speed, [time])](#DuploTrainBase+setMotorSpeed) ⇒ <code>Promise</code>
|
|
* [.playSound(sound)](#DuploTrainBase+playSound) ⇒ <code>Promise</code>
|
|
* [.rampMotorSpeed(port, fromSpeed, toSpeed, time)](#DuploTrainBase+rampMotorSpeed) ⇒ <code>Promise</code>
|
|
* [.setName(name)](#LPF2Hub+setName) ⇒ <code>Promise</code>
|
|
* [.setLEDRGB(red, green, blue)](#LPF2Hub+setLEDRGB) ⇒ <code>Promise</code>
|
|
* [.connect()](#Hub+connect) ⇒ <code>Promise</code>
|
|
* [.disconnect()](#Hub+disconnect) ⇒ <code>Promise</code>
|
|
* [.subscribe(port, [mode])](#Hub+subscribe) ⇒ <code>Promise</code>
|
|
* [.unsubscribe(port)](#Hub+unsubscribe) ⇒ <code>Promise</code>
|
|
* [.sleep(delay)](#Hub+sleep) ⇒ <code>Promise</code>
|
|
* [.wait(commands)](#Hub+wait) ⇒ <code>Promise</code>
|
|
* ["color" (port, color)](#LPF2Hub+event_color)
|
|
* ["speed" (port, speed)](#LPF2Hub+event_speed)
|
|
|
|
<a name="new_DuploTrainBase_new"></a>
|
|
|
|
### new DuploTrainBase()
|
|
The DuploTrainBase is emitted if the discovered device is a Duplo Train Base.
|
|
|
|
<a name="LPF2Hub+current"></a>
|
|
|
|
### duploTrainBase.current
|
|
**Kind**: instance property of [<code>DuploTrainBase</code>](#DuploTrainBase)
|
|
**Read only**: true
|
|
**Properties**
|
|
|
|
| Name | Type | Description |
|
|
| --- | --- | --- |
|
|
| current | <code>number</code> | Current usage of the hub (Amps) |
|
|
|
|
<a name="Hub+name"></a>
|
|
|
|
### duploTrainBase.name
|
|
**Kind**: instance property of [<code>DuploTrainBase</code>](#DuploTrainBase)
|
|
**Overrides**: [<code>name</code>](#Hub+name)
|
|
**Read only**: true
|
|
**Properties**
|
|
|
|
| Name | Type | Description |
|
|
| --- | --- | --- |
|
|
| name | <code>string</code> | Name of the hub |
|
|
|
|
<a name="Hub+uuid"></a>
|
|
|
|
### duploTrainBase.uuid
|
|
**Kind**: instance property of [<code>DuploTrainBase</code>](#DuploTrainBase)
|
|
**Overrides**: [<code>uuid</code>](#Hub+uuid)
|
|
**Read only**: true
|
|
**Properties**
|
|
|
|
| Name | Type | Description |
|
|
| --- | --- | --- |
|
|
| uuid | <code>string</code> | UUID of the hub |
|
|
|
|
<a name="Hub+rssi"></a>
|
|
|
|
### duploTrainBase.rssi
|
|
**Kind**: instance property of [<code>DuploTrainBase</code>](#DuploTrainBase)
|
|
**Overrides**: [<code>rssi</code>](#Hub+rssi)
|
|
**Read only**: true
|
|
**Properties**
|
|
|
|
| Name | Type | Description |
|
|
| --- | --- | --- |
|
|
| rssi | <code>number</code> | Signal strength of the hub |
|
|
|
|
<a name="Hub+batteryLevel"></a>
|
|
|
|
### duploTrainBase.batteryLevel
|
|
**Kind**: instance property of [<code>DuploTrainBase</code>](#DuploTrainBase)
|
|
**Overrides**: [<code>batteryLevel</code>](#Hub+batteryLevel)
|
|
**Read only**: true
|
|
**Properties**
|
|
|
|
| Name | Type | Description |
|
|
| --- | --- | --- |
|
|
| batteryLevel | <code>number</code> | Battery level of the hub (Percentage between 0-100) |
|
|
|
|
<a name="DuploTrainBase+setLEDColor"></a>
|
|
|
|
### duploTrainBase.setLEDColor(color) ⇒ <code>Promise</code>
|
|
Set the color of the LED on the train via a color value.
|
|
|
|
**Kind**: instance method of [<code>DuploTrainBase</code>](#DuploTrainBase)
|
|
**Overrides**: [<code>setLEDColor</code>](#LPF2Hub+setLEDColor)
|
|
**Returns**: <code>Promise</code> - Resolved upon successful issuance of command.
|
|
|
|
| Param | Type | Description |
|
|
| --- | --- | --- |
|
|
| color | <code>number</code> | A number representing one of the LED color consts. |
|
|
|
|
<a name="DuploTrainBase+setMotorSpeed"></a>
|
|
|
|
### duploTrainBase.setMotorSpeed(port, speed, [time]) ⇒ <code>Promise</code>
|
|
Set the motor speed on a given port.
|
|
|
|
**Kind**: instance method of [<code>DuploTrainBase</code>](#DuploTrainBase)
|
|
**Returns**: <code>Promise</code> - Resolved upon successful completion of command. If time is specified, this is once the motor is finished.
|
|
|
|
| Param | Type | Description |
|
|
| --- | --- | --- |
|
|
| port | <code>string</code> | |
|
|
| speed | <code>number</code> \| <code>Array.<number></code> | 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. |
|
|
| [time] | <code>number</code> | How long to activate the motor for (in milliseconds). Leave empty to turn the motor on indefinitely. |
|
|
|
|
<a name="DuploTrainBase+playSound"></a>
|
|
|
|
### duploTrainBase.playSound(sound) ⇒ <code>Promise</code>
|
|
Play a built-in train sound.
|
|
|
|
**Kind**: instance method of [<code>DuploTrainBase</code>](#DuploTrainBase)
|
|
**Returns**: <code>Promise</code> - Resolved upon successful issuance of command.
|
|
|
|
| Param | Type | Description |
|
|
| --- | --- | --- |
|
|
| sound | <code>number</code> | A number representing one of the Train Base sound consts. |
|
|
|
|
<a name="DuploTrainBase+rampMotorSpeed"></a>
|
|
|
|
### duploTrainBase.rampMotorSpeed(port, fromSpeed, toSpeed, time) ⇒ <code>Promise</code>
|
|
Ramp the motor speed on a given port.
|
|
|
|
**Kind**: instance method of [<code>DuploTrainBase</code>](#DuploTrainBase)
|
|
**Returns**: <code>Promise</code> - Resolved upon successful completion of command.
|
|
|
|
| Param | Type | Description |
|
|
| --- | --- | --- |
|
|
| port | <code>string</code> | |
|
|
| fromSpeed | <code>number</code> | For forward, a value between 1 - 100 should be set. For reverse, a value between -1 to -100. Stop is 0. |
|
|
| toSpeed | <code>number</code> | For forward, a value between 1 - 100 should be set. For reverse, a value between -1 to -100. Stop is 0. |
|
|
| time | <code>number</code> | How long the ramp should last (in milliseconds). |
|
|
|
|
<a name="LPF2Hub+setName"></a>
|
|
|
|
### duploTrainBase.setName(name) ⇒ <code>Promise</code>
|
|
Set the name of the Hub.
|
|
|
|
**Kind**: instance method of [<code>DuploTrainBase</code>](#DuploTrainBase)
|
|
**Returns**: <code>Promise</code> - Resolved upon successful issuance of command.
|
|
|
|
| Param | Type | Description |
|
|
| --- | --- | --- |
|
|
| name | <code>string</code> | New name of the hub (14 characters or less, ASCII only). |
|
|
|
|
<a name="LPF2Hub+setLEDRGB"></a>
|
|
|
|
### duploTrainBase.setLEDRGB(red, green, blue) ⇒ <code>Promise</code>
|
|
Set the color of the LED on the Hub via RGB values.
|
|
|
|
**Kind**: instance method of [<code>DuploTrainBase</code>](#DuploTrainBase)
|
|
**Returns**: <code>Promise</code> - Resolved upon successful issuance of command.
|
|
|
|
| Param | Type |
|
|
| --- | --- |
|
|
| red | <code>number</code> |
|
|
| green | <code>number</code> |
|
|
| blue | <code>number</code> |
|
|
|
|
<a name="Hub+connect"></a>
|
|
|
|
### duploTrainBase.connect() ⇒ <code>Promise</code>
|
|
Connect to the Hub.
|
|
|
|
**Kind**: instance method of [<code>DuploTrainBase</code>](#DuploTrainBase)
|
|
**Overrides**: [<code>connect</code>](#Hub+connect)
|
|
**Returns**: <code>Promise</code> - Resolved upon successful connect.
|
|
<a name="Hub+disconnect"></a>
|
|
|
|
### duploTrainBase.disconnect() ⇒ <code>Promise</code>
|
|
Disconnect the Hub.
|
|
|
|
**Kind**: instance method of [<code>DuploTrainBase</code>](#DuploTrainBase)
|
|
**Overrides**: [<code>disconnect</code>](#Hub+disconnect)
|
|
**Returns**: <code>Promise</code> - Resolved upon successful disconnect.
|
|
<a name="Hub+subscribe"></a>
|
|
|
|
### duploTrainBase.subscribe(port, [mode]) ⇒ <code>Promise</code>
|
|
Subscribe to sensor notifications on a given port.
|
|
|
|
**Kind**: instance method of [<code>DuploTrainBase</code>](#DuploTrainBase)
|
|
**Overrides**: [<code>subscribe</code>](#Hub+subscribe)
|
|
**Returns**: <code>Promise</code> - Resolved upon successful issuance of command.
|
|
|
|
| Param | Type | Description |
|
|
| --- | --- | --- |
|
|
| port | <code>string</code> | |
|
|
| [mode] | <code>number</code> | The sensor mode to activate. If no mode is provided, the default for that sensor will be chosen. |
|
|
|
|
<a name="Hub+unsubscribe"></a>
|
|
|
|
### duploTrainBase.unsubscribe(port) ⇒ <code>Promise</code>
|
|
Unsubscribe to sensor notifications on a given port.
|
|
|
|
**Kind**: instance method of [<code>DuploTrainBase</code>](#DuploTrainBase)
|
|
**Overrides**: [<code>unsubscribe</code>](#Hub+unsubscribe)
|
|
**Returns**: <code>Promise</code> - Resolved upon successful issuance of command.
|
|
|
|
| Param | Type |
|
|
| --- | --- |
|
|
| port | <code>string</code> |
|
|
|
|
<a name="Hub+sleep"></a>
|
|
|
|
### duploTrainBase.sleep(delay) ⇒ <code>Promise</code>
|
|
Sleep a given amount of time.
|
|
|
|
This is a helper method to make it easier to add delays into a chain of commands.
|
|
|
|
**Kind**: instance method of [<code>DuploTrainBase</code>](#DuploTrainBase)
|
|
**Overrides**: [<code>sleep</code>](#Hub+sleep)
|
|
**Returns**: <code>Promise</code> - Resolved after the delay is finished.
|
|
|
|
| Param | Type | Description |
|
|
| --- | --- | --- |
|
|
| delay | <code>number</code> | How long to sleep (in milliseconds). |
|
|
|
|
<a name="Hub+wait"></a>
|
|
|
|
### duploTrainBase.wait(commands) ⇒ <code>Promise</code>
|
|
Wait until a given list of concurrently running commands are complete.
|
|
|
|
This is a helper method to make it easier to wait for concurrent commands to complete.
|
|
|
|
**Kind**: instance method of [<code>DuploTrainBase</code>](#DuploTrainBase)
|
|
**Overrides**: [<code>wait</code>](#Hub+wait)
|
|
**Returns**: <code>Promise</code> - Resolved after the commands are finished.
|
|
|
|
| Param | Type | Description |
|
|
| --- | --- | --- |
|
|
| commands | <code>Array.<Promise.<any>></code> | Array of executing commands. |
|
|
|
|
<a name="LPF2Hub+event_color"></a>
|
|
|
|
### "color" (port, color)
|
|
Emits when a color sensor is activated.
|
|
|
|
**Kind**: event emitted by [<code>DuploTrainBase</code>](#DuploTrainBase)
|
|
|
|
| Param | Type | Description |
|
|
| --- | --- | --- |
|
|
| port | <code>string</code> | |
|
|
| color | <code>number</code> | A number representing one of the LED color consts. |
|
|
|
|
<a name="LPF2Hub+event_speed"></a>
|
|
|
|
### "speed" (port, speed)
|
|
Emits on a speed change.
|
|
|
|
**Kind**: event emitted by [<code>DuploTrainBase</code>](#DuploTrainBase)
|
|
|
|
| Param | Type |
|
|
| --- | --- |
|
|
| port | <code>string</code> |
|
|
| speed | <code>number</code> |
|
|
|