node-bluetooth-hci-socket

Bluetooth HCI socket binding for Node.js

__NOTE:__ Currently only supports __Linux__ and __Windows__.

Prerequisites

* node-gyp requirements

$3

* Bluetooth 4.0 Adapter

__Note:__ the node-usb dependency might fail install, this is ok, because it is an optional optional dependency. Installing ``libudev-dev` via your Linux distribution's package manager will resolve the problem.

$3

This library needs raw USB access to a Bluetooth 4.0 USB adapter, as it needs to bypass the Windows Bluetooth stack.

A WinUSB.aspx) driver is required, use Zadig tool to replace the driver for your adapter.

__WARNING:__ This will make the adapter unavailable in Windows Bluetooth settings! To roll back to the original driver go to: `Device Manager -> Open Device -> Update Driver`

#### Compatible Bluetooth 4.0 USB Adapter's

| Name | USB VID | USB PID |
|:---- | :------ | :-------|
| BCM920702 Bluetooth 4.0 | 0x0a5c | 0x21e8 |
| BCM20702A0 Bluetooth 4.0 | 0x19ff | 0x0239 |
| CSR8510 A10 | 0x0a12 | 0x0001 |
| Asus BT-400 | 0x0b05 | 0x17cb |
| Intel Wireless Bluetooth | 0x8087 | 0x07dc |

Install

`sh
npm install bluetooth-hci-socket
`

Usage

`javascript
var BluetoothHciSocket = require('bluetooth-hci-socket');
`

$3

#### Create

`javascript
var bluetoothHciSocket = new BluetoothHciSocket();
`

#### Set Filter

`javascript
var filter = new Buffer(14);

// ...

bluetoothHciSocket.setFilter(filter);
`

#### Bind

##### Raw Channel

`javascript
bluetoothHciSocket.bindRaw([deviceId]); // optional deviceId (integer)
`

##### User Channel

`javascript
bluetoothHciSocket.bindUser([deviceId]); // optional deviceId (integer)
`

Requires the device to be in the powered down state (`sudo hciconfig hciX down`).

##### Control Channel

`javascript
bluetoothHciSocket.bindControl();
`

#### Is Device Up

Query the device state.

`
var isDevUp = bluetoothHciSocket.isDevUp(); // returns: true or false
`

__Note:__ must be called after `bindRaw`.

#### Start/stop

Start or stop event handling:

`javascript
bluetoothHciSocket.start();

// ...

bluetoothHciSocket.stop();
`

__Note:__ must be called after `bindRaw` or `bindControl`.

#### Write

`javascript
var data = new Buffer(/ ... /);

// ...


bluetoothHciSocket.write(data);
`

__Note:__ must be called after `bindRaw` or `bindControl`.

$3

#### Data

`javascript
bluetoothHciSocket.on('data', function(data) {
// data is a Buffer

// ...
});
`

#### Error

`javascript
bluetoothHciSocket.on('error', function(error) {
// error is a Error

// ...
});
`

Examples

See examples folder for code examples.

Platform Notes

$3

#### Force Raw USB mode

Unload `btusb` kernel module:

`sh
sudo rmmod btusb
`

Set `BLUETOOTH_HCI_SOCKET_FORCE_USB` environment variable:

`sh
sudo BLUETOOTH_HCI_SOCKET_FORCE_USB=1 node .js
`

$3

#### Disable CSR USB Driver

`sh
sudo kextunload -b com.apple.iokit.CSRBluetoothHostControllerUSBTransport
`

#### Disable Broadcom USB Driver

`sh
sudo kextunload -b com.apple.iokit.BroadcomBluetoothHostControllerUSBTransport
`

$3

#### Force adapter USB VID and PID

Set `BLUETOOTH_HCI_SOCKET_USB_VID` and `BLUETOOTH_HCI_SOCKET_USB_PID` environment variables.

Example for USB device id: 050d:065a:

`sh
set BLUETOOTH_HCI_SOCKET_USB_VID=0x050d
set BLUETOOTH_HCI_SOCKET_USB_PID=0x065a

node .js
``