Jolt.js Development Guide

Discover and develop Jolt.js applications using Espruino, Bluetooth Low Energy and Pareto Anywhere open source IoT middleware.

Jolt.js Development with Web Bluetooth

The TL;DR (Too Long; Didn't Read)

Learn how to program a Jolt.js motor board driver with existing applications, or develop your own.

What's Jolt.js?
Jolt.js is an open hardware device that combines a Bluetooth Low Energy (BLE) microcontroller with motor control drivers in a compact square format.
What will this accomplish?
The Jolt.js will share sensor data and/or identifiers wirelessly using BLE advertising packets.
Is there an easier way?
Programming Espruino devices like the Jolt.js from the browser using Web Bluetooth is already incredibly easy.

Prerequisites

A Jolt.js and, optionally, a Pareto Anywhere instance to make sense of the data

Connecting to the Jolt.js   Step 1 of 3

Browse to the Espruino IDE and connect using Web Bluetooth.

What's Espruino?
Espruino is a JavaScript Interpreter for microcontrollers. It is open source firmware that ships with the Puck.js.
What's Web Bluetooth?
Web Bluetooth enables web browsers to connect and interact with Bluetooth Low Energy devices, like the Puck.js.
Connect to the Jolt.js

Prerequisites

A web browser which supports Web Bluetooth

Many—but not all—modern browsers such as Chrome support Web Bluetooth by default. MDN maintains this list of browser compatibility should your preferred web browser fail to support Web Bluetooth by default.

Browse to the Espruino IDE Part 1

Point a web browser to espruino.com/ide/ and observe the integrated development environment (IDE) as in the screenshot below.

Espruino IDE

Connect with Web Bluetooth Part 2

Click on the Connect/Disconnect icon at top left, and then select Web Bluetooth from the popup.

Connecting to a device in the Espruino IDE

Pair with the Jolt.js Part 3

Identify and select Jolt.js from the list of scanned devices, then click Pair.

If the desired Jolt.js does not appear, check the following:

  • is it powered on?
  • is it within a few metres of the computer?
  • is the Jolt.js connectable in the Settings menu?
Web Bluetooth pairing in Espruino IDE

If pairing is successful, the Connect/Disconnect icon at top left will turn green.

Jolt.js paired in Espruino IDE

The Jolt.js can now be programmed wirelessly from the browser using Web Bluetooth, which is the subject of the next step.

Programming the Jolt.js   Step 2 of 3

Load a JavaScript file and send it to the Jolt.js.

Why JavaScript?
JavaScript runs on almost every modern website (client-side), on many back-ends with Node.js (server-side), and lends itself well even to embedded devices with Espruino.
Any alternatives?
The Espruino IDE provides a Graphical Editor for novices to program with blocks.
Program the Jolt.js

From the Espruino IDE connected to the Jolt.js:

Enter the "Hello World!" program Part 1

Copy Ctrl+C and paste Ctrl+V the following lines of code into the code editor window of the Espruino IDE: 

// Blink green for 100ms
function blinkGreen() {
  LED2.write(true);
  setTimeout(function () { LED2.write(false); }, 100);
}

// Detect button press and blink green
setWatch(blinkGreen, BTN, { edge: "rising", repeat: true, debounce: 50 });

// Transmit Bluetooth Low Energy advertising packets
NRF.setAdvertising({}, {
    showName: false,
    manufacturer: 0x0590,
    manufacturerData: JSON.stringify({ name: "Jolt.js" })
});
Paste the Hello World code into the Espruino IDE

Upload to RAM Part 2

Click on the Send to Espruino button in the centre toolbar, ensuring that the default option to write to RAM is selected.

Send code to the Jolt.js in the Espruino IDE

A progress bar will appear in the bottom right corner followed by SENT in the bottom left corner of the IDE once the program upload completes.

The program will automatically execute and any console output, including error messages, may be observed in the area highlighted in the screenshot below.

Command prompt on the Jolt.js in the Espruino IDE

Observe the "Hello World!" output Part 3

The Jolt.js will blink green on button press.

The Jolt.js will not, however, transmit Bluetooth Low Energy advertising packets while it is connected. Click on the Connect/Disconnect icon at top left to disconnect from the Puck.js.

Disconnect from the Jolt.js in the Espruino IDE

If an instance of Pareto Anywhere is running, the Jolt.js should be discoverable by its Bluetooth Low Energy advertising packets which use the company code 0x0590 registered to Pur3 Ltd, the company which develops the Espruino open source firmware running on the Puck.js as well as the web IDE we used to upload our "Hello World!" program.

Program execution will continue until power is removed or until another program is executed via the Espruino IDE.

Running other programs   Step 3 of 3

Explore the potential of the Jolt.js in context-aware physical spaces.

What are context-aware physical spaces?
These are spaces that make sense of who/what is where/how by collecting and processing ambient wireless data, like that advertised by the Jolt.js.
Why use Jolt.js?
The Jolt.js is the first open source wireless motor driver platform we've identified that offers unconstrained programming freedom, allowing, among other things, the development of novel interactions in context-aware physical spaces.
Espruino Apps

anniversary-clock.js Code

Load the anniversary-clock.js code from our GitHub and create a unique clock using off-the-shelf stepper motors.

Load in Espruino IDE

reelyActive's 12-year anniversary clock

More programs

See our Espruino Apps repository on GitHub for the latest available programs.

Contributor
reelyActive half-barnowl

Tutorial prepared with ♥ by jeffyactive.

You can reelyActive's open source efforts directly by contributing code & docs, collectively by sharing across your network, and commercially through our packages.   We invite you to Gordon's work on Espruino with a donation too!

Where to next?

Continue exploring our open architecture and all its applications.