@kano/devices-sdk
v1.0.1
Published
Allows the detection and comunication with Kano devices.
Downloads
8
Maintainers
Keywords
Readme
kano-devices-sdk
Allows the detection and comunication with Kano devices.
Platform independance
This SDK aims to be platform independant as it doesn't implement any Bluetooth, Wi-FI or serial communication. Instead it provides classes expecting a mixin for a BLEDevice/SerialDevice/WiFIDevice to be provided.
Platform support
Some platforms are already supported and available in the platforms
directory.
Nodejs
Bluetooth communication is supported in a nodejs environment using the modules noble
or noble-uwp
. These modules will need to be installed in your project.
Cordova
Bluetooth communication is supported in a cordova environment using the plugin cordova-plugin-bluetoothle.
Example
import Devices from '../kano-devices/sdk/kano-devices-sdk.js';
// Pltform specific bluetooth watcher and device mixin
import Watcher from './ble-watcher.js';
import BLEDeviceMixin from './ble-device.js';
const DevicesManager = new Devices({
bluetooth: {
watcher: new Watcher(),
deviceMixin: BLEDeviceMixin,
},
});
export default DevicesManager;
Example of a mixin for the BLEDevice:
// Return a function that will receive the Device class. It needs to extends it, implement the bluetooth methods and return the BLEDevice class
const BLEDeviceMixin = (Device) => {
class BLEDevice extends Device {
// Will receive the device object the watcher found
constructor(device) {
super();
this.type = 'ble-device';
// Do something with the device object
}
// Implement here the methods
}
return BLEDevice;
};
export default BLEDeviceMixin;
Connection lifecycle
A BLEDevice must track the state of its connection following this State Machine Diagram:
Possible future applications:
- Write a websocket adapter