node-poweredup/DOCS.md
2018-08-07 10:59:43 +01:00

39 KiB

Classes

PoweredUPEventEmitter
WeDo2SmartHubHub
BoostMoveHubLPF2Hub
PUPHubLPF2Hub
PUPRemoteLPF2Hub

PoweredUP ⇐ EventEmitter

Kind: global class
Extends: EventEmitter

poweredUP.scan()

Begin scanning for Powered UP Hub devices.

Kind: instance method of PoweredUP

poweredUP.stop()

Stop scanning for Powered UP Hub devices.

Kind: instance method of PoweredUP

poweredUP.getConnectedHubByUUID(uuid) ⇒ Hub | null

Retrieve a Powered UP Hub by UUID.

Kind: instance method of PoweredUP

Param Type
uuid string

poweredUP.getConnectedHubs() ⇒ Array.<Hub>

Retrieve a list of Powered UP Hubs.

Kind: instance method of PoweredUP

"discover" (hub)

Emits when a Powered UP Hub device is found.

Kind: event emitted by PoweredUP

Param Type
hub WeDo2SmartHub | BoostMoveHub | PUPHub | PUPRemote

WeDo2SmartHub ⇐ Hub

Kind: global class
Extends: Hub

new WeDo2SmartHub()

The WeDo2SmartHub is emitted if the discovered device is a WeDo 2.0 Smart Hub.

weDo2SmartHub.name

Kind: instance property of WeDo2SmartHub
Read only: true
Properties

Name Type Description
name string Name of the hub

weDo2SmartHub.uuid

Kind: instance property of WeDo2SmartHub
Read only: true
Properties

Name Type Description
uuid string UUID of the hub

weDo2SmartHub.rssi

Kind: instance property of WeDo2SmartHub
Read only: true
Properties

Name Type Description
rssi number Signal strength of the hub

weDo2SmartHub.batteryLevel

Kind: instance property of WeDo2SmartHub
Read only: true
Properties

Name Type Description
batteryLevel number Battery level of the hub (Percentage between 0-100)

weDo2SmartHub.setName(name) ⇒ Promise

Set the name of the Hub.

Kind: instance method of WeDo2SmartHub
Returns: Promise - Resolved upon successful issuance of command.

Param Type Description
name string New name of the hub (14 characters or less, ASCII only).

weDo2SmartHub.setLEDColor(color) ⇒ Promise

Set the color of the LED on the Hub via a color value.

Kind: instance method of WeDo2SmartHub
Returns: Promise - Resolved upon successful issuance of command.

Param Type Description
color number A number representing one of the LED color consts.

weDo2SmartHub.setLEDRGB(red, green, blue) ⇒ Promise

Set the color of the LED on the Hub via RGB values.

Kind: instance method of WeDo2SmartHub
Returns: Promise - Resolved upon successful issuance of command.

Param Type
red number
green number
blue number

weDo2SmartHub.setMotorSpeed(port, speed, [time]) ⇒ Promise

Set the motor speed on a given port.

Kind: instance method of WeDo2SmartHub
Returns: Promise - Resolved upon successful completion of command. If time is specified, this is once the motor is finished.

Param Type Description
port string
speed number For forward, a value between 1 - 100 should be set. For reverse, a value between -1 to -100. Stop is 0.
[time] number How long to activate the motor for (in milliseconds). Leave empty to turn the motor on indefinitely.

weDo2SmartHub.rampMotorSpeed(port, fromSpeed, toSpeed, time) ⇒ Promise

Ramp the motor speed on a given port.

Kind: instance method of WeDo2SmartHub
Returns: Promise - Resolved upon successful completion of command.

Param Type Description
port string
fromSpeed number For forward, a value between 1 - 100 should be set. For reverse, a value between -1 to -100. Stop is 0.
toSpeed number For forward, a value between 1 - 100 should be set. For reverse, a value between -1 to -100. Stop is 0.
time number How long the ramp should last (in milliseconds).

