bluetooth-websocket-api
v0.0.2
Published
Bluetooth Websocket API - a JavaScript library that provides a simple WebSocket API to find, connect and interact with Bluetooth devices.
Downloads
12
Maintainers
Readme
Bluetooth Websocket API
The Bluetooth WebSocket API is an abstraction layer on top of the Web Bluetooth JavaScript API. The Web Bluetooth API allows websites to connect and interact with Bluetooth Low Energy devices. The library does not introduces a new API but extends the JavaScript functions as WebSocket messages. This can be handy when you want to write Bluetooth enabled webapps and already have an implementation on the server.
As the Bluetooth operations are dictated by the server, the front-end setup is straight forward. The Bluetooth search command, connect and communication are all initiated by the server side.
There are many different protocols on top of the WebSocket standard. The library has been designed while having this in mind, hence there is a separation between the library core and WebSocket adapter. Today Phoenix framework WebSocket channels are supported.
Requirements
- Android6.0+, Chrome OS or OS X. The full list of supported hardware is all the time updated by the Web Bluetooth workgroup
- Chrome v50+
- HTTPS due to WebBluetooth security requirements
Features/Usage
This library consists of three parts:
Core
Handles the Web Bluetooth API and maps functions to the WebSocket adapter.
Adapter
WebSocket specific implementation, formats and sends the messages back/forth between Core and the server.
App
An example app of usage is included in the repo, this can be used together with the Phoenix server reference app Bluetooth WebSocket Server.
Below is a simplified chart showing the different Bluetooth messages passed through the library.
For more detail of each socket event please see the Wiki page Wiki - Socket messages specification.
Installation of reference app
To start your app
Install node_module with npm install
To use SSL on localhost with WebBluetoothAPI
- Generate key with
openssl genrsa -out localhost.key 2048
- Generate cert with
openssl req -new -x509 -key localhost.key -out localhost.cert -days 3650 -subj /CN=localhost
- Put them in a directory
/keys/
- Start server with
node server.js
Now you can visit localhost:3000
with SSL from your browser.
To build js file when you update
- Update source file of
app/app/js
- Run build with
npm run build
- The file will be created to
dist/app.js
To start your HTTPS server on local:
node server.js
Now you can visit localhost:3000/app
from your browser.
Of course you can use your apache server.
Caution
- The value should be encoded with
base64
when you read/write value. Adapter#requestDevice()
method should be fired by click event (due to WebBluetoothAPI specification).characteristicvaluechanged
event is fired by after not only its value changes but also a value change notification/indication (due to WebBluetoothAPI specification).