🚀 Rocket Nuimo, a Node.js client package for Senic's Numio Control BLE device.

To install rocket-nuimo for use within your project use yarn or npm

$ yarn add `rocket-nuimo`

rocket-numio uses noble under the hood for communicating with to BLE devices. nobel running on Mojavé has issues currently and must be worked around.

Whether you are uses rocket-numio as a depedency, or running one of the example you will need to make overrides or adjustments when running on macOS.

In your project's package.json insert the following:

  "depedendencie": {
   "rocket-nuimo": "^0.4"
  },
  "resolutions": {
    "noble": "https://github.com/Timeular/noble-mac"
  }

Then run from the terminal

$ yarn install

Now when you run your respect yarn install or npm install it will the package suitable to running on macOS.

API documentation coming shortly. Check out examples for now.

Clone rocket-nuimo-node and run the examples to try things out. package.json contains many example scripts. Alternatively, for Visual Sudio Code users you have access to the pre-configured launch configurations to run the examples.

$ git clone https://github.com/pryomoax/rocket-nuimo-node.git
$ cd rocket-nuimo-node
$ yarn install

Run one of the following scripts

# Device discovery
$ yarn device-discovery

# Simple display of custom glyphs
$ yarn display

# Example of simple animation
$ yarn animation

# Selection events
$ yarn select-events

# Touch/Long Touch events
$ yarn touch-events

# Swipe (on device) and through the "fly" touchless gesture
$ yarn swipe-events

# Hover proximity events, through "fly" touchless gestures
$ yarn hover-events

# Dial rotate events
$ yarn rotate-events

There can be troubles connecting to a Nuimo when playing around with the device. To give you some leads in trouble shooting, try the following:

• Click the center screen button to wake up Nuimo Control
• Power cycle Nuimo Control
• Reset bluetooth on your Mac
• Check if there are any current issue with noble related to the OS/Node.js version you are using.