weDo2SmartHub.playSound(frequency, time) ⇒ Promise

Play a sound on the Hub's in-built buzzer

Kind: instance method of WeDo2SmartHub
Returns: Promise - Resolved upon successful completion of command (ie. once the sound has finished playing).

Param Type Description
frequency number
time number How long the sound should play for (in milliseconds).

weDo2SmartHub.connect() ⇒ Promise

Connect to the Hub.

Kind: instance method of WeDo2SmartHub
Overrides: connect
Returns: Promise - Resolved upon successful connect.

weDo2SmartHub.disconnect() ⇒ Promise

Disconnect the Hub.

Kind: instance method of WeDo2SmartHub
Returns: Promise - Resolved upon successful disconnect.

weDo2SmartHub.subscribe(port, [mode]) ⇒ Promise

Subscribe to sensor notifications on a given port.

Kind: instance method of WeDo2SmartHub
Returns: Promise - Resolved upon successful issuance of command.

Param Type Description
port string
[mode] number The sensor mode to activate. If no mode is provided, the default for that sensor will be chosen.

weDo2SmartHub.unsubscribe(port) ⇒ Promise

Unsubscribe to sensor notifications on a given port.

Kind: instance method of WeDo2SmartHub
Returns: Promise - Resolved upon successful issuance of command.

Param Type
port string

weDo2SmartHub.sleep(delay) ⇒ Promise

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 WeDo2SmartHub
Returns: Promise - Resolved after the delay is finished.

Param Type Description
delay number How long to sleep (in milliseconds).

weDo2SmartHub.wait(commands) ⇒ Promise

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 WeDo2SmartHub
Returns: Promise - Resolved after the commands are finished.

Param Type Description
commands Array.<Promise.<any>> Array of executing commands.

"button" (button, state)

Emits when a button is pressed.

Kind: event emitted by WeDo2SmartHub

Param Type Description
button string
state number A number representing one of the button state consts.

"distance" (port, distance)

Emits when a distance sensor is activated.

Kind: event emitted by WeDo2SmartHub

Param Type Description
port string
distance number Distance, in millimeters.

"color" (port, color)

Emits when a color sensor is activated.

Kind: event emitted by WeDo2SmartHub

Param Type Description
port string
color number A number representing one of the LED color consts.

"tilt" (port, x, y)

Emits when a tilt sensor is activated.

Kind: event emitted by WeDo2SmartHub

Param Type
port string
x number
y number

"rotate" (port, rotation)

Emits when a rotation sensor is activated.

Kind: event emitted by WeDo2SmartHub

Param Type
port string
rotation number

"attach" (port, type)

Emits when a motor or sensor is attached to the Hub.

Kind: event emitted by WeDo2SmartHub

Param Type Description
port string
type number A number representing one of the peripheral consts.

"detach" (port)

Emits when an attached motor or sensor is detached from the Hub.

Kind: event emitted by WeDo2SmartHub

Param Type
port string

BoostMoveHub ⇐ LPF2Hub

Kind: global class
Extends: LPF2Hub, Hub

new BoostMoveHub()

The BoostMoveHub is emitted if the discovered device is a Boost Move Hub.

boostMoveHub.current

Kind: instance property of BoostMoveHub
Read only: true
Properties

Name Type Description
current number Current usage of the hub (Amps)

boostMoveHub.name

Kind: instance property of BoostMoveHub
Read only: true
Properties

Name Type Description
name string Name of the hub

boostMoveHub.uuid

Kind: instance property of BoostMoveHub
Read only: true
Properties

Name Type Description
uuid string UUID of the hub

boostMoveHub.rssi

Kind: instance property of BoostMoveHub
Read only: true
Properties

Name Type Description
rssi number Signal strength of the hub

boostMoveHub.batteryLevel

Kind: instance property of BoostMoveHub
Read only: true
Properties

Name Type Description
batteryLevel number Battery level of the hub (Percentage between 0-100)

boostMoveHub.setLEDColor(color) ⇒ Promise

