[](https://travis-ci.org/akexorcist/Android-BluetoothSPP)
Android-BluetoothSPPLibrary
===========================
Bluetooth Serial Port Profile which comfortable to developer application to communication with microcontroller or android device via bluetooth.
This libraly include all important methods for serial port profile on bluetooth communication. It has built-in bluetooth device list.
Feature
--------------
It's very easy to use
Solve the lack of data like as "abcdefg" which divided to "abc" and "defg" when receive these data
Auto add LF (0x0A) and CR (0x0D) when send data to connection device
No need to create layout for bluetooth device list to select device for connection. You can use built-in layout in this library and you can customize layout if you want
Auto connection supported
Listener for receive data from connection device
Download
--------------
Maven
```
com.akexorcistbluetoothspp1.0.0
```
Gradle
```
compile 'com.akexorcist:bluetoothspp:1.0.0'
```
Simple Usage
--------------
Import this library to your workspace and include in to your android project
For Eclipse ADT : Download this library and import into your workspace and include this library to your project
For Android Studio : Use Gradle to download this library from Maven
Declare permission for library
```xml
```
Declare BluetoothSPP like this
```java
BluetoothSPP bt = new BluetoothSPP(Context);
```
Check if bluetooth is now available
```java
if(!bt.isBluetoothAvailable()) {
// any command for bluetooth is not available
}
```
Check if bluetooth is not enable when activity is onStart
```java
public void onStart() {
super.onStart();
if(!bt.isBluetoothEnable()) {
// Do somthing if bluetooth is disable
} else {
// Do something if bluetooth is already enable
}
}
```
if bluetooth is ready call this method to start service
For connection with android device
```java
bt.startService(BluetoothState.DEVICE_ANDROID);
```
For connection with any microcontroller which communication with bluetooth serial port profile module
```java
bt.startService(BluetoothState.DEVICE_OTHER);
```
Stop service with
```java
bt.stopService();
```
Intent to choose device activity
```java
Intent intent = new Intent(getApplicationContext(), DeviceList.class);
startActivityForResult(intent, BluetoothState.REQUEST_CONNECT_DEVICE);
```
don't forget declare library activty like this
```java
```
After intent to choose device activity and finish that activity. You need to check result data on onActivityResult
```java
public void onActivityResult(int requestCode, int resultCode, Intent data) {
if(requestCode == BluetoothState.REQUEST_CONNECT_DEVICE) {
if(resultCode == Activity.RESULT_OK)
bt.connect(data);
} else if(requestCode == BluetoothState.REQUEST_ENABLE_BT) {
if(resultCode == Activity.RESULT_OK) {
bt.setupService();
bt.startService(BluetoothState.DEVICE_ANDROID);
setup();
} else {
// Do something if user doesn't choose any device (Pressed back)
}
}
}
```
If you want to send any data. boolean parameter is mean that data will send with ending by LF and CR or not. If yes your data will added by LF & CR
```java
bt.send("Message", true);
```
or
```java
bt.send(new byte[] { 0x30, 0x38, ....}, false);
```
Listener for data receiving
```java
bt.setOnDataReceivedListener(new OnDataReceivedListener() {
public void onDataReceived(byte[] data, String message) {
// Do something when data incoming
}
});
```
Listener for bluetooth connection atatus
```java
bt.setBluetoothConnectionListener(new BluetoothConnectionListener() {
public void onDeviceConnected(String name, String address) {
// Do something when successfully connected
}
public void onDeviceDisconnected() {
// Do something when connection was disconnected
}
public void onDeviceConnectionFailed() {
// Do something when connection failed
}
});
```
Listener when bluetooth connection has changed
```java
bt.setBluetoothStateListener(new BluetoothStateListener() {
public void onServiceStateChanged(int state) {
if(state == BluetoothState.STATE_CONNECTED)
// Do something when successfully connected
else if(state == BluetoothState.STATE_CONNECTING)
// Do something while connecting
else if(state == BluetoothState.STATE_LISTEN)
// Do something when device is waiting for connection
else if(state == BluetoothState.STATE_NONE)
// Do something when device don't have any connection
}
});
```
Using auto connection
```java
bt.autoConnect("Keyword for filter paired device");
```
Listener for auto connection
```java
bt.setAutoConnectionListener(new AutoConnectionListener() {
public void onNewConnection(String name, String address) {
// Do something when earching for new connection device
}
public void onAutoConnectionStarted() {
// Do something when auto connection has started
}
});
```
Customize device list's layout by create layout which include
list view with id name = "list_devices"
button with id name = "button_scan"
*Example*
```xml
```
But if you don't need to create layout file. You just want to change only text on device list layout. You can use bundle to change text on device list
```java
Intent intent = new Intent(getApplicationContext(), DeviceList.class);
intent.putExtra("bluetooth_devices", "Bluetooth devices");
intent.putExtra("no_devices_found", "No device");
intent.putExtra("scanning", "");
intent.putExtra("scan_for_devices", "Search");
intent.putExtra("select_device", "Select");
startActivityForResult(intent, BluetoothState.REQUEST_CONNECT_DEVICE);
```
What's next?
===========================
- Connection Dialog
- Add Insecure Connection
- Fix bug on this issue https://github.com/akexorcist/Android-BluetoothSPPLibrary/issues/21
- Merge the code from https://github.com/akexorcist/Android-BluetoothSPPLibrary/pull/14 for a problem of auto connection
- Human Readable Log https://github.com/akexorcist/Android-BluetoothSPPLibrary/issues/19
License
--------------
Copyright (c) 2014 Akexorcist
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.