This is a node addon api package used for connecting other bluetooth through Bluethooth SPP. IMPORTANT! It supports for Windows platform. Now, we can use it as server and client.
This library is developed in C++ and support for Node.js.
Install this package into your project by below command
npm install @siva7170/ble-connection
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();-
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!");
});-
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!");
});-
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)=>{
});- onDataRecvCallback:
- Type:
Function
- Type:
This method will be triggered when the data sent from bluetooth server
bleConnInstance.OnReceiveData((data)=>{
console.log("Data receivedd: "+data);
});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());
}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();-
bluetooth_addr:
- Type:
String
- Type:
-
uuid:
- Type:
String
- Type:
-
timeout_for_reconnect:
- Type:
Integer
- Type:
-
no_of_attempt_to_reconnect:
- Type:
Integer
- Type:
It sets necessary things to BLE Connection before it initialize.
bleConnInstance.SetBtInfo("00:00:00:00:00:E0","aaaaaaaa-aaaa-4444-cccc-999888999888",5000,0);- statusCallback:
- Type:
Function
- Type:
This method will give current state of BLE Connection when it is changed from one to another.
bleConnInstance.GetStatus((res)=>{
console.log("Status: "+res);
});-
successCallback:
- Type:
Function
- Type:
-
failureCallback:
- Type:
Function
- Type:
It will make connection to device which is defined in SetBtInfo()
bleConnInstance.MakeConnection(()=>{
console.log("Connected...!");
},
()=>{
console.log("Failed to connect!");
});-
successCallback:
- Type:
Function
- Type:
-
failureCallback:
- Type:
Function
- Type:
This method will be triggered when connection made to Bluetooth Server.
bleConnInstance.IsConnected(()=>{
console.log("Connection status: Connected!");
},
()=>{
console.log("Failed to connect!");
});-
data:
- Type:
String
- Type:
-
successCallback:
- Type:
Function
- Type:
-
failureCallback:
- Type:
Function
- Type:
With this method, you can send data to client
bleConnInstance.SendDataToServer('Hi server!',(res)=>{
console.log("Data sent: "+sData);
}, (err)=>{
});- onDataRecvCallback:
- Type:
Function
- Type:
This method will be triggered when the data sent from bluetooth server
bleConnInstance.OnReceiveDataFromServer((data)=>{
console.log("Data receivedd: "+data);
});Please find full example of implementation
const bleConnection = require('@siva7170/ble-connection');
const bleConnInstance = new bleConnection.BLEConnection();
try{
bleConnInstance.SetBtInfo("00:00:00:00:00:E0","aaaaaaaa-aaaa-4444-cccc-999888999888",5000,0);
bleConnInstance.GetStatus((res)=>{
console.log("Status: "+res);
});
bleConnInstance.MakeConnection(()=>{
console.log("Connected...!");
},
()=>{
console.log("Failed to connect!");
});
bleConnInstance.IsConnected(()=>{
console.log("Connection status: Connected!");
// INITIATE
bleConnInstance.SendDataToServer("INITIATE",(res)=>{
console.log("Initiating...!");
}, (err)=>{
});
bleConnInstance.OnReceiveDataFromServer((data)=>{
bleConnInstance.SendDataToServer("READY_SCAN",(res)=>{
console.log("Ready scan...!");
}, (err)=>{
});
});
},
()=>{
console.log("Failed to connect!");
});
}catch(e){
console.error(e.toString());
}Below code is sample for how to use it. Please see methods and its functionalities below sections.
const bleConnection = require('@siva7170/ble-connection');
const bleServerInstance = new bleConnection.BLEServer();It sets necessary things to BLE Server before it initialize.
bleServerInstance.Initiate();- serviceName:
- Type:
String
- Type:
This method will start the Bluetooth SPP server.
bleServerInstance.StartServer(serviceName);This method will stop the Bluetooth SPP server.
bleServerInstance.StopServer();- dataCallback:
- Type:
Function
- Type:
It will call the data callback when new data received from client.
bleServerInstance.OnData((data)=>{
console.log("Data>",data);
});- data:
- Type:
String
- Type:
It will send data to client.
bleServerInstance.SendData("Hello!");- callback:
- Type:
Function
- Type:
This method will be triggered when connection made to Bluetooth Client.
bleServerInstance.OnClientConnected(()=>{
console.log("Connected!");
});- callback:
- Type:
Function
- Type:
This method will be triggered when connection lost with Bluetooth Client.
bleServerInstance.OnClientDisconnected(()=>{
console.log("Disconnected!");
});Please find full example of implementation
// Please refer "./test/server.js"- Bluetooth SPP Client (Windows)
- Bluetooth SPP Client (Other platform)
- Bluetooth SPP Server (Windows)
- Bluetooth SPP Server (Other platform)
- Modify all code more efficient
I created this package for my own usage. I welcome contribution for this package improvement.