Set the color of the LED on the Hub via a color value.

Kind: instance method of BoostMoveHub
Returns: Promise - Resolved upon successful issuance of command.

Param Type Description
color number A number representing one of the LED color consts.

boostMoveHub.setMotorSpeed(port, speed, [time]) ⇒ Promise

Set the motor speed on a given port.

Kind: instance method of BoostMoveHub
Returns: Promise - Resolved upon successful completion of command. If time is specified, this is once the motor is finished.

Param Type Description
port string
speed number | Array.<number> 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] number How long to activate the motor for (in milliseconds). Leave empty to turn the motor on indefinitely.

boostMoveHub.rampMotorSpeed(port, fromSpeed, toSpeed, time) ⇒ Promise

Ramp the motor speed on a given port.

Kind: instance method of BoostMoveHub
Returns: Promise - Resolved upon successful completion of command.

Param Type Description
port string
fromSpeed number For forward, a value between 1 - 100 should be set. For reverse, a value between -1 to -100. Stop is 0.
toSpeed number For forward, a value between 1 - 100 should be set. For reverse, a value between -1 to -100. Stop is 0.
time number How long the ramp should last (in milliseconds).

boostMoveHub.setMotorAngle(port, angle, [speed]) ⇒ Promise

Rotate a motor by a given angle.

Kind: instance method of BoostMoveHub
Returns: Promise - Resolved upon successful completion of command (ie. once the motor is finished).

Param Type Default Description
port string
angle number How much the motor should be rotated (in degrees).
[speed] number | Array.<number> 100 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.

boostMoveHub.setName(name) ⇒ Promise

Set the name of the Hub.

Kind: instance method of BoostMoveHub
Returns: Promise - Resolved upon successful issuance of command.

Param Type Description
name string New name of the hub (14 characters or less, ASCII only).

boostMoveHub.connect() ⇒ Promise

Connect to the Hub.

Kind: instance method of BoostMoveHub
Overrides: connect
Returns: Promise - Resolved upon successful connect.

boostMoveHub.disconnect() ⇒ Promise

Disconnect the Hub.

Kind: instance method of BoostMoveHub
Returns: Promise - Resolved upon successful disconnect.

boostMoveHub.subscribe(port, [mode]) ⇒ Promise

Subscribe to sensor notifications on a given port.

Kind: instance method of BoostMoveHub
Returns: Promise - Resolved upon successful issuance of command.

Param Type Description
port string
[mode] number The sensor mode to activate. If no mode is provided, the default for that sensor will be chosen.

boostMoveHub.unsubscribe(port) ⇒ Promise

Unsubscribe to sensor notifications on a given port.

Kind: instance method of BoostMoveHub
Returns: Promise - Resolved upon successful issuance of command.

Param Type
port string

boostMoveHub.sleep(delay) ⇒ Promise

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 BoostMoveHub
Returns: Promise - Resolved after the delay is finished.

Param Type Description
delay number How long to sleep (in milliseconds).

boostMoveHub.wait(commands) ⇒ Promise

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 BoostMoveHub
Returns: Promise - Resolved after the commands are finished.

Param Type Description
commands Array.<Promise.<any>> Array of executing commands.

"button" (button, state)

Emits when a button is pressed.

Kind: event emitted by BoostMoveHub

Param Type Description
button string
state number A number representing one of the button state consts.

"distance" (port, distance)

Emits when a distance sensor is activated.

Kind: event emitted by BoostMoveHub

Param Type Description
port string
distance number Distance, in millimeters.

"color" (port, color)

Emits when a color sensor is activated.

Kind: event emitted by BoostMoveHub

Param Type Description
port string
color number A number representing one of the LED color consts.

"tilt" (port, x, y)

Emits when a tilt sensor is activated.

Kind: event emitted by BoostMoveHub

Param Type Description
port string If the event is fired from the Move Hub's in-built tilt sensor, the special port "TILT" is used.
x number
y number

"rotate" (port, rotation)

Emits when a rotation sensor is activated.

