Java tutorial
/* * Copyright (C) 2013 The Android Open Source Project * * 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. */ package com.cqupt.sensor_ble.activity; import android.app.Service; import android.bluetooth.BluetoothAdapter; import android.bluetooth.BluetoothDevice; import android.bluetooth.BluetoothGatt; import android.bluetooth.BluetoothGattCallback; import android.bluetooth.BluetoothGattCharacteristic; import android.bluetooth.BluetoothGattDescriptor; import android.bluetooth.BluetoothGattService; import android.bluetooth.BluetoothManager; import android.bluetooth.BluetoothProfile; import android.content.Context; import android.content.Intent; import android.os.Binder; import android.os.IBinder; import android.support.v4.content.LocalBroadcastManager; import android.util.Log; import java.util.List; import java.util.UUID; /** * Service for managing connection and data communication with a GATT server hosted on a * given Bluetooth LE device. */ public class UartService extends Service { private final static String TAG = "SmartLock"; private static final String CHAR1_DATA = "char1"; private static final String WRITE_STATUS = "writeStatus"; public static final String RSSI = "rssi"; public static final String RSSI_STATUS = "rssiStatus"; private BluetoothManager mBluetoothManager; private BluetoothAdapter mBluetoothAdapter; private String mBluetoothDeviceAddress; private BluetoothGatt mBluetoothGatt; private static final int STATE_DISCONNECTED = 0; private static final int STATE_CONNECTING = 1; private static final int STATE_CONNECTED = 2; public final static String ACTION_GATT_CONNECTED = "com.cqupt.sensor_ble.ACTION_GATT_CONNECTED"; public final static String ACTION_GATT_DISCONNECTED = "com.cqupt.sensor_ble.ACTION_GATT_DISCONNECTED"; public final static String ACTION_GATT_SERVICES_DISCOVERED = "com.cqupt.sensor_ble.ACTION_GATT_SERVICES_DISCOVERED"; public final static String ACTION_DATA_AVAILABLE = "com.cqupt.sensor_ble.ACTION_DATA_AVAILABLE"; public final static String EXTRA_DATA = "com.cqupt.sensor_ble.EXTRA_DATA"; public final static String DEVICE_DOES_NOT_SUPPORT_UART = "com.cqupt.sensor_ble.DEVICE_DOES_NOT_SUPPORT_UART"; public final static String EXTRAS_DEVICE_BATTERY = "com.cqupt.sensor_ble.EXTRAS_DEVICE_BATTERY"; //? private static final UUID RX_SERVICE_UUID = UUID.fromString("0000ffe0-0000-1000-8000-00805f9b34fb"); //?RXCC254x?0xfff1 private static final UUID RX_CHAR_UUID = UUID.fromString("0000ffe1-0000-1000-8000-00805f9b34fb"); //?TXCC254x???0xfff4notify? private static final UUID TX_CHAR_UUID = UUID.fromString("0000ffe1-0000-1000-8000-00805f9b34fb"); private static final UUID CCCD = UUID.fromString("00002902-0000-1000-8000-00805f9b34fb"); //? public static final UUID Battery_Service_UUID = UUID.fromString("0000180F-0000-1000-8000-00805f9b34fb"); public static final UUID Battery_Level_UUID = UUID.fromString("00002a19-0000-1000-8000-00805f9b34fb"); // Implements callback methods for GATT events that the app cares about. For example, // connection change and services discovered. /** * ??? */ private final BluetoothGattCallback mGattCallback = new BluetoothGattCallback() { @Override public void onConnectionStateChange(BluetoothGatt gatt, int status, int newState) { String intentAction; /** * ? */ if (newState == BluetoothProfile.STATE_CONNECTED) { intentAction = ACTION_GATT_CONNECTED; broadcastUpdate(intentAction); Log.i(TAG, "Connected to GATT server."); // Attempts to discover services after successful connection. Log.i(TAG, "Attempting to start service discovery:" + mBluetoothGatt.discoverServices()); /** * */ } else if (newState == BluetoothProfile.STATE_DISCONNECTED) { intentAction = ACTION_GATT_DISCONNECTED; Log.i(TAG, "Disconnected from GATT server."); broadcastUpdate(intentAction); } } @Override public void onServicesDiscovered(BluetoothGatt gatt, int status) { if (status == BluetoothGatt.GATT_SUCCESS) { Log.w(TAG, "mBluetoothGatt = " + mBluetoothGatt); broadcastUpdate(ACTION_GATT_SERVICES_DISCOVERED); } else { Log.w(TAG, "onServicesDiscovered received: " + status); } } /** * ?RSSI * @param gatt gatt * @param rssi rssi * @param status status */ @Override public void onReadRemoteRssi(BluetoothGatt gatt, int rssi, int status) { super.onReadRemoteRssi(gatt, rssi, status); final Intent intent = new Intent(ACTION_DATA_AVAILABLE); intent.putExtra(RSSI, "" + rssi); intent.putExtra(RSSI_STATUS, "" + status); LocalBroadcastManager.getInstance(UartService.this).sendBroadcast(intent); } /** * ???? * @param gatt gatt * @param characteristic characteristic * @param status status */ @Override public void onCharacteristicWrite(BluetoothGatt gatt, BluetoothGattCharacteristic characteristic, int status) { super.onCharacteristicWrite(gatt, characteristic, status); broadcastUpdate(ACTION_DATA_AVAILABLE, characteristic, status); } /** * ? * @param gatt gatt * @param characteristic characteristic * @param status status */ @Override public void onCharacteristicRead(BluetoothGatt gatt, BluetoothGattCharacteristic characteristic, int status) { if (status == BluetoothGatt.GATT_SUCCESS) { if (Battery_Level_UUID.equals(characteristic.getUuid())) { broadcastUpdate(EXTRAS_DEVICE_BATTERY, characteristic); } else { broadcastUpdate(ACTION_DATA_AVAILABLE, characteristic); } } } /** * ?? * @param gatt gatt * @param characteristic characteristic */ @Override public void onCharacteristicChanged(BluetoothGatt gatt, BluetoothGattCharacteristic characteristic) { broadcastUpdate(ACTION_DATA_AVAILABLE, characteristic); } }; /** * ?? * * @param action action */ private void broadcastUpdate(final String action) { final Intent intent = new Intent(action); LocalBroadcastManager.getInstance(this).sendBroadcast(intent); } /** * ??? * * @param action action * @param characteristic characteristic */ StringBuilder temp = new StringBuilder(38); private void broadcastUpdate(final String action, final BluetoothGattCharacteristic characteristic) { final Intent intent = new Intent(action); if (TX_CHAR_UUID.equals(characteristic.getUuid())) { final byte[] byte_data = characteristic.getValue(); if (byte_data != null && byte_data.length > 0) { final StringBuilder stringBuilder = new StringBuilder(byte_data.length); for (byte byteChar : byte_data) { stringBuilder.append(String.format("%X", byteChar)); } temp.append(stringBuilder.toString()).append(" "); if ("A".equals(stringBuilder.toString())) { //? String string = temp.toString(); if (string.length() == 34) { //?? String t = String.valueOf(string.charAt(7)) + String.valueOf(string.charAt(10)); //?? String h = String.valueOf(string.charAt(25)) + String.valueOf(string.charAt(28));//?? int[] int_array = new int[2]; int_array[0] = Integer.parseInt(h); int_array[1] = Integer.parseInt(t); intent.putExtra(EXTRA_DATA, int_array); } temp = null; temp = new StringBuilder(38); } } } else if (RX_CHAR_UUID.equals(characteristic.getUuid())) { intent.putExtra(CHAR1_DATA, "" + characteristic.getIntValue(BluetoothGattCharacteristic.FORMAT_UINT8, 0)); } else if (Battery_Level_UUID.equals(characteristic.getUuid())) { intent.putExtra(EXTRA_DATA, "" + characteristic.getIntValue(BluetoothGattCharacteristic.FORMAT_UINT8, 0)); } LocalBroadcastManager.getInstance(this).sendBroadcast(intent); } private void broadcastUpdate(final String action, final BluetoothGattCharacteristic characteristic, final int status) { final Intent intent = new Intent(action); if (RX_CHAR_UUID.equals(characteristic.getUuid())) { intent.putExtra(WRITE_STATUS, "" + status); } LocalBroadcastManager.getInstance(this).sendBroadcast(intent); } /** * */ public class LocalBinder extends Binder { UartService getService() { return UartService.this; } } @Override public IBinder onBind(Intent intent) { return mBinder; } @Override public boolean onUnbind(Intent intent) { // After using a given device, you should make sure that BluetoothGatt.close() is called // such that resources are cleaned up properly. In this particular example, close() is // invoked when the UI is disconnected from the Service. close(); return super.onUnbind(intent); } private final IBinder mBinder = new LocalBinder(); /** * ?? ?mBluetoothAdapter * Initializes a reference to the local Bluetooth adapter. * * @return Return true if the initialization is successful. */ public boolean initialize() { // For API level 18 and above, get a reference to BluetoothAdapter through // BluetoothManager. if (mBluetoothManager == null) { mBluetoothManager = (BluetoothManager) getSystemService(Context.BLUETOOTH_SERVICE); if (mBluetoothManager == null) { Log.e(TAG, "Unable to initialize BluetoothManager."); return false; } } mBluetoothAdapter = mBluetoothManager.getAdapter(); if (mBluetoothAdapter == null) { Log.e(TAG, "Unable to obtain a BluetoothAdapter."); return false; } return true; } /** * ?RSSI * * @return boolean */ public boolean myReadRemoteRssi() { return mBluetoothGatt.readRemoteRssi(); } /** * ?? ? * Connects to the GATT server hosted on the Bluetooth LE device. * * @param address The device address of the destination device. * @return Return true if the connection is initiated successfully. The connection result * is reported asynchronously through the * {@code BluetoothGattCallback#onConnectionStateChange(android.bluetooth.BluetoothGatt, int, int)} * callback. */ public boolean connect(final String address) { if (mBluetoothAdapter == null || address == null) { Log.w(TAG, "BluetoothAdapter not initialized or unspecified address."); return false; } // Previously connected device. Try to reconnect. if (mBluetoothDeviceAddress != null && address.equals(mBluetoothDeviceAddress) && mBluetoothGatt != null) { Log.d(TAG, "Trying to use an existing mBluetoothGatt for connection."); return mBluetoothGatt.connect(); } final BluetoothDevice device = mBluetoothAdapter.getRemoteDevice(address); if (device == null) { Log.w(TAG, "Device not found. Unable to connect."); return false; } // We want to directly connect to the device, so we are setting the autoConnect // parameter to false. //autoConnect (boolean indicating whether to automatically connect to the BLE device // as soon as it becomes available) mBluetoothGatt = device.connectGatt(this, false, mGattCallback); Log.d(TAG, "Trying to create a new connection."); mBluetoothDeviceAddress = address; return true; } /** * ? * Disconnects an existing connection or cancel a pending connection. The disconnection result * is reported asynchronously through the * {@code BluetoothGattCallback#onConnectionStateChange(android.bluetooth.BluetoothGatt, int, int)} * callback. */ public void disconnect() { if (mBluetoothAdapter == null || mBluetoothGatt == null) { Log.w(TAG, "BluetoothAdapter not initialized"); return; } mBluetoothGatt.disconnect(); // mBluetoothGatt.close(); } /** * ? * After using a given BLE device, the app must call this method to ensure resources are * released properly. */ private void close() { if (mBluetoothGatt == null) { return; } Log.w(TAG, "mBluetoothGatt closed"); mBluetoothDeviceAddress = null; mBluetoothGatt.close(); mBluetoothGatt = null; } /** * ? * Request a read on a given {@code BluetoothGattCharacteristic}. The read result is reported * asynchronously through the {@code BluetoothGattCallback#onCharacteristicRead(android.bluetooth.BluetoothGatt, android.bluetooth.BluetoothGattCharacteristic, int)} * callback. * * @param characteristic The characteristic to read from. */ // public void readCharacteristic(BluetoothGattCharacteristic characteristic) { // if (mBluetoothAdapter == null || mBluetoothGatt == null) { // Log.w(TAG, "BluetoothAdapter not initialized"); // return; // } // mBluetoothGatt.readCharacteristic(characteristic); // } /** * Enables or disables notification on a give characteristic. * * @param characteristic Characteristic to act on. * @param enabled If true, enable notification. False otherwise. */ /* public void setCharacteristicNotification(BluetoothGattCharacteristic characteristic, boolean enabled) { if (mBluetoothAdapter == null || mBluetoothGatt == null) { Log.w(TAG, "BluetoothAdapter not initialized"); return; } mBluetoothGatt.setCharacteristicNotification(characteristic, enabled); if (UUID_HEART_RATE_MEASUREMENT.equals(characteristic.getUuid())) { BluetoothGattDescriptor descriptor = characteristic.getDescriptor( UUID.fromString(SampleGattAttributes.CLIENT_CHARACTERISTIC_CONFIG)); descriptor.setValue(BluetoothGattDescriptor.ENABLE_NOTIFICATION_VALUE); mBluetoothGatt.writeDescriptor(descriptor); } }*/ /** * ? * Enable TXNotification */ public void enableTXNotification() { if (mBluetoothGatt == null) { showMessage("mBluetoothGatt null"); broadcastUpdate(DEVICE_DOES_NOT_SUPPORT_UART); return; } BluetoothGattService RxService = mBluetoothGatt.getService(RX_SERVICE_UUID); if (RxService == null) { showMessage("Rx service not found!"); broadcastUpdate(DEVICE_DOES_NOT_SUPPORT_UART); return; } BluetoothGattCharacteristic TxChar = RxService.getCharacteristic(TX_CHAR_UUID); if (TxChar == null) { showMessage("Tx characteristic not found!"); broadcastUpdate(DEVICE_DOES_NOT_SUPPORT_UART); return; } //characteristic?? mBluetoothGatt.setCharacteristicNotification(TxChar, true); BluetoothGattDescriptor descriptor = TxChar.getDescriptor(CCCD); descriptor.setValue(BluetoothGattDescriptor.ENABLE_NOTIFICATION_VALUE); mBluetoothGatt.writeDescriptor(descriptor); } /** * ??? * * @param value value */ public void writeRXCharacteristic(byte[] value) { BluetoothGattService RxService = mBluetoothGatt.getService(RX_SERVICE_UUID); if (RxService == null) { showMessage("Rx service not found!"); broadcastUpdate(DEVICE_DOES_NOT_SUPPORT_UART); return; } BluetoothGattCharacteristic RxChar = RxService.getCharacteristic(RX_CHAR_UUID); if (RxChar == null) { showMessage("Rx characteristic not found!"); broadcastUpdate(DEVICE_DOES_NOT_SUPPORT_UART); return; } RxChar.setValue(value); boolean status = mBluetoothGatt.writeCharacteristic(RxChar); Log.d(TAG, "write TXChar - status=" + status); } public void readCharacteristic(UUID uuid1, UUID uuid2) { BluetoothGattService batteryService = mBluetoothGatt.getService(uuid1); if (batteryService == null) { return; } BluetoothGattCharacteristic batteryLevel = batteryService.getCharacteristic(uuid2); if (batteryLevel == null) { return; } mBluetoothGatt.readCharacteristic(batteryLevel); } /** * ? * * @param msg msg */ private void showMessage(String msg) { Log.e(TAG, msg); } /** * Retrieves a list of supported GATT services on the connected device. This should be * invoked only after {@code BluetoothGatt#discoverServices()} completes successfully. * * @return A {@code List} of supported services. */ public List<BluetoothGattService> getSupportedGattServices() { if (mBluetoothGatt == null) return null; return mBluetoothGatt.getServices(); } }