movehub

Node.js interface for the Lego Boost Move Hub 🤖 🐱 🎸 🚚

Install

$ npm install movehub

If you want to utilize the new async/await syntax see https://github.com/ttu/node-movehub-async which is based on this module.

Usage example

See test.js.

API

Classes

Boost

Kind: global class

• Boost
  • .connect(address, callback)
  • "ble-ready" (bleReady)
  • "hub-found" (hub)
  • .connectCallback : function

boost.connect(address, callback)

Kind: instance method of Boost

| Param | Type | Description | | --- | --- | --- | | address | string | MAC Address of the Hub | | callback | connectCallback | |

"ble-ready" (bleReady)

Kind: event emitted by Boost

| Param | Type | Description | | --- | --- | --- | | bleReady | boolean | reports true/false when BLE is active |

"hub-found" (hub)

Fires when a Move Hub is found

Kind: event emitted by Boost

| Param | Type | | --- | --- | | hub | object | | hub.uuid | string | | hub.address | string | | hub.localName | string |

boost.connectCallback : function

Kind: instance typedef of Boost

| Param | Type | Description | | --- | --- | --- | | error | null | error | | | hub | Hub | instance of the Hub Class |

Hub

Kind: global class

• Hub
  • .disconnect()
  • .motorTime(port, seconds, [dutyCycle], [callback])
  • .motorTimeMulti(seconds, dutyCycleA, dutyCycleB, callback)
  • .motorAngle(port, angle, [dutyCycle], [callback])
  • .motorAngleMulti(angle, dutyCycleA, dutyCycleB, callback)
  • .led(color, [callback])
  • .subscribe(port, [option], [callback])
  • .unsubscribe(port, [option], [callback])
  • .write(data, callback)
  • "rssi" (rssi)
  • "disconnect"
  • "connect"
  • "port" (port)
  • "color" (color)
  • "distance" (distance)
  • "tilt" (tilt)
  • "rotation" (rotation)

hub.disconnect()

Disconnect from Move Hub

Kind: instance method of Hub

hub.motorTime(port, seconds, [dutyCycle], [callback])

Run a motor for specific time

Kind: instance method of Hub

| Param | Type | Default | Description | | --- | --- | --- | --- | | port | string | number | | possible string values: A, B, AB, C, D. | | seconds | number | | | | [dutyCycle] | number | 100 | motor power percentage from -100 to 100. If a negative value is given rotation is counterclockwise. | | [callback] | function | | |

hub.motorTimeMulti(seconds, dutyCycleA, dutyCycleB, callback)

Run both motors (A and B) for specific time

Kind: instance method of Hub

| Param | Type | Description | | --- | --- | --- | | seconds | number | | | dutyCycleA | number | motor power percentage from -100 to 100. If a negative value is given rotation is counterclockwise. | | dutyCycleB | number | motor power percentage from -100 to 100. If a negative value is given rotation is counterclockwise. | | callback | function | |

hub.motorAngle(port, angle, [dutyCycle], [callback])

Turn a motor by specific angle

Kind: instance method of Hub

| Param | Type | Default | Description | | --- | --- | --- | --- | | port | string | number | | possible string values: A, B, AB, C, D. | | angle | number | | degrees to turn from 0 to 2147483647 | | [dutyCycle] | number | 100 | motor power percentage from -100 to 100. If a negative value is given rotation is counterclockwise. | | [callback] | function | | |

hub.motorAngleMulti(angle, dutyCycleA, dutyCycleB, callback)

Turn both motors (A and B) by specific angle

Kind: instance method of Hub

| Param | Type | Description | | --- | --- | --- | | angle | number | degrees to turn from 0 to 2147483647 | | dutyCycleA | number | motor power percentage from -100 to 100. If a negative value is given rotation is counterclockwise. | | dutyCycleB | number | motor power percentage from -100 to 100. If a negative value is given rotation is counterclockwise. | | callback | function | |

hub.led(color, [callback])

Control the LED on the Move Hub

Kind: instance method of Hub

| Param | Type | Description | | --- | --- | --- | | color | boolean | number | string | If set to boolean false the LED is switched off, if set to true the LED will be white. Possible string values: off, pink, purple, blue, lightblue, cyan, green, yellow, orange, red, white | | [callback] | function | |

hub.subscribe(port, [option], [callback])

Subscribe for sensor notifications

Kind: instance method of Hub

| Param | Type | Default | Description | | --- | --- | --- | --- | | port | string | number | | e.g. call .subscribe('C') if you have your distance/color sensor on port C. | | [option] | number | 0 | Unknown meaning. Needs to be 0 for distance/color, 2 for motors, 8 for tilt | | [callback] | function | | |

hub.unsubscribe(port, [option], [callback])

Unsubscribe from sensor notifications

Kind: instance method of Hub

| Param | Type | Default | Description | | --- | --- | --- | --- | | port | string | number | | | | [option] | number | 0 | Unknown meaning. Needs to be 0 for distance/color, 2 for motors, 8 for tilt | | [callback] | function | | |

hub.write(data, callback)

Send data over BLE

Kind: instance method of Hub

| Param | Type | Description | | --- | --- | --- | | data | string | Buffer | If a string is given it has to have hex bytes separated by spaces, e.g. 0a 01 c3 b2 | | callback | function | |

"rssi" (rssi)

Kind: event emitted by Hub

| Param | Type | | --- | --- | | rssi | number |

"disconnect"

Kind: event emitted by Hub

"connect"

Fires when a connection to the Move Hub is established

Kind: event emitted by Hub

"port" (port)

Fires on port changes

Kind: event emitted by Hub

| Param | Type | | --- | --- | | port | object | | port.port | string | | port.action | string |

"color" (color)

Kind: event emitted by Hub

| Param | Type | | --- | --- | | color | string |

"distance" (distance)

Kind: event emitted by Hub

| Param | Type | Description | | --- | --- | --- | | distance | number | distance in millimeters |

"tilt" (tilt)

Kind: event emitted by Hub

| Param | Type | | --- | --- | | tilt | object | | tilt.roll | number | | tilt.pitch | number |

"rotation" (rotation)

Kind: event emitted by Hub

| Param | Type | | --- | --- | | rotation | object | | rotation.port | string | | rotation.angle | |

Contributing

Pull Requests welcome! :-)

Credits

Thanks to Jorge Pereira who analyzed and documented the move hub ble protocol: https://github.com/JorgePe/BOOSTreveng

Disclaimer

LEGO and BOOST are Trademarks from The LEGO Company, which does not support (most probably doesn't even know about) this project. And of course I'm not responsible for any damage on your LEGO BOOST devices - use it at your own risk.

License

MIT (c) Sebastian Raff