Kind: event emitted by BoostMoveHub

Param Type
port string
rotation number

"attach" (port, type)

Emits when a motor or sensor is attached to the Hub.

Kind: event emitted by BoostMoveHub

Param Type Description
port string
type number A number representing one of the peripheral consts.

"detach" (port)

Emits when an attached motor or sensor is detached from the Hub.

Kind: event emitted by BoostMoveHub

Param Type
port string

PUPHub ⇐ LPF2Hub

Kind: global class
Extends: LPF2Hub, Hub

new PUPHub()

The PUPHub is emitted if the discovered device is a Powered Up Hub.

pupHub.current

Kind: instance property of PUPHub
Read only: true
Properties

Name Type Description
current number Current usage of the hub (Amps)

pupHub.name

Kind: instance property of PUPHub
Read only: true
Properties

Name Type Description
name string Name of the hub

pupHub.uuid

Kind: instance property of PUPHub
Read only: true
Properties

Name Type Description
uuid string UUID of the hub

pupHub.rssi

Kind: instance property of PUPHub
Read only: true
Properties

Name Type Description
rssi number Signal strength of the hub

pupHub.batteryLevel

Kind: instance property of PUPHub
Read only: true
Properties

Name Type Description
batteryLevel number Battery level of the hub (Percentage between 0-100)

pupHub.setLEDColor(color) ⇒ Promise

Set the color of the LED on the Hub via a color value.

Kind: instance method of PUPHub
Returns: Promise - Resolved upon successful issuance of command.

Param Type Description
color number A number representing one of the LED color consts.

pupHub.setMotorSpeed(port, speed, [time]) ⇒ Promise

Set the motor speed on a given port.

Kind: instance method of PUPHub
Returns: Promise - Resolved upon successful completion of command. If time is specified, this is once the motor is finished.

Param Type Description
port string
speed number | Array.<number> 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] number How long to activate the motor for (in milliseconds). Leave empty to turn the motor on indefinitely.

pupHub.rampMotorSpeed(port, fromSpeed, toSpeed, time) ⇒ Promise

Ramp the motor speed on a given port.

Kind: instance method of PUPHub
Returns: Promise - Resolved upon successful completion of command.

Param Type Description
port string
fromSpeed number For forward, a value between 1 - 100 should be set. For reverse, a value between -1 to -100. Stop is 0.
toSpeed number For forward, a value between 1 - 100 should be set. For reverse, a value between -1 to -100. Stop is 0.
time number How long the ramp should last (in milliseconds).

pupHub.setName(name) ⇒ Promise

Set the name of the Hub.

Kind: instance method of PUPHub
Returns: Promise - Resolved upon successful issuance of command.

Param Type Description
name string New name of the hub (14 characters or less, ASCII only).

pupHub.connect() ⇒ Promise

Connect to the Hub.

Kind: instance method of PUPHub
Overrides: connect
Returns: Promise - Resolved upon successful connect.

pupHub.disconnect() ⇒ Promise

Disconnect the Hub.

Kind: instance method of PUPHub
Returns: Promise - Resolved upon successful disconnect.

pupHub.subscribe(port, [mode]) ⇒ Promise

Subscribe to sensor notifications on a given port.

Kind: instance method of PUPHub
Returns: Promise - Resolved upon successful issuance of command.

Param Type Description
port string
[mode] number The sensor mode to activate. If no mode is provided, the default for that sensor will be chosen.

pupHub.unsubscribe(port) ⇒ Promise

Unsubscribe to sensor notifications on a given port.

Kind: instance method of PUPHub
Returns: Promise - Resolved upon successful issuance of command.

Param Type
port string

pupHub.sleep(delay) ⇒ Promise

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 PUPHub
Returns: Promise - Resolved after the delay is finished.

Param Type Description
delay number How long to sleep (in milliseconds).

pupHub.wait(commands) ⇒ Promise

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 PUPHub
Returns: Promise - Resolved after the commands are finished.

