JSPM

GAN Smart Timer via Web Bluetooth API

This library is designed for easy interaction with GAN Smart Timer on the platforms that support Web Bluetooth API.

Nature of the GAN Smart Timer is event-driven, so this library is depends on RxJS and provide Observable where you can subscribe for timer events.

Usage:

Sample application using this library can be found here:

• https://github.com/afedotov/gan-timer-display
• Live version: GAN Timer Display

TypeScript code:

import { connectGanTimer, GanTimerState } from 'gan-web-bluetooth';

var conn = await connectGanTimer();

conn.events$.subscribe((timerEvent) => {
    switch (timerEvent.state) {
        case GanTimerState.RUNNING:
            console.log('Timer is started');
            break;
        case GanTimerState.STOPPED:
            console.log(`Timer is stopped, recorded time = ${timerEvent.recordedTime}`);
            break;
        default:
            console.log(`Timer changed state to ${GanTimerState[timerEvent.state]}`);
    }
});

You can read last times stored in the timer memory:

Please note that you should not use getRecordedTimes() in polling fashion to get currently displayed time. Timer and its bluetooth protocol does not designed for that.

var recTimes = await conn.getRecordedTimes();
console.log(`Time on display = ${recTimes.displayTime}`);
recTimes.previousTimes.forEach((pt, i) => console.log(`Previous time ${i} = ${pt}`));

Possible timer states and their description:

Timer state diagram:

stateDiagram-v2
    direction LR
    IDLE --> HANDS_ON
    HANDS_ON --> HANDS_OFF
    HANDS_OFF --> HANDS_ON
    HANDS_ON --> GET_SET
    GET_SET --> RUNNING
    RUNNING --> STOPPED
    STOPPED --> FINISHED
    FINISHED --> IDLE