Ble Library V1.1

Simple and Mechanized Library to develop the BLE applications faster .

Getting Started

Create an Android Ble Project and Follow the below steps.

How To Add dunadevAndroid:bleLib To Your Project .. ?

Using Gradle:

Step 1 :Add it in your root build.gradle at the end of repositories .

allprojects {
  repositories {
   
   maven { url 'https://jitpack.io' }
  }
 }

Step 2 Add the dependency

dependencies {
         
     implementation 'com.github.EmKsolandroid:ble:1.1'

 }

Using Maven :

Step 1 :

<repositories>
  <repository>
      <id>jitpack.io</id>
      <url>https://jitpack.io</url>
  </repository>
 </repositories>

Step 2:

<dependency>
       <groupId>com.github.EmKsolandroid</groupId>
       <artifactId>ble</artifactId>
       <version>1.1</version>
   </dependency>

Once you have finished adding this library you are all set to work with Ble Lib.

Few Important Notes :

• This Library has already added all the premissions you required . so you need not to bother about it
  

   <uses-permission android:name="android.permission.BLUETOOTH_ADMIN"/>
  <uses-permission android:name="android.permission.BLUETOOTH"/>
  <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION"/>
  <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"/>
      <!-- Blutooth Permission -->
  <uses-feature android:name="android.hardware.bluetooth_le" android:required="true"/>
  

• You need to create the boradcast Reciever to get the Notification

• Initialization

  Create An Broadcast Reciver and Declare it in android Manifest:

  <receiver
              android:name="com.androidBle.maturis.blelib.MyReciever"
              android:enabled="true"
              android:exported="true">
              <intent-filter android:priority="9">
                  <action android:name="com.example.maturis.blelib.CUSTOM_BROADCAST" />
              </intent-filter>
          </receiver>
          
  

  Create An Object Of Ble this will enable the ble On device.

  Ble  ble = new Ble(Activity, Contxet,Android_Name_Reciver);
  

  Check for the permission and it will call the on request premission if permissions are not granted.

  Boolean status = ble.checkPermission(PERMISSION_REQUEST_COARSE_LOCATION);
          if (status){
              Log.w(TAG,"Permission Granted");
  
  
          }else {
              Log.w(TAG,"Permission Not Granted");
  
          }
  

  Override the onRequestPermissionsResult

    @Override
      public void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions, @NonNull int[] grantResults) {
          super.onRequestPermissionsResult(requestCode, permissions, grantResults);
          switch (requestCode) {
              case PERMISSION_REQUEST_COARSE_LOCATION: {
                  if (grantResults[0] == PackageManager.PERMISSION_GRANTED) {
                      // Permission granted, yay! Start the Bluetooth device scan.
                      Log.d("TAG", "RUNTIIME PERMISSION OK");
                      Log.w("TAG","SCANNING STARTED");
  
                  } else {
                      // Alert the user that this application requires the location permission to perform the scan.
                      Log.d("TAG", "RUNTIIME PERMISSION NOTOK");
                      Toast.makeText(this, "NO PERMISSION ", Toast.LENGTH_SHORT).show();
                  }
              }
          }
      }
  

  To, start the scan of Devices. The Device will stop the scan after a particular Scan duration.

   ble.scanLeDevice(true,SCAN_DURATION);
  

  To, stop the Scan the manually .

   ble.scanLeDevice(false,SCAN_DURATION);
  

  To get the list of devices .This will return an array list of type String

   ble.getDevices();
  

  To connect and to create a bond with Ble device.

  ble.connectBLE(MAC_ADDRESS);
  

  To disconnect with Ble Device

  ble.disConnectBLE();
  

  To perform write on characteristics.

  ble.writeCharacteristics(YOUR_BYTE_ARRAY,BLE_SERVICE,BLE_WRITE_CHARACTERISTICS);
  

  To enable Notification.

  ble.enableNotification(BLE_SERVICE,BLE_NOTIFY_CHARACTER,CLIENT_CCD,true);
  

  To get the Notified data you have to create a BroadCastReciver and add the following code snippet in onRecieve.

  ```
  @Override
  public void onReceive(Context context, Intent intent) {
      String data = intent.getStringExtra("data");
  
      Log.w(TAG, "Request Recieved On MyReciever ::" + data);
  
  }
  ```
  

  To check the logs. type Ble in logcat.

  Conclusion

  Feel free to modify the library as per your need.
  Happy coding

  Versioning

  We use Github for versioning. For the versions available, see the tags on this repository.

  Authors

  • **Maturi Karthik ** - maturikarthik31@gmail.com

  License

  This project is licensed under MIT -

  Built With

  • Maven - Dependency Management