LMBluetoothSdk

A library to make classic bluetooth or BLE easier to use in Android.

Screenshots

Usage

Step 1

Gradle

dependencies {
    compile 'co.lujun:lmbluetoothsdk:1.0.5'
}

Maven

<dependency>
    <groupId>co.lujun</groupId>
    <artifactId>lmbluetoothsdk</artifactId>
    <version>1.0.5</version>
    <packaging>aar</packaging>
</dependency>

Step 2

Build the controller in your app with current context(the sdk need this context to register a BroadcastReceiver to receive the bluetooth status), and you may get the singleton BluetoothController(BluetoothLEController) object, code like that:

// For classic bluetooth
BluetoothController mBTController = BluetoothController.getInstance().build(Context context);

// If you make code for BLE
// BluetoothLEController mBLEController = BluetoothLEController.getInstance().build(Context context);

Step 3

Use the BluetoothController instance you get to set a UUID for SDP record. If skip this step, will use the default UUID fa87c0d0-afac-11de-8a39-0800200c9a66. If you are connecting to a Bluetooth serial board then try using the well-known SPP UUID 00001101-0000-1000-8000-00805F9B34FB. This step is for classic bluetooth.

mBTController.setAppUuid(UUID uuid);

Step 4

Use the controller instance you get to set a BluetoothListener(BluetoothLEListener), with this listener you can get all status and data you need.

mBTController.setBluetoothListener(new BluetoothListener() {

       @Override
       public void onActionStateChanged(int preState, int state) {
           // Callback when bluetooth power state changed.
       }

       @Override
       public void onActionDiscoveryStateChanged(String discoveryState) {
           // Callback when local Bluetooth adapter discovery process state changed.
       }

       @Override
       public void onActionScanModeChanged(int preScanMode, int scanMode) {
           // Callback when the current scan mode changed.
       }

       @Override
       public void onBluetoothServiceStateChanged(int state) {
           // Callback when the connection state changed.
       }

       @Override
       public void onActionDeviceFound(BluetoothDevice device) {
           // Callback when found device.
       }

       @Override
       public void onReadData(final BluetoothDevice device, final byte[] data) {
           // Callback when remote device send data to current device.
       }
});

mBLEController.setBluetoothListener(new BluetoothLEListener() {

        @Override
        public void onReadData(final BluetoothGattCharacteristic characteristic) {
            // Read data from BLE device.
        }

        @Override
        public void onWriteData(final BluetoothGattCharacteristic characteristic) {
            // When write data to remote BLE device, the notification will send to here.
        }

        @Override
        public void onDataChanged(final BluetoothGattCharacteristic characteristic) {
            // When data changed, the notification will send to here.
        }

        @Override
        public void onActionStateChanged(int preState, int state) {
            // Callback when bluetooth power state changed.
        }

        @Override
        public void onActionDiscoveryStateChanged(String discoveryState) {
            // Callback when local Bluetooth adapter discovery process state changed.
        }

        @Override
        public void onActionScanModeChanged(int preScanMode, int scanMode) {
            // Callback when the current scan mode changed.
        }

        @Override
        public void onBluetoothServiceStateChanged(final int state) {
            // Callback when the connection state changed.
        }

        @Override
        public void onActionDeviceFound(final BluetoothDevice device, short rssi)) {
            // Callback when found device.
        }
});

Now the initialization step has been completed, you can use the following functional methods to make you app.

Public methods for BluetoothController/BluetoothLEController

Note: In Android6.0+, you have to ask the user explicitly about ACCESS_COARSE_LOCATION permission, because BluetoothDevice.ACTION_FOUND require ACCESS_COARSE_LOCATION permission when search classic bluetooth devices.

Public methods for BluetoothController

Public methods for BluetoothLEController

State

Manufacturing bluetooth connection status, there are 6 states in the class.

Change logs

1.0.5(2017-2-16)

• bug fix

1.0.4(2017-2-6)

• bug fix

1.0.2(2016-3-15)

• Add RSSI value for scan callback
• Add STATE_GOT_CHARACTERISTICS state for got all characteristics
• fixed issue #3

1.0.1(2016-2-2)

• sync to Maven
• fixed issue #2

1.0.0(2016-1-26)

• First release

Sample App

APK

About

If you have any questions, contact me: lujun.byte#gmail.com.

License

The MIT License (MIT)

Copyright (c) 2015 LinkMob.cc

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.