About Thingy:52
The Nordic Thingy:52™ is a compact, power-optimized, multi-sensor development kit. It is an easy-to-use development platform, designed to help you build IoT prototypes and demos, without the need to build hardware or write firmware. Read more about it here.
This repository
This repository is an attempt to make it easier to start developing applications for Thingy:52 using Web Bluetooth. Web Bluetooth is a JavaScript API that makes it possible to communicate with Bluetooth Low Energy devices in web browsers. The implementation status for different browsers and platforms can be seen here.
This is work in progress, and for now this repository will help you connect to a Thingy:52 and access all services and characteristics except sound and DFU (Device Firmware Upgrade):
Configuration
Environment
User interface
Motion
Battery status
js/thingy.js into your own project.index.html in a supported browser and open the console (ctrl + shift + J or cmd + alt + J). index.html.The following example will first connect to a thingy:52, then read its name and configure the RGB LED to "breathe" purple (color code 5, see here) pulses with 20% intensity and with 1500 ms delays between each pulse. It will also print the name of the device and the firmware version to the console.
import {Thingy} from "./js/thingy.js";
const thingy = new Thingy({logEnabled: true});
async function start(device) {
try {
await device.connect();
await device.ledBreathe({color: 5, intensity: 20, delay: 1500});
console.log(`Thingy name: ${await device.getName()}`);
console.log(`Current firmware: ${await device.getFirmwareVersion()}`);
} catch (error) {
console.error(error);
}
}
start(thingy);Note: the Web Bluetooth API requires that a function trying to connect to a BLE device is initiated by a user action such as a mouse click.
Documentation is also available in HTML format here.
Parameters
options (optional, default {logEnabled:false})Enables battery level notifications.
Parameters
eventHandler function The callback function that is triggered on battery level change. Will receive a battery level object as argument.enable boolean Enables notifications if true or disables them if set to false.Returns Promise<Error> Returns a promise when resolved or a promise with an error on rejection
Enables button notifications from Thingy. The assigned event handler will be called when the button on the Thingy is pushed or released.
Parameters
eventHandler function The callback function that is triggered on notification. Will receive a button object as argument.enable boolean Enables notifications if true or disables them if set to false.Returns Promise<Error> Returns a promise with button state when resolved or a promise with an error on rejection.
Enables color sensor notifications from Thingy. The assigned event handler will be called when notifications are received.
Parameters
eventHandler function The callback function that is triggered on notification. Will receive a color sensor object as argument.enable boolean Enables notifications if true or disables them if set to false.Returns Promise<Error> Returns a promise when resolved or a promise with an error on rejection
Configures color sensor LED calibration parameters.
Parameters
red Number The red intensity, ranging from 0 to 255.green Number The green intensity, ranging from 0 to 255.blue Number The blue intensity, ranging from 0 to 255.Returns Promise<Error> Returns a promise when resolved or a promise with an error on rejection.
Connects to Thingy. The function stores all discovered services and characteristics to the Thingy object.
Returns Promise<Error> Returns an empty promise when resolved or a promise with error on rejection
Method to disconnect from Thingy.
Returns Promise<Error> Returns an empty promise when resolved or a promise with error on rejection.
Enables Euler angle data notifications from Thingy. The assigned event handler will be called when notifications are received.
Parameters
eventHandler function The callback function that is triggered on notification. Will receive an Euler angle data object as argument.enable boolean Enables notifications if true or disables them if set to false.Returns Promise<Error> Returns a promise when resolved or a promise with an error on rejection
Gets the current external pin settings from the Thingy device. Returns an object with pin status information.
Returns Promise<(Object | Error)> Returns an external pin status object.
Enables gas notifications from Thingy. The assigned event handler will be called when notifications are received.
Parameters
eventHandler function The callback function that is triggered on notification. Will receive a gas object as argument.enable boolean Enables notifications if true or disables them if set to false.Returns Promise<Error> Returns a promise when resolved or a promise with an error on rejection
Gets the current advertising parameters
Returns Promise<(Object | Error)> Returns an object with the advertising parameters when resolved or a promise with error on rejection.
Gets the battery level of Thingy.
Returns Promise<(Object | Error)> Returns battery level in percentage when promise is resolved or an error if rejected.
Gets the configured cloud token.
Returns Promise<(string | Error)> Returns a string with the cloud token when resolved or a promise with error on rejection.
Gets the current connection parameters.
Returns Promise<(Object | Error)> Returns an object with the connection parameters when resolved or a promise with error on rejection.
Gets the configured Eddystone URL
Returns Promise<(URL | Error)> Returns a string with the URL when resolved or a promise with error on rejection.
Gets the current configuration of the Thingy environment module.
Returns Promise<(Object | Error)> Returns an environment configuration object when promise resolves, or an error if rejected.
Gets the current firmware version.
Returns Promise<(string | Error)> Returns a string with the firmware version or a promise with error on rejection.
Gets the current LED settings from the Thingy device. Returns an object with structure that depends on the settings.
Returns Promise<Object> Returns a LED status object. The content and structure depends on the current mode.
Gets the current configuration of the Thingy motion module.
Returns Promise<(Object | Error)> Returns a motion configuration object when promise resolves, or an error if rejected.
Gets the current Maximal Transmission Unit (MTU)
Returns Promise<(number | Error)> Returns the MTU when resolved or a promise with error on rejection.
Gets the name of the Thingy device.
Returns Promise<(string | Error)> Returns a string with the name when resolved or a promise with error on rejection.
Enables gravity vector notifications from Thingy. The assigned event handler will be called when notifications are received.
Parameters
eventHandler function The callback function that is triggered on notification. Will receive a heading object as argument.enable boolean Enables notifications if true or disables them if set to false.Returns Promise<Error> Returns a promise when resolved or a promise with an error on rejection
Enables heading notifications from Thingy. The assigned event handler will be called when notifications are received.
Parameters
eventHandler function The callback function that is triggered on notification. Will receive a heading object as argument.enable boolean Enables notifications if true or disables them if set to false.Returns Promise<Error> Returns a promise when resolved or a promise with an error on rejection
Enables humidity notifications from Thingy. The assigned event handler will be called when notifications are received.
Parameters
eventHandler function The callback function that is triggered on notification. Will receive a humidity object as argument.enable boolean Enables notifications if true or disables them if set to false.Returns Promise<Error> Returns a promise when resolved or a promise with an error on rejection
Sets the LED in "breathe" mode where the LED continuously pulses with the specified color, intensity and delay between pulses.
Parameters
params Object Options object for LED breathe mode
Returns Promise<Error> Returns a resolved promise or an error in a rejected promise.
Sets the LED in constant mode with the specified RGB color.
Parameters
color Object Color object with RGB values
Returns Promise<Error> Returns a resolved promise or an error in a rejected promise.
Sets the LED in one-shot mode. One-shot mode will result in one single pulse of the LED.
Parameters
params Object Option object for LED in one-shot mode
Returns Promise<Error> Returns a resolved promise or an error in a rejected promise.
Enables raw motion data notifications from Thingy. The assigned event handler will be called when notifications are received.
Parameters
eventHandler function The callback function that is triggered on notification. Will receive a raw motion data object as argument.enable boolean Enables notifications if true or disables them if set to false.Returns Promise<Error> Returns a promise when resolved or a promise with an error on rejection
Enables orientation detection notifications from Thingy. The assigned event handler will be called when notifications are received.
Parameters
eventHandler function The callback function that is triggered on notification. Will receive a orientation detection object as argument.enable boolean Enables notifications if true or disables them if set to false.Returns Promise<Error> Returns a promise when resolved or a promise with an error on rejection
Enables pressure notifications from Thingy. The assigned event handler will be called when notifications are received.
Parameters
eventHandler function The callback function that is triggered on notification. Will receive a pressure object as argument.enable boolean Enables notifications if true or disables them if set to false.Returns Promise<Error> Returns a promise when resolved or a promise with an error on rejection
Enables quaternion notifications from Thingy. The assigned event handler will be called when notifications are received.
Parameters
eventHandler function The callback function that is triggered on notification. Will receive a quaternion object as argument.enable boolean Enables notifications if true or disables them if set to false.Returns Promise<Error> Returns a promise when resolved or a promise with an error on rejection
Enables rotation matrix notifications from Thingy. The assigned event handler will be called when notifications are received.
Parameters
eventHandler function The callback function that is triggered on notification. Will receive an rotation matrix object as argument.enable boolean Enables notifications if true or disables them if set to false.Returns Promise<Error> Returns a promise when resolved or a promise with an error on rejection
Sets the advertising parameters
Parameters
params Object Object with key/value pairs 'interval' and 'timeout': {interval: someInterval, timeout: someTimeout}.
Returns Promise<Error> Returns a promise.
Sets the cloud token.
Parameters
token string The cloud token to be stored.Returns Promise<Error> Returns a promise.
Sets the color sensor update interval.
Parameters
interval Number Color sensor sampling interval in milliseconds. Must be in the range 200 ms to 60 000 ms.Returns Promise<Error> Returns a promise when resolved or a promise with an error on rejection.
Sets the connection interval
Parameters
params Object Connection interval object: {minInterval: someValue, maxInterval: someValue}
Returns Promise<Error> Returns a promise.
Sets the connection slave latency
Parameters
slaveLatency number The desired slave latency in the range from 0 to 499 connection intervals.Returns Promise<Object> Returns a promise.
Sets the connection supervision timeout Note: According to the Bluetooth Low Energy specification, the supervision timeout in milliseconds must be greater than (1 + slaveLatency) maxConnInterval 2, where maxConnInterval is also given in milliseconds.
Parameters
timeout number The desired connection supervision timeout in milliseconds and in the range of 100 ms to 32 000 ms.Returns Promise<Error> Returns a promise.
Sets the Eddystone URL It's recommeended to use URL shortener to stay within the limit of 14 characters long URL URL scheme prefix such as "https://" and "https://www." do not count towards that limit, neither does expansion codes such as ".com/" and ".org". Full details in the Eddystone URL specification: https://github.com/google/eddystone/tree/master/eddystone-url
Parameters
urlString string The URL that should be broadcasted.Returns Promise<Error> Returns a promise.
Set an external pin to chosen state.
Parameters
pin number Determines which pin is set. Range 1 - 4.value number Sets the value of the pin. 0 = OFF, 255 = ON.Returns Promise<Error> Returns a promise when resolved or a promise with an error on rejection.
Sets the gas sensor sampling interval.
Parameters
interval Number The gas sensor update interval in seconds. Allowed values are 1, 10, and 60 seconds.Returns Promise<Error> Returns a promise when resolved or a promise with an error on rejection.
Sets the humidity measurement update interval.
Parameters
interval Number Humidity sensor interval in milliseconds. Must be in the range 100 ms to 60 000 ms.Returns Promise<Error> Returns a promise when resolved or a promise with an error on rejection.
Sets the magnetometer compensation interval.
Parameters
interval Number Magnetometer compensation interval in milliseconds. Must be in the range 100 ms to 1 000 ms.Returns Promise<Error> Returns a promise when resolved or a promise with an error on rejection.
Sets motion processing unit update frequency.
Parameters
frequency Number Motion processing frequency in Hz. The allowed range is 5 - 200 Hz.Returns Promise<Error> Returns a promise when resolved or a promise with an error on rejection.
Sets the current Maximal Transmission Unit (MTU)
Parameters
params Object MTU settings object: {mtuSize: value, peripheralRequest: value}, where peripheralRequest is optional. (optional, default {peripheralRequest:false})
Returns Promise<Error> Returns a promise.
Sets the name of the Thingy device.
Parameters
name string The name that will be given to the Thingy.Returns Promise<Error> Returns a promise.
Sets the pressure measurement update interval.
Parameters
interval Number The pressure sensor update interval in milliseconds. Must be in the range 50 ms to 60 000 ms.Returns Promise<Error> Returns a promise when resolved or a promise with an error on rejection.
Sets the step counter interval.
Parameters
interval number Step counter interval in milliseconds. Must be in the range 100 ms to 5 000 ms.Returns Promise<Error> Returns a promise when resolved or a promise with an error on rejection.
Sets the temperature compensation interval.
Parameters
interval Number Temperature compensation interval in milliseconds. Must be in the range 100 ms to 5 000 ms.Returns Promise<Error> Returns a promise when resolved or a promise with an error on rejection.
Sets the temperature measurement update interval.
Parameters
interval Number Temperature sensor update interval in milliseconds. Must be in the range 100 ms to 60 000 ms.Returns Promise<Error> Returns a promise when resolved or a promise with an error on rejection.
Sets wake-on-motion feature to enabled or disabled state.
Parameters
enable boolean Set to True to enable or False to disable wake-on-motion feature.Returns Promise<Error> Returns a promise when resolved or a promise with an error on rejection.
Enables step counter notifications from Thingy. The assigned event handler will be called when notifications are received.
Parameters
eventHandler function The callback function that is triggered on notification. Will receive a step counter object as argument.enable boolean Enables notifications if true or disables them if set to false.Returns Promise<Error> Returns a promise when resolved or a promise with an error on rejection
Enables tap detection notifications from Thingy. The assigned event handler will be called when notifications are received.
Parameters
eventHandler function The callback function that is triggered on notification. Will receive a tap detection object as argument.enable boolean Enables notifications if true or disables them if set to false.Returns Promise<Error> Returns a promise when resolved or a promise with an error on rejection
Enables temperature notifications from Thingy. The assigned event handler will be called when notifications are received.
Parameters
eventHandler function The callback function that is triggered on notification. Will receive a temperature object as argument.enable boolean Enables notifications if true or disables them if set to false.Returns Promise<Error> Returns a promise when resolved or a promise with an error on rejection