This node module lets you communicate over Bluetooth serial port with devices using Node.js. The goal is have an easy to use API. This module is great for communicating with Bluetooth enabled Arduino devices.
- Only tested on Linux
- Only available on Linux and BSD like systems
- Not available for Windows and Mac OS X
- Currently all data is passed as strings
- Needs bluetooth development packages to build.
- The bluetooth device should already be paired.
npm install bluetooth-serial-port
var btSerial = new require('bluetooth-serial-port').BluetoothSerialPort();
btSerial.on('found', function(address, name) {
btSerial.findSerialPortChannel(address, function(channel) {
btSerial.connect(bluetoothAddress, channel, function() {
console.log('connected');
btSerial.write('my data');
btSerial.on('data', function(data) {
console.log(data);
});
}, function () {
console.log('cannot connect');
});
// close the connection when you're ready
btSerial.close();
});
});
btSerial.inquire();
Emitted when data is read from the serial port connection.
- data - the data that was read
Emitted when reading form the serial port connection results in an error. The connection is closed.
- message - an message describing the failure.
Emitted when a bluetooth device was found.
- address - the address of the device
- name - the name of the device
Emitted when the device inquiry execution did finish.
Starts searching for bluetooth devices. When a device is found a 'found' event will be emitted.
Checks if a device has a serial port service running and if it is found it passes the channel id to use for the RFCOMM connection.
- callback(channel) - called when finished looking for a serial port on the device. channel === -1 if no channel was found.
Connects to a remote bluetooth device.
- bluetoothAddress - the address of the remote Bluetooth device.
- [successCallback] - called when a connection has been established.
- [errorCallback(msg)] - called when the connection attempt results in an error.
Closes the connection.
Writes a string to the serial port connection.
-
data - the data string to be written.
-
Throws an exception when is called before a connection has been established.
This module is available under a http://opensource.org/licenses/BSD-2-Clause[FreeBSD license], see also the https://raw.github.com/eelcocramer/node-bluetooth-serial-port/master/LICENSE[LICENSE file] for details.