@siva7170/ble-connection v1.0.1
BLE Connection
This is a node addon api package used for connecting other bluetooth through Bluethooth SPP. IMPORTANT! It supports for Windows platform. For now, we can only connect to other bluetooth spp. It means, this package does not act as server.
Getting Started
This library is developed in C++ and support for Node.js.
Installation
Install this package into your project by below command
npm install @siva7170/ble-connection
Usage
Below code is sample for how to use it. Please see methods and its functionalities below sections.
const bleConnection = require('@siva7170/ble-connection');
const bleConnInstance = new bleConnection.BLEConnection();
Methods
Initiate(successCallback,failureCallback)
successCallback:
- Type:
Function
- Type:
failureCallback:
- Type:
Function
- Type:
It initializes the necessary things.
bleConnInstance.Initiate(()=>{
console.log("Initiated!");
// rest of the code
},()=>{
console.log("Failed to initiate!");
});
Connect(bluetooth_addr, uuid, successCallback,failureCallback)
bluetooth_addr:
- Type:
String
- Type:
uuid:
- Type:
String
- Type:
successCallback:
- Type:
Function
- Type:
failureCallback:
- Type:
Function
- Type:
This method will try to connect to the given bluetooth address and uuid from bluetooth spp server.
// please use valid bluetooth address and UUID
bleConnInstance.Connect("00:00:00:00:00:E0","aaaaaaaa-aaaa-4444-cccc-999888999888",()=>{
console.log("Connected!");
// rest of the code
},()=>{
console.log("Failed to connect!");
});
SendData(data, successCallback, failureCallback) (optional)
data:
- Type:
String
- Type:
successCallback:
- Type:
Function
- Type:
failureCallback:
- Type:
Function
- Type:
With this method, you can send data to client
bleConnInstance.SendData('Hi server!',(res)=>{
console.log("Data sent: "+sData);
}, (err)=>{
});
OnReceiveData(onDataRecvCallback)
- onDataRecvCallback:
- Type:
Function
- Type:
This method will be triggered when the data sent from bluetooth server
bleConnInstance.OnReceiveData((data)=>{
console.log("Data receivedd: "+data);
});
Full Exaample
Please find full example of implementation
const bleConnection = require('@siva7170/ble-connection');
const bleConnInstance = new bleConnection.BLEConnection();
try{
bleConnInstance.Initiate(()=>{
console.log("Initiated!");
bleConnInstance.Connect("00:00:00:00:00:E0","aaaaaaaa-aaaa-4444-cccc-999888999888",()=>{
console.log("Connected!");
let sData="Hi client";
bleConnInstance.SendData(sData,(res)=>{
console.log("Data sent: "+sData);
}, (err)=>{
});
bleConnInstance.OnReceiveData((data)=>{
console.log("Data receivedd: "+data);
});
sData="How are you?";
bleConnInstance.SendData(sData,(res)=>{
console.log("Data sent: "+sData);
}, (err)=>{
});
},()=>{
console.log("Failed to connect!");
});
},()=>{
console.log("Failed to initiate!");
});
}catch(e){
console.error(e.toString());
}
TODO
- Bluetooth SPP Client (Windows)
- Bluetooth SPP Client (Other platform)
- Bluetooth SPP Server (for all platform)
- Modify all code more efficient
Contribution
I created this package for my own usage. I welcome contribution for this package improvement.