Param Type Description
commands Array.<Promise.<any>> Array of executing commands.

"button" (button, state)

Emits when a button is pressed.

Kind: event emitted by PUPHub

Param Type Description
button string
state number A number representing one of the button state consts.

"distance" (port, distance)

Emits when a distance sensor is activated.

Kind: event emitted by PUPHub

Param Type Description
port string
distance number Distance, in millimeters.

"color" (port, color)

Emits when a color sensor is activated.

Kind: event emitted by PUPHub

Param Type Description
port string
color number A number representing one of the LED color consts.

"tilt" (port, x, y)

Emits when a tilt sensor is activated.

Kind: event emitted by PUPHub

Param Type Description
port string If the event is fired from the Move Hub's in-built tilt sensor, the special port "TILT" is used.
x number
y number

"attach" (port, type)

Emits when a motor or sensor is attached to the Hub.

Kind: event emitted by PUPHub

Param Type Description
port string
type number A number representing one of the peripheral consts.

"detach" (port)

Emits when an attached motor or sensor is detached from the Hub.

Kind: event emitted by PUPHub

Param Type
port string

PUPRemote ⇐ LPF2Hub

Kind: global class
Extends: LPF2Hub, Hub

new PUPRemote()

The PUPRemote is emitted if the discovered device is a Powered Up Remote.

pupRemote.current

Kind: instance property of PUPRemote
Read only: true
Properties

Name Type Description
current number Current usage of the hub (Amps)

pupRemote.name

Kind: instance property of PUPRemote
Read only: true
Properties

Name Type Description
name string Name of the hub

pupRemote.uuid

Kind: instance property of PUPRemote
Read only: true
Properties

Name Type Description
uuid string UUID of the hub

pupRemote.rssi

Kind: instance property of PUPRemote
Read only: true
Properties

Name Type Description
rssi number Signal strength of the hub

pupRemote.batteryLevel

Kind: instance property of PUPRemote
Read only: true
Properties

Name Type Description
batteryLevel number Battery level of the hub (Percentage between 0-100)

pupRemote.setLEDColor(color) ⇒ Promise

Set the color of the LED on the Remote via a color value.

Kind: instance method of PUPRemote
Returns: Promise - Resolved upon successful issuance of command.

Param Type Description
color number A number representing one of the LED color consts.

pupRemote.setName(name) ⇒ Promise

Set the name of the Hub.

Kind: instance method of PUPRemote
Returns: Promise - Resolved upon successful issuance of command.

Param Type Description
name string New name of the hub (14 characters or less, ASCII only).

pupRemote.connect() ⇒ Promise

Connect to the Hub.

Kind: instance method of PUPRemote
Overrides: connect
Returns: Promise - Resolved upon successful connect.

pupRemote.disconnect() ⇒ Promise

Disconnect the Hub.

Kind: instance method of PUPRemote
Returns: Promise - Resolved upon successful disconnect.

pupRemote.subscribe(port, [mode]) ⇒ Promise

Subscribe to sensor notifications on a given port.

Kind: instance method of PUPRemote
Returns: Promise - Resolved upon successful issuance of command.

Param Type Description
port string
[mode] number The sensor mode to activate. If no mode is provided, the default for that sensor will be chosen.

pupRemote.unsubscribe(port) ⇒ Promise

Unsubscribe to sensor notifications on a given port.

Kind: instance method of PUPRemote
Returns: Promise - Resolved upon successful issuance of command.

Param Type
port string

pupRemote.sleep(delay) ⇒ Promise

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 PUPRemote
Returns: Promise - Resolved after the delay is finished.

Param Type Description
delay number How long to sleep (in milliseconds).

pupRemote.wait(commands) ⇒ Promise

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 PUPRemote
Returns: Promise - Resolved after the commands are finished.

Param Type Description
commands Array.<Promise.<any>> Array of executing commands.

"button" (button, state)

Emits when a button is pressed.

Kind: event emitted by PUPRemote

Param Type Description
button string
state number A number representing one of the button state consts.