node-poweredup

Class: BoostMoveHub

BoostMoveHub

new BoostMoveHub()

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

Source:

Extends

Methods

connect()

Connect to the Hub.

Inherited From:
Overrides:
Source:
Returns:

Resolved upon successful connect.

Type
Promise

createVirtualPort(firstPortName, secondPortName)

Combines two ports with into a single virtual port.

Note: The devices attached to the ports must be of the same device type.

Parameters:
Name Type Description
firstPortName string

First port name
secondPortName string

Second port name
Inherited From:
Source:
Returns:

Resolved upon successful issuance of command.

Type
Promise

disconnect()

Disconnect the Hub.

Inherited From:
Source:
Returns:

Resolved upon successful disconnect.

Type
Promise

getDeviceAtPort(portName)

Retrieves the device attached to a given port.

Parameters:
Name Type Description
portName string

The name of the port to retrieve the device from.
Inherited From:
Source:
Returns:

The device attached to the port.

Type
Device | undefined

getDevices()

Retrieves all attached devices.

Inherited From:
Source:
Returns:

Array of all attached devices.

Type
Array.<Device>

getDevicesByType(deviceType)

Retrieves an array of devices of the specified type.

Parameters:
Name Type Description
deviceType number

The device type to lookup.
Inherited From:
Source:
Returns:

Array of all devices of the specified type.

Type
Array.<Device>

setName(name)

Set the name of the Hub.

Parameters:
Name Type Description
name string

New name of the hub (14 characters or less, ASCII only).
Inherited From:
Source:
Returns:

Resolved upon successful issuance of command.

Type
Promise

shutdown()

Shutdown the Hub.

Inherited From:
Source:
Returns:

Resolved upon successful disconnect.

Type
Promise

sleep(delay)

Sleep a given amount of time.

Note: This is a helper method to make it easier to add delays into a chain of commands.

Parameters:
Name Type Description
delay number

How long to sleep (in milliseconds).
Inherited From:
Source:
Returns:

Resolved after the delay is finished.

Type
Promise

wait(commands)

Wait until a given list of concurrently running commands are complete.

Note: This is a helper method to make it easier to wait for concurrent commands to complete.

Parameters:
Name Type Description
commands Array.<Promise.<any>>

Array of executing commands.
Inherited From:
Source:
Returns:

Resolved after the commands are finished.

Type
Promise

waitForDeviceAtPort(portName)

Retrieves the device attached to a given port, waiting until one is attached if there isn't one.

Note: If a device is never attached, the returned promise may never resolve.

Parameters:
Name Type Description
portName string

The name of the port to retrieve the device from.
Inherited From:
Source:
Returns:

Resolved once a device is attached, or resolved immediately if a device is already attached.

Type
Promise

waitForDeviceByType(deviceType)

Retrieves the first device attached of the specified type, waiting until one is attached if there isn't one.

Note: If a device is never attached, the returned promise may never resolve.

Parameters:
Name Type Description
deviceType number

The device type to lookup.
Inherited From:
Source:
Returns:

Resolved once a device is attached, or resolved immediately if a device is already attached.

Type
Promise

Events

attach

Emits when a device is attached to the Hub.

Parameters:
Name Type Description
device Device
Inherited From:
Source:

button

Emits when a button is pressed.

Parameters:
Name Type Description
button string
state ButtonState
Inherited From:
Source:

detach

Emits when a device is detached from the Hub.

Parameters:
Name Type Description
device Device
Inherited From:
Source:

disconnect

Emits when the hub is disconnected.

Inherited From:
Source: